@bharper/atv-js 0.2.3

package/dist/companion/protocol.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Companion protocol message dispatch layer.
+ * Port of pyatv/protocols/companion/protocol.py.
+ *
+ * Messages are OPACK-encoded with structure:
+ *   { _i: identifier, _t: messageType, _c: content, _x: transactionId }
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompanionProtocol = exports.MessageType = void 0;
+const events_1 = require("events");
+const connection_1 = require("./connection");
+const opack = __importStar(require("../opack"));
+const srp_1 = require("../pairing/srp");
+const credentials_1 = require("../pairing/credentials");
+const auth_1 = require("./auth");
+var MessageType;
+(function (MessageType) {
+    MessageType[MessageType["Event"] = 1] = "Event";
+    MessageType[MessageType["Request"] = 2] = "Request";
+    MessageType[MessageType["Response"] = 3] = "Response";
+})(MessageType || (exports.MessageType = MessageType = {}));
+const DEFAULT_TIMEOUT = 5000;
+class CompanionProtocol {
+    connection;
+    xid = Math.floor(Math.random() * 0x10000); // Random starting xid like pyatv
+    pendingRequests = new Map();
+    pendingAuth = new Map(); // keyed by frame type
+    eventListeners = new Map();
+    events = new events_1.EventEmitter();
+    srp;
+    credentialString;
+    _onConnectionLost;
+    constructor(connection, credentialString) {
+        this.connection = connection;
+        this.srp = new srp_1.SRPAuthHandler();
+        this.credentialString = credentialString;
+    }
+    set onConnectionLost(handler) {
+        this._onConnectionLost = handler;
+    }
+    // ---- FrameListener interface ----
+    frameReceived(frameType, payload) {
+        // Auth frames (PS_*, PV_*)
+        if (frameType >= connection_1.FrameType.PS_Start && frameType <= connection_1.FrameType.PV_Next) {
+            this.handleAuthFrame(frameType, payload);
+            return;
+        }
+        // OPACK frames
+        if (frameType === connection_1.FrameType.E_OPACK || frameType === connection_1.FrameType.U_OPACK || frameType === connection_1.FrameType.P_OPACK) {
+            if (payload.length === 0)
+                return;
+            const { value } = opack.unpack(payload);
+            this.handleOpack(frameType, value);
+        }
+    }
+    connectionLost(error) {
+        // Reject all pending requests
+        for (const [, pending] of this.pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('Connection lost'));
+        }
+        this.pendingRequests.clear();
+        for (const [, pending] of this.pendingAuth) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('Connection lost'));
+        }
+        this.pendingAuth.clear();
+        if (this._onConnectionLost)
+            this._onConnectionLost(error);
+    }
+    // ---- Auth frame handling ----
+    handleAuthFrame(frameType, payload) {
+        if (payload.length === 0)
+            return;
+        const { value } = opack.unpack(payload);
+        const data = value;
+        // Auth responses come as the next frame type after the request
+        // PV_Start(5) → response comes as PV_Next(6), PS_Start(3) → PS_Next(4)
+        const pending = this.pendingAuth.get(frameType);
+        if (pending) {
+            clearTimeout(pending.timer);
+            this.pendingAuth.delete(frameType);
+            pending.resolve(data);
+        }
+    }
+    /**
+     * Exchange an auth frame and wait for the response.
+     */
+    async exchangeAuth(frameType, data, timeout = DEFAULT_TIMEOUT) {
+        // Response frame type: for PS_Start(3)→PS_Next(4), PV_Start(5)→PV_Next(6)
+        // For PS_Next(4)→PS_Next(4), PV_Next(6)→PV_Next(6)
+        let responseType;
+        if (frameType === connection_1.FrameType.PS_Start) {
+            responseType = connection_1.FrameType.PS_Next;
+        }
+        else if (frameType === connection_1.FrameType.PV_Start) {
+            responseType = connection_1.FrameType.PV_Next;
+        }
+        else {
+            responseType = frameType; // PS_Next → PS_Next, PV_Next → PV_Next
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingAuth.delete(responseType);
+                reject(new Error(`Auth exchange timeout for frame type ${frameType}`));
+            }, timeout);
+            this.pendingAuth.set(responseType, { resolve, reject, timer });
+            this.connection.send(frameType, opack.pack(data));
+        });
+    }
+    // ---- OPACK message handling ----
+    handleOpack(frameType, data) {
+        const messageType = data._t;
+        if (messageType === MessageType.Event) {
+            const eventName = data._i;
+            const content = (data._c || {});
+            const listeners = this.eventListeners.get(eventName);
+            if (listeners) {
+                for (const listener of listeners) {
+                    try {
+                        listener(content);
+                    }
+                    catch { }
+                }
+            }
+            this.events.emit(eventName, content);
+        }
+        else if (messageType === MessageType.Response) {
+            const xid = data._x;
+            const pending = this.pendingRequests.get(xid);
+            if (pending) {
+                clearTimeout(pending.timer);
+                this.pendingRequests.delete(xid);
+                pending.resolve(data);
+            }
+        }
+    }
+    /**
+     * Send an OPACK request and wait for the response.
+     */
+    async exchangeOpack(data, frameType = connection_1.FrameType.E_OPACK, timeout = DEFAULT_TIMEOUT) {
+        const xid = this.xid++;
+        data._x = xid;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(xid);
+                reject(new Error(`OPACK exchange timeout for xid ${xid}`));
+            }, timeout);
+            this.pendingRequests.set(xid, { resolve, reject, timer });
+            this.connection.send(frameType, opack.pack(data));
+        });
+    }
+    /**
+     * Send an OPACK event (no response expected).
+     */
+    sendEvent(identifier, content) {
+        const data = {
+            _i: identifier,
+            _t: MessageType.Event,
+            _c: content,
+            _x: this.xid++,
+        };
+        this.connection.send(connection_1.FrameType.E_OPACK, opack.pack(data));
+    }
+    /**
+     * Send an OPACK request with standard message structure.
+     */
+    async sendCommand(identifier, content = {}, timeout = DEFAULT_TIMEOUT) {
+        const data = {
+            _i: identifier,
+            _t: MessageType.Request,
+            _c: content,
+        };
+        return this.exchangeOpack(data, connection_1.FrameType.E_OPACK, timeout);
+    }
+    /**
+     * Register a listener for a specific event name.
+     */
+    listenTo(eventName, listener) {
+        const existing = this.eventListeners.get(eventName) || [];
+        existing.push(listener);
+        this.eventListeners.set(eventName, existing);
+    }
+    /**
+     * Subscribe to device events.
+     */
+    async subscribeEvent(eventName) {
+        this.sendEvent('_interest', { _regEvents: [eventName] });
+    }
+    // ---- Connection lifecycle ----
+    /**
+     * Start the protocol: connect, verify credentials if available, enable encryption.
+     */
+    async start() {
+        await this.connection.connect();
+        if (this.credentialString) {
+            const credentials = (0, credentials_1.parseCredentials)(this.credentialString);
+            await this.setupEncryption(credentials);
+        }
+    }
+    async setupEncryption(credentials) {
+        const verifier = new auth_1.CompanionPairVerifyProcedure(this, this.srp, credentials);
+        await verifier.verifyCredentials();
+        const [outputKey, inputKey] = verifier.encryptionKeys();
+        this.connection.enableEncryption(outputKey, inputKey);
+    }
+    close() {
+        this.connection.close();
+    }
+}
+exports.CompanionProtocol = CompanionProtocol;
+//# sourceMappingURL=protocol.js.map

