appium-ios-remotexpc 0.17.0 → 0.18.1

package/build/src/services/ios/dvt/instruments/device-info.js

@@ -0,0 +1,167 @@
+import { getLogger } from '../../../../lib/logger.js';
+import { parseBinaryPlist } from '../../../../lib/plist/index.js';
+import { MessageAux } from '../dtx-message.js';
+import { BaseInstrument } from './base-instrument.js';
+const log = getLogger('DeviceInfo');
+/**
+ * DeviceInfo service provides access to device information, file system,
+ * and process management through the DTX protocol.
+ *
+ * Available methods:
+ * - ls(path): List directory contents
+ * - execnameForPid(pid): Get executable path for a process ID
+ * - proclist(): Get list of running processes
+ * - isRunningPid(pid): Check if a process is running
+ * - hardwareInformation(): Get hardware details
+ * - networkInformation(): Get network configuration
+ * - machTimeInfo(): Get mach time information
+ * - machKernelName(): Get kernel name
+ * - kpepDatabase(): Get kernel performance event database
+ * - traceCodes(): Get trace code mappings
+ * - nameForUid(uid): Get username for UID
+ * - nameForGid(gid): Get group name for GID
+ */
+export class DeviceInfo extends BaseInstrument {
+    static IDENTIFIER = 'com.apple.instruments.server.services.deviceinfo';
+    /**
+     * List directory contents at the specified path.
+     * @param path - The directory path to list
+     * @returns Array of filenames
+     * @throws {Error} If the directory doesn't exist or cannot be accessed
+     */
+    async ls(path) {
+        const result = await this.requestInformation('directoryListingForPath_', path);
+        if (result === null || result === undefined) {
+            throw new Error(`Failed to list directory: ${path}`);
+        }
+        log.debug(`Listed directory ${path}: ${result.length} entries`);
+        return result;
+    }
+    /**
+     * Get the full executable path for a given process ID.
+     * @param pid - The process identifier
+     * @returns The full path to the executable
+     */
+    async execnameForPid(pid) {
+        return this.requestInformation('execnameForPid_', pid);
+    }
+    /**
+     * Get the list of all running processes on the device.
+     * @returns Array of process information objects
+     */
+    async proclist() {
+        const result = await this.requestInformation('runningProcesses');
+        if (!Array.isArray(result)) {
+            throw new Error(`proclist returned invalid data: expected an array, got ${typeof result} (${JSON.stringify(result)})`);
+        }
+        log.debug(`Retrieved ${result.length} running processes`);
+        return result;
+    }
+    /**
+     * Check if a process with the given PID is currently running.
+     * @param pid - The process identifier to check
+     * @returns true if the process is running, false otherwise
+     */
+    async isRunningPid(pid) {
+        return this.requestInformation('isRunningPid_', pid);
+    }
+    /**
+     * Get hardware information about the device.
+     * @returns Object containing hardware information
+     */
+    async hardwareInformation() {
+        return this.requestInformation('hardwareInformation');
+    }
+    /**
+     * Get network configuration information.
+     * @returns Object containing network information
+     */
+    async networkInformation() {
+        return this.requestInformation('networkInformation');
+    }
+    /**
+     * Get mach kernel time information.
+     * @returns Object containing mach time info
+     */
+    async machTimeInfo() {
+        return this.requestInformation('machTimeInfo');
+    }
+    /**
+     * Get the mach kernel name.
+     * @returns The kernel name string
+     */
+    async machKernelName() {
+        return this.requestInformation('machKernelName');
+    }
+    /**
+     * Get the kernel performance event (kpep) database.
+     * @returns Object containing kpep database or null if not available
+     */
+    async kpepDatabase() {
+        const kpepData = await this.requestInformation('kpepDatabase');
+        if (kpepData === null || kpepData === undefined) {
+            return null;
+        }
+        // The kpepDatabase is returned as binary plist data
+        if (Buffer.isBuffer(kpepData)) {
+            try {
+                return parseBinaryPlist(kpepData);
+            }
+            catch (error) {
+                log.warn('Failed to parse kpep database:', error);
+                return null;
+            }
+        }
+        return kpepData;
+    }
+    /**
+     * Get trace code mappings.
+     * @returns Object mapping trace codes (as hex strings) to descriptions
+     */
+    async traceCodes() {
+        const codesFile = await this.requestInformation('traceCodesFile');
+        if (typeof codesFile !== 'string') {
+            return {};
+        }
+        const codes = {};
+        for (const line of codesFile.split('\n')) {
+            const match = line.trim().match(/^(\S+)\s+(.+)$/);
+            if (match) {
+                const [, hex, description] = match;
+                codes[hex] = description;
+            }
+        }
+        log.debug(`Retrieved ${Object.keys(codes).length} trace codes`);
+        return codes;
+    }
+    /**
+     * Get the username for a given user ID (UID).
+     * @param uid - The user identifier
+     * @returns The username string
+     */
+    async nameForUid(uid) {
+        return this.requestInformation('nameForUID_', uid);
+    }
+    /**
+     * Get the group name for a given group ID (GID).
+     * @param gid - The group identifier
+     * @returns The group name string
+     */
+    async nameForGid(gid) {
+        return this.requestInformation('nameForGID_', gid);
+    }
+    /**
+     * Generic method to request information from the device.
+     * @param selectorName - The selector name to call
+     * @param arg - Optional argument to pass to the selector
+     * @returns The information object or value returned by the selector
+     * @private
+     */
+    async requestInformation(selectorName, arg) {
+        await this.initialize();
+        const call = this.channel.call(selectorName);
+        const args = arg !== undefined ? new MessageAux().appendObj(arg) : undefined;
+        await call(args);
+        return this.channel.receivePlist();
+    }
+}

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

