appium-ios-remotexpc 0.0.2 → 0.0.4

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.0.4](https://github.com/appium/appium-ios-remotexpc/compare/v0.0.3...v0.0.4) (2025-07-03)
+
+### Miscellaneous Chores
+
+* Add build release to npm module ([#49](https://github.com/appium/appium-ios-remotexpc/issues/49)) ([77c7720](https://github.com/appium/appium-ios-remotexpc/commit/77c77201d730e8a501813fc39bf1a768de2bf497))
+
+## [0.0.3](https://github.com/appium/appium-ios-remotexpc/compare/v0.0.2...v0.0.3) (2025-07-03)
+
+### Miscellaneous Chores
+
+* add more permissions ([1933d7e](https://github.com/appium/appium-ios-remotexpc/commit/1933d7e1ce04fceeb90812ea62a2e8083c6d61ed))
+
 ## [0.0.2](https://github.com/appium/appium-ios-remotexpc/compare/v0.0.1...v0.0.2) (2025-07-03)
 
 ### Miscellaneous Chores

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

@@ -0,0 +1,51 @@
+import { Socket } from 'node:net';
+import { PlistService, type PlistServiceOptions } from './lib/plist/plist-service.js';
+import type { PlistDictionary } from './lib/types.js';
+/**
+ * Message type for plist communications
+ */
+type PlistMessage = PlistDictionary;
+/**
+ * Base class for services that use PlistService for communication
+ */
+export declare abstract class BasePlistService {
+    /**
+     * Sends a message and waits for a response
+     * @param message The message to send
+     * @param timeout Timeout in milliseconds
+     * @returns Promise resolving to the response
+     */
+    sendAndReceive(message: PlistMessage, timeout?: number): Promise<PlistMessage>;
+    /**
+     * Closes the underlying connection
+     */
+    close(): void;
+    /**
+     * Gets the PlistService instance
+     * @returns The PlistService instance
+     */
+    protected getPlistService(): PlistService;
+    /**
+     * The underlying PlistService instance
+     */
+    protected _plistService: PlistService;
+    /**
+     * Creates a new BasePlistService
+     * @param plistServiceOrSocket PlistService instance or Socket
+     * @param options Configuration options for PlistService
+     */
+    protected constructor(plistServiceOrSocket: PlistService | Socket, options?: PlistServiceOptions);
+    /**
+     * Sends a message without waiting for a response
+     * @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

@@ -0,0 +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"}

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

@@ -0,0 +1,61 @@
+import { Socket } from 'node:net';
+import { PlistService, } from './lib/plist/plist-service.js';
+/**
+ * Base class for services that use PlistService for communication
+ */
+export class BasePlistService {
+    /**
+     * Sends a message and waits for a response
+     * @param message The message to send
+     * @param timeout Timeout in milliseconds
+     * @returns Promise resolving to the response
+     */
+    async sendAndReceive(message, timeout) {
+        return this._plistService.sendPlistAndReceive(message, timeout);
+    }
+    /**
+     * Closes the underlying connection
+     */
+    close() {
+        this._plistService.close();
+    }
+    /**
+     * Gets the PlistService instance
+     * @returns The PlistService instance
+     */
+    getPlistService() {
+        return this._plistService;
+    }
+    /**
+     * The underlying PlistService instance
+     */
+    _plistService;
+    /**
+     * Creates a new BasePlistService
+     * @param plistServiceOrSocket PlistService instance or Socket
+     * @param options Configuration options for PlistService
+     */
+    constructor(plistServiceOrSocket, options = {}) {
+        if (plistServiceOrSocket instanceof PlistService) {
+            this._plistService = plistServiceOrSocket;
+        }
+        else {
+            this._plistService = new PlistService(plistServiceOrSocket, options);
+        }
+    }
+    /**
+     * Sends a message without waiting for a response
+     * @param message The message to send
+     */
+    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/base-socket-service.d.ts

@@ -0,0 +1,15 @@
+import { EventEmitter } from 'node:events';
+import { Socket } from 'node:net';
+import { Readable } from 'node:stream';
+declare class BaseSocketService extends EventEmitter {
+    protected _socketClient: Socket;
+    protected _isConnected: boolean;
+    /**
+     * @param socketClient
+     */
+    constructor(socketClient: Socket);
+    _assignClientFailureHandlers(...sourceStreams: Readable[]): void;
+    close(): void;
+}
+export { BaseSocketService };
+//# sourceMappingURL=base-socket-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-socket-service.d.ts","sourceRoot":"","sources":["../../src/base-socket-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,cAAM,iBAAkB,SAAQ,YAAY;IAC1C,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAS;IAExC;;OAEG;gBACS,YAAY,EAAE,MAAM;IA0BhC,4BAA4B,CAAC,GAAG,aAAa,EAAE,QAAQ,EAAE,GAAG,IAAI;IAUhE,KAAK,IAAI,IAAI;CAKd;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,46 @@
+import { EventEmitter } from 'node:events';
+import { Socket } from 'node:net';
+import { Readable } from 'node:stream';
+class BaseSocketService extends EventEmitter {
+    _socketClient;
+    _isConnected = false;
+    /**
+     * @param socketClient
+     */
+    constructor(socketClient) {
+        super();
+        this._socketClient = socketClient;
+        // Check if already connected
+        this._isConnected = !socketClient.connecting && !socketClient.destroyed;
+        // if not connected and it's a raw socket
+        if (!this._isConnected && socketClient instanceof Socket) {
+            this._socketClient.once('connect', () => {
+                this._isConnected = true;
+                this.emit('connect');
+            });
+        }
+        // setup basic error handling
+        this._socketClient.on('error', (err) => {
+            this.emit('error', err);
+        });
+        this._socketClient.on('close', () => {
+            this._isConnected = false;
+            this.emit('close');
+        });
+    }
+    _assignClientFailureHandlers(...sourceStreams) {
+        for (const evt of ['close', 'end']) {
+            this._socketClient.once(evt, () => {
+                sourceStreams.map((s) => {
+                    s.unpipe(this._socketClient);
+                });
+            });
+        }
+    }
+    close() {
+        if (!this._socketClient.destroyed) {
+            this._socketClient.end();
+        }
+    }
+}
+export { BaseSocketService };

package/build/src/index.d.ts

@@ -0,0 +1,9 @@
+import { createLockdownServiceByUDID } from './lib/lockdown/index.js';
+import { PacketStreamClient, PacketStreamServer, TunnelManager } from './lib/tunnel/index.js';
+import { TunnelRegistryServer, startTunnelRegistryServer } from './lib/tunnel/tunnel-registry-server.js';
+import { Usbmux, createUsbmux } from './lib/usbmux/index.js';
+import * as Services from './services.js';
+import { startCoreDeviceProxy } from './services/ios/tunnel-service/index.js';
+export type { DiagnosticsService, SyslogService, SocketInfo, TunnelResult, TunnelRegistry, TunnelRegistryEntry, } from './lib/types.js';
+export { createUsbmux, Services, Usbmux, TunnelManager, PacketStreamServer, PacketStreamClient, createLockdownServiceByUDID, startCoreDeviceProxy, TunnelRegistryServer, startTunnelRegistryServer, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GAC1B,CAAC"}

package/build/src/index.js

@@ -0,0 +1,7 @@
+import { createLockdownServiceByUDID } from './lib/lockdown/index.js';
+import { PacketStreamClient, PacketStreamServer, TunnelManager, } from './lib/tunnel/index.js';
+import { TunnelRegistryServer, startTunnelRegistryServer, } from './lib/tunnel/tunnel-registry-server.js';
+import { Usbmux, createUsbmux } from './lib/usbmux/index.js';
+import * as Services from './services.js';
+import { startCoreDeviceProxy } from './services/ios/tunnel-service/index.js';
+export { createUsbmux, Services, Usbmux, TunnelManager, PacketStreamServer, PacketStreamClient, createLockdownServiceByUDID, startCoreDeviceProxy, TunnelRegistryServer, startTunnelRegistryServer, };

package/build/src/lib/apple-tv/constants.d.ts

@@ -0,0 +1,49 @@
+export declare const DEFAULT_PAIRING_CONFIG: {
+    readonly timeout: 30000;
+    readonly discoveryTimeout: 5000;
+    readonly maxRetries: 3;
+    readonly pairingDirectory: ".pairing";
+};
+export declare const PairingDataComponentType: {
+    readonly METHOD: 0;
+    readonly IDENTIFIER: 1;
+    readonly SALT: 2;
+    readonly PUBLIC_KEY: 3;
+    readonly PROOF: 4;
+    readonly ENCRYPTED_DATA: 5;
+    readonly STATE: 6;
+    readonly ERROR: 7;
+    readonly RETRY_DELAY: 8;
+    readonly CERTIFICATE: 9;
+    readonly SIGNATURE: 10;
+    readonly PERMISSIONS: 11;
+    readonly FRAGMENT_DATA: 12;
+    readonly FRAGMENT_LAST: 13;
+    readonly SESSION_ID: 14;
+    readonly TTL: 15;
+    readonly EXTRA_DATA: 16;
+    readonly INFO: 17;
+    readonly ACL: 18;
+    readonly FLAGS: 19;
+    readonly VALIDATION_DATA: 20;
+    readonly MFI_AUTH_TOKEN: 21;
+    readonly MFI_PRODUCT_TYPE: 22;
+    readonly SERIAL_NUMBER: 23;
+    readonly MFI_AUTH_TOKEN_UUID: 24;
+    readonly APP_FLAGS: 25;
+    readonly OWNERSHIP_PROOF: 26;
+    readonly SETUP_CODE_TYPE: 27;
+    readonly PRODUCTION_DATA: 28;
+    readonly APP_INFO: 29;
+    readonly SEPARATOR: 255;
+};
+export declare const TLV8_MAX_FRAGMENT_SIZE = 255;
+export declare const SRP_PRIME_3072: bigint;
+export declare const SRP_GENERATOR: bigint;
+export declare const SRP_HASH_ALGORITHM = "sha512";
+export declare const SRP_USERNAME = "Pair-Setup";
+export declare const SRP_KEY_LENGTH_BYTES = 384;
+export declare const SRP_PRIVATE_KEY_BITS = 256;
+export declare const HKDF_HASH_ALGORITHM = "sha512";
+export declare const HKDF_HASH_LENGTH = 64;
+//# sourceMappingURL=constants.d.ts.map

package/build/src/lib/apple-tv/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/apple-tv/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAGX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3B,CAAC;AAGX,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAG1C,eAAO,MAAM,cAAc,QAc1B,CAAC;AAGF,eAAO,MAAM,aAAa,QAAY,CAAC;AAGvC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAG3C,eAAO,MAAM,YAAY,eAAe,CAAC;AAGzC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAGxC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAGxC,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAG5C,eAAO,MAAM,gBAAgB,KAAK,CAAC"}

package/build/src/lib/apple-tv/constants.js

@@ -0,0 +1,71 @@
+// Default configuration values for Apple TV pairing behavior
+export const DEFAULT_PAIRING_CONFIG = {
+    timeout: 30000,
+    discoveryTimeout: 5000,
+    maxRetries: 3,
+    pairingDirectory: '.pairing',
+};
+// TLV8 component type identifiers used in pairing data exchange
+export const PairingDataComponentType = {
+    METHOD: 0x00,
+    IDENTIFIER: 0x01,
+    SALT: 0x02,
+    PUBLIC_KEY: 0x03,
+    PROOF: 0x04,
+    ENCRYPTED_DATA: 0x05,
+    STATE: 0x06,
+    ERROR: 0x07,
+    RETRY_DELAY: 0x08,
+    CERTIFICATE: 0x09,
+    SIGNATURE: 0x0a,
+    PERMISSIONS: 0x0b,
+    FRAGMENT_DATA: 0x0c,
+    FRAGMENT_LAST: 0x0d,
+    SESSION_ID: 0x0e,
+    TTL: 0x0f,
+    EXTRA_DATA: 0x10,
+    INFO: 0x11,
+    ACL: 0x12,
+    FLAGS: 0x13,
+    VALIDATION_DATA: 0x14,
+    MFI_AUTH_TOKEN: 0x15,
+    MFI_PRODUCT_TYPE: 0x16,
+    SERIAL_NUMBER: 0x17,
+    MFI_AUTH_TOKEN_UUID: 0x18,
+    APP_FLAGS: 0x19,
+    OWNERSHIP_PROOF: 0x1a,
+    SETUP_CODE_TYPE: 0x1b,
+    PRODUCTION_DATA: 0x1c,
+    APP_INFO: 0x1d,
+    SEPARATOR: 0xff,
+};
+// Maximum allowed size of a TLV8 fragment
+export const TLV8_MAX_FRAGMENT_SIZE = 255;
+// RFC 5054 3072-bit safe prime used for SRP key exchange
+export const SRP_PRIME_3072 = BigInt('0x' +
+    'FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74' +
+    '020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F1437' +
+    '4FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7ED' +
+    'EE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF05' +
+    '98DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB' +
+    '9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3B' +
+    'E39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF695581718' +
+    '3995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33' +
+    'A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7' +
+    'ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864' +
+    'D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E2' +
+    '08E24FA074E5AB3143DB5BFCE0FD108E4B82D120A93AD2CAFFFFFFFFFFFFFFFF');
+// Generator value (g=5) used in SRP key exchange
+export const SRP_GENERATOR = BigInt(5);
+// Hash algorithm used in SRP protocol (per HomeKit spec)
+export const SRP_HASH_ALGORITHM = 'sha512';
+// SRP username identifier used in Apple Pair-Setup
+export const SRP_USERNAME = 'Pair-Setup';
+// Key length in bytes for SRP (3072 bits = 384 bytes)
+export const SRP_KEY_LENGTH_BYTES = 384;
+// Number of bits for SRP private key (usually 256 bits)
+export const SRP_PRIVATE_KEY_BITS = 256;
+// Hash algorithm used for HKDF in pairing encryption
+export const HKDF_HASH_ALGORITHM = 'sha512';
+// Output length (in bytes) for HKDF key derivation
+export const HKDF_HASH_LENGTH = 64;

package/build/src/lib/apple-tv/errors.d.ts

@@ -0,0 +1,17 @@
+export declare class AppleTVError extends Error {
+    constructor(message: string);
+}
+export declare class PairingError extends AppleTVError {
+    code?: string | undefined;
+    details?: any | undefined;
+    constructor(message: string, code?: string | undefined, details?: any | undefined);
+}
+export declare class NetworkError extends AppleTVError {
+}
+export declare class CryptographyError extends AppleTVError {
+}
+export declare class SRPError extends AppleTVError {
+}
+export declare class TLV8Error extends AppleTVError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/src/lib/apple-tv/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/lib/apple-tv/errors.ts"],"names":[],"mappings":"AACA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAK5B;AAGD,qBAAa,YAAa,SAAQ,YAAY;IAGnC,IAAI,CAAC,EAAE,MAAM;IACb,OAAO,CAAC,EAAE,GAAG;gBAFpB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,GAAG,YAAA;CAIvB;AAGD,qBAAa,YAAa,SAAQ,YAAY;CAAG;AAGjD,qBAAa,iBAAkB,SAAQ,YAAY;CAAG;AAGtD,qBAAa,QAAS,SAAQ,YAAY;CAAG;AAG7C,qBAAa,SAAU,SAAQ,YAAY;CAAG"}

package/build/src/lib/apple-tv/errors.js

@@ -0,0 +1,30 @@
+// Base error class for all Apple TV related errors
+export class AppleTVError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+// Represents an error that occurs during the pairing process
+export class PairingError extends AppleTVError {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+    }
+}
+// Represents an error related to network communication
+export class NetworkError extends AppleTVError {
+}
+// Represents an error occurring during cryptographic operations
+export class CryptographyError extends AppleTVError {
+}
+// Represents an error specific to SRP (Secure Remote Password) protocol
+export class SRPError extends AppleTVError {
+}
+// Represents an error related to TLV8 encoding/decoding
+export class TLV8Error extends AppleTVError {
+}

package/build/src/lib/apple-tv/tlv/decoder.d.ts

@@ -0,0 +1,19 @@
+import type { PairingDataComponentTypeValue, TLV8Item } from '../types.js';
+/**
+ * Decodes a TLV8-formatted buffer into an array of TLV8 items.
+ *
+ * @param buffer - A Node.js Buffer containing TLV8 encoded data
+ * @returns Array of TLV8Item objects with `type` and `data`
+ * @throws TLV8Error if the buffer does not contain valid TLV8 data
+ */
+export declare function decodeTLV8(buffer: Buffer): TLV8Item[];
+/**
+ * Decodes a TLV8-formatted buffer into a dictionary mapping
+ * each TLV8 type to its corresponding data buffer. If the same
+ * type occurs more than once, their values are concatenated.
+ *
+ * @param buffer - A Node.js Buffer containing TLV8 encoded data
+ * @returns A dictionary of type-value mappings
+ */
+export declare function decodeTLV8ToDict(buffer: Buffer): Partial<Record<PairingDataComponentTypeValue, Buffer>>;
+//# sourceMappingURL=decoder.d.ts.map

package/build/src/lib/apple-tv/tlv/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/tlv/decoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6BAA6B,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CA4BrD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC,CAiBxD"}

package/build/src/lib/apple-tv/tlv/decoder.js

@@ -0,0 +1,49 @@
+import { TLV8Error } from '../errors.js';
+/**
+ * Decodes a TLV8-formatted buffer into an array of TLV8 items.
+ *
+ * @param buffer - A Node.js Buffer containing TLV8 encoded data
+ * @returns Array of TLV8Item objects with `type` and `data`
+ * @throws TLV8Error if the buffer does not contain valid TLV8 data
+ */
+export function decodeTLV8(buffer) {
+    const items = [];
+    let offset = 0;
+    while (offset < buffer.length) {
+        if (offset + 2 > buffer.length) {
+            throw new TLV8Error(`Invalid TLV8: insufficient data for type and length at offset ${offset}`);
+        }
+        const type = buffer[offset];
+        const length = buffer[offset + 1];
+        offset += 2;
+        if (offset + length > buffer.length) {
+            throw new TLV8Error(`Invalid TLV8: insufficient data for value at offset ${offset}`);
+        }
+        const data = buffer.subarray(offset, offset + length);
+        offset += length;
+        items.push({ type, data });
+    }
+    return items;
+}
+/**
+ * Decodes a TLV8-formatted buffer into a dictionary mapping
+ * each TLV8 type to its corresponding data buffer. If the same
+ * type occurs more than once, their values are concatenated.
+ *
+ * @param buffer - A Node.js Buffer containing TLV8 encoded data
+ * @returns A dictionary of type-value mappings
+ */
+export function decodeTLV8ToDict(buffer) {
+    const items = decodeTLV8(buffer);
+    const result = {};
+    for (const { type, data } of items) {
+        if (!result[type]) {
+            result[type] = [];
+        }
+        result[type].push(data);
+    }
+    return Object.fromEntries(Object.entries(result).map(([type, buffers]) => [
+        type,
+        Buffer.concat(buffers),
+    ]));
+}

package/build/src/lib/apple-tv/tlv/encoder.d.ts

@@ -0,0 +1,10 @@
+import type { TLV8Item } from '../types.js';
+/**
+ * Encodes an array of TLV8 items into a single TLV8-compliant buffer.
+ * If a data value exceeds TLV8_MAX_FRAGMENT_SIZE, it will be split across multiple entries.
+ *
+ * @param items - Array of TLV8 items to encode
+ * @returns A Buffer containing the encoded TLV8 data
+ */
+export declare function encodeTLV8(items: TLV8Item[]): Buffer;
+//# sourceMappingURL=encoder.d.ts.map

package/build/src/lib/apple-tv/tlv/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/tlv/encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAsBpD"}

package/build/src/lib/apple-tv/tlv/encoder.js

@@ -0,0 +1,20 @@
+import { TLV8_MAX_FRAGMENT_SIZE } from '../constants.js';
+/**
+ * Encodes an array of TLV8 items into a single TLV8-compliant buffer.
+ * If a data value exceeds TLV8_MAX_FRAGMENT_SIZE, it will be split across multiple entries.
+ *
+ * @param items - Array of TLV8 items to encode
+ * @returns A Buffer containing the encoded TLV8 data
+ */
+export function encodeTLV8(items) {
+    const chunks = [];
+    for (const { type, data } of items) {
+        let offset = 0;
+        while (offset < data.length) {
+            const fragmentLength = Math.min(TLV8_MAX_FRAGMENT_SIZE, data.length - offset);
+            chunks.push(Buffer.from([type, fragmentLength]), data.subarray(offset, offset + fragmentLength));
+            offset += fragmentLength;
+        }
+    }
+    return Buffer.concat(chunks);
+}

package/build/src/lib/apple-tv/tlv/index.d.ts

@@ -0,0 +1,4 @@
+export { encodeTLV8 } from './encoder.js';
+export { decodeTLV8, decodeTLV8ToDict } from './decoder.js';
+export { createSetupManualPairingData, createPairVerificationData, } from './pairing-tlv.js';
+//# sourceMappingURL=index.d.ts.map

package/build/src/lib/apple-tv/tlv/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/tlv/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC"}

package/build/src/lib/apple-tv/tlv/index.js

@@ -0,0 +1,3 @@
+export { encodeTLV8 } from './encoder.js';
+export { decodeTLV8, decodeTLV8ToDict } from './decoder.js';
+export { createSetupManualPairingData, createPairVerificationData, } from './pairing-tlv.js';

package/build/src/lib/apple-tv/tlv/pairing-tlv.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Creates TLV8-encoded setup data for manual pairing, with default METHOD and STATE.
+ *
+ * @returns Base64-encoded TLV8 string for manual pairing
+ */
+export declare function createSetupManualPairingData(): string;
+/**
+ * Creates TLV8-encoded data for pair verification, including the X25519 public key.
+ *
+ * @param x25519PublicKey - A buffer containing the X25519 public key
+ * @returns Base64-encoded TLV8 string for verification
+ */
+export declare function createPairVerificationData(x25519PublicKey: Buffer): string;
+//# sourceMappingURL=pairing-tlv.d.ts.map

package/build/src/lib/apple-tv/tlv/pairing-tlv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-tlv.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/tlv/pairing-tlv.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAOrD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAO1E"}

package/build/src/lib/apple-tv/tlv/pairing-tlv.js

@@ -0,0 +1,27 @@
+import { PairingDataComponentType } from '../constants.js';
+import { encodeTLV8 } from './encoder.js';
+/**
+ * Creates TLV8-encoded setup data for manual pairing, with default METHOD and STATE.
+ *
+ * @returns Base64-encoded TLV8 string for manual pairing
+ */
+export function createSetupManualPairingData() {
+    const tlv = encodeTLV8([
+        { type: PairingDataComponentType.METHOD, data: Buffer.from([0x00]) },
+        { type: PairingDataComponentType.STATE, data: Buffer.from([0x01]) },
+    ]);
+    return tlv.toString('base64');
+}
+/**
+ * Creates TLV8-encoded data for pair verification, including the X25519 public key.
+ *
+ * @param x25519PublicKey - A buffer containing the X25519 public key
+ * @returns Base64-encoded TLV8 string for verification
+ */
+export function createPairVerificationData(x25519PublicKey) {
+    const tlv = encodeTLV8([
+        { type: PairingDataComponentType.STATE, data: Buffer.from([0x01]) },
+        { type: PairingDataComponentType.PUBLIC_KEY, data: x25519PublicKey },
+    ]);
+    return tlv.toString('base64');
+}

package/build/src/lib/apple-tv/types.d.ts

@@ -0,0 +1,36 @@
+export interface AppleTVDeviceInfo {
+    altIRK: Buffer;
+    btAddr: string;
+    mac: Buffer;
+    remotePairingSerialNumber: string;
+    accountID: string;
+    model: string;
+    name: string;
+}
+export interface PairingKeys {
+    publicKey: Buffer;
+    privateKey: Buffer;
+}
+export interface PairingResult {
+    success: boolean;
+    pairingFile?: string;
+    deviceId: string;
+    error?: Error;
+}
+export interface PairingConfig {
+    timeout: number;
+    discoveryTimeout: number;
+    maxRetries: number;
+    pairingDirectory: string;
+}
+export interface TLV8Item {
+    type: PairingDataComponentTypeValue;
+    data: Buffer;
+}
+export type PairingDataComponentTypeValue = number;
+export type Opack2Value = null | undefined | boolean | number | string | Buffer | Opack2Array | Opack2Dictionary;
+export interface Opack2Array extends Array<Opack2Value> {
+}
+export interface Opack2Dictionary extends Record<string, Opack2Value> {
+}
+//# sourceMappingURL=types.d.ts.map

package/build/src/lib/apple-tv/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/apple-tv/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB,EAAE,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAGD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,6BAA6B,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC;AAGnD,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,SAAS,GACT,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,WAAW,GACX,gBAAgB,CAAC;AAGrB,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,WAAW,CAAC;CAAG;AAG1D,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;CAAG"}

package/build/src/lib/apple-tv/types.js

@@ -0,0 +1 @@
+export {};