package/dist/companion/protocol.js.map

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

package/dist/companion/remote.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Remote control via Companion protocol HID and media control commands.
+ * Port of pyatv/protocols/companion/api.py + __init__.py remote control.
+ */
+import { CompanionProtocol } from './protocol';
+/** HID command values matching pyatv's HidCommand enum. */
+export declare enum HidCommand {
+    Up = 1,
+    Down = 2,
+    Left = 3,
+    Right = 4,
+    Menu = 5,
+    Select = 6,
+    Home = 7,
+    VolumeUp = 8,
+    VolumeDown = 9,
+    Siri = 10,
+    Screensaver = 11,
+    Sleep = 12,
+    Wake = 13,
+    PlayPause = 14,
+    ChannelIncrement = 15,
+    ChannelDecrement = 16,
+    Guide = 17,
+    PageUp = 18,
+    PageDown = 19
+}
+/** Media control command values matching pyatv's MediaControlCommand enum. */
+export declare enum MediaControlCommand {
+    Play = 1,
+    Pause = 2,
+    NextTrack = 3,
+    PreviousTrack = 4,
+    GetVolume = 5,
+    SetVolume = 6,
+    SkipBy = 7
+}
+/** Named remote keys. */
+export declare enum RemoteKey {
+    Up = "up",
+    Down = "down",
+    Left = "left",
+    Right = "right",
+    Select = "select",
+    Menu = "menu",
+    TopMenu = "top_menu",
+    Home = "home",
+    HomeHold = "home_hold",
+    PlayPause = "play_pause",
+    Next = "next",
+    Previous = "previous",
+    SkipForward = "skip_forward",
+    SkipBackward = "skip_backward",
+    VolumeUp = "volume_up",
+    VolumeDown = "volume_down",
+    Guide = "guide"
+}
+/**
+ * Send a media control command.
+ */
+export declare function sendMediaControl(protocol: CompanionProtocol, command: MediaControlCommand, args?: Record<string, unknown>): Promise<void>;
+/**
+ * Send a remote control key press. Handles HID keys, media control keys,
+ * and long-press keys automatically.
+ */
+export declare function sendKeyPress(protocol: CompanionProtocol, key: RemoteKey | string): Promise<void>;
+/**
+ * Send a HID button down event only (for long press behavior).
+ */
+export declare function sendKeyDown(protocol: CompanionProtocol, key: RemoteKey | string): Promise<void>;
+/**
+ * Send a HID button up event only (to release a held button).
+ */
+export declare function sendKeyUp(protocol: CompanionProtocol, key: RemoteKey | string): Promise<void>;
+//# sourceMappingURL=remote.d.ts.map

