@av-pi-studio/client 0.0.1

package/dist/terminal-stream-router.js

@@ -0,0 +1,62 @@
+import { encodeTerminalFrame } from "@av-pi-studio/protocol";
+export class TerminalStreamRouter {
+    daemon;
+    subscribers = new Map();
+    detach = null;
+    constructor(daemon) {
+        this.daemon = daemon;
+    }
+    /** Begin routing inbound terminal frames. Idempotent. */
+    start() {
+        if (this.detach)
+            return;
+        this.detach = this.daemon.onTerminalFrame((frame) => this.dispatch(frame));
+    }
+    /** Stop routing inbound frames (subscribers retained). */
+    stop() {
+        this.detach?.();
+        this.detach = null;
+    }
+    /** Register (or replace) the subscriber for a slot. Returns an unsubscribe fn. */
+    subscribeSlot(slot, subscriber) {
+        this.subscribers.set(slot, subscriber);
+        return () => {
+            if (this.subscribers.get(slot) === subscriber)
+                this.subscribers.delete(slot);
+        };
+    }
+    /** True iff a subscriber is registered for the slot. */
+    hasSlot(slot) {
+        return this.subscribers.has(slot);
+    }
+    // ─── Outbound ─────────────────────────────────────────────────────────────
+    /** Send raw input bytes to a slot's PTY (opcode `Input = 0x02`). */
+    sendInput(slot, data) {
+        this.daemon.sendBinary(encodeTerminalFrame({ opcode: "Input", slot, data }));
+    }
+    /** Send a resize (opcode `Resize = 0x03`, JSON `{ rows, cols }` payload). */
+    sendResize(slot, rows, cols) {
+        this.daemon.sendBinary(encodeTerminalFrame({ opcode: "Resize", slot, rows, cols }));
+    }
+    // ─── Inbound dispatch ───────────────────────────────────────────────────────
+    dispatch(frame) {
+        const subscriber = this.subscribers.get(frame.slot);
+        if (!subscriber)
+            return; // no subscriber for this slot — drop
+        switch (frame.opcode) {
+            case "Output":
+                subscriber.onOutput?.(frame.data);
+                return;
+            case "Snapshot":
+                subscriber.onSnapshot?.(frame.data);
+                return;
+            case "Restore":
+                subscriber.onRestore?.(frame.data);
+                return;
+            default:
+                // Input/Resize are outbound-only; ignore if echoed back.
+                return;
+        }
+    }
+}
+//# sourceMappingURL=terminal-stream-router.js.map

package/dist/terminal-stream-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-stream-router.js","sourceRoot":"","sources":["../src/terminal-stream-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,wBAAwB,CAAC;AAuBjF,MAAM,OAAO,oBAAoB;IAIF;IAHZ,WAAW,GAAG,IAAI,GAAG,EAAkC,CAAC;IACjE,MAAM,GAAwB,IAAI,CAAC;IAE3C,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAErD,yDAAyD;IACzD,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,0DAA0D;IAC1D,IAAI;QACF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,kFAAkF;IAClF,aAAa,CAAC,IAAY,EAAE,UAAkC;QAC5D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACvC,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,UAAU;gBAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/E,CAAC,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,6EAA6E;IAE7E,oEAAoE;IACpE,SAAS,CAAC,IAAY,EAAE,IAAgB;QACtC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,6EAA6E;IAC7E,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY;QACjD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,+EAA+E;IAEvE,QAAQ,CAAC,KAAoB;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU;YAAE,OAAO,CAAC,qCAAqC;QAC9D,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACX,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,OAAO;YACT,KAAK,UAAU;gBACb,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACpC,OAAO;YACT,KAAK,SAAS;gBACZ,UAAU,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnC,OAAO;YACT;gBACE,yDAAyD;gBACzD,OAAO;QACX,CAAC;IACH,CAAC;CACF"}

