io.appium.settings 8.0.10 → 8.1.0

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

@@ -0,0 +1,160 @@
+import { randomUUID } from 'node:crypto';
+import { waitForCondition } from 'asyncbox';
+import { SETTINGS_HELPER_ID, STREAMING_ACTIVITY_NAME, VIDEO_STREAM_ACTION_START, VIDEO_STREAM_ACTION_STOP, VIDEO_STREAM_SERVICE_NAME, } from '../constants.js';
+import { StreamTrack, StreamTransport, validateLocalPortOpts } from '../utils/index.js';
+const STREAM_STARTUP_TIMEOUT_MS = 3 * 1000;
+const STREAM_STOP_TIMEOUT_MS = 3 * 1000;
+/**
+ * Creates a new instance of the live H.264/HEVC video streaming session.
+ * The stream only works since Android API 29+
+ *
+ * @returns The streaming session instance
+ */
+export function makeVideoStreamSession() {
+    return new VideoStreamSession(this.adb);
+}
+function validateVideoStreamOpts(opts) {
+    const { codec, fps, bitrate } = opts;
+    if (codec !== undefined && codec !== 'h264' && codec !== 'hevc') {
+        throw new TypeError(`codec must be either 'h264' or 'hevc', got ${codec}`);
+    }
+    if (fps !== undefined && (!Number.isInteger(fps) || fps <= 0)) {
+        throw new TypeError(`fps must be a positive integer, got ${fps}`);
+    }
+    if (bitrate !== undefined && (!Number.isInteger(bitrate) || bitrate <= 0)) {
+        throw new TypeError(`bitrate must be a positive integer, got ${bitrate}`);
+    }
+    validateLocalPortOpts(opts);
+}
+/**
+ * Live H.264/HEVC video streaming session for the device screen, with an
+ * optional interleaved AAC audio track.
+ */
+export class VideoStreamSession {
+    adb;
+    transport = null;
+    /**
+     * Creates a new VideoStreamSession instance.
+     *
+     * @param adb - ADB instance for device communication
+     */
+    constructor(adb) {
+        this.adb = adb;
+    }
+    /**
+     * Checks if the video stream is currently running.
+     */
+    async isRunning() {
+        const stdout = await this.adb.shell(['dumpsys', 'activity', 'services', VIDEO_STREAM_SERVICE_NAME]);
+        return stdout.includes(VIDEO_STREAM_SERVICE_NAME);
+    }
+    /**
+     * Starts the live video stream.
+     * If a stream is already running, this method returns false without starting a new one.
+     *
+     * @param opts Streaming options including codec, fps, bitrate, resolution, audio, and the local port to use
+     * @returns True if the stream was started successfully, false if already running
+     * @throws {Error} If the stream fails to start within the timeout period
+     */
+    async start(opts = {}) {
+        validateVideoStreamOpts(opts);
+        if (await this.isRunning()) {
+            return false;
+        }
+        const { codec, fps, bitrate, resolution, audio, localPort, localPortRange } = opts;
+        // Socket names are validated on-device against ^[a-zA-Z0-9._-]{1,200}$, so this
+        // must not contain a "/" - unlike VIDEO_STREAM_SERVICE_NAME.
+        const socketName = `${SETTINGS_HELPER_ID}.videostream.${randomUUID()}`;
+        const args = [
+            'am',
+            'start',
+            '-n',
+            STREAMING_ACTIVITY_NAME,
+            '-a',
+            VIDEO_STREAM_ACTION_START,
+            '--es',
+            'socket_name',
+            socketName,
+        ];
+        if (codec) {
+            args.push('--es', 'codec', codec);
+        }
+        if (fps) {
+            args.push('--es', 'fps', `${fps}`);
+        }
+        if (bitrate) {
+            args.push('--es', 'bitrate', `${bitrate}`);
+        }
+        if (resolution) {
+            args.push('--es', 'resolution', resolution);
+        }
+        if (audio !== undefined) {
+            args.push('--es', 'audio', audio ? 'true' : 'false');
+        }
+        await this.adb.shell(args);
+        try {
+            await waitForCondition(async () => await this.isRunning(), {
+                waitMs: STREAM_STARTUP_TIMEOUT_MS,
+                intervalMs: 300,
+            });
+        }
+        catch {
+            throw new Error(`The video stream is not running after ${STREAM_STARTUP_TIMEOUT_MS}ms. ` +
+                `Please check the logcat output for more details.`);
+        }
+        this.transport = await StreamTransport.connect(this.adb, socketName, { localPort, localPortRange });
+        return true;
+    }
+    /**
+     * Yields access units (video NAL units and, if enabled, AAC audio units) as
+     * they arrive from the device. `start()` must be called before iterating.
+     */
+    async *accessUnits() {
+        if (!this.transport) {
+            throw new Error('The video stream has not been started. Call start() first.');
+        }
+        for await (const frame of this.transport.frames()) {
+            yield {
+                track: frame.track === StreamTrack.Audio ? 'audio' : 'video',
+                data: frame.data,
+                sequence: Number(frame.sequence),
+                timestampMicros: Number(frame.timestampMicros),
+                isKeyFrame: frame.isKeyFrame,
+                isConfig: frame.isConfig,
+            };
+        }
+    }
+    /**
+     * Stops the currently running video stream.
+     *
+     * @returns True if the stream was stopped successfully, false if it was not running
+     * @throws {Error} If the stream fails to stop within the timeout period
+     */
+    async stop() {
+        try {
+            if (!(await this.isRunning())) {
+                // The on-device service may have already stopped itself (e.g. the client
+                // disconnected), leaving a local transport/adb-forward that still needs closing.
+                return false;
+            }
+            await this.adb.shell(['am', 'start', '-n', STREAMING_ACTIVITY_NAME, '-a', VIDEO_STREAM_ACTION_STOP]);
+            try {
+                await waitForCondition(async () => !(await this.isRunning()), {
+                    waitMs: STREAM_STOP_TIMEOUT_MS,
+                    intervalMs: 300,
+                });
+            }
+            catch {
+                throw new Error(`The attempt to stop the current video stream timed out after ${STREAM_STOP_TIMEOUT_MS}ms`);
+            }
+            return true;
+        }
+        finally {
+            if (this.transport) {
+                await this.transport.close();
+                this.transport = null;
+            }
+        }
+    }
+}
+//# sourceMappingURL=video-stream.js.map

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

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

