appium-ios-remotexpc 0.0.3 → 0.0.5

package/build/src/lib/apple-tv/encryption/hkdf.d.ts

@@ -0,0 +1,18 @@
+export interface HKDFParams {
+    ikm: Buffer;
+    salt: Buffer | null;
+    info: Buffer;
+    length: number;
+}
+/**
+ * HMAC-based Key Derivation Function (HKDF) as defined in RFC 5869
+ * Derives cryptographic keys from input key material using a two-step process:
+ * 1. Extract: Generate a pseudorandom key from the input key material
+ * 2. Expand: Expand the pseudorandom key to the desired output length
+ *
+ * @param params - HKDF parameters including input key material, salt, info, and desired output length
+ * @returns Buffer containing the derived key material of specified length
+ * @throws CryptographyError if derivation fails or parameters are invalid
+ */
+export declare function hkdf(params: HKDFParams): Buffer;
+//# sourceMappingURL=hkdf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hkdf.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/encryption/hkdf.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA6B/C"}

package/build/src/lib/apple-tv/encryption/hkdf.js

@@ -0,0 +1,73 @@
+import { logger } from '@appium/support';
+import { createHmac } from 'node:crypto';
+import { HKDF_HASH_ALGORITHM, HKDF_HASH_LENGTH } from '../constants.js';
+import { CryptographyError } from '../errors.js';
+const log = logger.getLogger('HKDF');
+const MAX_OUTPUT_LENGTH = 255 * HKDF_HASH_LENGTH;
+/**
+ * HMAC-based Key Derivation Function (HKDF) as defined in RFC 5869
+ * Derives cryptographic keys from input key material using a two-step process:
+ * 1. Extract: Generate a pseudorandom key from the input key material
+ * 2. Expand: Expand the pseudorandom key to the desired output length
+ *
+ * @param params - HKDF parameters including input key material, salt, info, and desired output length
+ * @returns Buffer containing the derived key material of specified length
+ * @throws CryptographyError if derivation fails or parameters are invalid
+ */
+export function hkdf(params) {
+    const { ikm, salt, info, length } = params;
+    if (!ikm || ikm.length === 0) {
+        throw new CryptographyError('Input key material (IKM) cannot be empty');
+    }
+    if (!info) {
+        throw new CryptographyError('Info parameter is required');
+    }
+    if (length <= 0) {
+        throw new CryptographyError('Output length must be positive');
+    }
+    if (length > MAX_OUTPUT_LENGTH) {
+        throw new CryptographyError(`Output length cannot exceed ${MAX_OUTPUT_LENGTH} bytes`);
+    }
+    try {
+        const extractedKey = hkdfExtract(ikm, salt);
+        return hkdfExpand(extractedKey, info, length);
+    }
+    catch (error) {
+        log.error('HKDF derivation failed:', error);
+        const message = error instanceof Error ? error.message : String(error);
+        throw new CryptographyError(`HKDF derivation failed: ${message}`);
+    }
+}
+/**
+ * HKDF Extract step: generates a pseudorandom key from input key material
+ * @param ikm - Input key material
+ * @param salt - Optional salt value (uses zero salt if null)
+ * @returns Pseudorandom key of hash length
+ */
+function hkdfExtract(ikm, salt) {
+    const actualSalt = salt || Buffer.alloc(HKDF_HASH_LENGTH);
+    return createHmac(HKDF_HASH_ALGORITHM, actualSalt).update(ikm).digest();
+}
+/**
+ * HKDF Expand a step: expands a pseudorandom key to desired output length
+ * @param prk - Pseudorandom key from extract step
+ * @param info - Context and application specific information
+ * @param length - Desired output key material length
+ * @returns Output key material of specified length
+ */
+function hkdfExpand(prk, info, length) {
+    const numberOfBlocks = Math.ceil(length / HKDF_HASH_LENGTH);
+    const blocks = [];
+    let previousBlock = Buffer.alloc(0);
+    for (let blockIndex = 1; blockIndex <= numberOfBlocks; blockIndex++) {
+        const hmac = createHmac(HKDF_HASH_ALGORITHM, prk);
+        hmac.update(previousBlock);
+        hmac.update(info);
+        hmac.update(Buffer.from([blockIndex]));
+        const currentBlock = hmac.digest();
+        blocks.push(currentBlock);
+        previousBlock = currentBlock;
+    }
+    const outputKeyMaterial = Buffer.concat(blocks);
+    return outputKeyMaterial.subarray(0, length);
+}

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

