appium-ios-remotexpc 0.18.0 → 0.19.0

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

@@ -0,0 +1,68 @@
+import { getLogger } from '../../../../lib/logger.js';
+import { MessageAux } from '../dtx-message.js';
+import { decodeNSKeyedArchiver } from '../nskeyedarchiver-decoder.js';
+import { BaseInstrument } from './base-instrument.js';
+const log = getLogger('Notifications');
+/**
+ * Notifications service for monitoring iOS system events
+ *
+ * @example
+ * ```typescript
+ * for await (const msg of dvtService.notifications.messages()) {
+ *   if (!msg) continue;
+ *
+ *   if (msg.selector === 'applicationStateNotification:') {
+ *     const app = msg.data;
+ *     console.log(`${app.appName}: ${app.state_description}`);
+ *   }
+ * }
+ * ```
+ */
+export class Notifications extends BaseInstrument {
+    /** DTX service identifier for mobile notifications */
+    static IDENTIFIER = 'com.apple.instruments.server.services.mobilenotifications';
+    async start() {
+        await this.initialize();
+        const args = new MessageAux().appendObj(true);
+        await this.channel.call('setApplicationStateNotificationsEnabled_')(args);
+        await this.channel.call('setMemoryNotificationsEnabled_')(args);
+    }
+    async stop() {
+        const args = new MessageAux().appendObj(false);
+        await this.channel.call('setApplicationStateNotificationsEnabled_')(args);
+        await this.channel.call('setMemoryNotificationsEnabled_')(args);
+    }
+    /**
+     * Yields notification messages from the iOS device
+     */
+    async *messages() {
+        log.debug('Network monitoring has started');
+        await this.start();
+        try {
+            while (true) {
+                const [selector, auxiliaries] = await this.channel.receivePlistWithAux();
+                // Decode NSKeyedArchiver format in auxiliaries first index
+                const decodedData = auxiliaries[0];
+                if (decodedData &&
+                    typeof decodedData === 'object' &&
+                    decodedData.$archiver === 'NSKeyedArchiver') {
+                    try {
+                        const data = decodeNSKeyedArchiver(decodedData);
+                        yield {
+                            selector: selector,
+                            data,
+                        };
+                    }
+                    catch (error) {
+                        log.warn('Failed to decode NSKeyedArchiver data:', error);
+                        await this.stop();
+                    }
+                }
+            }
+        }
+        finally {
+            log.debug('Network monitoring has ended');
+            await this.stop();
+        }
+    }
+}

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;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"}
+{"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;AAsBrD,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,CAmCnC;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM;;;;;;;;GAO3D"}

package/build/src/services.js

@@ -10,6 +10,7 @@ import { ConditionInducer } from './services/ios/dvt/instruments/condition-induc
 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 { Notifications } from './services/ios/dvt/instruments/notifications.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';
@@ -142,6 +143,7 @@ export async function startDVTService(udid) {
     const appListing = new ApplicationListing(dvtService);
     const graphics = new Graphics(dvtService);
     const deviceInfo = new DeviceInfo(dvtService);
+    const notification = new Notifications(dvtService);
     return {
         remoteXPC: remoteXPC,
         dvtService,
@@ -151,6 +153,7 @@ export async function startDVTService(udid) {
         appListing,
         graphics,
         deviceInfo,
+        notification,
     };
 }
 export async function createRemoteXPCConnection(udid) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-remotexpc",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",
   "type": "module",
@@ -46,6 +46,7 @@
     "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:dvt:notification": "mocha test/integration/dvt_instruments/notifications-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"
   },
@@ -69,6 +70,7 @@
     "@types/chai": "^5.2.1",
     "@types/chai-as-promised": "^8.0.2",
     "@types/mocha": "^10.0.10",
+    "@types/sinon": "^21.0.0",
     "chai": "^6.0.1",
     "chai-as-promised": "^8.0.1",
     "conventional-changelog-conventionalcommits": "^9.1.0",