package/build/lib/constants.d.ts

@@ -30,4 +30,11 @@ export declare const RECORDING_SERVICE_NAME = "io.appium.settings/.recorder.Reco
 export declare const RECORDING_ACTIVITY_NAME = "io.appium.settings/io.appium.settings.Settings";
 export declare const RECORDING_ACTION_START = "io.appium.settings.recording.ACTION_START";
 export declare const RECORDING_ACTION_STOP = "io.appium.settings.recording.ACTION_STOP";
+export declare const STREAMING_ACTIVITY_NAME = "io.appium.settings/io.appium.settings.Settings";
+export declare const JPEG_STREAM_SERVICE_NAME = "io.appium.settings/.streaming.JpegStreamService";
+export declare const JPEG_STREAM_ACTION_START = "io.appium.settings.streaming.jpeg.ACTION_START";
+export declare const JPEG_STREAM_ACTION_STOP = "io.appium.settings.streaming.jpeg.ACTION_STOP";
+export declare const VIDEO_STREAM_SERVICE_NAME = "io.appium.settings/.streaming.VideoStreamService";
+export declare const VIDEO_STREAM_ACTION_START = "io.appium.settings.streaming.video.ACTION_START";
+export declare const VIDEO_STREAM_ACTION_STOP = "io.appium.settings.streaming.video.ACTION_STOP";
 //# sourceMappingURL=constants.d.ts.map

