craft-native 0.0.217 → 0.0.218

package/README.md

@@ -522,6 +522,16 @@ app's UI checks for persisted progress and offline content. Neither operation
 uninstalls an app or clears its data. The controls deliberately refuse physical
 devices and implicit device selectors.
 
+For guest-frame evidence on a headless iOS runner, use
+`recordIosSimulatorVideo({ device: simulatorUuid, path: '/absolute/path/video.mp4' })`
+from the same entrypoint. It resolves after Apple's first-frame acknowledgement.
+Call `await recording.stop()` in `finally` before restarting the simulator or
+installing an update; repeated stops share the same finalization. Startup and
+stop are bounded (30 seconds by default, `timeoutMs` to change it), and an empty
+or failed recording rejects. Existing files are preserved unless `overwrite: true`
+is set. Capture retains a display-frame sink independently of the Device Hub viewer;
+it does not change the application's animations or test assertions.
+
 ## Contributing
 
 We love contributions! Please see our [contributing guide](../../CONTRIBUTING.md).

package/dist/cli.js

@@ -3424,7 +3424,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.217";
+var version = "0.0.218";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/index.cjs

@@ -309,7 +309,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.217";
+var version = "0.0.218";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/index.js

@@ -57,7 +57,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.217";
+var version = "0.0.218";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/mobile-testing.d.ts

@@ -17,6 +17,22 @@ export interface MobileTestDevice {
     }>;
     installedBuild: () => Promise<string>;
 }
+export interface IosSimulatorRecording {
+    path: string;
+    stop: () => Promise<void>;
+}
+/**
+ * Retains guest display frames, including on a headless runner. Waits for
+ * simctl's documented first-frame acknowledgement; stop finalizes the movie
+ * before a test shuts down the device or replaces its app.
+ */
+export declare function recordIosSimulatorVideo(options: {
+    device: string;
+    path: string;
+    overwrite?: boolean;
+    xcrun?: string;
+    timeoutMs?: number;
+}): Promise<IosSimulatorRecording>;
 /**
  * Drives an explicitly selected simulator/emulator. Restart preserves its disk;
  * update installs over the existing app, without uninstalling or clearing data.

package/dist/mobile-testing.js

@@ -1,12 +1,105 @@
 // @bun
 // src/mobile-testing.ts
 import { access } from "fs/promises";
-import { join } from "path";
+import { isAbsolute, join } from "path";
+function requireIosSimulator(device) {
+  if (!/^[a-f\d]{8}(?:-[a-f\d]{4}){3}-[a-f\d]{12}$/i.test(device))
+    throw new Error("An explicit iOS simulator UUID is required");
+}
+async function recordIosSimulatorVideo(options) {
+  requireIosSimulator(options.device);
+  if (!isAbsolute(options.path))
+    throw new Error("A local absolute recording path is required");
+  const timeout = options.timeoutMs ?? 30000;
+  if (!Number.isSafeInteger(timeout) || timeout < 1)
+    throw new Error("Recording timeout must be a positive integer");
+  const child = Bun.spawn([
+    options.xcrun || "xcrun",
+    "simctl",
+    "io",
+    options.device,
+    "recordVideo",
+    "--codec=h264",
+    ...options.overwrite ? ["--force"] : [],
+    options.path
+  ], { stdout: "ignore", stderr: "pipe" });
+  let diagnostics = "";
+  const firstFrame = Promise.withResolvers();
+  const drained = (async () => {
+    const reader = child.stderr.getReader();
+    const decoder = new TextDecoder;
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+          break;
+        diagnostics += decoder.decode(value, { stream: true });
+        if (/(?:^|\n)Recording started\r?\n/.test(diagnostics))
+          firstFrame.resolve();
+        diagnostics = diagnostics.slice(-4096);
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  })();
+  drained.catch(() => {});
+  const startupTimeout = Promise.withResolvers();
+  const deadline = setTimeout(() => startupTimeout.reject(new Error("Recorder did not produce its first frame in time")), timeout);
+  try {
+    await Promise.race([
+      firstFrame.promise,
+      child.exited.then(async (code) => {
+        await drained;
+        throw new Error(`Recorder exited before its first frame (${code})`);
+      }),
+      startupTimeout.promise
+    ]);
+  } catch (cause) {
+    child.kill("SIGKILL");
+    await child.exited;
+    await drained.catch(() => {});
+    throw new Error(`${cause instanceof Error ? cause.message : cause}
+${diagnostics}`);
+  } finally {
+    clearTimeout(deadline);
+  }
+  let stopping;
+  return {
+    path: options.path,
+    stop: () => stopping ||= (async () => {
+      if (child.exitCode !== null)
+        throw new Error(`Recorder ended before stop
+${diagnostics}`);
+      child.kill("SIGINT");
+      const finalizationTimeout = Promise.withResolvers();
+      const stopDeadline = setTimeout(() => {
+        child.kill("SIGKILL");
+        finalizationTimeout.reject(new Error("Recorder did not finalize in time"));
+      }, timeout);
+      try {
+        const code = await Promise.race([
+          child.exited,
+          finalizationTimeout.promise
+        ]);
+        await drained;
+        if (code !== 0)
+          throw new Error(`Recorder failed (${code})
+${diagnostics}`);
+        const file = Bun.file(options.path);
+        if (!await file.exists() || file.size === 0)
+          throw new Error("Recorder did not write a movie");
+      } finally {
+        clearTimeout(stopDeadline);
+        await child.exited;
+      }
+    })()
+  };
+}
 function createMobileTestDevice(options) {
   if (!/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(options.appId))
     throw new Error("An explicit app identifier is required");
-  if (options.platform === "ios" && !/^[a-f\d]{8}(?:-[a-f\d]{4}){3}-[a-f\d]{12}$/i.test(options.device))
-    throw new Error("An explicit iOS simulator UUID is required");
+  if (options.platform === "ios")
+    requireIosSimulator(options.device);
   if (options.platform === "android" && !/^emulator-\d+$/.test(options.device))
     throw new Error("An explicit Android emulator serial is required");
   async function run(args, timeout = 120000) {
@@ -74,5 +167,6 @@ ${errors || output}`);
   return { restart, installUpdate, installedBuild };
 }
 export {
+  recordIosSimulatorVideo,
   createMobileTestDevice
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "craft-native",
-  "version": "0.0.217",
+  "version": "0.0.218",
   "type": "module",
   "description": "Build desktop apps with web languages - TypeScript SDK for Craft",
   "author": "Chris Breuer <chris@stacksjs.org>",