@@ -77,6 +79,7 @@
     "prettier": "^3.5.3",
     "rimraf": "^6.0.1",
     "semantic-release": "^25.0.2",
+    "sinon": "^21.0.0",
     "ts-node": "^10.9.2",
     "tsx": "^4.7.0",
     "typescript": "^5.2.2"
@@ -84,7 +87,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/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

@@ -8,6 +8,7 @@ import type { ServiceConnection } from '../service-connection.js';
 import type { BaseService, Service } from '../services/ios/base-service.js';
 import type { iOSApplication } from '../services/ios/dvt/instruments/application-listing.js';
 import type { LocationCoordinates } from '../services/ios/dvt/instruments/location-simulation.js';
+import type { NotificationMessage } from '../services/ios/dvt/instruments/notifications.js';
 import { ProvisioningProfile } from '../services/ios/misagent/provisioning-profile.js';
 import type { PowerAssertionOptions } from '../services/ios/power-assertion/index.js';
 import { PowerAssertionType } from '../services/ios/power-assertion/index.js';
@@ -796,6 +797,50 @@ export interface DeviceInfoService {
   nameForGid(gid: number): Promise<string>;
 }
 
+/**
+ * Notification service monitor memory and app notifications
+ */
+export interface NotificationService {
+  /**
+   * Yields notification from memory and application state changes
+   * @example:
+   * {
+   *   selector: 'applicationStateNotification:',
+   *   data:
+   *     {
+   *       mach_absolute_time: 58061793038,
+   *       execName: '/Applications/Spotlight.app',
+   *       appName: 'Spotlight',
+   *       pid: 327,
+   *       state_description: 'Suspended'
+   *     }
+   * },
+   * {
+   *   selector: 'applicationStateNotification:',
+   *   data:
+   *     {
+   *       mach_absolute_time: 58061827502,
+   *       execName: '/private/var/containers/Bundle/Application/28AF0B11-363A-4242-9164-CF690064402B/MobileCal.app',
+   *       appName: 'MobileCal',
+   *       pid: 449,
+   *       state_description: 'Suspended'
+   *     }
+   * },
+   * {
+   *   selector: 'memoryLevelNotification:',
+   *   data:
+   *     {
+   *       code: 3,
+   *       mach_absolute_time: 101524320437,
+   *       timestamp: [Object],
+   *       pid: -1
+   *     }
+   *
+   * }
+   */
+  messages(): AsyncGenerator<NotificationMessage, void, undefined>;
+}
+
 /**
  * DVT service with connection
  * This allows callers to properly manage the connection lifecycle
@@ -815,6 +860,8 @@ export interface DVTServiceWithConnection {
   graphics: GraphicsService;
   /** The DeviceInfo service instance */
   deviceInfo: DeviceInfoService;
+  /** The Notifications service instance */
+  notification: NotificationService;
   /** The RemoteXPC connection that can be used to close the connection */
   remoteXPC: RemoteXpcConnection;
 }

package/src/services/ios/dvt/channel.ts

@@ -23,6 +23,14 @@ export class Channel {
     return data;
   }
 
+  /**
+   * Receive a plist response from the channel with auxiliaries
+   * @returns Tuple of [selector, auxiliaries]
+   */
+  async receivePlistWithAux(): Promise<[string, any[]]> {
+    return await this.service.recvPlist(this.channelCode);
+  }
+
   /**
    * Call a method on this channel with automatic ObjectiveC selector conversion
    *

package/src/services/ios/dvt/instruments/application-listing.ts

@@ -1,7 +1,6 @@
 import { getLogger } from '../../../../lib/logger.js';
-import type { Channel } from '../channel.js';
 import { MessageAux } from '../dtx-message.js';
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 
 const log = getLogger('ApplicationListing');
 
@@ -46,24 +45,10 @@ export interface iOSApplication {
 /**
  * Application Listing service for retrieving installed applications
  */