package/dist/companion/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/companion/remote.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,2DAA2D;AAC3D,oBAAY,UAAU;IACpB,EAAE,IAAI;IACN,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;IACR,MAAM,IAAI;IACV,IAAI,IAAI;IACR,QAAQ,IAAI;IACZ,UAAU,IAAI;IACd,IAAI,KAAK;IACT,WAAW,KAAK;IAChB,KAAK,KAAK;IACV,IAAI,KAAK;IACT,SAAS,KAAK;IACd,gBAAgB,KAAK;IACrB,gBAAgB,KAAK;IACrB,KAAK,KAAK;IACV,MAAM,KAAK;IACX,QAAQ,KAAK;CACd;AAED,8EAA8E;AAC9E,oBAAY,mBAAmB;IAC7B,IAAI,IAAI;IACR,KAAK,IAAI;IACT,SAAS,IAAI;IACb,aAAa,IAAI;IACjB,SAAS,IAAI;IACb,SAAS,IAAI;IACb,MAAM,IAAI;CACX;AAED,yBAAyB;AACzB,oBAAY,SAAS;IACnB,EAAE,OAAO;IACT,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,OAAO,aAAa;IACpB,IAAI,SAAS;IACb,QAAQ,cAAc;IACtB,SAAS,eAAe;IACxB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,WAAW,iBAAiB;IAC5B,YAAY,kBAAkB;IAC9B,QAAQ,cAAc;IACtB,UAAU,gBAAgB;IAC1B,KAAK,UAAU;CAChB;AA6BD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBtG;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrG;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnG"}