@@ -0,0 +1,5 @@
+export { Opack2 } from './opack2.js';
+export { encryptChaCha20Poly1305, decryptChaCha20Poly1305, type ChaCha20Poly1305Params, } from './chacha20-poly1305.js';
+export { generateEd25519KeyPair, createEd25519Signature } from './ed25519.js';
+export { hkdf, type HKDFParams } from './hkdf.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/encryption/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,4 @@
+export { Opack2 } from './opack2.js';
+export { encryptChaCha20Poly1305, decryptChaCha20Poly1305, } from './chacha20-poly1305.js';
+export { generateEd25519KeyPair, createEd25519Signature } from './ed25519.js';
+export { hkdf } from './hkdf.js';

package/build/src/lib/apple-tv/encryption/opack2.d.ts

@@ -0,0 +1,57 @@
+interface SerializableArray extends Array<SerializableValue> {
+}
+interface SerializableObject extends Record<string, SerializableValue> {
+}
+type SerializableValue = null | undefined | boolean | number | string | Buffer | SerializableArray | SerializableObject;
+/**
+ * OPACK2 binary serialization format encoder
+ * Implements Apple's OPACK2 protocol for efficient binary serialization of structured data
+ */
+export declare class Opack2 {
+    /**
+     * Serializes a JavaScript object to OPACK2 binary format
+     * @param obj - The object to serialize (supports primitives, arrays, objects, and Buffers)
+     * @returns Buffer containing the serialized data
+     * @throws AppleTVError if the object contains unsupported types
+     */
+    static dumps(obj: SerializableValue): Buffer;
+    /**
+     * Main encoding dispatcher that routes values to appropriate type-specific encoders
+     * @param obj - Value to encode
+     * @returns Buffer containing encoded value
+     * @throws AppleTVError for unsupported types
+     */
+    private static encode;
+    /**
+     * Encodes numeric values with the appropriate size optimization
+     * @param num - Number to encode
+     * @returns Buffer containing encoded number
+     */
+    private static encodeNumber;
+    /**
+     * Encodes UTF-8 strings with length-optimized headers
+     * @param str - String to encode
+     * @returns Buffer containing encoded string
+     */
+    private static encodeString;
+    /**
+     * Encodes binary data with length-optimized headers
+     * @param bytes - Buffer to encode
+     * @returns Buffer containing encoded binary data
+     */
+    private static encodeBytes;
+    /**
+     * Encodes arrays with count-optimized headers
+     * @param arr - Array to encode
+     * @returns Buffer containing encoded array
+     */
+    private static encodeArray;
+    /**
+     * Encodes objects/dictionaries with count-optimized headers
+     * @param dict - Object to encode
+     * @returns Buffer containing encoded dictionary
+     */
+    private static encodeDict;
+}
+export {};
+//# sourceMappingURL=opack2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opack2.d.ts","sourceRoot":"","sources":["../../../../../src/lib/apple-tv/encryption/opack2.ts"],"names":[],"mappings":"AAGA,UAAU,iBAAkB,SAAQ,KAAK,CAAC,iBAAiB,CAAC;CAAG;AAC/D,UAAU,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;CAAG;AAEzE,KAAK,iBAAiB,GAClB,IAAI,GACJ,SAAS,GACT,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB;;;GAGG;AACH,qBAAa,MAAM;IACjB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM;IAI5C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IAwCrB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAiC3B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAqC3B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAoC1B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAuB1B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAyB1B"}

package/build/src/lib/apple-tv/encryption/opack2.js

