@bharper/atv-js 0.2.3

package/dist/companion/auth.js.map

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

package/dist/companion/connection.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Companion protocol TCP connection with frame-based protocol.
+ * Port of pyatv/protocols/companion/connection.py.
+ *
+ * Frame format: [1-byte FrameType][3-byte big-endian payload length][payload]
+ * When encrypted, payload includes 16-byte auth tag in the length field.
+ */
+export declare enum FrameType {
+    Unknown = 0,
+    NoOp = 1,
+    PS_Start = 3,
+    PS_Next = 4,
+    PV_Start = 5,
+    PV_Next = 6,
+    U_OPACK = 7,
+    E_OPACK = 8,
+    P_OPACK = 9,
+    PA_Req = 10,
+    PA_Rsp = 11,
+    SessionStartRequest = 16,
+    SessionStartResponse = 17,
+    SessionData = 18,
+    FamilyIdentityRequest = 32,
+    FamilyIdentityResponse = 33,
+    FamilyIdentityUpdate = 34
+}
+export interface FrameListener {
+    frameReceived(frameType: FrameType, payload: Buffer): void;
+    connectionLost(error?: Error): void;
+}
+export declare class CompanionConnection {
+    private socket;
+    private buffer;
+    private chacha;
+    private listener;
+    private host;
+    private port;
+    private connected;
+    constructor(host: string, port: number, listener?: FrameListener);
+    setListener(listener: FrameListener): void;
+    connect(): Promise<void>;
+    private processBuffer;
+    send(frameType: FrameType, data: Buffer): void;
+    enableEncryption(outputKey: Buffer, inputKey: Buffer): void;
+    close(): void;
+    get isConnected(): boolean;
+    getHost(): string;
+    getPort(): number;
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/companion/connection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,oBAAY,SAAS;IACnB,OAAO,IAAI;IACX,IAAI,IAAI;IACR,QAAQ,IAAI;IACZ,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;IACX,MAAM,KAAK;IACX,MAAM,KAAK;IACX,mBAAmB,KAAK;IACxB,oBAAoB,KAAK;IACzB,WAAW,KAAK;IAChB,qBAAqB,KAAK;IAC1B,sBAAsB,KAAK;IAC3B,oBAAoB,KAAK;CAC1B;AAID,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACrC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa;IAMhE,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B9B,OAAO,CAAC,aAAa;IAyBrB,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAwB9C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI3D,KAAK,IAAI,IAAI;IAQb,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,OAAO,IAAI,MAAM;IAIjB,OAAO,IAAI,MAAM;CAGlB"}

package/dist/companion/connection.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Companion protocol TCP connection with frame-based protocol.
+ * Port of pyatv/protocols/companion/connection.py.
+ *
+ * Frame format: [1-byte FrameType][3-byte big-endian payload length][payload]
+ * When encrypted, payload includes 16-byte auth tag in the length field.
+ */
+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.CompanionConnection = exports.FrameType = void 0;
+const net = __importStar(require("net"));
+const chacha20_1 = require("../crypto/chacha20");
+var FrameType;
+(function (FrameType) {
+    FrameType[FrameType["Unknown"] = 0] = "Unknown";
+    FrameType[FrameType["NoOp"] = 1] = "NoOp";
+    FrameType[FrameType["PS_Start"] = 3] = "PS_Start";
+    FrameType[FrameType["PS_Next"] = 4] = "PS_Next";
+    FrameType[FrameType["PV_Start"] = 5] = "PV_Start";
+    FrameType[FrameType["PV_Next"] = 6] = "PV_Next";
+    FrameType[FrameType["U_OPACK"] = 7] = "U_OPACK";
+    FrameType[FrameType["E_OPACK"] = 8] = "E_OPACK";
+    FrameType[FrameType["P_OPACK"] = 9] = "P_OPACK";
+    FrameType[FrameType["PA_Req"] = 10] = "PA_Req";
+    FrameType[FrameType["PA_Rsp"] = 11] = "PA_Rsp";
+    FrameType[FrameType["SessionStartRequest"] = 16] = "SessionStartRequest";
+    FrameType[FrameType["SessionStartResponse"] = 17] = "SessionStartResponse";
+    FrameType[FrameType["SessionData"] = 18] = "SessionData";
+    FrameType[FrameType["FamilyIdentityRequest"] = 32] = "FamilyIdentityRequest";
+    FrameType[FrameType["FamilyIdentityResponse"] = 33] = "FamilyIdentityResponse";
+    FrameType[FrameType["FamilyIdentityUpdate"] = 34] = "FamilyIdentityUpdate";
+})(FrameType || (exports.FrameType = FrameType = {}));
+const HEADER_LENGTH = 4;
+class CompanionConnection {
+    socket = null;
+    buffer = Buffer.alloc(0);
+    chacha = null;
+    listener;
+    host;
+    port;
+    connected = false;
+    constructor(host, port, listener) {
+        this.host = host;
+        this.port = port;
+        this.listener = listener || { frameReceived: () => { }, connectionLost: () => { } };
+    }
+    setListener(listener) {
+        this.listener = listener;
+    }
+    async connect() {
+        if (this.connected)
+            return;
+        return new Promise((resolve, reject) => {
+            this.socket = net.createConnection({ host: this.host, port: this.port }, () => {
+                this.connected = true;
+                this.socket?.unref();
+                resolve();
+            });
+            this.socket.on('data', (data) => {
+                this.buffer = Buffer.concat([this.buffer, data]);
+                this.processBuffer();
+            });
+            this.socket.on('error', (err) => {
+                if (!this.connected) {
+                    reject(err);
+                }
+                else {
+                    this.listener.connectionLost(err);
+                }
+            });
+            this.socket.on('close', () => {
+                this.connected = false;
+                this.listener.connectionLost();
+            });
+        });
+    }
+    processBuffer() {
+        while (this.buffer.length >= HEADER_LENGTH) {
+            const payloadLength = HEADER_LENGTH + ((this.buffer[1] << 16) | (this.buffer[2] << 8) | this.buffer[3]);
+            if (this.buffer.length < payloadLength)
+                break;
+            const header = this.buffer.subarray(0, HEADER_LENGTH);
+            let payload = Buffer.from(this.buffer.subarray(HEADER_LENGTH, payloadLength));
+            this.buffer = this.buffer.subarray(payloadLength);
+            if (this.chacha && payload.length > 0) {
+                try {
+                    payload = this.chacha.decrypt(payload, undefined, header);
+                }
+                catch (err) {
+                    // Decryption failed, skip this frame
+                    continue;
+                }
+            }
+            this.listener.frameReceived(header[0], payload);
+        }
+    }
+    send(frameType, data) {
+        if (!this.socket || !this.connected) {
+            throw new Error('Not connected');
+        }
+        let payloadLength = data.length;
+        if (this.chacha && payloadLength > 0) {
+            payloadLength += chacha20_1.AUTH_TAG_LENGTH;
+        }
+        const header = Buffer.alloc(HEADER_LENGTH);
+        header[0] = frameType;
+        header[1] = (payloadLength >> 16) & 0xff;
+        header[2] = (payloadLength >> 8) & 0xff;
+        header[3] = payloadLength & 0xff;
+        let payload = data;
+        if (this.chacha && data.length > 0) {
+            payload = this.chacha.encrypt(data, undefined, header);
+        }
+        this.socket.write(Buffer.concat([header, payload]));
+    }
+    enableEncryption(outputKey, inputKey) {
+        this.chacha = new chacha20_1.Chacha20Cipher(outputKey, inputKey, 12);
+    }
+    close() {
+        this.connected = false;
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+        }
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    getHost() {
+        return this.host;
+    }
+    getPort() {
+        return this.port;
+    }
+}
+exports.CompanionConnection = CompanionConnection;
+//# sourceMappingURL=connection.js.map

package/dist/companion/connection.js.map

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

package/dist/companion/keyboard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Keyboard/text input via Companion protocol.
+ * Port of pyatv/protocols/companion/api.py text input handling +
+ * pyatv/protocols/companion/__init__.py CompanionKeyboard.
+ */
+import { CompanionProtocol } from './protocol';
+export declare enum KeyboardFocusState {
+    Unknown = "unknown",
+    Focused = "focused",
+    Unfocused = "unfocused"
+}
+export interface KeyboardState {
+    focusState: KeyboardFocusState;
+}
+/**
+ * Execute a text input command: optionally clear existing text, then append new text.
+ * Returns the current text after the operation, or null if keyboard not focused.
+ */
+export declare function textInputCommand(protocol: CompanionProtocol, text: string, clearPreviousInput: boolean): Promise<string | null>;
+/**
+ * Get the current text from a focused keyboard.
+ */
+export declare function getText(protocol: CompanionProtocol): Promise<string | null>;
+/**
+ * Set (replace) the text in a focused keyboard.
+ */
+export declare function setText(protocol: CompanionProtocol, text: string): Promise<void>;
+/**
+ * Check if keyboard is currently focused by starting a text input session.
+ */
+export declare function getKeyboardFocus(protocol: CompanionProtocol): Promise<boolean>;
+/**
+ * Register keyboard focus state listeners on a protocol instance.
+ * Uses polling since _tiStarted/_tiStopped events aren't reliably pushed.
+ * Calls the callback whenever focus state changes.
+ * Returns a function to stop the polling.
+ */
+export declare function watchKeyboardFocus(protocol: CompanionProtocol, callback: (state: KeyboardFocusState) => void, pollIntervalMs?: number): () => void;
+//# sourceMappingURL=keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/companion/keyboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAgBD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,OAAO,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4CxB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,EAC7C,cAAc,SAAO,GACpB,MAAM,IAAI,CAiCZ"}

package/dist/companion/keyboard.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Keyboard/text input via Companion protocol.
+ * Port of pyatv/protocols/companion/api.py text input handling +
+ * pyatv/protocols/companion/__init__.py CompanionKeyboard.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyboardFocusState = void 0;
+exports.textInputCommand = textInputCommand;
+exports.getText = getText;
+exports.setText = setText;
+exports.getKeyboardFocus = getKeyboardFocus;
+exports.watchKeyboardFocus = watchKeyboardFocus;
+const bplist_1 = require("../bplist");
+var KeyboardFocusState;
+(function (KeyboardFocusState) {
+    KeyboardFocusState["Unknown"] = "unknown";
+    KeyboardFocusState["Focused"] = "focused";
+    KeyboardFocusState["Unfocused"] = "unfocused";
+})(KeyboardFocusState || (exports.KeyboardFocusState = KeyboardFocusState = {}));
+/**
+ * Start a text input session. Returns the response containing _tiD if keyboard is focused.
+ */
+async function textInputStart(protocol) {
+    return protocol.sendCommand('_tiStart', {});
+}
+/**
+ * Stop a text input session.
+ */
+async function textInputStop(protocol) {
+    return protocol.sendCommand('_tiStop', {});
+}
+/**
+ * Execute a text input command: optionally clear existing text, then append new text.
+ * Returns the current text after the operation, or null if keyboard not focused.
+ */
+async function textInputCommand(protocol, text, clearPreviousInput) {
+    // Restart session to get latest state
+    await textInputStop(protocol);
+    const response = await textInputStart(protocol);
+    const content = (response._c || {});
+    const tiData = content._tiD;
+    if (!tiData || !Buffer.isBuffer(tiData)) {
+        return null; // Keyboard not focused
+    }
+    // Extract session UUID and current text from NSKeyedArchiver data
+    const [sessionUuid, currentTextRaw] = (0, bplist_1.readArchiveProperties)(tiData, ['sessionUUID'], ['documentState', 'docSt', 'contextBeforeInput']);
+    if (!sessionUuid || !Buffer.isBuffer(sessionUuid)) {
+        return null;
+    }
+    let currentText = typeof currentTextRaw === 'string' ? currentTextRaw : '';
+    // Clear text if requested
+    if (clearPreviousInput) {
+        protocol.sendEvent('_tiC', {
+            _tiV: 1,
+            _tiD: (0, bplist_1.createRtiClearTextPayload)(sessionUuid),
+        });
+        currentText = '';
+    }
+    // Append new text
+    if (text) {
+        protocol.sendEvent('_tiC', {
+            _tiV: 1,
+            _tiD: (0, bplist_1.createRtiInputTextPayload)(sessionUuid, text),
+        });
+        currentText += text;
+    }
+    return currentText;
+}
+/**
+ * Get the current text from a focused keyboard.
+ */
+async function getText(protocol) {
+    return textInputCommand(protocol, '', false);
+}
+/**
+ * Set (replace) the text in a focused keyboard.
+ */
+async function setText(protocol, text) {
+    await textInputCommand(protocol, text, true);
+}
+/**
+ * Check if keyboard is currently focused by starting a text input session.
+ */
+async function getKeyboardFocus(protocol) {
+    await textInputStop(protocol);
+    const response = await textInputStart(protocol);
+    const content = (response._c || {});
+    return '_tiD' in content && content._tiD !== null && content._tiD !== undefined;
+}
+/**
+ * Register keyboard focus state listeners on a protocol instance.
+ * Uses polling since _tiStarted/_tiStopped events aren't reliably pushed.
+ * Calls the callback whenever focus state changes.
+ * Returns a function to stop the polling.
+ */
+function watchKeyboardFocus(protocol, callback, pollIntervalMs = 1000) {
+    let lastState = KeyboardFocusState.Unknown;
+    let running = true;
+    const poll = async () => {
+        if (!running)
+            return;
+        try {
+            const focused = await getKeyboardFocus(protocol);
+            const newState = focused ? KeyboardFocusState.Focused : KeyboardFocusState.Unfocused;
+            if (newState !== lastState) {
+                lastState = newState;
+                callback(newState);
+            }
+        }
+        catch {
+            // Connection may be closed, stop polling
+            running = false;
+            return;
+        }
+        if (running) {
+            setTimeout(poll, pollIntervalMs);
+        }
+    };
+    // Start polling
+    poll();
+    // Return stop function
+    return () => {
+        running = false;
+    };
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/companion/keyboard.js.map

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

package/dist/companion/pairing_keepalive.d.ts

@@ -0,0 +1,4 @@
+import { CompanionConnection } from './connection';
+export declare function getCompanionPairingConnection(host: string, port: number): CompanionConnection;
+export declare function releaseCompanionPairingConnection(connection: CompanionConnection): void;
+//# sourceMappingURL=pairing_keepalive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pairing_keepalive.d.ts","sourceRoot":"","sources":["../../src/companion/pairing_keepalive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA4BnD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAwB7F;AAED,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAoBvF"}

package/dist/companion/pairing_keepalive.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCompanionPairingConnection = getCompanionPairingConnection;
+exports.releaseCompanionPairingConnection = releaseCompanionPairingConnection;
+const connection_1 = require("./connection");
+const COMPANION_AGENT_IDLE_MS = 2 * 60 * 1000;
+const connectionCache = new Map();
+function connectionKey(host, port) {
+    return `${host}:${port}`;
+}
+function scheduleCleanup(key, entry) {
+    if (entry.timer)
+        clearTimeout(entry.timer);
+    entry.lastUsed = Date.now();
+    entry.timer = setTimeout(() => {
+        if (Date.now() - entry.lastUsed >= COMPANION_AGENT_IDLE_MS) {
+            entry.connection.close();
+            connectionCache.delete(key);
+        }
+    }, COMPANION_AGENT_IDLE_MS);
+    entry.timer.unref();
+}
+function getCompanionPairingConnection(host, port) {
+    const key = connectionKey(host, port);
+    const existing = connectionCache.get(key);
+    if (existing) {
+        if (existing.connection.isConnected) {
+            scheduleCleanup(key, existing);
+            return existing.connection;
+        }
+        existing.connection.close();
+        connectionCache.delete(key);
+    }
+    const connection = new connection_1.CompanionConnection(host, port);
+    const entry = {
+        connection,
+        lastUsed: Date.now(),
+        timer: setTimeout(() => {
+            connection.close();
+            connectionCache.delete(key);
+        }, COMPANION_AGENT_IDLE_MS),
+    };
+    entry.timer.unref();
+    connectionCache.set(key, entry);
+    return connection;
+}
+function releaseCompanionPairingConnection(connection) {
+    const key = connectionKey(connection.getHost(), connection.getPort());
+    const existing = connectionCache.get(key);
+    if (existing) {
+        scheduleCleanup(key, existing);
+    }
+    else {
+        const entry = {
+            connection,
+            lastUsed: Date.now(),
+            timer: setTimeout(() => {
+                connection.close();
+                connectionCache.delete(key);
+            }, COMPANION_AGENT_IDLE_MS),
+        };
+        entry.timer.unref();
+        connectionCache.set(key, entry);
+    }
+    // Detach listener to avoid delivering stale events.
+    connection.setListener({ frameReceived: () => { }, connectionLost: () => { } });
+}
+//# sourceMappingURL=pairing_keepalive.js.map

package/dist/companion/pairing_keepalive.js.map

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

package/dist/companion/protocol.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 }
+ */
+import { CompanionConnection, FrameType, FrameListener } from './connection';
+export declare enum MessageType {
+    Event = 1,
+    Request = 2,
+    Response = 3
+}
+export interface CompanionEventListener {
+    (data: Record<string, unknown>): void;
+}
+export declare class CompanionProtocol implements FrameListener {
+    connection: CompanionConnection;
+    private xid;
+    private pendingRequests;
+    private pendingAuth;
+    private eventListeners;
+    private events;
+    private srp;
+    private credentialString;
+    private _onConnectionLost?;
+    constructor(connection: CompanionConnection, credentialString: string | null);
+    set onConnectionLost(handler: (error?: Error) => void);
+    frameReceived(frameType: FrameType, payload: Buffer): void;
+    connectionLost(error?: Error): void;
+    private handleAuthFrame;
+    /**
+     * Exchange an auth frame and wait for the response.
+     */
+    exchangeAuth(frameType: FrameType, data: Record<string, unknown>, timeout?: number): Promise<Record<string, unknown>>;
+    private handleOpack;
+    /**
+     * Send an OPACK request and wait for the response.
+     */
+    exchangeOpack(data: Record<string, unknown>, frameType?: FrameType, timeout?: number): Promise<Record<string, unknown>>;
+    /**
+     * Send an OPACK event (no response expected).
+     */
+    sendEvent(identifier: string, content: Record<string, unknown>): void;
+    /**
+     * Send an OPACK request with standard message structure.
+     */
+    sendCommand(identifier: string, content?: Record<string, unknown>, timeout?: number): Promise<Record<string, unknown>>;
+    /**
+     * Register a listener for a specific event name.
+     */
+    listenTo(eventName: string, listener: CompanionEventListener): void;
+    /**
+     * Subscribe to device events.
+     */
+    subscribeEvent(eventName: string): Promise<void>;
+    /**
+     * Start the protocol: connect, verify credentials if available, enable encryption.
+     */
+    start(): Promise<void>;
+    private setupEncryption;
+    close(): void;
+}
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/companion/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAM7E,oBAAY,WAAW;IACrB,KAAK,IAAI;IACT,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AAUD,MAAM,WAAW,sBAAsB;IACrC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACvC;AAED,qBAAa,iBAAkB,YAAW,aAAa;IACrD,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,CAAC,GAAG,CAAuC;IAClD,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,iBAAiB,CAAC,CAA0B;gBAExC,UAAU,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAM5E,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,EAEpD;IAID,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAe1D,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAmBnC,OAAO,CAAC,eAAe;IAevB;;OAEG;IACG,YAAY,CAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,SAAkB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAyBnC,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,GAAE,SAA6B,EACxC,OAAO,SAAkB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAenC;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUrE;;OAEG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,OAAO,SAAkB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASnC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAMnE;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,eAAe;IAO7B,KAAK,IAAI,IAAI;CAGd"}