package/dist/companion/remote.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Remote control via Companion protocol HID and media control commands.
+ * Port of pyatv/protocols/companion/api.py + __init__.py remote control.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteKey = exports.MediaControlCommand = exports.HidCommand = void 0;
+exports.sendMediaControl = sendMediaControl;
+exports.sendKeyPress = sendKeyPress;
+exports.sendKeyDown = sendKeyDown;
+exports.sendKeyUp = sendKeyUp;
+/** HID command values matching pyatv's HidCommand enum. */
+var HidCommand;
+(function (HidCommand) {
+    HidCommand[HidCommand["Up"] = 1] = "Up";
+    HidCommand[HidCommand["Down"] = 2] = "Down";
+    HidCommand[HidCommand["Left"] = 3] = "Left";
+    HidCommand[HidCommand["Right"] = 4] = "Right";
+    HidCommand[HidCommand["Menu"] = 5] = "Menu";
+    HidCommand[HidCommand["Select"] = 6] = "Select";
+    HidCommand[HidCommand["Home"] = 7] = "Home";
+    HidCommand[HidCommand["VolumeUp"] = 8] = "VolumeUp";
+    HidCommand[HidCommand["VolumeDown"] = 9] = "VolumeDown";
+    HidCommand[HidCommand["Siri"] = 10] = "Siri";
+    HidCommand[HidCommand["Screensaver"] = 11] = "Screensaver";
+    HidCommand[HidCommand["Sleep"] = 12] = "Sleep";
+    HidCommand[HidCommand["Wake"] = 13] = "Wake";
+    HidCommand[HidCommand["PlayPause"] = 14] = "PlayPause";
+    HidCommand[HidCommand["ChannelIncrement"] = 15] = "ChannelIncrement";
+    HidCommand[HidCommand["ChannelDecrement"] = 16] = "ChannelDecrement";
+    HidCommand[HidCommand["Guide"] = 17] = "Guide";
+    HidCommand[HidCommand["PageUp"] = 18] = "PageUp";
+    HidCommand[HidCommand["PageDown"] = 19] = "PageDown";
+})(HidCommand || (exports.HidCommand = HidCommand = {}));
+/** Media control command values matching pyatv's MediaControlCommand enum. */
+var MediaControlCommand;
+(function (MediaControlCommand) {
+    MediaControlCommand[MediaControlCommand["Play"] = 1] = "Play";
+    MediaControlCommand[MediaControlCommand["Pause"] = 2] = "Pause";
+    MediaControlCommand[MediaControlCommand["NextTrack"] = 3] = "NextTrack";
+    MediaControlCommand[MediaControlCommand["PreviousTrack"] = 4] = "PreviousTrack";
+    MediaControlCommand[MediaControlCommand["GetVolume"] = 5] = "GetVolume";
+    MediaControlCommand[MediaControlCommand["SetVolume"] = 6] = "SetVolume";
+    MediaControlCommand[MediaControlCommand["SkipBy"] = 7] = "SkipBy";
+})(MediaControlCommand || (exports.MediaControlCommand = MediaControlCommand = {}));
+/** Named remote keys. */
+var RemoteKey;
+(function (RemoteKey) {
+    RemoteKey["Up"] = "up";
+    RemoteKey["Down"] = "down";
+    RemoteKey["Left"] = "left";
+    RemoteKey["Right"] = "right";
+    RemoteKey["Select"] = "select";
+    RemoteKey["Menu"] = "menu";
+    RemoteKey["TopMenu"] = "top_menu";
+    RemoteKey["Home"] = "home";
+    RemoteKey["HomeHold"] = "home_hold";
+    RemoteKey["PlayPause"] = "play_pause";
+    RemoteKey["Next"] = "next";
+    RemoteKey["Previous"] = "previous";
+    RemoteKey["SkipForward"] = "skip_forward";
+    RemoteKey["SkipBackward"] = "skip_backward";
+    RemoteKey["VolumeUp"] = "volume_up";
+    RemoteKey["VolumeDown"] = "volume_down";
+    RemoteKey["Guide"] = "guide";
+})(RemoteKey || (exports.RemoteKey = RemoteKey = {}));
+const KEY_TO_HID = {
+    [RemoteKey.Up]: HidCommand.Up,
+    [RemoteKey.Down]: HidCommand.Down,
+    [RemoteKey.Left]: HidCommand.Left,
+    [RemoteKey.Right]: HidCommand.Right,
+    [RemoteKey.Select]: HidCommand.Select,
+    [RemoteKey.Menu]: HidCommand.Menu,
+    [RemoteKey.TopMenu]: HidCommand.Menu,
+    [RemoteKey.Home]: HidCommand.Home,
+    [RemoteKey.HomeHold]: HidCommand.Home,
+    [RemoteKey.PlayPause]: HidCommand.PlayPause,
+    [RemoteKey.VolumeUp]: HidCommand.VolumeUp,
+    [RemoteKey.VolumeDown]: HidCommand.VolumeDown,
+    [RemoteKey.Guide]: HidCommand.Guide,
+};
+/** Keys that are media control commands rather than HID. */
+const KEY_TO_MEDIA = {
+    [RemoteKey.Next]: MediaControlCommand.NextTrack,
+    [RemoteKey.Previous]: MediaControlCommand.PreviousTrack,
+};
+/** Keys that require a long press (hold down, delay, release). */
+const LONG_PRESS_KEYS = new Set([RemoteKey.HomeHold]);
+const LONG_PRESS_DELAY_MS = 1000;
+/**
+ * Send a media control command.
+ */
+async function sendMediaControl(protocol, command, args) {
+    await protocol.sendCommand('_mcc', { _mcc: command, ...(args || {}) });
+}
+/**
+ * Send a remote control key press. Handles HID keys, media control keys,
+ * and long-press keys automatically.
+ */
+async function sendKeyPress(protocol, key) {
+    // Media control keys
+    const mediaCommand = KEY_TO_MEDIA[key];
+    if (mediaCommand !== undefined) {
+        await sendMediaControl(protocol, mediaCommand);
+        return;
+    }
+    const hidCommand = KEY_TO_HID[key];
+    if (hidCommand === undefined) {
+        throw new Error(`Unknown remote key: ${key}`);
+    }
+    if (LONG_PRESS_KEYS.has(key)) {
+        // Long press: hold down, wait, release
+        await protocol.sendCommand('_hidC', { _hBtS: 1, _hidC: hidCommand });
+        await new Promise((r) => setTimeout(r, LONG_PRESS_DELAY_MS));
+        await protocol.sendCommand('_hidC', { _hBtS: 2, _hidC: hidCommand });
+        return;
+    }
+    // Normal press: down + up
+    await protocol.sendCommand('_hidC', { _hBtS: 1, _hidC: hidCommand });
+    await protocol.sendCommand('_hidC', { _hBtS: 2, _hidC: hidCommand });
+}
+/**
+ * Send a HID button down event only (for long press behavior).
+ */
+async function sendKeyDown(protocol, key) {
+    const hidCommand = KEY_TO_HID[key];
+    if (hidCommand === undefined) {
+        throw new Error(`Unknown remote key: ${key}`);
+    }
+    await protocol.sendCommand('_hidC', { _hBtS: 1, _hidC: hidCommand });
+}
+/**
+ * Send a HID button up event only (to release a held button).
+ */
+async function sendKeyUp(protocol, key) {
+    const hidCommand = KEY_TO_HID[key];
+    if (hidCommand === undefined) {
+        throw new Error(`Unknown remote key: ${key}`);
+    }
+    await protocol.sendCommand('_hidC', { _hBtS: 2, _hidC: hidCommand });
+}
+//# sourceMappingURL=remote.js.map