@@ -1,10 +1,6 @@
-import type { DVTSecureSocketProxyService } from '../index.js';
-export declare class Graphics {
-    private readonly dvt;
+import { BaseInstrument } from './base-instrument.js';
+export declare class Graphics extends BaseInstrument {
     static readonly IDENTIFIER = "com.apple.instruments.server.services.graphics.opengl";
-    private channel;
-    constructor(dvt: DVTSecureSocketProxyService);
-    initialize(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
     messages(): AsyncGenerator<unknown, void, unknown>;

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

@@ -1 +1 @@
-{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../../../../../src/services/ios/dvt/instruments/graphics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAI/D,qBAAa,QAAQ;IAMP,OAAO,CAAC,QAAQ,CAAC,GAAG;IALhC,MAAM,CAAC,QAAQ,CAAC,UAAU,2DACgC;IAE1D,OAAO,CAAC,OAAO,CAAwB;gBAEV,GAAG,EAAE,2BAA2B;IAEvD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpB,QAAQ,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;CAa1D"}
+{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../../../../../src/services/ios/dvt/instruments/graphics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,qBAAa,QAAS,SAAQ,cAAc;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,2DACgC;IAEpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpB,QAAQ,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;CAa1D"}

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

@@ -1,18 +1,9 @@
 import { getLogger } from '../../../../lib/logger.js';
 import { MessageAux } from '../dtx-message.js';
+import { BaseInstrument } from './base-instrument.js';
 const log = getLogger('Graphics');
-export class Graphics {
-    dvt;
+export class Graphics extends BaseInstrument {
     static IDENTIFIER = 'com.apple.instruments.server.services.graphics.opengl';
-    channel = null;
-    constructor(dvt) {
-        this.dvt = dvt;
-    }
-    async initialize() {
-        if (!this.channel) {
-            this.channel = await this.dvt.makeChannel(Graphics.IDENTIFIER);
-        }
-    }
     async start() {
         await this.initialize();
         const args = new MessageAux().appendObj(0.0);

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

@@ -1,4 +1,4 @@
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 /**
  * Geographic coordinates
  */
@@ -9,15 +9,8 @@ export interface LocationCoordinates {
 /**
  * Location simulation service for simulating device GPS location
  */
-export declare class LocationSimulation {
-    private readonly dvt;
+export declare class LocationSimulation extends BaseInstrument {
     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

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

@@ -1 +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"}
+{"version":3,"file":"location-simulation.d.ts","sourceRoot":"","sources":["../../../../../../src/services/ios/dvt/instruments/location-simulation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,MAAM,CAAC,QAAQ,CAAC,UAAU,8DACmC;IAE7D;;;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

@@ -1,25 +1,12 @@
 import { getLogger } from '../../../../lib/logger.js';
 import { MessageAux } from '../dtx-message.js';
+import { BaseInstrument } from './base-instrument.js';
 const log = getLogger('LocationSimulation');
 /**
  * Location simulation service for simulating device GPS location
  */
-export class LocationSimulation {
-    dvt;
+export class LocationSimulation extends BaseInstrument {
     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

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

@@ -1,13 +1,9 @@
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 /**
  * Screenshot service for capturing device screenshots
  */
-export declare class Screenshot {
-    private readonly dvt;
+export declare class Screenshot extends BaseInstrument {
     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

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

@@ -1 +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"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../../../../src/services/ios/dvt/instruments/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD;;GAEG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,MAAM,CAAC,QAAQ,CAAC,UAAU,sDAC2B;IAErD;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CAmBvC"}

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

@@ -1,20 +1,11 @@
 import { getLogger } from '../../../../lib/logger.js';
+import { BaseInstrument } from './base-instrument.js';
 const log = getLogger('Screenshot');
 /**
  * Screenshot service for capturing device screenshots
  */
-export class Screenshot {
-    dvt;
+export class Screenshot extends BaseInstrument {
     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

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,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;AAoBrD,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,CA+BnC;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;AAqBrD,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,CAiCnC;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM;;;;;;;;GAO3D"}

package/build/src/services.js

@@ -7,6 +7,7 @@ import DiagnosticsService from './services/ios/diagnostic-service/index.js';
 import { DVTSecureSocketProxyService } from './services/ios/dvt/index.js';
 import { ApplicationListing } from './services/ios/dvt/instruments/application-listing.js';
 import { ConditionInducer } from './services/ios/dvt/instruments/condition-inducer.js';
+import { DeviceInfo } from './services/ios/dvt/instruments/device-info.js';
 import { Graphics } from './services/ios/dvt/instruments/graphics.js';
 import { LocationSimulation } from './services/ios/dvt/instruments/location-simulation.js';
 import { Screenshot } from './services/ios/dvt/instruments/screenshot.js';
@@ -140,6 +141,7 @@ export async function startDVTService(udid) {
     const screenshot = new Screenshot(dvtService);
     const appListing = new ApplicationListing(dvtService);
     const graphics = new Graphics(dvtService);
+    const deviceInfo = new DeviceInfo(dvtService);
     return {
         remoteXPC: remoteXPC,
         dvtService,
@@ -148,6 +150,7 @@ export async function startDVTService(udid) {
         screenshot,
         appListing,
         graphics,
+        deviceInfo,
     };
 }
 export async function createRemoteXPCConnection(udid) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-remotexpc",
-  "version": "0.17.0",
+  "version": "0.18.1",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",
   "type": "module",
@@ -44,6 +44,7 @@
     "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:dvt:device-info": "mocha test/integration/dvt_instruments/device-info-test.ts --exit --timeout 1m",
     "test:dvt:applist": "mocha test/integration/dvt_instruments/app-listing-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"
@@ -83,7 +84,7 @@
   "dependencies": {
     "@appium/strongbox": "^1.0.0-rc.1",
     "@appium/support": "^7.0.0-rc.1",
-    "@types/node": "^24.0.10",
+    "@types/node": "^25.0.2",
     "@xmldom/xmldom": "^0.9.8",
     "appium-ios-tuntap": "^0.x",
     "axios": "^1.12.0",

package/src/index.ts

@@ -29,6 +29,8 @@ export type {
   ConditionInducerService,
   ScreenshotService,
   GraphicsService,
+  DeviceInfoService,
+  ProcessInfo,
   ConditionProfile,
   ConditionGroup,
   SocketInfo,

package/src/lib/apple-tv/encryption/ed25519.ts

@@ -1,8 +1,4 @@
-import {
-  type KeyPairKeyObjectResult,
-  generateKeyPairSync,
-  sign,
-} from 'node:crypto';
+import { generateKeyPairSync, sign } from 'node:crypto';
 
 import { getLogger } from '../../logger.js';
 import { CryptographyError } from '../errors.js';
@@ -24,7 +20,7 @@ const ED25519_PKCS8_PREFIX = Buffer.from(
  */
 export function generateEd25519KeyPair(): PairingKeys {
   try {
-    const keyPair: KeyPairKeyObjectResult = generateKeyPairSync('ed25519');
+    const keyPair = generateKeyPairSync('ed25519');
 
     const publicKeyDer = keyPair.publicKey.export({
       type: 'spki',

package/src/lib/tunnel/packet-stream-client.ts

@@ -47,7 +47,7 @@ export class PacketStreamClient extends EventEmitter {
       );
 
       this.socket.on('data', (data) => {
-        this.handleData(data);
+        this.handleData(Buffer.isBuffer(data) ? data : Buffer.from(data));
       });
 
       this.socket.once('close', () => {

package/src/lib/types.ts

@@ -574,6 +574,228 @@ export interface GraphicsService {
   messages(): AsyncGenerator<unknown, void, unknown>;
 }
 
+/**
+ * Process information
+ */
+export interface ProcessInfo {
+  /** Process identifier (may be negative for system services) */
+  pid: number;
+
+  /** Process name */
+  name?: string;
+
+  /** Indicates whether the process is an application */
+  isApplication: boolean;
+
+  /** Bundle identifier for application processes */
+  bundleIdentifier?: string;
+
+  /** Full path to the executable */
+  realAppName?: string;
+
+  /** Raw device start timestamp */
+  startDate?: {
+    /** Mach-based timestamp value */
+    'NS.time': number;
+  };
+
+  /** Whether crash analysis should include corpse sampling */
+  shouldAnalyzeWithCorpse?: boolean;
+}
+
+/**
+ * DeviceInfo service interface for accessing device information,
+ * file system, and process management
+ */
+export interface DeviceInfoService {
+  /**
+   * List directory contents
+   * @param path The directory path to list
+   * @returns Array of filenames
+   */
+  ls(path: string): Promise<string[]>;
+
+  /**
+   * Get executable path for a process
+   * @param pid The process identifier
+   * @returns The full path to the executable
+   */
+  execnameForPid(pid: number): Promise<string>;
+
+  /**
+   * Get list of running processes
+   * @returns Array of process information
+   * @example
+   * ```typescript
+   * const processes = await deviceInfo.proclist();
+   * // Example response:
+   * // [
+   * //   {
+   * //     name: 'audioaccessoryd',
+   * //     startDate: { 'NS.time': 786563887.8186979 },
+   * //     isApplication: false,
+   * //     pid: 77,
+   * //     realAppName: '/usr/libexec/audioaccessoryd'
+   * //   },
+   * //   {
+   * //     name: 'dmd',
+   * //     startDate: { 'NS.time': 786563890.2724509 },
+   * //     isApplication: false,
+   * //     pid: -102,
+   * //     realAppName: '/usr/libexec/dmd'
+   * //   },
+   * //   ...
+   * // ]
+   * ```
+   */
+  proclist(): Promise<ProcessInfo[]>;
+
+  /**
+   * Check if a process is running
+   * @param pid The process identifier
+   * @returns true if running, false otherwise
+   */
+  isRunningPid(pid: number): Promise<boolean>;
+
+  /**
+   * Get hardware information
+   * @returns Hardware information object
+   * @example
+   * ```typescript
+   * const hwInfo = await deviceInfo.hardwareInformation();
+   * // Example response:
+   * // {
+   * //   numberOfPhysicalCpus: 6,
+   * //   hwCPUsubtype: 2,
+   * //   numberOfCpus: 6,
+   * //   hwCPUtype: 16777228,
+   * //   hwCPU64BitCapable: 1,
+   * //   ProcessorTraceState: {
+   * //     HWTraceVersion: '{\n  "lib_ver": "libhwtrace @ tag libhwtrace-118.1",\n  "api_ver": 21,\n  ...\n}',
+   * //     Streaming: false,
+   * //     ProdTraceSupported: false,
+   * //     AllocatedBufferSize: 0,
+   * //     HWSupported: false,
+   * //     HWConfigured: false,
+   * //     RequestedBufferSize: 0,
+   * //     DevTraceSupported: false
+   * //   }
+   * // }
+   * ```
+   */
+  hardwareInformation(): Promise<any>;
+
+  /**
+   * Get network information
+   * @returns Network information object
+   * @example
+   * ```typescript
+   * const networkInfo = await deviceInfo.networkInformation();
+   * // Example response:
+   * // {
+   * //   en2: 'Ethernet Adapter (en2)',
+   * //   en0: 'Wi-Fi',
+   * //   en1: 'Ethernet Adapter (en1)',
+   * //   lo0: 'Loopback'
+   * // }
+   * ```
+   */
+  networkInformation(): Promise<any>;
+
+  /**
+   * Get mach time information
+   * @returns Mach time info array containing [machAbsoluteTime, numer, denom, machContinuousTime, systemTime, timezone]
+   * @example
+   * ```typescript
+   * const machTime = await deviceInfo.machTimeInfo();
+   * // Example response:
+   * // [
+   * //   1536005260807,      // machAbsoluteTime
+   * //   125,                // numer
+   * //   3,                  // denom
+   * //   1713684132688,      // machContinuousTime
+   * //   1764942215.065243,  // systemTime
+   * //   'Asia/Kolkata'      // timezone
+   * // ]
+   * ```
+   */
+  machTimeInfo(): Promise<any>;
+
+  /**
+   * Get mach kernel name
+   * @returns Kernel name string
+   * @example
+   * ```typescript
+   * const kernelName = await deviceInfo.machKernelName();
+   * // Example response:
+   * // '/mach.release.t8030'
+   * ```
+   */
+  machKernelName(): Promise<string>;
+
+  /**
+   * Get kernel performance event database
+   * @returns KPEP database object or null
+   * @example
+   * ```typescript
+   * const kpep = await deviceInfo.kpepDatabase();
+   * // Example response:
+   * // {
+   * //   system: {
+   * //     cpu: {
+   * //       config_counters: 1020,
+   * //       marketing_name: 'Apple A13',
+   * //       fixed_counters: 3,
+   * //       aliases: { ... },
+   * //       events: { ... },
+   * //       architecture: 'arm64',
+   * //       power_counters: -32
+   * //     }
+   * //   },
+   * //   internal: false,
+   * //   id: 'cpu_100000c_2_462504d2',
+   * //   name: 'a13',
+   * //   version: [1, 0]
+   * // }
+   * ```
+   */
+  kpepDatabase(): Promise<any | null>;
+
+  /**
+   * Get trace code mappings
+   * @returns Object mapping trace codes (as hex strings) to descriptions
+   * @example
+   * ```typescript
+   * const codes = await deviceInfo.traceCodes();
+   * // Example response:
+   * // {
+   * //   '0x1020000': 'KTrap_DivideError',
+   * //   '0x1020004': 'KTrap_Debug',
+   * //   '0x1020008': 'KTrap_NMI',
+   * //   '0x102000c': 'KTrap_Int3',
+   * //   '0x1020010': 'KTrap_Overflow',
+   * //   '0x1020014': 'KTrap_BoundRange',
+   * //   ...
+   * // }
+   * ```
+   */
+  traceCodes(): Promise<Record<string, string>>;
+
+  /**
+   * Get username for UID
+   * @param uid The user identifier
+   * @returns Username string
+   */
+  nameForUid(uid: number): Promise<string>;
+
+  /**
+   * Get group name for GID
+   * @param gid The group identifier
+   * @returns Group name string
+   */
+  nameForGid(gid: number): Promise<string>;
+}
+
 /**
  * DVT service with connection
  * This allows callers to properly manage the connection lifecycle
@@ -591,6 +813,8 @@ export interface DVTServiceWithConnection {
   appListing: AppListService;
   /** The Graphics service instance */
   graphics: GraphicsService;
+  /** The DeviceInfo service instance */
+  deviceInfo: DeviceInfoService;
   /** The RemoteXPC connection that can be used to close the connection */
   remoteXPC: RemoteXpcConnection;
 }