package/build/lib/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,6BAA6B,cAAc,CAAC;AAIzD,eAAO,MAAM,kBAAkB,oDAAuC,CAAC;AACvE,eAAO,MAAM,0BAA0B,qCAAwC,CAAC;AAEhF,eAAO,MAAM,UAAU,kCAAqC,CAAC;AAC7D,eAAO,MAAM,WAAW,mCAAsC,CAAC;AAC/D,eAAO,MAAM,SAAS,iCAAoC,CAAC;AAE3D,eAAO,MAAM,gCAAgC,gEAAmD,CAAC;AACjG,eAAO,MAAM,8BAA8B,4BAA+B,CAAC;AAC3E,eAAO,MAAM,0BAA0B,qEAAwD,CAAC;AAChG,eAAO,MAAM,wBAAwB,iCAAoC,CAAC;AAC1E,eAAO,MAAM,yBAAyB,iEAAoD,CAAC;AAC3F,eAAO,MAAM,uBAAuB,wCAA2C,CAAC;AAEhF,eAAO,MAAM,0BAA0B,2DAA8C,CAAC;AACtF,eAAO,MAAM,wBAAwB,iCAAoC,CAAC;AAE1E,eAAO,MAAM,uBAAuB,wDAA2C,CAAC;AAChF,eAAO,MAAM,qBAAqB,8BAAiC,CAAC;AAEpE,eAAO,MAAM,6BAA6B,gDAAmC,CAAC;AAC9E,eAAO,MAAM,2BAA2B,oCAAuC,CAAC;AAEhF,eAAO,MAAM,gBAAgB,wCAA2C,CAAC;AACzE,eAAO,MAAM,iBAAiB,uDAA0C,CAAC;AACzE,eAAO,MAAM,yBAAyB,gCAAmC,CAAC;AAE1E,eAAO,MAAM,iBAAiB,4CAA+B,CAAC;AAC9D,eAAO,MAAM,yBAAyB,gCAAmC,CAAC;AAE1E,eAAO,MAAM,mBAAmB,uDAA0C,CAAC;AAC3E,eAAO,MAAM,iBAAiB,kCAAqC,CAAC;AAEpE,eAAO,MAAM,sCAAsC,kCAAqC,CAAC;AACzF,eAAO,MAAM,8BAA8B,qCAAwC,CAAC;AAEpF,eAAO,MAAM,sBAAsB,iDAAoD,CAAC;AACxF,eAAO,MAAM,uBAAuB,mDAAsD,CAAC;AAC3F,eAAO,MAAM,sBAAsB,8CAAiD,CAAC;AACrF,eAAO,MAAM,qBAAqB,6CAAgD,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,6BAA6B,cAAc,CAAC;AAIzD,eAAO,MAAM,kBAAkB,oDAAuC,CAAC;AACvE,eAAO,MAAM,0BAA0B,qCAAwC,CAAC;AAEhF,eAAO,MAAM,UAAU,kCAAqC,CAAC;AAC7D,eAAO,MAAM,WAAW,mCAAsC,CAAC;AAC/D,eAAO,MAAM,SAAS,iCAAoC,CAAC;AAE3D,eAAO,MAAM,gCAAgC,gEAAmD,CAAC;AACjG,eAAO,MAAM,8BAA8B,4BAA+B,CAAC;AAC3E,eAAO,MAAM,0BAA0B,qEAAwD,CAAC;AAChG,eAAO,MAAM,wBAAwB,iCAAoC,CAAC;AAC1E,eAAO,MAAM,yBAAyB,iEAAoD,CAAC;AAC3F,eAAO,MAAM,uBAAuB,wCAA2C,CAAC;AAEhF,eAAO,MAAM,0BAA0B,2DAA8C,CAAC;AACtF,eAAO,MAAM,wBAAwB,iCAAoC,CAAC;AAE1E,eAAO,MAAM,uBAAuB,wDAA2C,CAAC;AAChF,eAAO,MAAM,qBAAqB,8BAAiC,CAAC;AAEpE,eAAO,MAAM,6BAA6B,gDAAmC,CAAC;AAC9E,eAAO,MAAM,2BAA2B,oCAAuC,CAAC;AAEhF,eAAO,MAAM,gBAAgB,wCAA2C,CAAC;AACzE,eAAO,MAAM,iBAAiB,uDAA0C,CAAC;AACzE,eAAO,MAAM,yBAAyB,gCAAmC,CAAC;AAE1E,eAAO,MAAM,iBAAiB,4CAA+B,CAAC;AAC9D,eAAO,MAAM,yBAAyB,gCAAmC,CAAC;AAE1E,eAAO,MAAM,mBAAmB,uDAA0C,CAAC;AAC3E,eAAO,MAAM,iBAAiB,kCAAqC,CAAC;AAEpE,eAAO,MAAM,sCAAsC,kCAAqC,CAAC;AACzF,eAAO,MAAM,8BAA8B,qCAAwC,CAAC;AAEpF,eAAO,MAAM,sBAAsB,iDAAoD,CAAC;AACxF,eAAO,MAAM,uBAAuB,mDAAsD,CAAC;AAC3F,eAAO,MAAM,sBAAsB,8CAAiD,CAAC;AACrF,eAAO,MAAM,qBAAqB,6CAAgD,CAAC;AAEnF,eAAO,MAAM,uBAAuB,mDAA0B,CAAC;AAE/D,eAAO,MAAM,wBAAwB,oDAAuD,CAAC;AAC7F,eAAO,MAAM,wBAAwB,mDAAsD,CAAC;AAC5F,eAAO,MAAM,uBAAuB,kDAAqD,CAAC;AAE1F,eAAO,MAAM,yBAAyB,qDAAwD,CAAC;AAC/F,eAAO,MAAM,yBAAyB,oDAAuD,CAAC;AAC9F,eAAO,MAAM,wBAAwB,mDAAsD,CAAC"}