package/dist/transport.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pluggable transport abstraction — direct WebSocket and (future) relay E2EE share this API.
+ * See architecture/client-app-runtime.md § Layered client library.
+ */
+export type TransportMessageHandler = (data: string | ArrayBuffer | Blob) => void;
+export type TransportCloseHandler = (code: number, reason: string) => void;
+export type TransportErrorHandler = (error: unknown) => void;
+export interface Transport {
+    /** Initiate the connection. Resolves when the socket is open (raw, pre-handshake). */
+    connect(url: string): Promise<void>;
+    /** Send a text frame. */
+    sendText(data: string): void;
+    /** Send a binary frame. */
+    sendBinary(data: Uint8Array): void;
+    /** Close the transport cleanly. */
+    close(code?: number, reason?: string): void;
+    /** Whether the transport is currently open and writeable. */
+    readonly isOpen: boolean;
+    onMessage: TransportMessageHandler | null;
+    onClose: TransportCloseHandler | null;
+    onError: TransportErrorHandler | null;
+}
+type AnyWebSocket = {
+    readyState: number;
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    onopen: ((ev: unknown) => void) | null;
+    onclose: ((ev: {
+        code: number;
+        reason: string;
+    }) => void) | null;
+    onerror: ((ev: unknown) => void) | null;
+    onmessage: ((ev: {
+        data: unknown;
+    }) => void) | null;
+};
+type WsFactory = (url: string, protocols?: string[]) => AnyWebSocket;
+/**
+ * Create a direct WebSocket transport using the supplied factory.
+ * Default factory uses the global `WebSocket` (browser/RN/Node 22+) or throws.
+ */
+export declare function createWebSocketTransport(factory?: WsFactory): Transport;
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAC3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,sFAAsF;IACtF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2BAA2B;IAC3B,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,mCAAmC;IACnC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACtC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACvC;AAID,KAAK,YAAY,GAAG;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACjE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACrD,CAAC;AAEF,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC;AASrE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CA4DvE"}

package/dist/transport.js

@@ -0,0 +1,80 @@
+/**
+ * Pluggable transport abstraction — direct WebSocket and (future) relay E2EE share this API.
+ * See architecture/client-app-runtime.md § Layered client library.
+ */
+// Node `ws` compatibility: ws closes have reason as Buffer, not string.
+function reasonString(reason) {
+    if (typeof reason === "string")
+        return reason;
+    if (reason instanceof Uint8Array || Buffer.isBuffer(reason))
+        return reason.toString("utf8");
+    return String(reason ?? "");
+}
+/**
+ * Create a direct WebSocket transport using the supplied factory.
+ * Default factory uses the global `WebSocket` (browser/RN/Node 22+) or throws.
+ */
+export function createWebSocketTransport(factory) {
+    let ws = null;
+    const self = {
+        onMessage: null,
+        onClose: null,
+        onError: null,
+        get isOpen() {
+            return ws !== null && ws.readyState === 1; // OPEN
+        },
+        connect(url) {
+            return new Promise((resolve, reject) => {
+                const create = factory ?? (() => new WebSocket(url));
+                try {
+                    ws = factory ? create(url) : new WebSocket(url);
+                }
+                catch (err) {
+                    reject(err);
+                    return;
+                }
+                ws.onopen = () => resolve();
+                ws.onerror = (ev) => {
+                    if (ws?.readyState !== 1) {
+                        reject(ev);
+                    }
+                    self.onError?.(ev);
+                };
+                ws.onclose = (ev) => {
+                    self.onClose?.(ev.code, reasonString(ev.reason));
+                };
+                ws.onmessage = (ev) => {
+                    const { data } = ev;
+                    if (data instanceof ArrayBuffer || data instanceof Uint8Array) {
+                        self.onMessage?.(data);
+                    }
+                    else if (typeof data === "string") {
+                        self.onMessage?.(data);
+                    }
+                    else if (typeof Blob !== "undefined" && data instanceof Blob) {
+                        // Browser default `binaryType` is "blob" — DaemonClient.handleIncoming already
+                        // reads Blob payloads asynchronously via `.arrayBuffer()`, so forward it as-is
+                        // instead of silently dropping every binary (terminal/file-transfer) frame.
+                        self.onMessage?.(data);
+                    }
+                    else if (Buffer.isBuffer(data)) {
+                        // Node `ws` may deliver Buffer
+                        self.onMessage?.(data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength));
+                    }
+                };
+            });
+        },
+        sendText(data) {
+            ws?.send(data);
+        },
+        sendBinary(data) {
+            ws?.send(data);
+        },
+        close(code = 1000, reason = "") {
+            ws?.close(code, reason);
+            ws = null;
+        },
+    };
+    return self;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@av-pi-studio/client",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@av-pi-studio/protocol": "^0.0.1"
+  }
+}