@craft-native/ios 0.0.214 → 0.0.215

package/README.md

@@ -192,6 +192,14 @@ wrong screen. `systemtap` targets the system button around a Live Activity rathe
 than its remotely hosted text. The [Live Activity layout fixture](./fixtures/live-activity)
 exercises long names and timer alignment using the production widget.
 
+Use `universallink https://example.com/profile` to test an associated HTTPS
+link after a fresh install. The driver host uses Apple's public
+`universalLinksOnly` option and waits up to 60 seconds for iOS to accept the
+association downloaded from Apple's CDN. A rejected association fails the
+journey; it cannot fall back to Safari. This operation does not launch the app
+under test directly, so a preceding `terminate` still tests a cold handoff.
+Use `openurl` for browser fallback checks and custom URL schemes.
+
 The iOS host uses the shared tree-layout ABI for eligible definite-size,
 non-grid, non-wrapped containers and retains a local fallback for older
 runtimes or unsupported styles. Both paths implement wrapped-line and grid

package/dist/index.js

@@ -156,8 +156,11 @@ function serializeSimulatorSteps(steps) {
       }
     } else if ("name" in step)
       arg = token(step.name);
-    else if ("url" in step)
+    else if ("url" in step) {
+      if (step.command === "universallink" && new URL(step.url).protocol !== "https:")
+        throw new Error("Universal Links require an HTTPS URL");
       arg = step.url;
+    }
     if (/[\r\n]/.test(arg))
       throw new Error("Simulator arguments cannot contain newlines");
     return `${step.command}${arg ? ` ${arg}` : ""}`;

package/dist/testing.d.ts

@@ -60,6 +60,11 @@ export type SimulatorStep = {
     command: 'openurl';
     url: string;
 }
+/** Use Apple's universalLinksOnly API, allowing association downloads up to 60 seconds. */
+ | {
+    command: 'universallink';
+    url: string;
+}
 /** Runs `step` only when the element with this identifier is there (a screen shown the first time). */
  | {
     command: 'ifid';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-native/ios",
-  "version": "0.0.214",
+  "version": "0.0.215",
   "homepage": "https://github.com/craft-native/craft/tree/main/packages/ios#readme",
   "repository": {
     "type": "git",

package/templates/testing/DriverTests.swift.template

@@ -14,6 +14,7 @@ import XCTest
 ///   delay <ms>            every proxied request waits this long (0 = off)
 ///   exec <hook>           runs the switch's HOOKS/<hook>.sh on the Mac (restart the API, …)
 ///   openurl <url>         opens a link through the system, answering "Open in the app?"
+///   universallink <https-url> waits up to 60s for an OS-verified link; never opens a browser
 ///   shot <name>           screenshot → shots/<name>.png
 ///   tree <name>           accessibility tree → shots/<name>.txt
 ///   tap <text>            first hittable element whose label contains text
@@ -253,6 +254,21 @@ final class DriverTests: XCTestCase {
                 answerOpenPrompt()
                 note("openurl \(arg)")
             }
+        case "universallink":
+            guard let url = URL(string: arg), url.scheme == "https" else {
+                check(false, "universallink requires an HTTPS URL")
+                return
+            }
+            let host = XCUIApplication(bundleIdentifier: "{{BUNDLE_PREFIX}}.host")
+            host.launchArguments = ["--craft-universal-link", url.absoluteString]
+            host.launch()
+            let opened = app.wait(for: .runningForeground, timeout: 75)
+            if !opened {
+                post("/save?name=universal-link-host.txt", Data(host.debugDescription.utf8))
+                post("/save?name=universal-link-app.txt", Data(app.debugDescription.utf8))
+            }
+            check(opened, "universallink \(arg) opened the target app")
+            host.terminate()
         case "shot":
             let shot = XCUIScreen.main.screenshot()
             post("/save?name=\(arg).png", shot.pngRepresentation)

package/templates/testing/HostApp.swift

@@ -1,6 +1,36 @@
 import SwiftUI
+import UIKit
 
 @main
 struct HostApp: App {
-    var body: some Scene { WindowGroup { Text("Craft simulator driver") } }
+    @State private var status = "Craft simulator driver"
+
+    var body: some Scene {
+        WindowGroup {
+            Text(status).accessibilityIdentifier("craft-driver-status")
+                .task { await openUniversalLinkIfRequested() }
+        }
+    }
+
+    @MainActor
+    private func openUniversalLinkIfRequested() async {
+        let arguments = ProcessInfo.processInfo.arguments
+        guard let index = arguments.firstIndex(of: "--craft-universal-link"),
+              arguments.indices.contains(index + 1),
+              let url = URL(string: arguments[index + 1]), url.scheme == "https" else { return }
+        // Installation returns before iOS finishes downloading the AASA from
+        // Apple's CDN. Ask the public API until the OS accepts the association;
+        // universalLinksOnly prevents a failed attempt from opening Safari.
+        let deadline = Date().addingTimeInterval(60)
+        while Date() < deadline && !Task.isCancelled {
+            let opened = await UIApplication.shared.open(url, options: [.universalLinksOnly: true])
+            if opened {
+                status = "Universal Link accepted"
+                return
+            }
+            status = "Waiting for Universal Link association"
+            try? await Task.sleep(nanoseconds: 1_000_000_000)
+        }
+        status = "Universal Link was not accepted within 60 seconds"
+    }
 }