@@ -0,0 +1,203 @@
+import * as constants from '../constants.js';
+import { AppleTVError } from '../errors.js';
+/**
+ * OPACK2 binary serialization format encoder
+ * Implements Apple's OPACK2 protocol for efficient binary serialization of structured data
+ */
+export class Opack2 {
+    /**
+     * Serializes a JavaScript object to OPACK2 binary format
+     * @param obj - The object to serialize (supports primitives, arrays, objects, and Buffers)
+     * @returns Buffer containing the serialized data
+     * @throws AppleTVError if the object contains unsupported types
+     */
+    static dumps(obj) {
+        return this.encode(obj);
+    }
+    /**
+     * Main encoding dispatcher that routes values to appropriate type-specific encoders
+     * @param obj - Value to encode
+     * @returns Buffer containing encoded value
+     * @throws AppleTVError for unsupported types
+     */
+    static encode(obj) {
+        if (obj === null || obj === undefined) {
+            return Buffer.from([constants.OPACK2_NULL]);
+        }
+        if (typeof obj === 'boolean') {
+            return Buffer.from([
+                obj ? constants.OPACK2_TRUE : constants.OPACK2_FALSE,
+            ]);
+        }
+        if (typeof obj === 'number') {
+            return this.encodeNumber(obj);
+        }
+        if (typeof obj === 'string') {
+            return this.encodeString(obj);
+        }
+        if (Buffer.isBuffer(obj)) {
+            return this.encodeBytes(obj);
+        }
+        if (Array.isArray(obj)) {
+            return this.encodeArray(obj);
+        }
+        if (typeof obj === 'object' &&
+            !Array.isArray(obj) &&
+            !Buffer.isBuffer(obj)) {
+            return this.encodeDict(obj);
+        }
+        throw new AppleTVError(`Unsupported type for OPACK2 serialization: ${typeof obj}`);
+    }
+    /**
+     * Encodes numeric values with the appropriate size optimization
+     * @param num - Number to encode
+     * @returns Buffer containing encoded number
+     */
+    static encodeNumber(num) {
+        if (!Number.isInteger(num) || num < 0) {
+            const buffer = Buffer.allocUnsafe(5);
+            buffer[0] = constants.OPACK2_FLOAT_MARKER;
+            buffer.writeFloatLE(num, 1);
+            return buffer;
+        }
+        if (num <= constants.OPACK2_SMALL_INT_MAX) {
+            return Buffer.from([num + constants.OPACK2_SMALL_INT_OFFSET]);
+        }
+        if (num <= constants.OPACK2_UINT8_MAX) {
+            return Buffer.from([constants.OPACK2_INT8_MARKER, num]);
+        }
+        if (num <= constants.OPACK2_UINT32_MAX) {
+            const buffer = Buffer.allocUnsafe(5);
+            buffer[0] = constants.OPACK2_INT32_MARKER;
+            buffer.writeUInt32LE(num, 1);
+            return buffer;
+        }
+        if (num <= Number.MAX_SAFE_INTEGER) {
+            const buffer = Buffer.allocUnsafe(9);
+            buffer[0] = constants.OPACK2_INT64_MARKER;
+            buffer.writeBigUInt64LE(BigInt(num), 1);
+            return buffer;
+        }
+        throw new AppleTVError(`Number too large for OPACK2 encoding: ${num}`);
+    }
+    /**
+     * Encodes UTF-8 strings with length-optimized headers
+     * @param str - String to encode
+     * @returns Buffer containing encoded string
+     */
+    static encodeString(str) {
+        const encoded = Buffer.from(str, 'utf8');
+        const length = encoded.length;
+        if (length <= constants.OPACK2_SMALL_STRING_MAX) {
+            return Buffer.concat([
+                Buffer.from([constants.OPACK2_SMALL_STRING_BASE + length]),
+                encoded,
+            ]);
+        }
+        if (length <= constants.OPACK2_UINT8_MAX) {
+            return Buffer.concat([
+                Buffer.from([constants.OPACK2_STRING_8BIT_LEN_MARKER, length]),
+                encoded,
+            ]);
+        }
+        if (length <= constants.OPACK2_UINT16_MAX) {
+            const header = Buffer.allocUnsafe(3);
+            header[0] = constants.OPACK2_STRING_16BIT_LEN_MARKER;
+            header.writeUInt16BE(length, 1);
+            return Buffer.concat([header, encoded]);
+        }
+        if (length <= constants.OPACK2_UINT32_MAX) {
+            const header = Buffer.allocUnsafe(5);
+            header[0] = constants.OPACK2_STRING_32BIT_LEN_MARKER;
+            header.writeUInt32BE(length, 1);
+            return Buffer.concat([header, encoded]);
+        }
+        throw new AppleTVError(`String too long for OPACK2 encoding: ${length} bytes`);
+    }
+    /**
+     * Encodes binary data with length-optimized headers
+     * @param bytes - Buffer to encode
+     * @returns Buffer containing encoded binary data
+     */
+    static encodeBytes(bytes) {
+        const length = bytes.length;
+        if (length <= constants.OPACK2_SMALL_BYTES_MAX) {
+            return Buffer.concat([
+                Buffer.from([constants.OPACK2_SMALL_BYTES_BASE + length]),
+                bytes,
+            ]);
+        }
+        if (length <= constants.OPACK2_UINT8_MAX) {
+            return Buffer.concat([
+                Buffer.from([constants.OPACK2_BYTES_8BIT_LEN_MARKER, length]),
+                bytes,
+            ]);
+        }
+        if (length <= constants.OPACK2_UINT16_MAX) {
+            const header = Buffer.allocUnsafe(3);
+            header[0] = constants.OPACK2_BYTES_16BIT_LEN_MARKER;
+            header.writeUInt16BE(length, 1);
+            return Buffer.concat([header, bytes]);
+        }
+        if (length <= constants.OPACK2_UINT32_MAX) {
+            const header = Buffer.allocUnsafe(5);
+            header[0] = constants.OPACK2_BYTES_32BIT_LEN_MARKER;
+            header.writeUInt32BE(length, 1);
+            return Buffer.concat([header, bytes]);
+        }
+        throw new AppleTVError(`Byte array too long for OPACK2 encoding: ${length} bytes`);
+    }
+    /**
+     * Encodes arrays with count-optimized headers
+     * @param arr - Array to encode
+     * @returns Buffer containing encoded array
+     */
+    static encodeArray(arr) {
+        const length = arr.length;
+        if (length <= constants.OPACK2_SMALL_ARRAY_MAX) {
+            const parts = [
+                Buffer.from([constants.OPACK2_SMALL_ARRAY_BASE + length]),
+            ];
+            for (const item of arr) {
+                parts.push(this.encode(item));
+            }
+            return Buffer.concat(parts);
+        }
+        const parts = [
+            Buffer.from([constants.OPACK2_VARIABLE_ARRAY_MARKER]),
+        ];
+        for (const item of arr) {
+            parts.push(this.encode(item));
+        }
+        parts.push(Buffer.from([constants.OPACK2_NULL]));
+        return Buffer.concat(parts);
+    }
+    /**
+     * Encodes objects/dictionaries with count-optimized headers
+     * @param dict - Object to encode
+     * @returns Buffer containing encoded dictionary
+     */
+    static encodeDict(dict) {
+        const entries = Object.entries(dict);
+        const length = entries.length;
+        if (length < constants.OPACK2_SMALL_DICT_MAX) {
+            const parts = [
+                Buffer.from([constants.OPACK2_SMALL_DICT_BASE + length]),
+            ];
+            for (const [key, value] of entries) {
+                parts.push(this.encode(key));
+                parts.push(this.encode(value));
+            }
+            return Buffer.concat(parts);
+        }
+        const parts = [
+            Buffer.from([constants.OPACK2_VARIABLE_DICT_MARKER]),
+        ];
+        for (const [key, value] of entries) {
+            parts.push(this.encode(key));
+            parts.push(this.encode(value));
+        }
+        parts.push(Buffer.from([constants.OPACK2_NULL, constants.OPACK2_NULL]));
+        return Buffer.concat(parts);
+    }
+}

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 {};