appium-ios-remotexpc 5.2.2 → 5.4.0

package/build/src/services/ios/app-service/index.d.ts

@@ -0,0 +1,150 @@
+import type { XPCDictionary } from '../../../lib/types.js';
+import { type CoreDeviceInvokeOptions, CoreDeviceService } from '../core-device/core-device-service.js';
+/** A process as reported by the device (pid + executable location). */
+export interface AppServiceProcessToken {
+    processIdentifier: number;
+    executableURL?: {
+        relative?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * An installed application entry. Only the most commonly used fields are typed;
+ * the device returns additional metadata accessible via the index signature.
+ */
+export interface InstalledApp {
+    bundleIdentifier?: string;
+    name?: string;
+    version?: string;
+    path?: string;
+    isRemovable?: boolean;
+    isInternal?: boolean;
+    isHidden?: boolean;
+    isAppClip?: boolean;
+    isDefault?: boolean;
+    [key: string]: unknown;
+}
+export interface ListAppsOptions {
+    includeAppClips?: boolean;
+    includeRemovableApps?: boolean;
+    includeHiddenApps?: boolean;
+    includeInternalApps?: boolean;
+    includeDefaultApps?: boolean;
+    /**
+     * Restrict results to apps the caller has container access to. Required by
+     * iOS 26+; defaults to false (list all apps).
+     */
+    requireContainerAccess?: boolean;
+    /**
+     * Include each app's app-group identifiers in the response. Required key on
+     * iOS 26+; defaults to false.
+     */
+    includeAppGroupIdentifiers?: boolean;
+    /**
+     * Include each app's on-device container paths in the response. Required key
+     * on iOS 26+; defaults to false.
+     */
+    includeContainerPaths?: boolean;
+    /**
+     * Override the default invocation timeout (ms). Recommended on iOS 26+, where
+     * the device may not respond to a full app enumeration over this path.
+     */
+    timeoutMs?: number;
+}
+export interface LaunchApplicationOptions {
+    /** Launch arguments passed to the application. */
+    arguments?: string[];
+    /** Environment variables to inject. */
+    environment?: Record<string, string>;
+    /** Start the process suspended (stopped) instead of running. */
+    startSuspended?: boolean;
+    /** Terminate an already-running instance before launching. Defaults to true. */
+    terminateExisting?: boolean;
+    /** Extra platform-specific options serialized into a plist. */
+    platformSpecificOptions?: Record<string, unknown>;
+    /** Override the default invocation timeout. */
+    timeoutMs?: number;
+}
+/** Result of launching an application. */
+export interface LaunchedApplication {
+    /** The launched process token (pid + executable location). */
+    processToken?: AppServiceProcessToken;
+    /** Convenience accessor for the launched process id, when available. */
+    processIdentifier?: number;
+    [key: string]: unknown;
+}
+/**
+ * CoreDevice AppService — manage applications and processes on the device.
+ *
+ * This is the modern (`devicectl`) backend for app lifecycle on iOS 17+: listing
+ * installed apps, launching/terminating apps, enumerating processes, signaling
+ * processes and uninstalling apps. Communicates over RemoteXPC via the shared
+ * {@link CoreDeviceService} invocation envelope.
+ *
+ * @example
+ * ```ts
+ * import { constants as osConstants } from 'node:os';
+ *
+ * const appService = await Services.startAppService(udid);
+ * try {
+ *   const launched = await appService.launchApplication('com.apple.Preferences');
+ *   await appService.sendSignalToProcess(
+ *     launched.processIdentifier!,
+ *     osConstants.signals.SIGKILL,
+ *   );
+ * } finally {
+ *   await appService.close();
+ * }
+ * ```
+ */
+export declare class AppService extends CoreDeviceService {
+    static readonly RSD_SERVICE_NAME = "com.apple.coredevice.appservice";
+    constructor(udid: string);
+    /**
+     * Lists installed applications. All categories are included by default.
+     *
+     * ⚠️ Limited on iOS 26+: the device gates app enumeration on this path and
+     * does not respond for requests that would return apps whose data containers
+     * the caller cannot access (the call hangs until `timeoutMs`). It only returns
+     * for result sets needing no container access (typically empty). For reliable
+     * app enumeration across iOS versions, prefer
+     * {@link InstallationProxyService.browse} (`Services.startInstallationProxyService`).
+     * This method remains for parity with the modern `devicectl`-style API and for
+     * environments/devices where the privileged context is available.
+     */
+    listApps(options?: ListAppsOptions): Promise<InstalledApp[]>;
+    /**
+     * Launches an application by bundle identifier and returns its process token.
+     *
+     * Throws a {@link CoreDeviceError} if the bundle id is not installed (the
+     * device reports e.g. "The requested application … is not installed.").
+     */
+    launchApplication(bundleId: string, options?: LaunchApplicationOptions): Promise<LaunchedApplication>;
+    /**
+     * Lists the processes currently running on the device.
+     */
+    listProcesses(): Promise<AppServiceProcessToken[]>;
+    /**
+     * Sends a POSIX signal to a process by pid. Use `os.constants.signals` for
+     * signal numbers (e.g. `SIGKILL` to terminate, `SIGTERM` to ask politely).
+     *
+     * Throws a {@link CoreDeviceError} if the pid is not running (the device
+     * reports `com.apple.dt.CoreDeviceError`).
+     */
+    sendSignalToProcess(pid: number, signal: number): Promise<XPCDictionary>;
+    /**
+     * Uninstalls an application by bundle identifier. This is idempotent: the
+     * device resolves successfully even if the app is not installed.
+     */
+    uninstallApp(bundleId: string): Promise<void>;
+    /**
+     * Monitors termination of a process and resolves with its exit status
+     * (`{ status: { exitCode, wasCoreDumpCreated } }`). If the pid is not running,
+     * the device resolves immediately rather than waiting. Pass `timeoutMs` via
+     * `options` to bound how long to wait for a still-running process to exit.
+     */
+    monitorProcessTermination(pid: number, options?: CoreDeviceInvokeOptions): Promise<XPCDictionary>;
+}
+export default AppService;
+//# sourceMappingURL=index.d.ts.map

package/build/src/services/ios/app-service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/app-service/index.ts"],"names":[],"mappings":"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"}

package/build/src/services/ios/app-service/index.js

@@ -0,0 +1,151 @@
+import { createPlist } from '../../../lib/plist/index.js';
+import { CoreDeviceService, } from '../core-device/core-device-service.js';
+const FEATURE_LIST_APPS = 'com.apple.coredevice.feature.listapps';
+const FEATURE_LAUNCH_APPLICATION = 'com.apple.coredevice.feature.launchapplication';
+const FEATURE_LIST_PROCESSES = 'com.apple.coredevice.feature.listprocesses';
+const FEATURE_UNINSTALL_APP = 'com.apple.coredevice.feature.uninstallapp';
+const FEATURE_SEND_SIGNAL = 'com.apple.coredevice.feature.sendsignaltoprocess';
+const FEATURE_MONITOR_PROCESS_TERMINATION = 'com.apple.coredevice.feature.monitorprocesstermination';
+/**
+ * CoreDevice AppService — manage applications and processes on the device.
+ *
+ * This is the modern (`devicectl`) backend for app lifecycle on iOS 17+: listing
+ * installed apps, launching/terminating apps, enumerating processes, signaling
+ * processes and uninstalling apps. Communicates over RemoteXPC via the shared
+ * {@link CoreDeviceService} invocation envelope.
+ *
+ * @example
+ * ```ts
+ * import { constants as osConstants } from 'node:os';
+ *
+ * const appService = await Services.startAppService(udid);
+ * try {
+ *   const launched = await appService.launchApplication('com.apple.Preferences');
+ *   await appService.sendSignalToProcess(
+ *     launched.processIdentifier!,
+ *     osConstants.signals.SIGKILL,
+ *   );
+ * } finally {
+ *   await appService.close();
+ * }
+ * ```
+ */
+export class AppService extends CoreDeviceService {
+    static RSD_SERVICE_NAME = 'com.apple.coredevice.appservice';
+    constructor(udid) {
+        super(udid, AppService.RSD_SERVICE_NAME);
+    }
+    /**
+     * Lists installed applications. All categories are included by default.
+     *
+     * ⚠️ Limited on iOS 26+: the device gates app enumeration on this path and
+     * does not respond for requests that would return apps whose data containers
+     * the caller cannot access (the call hangs until `timeoutMs`). It only returns
+     * for result sets needing no container access (typically empty). For reliable
+     * app enumeration across iOS versions, prefer
+     * {@link InstallationProxyService.browse} (`Services.startInstallationProxyService`).
+     * This method remains for parity with the modern `devicectl`-style API and for
+     * environments/devices where the privileged context is available.
+     */
+    async listApps(options = {}) {
+        const output = await this.invoke(FEATURE_LIST_APPS, {
+            includeAppClips: options.includeAppClips ?? true,
+            includeRemovableApps: options.includeRemovableApps ?? true,
+            includeHiddenApps: options.includeHiddenApps ?? true,
+            includeInternalApps: options.includeInternalApps ?? true,
+            includeDefaultApps: options.includeDefaultApps ?? true,
+            requireContainerAccess: options.requireContainerAccess ?? false,
+            includeAppGroupIdentifiers: options.includeAppGroupIdentifiers ?? false,
+            includeContainerPaths: options.includeContainerPaths ?? false,
+        }, { timeoutMs: options.timeoutMs });
+        return asArray(output);
+    }
+    /**
+     * Launches an application by bundle identifier and returns its process token.
+     *
+     * Throws a {@link CoreDeviceError} if the bundle id is not installed (the
+     * device reports e.g. "The requested application … is not installed.").
+     */
+    async launchApplication(bundleId, options = {}) {
+        const platformOptions = createPlist((options.platformSpecificOptions ?? {}));
+        const platformOptionsBuffer = Buffer.isBuffer(platformOptions)
+            ? platformOptions
+            : Buffer.from(platformOptions, 'utf8');
+        const output = asDict(await this.invoke(FEATURE_LAUNCH_APPLICATION, {
+            applicationSpecifier: {
+                bundleIdentifier: { _0: bundleId },
+            },
+            options: {
+                arguments: options.arguments ?? [],
+                environmentVariables: options.environment ?? {},
+                standardIOUsesPseudoterminals: true,
+                startStopped: options.startSuspended ?? false,
+                terminateExisting: options.terminateExisting ?? true,
+                user: { shortName: 'mobile' },
+                platformSpecificOptions: platformOptionsBuffer,
+            },
+            standardIOIdentifiers: {},
+        }, { timeoutMs: options.timeoutMs }));
+        return {
+            ...output,
+            processIdentifier: extractProcessIdentifier(output),
+        };
+    }
+    /**
+     * Lists the processes currently running on the device.
+     */
+    async listProcesses() {
+        const output = asDict(await this.invoke(FEATURE_LIST_PROCESSES));
+        return asArray(output.processTokens);
+    }
+    /**
+     * Sends a POSIX signal to a process by pid. Use `os.constants.signals` for
+     * signal numbers (e.g. `SIGKILL` to terminate, `SIGTERM` to ask politely).
+     *
+     * Throws a {@link CoreDeviceError} if the pid is not running (the device
+     * reports `com.apple.dt.CoreDeviceError`).
+     */
+    async sendSignalToProcess(pid, signal) {
+        return asDict(await this.invoke(FEATURE_SEND_SIGNAL, {
+            process: { processIdentifier: pid },
+            signal,
+        }));
+    }
+    /**
+     * Uninstalls an application by bundle identifier. This is idempotent: the
+     * device resolves successfully even if the app is not installed.
+     */
+    async uninstallApp(bundleId) {
+        await this.invoke(FEATURE_UNINSTALL_APP, { bundleIdentifier: bundleId });
+    }
+    /**
+     * Monitors termination of a process and resolves with its exit status
+     * (`{ status: { exitCode, wasCoreDumpCreated } }`). If the pid is not running,
+     * the device resolves immediately rather than waiting. Pass `timeoutMs` via
+     * `options` to bound how long to wait for a still-running process to exit.
+     */
+    async monitorProcessTermination(pid, options = {}) {
+        return asDict(await this.invoke(FEATURE_MONITOR_PROCESS_TERMINATION, { processToken: { processIdentifier: pid } }, options));
+    }
+}
+function asDict(value) {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        return value;
+    }
+    return {};
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function extractProcessIdentifier(output) {
+    const token = output.processToken;
+    if (token && typeof token === 'object' && !Array.isArray(token)) {
+        const pid = token.processIdentifier;
+        if (typeof pid === 'number') {
+            return pid;
+        }
+    }
+    return undefined;
+}
+export default AppService;
+//# sourceMappingURL=index.js.map

package/build/src/services/ios/app-service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/services/ios/app-service/index.ts"],"names":[],"mappings":"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"}

package/build/src/services/ios/core-device/core-device-service.d.ts

@@ -0,0 +1,70 @@
+import { RemoteXpcFramedTransport } from '../../../lib/remote-xpc/remote-xpc-framed-transport.js';
+import type { XPCDictionary, XPCValue } from '../../../lib/types.js';
+import { BaseService } from '../base-service.js';
+export interface CoreDeviceInvokeOptions {
+    /** Optional action identifier for the invocation. */
+    actionIdentifier?: string;
+    /** Override the default response timeout. */
+    timeoutMs?: number;
+}
+/**
+ * Error thrown when a CoreDevice invocation fails or returns no output.
+ */
+export declare class CoreDeviceError extends Error {
+    readonly response?: XPCDictionary;
+    constructor(message: string, response?: XPCDictionary);
+}
+/**
+ * Base class for iOS CoreDevice (`com.apple.coredevice.*`) services.
+ *
+ * CoreDevice services speak RemoteXPC over the tunnel and wrap every request in
+ * a common invocation envelope. This base owns the framed transport lifecycle
+ * and exposes:
+ *   - {@link invoke} for request/response features (the common case)
+ *   - {@link send} for fire-and-forget messages (e.g. HID events)
+ *
+ * Subclasses pass their RSD service name to the constructor and typically also
+ * expose it via a static `RSD_SERVICE_NAME` for catalog checks.
+ */
+export declare abstract class CoreDeviceService extends BaseService {
+    private readonly serviceName;
+    protected transport: RemoteXpcFramedTransport | null;
+    protected nextMessageId: number;
+    /** Serializes invocations so concurrent calls do not interleave replies. */
+    private invokeQueue;
+    constructor(udid: string, serviceName: string);
+    close(): Promise<void>;
+    /**
+     * Sends a fire-and-forget XPC message on the root channel. Used by services
+     * that do not expect a reply (e.g. HID event streams).
+     */
+    protected send(body: XPCDictionary): Promise<void>;
+    /**
+     * Invokes a CoreDevice feature and returns its `CoreDevice.output`.
+     *
+     * Each invocation uses a fresh connection: CoreDevice services close the
+     * connection after a request/response cycle, so reusing a connection
+     * across invocations fails. Calls are also serialized, so they never overlap.
+     */
+    protected invoke(featureIdentifier?: string, input?: XPCDictionary, options?: CoreDeviceInvokeOptions): Promise<XPCValue>;
+    protected createTransport(): Promise<RemoteXpcFramedTransport>;
+    protected getTransport(): Promise<RemoteXpcFramedTransport>;
+    /**
+     * Creates a transport and attaches a permanent `'error'` listener. The
+     * framed transport is an EventEmitter; an `'error'` emitted with no listener
+     * is thrown by Node and crashes the process. `invoke()` registers a per-call
+     * listener, but fire-and-forget `send()` does not — so this guarantees a
+     * listener always exists for the transport's lifetime.
+     */
+    private newTransport;
+    /**
+     * Closes any existing connection and opens a fresh one. Used by {@link invoke}
+     * because CoreDevice services are one-shot per connection.
+     */
+    private refreshTransport;
+    private invokeInternal;
+    private buildEnvelope;
+    private waitForResponse;
+}
+export default CoreDeviceService;
+//# sourceMappingURL=core-device-service.d.ts.map

package/build/src/services/ios/core-device/core-device-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-device-service.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/core-device/core-device-service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAElG,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA6BjD,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa;CAKtD;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,iBAAkB,SAAQ,WAAW;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,SAAS,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAQ;IAC5D,SAAS,CAAC,aAAa,SAAK;IAE5B,4EAA4E;IAC5E,OAAO,CAAC,WAAW,CAAuC;gBAE9C,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;;OAGG;cACa,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxD;;;;;;OAMG;cACa,MAAM,CACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,KAAK,GAAE,aAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,QAAQ,CAAC;cAuBJ,eAAe,IAAI,OAAO,CAAC,wBAAwB,CAAC;cAQpD,YAAY,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAOjE;;;;;;OAMG;YACW,YAAY;IAS1B;;;OAGG;YACW,gBAAgB;YAUhB,cAAc;IAuC5B,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,eAAe;CA4DxB;AAqDD,eAAe,iBAAiB,CAAC"}

package/build/src/services/ios/core-device/core-device-service.js

@@ -0,0 +1,262 @@
+import { randomUUID } from 'node:crypto';
+import { getLogger } from '../../../lib/logger.js';
+import { Http2Constants, XpcConstants, } from '../../../lib/remote-xpc/constants.js';
+import { RemoteXpcFramedTransport } from '../../../lib/remote-xpc/remote-xpc-framed-transport.js';
+import { encodeMessage } from '../../../lib/remote-xpc/xpc-protocol.js';
+import { BaseService } from '../base-service.js';
+const log = getLogger('CoreDeviceService');
+const CONNECT_TIMEOUT_MS = 10_000;
+const DEFAULT_INVOKE_TIMEOUT_MS = 30_000;
+/**
+ * CoreDevice protocol version reported to the device.
+ */
+const CORE_DEVICE_VERSION_STRING = '629.3';
+const CORE_DEVICE_DDI_PROTOCOL_VERSION = 2;
+/**
+ * Builds the `CoreDevice.coreDeviceVersion` dictionary. `components` are encoded
+ * as XPC uint64 values (hence `bigint`), while `originalComponentsCount` is an
+ * int64 (a plain integer).
+ */
+function buildCoreDeviceVersion(version) {
+    const components = version.split('.');
+    return {
+        components: components.map((component) => BigInt(component)),
+        originalComponentsCount: components.length,
+        stringValue: version,
+    };
+}
+const CORE_DEVICE_VERSION = buildCoreDeviceVersion(CORE_DEVICE_VERSION_STRING);
+/**
+ * Error thrown when a CoreDevice invocation fails or returns no output.
+ */
+export class CoreDeviceError extends Error {
+    response;
+    constructor(message, response) {
+        super(message);
+        this.name = 'CoreDeviceError';
+        this.response = response;
+    }
+}
+/**
+ * Base class for iOS CoreDevice (`com.apple.coredevice.*`) services.
+ *
+ * CoreDevice services speak RemoteXPC over the tunnel and wrap every request in
+ * a common invocation envelope. This base owns the framed transport lifecycle
+ * and exposes:
+ *   - {@link invoke} for request/response features (the common case)
+ *   - {@link send} for fire-and-forget messages (e.g. HID events)
+ *
+ * Subclasses pass their RSD service name to the constructor and typically also
+ * expose it via a static `RSD_SERVICE_NAME` for catalog checks.
+ */
+export class CoreDeviceService extends BaseService {
+    serviceName;
+    transport = null;
+    nextMessageId = 1;
+    /** Serializes invocations so concurrent calls do not interleave replies. */
+    invokeQueue = Promise.resolve();
+    constructor(udid, serviceName) {
+        super(udid);
+        this.serviceName = serviceName;
+    }
+    async close() {
+        if (!this.transport) {
+            return;
+        }
+        const transport = this.transport;
+        this.transport = null;
+        await transport.close();
+    }
+    /**
+     * Sends a fire-and-forget XPC message on the root channel. Used by services
+     * that do not expect a reply (e.g. HID event streams).
+     */
+    async send(body) {
+        const transport = await this.getTransport();
+        transport.sendDataFrame(encodeMessage({
+            flags: XpcConstants.XPC_FLAGS_ALWAYS_SET |
+                XpcConstants.XPC_FLAGS_DATA_PRESENT,
+            id: this.nextMessageId++,
+            body,
+        }), Http2Constants.ROOT_CHANNEL);
+    }
+    /**
+     * Invokes a CoreDevice feature and returns its `CoreDevice.output`.
+     *
+     * Each invocation uses a fresh connection: CoreDevice services close the
+     * connection after a request/response cycle, so reusing a connection
+     * across invocations fails. Calls are also serialized, so they never overlap.
+     */
+    async invoke(featureIdentifier, input = {}, options = {}) {
+        // Serialize invocations: await the previous call's completion, then install
+        // a new tail that the next caller will await. Prior failures are ignored so
+        // one failed call does not poison the queue.
+        const previous = this.invokeQueue;
+        let release = () => undefined;
+        this.invokeQueue = new Promise((resolve) => {
+            release = resolve;
+        });
+        try {
+            await previous;
+        }
+        catch {
+            // Ignore the previous invocation's outcome.
+        }
+        try {
+            return await this.invokeInternal(featureIdentifier, input, options);
+        }
+        finally {
+            release();
+        }
+    }
+    async createTransport() {
+        const transport = new RemoteXpcFramedTransport(await this.resolveServiceAddress(this.serviceName));
+        await transport.connect({ timeoutMs: CONNECT_TIMEOUT_MS });
+        return transport;
+    }
+    async getTransport() {
+        if (!this.transport?.isConnected) {
+            this.transport = await this.newTransport();
+        }
+        return this.transport;
+    }
+    /**
+     * Creates a transport and attaches a permanent `'error'` listener. The
+     * framed transport is an EventEmitter; an `'error'` emitted with no listener
+     * is thrown by Node and crashes the process. `invoke()` registers a per-call
+     * listener, but fire-and-forget `send()` does not — so this guarantees a
+     * listener always exists for the transport's lifetime.
+     */
+    async newTransport() {
+        const transport = await this.createTransport();
+        transport.on('error', (error) => {
+            log.debug(`CoreDevice transport error: ${error.message}`);
+        });
+        this.nextMessageId = 1;
+        return transport;
+    }
+    /**
+     * Closes any existing connection and opens a fresh one. Used by {@link invoke}
+     * because CoreDevice services are one-shot per connection.
+     */
+    async refreshTransport() {
+        if (this.transport) {
+            const previous = this.transport;
+            this.transport = null;
+            await previous.close().catch(() => undefined);
+        }
+        this.transport = await this.newTransport();
+        return this.transport;
+    }
+    async invokeInternal(featureIdentifier, input, options) {
+        const transport = await this.refreshTransport();
+        const request = this.buildEnvelope(featureIdentifier, input, options.actionIdentifier);
+        // Register the response listener before sending so a fast reply is not lost.
+        const responsePromise = this.waitForResponse(transport, options.timeoutMs ?? DEFAULT_INVOKE_TIMEOUT_MS, featureIdentifier);
+        transport.sendDataFrame(encodeMessage({
+            flags: XpcConstants.XPC_FLAGS_ALWAYS_SET |
+                XpcConstants.XPC_FLAGS_DATA_PRESENT |
+                XpcConstants.XPC_FLAGS_WANTING_REPLY,
+            id: this.nextMessageId++,
+            body: request,
+        }), Http2Constants.ROOT_CHANNEL);
+        const response = await responsePromise;
+        const output = response['CoreDevice.output'];
+        if (output === undefined) {
+            throw buildInvocationError(featureIdentifier, response);
+        }
+        return output;
+    }
+    buildEnvelope(featureIdentifier, input, actionIdentifier) {
+        const request = {
+            'CoreDevice.CoreDeviceDDIProtocolVersion': CORE_DEVICE_DDI_PROTOCOL_VERSION,
+            'CoreDevice.coreDeviceVersion': CORE_DEVICE_VERSION,
+            'CoreDevice.deviceIdentifier': randomUUID(),
+            'CoreDevice.input': input,
+            'CoreDevice.invocationIdentifier': randomUUID(),
+        };
+        if (featureIdentifier !== undefined) {
+            request['CoreDevice.featureIdentifier'] = featureIdentifier;
+            request['CoreDevice.action'] = {};
+        }
+        if (actionIdentifier !== undefined) {
+            request['CoreDevice.actionIdentifier'] = actionIdentifier;
+        }
+        return request;
+    }
+    waitForResponse(transport, timeoutMs, featureIdentifier) {
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const cleanup = () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                clearTimeout(timer);
+                transport.off('message', onMessage);
+                transport.off('error', onError);
+                transport.off('close', onClose);
+            };
+            const onMessage = (body) => {
+                // Skip empty/handshake acks; the real reply carries CoreDevice.* keys.
+                if (!body ||
+                    typeof body !== 'object' ||
+                    Object.keys(body).length === 0) {
+                    return;
+                }
+                cleanup();
+                resolve(body);
+            };
+            const onError = (error) => {
+                cleanup();
+                reject(error);
+            };
+            const onClose = () => {
+                cleanup();
+                reject(new CoreDeviceError(`CoreDevice connection closed while awaiting '${featureIdentifier ?? '<none>'}'`));
+            };
+            const timer = setTimeout(() => {
+                cleanup();
+                reject(new CoreDeviceError(`CoreDevice invocation '${featureIdentifier ?? '<none>'}' timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            transport.on('message', onMessage);
+            transport.once('error', onError);
+            transport.once('close', onClose);
+        });
+    }
+}
+/**
+ * Builds a descriptive error from a CoreDevice reply that carries no output.
+ * The device returns an `NSError`-shaped `CoreDevice.error` whose `userInfo`
+ * holds a human-readable reason; surface it so callers can tell *why* (e.g. a
+ * missing bundle id or pid) instead of a generic failure.
+ */
+function buildInvocationError(featureIdentifier, response) {
+    const feature = featureIdentifier ?? '<none>';
+    const deviceError = response['CoreDevice.error'];
+    if (!deviceError ||
+        typeof deviceError !== 'object' ||
+        Array.isArray(deviceError)) {
+        return new CoreDeviceError(`CoreDevice invocation '${feature}' returned no output`, response);
+    }
+    const error = deviceError;
+    const userInfo = error.userInfo && typeof error.userInfo === 'object'
+        ? error.userInfo
+        : {};
+    const reason = pickString(userInfo.NSLocalizedDescription) ??
+        pickString(userInfo.NSLocalizedFailureReason) ??
+        pickString(userInfo.NSDebugDescription) ??
+        'unknown error';
+    const failureReason = pickString(userInfo.NSLocalizedFailureReason);
+    const detail = failureReason && failureReason !== reason
+        ? `${reason} ${failureReason}`
+        : reason;
+    const domain = pickString(error.domain) ?? 'unknown';
+    const code = typeof error.code === 'number' ? ` ${error.code}` : '';
+    return new CoreDeviceError(`CoreDevice '${feature}' failed: ${detail} [${domain}${code}]`, response);
+}
+function pickString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+export default CoreDeviceService;
+//# sourceMappingURL=core-device-service.js.map

package/build/src/services/ios/core-device/core-device-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-device-service.js","sourceRoot":"","sources":["../../../../../src/services/ios/core-device/core-device-service.ts"],"names":[],"mappings":"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"}