[Tophat] feat: add the ability to wait for a build to complete

[kieran-osgood-shopify]

What changes are you making?

dev tophat relied on being run after the artifacts are populated on a PR, and would fail if they weren't available.

This PR adds --wait and and interactive option to wait for the new build, or to select a pre-existing build (highlighting to the user that the build is stale to the latest SHA)

This also enables triggering a build on a PR if a build isn't yet available.

How to test

---

Before you merge

Important

• I've added tests to support my implementation
• I have read and agree with the Contribution Guidelines
• I have read and agree with the Code of Conduct
• I've updated the relevant platform README (platforms/swift/README.md and/or platforms/android/README.md)

---

Releasing a new Swift version?

• I have bumped the version in ShopifyCheckoutKit.podspec
• I have bumped the version in platforms/swift/Sources/ShopifyCheckoutKit/ShopifyCheckoutKit.swift
• I have updated the SwiftPM/CocoaPods version snippets in platforms/swift/README.md (major version only)

Releasing a new Embedded Checkout Protocol version?

• I have bumped embeddedCheckoutProtocolAndroid in platforms/android/gradle/libs.versions.toml
• I have updated protocol/languages/kotlin/embedded-checkout-protocol/api/embedded-checkout-protocol.api if the public API changed

Releasing a new Android version?

• I have bumped checkoutKitAndroid in platforms/android/gradle/libs.versions.toml
• I have updated the Gradle/Maven version snippets in platforms/android/README.md

Tip

See the Contributing documentation for the full release process per platform.

[kieran-osgood-shopify]

• DO NOT MERGE: add phantom E2E target to simulate config/matrix drift #491
• [Bitrise] Failover gracefully when run drifts from main #490
• [Tophat] Adds swift/kotlin to tophat install rows #473
• [Tophat] feat: add the ability to wait for a build to complete #434 👈 (View in Graphite)
• [Tophat] Refactor: extract shared browserstack client #433
• [Tophat] Add Bitrise client for Tophat artifact discovery #419
• [Tophat] Add Tophat integration for Checkout Kit React Native builds #401
• [Phase 7] Soft-launch E2E PR checks #364 : 1 other dependent PR (#417 )
• [Phase 6] Report E2E results to GitHub #363
• [Phase 5] Run BrowserStack Maestro from E2E matrix rows #362
• [Phase 4] Build React Native iOS E2E IPA artifact #361
• [Phase 3] Build React Native Android E2E APK artifact #360
• [Phase 2] Add Bitrise E2E pipeline skeleton #357
• [Phase1] Add E2E matrix launch smoke foundation #356
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[kieran-osgood-shopify]

Merge activity

• Jul 16, 4:48 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jul 16, 4:54 PM UTC: Graphite rebased this pull request as part of a merge.
• Jul 16, 4:54 PM UTC: @kieran-osgood-shopify merged this pull request with Graphite.