appium-ios-remotexpc 0.13.2 → 0.15.0

package/build/src/services/ios/dvt/instruments/location-simulation.d.ts

@@ -0,0 +1,43 @@
+import type { DVTSecureSocketProxyService } from '../index.js';
+/**
+ * Geographic coordinates
+ */
+export interface LocationCoordinates {
+    latitude: number;
+    longitude: number;
+}
+/**
+ * Location simulation service for simulating device GPS location
+ */
+export declare class LocationSimulation {
+    private readonly dvt;
+    static readonly IDENTIFIER = "com.apple.instruments.server.services.LocationSimulation";
+    private channel;
+    constructor(dvt: DVTSecureSocketProxyService);
+    /**
+     * Initialize the location simulation channel
+     */
+    initialize(): Promise<void>;
+    /**
+     * Set the simulated GPS location
+     * @param coordinates The location coordinates
+     */
+    set(coordinates: LocationCoordinates): Promise<void>;
+    /**
+     * Set the simulated GPS location
+     * @param latitude The latitude coordinate
+     * @param longitude The longitude coordinate
+     */
+    setLocation(latitude: number, longitude: number): Promise<void>;
+    /**
+     * Stop location simulation and restore the actual device location
+     *
+     * Note: This method is safe to call even if no location simulation is currently active.
+     */
+    clear(): Promise<void>;
+    /**
+     * Stop location simulation (alias for clear)
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=location-simulation.d.ts.map

package/build/src/services/ios/dvt/instruments/location-simulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location-simulation.d.ts","sourceRoot":"","sources":["../../../../../../src/services/ios/dvt/instruments/location-simulation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAMjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALhC,MAAM,CAAC,QAAQ,CAAC,UAAU,8DACmC;IAE7D,OAAO,CAAC,OAAO,CAAwB;gBAEV,GAAG,EAAE,2BAA2B;IAE7D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;;OAGG;IACG,GAAG,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D;;;;OAIG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/build/src/services/ios/dvt/instruments/location-simulation.js

@@ -0,0 +1,60 @@
+import { getLogger } from '../../../../lib/logger.js';
+import { MessageAux } from '../dtx-message.js';
+const log = getLogger('LocationSimulation');
+/**
+ * Location simulation service for simulating device GPS location
+ */
+export class LocationSimulation {
+    dvt;
+    static IDENTIFIER = 'com.apple.instruments.server.services.LocationSimulation';
+    channel = null;
+    constructor(dvt) {
+        this.dvt = dvt;
+    }
+    /**
+     * Initialize the location simulation channel
+     */
+    async initialize() {
+        if (this.channel) {
+            return;
+        }
+        this.channel = await this.dvt.makeChannel(LocationSimulation.IDENTIFIER);
+    }
+    /**
+     * Set the simulated GPS location
+     * @param coordinates The location coordinates
+     */
+    async set(coordinates) {
+        await this.initialize();
+        const args = new MessageAux()
+            .appendObj(coordinates.latitude)
+            .appendObj(coordinates.longitude);
+        await this.channel.call('simulateLocationWithLatitude_longitude_')(args);
+        await this.channel.receivePlist();
+        log.info(`Location set to: ${coordinates.latitude}, ${coordinates.longitude}`);
+    }
+    /**
+     * Set the simulated GPS location
+     * @param latitude The latitude coordinate
+     * @param longitude The longitude coordinate
+     */
+    async setLocation(latitude, longitude) {
+        await this.set({ latitude, longitude });
+    }
+    /**
+     * Stop location simulation and restore the actual device location
+     *
+     * Note: This method is safe to call even if no location simulation is currently active.
+     */
+    async clear() {
+        await this.initialize();
+        await this.channel.call('stopLocationSimulation')();
+        log.info('Location simulation stopped');
+    }
+    /**
+     * Stop location simulation (alias for clear)
+     */
+    async stop() {
+        await this.clear();
+    }
+}

package/build/src/services/ios/dvt/instruments/screenshot.d.ts

@@ -0,0 +1,17 @@
+import type { DVTSecureSocketProxyService } from '../index.js';
+/**
+ * Screenshot service for capturing device screenshots
+ */
+export declare class Screenshot {
+    private readonly dvt;
+    static readonly IDENTIFIER = "com.apple.instruments.server.services.screenshot";
+    private channel;
+    constructor(dvt: DVTSecureSocketProxyService);
+    initialize(): Promise<void>;
+    /**
+     * Capture a screenshot from the device
+     * @returns The screenshot data as a Buffer
+     */
+    getScreenshot(): Promise<Buffer>;
+}
+//# sourceMappingURL=screenshot.d.ts.map

package/build/src/services/ios/dvt/instruments/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../../../../src/services/ios/dvt/instruments/screenshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAI/D;;GAEG;AACH,qBAAa,UAAU;IAMT,OAAO,CAAC,QAAQ,CAAC,GAAG;IALhC,MAAM,CAAC,QAAQ,CAAC,UAAU,sDAC2B;IAErD,OAAO,CAAC,OAAO,CAAwB;gBAEV,GAAG,EAAE,2BAA2B;IAEvD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CAmBvC"}

package/build/src/services/ios/dvt/instruments/screenshot.js

@@ -0,0 +1,35 @@
+import { getLogger } from '../../../../lib/logger.js';
+const log = getLogger('Screenshot');
+/**
+ * Screenshot service for capturing device screenshots
+ */
+export class Screenshot {
+    dvt;
+    static IDENTIFIER = 'com.apple.instruments.server.services.screenshot';
+    channel = null;
+    constructor(dvt) {
+        this.dvt = dvt;
+    }
+    async initialize() {
+        if (!this.channel) {
+            this.channel = await this.dvt.makeChannel(Screenshot.IDENTIFIER);
+        }
+    }
+    /**
+     * Capture a screenshot from the device
+     * @returns The screenshot data as a Buffer
+     */
+    async getScreenshot() {
+        await this.initialize();
+        await this.channel.call('takeScreenshot')();
+        const result = await this.channel.receivePlist();
+        if (!result) {
+            throw new Error('Failed to capture screenshot: received null response');
+        }
+        if (!Buffer.isBuffer(result)) {
+            throw new Error(`Unexpected response format from getScreenshot: expected Buffer, got ${typeof result}`);
+        }
+        log.info(`Screenshot captured successfully (${result.length} bytes)`);
+        return result;
+    }
+}

package/build/src/services/ios/dvt/nskeyedarchiver-decoder.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Decode NSKeyedArchiver formatted data into native JavaScript objects
+ *
+ * NSKeyedArchiver is Apple's serialization format that stores object graphs
+ * with references. The format includes:
+ * - $version: Archive version (typically 100000)
+ * - $archiver: "NSKeyedArchiver"
+ * - $top: Root object references
+ * - $objects: Array of all objects with cross-references
+ */
+export declare class NSKeyedArchiverDecoder {
+    private readonly objects;
+    private readonly decoded;
+    private readonly archive;
+    constructor(data: any);
+    /**
+     * Check if data is in NSKeyedArchiver format
+     */
+    static isNSKeyedArchive(data: any): boolean;
+    /**
+     * Decode the entire archive starting from the root
+     */
+    decode(): any;
+    /**
+     * Decode an object at a specific index
+     */
+    private decodeObject;
+    /**
+     * Decode an NSArray
+     */
+    private decodeArray;
+    /**
+     * Decode an NSDictionary
+     */
+    private decodeDictionary;
+}
+/**
+ * Decode NSKeyedArchiver data or return as-is if not archived
+ */
+export declare function decodeNSKeyedArchiver(data: any): any;
+//# sourceMappingURL=nskeyedarchiver-decoder.d.ts.map

package/build/src/services/ios/dvt/nskeyedarchiver-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nskeyedarchiver-decoder.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/dvt/nskeyedarchiver-decoder.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;gBAElB,IAAI,EAAE,GAAG;IAUrB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO;IAa3C;;OAEG;IACH,MAAM,IAAI,GAAG;IA8Bb;;OAEG;IACH,OAAO,CAAC,YAAY;IAkFpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAkBzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAiBpD"}

package/build/src/services/ios/dvt/nskeyedarchiver-decoder.js

@@ -0,0 +1,195 @@
+import { getLogger } from '../../../lib/logger.js';
+const log = getLogger('NSKeyedArchiverDecoder');
+/**
+ * Decode NSKeyedArchiver formatted data into native JavaScript objects
+ *
+ * NSKeyedArchiver is Apple's serialization format that stores object graphs
+ * with references. The format includes:
+ * - $version: Archive version (typically 100000)
+ * - $archiver: "NSKeyedArchiver"
+ * - $top: Root object references
+ * - $objects: Array of all objects with cross-references
+ */
+export class NSKeyedArchiverDecoder {
+    objects;
+    decoded;
+    archive;
+    constructor(data) {
+        if (!NSKeyedArchiverDecoder.isNSKeyedArchive(data)) {
+            throw new Error('Data is not in NSKeyedArchiver format');
+        }
+        this.archive = data;
+        this.objects = data.$objects || [];
+        this.decoded = new Map();
+    }
+    /**
+     * Check if data is in NSKeyedArchiver format
+     */
+    static isNSKeyedArchive(data) {
+        if (!data || typeof data !== 'object') {
+            return false;
+        }
+        return ('$archiver' in data &&
+            data.$archiver === 'NSKeyedArchiver' &&
+            '$objects' in data &&
+            Array.isArray(data.$objects));
+    }
+    /**
+     * Decode the entire archive starting from the root
+     */
+    decode() {
+        if (!this.objects || this.objects.length === 0) {
+            return null;
+        }
+        // Extract root reference from $top
+        let rootIndex = null;
+        if (this.archive.$top && typeof this.archive.$top === 'object') {
+            const top = this.archive.$top;
+            if ('root' in top) {
+                const root = top.root;
+                if (typeof root === 'number') {
+                    rootIndex = root;
+                }
+                else if (typeof root === 'object' && root && 'CF$UID' in root) {
+                    rootIndex = root.CF$UID;
+                }
+            }
+        }
+        // If we found the root index, decode it
+        if (rootIndex !== null) {
+            return this.decodeObject(rootIndex);
+        }
+        // Fallback: decode first non-null object
+        log.warn('Could not find root reference, using fallback');
+        return this.decodeObject(1);
+    }
+    /**
+     * Decode an object at a specific index
+     */
+    decodeObject(index) {
+        if (index < 0 || index >= this.objects.length) {
+            return null;
+        }
+        // Check cache
+        if (this.decoded.has(index)) {
+            return this.decoded.get(index);
+        }
+        const obj = this.objects[index];
+        // Handle null marker
+        if (obj === '$null' || obj === null) {
+            return null;
+        }
+        // Handle primitive types
+        if (typeof obj !== 'object') {
+            return obj;
+        }
+        // Handle Buffer/binary data (eg. screenshots)
+        if (Buffer.isBuffer(obj)) {
+            this.decoded.set(index, obj);
+            return obj;
+        }
+        // Handle UID references
+        if ('CF$UID' in obj) {
+            return this.decodeObject(obj.CF$UID);
+        }
+        // Handle NSDictionary (NS.keys + NS.objects) - check this FIRST before NSArray
+        if ('NS.keys' in obj && 'NS.objects' in obj) {
+            const result = this.decodeDictionary(obj['NS.keys'], obj['NS.objects']);
+            this.decoded.set(index, result);
+            return result;
+        }
+        // Handle NSArray (NS.objects only, without NS.keys)
+        if ('NS.objects' in obj) {
+            const result = this.decodeArray(obj['NS.objects']);
+            this.decoded.set(index, result);
+            return result;
+        }
+        // Handle regular objects - just return as-is but resolve references
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (key === '$class') {
+                continue; // Skip class metadata
+            }
+            if (typeof value === 'number') {
+                // Could be a reference or primitive
+                const referenced = this.objects[value];
+                if (referenced &&
+                    typeof referenced === 'object' &&
+                    referenced !== '$null') {
+                    result[key] = this.decodeObject(value);
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+            else if (typeof value === 'object' && value && 'CF$UID' in value) {
+                const uid = value.CF$UID;
+                if (typeof uid === 'number') {
+                    result[key] = this.decodeObject(uid);
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        this.decoded.set(index, result);
+        return result;
+    }
+    /**
+     * Decode an NSArray
+     */
+    decodeArray(refs) {
+        if (!Array.isArray(refs)) {
+            return [];
+        }
+        return refs.map((ref) => {
+            if (typeof ref === 'number') {
+                return this.decodeObject(ref);
+            }
+            else if (typeof ref === 'object' && ref && 'CF$UID' in ref) {
+                return this.decodeObject(ref.CF$UID);
+            }
+            return ref;
+        });
+    }
+    /**
+     * Decode an NSDictionary
+     */
+    decodeDictionary(keyRefs, valueRefs) {
+        if (!Array.isArray(keyRefs) || !Array.isArray(valueRefs)) {
+            return {};
+        }
+        const result = {};
+        for (let i = 0; i < keyRefs.length && i < valueRefs.length; i++) {
+            const key = this.decodeObject(keyRefs[i]);
+            const value = this.decodeObject(valueRefs[i]);
+            if (typeof key === 'string') {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Decode NSKeyedArchiver data or return as-is if not archived
+ */
+export function decodeNSKeyedArchiver(data) {
+    if (!data) {
+        return data;
+    }
+    // Check if this is NSKeyedArchiver format
+    if (!NSKeyedArchiverDecoder.isNSKeyedArchive(data)) {
+        return data;
+    }
+    try {
+        const decoder = new NSKeyedArchiverDecoder(data);
+        return decoder.decode();
+    }
+    catch (error) {
+        log.warn('Failed to decode NSKeyedArchiver data:', error);
+        return data;
+    }
+}

package/build/src/services/ios/dvt/utils.d.ts

@@ -0,0 +1,19 @@
+import type { PlistDictionary } from '../../../lib/types.js';
+export declare function isPlainObject(value: any): value is Record<string, any>;
+export declare function hasProperties(obj: any, ...props: string[]): boolean;
+export declare function isNSKeyedArchiverFormat(data: any): boolean;
+export declare function isNSDictionaryFormat(obj: any): boolean;
+export declare function hasNSErrorIndicators(obj: any): boolean;
+/**
+ * Extract $objects array from NSKeyedArchiver format, returns null if invalid
+ */
+export declare function extractNSKeyedArchiverObjects(data: any): any[] | null;
+/**
+ * Extract NSDictionary from NSKeyedArchiver objects using key/value references
+ */
+export declare function extractNSDictionary(dictObj: any, objects: any[]): PlistDictionary;
+/**
+ * Extract strings from NSKeyedArchiver objects array as dictionary keys
+ */
+export declare function extractCapabilityStrings(objects: any[]): PlistDictionary;
+//# sourceMappingURL=utils.d.ts.map

package/build/src/services/ios/dvt/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/dvt/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEtE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAEnE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAM1D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAEtD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAOtD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI,CAOrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EAAE,GACb,eAAe,CAsBjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,eAAe,CAYxE"}

package/build/src/services/ios/dvt/utils.js

@@ -0,0 +1,67 @@
+export function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function hasProperties(obj, ...props) {
+    return isPlainObject(obj) ? props.every((prop) => prop in obj) : false;
+}
+export function isNSKeyedArchiverFormat(data) {
+    return (hasProperties(data, '$objects') &&
+        Array.isArray(data.$objects) &&
+        data.$objects.length > 0);
+}
+export function isNSDictionaryFormat(obj) {
+    return hasProperties(obj, 'NS.keys', 'NS.objects');
+}
+export function hasNSErrorIndicators(obj) {
+    if (!isPlainObject(obj)) {
+        return false;
+    }
+    const errorProps = ['NSCode', 'NSUserInfo', 'NSDomain'];
+    return errorProps.some((prop) => prop in obj);
+}
+/**
+ * Extract $objects array from NSKeyedArchiver format, returns null if invalid
+ */
+export function extractNSKeyedArchiverObjects(data) {
+    if (!isNSKeyedArchiverFormat(data)) {
+        return null;
+    }
+    const objects = data.$objects;
+    return objects.length > 1 ? objects : null;
+}
+/**
+ * Extract NSDictionary from NSKeyedArchiver objects using key/value references
+ */
+export function extractNSDictionary(dictObj, objects) {
+    if (!isNSDictionaryFormat(dictObj)) {
+        return {};
+    }
+    const keysRef = dictObj['NS.keys'];
+    const valuesRef = dictObj['NS.objects'];
+    if (!Array.isArray(keysRef) || !Array.isArray(valuesRef)) {
+        return {};
+    }
+    const result = {};
+    for (let i = 0; i < keysRef.length; i++) {
+        const key = objects[keysRef[i]];
+        const value = objects[valuesRef[i]];
+        if (typeof key === 'string') {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Extract strings from NSKeyedArchiver objects array as dictionary keys
+ */
+export function extractCapabilityStrings(objects) {
+    const result = {};
+    // Start from index 1 because index 0 is always '$null' in NSKeyedArchiver format
+    for (let i = 1; i < objects.length; i++) {
+        const obj = objects[i];
+        if (typeof obj === 'string' && obj !== '$null') {
+            result[obj] = true;
+        }
+    }
+    return result;
+}

package/build/src/services.d.ts

@@ -1,5 +1,5 @@
 import { RemoteXpcConnection } from './lib/remote-xpc/remote-xpc-connection.js';
-import type { DiagnosticsServiceWithConnection, MisagentServiceWithConnection, MobileConfigServiceWithConnection, MobileImageMounterServiceWithConnection, NotificationProxyServiceWithConnection, PowerAssertionServiceWithConnection, SpringboardServiceWithConnection, SyslogService as SyslogServiceType, WebInspectorServiceWithConnection } from './lib/types.js';
+import type { DVTServiceWithConnection, DiagnosticsServiceWithConnection, MisagentServiceWithConnection, MobileConfigServiceWithConnection, MobileImageMounterServiceWithConnection, NotificationProxyServiceWithConnection, PowerAssertionServiceWithConnection, SpringboardServiceWithConnection, SyslogService as SyslogServiceType, WebInspectorServiceWithConnection } from './lib/types.js';
 import AfcService from './services/ios/afc/index.js';
 export declare function startDiagnosticsService(udid: string): Promise<DiagnosticsServiceWithConnection>;
 export declare function startNotificationProxyService(udid: string): Promise<NotificationProxyServiceWithConnection>;
@@ -15,6 +15,7 @@ export declare function startSyslogService(udid: string): Promise<SyslogServiceT
  */
 export declare function startAfcService(udid: string): Promise<AfcService>;
 export declare function startWebInspectorService(udid: string): Promise<WebInspectorServiceWithConnection>;
+export declare function startDVTService(udid: string): Promise<DVTServiceWithConnection>;
 export declare function createRemoteXPCConnection(udid: string): Promise<{
     remoteXPC: RemoteXpcConnection;
     tunnelConnection: {

package/build/src/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/services.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,OAAO,KAAK,EACV,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,gCAAgC,EAChC,aAAa,IAAI,iBAAiB,EAClC,iCAAiC,EAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAcrD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,sCAAsC,CAAC,CAYjD;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,uCAAuC,CAAC,CAYlD;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,6BAA6B,CAAC,CAYxC;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mCAAmC,CAAC,CAY9C;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM;;;;;;;;GAO3D"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/services.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,gCAAgC,EAChC,aAAa,IAAI,iBAAiB,EAClC,iCAAiC,EAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAkBrD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,sCAAsC,CAAC,CAYjD;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,uCAAuC,CAAC,CAYlD;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,6BAA6B,CAAC,CAYxC;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mCAAmC,CAAC,CAY9C;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,CAAC,CA2BnC;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM;;;;;;;;GAO3D"}

package/build/src/services.js

@@ -4,6 +4,10 @@ import { TunnelManager } from './lib/tunnel/index.js';
 import { TunnelApiClient } from './lib/tunnel/tunnel-api-client.js';
 import AfcService from './services/ios/afc/index.js';
 import DiagnosticsService from './services/ios/diagnostic-service/index.js';
+import { DVTSecureSocketProxyService } from './services/ios/dvt/index.js';
+import { ConditionInducer } from './services/ios/dvt/instruments/condition-inducer.js';
+import { LocationSimulation } from './services/ios/dvt/instruments/location-simulation.js';
+import { Screenshot } from './services/ios/dvt/instruments/screenshot.js';
 import { MisagentService } from './services/ios/misagent/index.js';
 import { MobileConfigService } from './services/ios/mobile-config/index.js';
 import MobileImageMounterService from './services/ios/mobile-image-mounter/index.js';
@@ -118,6 +122,28 @@ export async function startWebInspectorService(udid) {
         ]),
     };
 }
+export async function startDVTService(udid) {
+    const { remoteXPC, tunnelConnection } = await createRemoteXPCConnection(udid);
+    const dvtServiceDescriptor = remoteXPC.findService(DVTSecureSocketProxyService.RSD_SERVICE_NAME);
+    // Create DVT service instance
+    const dvtService = new DVTSecureSocketProxyService([
+        tunnelConnection.host,
+        parseInt(dvtServiceDescriptor.port, 10),
+    ]);
+    // Connect to DVT service
+    await dvtService.connect();
+    // Create instrument services
+    const locationSimulation = new LocationSimulation(dvtService);
+    const conditionInducer = new ConditionInducer(dvtService);
+    const screenshot = new Screenshot(dvtService);
+    return {
+        remoteXPC: remoteXPC,
+        dvtService,
+        locationSimulation,
+        conditionInducer,
+        screenshot,
+    };
+}
 export async function createRemoteXPCConnection(udid) {
     const tunnelConnection = await getTunnelInformation(udid);
     const remoteXPC = await startService(tunnelConnection.host, tunnelConnection.port);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-remotexpc",
-  "version": "0.13.2",
+  "version": "0.15.0",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",
   "type": "module",
@@ -39,6 +39,10 @@
     "test:misagent": "mocha test/integration/misagent-service-test.ts --exit --timeout 1m",
     "test:afc": "mocha test/integration/afc-test.ts --exit --timeout 1m",
     "test:power-assertion": "mocha test/integration/power-assertion-test.ts --exit --timeout 1m",
+    "test:dvt": "mocha test/integration/dvt-service-test.ts --exit --timeout 1m",
+    "test:dvt:location-simulation": "mocha test/integration/dvt_instruments/location-simulation-test.ts --exit --timeout 1m",
+    "test:dvt:condition-inducer": "mocha test/integration/dvt_instruments/condition-inducer-test.ts --exit --timeout 1m",
+    "test:dvt:screenshot": "mocha test/integration/dvt_instruments/screenshot-test.ts --exit --timeout 1m",
     "test:tunnel-creation": "sudo tsx scripts/test-tunnel-creation.ts",
     "test:tunnel-creation:lsof": "sudo tsx scripts/test-tunnel-creation.ts --keep-open"
   },

package/src/index.ts

@@ -24,6 +24,12 @@ export type {
   WebInspectorService,
   MisagentService,
   SyslogService,
+  DVTSecureSocketProxyService,
+  LocationSimulationService,
+  ConditionInducerService,
+  ScreenshotService,
+  ConditionProfile,
+  ConditionGroup,
   SocketInfo,
   TunnelResult,
   TunnelRegistry,
@@ -36,6 +42,7 @@ export type {
   SpringboardServiceWithConnection,
   WebInspectorServiceWithConnection,
   MisagentServiceWithConnection,
+  DVTServiceWithConnection,
 } from './lib/types.js';
 export { PowerAssertionType } from './lib/types.js';
 export {

package/src/lib/plist/binary-plist-creator.ts

@@ -11,6 +11,7 @@ import {
   BPLIST_TRAILER_SIZE,
   BPLIST_TYPE,
 } from './constants.js';
+import { PlistUID } from './plist-uid.js';
 
 /**
  * Checks if a value is a plain object (not null, not an array, not a Date, not a Buffer)
@@ -220,6 +221,30 @@ class BinaryPlistCreator {
     return Buffer.from([value ? BPLIST_TYPE.TRUE : BPLIST_TYPE.FALSE]);
   }
 
+  /**
+   * Creates UID data for NSKeyedArchiver references
+   * @param value - The UID value to encode
+   * @returns Buffer containing the encoded UID
+   */
+  private _createUIDData(value: number): Buffer {
+    // UID format: 0x80 | length_marker, followed by the UID value
+    let buffer: Buffer;
+    if (value <= 255) {
+      buffer = Buffer.alloc(2);
+      buffer.writeUInt8(BPLIST_TYPE.UID | 0, 0);
+      buffer.writeUInt8(value, 1);
+    } else if (value <= 65535) {
+      buffer = Buffer.alloc(3);
+      buffer.writeUInt8(BPLIST_TYPE.UID | 1, 0);
+      buffer.writeUInt16BE(value, 1);
+    } else {
+      buffer = Buffer.alloc(5);
+      buffer.writeUInt8(BPLIST_TYPE.UID | 2, 0);
+      buffer.writeUInt32BE(value, 1);
+    }
+    return buffer;
+  }
+
   /**
    * Creates binary data for an integer value
    * @param value - The integer value (number or bigint)
@@ -507,6 +532,11 @@ class BinaryPlistCreator {
       return this._createBufferData(value);
     }
 
+    // Handle UID (for NSKeyedArchiver format)
+    if (value instanceof PlistUID) {
+      return this._createUIDData(value.value);
+    }
+
     // Handle strings
     if (typeof value === 'string') {
       return this._createStringData(value);

package/src/lib/plist/index.ts

@@ -26,6 +26,8 @@ import {
   trimBeforeXmlDeclaration,
 } from './utils.js';
 
+export { PlistUID } from './plist-uid.js';
+
 export {
   createPlist,
   createXmlPlist,