appium-ios-remotexpc 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [0.3.0](https://github.com/appium/appium-ios-remotexpc/compare/v0.2.0...v0.3.0) (2025-08-26)
+
+### Features
+
+* Tune Node.js engines ([#60](https://github.com/appium/appium-ios-remotexpc/issues/60)) ([ab3a259](https://github.com/appium/appium-ios-remotexpc/commit/ab3a25966569c4fa07c50aad250c91cf9a837507))
+
+### Bug Fixes
+
+* use 0.9+ explicitly for xmldom reps ([#63](https://github.com/appium/appium-ios-remotexpc/issues/63)) ([4940032](https://github.com/appium/appium-ios-remotexpc/commit/4940032d439e5dd6a4537c8b8dde8ed49be7ebb9))
+
+### Miscellaneous Chores
+
+* **deps:** bump actions/checkout from 3 to 4 ([#57](https://github.com/appium/appium-ios-remotexpc/issues/57)) ([4d80170](https://github.com/appium/appium-ios-remotexpc/commit/4d80170359af0b41edfb11016ecc08aa6867a28c))
+* **deps:** bump actions/setup-node from 3 to 4 ([#58](https://github.com/appium/appium-ios-remotexpc/issues/58)) ([1f2abdd](https://github.com/appium/appium-ios-remotexpc/commit/1f2abddc315900825d5a94dd817b234a393e1f85))
+
+## [0.2.0](https://github.com/appium/appium-ios-remotexpc/compare/v0.1.1...v0.2.0) (2025-08-14)
+
+### Features
+
+* implement notification proxy ([#59](https://github.com/appium/appium-ios-remotexpc/issues/59)) ([aede9f5](https://github.com/appium/appium-ios-remotexpc/commit/aede9f55d7c94657b15a5fe20cc221686a941596))
+
 ## [0.1.1](https://github.com/appium/appium-ios-remotexpc/compare/v0.1.0...v0.1.1) (2025-07-23)
 
 ### Bug Fixes

package/build/src/base-plist-service.d.ts

@@ -20,6 +20,12 @@ export declare abstract class BasePlistService {
      * Closes the underlying connection
      */
     close(): void;
+    /**
+     * Waits for a message
+     * @param timeout Timeout in milliseconds
+     * @returns Promise resolving to the received message
+     */
+    receive(timeout?: number): Promise<PlistMessage>;
     /**
      * Gets the PlistService instance
      * @returns The PlistService instance
@@ -40,12 +46,6 @@ export declare abstract class BasePlistService {
      * @param message The message to send
      */
     protected send(message: PlistMessage): void;
-    /**
-     * Waits for a message
-     * @param timeout Timeout in milliseconds
-     * @returns Promise resolving to the received message
-     */
-    protected receive(timeout?: number): Promise<PlistMessage>;
 }
 export {};
 //# sourceMappingURL=base-plist-service.d.ts.map

package/build/src/base-plist-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-plist-service.d.ts","sourceRoot":"","sources":["../../src/base-plist-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,KAAK,YAAY,GAAG,eAAe,CAAC;AAEpC;;GAEG;AACH,8BAAsB,gBAAgB;IACpC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;IAIxB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACH,SAAS,CAAC,eAAe,IAAI,YAAY;IAIzC;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IAEtC;;;;OAIG;IACH,SAAS,aACP,oBAAoB,EAAE,YAAY,GAAG,MAAM,EAC3C,OAAO,GAAE,mBAAwB;IASnC;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI3C;;;;OAIG;cACa,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAGjE"}
+{"version":3,"file":"base-plist-service.d.ts","sourceRoot":"","sources":["../../src/base-plist-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,KAAK,YAAY,GAAG,eAAe,CAAC;AAEpC;;GAEG;AACH,8BAAsB,gBAAgB;IACpC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;IAIxB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;;;OAIG;IACU,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D;;;OAGG;IACH,SAAS,CAAC,eAAe,IAAI,YAAY;IAIzC;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,YAAY,CAAC;IAEtC;;;;OAIG;IACH,SAAS,aACP,oBAAoB,EAAE,YAAY,GAAG,MAAM,EAC3C,OAAO,GAAE,mBAAwB;IASnC;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;CAG5C"}

package/build/src/base-plist-service.js

@@ -19,6 +19,14 @@ export class BasePlistService {
     close() {
         this._plistService.close();
     }
+    /**
+     * Waits for a message
+     * @param timeout Timeout in milliseconds
+     * @returns Promise resolving to the received message
+     */
+    async receive(timeout) {
+        return this._plistService.receivePlist(timeout);
+    }
     /**
      * Gets the PlistService instance
      * @returns The PlistService instance
@@ -50,12 +58,4 @@ export class BasePlistService {
     send(message) {
         this._plistService.sendPlist(message);
     }
-    /**
-     * Waits for a message
-     * @param timeout Timeout in milliseconds
-     * @returns Promise resolving to the received message
-     */
-    async receive(timeout) {
-        return this._plistService.receivePlist(timeout);
-    }
 }

package/build/src/lib/types.d.ts

@@ -3,6 +3,7 @@
  */
 import type { PacketData } from 'appium-ios-tuntap';
 import { EventEmitter } from 'events';
+import type { ServiceConnection } from '../service-connection.js';
 import type { BaseService, Service } from '../services/ios/base-service.js';
 import type { RemoteXpcConnection } from './remote-xpc/remote-xpc-connection.js';
 import type { Device } from './usbmux/index.js';
@@ -139,6 +140,40 @@ export interface DiagnosticsService extends BaseService {
         timeout?: number;
     }): Promise<PlistDictionary[] | Record<string, any>>;
 }
+/**
+ * Represents the static side of DiagnosticsService
+ */
+export interface NotificationProxyService extends BaseService {
+    /**
+     * Connect to the notification proxy service
+     * @returns Promise resolving to the ServiceConnection instance
+     */
+    connectToNotificationProxyService(): Promise<ServiceConnection>;
+    /**
+     * Observe a notification
+     * @param notification The notification name to subscribe to
+     * @returns Promise that resolves when the subscription request is sent
+     */
+    observe(notification: string): Promise<PlistDictionary>;
+    /**
+     * Post a notification
+     * @param notification The notification name to post
+     * @returns Promise that resolves when the post request is sent
+     */
+    post(notification: string): Promise<PlistDictionary>;
+    /**
+     * Expect notifications as an async generator
+     * @param timeout Timeout in milliseconds
+     * @returns AsyncGenerator yielding PlistMessage objects
+     */
+    expectNotifications(timeout?: number): AsyncGenerator<PlistMessage>;
+    /**
+     * Expect a single notification
+     * @param timeout Timeout in milliseconds
+     * @returns Promise resolving to the expected notification
+     */
+    expectNotification(timeout?: number): Promise<PlistMessage>;
+}
 /**
  * Represents the static side of DiagnosticsService
  */
@@ -163,6 +198,16 @@ export interface DiagnosticsServiceWithConnection {
     /** The RemoteXPC connection that can be used to close the connection */
     remoteXPC: RemoteXpcConnection;
 }
+/**
+ * Represents a NotificationProxyService instance with its associated RemoteXPC connection
+ * This allows callers to properly manage the connection lifecycle
+ */
+export interface NotificationProxyServiceWithConnection {
+    /** The NotificationProxyService instance */
+    notificationProxyService: NotificationProxyService;
+    /** The RemoteXPC connection that can be used to close the connection */
+    remoteXPC: RemoteXpcConnection;
+}
 /**
  * Options for configuring syslog capture
  */

package/build/src/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/build/src/services/ios/notification-proxy/index.d.ts

@@ -0,0 +1,59 @@
+import type { NotificationProxyService as NotificationProxyServiceInterface, PlistDictionary, PlistMessage } from '../../../lib/types.js';
+import { ServiceConnection } from '../../../service-connection.js';
+import { BaseService } from '../base-service.js';
+export interface ObserveNotificationRequest extends PlistDictionary {
+    Command: 'ObserveNotification';
+    Name: string;
+}
+export interface PostNotificationRequest extends PlistDictionary {
+    Command: 'PostNotification';
+    Name: string;
+}
+/**
+ * NotificationProxyService provides an API to:
+ * - Observe notifications
+ * - Post notifications
+ * - Expects notifications
+ */
+declare class NotificationProxyService extends BaseService implements NotificationProxyServiceInterface {
+    static readonly RSD_SERVICE_NAME = "com.apple.mobile.notification_proxy.shim.remote";
+    private readonly timeout;
+    private _conn;
+    private _pendingNotificationsObservationSet;
+    constructor(address: [string, number], timeout?: number);
+    /**
+     * Observe a notification
+     * @param notification The notification name to subscribe to
+     * @returns Promise that resolves when the subscription request is sent
+     */
+    observe(notification: string): Promise<PlistDictionary>;
+    /**
+     * Post a notification
+     * @param notification The notification name to post
+     * @returns Promise that resolves when the post request is sent
+     */
+    post(notification: string): Promise<PlistDictionary>;
+    /**
+     * Expect notifications as an async generator
+     * @param timeout Timeout in milliseconds
+     * @returns AsyncGenerator yielding PlistMessage objects
+     */
+    expectNotifications(timeout?: number): AsyncGenerator<PlistMessage>;
+    /**
+     * Expect a single notification
+     * @param timeout Timeout in milliseconds
+     * @returns Promise resolving to the expected notification
+     */
+    expectNotification(timeout?: number): Promise<PlistMessage>;
+    /**
+     * Connect to the notification proxy service
+     * @returns Promise resolving to the ServiceConnection instance
+     */
+    connectToNotificationProxyService(): Promise<ServiceConnection>;
+    private createObserveNotificationRequest;
+    private createPostNotificationRequest;
+    private getServiceConfig;
+    private sendPlistDictionary;
+}
+export { NotificationProxyService };
+//# sourceMappingURL=index.d.ts.map

package/build/src/services/ios/notification-proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/notification-proxy/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,IAAI,iCAAiC,EAC7D,eAAe,EACf,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,OAAO,EAAE,kBAAkB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,cAAM,wBACJ,SAAQ,WACR,YAAW,iCAAiC;IAE5C,MAAM,CAAC,QAAQ,CAAC,gBAAgB,qDACoB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,mCAAmC,CAA0B;gBAEzD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,MAAc;IAK9D;;;;OAIG;IACG,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAU7D;;;;OAIG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAe1D;;;;OAIG;IACI,mBAAmB,CACxB,OAAO,GAAE,MAAe,GACvB,cAAc,CAAC,YAAY,CAAC;IAqB/B;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,GAAE,MAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IASzE;;;OAGG;IACG,iCAAiC,IAAI,OAAO,CAAC,iBAAiB,CAAC;IASrE,OAAO,CAAC,gCAAgC;IASxC,OAAO,CAAC,6BAA6B;IASrC,OAAO,CAAC,gBAAgB;YAWV,mBAAmB;CAelC;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/build/src/services/ios/notification-proxy/index.js

@@ -0,0 +1,134 @@
+import { logger } from '@appium/support';
+import { ServiceConnection } from '../../../service-connection.js';
+import { BaseService } from '../base-service.js';
+const log = logger.getLogger('NotificationProxyService');
+/**
+ * NotificationProxyService provides an API to:
+ * - Observe notifications
+ * - Post notifications
+ * - Expects notifications
+ */
+class NotificationProxyService extends BaseService {
+    static RSD_SERVICE_NAME = 'com.apple.mobile.notification_proxy.shim.remote';
+    timeout;
+    _conn = null;
+    _pendingNotificationsObservationSet = new Set();
+    constructor(address, timeout = 10000) {
+        super(address);
+        this.timeout = timeout;
+    }
+    /**
+     * Observe a notification
+     * @param notification The notification name to subscribe to
+     * @returns Promise that resolves when the subscription request is sent
+     */
+    async observe(notification) {
+        if (!this._conn) {
+            this._conn = await this.connectToNotificationProxyService();
+        }
+        const request = this.createObserveNotificationRequest(notification);
+        const result = await this.sendPlistDictionary(request);
+        this._pendingNotificationsObservationSet.add(notification);
+        return result;
+    }
+    /**
+     * Post a notification
+     * @param notification The notification name to post
+     * @returns Promise that resolves when the post request is sent
+     */
+    async post(notification) {
+        if (!this._pendingNotificationsObservationSet.has(notification)) {
+            log.error('Posting notifications without observing them may not yield any results. ' +
+                'Consider calling observe() first.');
+            throw new Error('You must call observe() before posting notifications.');
+        }
+        this._conn = await this.connectToNotificationProxyService();
+        const request = this.createPostNotificationRequest(notification);
+        const result = await this.sendPlistDictionary(request);
+        this._pendingNotificationsObservationSet.delete(notification);
+        return result;
+    }
+    /**
+     * Expect notifications as an async generator
+     * @param timeout Timeout in milliseconds
+     * @returns AsyncGenerator yielding PlistMessage objects
+     */
+    async *expectNotifications(timeout = 120000) {
+        if (!this._conn) {
+            this._conn = await this.connectToNotificationProxyService();
+        }
+        while (true) {
+            try {
+                const notification = await this._conn.receive(timeout);
+                const notificationStr = JSON.stringify(notification);
+                const truncatedStr = notificationStr.length > 500
+                    ? `${notificationStr.substring(0, 500)}...`
+                    : notificationStr;
+                log.info(`received response: ${truncatedStr}`);
+                yield notification;
+            }
+            catch (error) {
+                log.error(`Error receiving notification: ${error.message}`);
+                throw error;
+            }
+        }
+    }
+    /**
+     * Expect a single notification
+     * @param timeout Timeout in milliseconds
+     * @returns Promise resolving to the expected notification
+     */
+    async expectNotification(timeout = 120000) {
+        const generator = this.expectNotifications(timeout);
+        const { value, done } = await generator.next();
+        if (done || !value) {
+            throw new Error('No notification received');
+        }
+        return value;
+    }
+    /**
+     * Connect to the notification proxy service
+     * @returns Promise resolving to the ServiceConnection instance
+     */
+    async connectToNotificationProxyService() {
+        if (this._conn) {
+            return this._conn;
+        }
+        const service = this.getServiceConfig();
+        this._conn = await this.startLockdownService(service);
+        return this._conn;
+    }
+    createObserveNotificationRequest(notification) {
+        return {
+            Command: 'ObserveNotification',
+            Name: notification,
+        };
+    }
+    createPostNotificationRequest(notification) {
+        return {
+            Command: 'PostNotification',
+            Name: notification,
+        };
+    }
+    getServiceConfig() {
+        return {
+            serviceName: NotificationProxyService.RSD_SERVICE_NAME,
+            port: this.address[1].toString(),
+            options: { createConnectionTimeout: this.timeout },
+        };
+    }
+    async sendPlistDictionary(request) {
+        if (!this._conn) {
+            this._conn = await this.connectToNotificationProxyService();
+        }
+        const response = await this._conn.sendPlistRequest(request, this.timeout);
+        if (!response) {
+            return {};
+        }
+        if (Array.isArray(response)) {
+            return response.length > 0 ? response[0] : {};
+        }
+        return response;
+    }
+}
+export { NotificationProxyService };

package/build/src/services.d.ts

@@ -1,6 +1,7 @@
 import { RemoteXpcConnection } from './lib/remote-xpc/remote-xpc-connection.js';
-import type { DiagnosticsServiceWithConnection, SyslogService as SyslogServiceType } from './lib/types.js';
+import type { DiagnosticsServiceWithConnection, NotificationProxyServiceWithConnection, SyslogService as SyslogServiceType } from './lib/types.js';
 export declare function startDiagnosticsService(udid: string): Promise<DiagnosticsServiceWithConnection>;
+export declare function startNotificationProxyService(udid: string): Promise<NotificationProxyServiceWithConnection>;
 export declare function startSyslogService(udid: string): Promise<SyslogServiceType>;
 export declare function createRemoteXPCConnection(udid: string): Promise<{
     remoteXPC: RemoteXpcConnection;

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,aAAa,IAAI,iBAAiB,EACnC,MAAM,gBAAgB,CAAC;AAOxB,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAG5B;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,gCAAgC,EAChC,sCAAsC,EACtC,aAAa,IAAI,iBAAiB,EACnC,MAAM,gBAAgB,CAAC;AAQxB,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,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM;;;;;;;;GAO3D"}

package/build/src/services.js

@@ -3,6 +3,7 @@ import { RemoteXpcConnection } from './lib/remote-xpc/remote-xpc-connection.js';
 import { TunnelManager } from './lib/tunnel/index.js';
 import { TunnelApiClient } from './lib/tunnel/tunnel-api-client.js';
 import DiagnosticsService from './services/ios/diagnostic-service/index.js';
+import { NotificationProxyService } from './services/ios/notification-proxy/index.js';
 import SyslogService from './services/ios/syslog-service/index.js';
 const APPIUM_XCUITEST_DRIVER_NAME = 'appium-xcuitest-driver';
 const TUNNEL_REGISTRY_PORT = 'tunnelRegistryPort';
@@ -17,6 +18,17 @@ export async function startDiagnosticsService(udid) {
         ]),
     };
 }
+export async function startNotificationProxyService(udid) {
+    const { remoteXPC, tunnelConnection } = await createRemoteXPCConnection(udid);
+    const notificationProxyService = remoteXPC.findService(NotificationProxyService.RSD_SERVICE_NAME);
+    return {
+        remoteXPC: remoteXPC,
+        notificationProxyService: new NotificationProxyService([
+            tunnelConnection.host,
+            parseInt(notificationProxyService.port, 10),
+        ]),
+    };
+}
 export async function startSyslogService(udid) {
     const { tunnelConnection } = await createRemoteXPCConnection(udid);
     return new SyslogService([tunnelConnection.host, tunnelConnection.port]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-remotexpc",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",
   "type": "module",
@@ -11,7 +11,8 @@
     }
   },
   "engines": {
-    "node": ">=20 <23"
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
+    "npm": ">=10"
   },
   "scripts": {
     "clean:build": "rimraf ./build",
@@ -27,6 +28,7 @@
     "test:tunnel": "mocha test/integration/tunnel-test.ts --exit --timeout 1m",
     "test:pair-record": "mocha test/integration/read-pair-record-test.ts --exit --timeout 1m",
     "test:diagnostics": "mocha test/integration/diagnostics-test.ts --exit --timeout 1m",
+    "test:notification": "mocha test/integration/notification-proxy-test.ts --exit --timeout 1m",
     "test:unit": "mocha 'test/unit/**/*.ts' --exit --timeout 2m",
     "test:tunnel-creation": "sudo tsx scripts/test-tunnel-creation.ts",
     "test:tunnel-creation:lsof": "sudo tsx scripts/test-tunnel-creation.ts --keep-open"
@@ -43,21 +45,17 @@
   },
   "description": "",
   "devDependencies": {
-    "@appium/eslint-config-appium-ts": "^1.0.4",
-    "@appium/tsconfig": "^0.3.5",
-    "@eslint/js": "^9.23.0",
+    "@appium/eslint-config-appium-ts": "^2.0.0-rc.1",
+    "@appium/tsconfig": "^1.0.0-rc.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@trivago/prettier-plugin-sort-imports": "^5.2.2",
     "@types/chai": "^5.2.1",
     "@types/chai-as-promised": "^8.0.2",
     "@types/mocha": "^10.0.10",
-    "appium": "^2.17.1",
     "chai": "^5.2.0",
     "chai-as-promised": "^8.0.1",
     "conventional-changelog-conventionalcommits": "^8.0.0",
-    "eslint": "^9.23.0",
-    "eslint-config-prettier": "^10.1.2",
     "eslint-plugin-unicorn": "^58.0.0",
     "mocha": "^11.1.0",
     "prettier": "^3.5.3",
@@ -65,12 +63,11 @@
     "semantic-release": "^24.0.0",
     "ts-node": "^10.9.2",
     "tsx": "^4.7.0",
-    "typescript": "^5.2.2",
-    "typescript-eslint": "^8.29.0"
+    "typescript": "^5.2.2"
   },
   "dependencies": {
-    "@appium/strongbox": "^0.x",
-    "@appium/support": "^6.1.0",
+    "@appium/strongbox": "^1.0.0-rc.1",
+    "@appium/support": "^7.0.0-rc.1",
     "@types/node": "^24.0.10",
     "@xmldom/xmldom": "^0.9.8",
     "npm-run-all2": "^7.0.2",

package/src/base-plist-service.ts

@@ -35,6 +35,15 @@ export abstract class BasePlistService {
     this._plistService.close();
   }
 
+  /**
+   * Waits for a message
+   * @param timeout Timeout in milliseconds
+   * @returns Promise resolving to the received message
+   */
+  public async receive(timeout?: number): Promise<PlistMessage> {
+    return this._plistService.receivePlist(timeout);
+  }
+
   /**
    * Gets the PlistService instance
    * @returns The PlistService instance
@@ -71,13 +80,4 @@ export abstract class BasePlistService {
   protected send(message: PlistMessage): void {
     this._plistService.sendPlist(message);
   }
-
-  /**
-   * Waits for a message
-   * @param timeout Timeout in milliseconds
-   * @returns Promise resolving to the received message
-   */
-  protected async receive(timeout?: number): Promise<PlistMessage> {
-    return this._plistService.receivePlist(timeout);
-  }
 }

package/src/lib/types.ts

@@ -4,6 +4,7 @@
 import type { PacketData } from 'appium-ios-tuntap';
 import { EventEmitter } from 'events';
 
+import type { ServiceConnection } from '../service-connection.js';
 import type { BaseService, Service } from '../services/ios/base-service.js';
 import type { RemoteXpcConnection } from './remote-xpc/remote-xpc-connection.js';
 import type { Device } from './usbmux/index.js';
@@ -176,6 +177,41 @@ export interface DiagnosticsService extends BaseService {
   }): Promise<PlistDictionary[] | Record<string, any>>;
 }
 
+/**
+ * Represents the static side of DiagnosticsService
+ */
+export interface NotificationProxyService extends BaseService {
+  /**
+   * Connect to the notification proxy service
+   * @returns Promise resolving to the ServiceConnection instance
+   */
+  connectToNotificationProxyService(): Promise<ServiceConnection>;
+  /**
+   * Observe a notification
+   * @param notification The notification name to subscribe to
+   * @returns Promise that resolves when the subscription request is sent
+   */
+  observe(notification: string): Promise<PlistDictionary>;
+  /**
+   * Post a notification
+   * @param notification The notification name to post
+   * @returns Promise that resolves when the post request is sent
+   */
+  post(notification: string): Promise<PlistDictionary>;
+  /**
+   * Expect notifications as an async generator
+   * @param timeout Timeout in milliseconds
+   * @returns AsyncGenerator yielding PlistMessage objects
+   */
+  expectNotifications(timeout?: number): AsyncGenerator<PlistMessage>;
+  /**
+   * Expect a single notification
+   * @param timeout Timeout in milliseconds
+   * @returns Promise resolving to the expected notification
+   */
+  expectNotification(timeout?: number): Promise<PlistMessage>;
+}
+
 /**
  * Represents the static side of DiagnosticsService
  */
@@ -202,6 +238,17 @@ export interface DiagnosticsServiceWithConnection {
   remoteXPC: RemoteXpcConnection;
 }
 
+/**
+ * Represents a NotificationProxyService instance with its associated RemoteXPC connection
+ * This allows callers to properly manage the connection lifecycle
+ */
+export interface NotificationProxyServiceWithConnection {
+  /** The NotificationProxyService instance */
+  notificationProxyService: NotificationProxyService;
+  /** The RemoteXPC connection that can be used to close the connection */
+  remoteXPC: RemoteXpcConnection;
+}
+
 /**
  * Options for configuring syslog capture
  */

package/src/services/ios/notification-proxy/index.ts

@@ -0,0 +1,180 @@
+import { logger } from '@appium/support';
+
+import type {
+  NotificationProxyService as NotificationProxyServiceInterface,
+  PlistDictionary,
+  PlistMessage,
+} from '../../../lib/types.js';
+import { ServiceConnection } from '../../../service-connection.js';
+import { BaseService } from '../base-service.js';
+
+const log = logger.getLogger('NotificationProxyService');
+
+export interface ObserveNotificationRequest extends PlistDictionary {
+  Command: 'ObserveNotification';
+  Name: string;
+}
+
+export interface PostNotificationRequest extends PlistDictionary {
+  Command: 'PostNotification';
+  Name: string;
+}
+
+/**
+ * NotificationProxyService provides an API to:
+ * - Observe notifications
+ * - Post notifications
+ * - Expects notifications
+ */
+class NotificationProxyService
+  extends BaseService
+  implements NotificationProxyServiceInterface
+{
+  static readonly RSD_SERVICE_NAME =
+    'com.apple.mobile.notification_proxy.shim.remote';
+  private readonly timeout: number;
+  private _conn: ServiceConnection | null = null;
+  private _pendingNotificationsObservationSet: Set<string> = new Set();
+
+  constructor(address: [string, number], timeout: number = 10000) {
+    super(address);
+    this.timeout = timeout;
+  }
+
+  /**
+   * Observe a notification
+   * @param notification The notification name to subscribe to
+   * @returns Promise that resolves when the subscription request is sent
+   */
+  async observe(notification: string): Promise<PlistDictionary> {
+    if (!this._conn) {
+      this._conn = await this.connectToNotificationProxyService();
+    }
+    const request = this.createObserveNotificationRequest(notification);
+    const result = await this.sendPlistDictionary(request);
+    this._pendingNotificationsObservationSet.add(notification);
+    return result;
+  }
+
+  /**
+   * Post a notification
+   * @param notification The notification name to post
+   * @returns Promise that resolves when the post request is sent
+   */
+  async post(notification: string): Promise<PlistDictionary> {
+    if (!this._pendingNotificationsObservationSet.has(notification)) {
+      log.error(
+        'Posting notifications without observing them may not yield any results. ' +
+          'Consider calling observe() first.',
+      );
+      throw new Error('You must call observe() before posting notifications.');
+    }
+    this._conn = await this.connectToNotificationProxyService();
+    const request = this.createPostNotificationRequest(notification);
+    const result = await this.sendPlistDictionary(request);
+    this._pendingNotificationsObservationSet.delete(notification);
+    return result;
+  }
+
+  /**
+   * Expect notifications as an async generator
+   * @param timeout Timeout in milliseconds
+   * @returns AsyncGenerator yielding PlistMessage objects
+   */
+  async *expectNotifications(
+    timeout: number = 120000,
+  ): AsyncGenerator<PlistMessage> {
+    if (!this._conn) {
+      this._conn = await this.connectToNotificationProxyService();
+    }
+    while (true) {
+      try {
+        const notification = await this._conn.receive(timeout);
+        const notificationStr = JSON.stringify(notification);
+        const truncatedStr =
+          notificationStr.length > 500
+            ? `${notificationStr.substring(0, 500)}...`
+            : notificationStr;
+        log.info(`received response: ${truncatedStr}`);
+        yield notification;
+      } catch (error) {
+        log.error(`Error receiving notification: ${(error as Error).message}`);
+        throw error;
+      }
+    }
+  }
+
+  /**
+   * Expect a single notification
+   * @param timeout Timeout in milliseconds
+   * @returns Promise resolving to the expected notification
+   */
+  async expectNotification(timeout: number = 120000): Promise<PlistMessage> {
+    const generator = this.expectNotifications(timeout);
+    const { value, done } = await generator.next();
+    if (done || !value) {
+      throw new Error('No notification received');
+    }
+    return value;
+  }
+
+  /**
+   * Connect to the notification proxy service
+   * @returns Promise resolving to the ServiceConnection instance
+   */
+  async connectToNotificationProxyService(): Promise<ServiceConnection> {
+    if (this._conn) {
+      return this._conn;
+    }
+    const service = this.getServiceConfig();
+    this._conn = await this.startLockdownService(service);
+    return this._conn;
+  }
+
+  private createObserveNotificationRequest(
+    notification: string,
+  ): ObserveNotificationRequest {
+    return {
+      Command: 'ObserveNotification',
+      Name: notification,
+    };
+  }
+
+  private createPostNotificationRequest(
+    notification: string,
+  ): PostNotificationRequest {
+    return {
+      Command: 'PostNotification',
+      Name: notification,
+    };
+  }
+
+  private getServiceConfig(): {
+    serviceName: string;
+    port: string;
+    options: { createConnectionTimeout: number };
+  } {
+    return {
+      serviceName: NotificationProxyService.RSD_SERVICE_NAME,
+      port: this.address[1].toString(),
+      options: { createConnectionTimeout: this.timeout },
+    };
+  }
+  private async sendPlistDictionary(
+    request: PlistDictionary,
+  ): Promise<PlistDictionary> {
+    if (!this._conn) {
+      this._conn = await this.connectToNotificationProxyService();
+    }
+    const response = await this._conn.sendPlistRequest(request, this.timeout);
+    if (!response) {
+      return {};
+    }
+    if (Array.isArray(response)) {
+      return response.length > 0 ? (response[0] as PlistDictionary) : {};
+    }
+    return response as PlistDictionary;
+  }
+}
+
+export { NotificationProxyService };

package/src/services.ts

@@ -5,9 +5,11 @@ import { TunnelManager } from './lib/tunnel/index.js';
 import { TunnelApiClient } from './lib/tunnel/tunnel-api-client.js';
 import type {
   DiagnosticsServiceWithConnection,
+  NotificationProxyServiceWithConnection,
   SyslogService as SyslogServiceType,
 } from './lib/types.js';
 import DiagnosticsService from './services/ios/diagnostic-service/index.js';
+import { NotificationProxyService } from './services/ios/notification-proxy/index.js';
 import SyslogService from './services/ios/syslog-service/index.js';
 
 const APPIUM_XCUITEST_DRIVER_NAME = 'appium-xcuitest-driver';
@@ -29,6 +31,22 @@ export async function startDiagnosticsService(
   };
 }
 
+export async function startNotificationProxyService(
+  udid: string,
+): Promise<NotificationProxyServiceWithConnection> {
+  const { remoteXPC, tunnelConnection } = await createRemoteXPCConnection(udid);
+  const notificationProxyService = remoteXPC.findService(
+    NotificationProxyService.RSD_SERVICE_NAME,
+  );
+  return {
+    remoteXPC: remoteXPC as RemoteXpcConnection,
+    notificationProxyService: new NotificationProxyService([
+      tunnelConnection.host,
+      parseInt(notificationProxyService.port, 10),
+    ]),
+  };
+}
+
 export async function startSyslogService(
   udid: string,
 ): Promise<SyslogServiceType> {