package/dist/companion/remote.js.map

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

package/dist/crypto/chacha20.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ChaCha20-Poly1305 AEAD encryption with counter-based nonces.
+ * Uses @noble/ciphers for pure JS implementation (works in Electron).
+ */
+declare const AUTH_TAG_LENGTH = 16;
+export { AUTH_TAG_LENGTH };
+export declare class Chacha20Cipher {
+    private outKey;
+    private inKey;
+    private outCounter;
+    private inCounter;
+    private nonceLength;
+    constructor(outKey: Buffer, inKey: Buffer, nonceLength?: number);
+    private padNonce;
+    private getOutNonce;
+    private getInNonce;
+    encrypt(data: Buffer, nonce?: Buffer, aad?: Buffer): Buffer;
+    decrypt(data: Buffer, nonce?: Buffer, aad?: Buffer): Buffer;
+}
+/**
+ * 8-byte counter variant: nonce = [4 zero bytes][8-byte LE counter].
+ * Used for pairing steps with explicit nonces like "PS-Msg05", "PV-Msg02".
+ */
+export declare class Chacha20Cipher8byteNonce extends Chacha20Cipher {
+    constructor(outKey: Buffer, inKey: Buffer);
+}
+//# sourceMappingURL=chacha20.d.ts.map

package/dist/crypto/chacha20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chacha20.d.ts","sourceRoot":"","sources":["../../src/crypto/chacha20.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,QAAA,MAAM,eAAe,KAAK,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,SAAK;IAM3D,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAe3D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;CAc5D;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;gBAC9C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAG1C"}