-export class ApplicationListing {
+export class ApplicationListing extends BaseInstrument {
   static readonly IDENTIFIER =
     'com.apple.instruments.server.services.device.applictionListing';
 
-  private channel: Channel | null = null;
-
-  constructor(private readonly dvt: DVTSecureSocketProxyService) {}
-
-  /**
-   * Initialize the application listing channel
-   */
-  async initialize(): Promise<void> {
-    if (this.channel) {
-      return;
-    }
-    this.channel = await this.dvt.makeChannel(ApplicationListing.IDENTIFIER);
-  }
-
   /**
    * Get the list of installed applications from the device
    * @returns {Promise<iOSApplication[]>}

package/src/services/ios/dvt/instruments/base-instrument.ts

@@ -0,0 +1,27 @@
+import type { Channel } from '../channel.js';
+import type { DVTSecureSocketProxyService } from '../index.js';
+
+/**
+ * Base class for DVT instrument services.
+ *
+ * Subclasses must define a static `IDENTIFIER` property.
+ */
+export abstract class BaseInstrument {
+  static readonly IDENTIFIER: string;
+
+  protected channel: Channel | null = null;
+  constructor(protected readonly dvt: DVTSecureSocketProxyService) {}
+
+  protected get identifier(): string {
+    return (this.constructor as typeof BaseInstrument).IDENTIFIER;
+  }
+
+  /**
+   * Initialize the instrument channel.
+   */
+  async initialize(): Promise<void> {
+    if (!this.channel) {
+      this.channel = await this.dvt.makeChannel(this.identifier);
+    }
+  }
+}

package/src/services/ios/dvt/instruments/condition-inducer.ts

@@ -1,8 +1,7 @@
 import { getLogger } from '../../../../lib/logger.js';
 import type { ConditionGroup } from '../../../../lib/types.js';
-import type { Channel } from '../channel.js';
 import { MessageAux } from '../dtx-message.js';
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 
 const log = getLogger('ConditionInducer');
 
@@ -10,24 +9,10 @@ const log = getLogger('ConditionInducer');
  * Condition Inducer service for simulating various device conditions
  * such as network conditions, thermal states, etc.
  */
-export class ConditionInducer {
+export class ConditionInducer extends BaseInstrument {
   static readonly IDENTIFIER =
     'com.apple.instruments.server.services.ConditionInducer';
 
-  private channel: Channel | null = null;
-
-  constructor(private readonly dvt: DVTSecureSocketProxyService) {}
-
-  /**
-   * Initialize the condition inducer channel
-   */
-  async initialize(): Promise<void> {
-    if (this.channel) {
-      return;
-    }
-    this.channel = await this.dvt.makeChannel(ConditionInducer.IDENTIFIER);
-  }
-
   /**
    * List all available condition inducers and their profiles
    * @returns Array of condition groups with their available profiles

package/src/services/ios/dvt/instruments/device-info.ts

@@ -1,9 +1,8 @@
 import { getLogger } from '../../../../lib/logger.js';
 import { parseBinaryPlist } from '../../../../lib/plist/index.js';
 import type { ProcessInfo } from '../../../../lib/types.js';
-import type { Channel } from '../channel.js';
 import { MessageAux } from '../dtx-message.js';
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 
 const log = getLogger('DeviceInfo');
 
@@ -25,22 +24,10 @@ const log = getLogger('DeviceInfo');
  * - nameForUid(uid): Get username for UID
  * - nameForGid(gid): Get group name for GID
  */
-export class DeviceInfo {
+export class DeviceInfo extends BaseInstrument {
   static readonly IDENTIFIER =
     'com.apple.instruments.server.services.deviceinfo';
 
-  private channel: Channel | null = null;
-  constructor(private readonly dvt: DVTSecureSocketProxyService) {}
-
-  /**
-   * Initialize the device info channel
-   */
-  async initialize(): Promise<void> {
-    if (!this.channel) {
-      this.channel = await this.dvt.makeChannel(DeviceInfo.IDENTIFIER);
-    }
-  }
-
   /**
    * List directory contents at the specified path.
    * @param path - The directory path to list

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

@@ -1,24 +1,13 @@
 import { getLogger } from '../../../../lib/logger.js';
-import type { Channel } from '../channel.js';
 import { MessageAux } from '../dtx-message.js';
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 
 const log = getLogger('Graphics');
 
-export class Graphics {
+export class Graphics extends BaseInstrument {
   static readonly IDENTIFIER =
     'com.apple.instruments.server.services.graphics.opengl';
 
-  private channel: Channel | null = null;
-
-  constructor(private readonly dvt: DVTSecureSocketProxyService) {}
-
-  async initialize(): Promise<void> {
-    if (!this.channel) {
-      this.channel = await this.dvt.makeChannel(Graphics.IDENTIFIER);
-    }
-  }
-
   async start(): Promise<void> {
     await this.initialize();
 

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

@@ -1,7 +1,6 @@
 import { getLogger } from '../../../../lib/logger.js';
-import type { Channel } from '../channel.js';
 import { MessageAux } from '../dtx-message.js';
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 
 const log = getLogger('LocationSimulation');
 
@@ -16,25 +15,10 @@ export interface LocationCoordinates {
 /**
  * Location simulation service for simulating device GPS location
  */
-export class LocationSimulation {
+export class LocationSimulation extends BaseInstrument {
   static readonly IDENTIFIER =
     'com.apple.instruments.server.services.LocationSimulation';
 
-  private channel: Channel | null = null;
-
-  constructor(private readonly dvt: DVTSecureSocketProxyService) {}
-
-  /**
-   * Initialize the location simulation channel
-   */
-  async initialize(): Promise<void> {
-    if (this.channel) {
-      return;
-    }
-
-    this.channel = await this.dvt.makeChannel(LocationSimulation.IDENTIFIER);
-  }
-
   /**
    * Set the simulated GPS location
    * @param coordinates The location coordinates

package/src/services/ios/dvt/instruments/notifications.ts

@@ -0,0 +1,144 @@
+import { getLogger } from '../../../../lib/logger.js';
+import { MessageAux } from '../dtx-message.js';
+import { decodeNSKeyedArchiver } from '../nskeyedarchiver-decoder.js';
+import { BaseInstrument } from './base-instrument.js';
+
+const log = getLogger('Notifications');
+
+/**
+ * Application state notification data structure
+ */
+export interface ApplicationStateNotificationData {
+  /** High-precision Mach absolute time timestamp */
+  mach_absolute_time: bigint;
+  /** Full path to the executable (e.g., '/private/var/containers/Bundle/Application/.../MobileCal.app') */
+  execName: string;
+  /** Short application name (e.g., 'MobileCal') */
+  appName: string;
+  /** Process ID of the application */
+  pid: number;
+  /** Application state: 'Foreground' | 'Background' | 'Suspended' | 'Terminated' */
+  state_description: string;
+}
+
+/**
+ * Memory level notification data structure
+ */
+export interface MemoryLevelNotificationData {
+  /** Memory pressure level code (0=Normal, 1=Warning, 2=Critical, 3=...) */
+  code: number;
+  /** High-precision Mach absolute time timestamp */
+  mach_absolute_time: bigint;
+  /** NSDate timestamp object with NS.time property */
+  timestamp: number;
+  /** Process ID (-1 for system-wide notifications) */
+  pid: number;
+}
+
+/**
+ * Application state notification message
+ */
+export interface ApplicationStateNotification {
+  selector: 'applicationStateNotification:';
+  data: ApplicationStateNotificationData;
+}
+
+/**
+ * Memory level notification message
+ */
+export interface MemoryLevelNotification {
+  selector: 'memoryLevelNotification:';
+  data: MemoryLevelNotificationData;
+}
+
+/**
+ * Monitor memory and app notification
+ *
+ * @example
+ * ```typescript
+ * for await (const msg of notifications.messages()) {
+ *   if (!msg) continue;
+ *
+ *   if (msg.selector === 'applicationStateNotification:') {
+ *     const notif = msg.data;
+ *     console.log(`${notif.appName} is ${notif.state_description}`);
+ *   }
+ * }
+ * ```
+ */
+export type NotificationMessage =
+  | ApplicationStateNotification
+  | MemoryLevelNotification;
+
+/**
+ * Notifications service for monitoring iOS system events
+ *
+ * @example
+ * ```typescript
+ * for await (const msg of dvtService.notifications.messages()) {
+ *   if (!msg) continue;
+ *
+ *   if (msg.selector === 'applicationStateNotification:') {
+ *     const app = msg.data;
+ *     console.log(`${app.appName}: ${app.state_description}`);
+ *   }
+ * }
+ * ```
+ */
+export class Notifications extends BaseInstrument {
+  /** DTX service identifier for mobile notifications */
+  static readonly IDENTIFIER =
+    'com.apple.instruments.server.services.mobilenotifications';
+
+  async start(): Promise<void> {
+    await this.initialize();
+    const args = new MessageAux().appendObj(true);
+    await this.channel!.call('setApplicationStateNotificationsEnabled_')(args);
+    await this.channel!.call('setMemoryNotificationsEnabled_')(args);
+  }
+
+  async stop(): Promise<void> {
+    const args = new MessageAux().appendObj(false);
+    await this.channel!.call('setApplicationStateNotificationsEnabled_')(args);
+    await this.channel!.call('setMemoryNotificationsEnabled_')(args);
+  }
+
+  /**
+   * Yields notification messages from the iOS device
+   */
+  async *messages(): AsyncGenerator<NotificationMessage, void, undefined> {
+    log.debug('Network monitoring has started');
+    await this.start();
+
+    try {
+      while (true) {
+        const [selector, auxiliaries] =
+          await this.channel!.receivePlistWithAux();
+
+        // Decode NSKeyedArchiver format in auxiliaries first index
+        const decodedData = auxiliaries[0];
+        if (
+          decodedData &&
+          typeof decodedData === 'object' &&
+          decodedData.$archiver === 'NSKeyedArchiver'
+        ) {
+          try {
+            const data = decodeNSKeyedArchiver(decodedData);
+            yield {
+              selector: selector as
+                | 'applicationStateNotification:'
+                | 'memoryLevelNotification:',
+              data,
+            } as NotificationMessage;
+          } catch (error) {
+            log.warn('Failed to decode NSKeyedArchiver data:', error);
+            await this.stop();
+          }
+        }
+      }
+    } finally {
+      log.debug('Network monitoring has ended');
+      await this.stop();
+    }
+  }
+}

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

@@ -1,26 +1,15 @@
 import { getLogger } from '../../../../lib/logger.js';
-import type { Channel } from '../channel.js';
-import type { DVTSecureSocketProxyService } from '../index.js';
+import { BaseInstrument } from './base-instrument.js';
 
 const log = getLogger('Screenshot');
 
 /**
  * Screenshot service for capturing device screenshots
  */
-export class Screenshot {
+export class Screenshot extends BaseInstrument {
   static readonly IDENTIFIER =
     'com.apple.instruments.server.services.screenshot';
 
-  private channel: Channel | null = null;
-
-  constructor(private readonly dvt: DVTSecureSocketProxyService) {}
-
-  async initialize(): Promise<void> {
-    if (!this.channel) {
-      this.channel = await this.dvt.makeChannel(Screenshot.IDENTIFIER);
-    }
-  }
-
   /**
    * Capture a screenshot from the device
    * @returns The screenshot data as a Buffer