@appium/coresim 1.4.0 → 1.6.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [1.6.0](https://github.com/appium/coresim/compare/v1.5.0...v1.6.0) (2026-09-23)
+
+### Features
+
+* add optional audio capture to video recording and streaming  ([#18](https://github.com/appium/coresim/issues/18)) ([e634078](https://github.com/appium/coresim/commit/e634078669db724a676bf95fa074a89d3ac5a9c8))
+
+## [1.5.0](https://github.com/appium/coresim/compare/v1.4.0...v1.5.0) (2026-09-22)
+
+### Features
+
+* Add video recording API ([#17](https://github.com/appium/coresim/issues/17)) ([d399403](https://github.com/appium/coresim/commit/d399403c1d329f303ab51726fa382313cf09ad0f))
+
 ## [1.4.0](https://github.com/appium/coresim/compare/v1.3.0...v1.4.0) (2026-09-19)
 
 ### Features

package/README.md

@@ -54,6 +54,20 @@ await sim.deleteDevice(device.udid);
   readiness with `getBootStatus()`/`waitForBoot()`.
 - **Apps** — install, remove, launch, terminate, and inspect apps.
 - **Processes** — spawn a process on the simulator and stream its stdout/stderr live.
+- **Screen capture** — screenshots, video recording to a file, and a real-time encoded video
+  stream — optionally with the device's own audio, muxed into the recording or interleaved into
+  the stream (`audio: true` on `startVideoRecording`/`startVideoStream`). Audio capture requires:
+  - **macOS 14.2+** on the host (Core Audio process taps).
+  - The host's **"System Audio Recording Only"** privacy permission (System Settings > Privacy &
+    Security > Screen & System Audio Recording). This can't be granted programmatically, and a
+    denial isn't a thrown error — it silently produces an audio-less/near-silent track.
+  - A default audio output device on the host, and a booted simulator that has produced audio at
+    least once (e.g. a foreground app that plays sound) — an empty guest process set throws.
+  - Uses a host-side Core Audio API, not anything iOS-version-specific, so it's expected to work
+    on any simulator runtime; only Xcode 26.x has actually been exercised so far.
+
+  On some CI/headless hosts, starting an audio capture can block for a while before failing —
+  see [`CLAUDE.md`](./CLAUDE.md) for the known root cause and current workaround.
 - **Simulator settings** — appearance (light/dark), accessibility (increase contrast, content
   size), location, and permissions.
 - **Extras** — keychain certificates, push notifications, and Darwin notifications.

package/binding.gyp

@@ -13,7 +13,14 @@
         "src/native/tcc_privacy.mm",
         "src/native/sim_pasteboard.mm",
         "src/native/sim_process.mm",
-        "src/native/sim_screenshot.mm"
+        "src/native/sim_audio_tap.mm",
+        "src/native/audio_encoder.mm",
+        "src/native/av_recording.mm",
+        "src/native/av_stream.mm",
+        "src/native/sim_screenshot.mm",
+        "src/native/sim_video_recording.mm",
+        "src/native/video_encoder.mm",
+        "src/native/sim_video_stream.mm"
       ],
       "include_dirs": [
         "<!@(node -p \"require('node-addon-api').include\")"
@@ -42,9 +49,15 @@
         "OTHER_LDFLAGS": [
           "-framework", "Foundation",
           "-framework", "AppKit",
+          "-framework", "AudioToolbox",
+          "-framework", "AVFoundation",
+          "-framework", "CoreAudio",
           "-framework", "CoreImage",
+          "-framework", "CoreMedia",
+          "-framework", "CoreVideo",
           "-framework", "ImageIO",
           "-framework", "IOSurface",
+          "-framework", "VideoToolbox",
           "-lsqlite3"
         ]
       }

package/lib/src/commands/video-recording.d.ts

@@ -0,0 +1,57 @@
+import type { NativeSimctl } from '../native-simctl.js';
+import type { VideoRecordingOptions } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        startVideoRecording(udid: string, outputFile: string, options?: VideoRecordingOptions): Promise<void>;
+        stopVideoRecording(udid: string): Promise<void>;
+        isVideoRecording(udid: string): Promise<boolean>;
+    }
+}
+/**
+ * Starts recording the device's display (and, with `options.audio`, its audio too, muxed as a
+ * second track) to `outputFile` — the native equivalent of `simctl io <udid> recordVideo` when
+ * both `audio` and `fps` are unset. Resolves once the first frame has actually been recorded, so
+ * it's always safe to call {@link stopVideoRecording} immediately after. Only one recording may be
+ * active per device at a time; starting a second one while the first is still running rejects.
+ *
+ * Without `audio`/`fps`, rejects with `NativeSimUnavailableError` if this CoreSimulator predates
+ * the private capture API — confirmed missing on Xcode 16.4's, present on Xcode 26.5+ (Apple
+ * documents no exact version floor). With either set, see {@link VideoRecordingOptions.audio}'s
+ * own doc comment for the host-permission requirement that applies specifically to `audio`; a
+ * failure *after* this call has already resolved (e.g. the audio tap's guest process set vanishing
+ * mid-recording) doesn't reject it — it's logged here instead — call {@link stopVideoRecording} to
+ * observe it as a rejection and release the recording's resources.
+ *
+ * @param udid — UDID of the device to record; must be booted
+ * @param outputFile — filesystem path to write the video to; resolved against `process.cwd()` if
+ *   relative, since the native layer requires an absolute path
+ * @param options — `displayId`, `codec`, `mask`, `audio`, `fps`, `bitrate` — see {@link VideoRecordingOptions}
+ * @throws {Error} if a recording is already in progress for this device
+ */
+export declare function startVideoRecording(this: NativeSimctl, udid: string, outputFile: string, options?: VideoRecordingOptions): Promise<void>;
+/**
+ * Stops a recording previously started by {@link startVideoRecording} on the same device.
+ * Resolves once the video file has been finalized on disk and is safe to read. If `start` is still
+ * in flight (e.g. a concurrent caller stopping as soon as {@link isVideoRecording} turns `true`),
+ * waits for it to settle first — issuing the native stop call any earlier is a silent CoreSimulator
+ * race (see CLAUDE.md).
+ *
+ * Safe to call concurrently or to retry after a failure: every concurrent call for the same
+ * recording shares a single in-flight native stop call rather than each issuing its own (which
+ * could otherwise stop whatever *new* recording has since started on this device instead), and a
+ * failed stop — even one that failed before ever reaching the native recorder, e.g. a transient
+ * device-lookup error — leaves the recording tracked as still active so a retry can reach the
+ * native call rather than the caller losing the ability to stop it at all.
+ *
+ * @param udid — UDID of the device to stop recording
+ * @throws {Error} if no recording is currently in progress for this device
+ */
+export declare function stopVideoRecording(this: NativeSimctl, udid: string): Promise<void>;
+/**
+ * Whether a recording started by {@link startVideoRecording} is currently active for this device.
+ * Pure local state — no CoreSimulator dispatch — so this never rejects with a native error.
+ *
+ * @param udid — UDID of the device to check
+ */
+export declare function isVideoRecording(this: NativeSimctl, udid: string): Promise<boolean>;
+//# sourceMappingURL=video-recording.d.ts.map

package/lib/src/commands/video-recording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-recording.d.ts","sourceRoot":"","sources":["../../../src/commands/video-recording.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAA6B,qBAAqB,EAAC,MAAM,aAAa,CAAC;AAGnF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACtG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAClD;CACF;AAqBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxF;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzF"}

package/lib/src/commands/video-recording.js

@@ -0,0 +1,123 @@
+import path from 'node:path';
+import { logger } from '@appium/support';
+import { runCatchingAsync, toTypedError } from '../utils/index.js';
+const log = logger.getLogger('CoreSim');
+// Tracks which devices currently have an active recording — module-level since the constraint (at
+// most one per device) is CoreSimulator's own, not per-NativeSimctl-instance.
+const activeRecordings = new Map();
+/**
+ * Starts recording the device's display (and, with `options.audio`, its audio too, muxed as a
+ * second track) to `outputFile` — the native equivalent of `simctl io <udid> recordVideo` when
+ * both `audio` and `fps` are unset. Resolves once the first frame has actually been recorded, so
+ * it's always safe to call {@link stopVideoRecording} immediately after. Only one recording may be
+ * active per device at a time; starting a second one while the first is still running rejects.
+ *
+ * Without `audio`/`fps`, rejects with `NativeSimUnavailableError` if this CoreSimulator predates
+ * the private capture API — confirmed missing on Xcode 16.4's, present on Xcode 26.5+ (Apple
+ * documents no exact version floor). With either set, see {@link VideoRecordingOptions.audio}'s
+ * own doc comment for the host-permission requirement that applies specifically to `audio`; a
+ * failure *after* this call has already resolved (e.g. the audio tap's guest process set vanishing
+ * mid-recording) doesn't reject it — it's logged here instead — call {@link stopVideoRecording} to
+ * observe it as a rejection and release the recording's resources.
+ *
+ * @param udid — UDID of the device to record; must be booted
+ * @param outputFile — filesystem path to write the video to; resolved against `process.cwd()` if
+ *   relative, since the native layer requires an absolute path
+ * @param options — `displayId`, `codec`, `mask`, `audio`, `fps`, `bitrate` — see {@link VideoRecordingOptions}
+ * @throws {Error} if a recording is already in progress for this device
+ */
+export async function startVideoRecording(udid, outputFile, options = {}) {
+    // Mirrors startVideoStream's identical validation — both reach the same native encoder path,
+    // which otherwise silently truncates an out-of-range value instead of rejecting it.
+    if (options.fps !== undefined && (!Number.isFinite(options.fps) || options.fps < 1)) {
+        throw new RangeError(`fps must be a finite number >= 1, got ${options.fps}`);
+    }
+    if (options.bitrate !== undefined &&
+        (!Number.isFinite(options.bitrate) || options.bitrate <= 0 || options.bitrate > 2 ** 31 - 1)) {
+        throw new RangeError(`bitrate must be a positive number no greater than ${2 ** 31 - 1}, got ${options.bitrate}`);
+    }
+    const key = udid.toLowerCase();
+    if (activeRecordings.has(key)) {
+        throw new Error(`A video recording is already in progress for device '${udid}'`);
+    }
+    const absoluteOutputFile = path.resolve(outputFile);
+    const startPromise = runCatchingAsync(async () => (await this._findDevice(udid)).startVideoRecording(absoluteOutputFile, options, (err) => {
+        // Only ever invoked on the `audio`/`fps` (own-encoder) path — see its own doc comment above.
+        // No live consumer to report to (this call already resolved), so logged instead of lost.
+        log.error(`Unhandled video recording error for device '${udid}': ${toTypedError(err).stack ?? err}`);
+    }));
+    // Marked before the native call resolves, not after, so a concurrent startVideoRecording for the
+    // same device is rejected immediately instead of racing this one — rolled back below on failure.
+    const state = { start: startPromise };
+    activeRecordings.set(key, state);
+    try {
+        await startPromise;
+    }
+    catch (e) {
+        // Only clear our own entry — a concurrent stopVideoRecording (see below) may already have.
+        if (activeRecordings.get(key) === state) {
+            activeRecordings.delete(key);
+        }
+        throw e;
+    }
+}
+/**
+ * Stops a recording previously started by {@link startVideoRecording} on the same device.
+ * Resolves once the video file has been finalized on disk and is safe to read. If `start` is still
+ * in flight (e.g. a concurrent caller stopping as soon as {@link isVideoRecording} turns `true`),
+ * waits for it to settle first — issuing the native stop call any earlier is a silent CoreSimulator
+ * race (see CLAUDE.md).
+ *
+ * Safe to call concurrently or to retry after a failure: every concurrent call for the same
+ * recording shares a single in-flight native stop call rather than each issuing its own (which
+ * could otherwise stop whatever *new* recording has since started on this device instead), and a
+ * failed stop — even one that failed before ever reaching the native recorder, e.g. a transient
+ * device-lookup error — leaves the recording tracked as still active so a retry can reach the
+ * native call rather than the caller losing the ability to stop it at all.
+ *
+ * @param udid — UDID of the device to stop recording
+ * @throws {Error} if no recording is currently in progress for this device
+ */
+export async function stopVideoRecording(udid) {
+    const key = udid.toLowerCase();
+    const state = activeRecordings.get(key);
+    if (!state) {
+        throw new Error(`No video recording is in progress for device '${udid}'`);
+    }
+    let handle;
+    try {
+        handle = await state.start;
+    }
+    catch {
+        // start itself failed — its own catch already cleaned up activeRecordings; nothing to stop.
+        throw new Error(`No video recording is in progress for device '${udid}'`);
+    }
+    const stopPromise = (state.stop ??= runCatchingAsync(async () => {
+        await handle.stop();
+    }));
+    try {
+        await stopPromise;
+    }
+    catch (e) {
+        // Only clear our own attempt, and only if it's still the current one — a future call must be
+        // able to retry the native stop rather than replaying this same rejection forever, but must
+        // not clobber a newer attempt another concurrent caller may have already started instead.
+        if (state.stop === stopPromise) {
+            state.stop = undefined;
+        }
+        throw e;
+    }
+    if (activeRecordings.get(key) === state) {
+        activeRecordings.delete(key);
+    }
+}
+/**
+ * Whether a recording started by {@link startVideoRecording} is currently active for this device.
+ * Pure local state — no CoreSimulator dispatch — so this never rejects with a native error.
+ *
+ * @param udid — UDID of the device to check
+ */
+export async function isVideoRecording(udid) {
+    return activeRecordings.has(udid.toLowerCase());
+}
+//# sourceMappingURL=video-recording.js.map

package/lib/src/commands/video-recording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-recording.js","sourceRoot":"","sources":["../../../src/commands/video-recording.ts"],"names":[],"mappings":"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"}

package/lib/src/commands/video-stream.d.ts

@@ -0,0 +1,92 @@
+import { EventEmitter } from 'node:events';
+import type { NativeSimctl } from '../native-simctl.js';
+import type { VideoAccessUnit, VideoStreamOptions } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        startVideoStream(udid: string, options?: VideoStreamOptions): Promise<VideoStream>;
+    }
+}
+export declare const MAX_BUFFERED_UNITS = 60;
+/**
+ * Single-consumer FIFO between native's per-frame callback and `accessUnits()`. Unlike routing
+ * through `EventEmitter`, a unit pushed before any consumer has started iterating is retained
+ * (fixing the encoder's own first-frame/keyframe otherwise being lost to a startup race) rather
+ * than silently dropped.
+ *
+ * Bounded at `MAX_BUFFERED_UNITS`, but resync-aware about *how* it sheds load once a slow consumer
+ * falls behind: since interframes only reference earlier frames they were encoded against (no
+ * `AllowFrameReordering`), dropping an arbitrary one would orphan every later one from its
+ * reference chain, corrupting decode from that point on even though delivery looks unbroken.
+ * Overflow instead clears the backlog entirely and enters a resync state — `dropsDuringResync`
+ * decides which further units to discard (not buffer) until `endsResync` sees a self-decodable
+ * point to resume clean delivery from. Generic (not hardcoded to video's own reference-chain
+ * concern) so `VideoStream` can reuse this same machinery when it's carrying interleaved audio
+ * too (`VideoStreamOptions.audio`) — an audio unit is always independently decodable, so it's
+ * configured to never be dropped and never itself end a resync; only video interframes are.
+ */
+export declare class AccessUnitQueue<T> {
+    private readonly opts;
+    private readonly buffer;
+    private waiter;
+    private ended;
+    private error;
+    private resyncing;
+    constructor(opts: {
+        /** Whether `unit` should be discarded (not buffered) while resyncing. */
+        dropsDuringResync: (unit: T) => boolean;
+        /** Whether `unit` is a self-decodable point resync can resume clean delivery from. */
+        endsResync: (unit: T) => boolean;
+        /** Called once when overflow first forces a resync, e.g. to request a fresh keyframe. */
+        onOverflow?: () => void;
+    });
+    push(unit: T): void;
+    /** Ends the queue with an error — any pending or future `next()` rejects with it. */
+    fail(err: unknown): void;
+    /** Ends the queue cleanly — any pending or future `next()` resolves `done`. */
+    end(): void;
+    /**
+     * Resolves `done` (not rejects) if `signal` aborts while waiting, mirroring `events.on()`.
+     * Checks cancellation/end *before* dequeuing, so an already-aborted signal or an already-ended
+     * queue never hands out a stale buffered unit — an aborted consumer, or a fresh iterator started
+     * after `stop()`, must see the boundary immediately rather than draining leftovers first.
+     */
+    next(signal: AbortSignal): Promise<IteratorResult<T>>;
+}
+/**
+ * A live video stream from `NativeSimctl.startVideoStream` — encodes the device's display (and,
+ * with `options.audio`, its audio too — see {@link VideoStreamOptions}) in real time via
+ * VideoToolbox/Core Audio, unlike `startVideoRecording`, which drives CoreSimulator's own private,
+ * file-only recorder. Mirrors `appium-ios-remotexpc`'s `ScreenStreamCapture` shape
+ * (`accessUnits()`/`stop()`) for API consistency; the transport is otherwise unrelated.
+ */
+export declare class VideoStream extends EventEmitter {
+    readonly codec: 'h264' | 'hevc';
+    private handle;
+    private readonly stopController;
+    private stopPromise;
+    private readonly queue;
+    private activeConsumers;
+    /**
+     * Yields each encoded access unit as it's produced, until {@link stop} is called or the stream
+     * errors (in which case the error is thrown out of the loop). Pass `signal` to stop iterating
+     * without treating that as an error. Mirrors `ScreenStreamCapture.accessUnits()`'s shape.
+     *
+     * Only one active consumer is supported at a time — a second concurrent call rejects rather
+     * than silently sharing (and corrupting) the first one's single internal waiter slot.
+     */
+    accessUnits(signal?: AbortSignal): AsyncGenerator<VideoAccessUnit>;
+    /** Stops the stream and releases the underlying encoder. Idempotent, including concurrently. */
+    stop(): Promise<void>;
+}
+/**
+ * Starts encoding the device's display (and, with `options.audio`, its audio) in real time.
+ * Resolves once the encoder(s) have actually started; the returned {@link VideoStream}'s
+ * `accessUnits()` then yields each unit as it arrives. Independent of
+ * `startVideoRecording`/`stopVideoRecording` — both, and any number of concurrent streams, can
+ * run on the same device at once.
+ *
+ * @param udid — UDID of the device to stream; must be booted
+ * @param options — `displayId`, `codec`, `fps`, `bitrate`, `audio` — see {@link VideoStreamOptions}
+ */
+export declare function startVideoStream(this: NativeSimctl, udid: string, options?: VideoStreamOptions): Promise<VideoStream>;
+//# sourceMappingURL=video-stream.d.ts.map