package/dist/crypto/chacha20.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * ChaCha20-Poly1305 AEAD encryption with counter-based nonces.
+ * Uses @noble/ciphers for pure JS implementation (works in Electron).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chacha20Cipher8byteNonce = exports.Chacha20Cipher = exports.AUTH_TAG_LENGTH = void 0;
+const chacha_js_1 = require("@noble/ciphers/chacha.js");
+const NONCE_LENGTH = 12;
+const AUTH_TAG_LENGTH = 16;
+exports.AUTH_TAG_LENGTH = AUTH_TAG_LENGTH;
+class Chacha20Cipher {
+    outKey;
+    inKey;
+    outCounter = 0;
+    inCounter = 0;
+    nonceLength;
+    constructor(outKey, inKey, nonceLength = 12) {
+        this.outKey = outKey;
+        this.inKey = inKey;
+        this.nonceLength = nonceLength;
+    }
+    padNonce(nonce) {
+        if (nonce.length >= NONCE_LENGTH)
+            return nonce;
+        const padded = Buffer.alloc(NONCE_LENGTH);
+        nonce.copy(padded, NONCE_LENGTH - nonce.length);
+        return padded;
+    }
+    getOutNonce() {
+        const nonce = Buffer.alloc(this.nonceLength);
+        writeLECounter(nonce, this.outCounter, this.nonceLength);
+        return this.nonceLength !== NONCE_LENGTH ? this.padNonce(nonce) : nonce;
+    }
+    getInNonce() {
+        const nonce = Buffer.alloc(this.nonceLength);
+        writeLECounter(nonce, this.inCounter, this.nonceLength);
+        return this.nonceLength !== NONCE_LENGTH ? this.padNonce(nonce) : nonce;
+    }
+    encrypt(data, nonce, aad) {
+        let useNonce;
+        if (nonce === undefined) {
+            useNonce = this.getOutNonce();
+            this.outCounter++;
+        }
+        else {
+            useNonce = nonce.length < NONCE_LENGTH ? this.padNonce(nonce) : nonce;
+        }
+        // Use @noble/ciphers chacha20-poly1305 (pure JS, works in Electron)
+        const cipher = (0, chacha_js_1.chacha20poly1305)(this.outKey, useNonce, aad);
+        const encrypted = cipher.encrypt(data);
+        return Buffer.from(encrypted);
+    }
+    decrypt(data, nonce, aad) {
+        let useNonce;
+        if (nonce === undefined) {
+            useNonce = this.getInNonce();
+            this.inCounter++;
+        }
+        else {
+            useNonce = nonce.length < NONCE_LENGTH ? this.padNonce(nonce) : nonce;
+        }
+        // Use @noble/ciphers chacha20-poly1305 (pure JS, works in Electron)
+        const decipher = (0, chacha_js_1.chacha20poly1305)(this.inKey, useNonce, aad);
+        const decrypted = decipher.decrypt(data);
+        return Buffer.from(decrypted);
+    }
+}
+exports.Chacha20Cipher = Chacha20Cipher;
+/**
+ * 8-byte counter variant: nonce = [4 zero bytes][8-byte LE counter].
+ * Used for pairing steps with explicit nonces like "PS-Msg05", "PV-Msg02".
+ */
+class Chacha20Cipher8byteNonce extends Chacha20Cipher {
+    constructor(outKey, inKey) {
+        super(outKey, inKey, 8);
+    }
+}
+exports.Chacha20Cipher8byteNonce = Chacha20Cipher8byteNonce;
+function writeLECounter(buf, counter, length) {
+    // Use BigInt to avoid JavaScript's 32-bit limit on bit operations
+    let c = BigInt(counter);
+    for (let i = 0; i < length && i < 8; i++) {
+        buf[i] = Number(c & 0xffn);
+        c >>= 8n;
+    }
+}
+//# sourceMappingURL=chacha20.js.map

package/dist/crypto/chacha20.js.map

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

package/dist/crypto/hkdf.d.ts

@@ -0,0 +1,6 @@
+/**
+ * HKDF-SHA512 key derivation.
+ * Port of pyatv/auth/hap_srp.py hkdf_expand().
+ */
+export declare function hkdfExpand(salt: string, info: string, sharedSecret: Buffer): Buffer;
+//# sourceMappingURL=hkdf.d.ts.map

package/dist/crypto/hkdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hkdf.d.ts","sourceRoot":"","sources":["../../src/crypto/hkdf.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAUnF"}