package/build/lib/constants.js

@@ -31,4 +31,11 @@ export const RECORDING_SERVICE_NAME = `${SETTINGS_HELPER_ID}/.recorder.RecorderS
 export const RECORDING_ACTIVITY_NAME = `${SETTINGS_HELPER_ID}/io.appium.settings.Settings`;
 export const RECORDING_ACTION_START = `${SETTINGS_HELPER_ID}.recording.ACTION_START`;
 export const RECORDING_ACTION_STOP = `${SETTINGS_HELPER_ID}.recording.ACTION_STOP`;
+export const STREAMING_ACTIVITY_NAME = RECORDING_ACTIVITY_NAME;
+export const JPEG_STREAM_SERVICE_NAME = `${SETTINGS_HELPER_ID}/.streaming.JpegStreamService`;
+export const JPEG_STREAM_ACTION_START = `${SETTINGS_HELPER_ID}.streaming.jpeg.ACTION_START`;
+export const JPEG_STREAM_ACTION_STOP = `${SETTINGS_HELPER_ID}.streaming.jpeg.ACTION_STOP`;
+export const VIDEO_STREAM_SERVICE_NAME = `${SETTINGS_HELPER_ID}/.streaming.VideoStreamService`;
+export const VIDEO_STREAM_ACTION_START = `${SETTINGS_HELPER_ID}.streaming.video.ACTION_START`;
+export const VIDEO_STREAM_ACTION_STOP = `${SETTINGS_HELPER_ID}.streaming.video.ACTION_STOP`;
 //# sourceMappingURL=constants.js.map

package/build/lib/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AACvD,MAAM,CAAC,MAAM,6BAA6B,GAAG,WAAW,CAAC;AAEzD,MAAM,aAAa,GAAG,GAAG,kBAAkB,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,aAAa,oBAAoB,CAAC;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,kBAAkB,gBAAgB,CAAC;AAEhF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,kBAAkB,aAAa,CAAC;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,kBAAkB,cAAc,CAAC;AAC/D,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,kBAAkB,YAAY,CAAC;AAE3D,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,aAAa,gCAAgC,CAAC;AACjG,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,kBAAkB,OAAO,CAAC;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,aAAa,qCAAqC,CAAC;AAChG,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,kBAAkB,YAAY,CAAC;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,aAAa,iCAAiC,CAAC;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,kBAAkB,mBAAmB,CAAC;AAEhF,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,aAAa,2BAA2B,CAAC;AACtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,kBAAkB,YAAY,CAAC;AAE1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,aAAa,wBAAwB,CAAC;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,kBAAkB,SAAS,CAAC;AAEpE,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,aAAa,gBAAgB,CAAC;AAC9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,kBAAkB,eAAe,CAAC;AAEhF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,kBAAkB,mBAAmB,CAAC;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,aAAa,uBAAuB,CAAC;AACzE,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,kBAAkB,WAAW,CAAC;AAE1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,aAAa,YAAY,CAAC;AAC9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,kBAAkB,WAAW,CAAC;AAE1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,aAAa,uBAAuB,CAAC;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,kBAAkB,aAAa,CAAC;AAEpE,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAAG,kBAAkB,aAAa,CAAC;AACzF,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,kBAAkB,gBAAgB,CAAC;AAEpF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,kBAAkB,4BAA4B,CAAC;AACxF,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,kBAAkB,8BAA8B,CAAC;AAC3F,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,kBAAkB,yBAAyB,CAAC;AACrF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,kBAAkB,wBAAwB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"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"}

package/build/lib/index.js

@@ -1,4 +1,4 @@
-import { getSettingsApkPath } from './utils.js';
+import { getSettingsApkPath } from './utils/index.js';
 export const path = getSettingsApkPath();
 export * from './constants.js';
 export { SettingsApp } from './client.js';

package/build/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAE9C,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC"}

package/build/lib/{utils.d.ts → utils/apk-path.d.ts}

@@ -4,4 +4,4 @@
  * @returns Full path to the APK file
  */
 export declare function getSettingsApkPath(): string;
-//# sourceMappingURL=utils.d.ts.map
+//# sourceMappingURL=apk-path.d.ts.map

package/build/lib/utils/apk-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apk-path.d.ts","sourceRoot":"","sources":["../../../lib/utils/apk-path.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/build/lib/{utils.js → utils/apk-path.js}

@@ -32,4 +32,4 @@ function getModuleRootSync() {
     }
     throw new Error(`Cannot find the root of the ${MODULE_NAME} Node.js module`);
 }
-//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=apk-path.js.map

package/build/lib/utils/apk-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apk-path.js","sourceRoot":"","sources":["../../../lib/utils/apk-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,wBAAwB,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB;IACxB,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,UAAU,EAAE,CAAC;QACnB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC1G,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,UAAU,GAAG,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,WAAW,iBAAiB,CAAC,CAAC;AAC/E,CAAC"}

package/build/lib/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { getSettingsApkPath } from './apk-path.js';
+export { createParserState, parseFrames, StreamTrack } from './streaming-protocol.js';
+export type { FrameParserState, StreamFrame } from './streaming-protocol.js';
+export { BoundedFrameQueue, resolveLocalPort, StreamTransport, validateLocalPortOpts } from './streaming-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/build/lib/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACjD,OAAO,EAAC,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpF,YAAY,EAAC,gBAAgB,EAAE,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,qBAAqB,EAAC,MAAM,0BAA0B,CAAC"}

package/build/lib/utils/index.js

@@ -0,0 +1,4 @@
+export { getSettingsApkPath } from './apk-path.js';
+export { createParserState, parseFrames, StreamTrack } from './streaming-protocol.js';
+export { BoundedFrameQueue, resolveLocalPort, StreamTransport, validateLocalPortOpts } from './streaming-transport.js';
+//# sourceMappingURL=index.js.map

package/build/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACjD,OAAO,EAAC,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,qBAAqB,EAAC,MAAM,0BAA0B,CAAC"}

package/build/lib/utils/streaming-protocol.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Track discriminator for a streamed frame, matching the on-device
+ * `io.appium.settings.streaming.Frame.Track` enum ordinals.
+ */
+export declare enum StreamTrack {
+    Jpeg = 0,
+    Video = 1,
+    Audio = 2
+}
+/**
+ * A single parsed frame/access-unit read off the streaming socket.
+ */
+export interface StreamFrame {
+    track: StreamTrack;
+    sequence: bigint;
+    timestampMicros: bigint;
+    data: Buffer;
+    isConfig: boolean;
+    isKeyFrame: boolean;
+    isEndOfStream: boolean;
+}
+/**
+ * Incremental parser state, carried across chunk boundaries.
+ */
+export interface FrameParserState {
+    buf: Buffer;
+}
+/**
+ * Creates a fresh, empty parser state for use with {@link parseFrames}.
+ *
+ * @returns A new, empty FrameParserState
+ */
+export declare function createParserState(): FrameParserState;
+/**
+ * Parses as many complete frames as are available in `state.buf` + `chunk`,
+ * carrying over any trailing partial frame in `state` for the next call.
+ *
+ * Wire format (big-endian, matches `io.appium.settings.streaming.StreamProtocol`):
+ * offset 0 (4 bytes): magic "APST"; offset 4 (1 byte): version;
+ * offset 5 (1 byte): track; offset 6 (1 byte): flags; offset 7: reserved;
+ * offset 8 (8 bytes): sequence; offset 16 (8 bytes): timestampMicros;
+ * offset 24 (4 bytes): payloadLength; followed by `payloadLength` payload bytes.
+ *
+ * @throws {Error} If the stream desynchronizes (unexpected magic bytes)
+ */
+export declare function parseFrames(state: FrameParserState, chunk: Buffer): Generator<StreamFrame>;
+//# sourceMappingURL=streaming-protocol.d.ts.map

package/build/lib/utils/streaming-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-protocol.d.ts","sourceRoot":"","sources":["../../../lib/utils/streaming-protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,WAAW;IACrB,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB;AAKD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,CAEpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAiB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,CAkC3F"}

package/build/lib/utils/streaming-protocol.js

@@ -0,0 +1,67 @@
+/**
+ * Track discriminator for a streamed frame, matching the on-device
+ * `io.appium.settings.streaming.Frame.Track` enum ordinals.
+ */
+export var StreamTrack;
+(function (StreamTrack) {
+    StreamTrack[StreamTrack["Jpeg"] = 0] = "Jpeg";
+    StreamTrack[StreamTrack["Video"] = 1] = "Video";
+    StreamTrack[StreamTrack["Audio"] = 2] = "Audio";
+})(StreamTrack || (StreamTrack = {}));
+const FLAG_CONFIG = 0x01;
+const FLAG_KEYFRAME = 0x02;
+const FLAG_EOS = 0x04;
+const HEADER_SIZE = 28;
+const MAGIC = Buffer.from('APST', 'ascii');
+/**
+ * Creates a fresh, empty parser state for use with {@link parseFrames}.
+ *
+ * @returns A new, empty FrameParserState
+ */
+export function createParserState() {
+    return { buf: Buffer.alloc(0) };
+}
+/**
+ * Parses as many complete frames as are available in `state.buf` + `chunk`,
+ * carrying over any trailing partial frame in `state` for the next call.
+ *
+ * Wire format (big-endian, matches `io.appium.settings.streaming.StreamProtocol`):
+ * offset 0 (4 bytes): magic "APST"; offset 4 (1 byte): version;
+ * offset 5 (1 byte): track; offset 6 (1 byte): flags; offset 7: reserved;
+ * offset 8 (8 bytes): sequence; offset 16 (8 bytes): timestampMicros;
+ * offset 24 (4 bytes): payloadLength; followed by `payloadLength` payload bytes.
+ *
+ * @throws {Error} If the stream desynchronizes (unexpected magic bytes)
+ */
+export function* parseFrames(state, chunk) {
+    state.buf = state.buf.length ? Buffer.concat([state.buf, chunk]) : chunk;
+    for (;;) {
+        if (state.buf.length < HEADER_SIZE) {
+            return;
+        }
+        if (!state.buf.subarray(0, 4).equals(MAGIC)) {
+            throw new Error('Stream desynchronized: unexpected magic bytes in the streaming protocol header');
+        }
+        const payloadLength = state.buf.readUInt32BE(24);
+        const totalLength = HEADER_SIZE + payloadLength;
+        if (state.buf.length < totalLength) {
+            return;
+        }
+        const track = state.buf.readUInt8(5);
+        const flags = state.buf.readUInt8(6);
+        const sequence = state.buf.readBigUInt64BE(8);
+        const timestampMicros = state.buf.readBigUInt64BE(16);
+        const data = Buffer.from(state.buf.subarray(HEADER_SIZE, totalLength));
+        state.buf = state.buf.subarray(totalLength);
+        yield {
+            track,
+            sequence,
+            timestampMicros,
+            data,
+            isConfig: (flags & FLAG_CONFIG) !== 0,
+            isKeyFrame: (flags & FLAG_KEYFRAME) !== 0,
+            isEndOfStream: (flags & FLAG_EOS) !== 0,
+        };
+    }
+}
+//# sourceMappingURL=streaming-protocol.js.map

package/build/lib/utils/streaming-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-protocol.js","sourceRoot":"","sources":["../../../lib/utils/streaming-protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,6CAAQ,CAAA;IACR,+CAAS,CAAA;IACT,+CAAS,CAAA;AACX,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC;AAetB,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAS3C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,SAAS,CAAC,CAAC,WAAW,CAAC,KAAuB,EAAE,KAAa;IACjE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzE,SAAS,CAAC;QACR,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;QACpG,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;QAChD,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAgB,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QAEvE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE5C,MAAM;YACJ,KAAK;YACL,QAAQ;YACR,eAAe;YACf,IAAI;YACJ,QAAQ,EAAE,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;YACrC,UAAU,EAAE,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;YACzC,aAAa,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;SACxC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/lib/utils/streaming-transport.d.ts

@@ -0,0 +1,142 @@
+import type { ADB } from 'appium-adb';
+import type { LocalPortOpts } from '../commands/types.js';
+import { type StreamFrame } from './streaming-protocol.js';
+/**
+ * Describes a decode-dependency chain within the queued items (e.g. H.264/HEVC video
+ * frames, where a delta frame is undecodable without every frame back to its last
+ * keyframe). Items outside the chain (e.g. an interleaved audio track) are unaffected.
+ */
+export interface DependencyChain<T> {
+    /** True for items that participate in the chain at all (e.g. non-CONFIG video frames). */
+    isChainMember: (item: T) => boolean;
+    /** True for a chain member that doesn't depend on earlier ones (e.g. a keyframe). */
+    isSyncPoint: (item: T) => boolean;
+}
+/**
+ * A bounded async-iterable queue that drops the oldest buffered item once its
+ * capacity is exceeded, so a slow consumer never causes unbounded memory growth.
+ * An optional `isProtected` predicate can shield items (e.g. video CONFIG frames)
+ * from eviction as long as any non-protected item remains to drop instead. An
+ * optional `dependencyChain` additionally makes eviction dependency-aware: dropping
+ * any chain member cascades to every following chain member up to (not including)
+ * the next sync point, and further chain-member pushes are discarded until a fresh
+ * sync point arrives - since anything in between is undecodable, buffering it only
+ * to have the consumer choke on it later isn't useful.
+ */
+export declare class BoundedFrameQueue<T> {
+    private readonly capacity;
+    private readonly isProtected?;
+    private readonly dependencyChain?;
+    private readonly items;
+    private readonly waiters;
+    private readonly errorWaiters;
+    private ended;
+    private endError;
+    private awaitingSyncPoint;
+    constructor(capacity?: number, isProtected?: ((item: T) => boolean) | undefined, dependencyChain?: DependencyChain<T> | undefined);
+    /**
+     * Enqueues an item. If a consumer is already awaiting the next item, it is
+     * delivered directly; otherwise it is buffered, dropping the oldest droppable
+     * (non-protected) buffered item first if `capacity` would be exceeded. If a
+     * `dependencyChain` was given and a prior eviction broke it without a later sync
+     * point already buffered, chain-member items are silently discarded here until a
+     * fresh sync point item is pushed.
+     *
+     * @param item - The item to enqueue
+     */
+    push(item: T): void;
+    /**
+     * Marks the dependency chain (if configured) as broken by something outside this
+     * queue's own eviction - e.g. a producer detecting a sequence gap in items it never
+     * even offered here. The next chain-member item pushed is discarded unless it is
+     * itself a sync point, exactly as if a local eviction had cascaded off the end of
+     * the buffer. A no-op if no `dependencyChain` was configured.
+     */
+    notifyGap(): void;
+    /**
+     * Evicts one item to bring the queue back under capacity: the oldest non-protected
+     * item, or (if every buffered item is protected, which should not happen in
+     * practice) the true oldest one regardless. If the evicted item was a
+     * `dependencyChain` member, cascades to drop every following chain member up to
+     * the next sync point, setting {@link awaitingSyncPoint} if none is found.
+     */
+    private evictOnce;
+    /**
+     * Starting at `index`, removes chain-member items up to (not including) the next
+     * sync point, skipping over non-chain-member items (e.g. an interleaved audio
+     * track) in place without disturbing them.
+     *
+     * @returns True if a sync point was found (and kept), false if the scan reached
+     * the end of the buffer first
+     */
+    private dropDependentsFrom;
+    /**
+     * Ends the queue. Any already-buffered items are still delivered first; once
+     * drained, the async iterator completes, rejecting with `error` if one is given.
+     * A no-op if the queue has already ended.
+     *
+     * @param error - Optional error to surface to the consumer once buffered items are drained
+     */
+    end(error?: Error): void;
+    private next;
+    /**
+     * Async-iterates the queue, yielding items as they are pushed until {@link end} is called.
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<T>;
+}
+/**
+ * Validates local-port selection options for a live stream session.
+ *
+ * @param opts - Options containing an optional localPort and/or localPortRange
+ * @throws {TypeError} If both localPort and localPortRange are provided, or either is malformed
+ */
+export declare function validateLocalPortOpts(opts: LocalPortOpts): void;
+/**
+ * Resolves the local TCP port to use for the `adb forward` bridge: the exact
+ * `localPort` if given, the first free port in `localPortRange` if given, or an
+ * OS-assigned ephemeral port otherwise.
+ *
+ * @param opts - Port selection options; see {@link validateLocalPortOpts}
+ * @returns The bound, free local TCP port
+ * @throws {Error} If the requested port is busy, or no free port exists in the requested range
+ */
+export declare function resolveLocalPort(opts: LocalPortOpts): Promise<number>;
+/**
+ * Bridges the on-device local abstract socket to the host over `adb forward`,
+ * parses the streaming wire protocol, and exposes the result as a bounded
+ * async-iterable frame queue.
+ */
+export declare class StreamTransport {
+    private readonly adb;
+    private readonly localPort;
+    private readonly socket;
+    private readonly queue;
+    private readonly parserState;
+    private closed;
+    private lastVideoSequence;
+    private constructor();
+    /**
+     * Resolves a local port, forwards it to the on-device local abstract socket via
+     * `adb forward`, and connects to it (retrying until the on-device session accepts).
+     * On failure, any port forward that was already set up is best-effort removed.
+     *
+     * @param adb - ADB instance for device communication
+     * @param socketName - Name of the on-device local abstract socket to forward
+     * @param portOpts - Optional local port selection options
+     * @returns A connected StreamTransport instance
+     * @throws {Error} If the local port cannot be resolved, or the connection fails
+     */
+    static connect(adb: ADB, socketName: string, portOpts?: LocalPortOpts): Promise<StreamTransport>;
+    private wire;
+    /**
+     * Returns an async generator yielding parsed frames as they arrive on the socket,
+     * until the connection closes or errors.
+     */
+    frames(): AsyncGenerator<StreamFrame>;
+    /**
+     * Destroys the client socket and best-effort removes the `adb forward` port
+     * mapping. Safe to call more than once.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=streaming-transport.d.ts.map

package/build/lib/utils/streaming-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-transport.d.ts","sourceRoot":"","sources":["../../../lib/utils/streaming-transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,YAAY,CAAC;AAGpC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAA8C,KAAK,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAUtG;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,0FAA0F;IAC1F,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACpC,qFAAqF;IACrF,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB,CAAC,CAAC;IAS5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAVnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAC1E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,iBAAiB,CAAS;gBAGf,QAAQ,GAAE,MAA+B,EACzC,WAAW,CAAC,GAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,aAAA,EAClC,eAAe,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,YAAA;IAGvD;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAwBnB;;;;;;OAMG;IACH,SAAS,IAAI,IAAI;IAMjB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAcjB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAoBxB,OAAO,CAAC,IAAI;IAaZ;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;CASnD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAgB/D;AAgCD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B3E;AA+DD;;;;GAIG;AACH,qBAAa,eAAe;IAoBxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAfzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGnB;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,MAAM,CAAS;IAKvB,OAAO,CAAC,iBAAiB,CAAqB;IAE9C,OAAO;IAMP;;;;;;;;;;OAUG;WACU,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAe1G,OAAO,CAAC,IAAI;IAqBZ;;;OAGG;IACH,MAAM,IAAI,cAAc,CAAC,WAAW,CAAC;IAIrC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}