package/lib/src/commands/video-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-stream.d.ts","sourceRoot":"","sources":["../../../src/commands/video-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAIzC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAA0B,eAAe,EAAE,kBAAkB,EAAC,MAAM,aAAa,CAAC;AAG9F,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;KACpF;CACF;AASD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAKrC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe,CAAC,CAAC;IAQ1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,MAAM,CAA6F;IAC3G,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,SAAS,CAAS;gBAGP,IAAI,EAAE;QACrB,yEAAyE;QACzE,iBAAiB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;QACxC,sFAAsF;QACtF,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;QACjC,yFAAyF;QACzF,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;KACzB;IAGH,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IA0BnB,qFAAqF;IACrF,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAcxB,+EAA+E;IAC/E,GAAG,IAAI,IAAI;IAaX;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CA6BtD;AAED;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,YAAY;aAiBf,KAAK,EAAE,MAAM,GAAG,MAAM;IAhBlD,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,WAAW,CAA4B;IAM/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAInB;IACH,OAAO,CAAC,eAAe,CAAK;IAiC5B;;;;;;;OAOG;IACI,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC;IAmBzE,gGAAgG;IAC1F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CAuBtB"}

package/lib/src/commands/video-stream.js

@@ -0,0 +1,242 @@
+import { EventEmitter } from 'node:events';
+import { logger } from '@appium/support';
+import { runCatchingAsync, toTypedError } from '../utils/index.js';
+const log = logger.getLogger('CoreSim');
+// Matches the native side's own ThreadSafeFunction queue bound (see coresim.mm's
+// kAccessUnitQueueSize) — kept here too since the native bound alone provides no real
+// backpressure: _handleAccessUnit's emit-equivalent push always returns immediately, regardless of
+// how slow the actual accessUnits() consumer is, so without a bound of its own this queue could
+// otherwise grow without limit while a slow consumer falls behind.
+export const MAX_BUFFERED_UNITS = 60;
+const SINGLE_CONSUMER_ERROR = 'VideoStream.accessUnits() supports only one active consumer at a time — a second concurrent call rejects.';
+/**
+ * Single-consumer FIFO between native's per-frame callback and `accessUnits()`. Unlike routing
+ * through `EventEmitter`, a unit pushed before any consumer has started iterating is retained
+ * (fixing the encoder's own first-frame/keyframe otherwise being lost to a startup race) rather
+ * than silently dropped.
+ *
+ * Bounded at `MAX_BUFFERED_UNITS`, but resync-aware about *how* it sheds load once a slow consumer
+ * falls behind: since interframes only reference earlier frames they were encoded against (no
+ * `AllowFrameReordering`), dropping an arbitrary one would orphan every later one from its
+ * reference chain, corrupting decode from that point on even though delivery looks unbroken.
+ * Overflow instead clears the backlog entirely and enters a resync state — `dropsDuringResync`
+ * decides which further units to discard (not buffer) until `endsResync` sees a self-decodable
+ * point to resume clean delivery from. Generic (not hardcoded to video's own reference-chain
+ * concern) so `VideoStream` can reuse this same machinery when it's carrying interleaved audio
+ * too (`VideoStreamOptions.audio`) — an audio unit is always independently decodable, so it's
+ * configured to never be dropped and never itself end a resync; only video interframes are.
+ */
+export class AccessUnitQueue {
+    opts;
+    buffer = [];
+    waiter;
+    ended = false;
+    error;
+    resyncing = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    push(unit) {
+        if (this.ended) {
+            return;
+        }
+        if (this.resyncing) {
+            if (this.opts.dropsDuringResync(unit)) {
+                return; // still waiting for a self-decodable point to resume delivery from
+            }
+            if (this.opts.endsResync(unit)) {
+                this.resyncing = false;
+            }
+        }
+        if (this.waiter) {
+            const { resolve } = this.waiter;
+            this.waiter = undefined;
+            resolve({ value: unit, done: false });
+            return;
+        }
+        this.buffer.push(unit);
+        if (this.buffer.length > MAX_BUFFERED_UNITS) {
+            this.buffer.length = 0;
+            this.resyncing = true;
+            this.opts.onOverflow?.();
+        }
+    }
+    /** Ends the queue with an error — any pending or future `next()` rejects with it. */
+    fail(err) {
+        if (this.ended) {
+            return;
+        }
+        this.ended = true;
+        this.error = err;
+        this.buffer.length = 0;
+        if (this.waiter) {
+            const { reject } = this.waiter;
+            this.waiter = undefined;
+            reject(err);
+        }
+    }
+    /** Ends the queue cleanly — any pending or future `next()` resolves `done`. */
+    end() {
+        if (this.ended) {
+            return;
+        }
+        this.ended = true;
+        this.buffer.length = 0;
+        if (this.waiter) {
+            const { resolve } = this.waiter;
+            this.waiter = undefined;
+            resolve({ value: undefined, done: true });
+        }
+    }
+    /**
+     * Resolves `done` (not rejects) if `signal` aborts while waiting, mirroring `events.on()`.
+     * Checks cancellation/end *before* dequeuing, so an already-aborted signal or an already-ended
+     * queue never hands out a stale buffered unit — an aborted consumer, or a fresh iterator started
+     * after `stop()`, must see the boundary immediately rather than draining leftovers first.
+     */
+    next(signal) {
+        if (signal.aborted) {
+            return Promise.resolve({ value: undefined, done: true });
+        }
+        if (this.ended) {
+            return this.error ? Promise.reject(this.error) : Promise.resolve({ value: undefined, done: true });
+        }
+        const buffered = this.buffer.shift();
+        if (buffered !== undefined) {
+            return Promise.resolve({ value: buffered, done: false });
+        }
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                this.waiter = undefined;
+                resolve({ value: undefined, done: true });
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+            this.waiter = {
+                resolve: (result) => {
+                    signal.removeEventListener('abort', onAbort);
+                    resolve(result);
+                },
+                reject: (err) => {
+                    signal.removeEventListener('abort', onAbort);
+                    reject(err);
+                },
+            };
+        });
+    }
+}
+/**
+ * A live video stream from `NativeSimctl.startVideoStream` — encodes the device's display (and,
+ * with `options.audio`, its audio too — see {@link VideoStreamOptions}) in real time via
+ * VideoToolbox/Core Audio, unlike `startVideoRecording`, which drives CoreSimulator's own private,
+ * file-only recorder. Mirrors `appium-ios-remotexpc`'s `ScreenStreamCapture` shape
+ * (`accessUnits()`/`stop()`) for API consistency; the transport is otherwise unrelated.
+ */
+export class VideoStream extends EventEmitter {
+    codec;
+    handle;
+    stopController = new AbortController();
+    stopPromise;
+    // Requests a fresh keyframe on resync so delivery can resume immediately rather than waiting
+    // for the next periodic one — `handle` may not be attached yet on a startup-time overflow
+    // (vanishingly unlikely given MAX_BUFFERED_UNITS), in which case this is just a no-op. Only a
+    // video keyframe ends/is exempt from resync — an audio unit (when present) is always
+    // independently decodable, so it's never dropped and never itself ends a resync.
+    queue = new AccessUnitQueue({
+        dropsDuringResync: (unit) => unit.track === 'video' && !unit.isKeyFrame,
+        endsResync: (unit) => unit.track === 'video' && unit.isKeyFrame,
+        onOverflow: () => this.handle?.requestKeyFrame(),
+    });
+    activeConsumers = 0;
+    /** @internal */
+    constructor(codec) {
+        super();
+        this.codec = codec;
+    }
+    /** @internal */
+    _handleAccessUnit(unit) {
+        this.queue.push(unit);
+    }
+    /**
+     * @internal
+     * An active `accessUnits()` consumer receives the error via the queue itself (thrown out of its
+     * `for await` loop, per that method's contract) rather than the `'error'` event, so `emit` is
+     * only used for an explicit external listener; with neither, it's logged instead of lost.
+     */
+    _handleError(err) {
+        const error = toTypedError(err);
+        this.queue.fail(error);
+        if (this.listenerCount('error') > 0) {
+            this.emit('error', error);
+        }
+        else if (this.activeConsumers === 0) {
+            log.error(`Unhandled VideoStream error: ${error.stack ?? error}`);
+        }
+    }
+    /** @internal */
+    _attachHandle(handle) {
+        this.handle = handle;
+    }
+    /**
+     * Yields each encoded access unit as it's produced, until {@link stop} is called or the stream
+     * errors (in which case the error is thrown out of the loop). Pass `signal` to stop iterating
+     * without treating that as an error. Mirrors `ScreenStreamCapture.accessUnits()`'s shape.
+     *
+     * Only one active consumer is supported at a time — a second concurrent call rejects rather
+     * than silently sharing (and corrupting) the first one's single internal waiter slot.
+     */
+    async *accessUnits(signal) {
+        if (this.activeConsumers > 0) {
+            throw new Error(SINGLE_CONSUMER_ERROR);
+        }
+        const combined = signal ? AbortSignal.any([signal, this.stopController.signal]) : this.stopController.signal;
+        this.activeConsumers++;
+        try {
+            for (;;) {
+                const result = await this.queue.next(combined);
+                if (result.done) {
+                    return;
+                }
+                yield result.value;
+            }
+        }
+        finally {
+            this.activeConsumers--;
+        }
+    }
+    /** Stops the stream and releases the underlying encoder. Idempotent, including concurrently. */
+    async stop() {
+        this.stopPromise ??= (async () => {
+            this.stopController.abort();
+            this.queue.end();
+            await this.handle?.stop();
+        })();
+        return this.stopPromise;
+    }
+}
+/**
+ * Starts encoding the device's display (and, with `options.audio`, its audio) in real time.
+ * Resolves once the encoder(s) have actually started; the returned {@link VideoStream}'s
+ * `accessUnits()` then yields each unit as it arrives. Independent of
+ * `startVideoRecording`/`stopVideoRecording` — both, and any number of concurrent streams, can
+ * run on the same device at once.
+ *
+ * @param udid — UDID of the device to stream; must be booted
+ * @param options — `displayId`, `codec`, `fps`, `bitrate`, `audio` — see {@link VideoStreamOptions}
+ */
+export async function startVideoStream(udid, options = {}) {
+    // The native poller clamps below 1 fps to 1 fps rather than actually polling that slowly, so a
+    // sub-1 value here would silently poll far more often than requested — rejected instead.
+    if (options.fps !== undefined && (!Number.isFinite(options.fps) || options.fps < 1)) {
+        throw new RangeError(`fps must be a finite number >= 1, got ${options.fps}`);
+    }
+    if (options.bitrate !== undefined &&
+        (!Number.isFinite(options.bitrate) || options.bitrate <= 0 || options.bitrate > 2 ** 31 - 1)) {
+        throw new RangeError(`bitrate must be a positive number no greater than ${2 ** 31 - 1}, got ${options.bitrate}`);
+    }
+    const device = await runCatchingAsync(() => this._findDevice(udid));
+    const stream = new VideoStream(options.codec === 'hevc' ? 'hevc' : 'h264');
+    const handle = await runCatchingAsync(() => device.startVideoStream(options, (unit) => stream._handleAccessUnit(unit), (err) => stream._handleError(err)));
+    stream._attachHandle(handle);
+    return stream;
+}
+//# sourceMappingURL=video-stream.js.map

package/lib/src/commands/video-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-stream.js","sourceRoot":"","sources":["../../../src/commands/video-stream.ts"],"names":[],"mappings":"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"}

package/lib/src/index.d.ts

@@ -1,7 +1,8 @@
 export { NativeSimError, NativeSimUnavailableError, NativeSimDispatchError, NativeSimOperationError } from './errors.js';
 export { NativeSimctl } from './native-simctl.js';
 export { SpawnedProcess } from './commands/spawn.js';
+export { VideoStream } from './commands/video-stream.js';
 export type { AppContainerType } from './commands/app.js';
 export type { BiometricName } from './commands/biometric.js';
-export { SimBootStatus, SimDeviceState, type ApnsAlert, type ApnsPayload, type ApnsSound, type PushNotificationPayload, type ScreenshotOptions, type SimBootInfo, type SimDeviceInfo, type SimDeviceTypeInfo, type SimDisplayInfo, type SimPermissionService, type SimPermissionStatus, type SimProcessInfo, type SimRuntimeInfo, type SpawnOptions, } from './types.js';
+export { SimBootStatus, SimDeviceState, type ApnsAlert, type ApnsPayload, type ApnsSound, type PushNotificationPayload, type ScreenshotOptions, type SimBootInfo, type SimDeviceInfo, type SimDeviceTypeInfo, type SimDisplayInfo, type SimPermissionService, type SimPermissionStatus, type SimProcessInfo, type SimRuntimeInfo, type SpawnOptions, type VideoAccessUnit, type VideoRecordingOptions, type VideoStreamOptions, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,uBAAuB,EAAC,MAAM,aAAa,CAAC;AACvH,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,uBAAuB,EAAC,MAAM,aAAa,CAAC;AACvH,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAC;AACvD,YAAY,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC"}

package/lib/src/index.js

@@ -1,5 +1,6 @@
 export { NativeSimError, NativeSimUnavailableError, NativeSimDispatchError, NativeSimOperationError } from './errors.js';
 export { NativeSimctl } from './native-simctl.js';
 export { SpawnedProcess } from './commands/spawn.js';
+export { VideoStream } from './commands/video-stream.js';
 export { SimBootStatus, SimDeviceState, } from './types.js';
 //# sourceMappingURL=index.js.map