@kuralle-syrinx/ws 4.4.1 → 4.5.0

package/dist/node.js

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: MIT
+//
+// Node/Bun socket adapter for WebSocketConnection, backed by the `ws` library.
+// Kept in its own entry point so a Cloudflare Workers build (which uses
+// createWebSocketAdapter) never bundles `ws`.
+import WebSocket from "ws";
+export const createNodeWsSocket = (url, headers) => {
+    const ws = new WebSocket(url, Object.keys(headers).length > 0 ? { headers } : undefined);
+    let verifyTimer = null;
+    let verifyOnPong = null;
+    let verifyResolve = null;
+    const clearVerify = (result) => {
+        if (verifyTimer)
+            clearTimeout(verifyTimer);
+        if (verifyOnPong)
+            ws.off("pong", verifyOnPong);
+        verifyTimer = null;
+        verifyOnPong = null;
+        if (verifyResolve) {
+            verifyResolve(result ?? false);
+            verifyResolve = null;
+        }
+    };
+    return {
+        supportsFramePing: true,
+        get isOpen() {
+            return ws.readyState === ws.OPEN;
+        },
+        send: (data) => ws.send(data),
+        keepAlivePing: () => {
+            try {
+                ws.ping();
+            }
+            catch {
+                // socket not open — keepalive is best-effort
+            }
+        },
+        verify: (timeoutMs) => new Promise((resolve) => {
+            clearVerify(false);
+            if (ws.readyState !== ws.OPEN) {
+                resolve(false);
+                return;
+            }
+            verifyResolve = resolve;
+            const onPong = () => {
+                clearVerify(true);
+            };
+            verifyOnPong = onPong;
+            verifyTimer = setTimeout(() => {
+                clearVerify(false);
+            }, timeoutMs);
+            ws.once("pong", onPong);
+            try {
+                ws.ping();
+            }
+            catch {
+                clearVerify(false);
+            }
+        }),
+        dispose: () => {
+            clearVerify(false);
+            ws.removeAllListeners();
+            // Closing a socket that is still CONNECTING makes `ws` emit an asynchronous
+            // 'error' event ("WebSocket was closed before the connection was established").
+            // removeAllListeners() just stripped the error handler, so without re-attaching
+            // a sink that event becomes an uncaught exception and crashes the process — the
+            // exact thing that happens when a caller hangs up during a slow provider connect.
+            // Swallow stray close-time errors, and abort a pending handshake with terminate().
+            ws.on("error", () => { });
+            try {
+                if (ws.readyState === ws.CONNECTING) {
+                    ws.terminate();
+                }
+                else {
+                    ws.close();
+                }
+            }
+            catch {
+                // best effort
+            }
+        },
+        onOpen: (handler) => ws.on("open", handler),
+        onMessage: (handler) => ws.on("message", (data, isBinary) => handler(isBinary ? toUint8(data) : data.toString(), isBinary)),
+        onClose: (handler) => ws.on("close", (code, reason) => handler(code, reason.toString("utf8"))),
+        onError: (handler) => ws.on("error", handler),
+    };
+};
+function toUint8(data) {
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    if (Array.isArray(data))
+        return new Uint8Array(Buffer.concat(data));
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/realtime-socket.d.ts

@@ -0,0 +1,24 @@
+import { type RetryConfig } from "@kuralle-syrinx/core";
+import { type SocketFactory } from "./index.js";
+export interface RealtimeSocketOptions {
+    readonly url: () => string;
+    readonly headers?: Record<string, string>;
+    readonly socketFactory: SocketFactory;
+    readonly retry?: RetryConfig;
+    readonly keepAliveIntervalMs?: number;
+    readonly replayBufferSize?: number;
+    readonly onMessage: (json: string) => void;
+    readonly onReady?: () => void;
+    readonly onConnectionLost?: (err: Error) => void;
+    readonly onUnrecoverable?: (err: Error) => void;
+}
+export declare class RealtimeSocket {
+    private readonly opts;
+    private conn;
+    constructor(opts: RealtimeSocketOptions);
+    connect(): Promise<void>;
+    send(event: Record<string, unknown>): void;
+    get isReady(): boolean;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=realtime-socket.d.ts.map

package/dist/realtime-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-socket.d.ts","sourceRoot":"","sources":["../src/realtime-socket.ts"],"names":[],"mappings":"AAMA,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACjD;AAED,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,IAAI,CAAoC;gBAEnB,IAAI,EAAE,qBAAqB;IAElD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK1C,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/realtime-socket.js

@@ -0,0 +1,45 @@
+// SPDX-License-Identifier: MIT
+//
+// Full-duplex provider socket for OpenAI Realtime (and siblings). Wraps
+// WebSocketConnection with JSON send/receive — the cascade STT/TTS sockets
+// stay separate; this is the bi-model live loop transport.
+import { VOICE_PROVIDER_RETRY_CONFIG } from "@kuralle-syrinx/core";
+import { WebSocketConnection } from "./index.js";
+export class RealtimeSocket {
+    opts;
+    conn = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async connect() {
+        this.conn = new WebSocketConnection({
+            url: this.opts.url,
+            headers: this.opts.headers,
+            socketFactory: this.opts.socketFactory,
+            retry: this.opts.retry ?? VOICE_PROVIDER_RETRY_CONFIG,
+            keepAliveIntervalMs: this.opts.keepAliveIntervalMs ?? 15_000,
+            replayBufferSize: this.opts.replayBufferSize ?? 0,
+            onMessage: (data) => {
+                if (typeof data === "string")
+                    this.opts.onMessage(data);
+            },
+            onConnectionLost: this.opts.onConnectionLost,
+            onUnrecoverable: this.opts.onUnrecoverable,
+            onReadyBeforeReplay: this.opts.onReady,
+        });
+        await this.conn.connect();
+    }
+    send(event) {
+        if (!this.conn)
+            throw new Error("Realtime socket is not connected");
+        this.conn.send(JSON.stringify(event));
+    }
+    get isReady() {
+        return this.conn?.isReady ?? false;
+    }
+    async close() {
+        await this.conn?.close();
+        this.conn = null;
+    }
+}
+//# sourceMappingURL=realtime-socket.js.map

package/dist/realtime-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-socket.js","sourceRoot":"","sources":["../src/realtime-socket.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,wEAAwE;AACxE,2EAA2E;AAC3E,2DAA2D;AAE3D,OAAO,EAAE,2BAA2B,EAAoB,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAsB,MAAM,YAAY,CAAC;AAerE,MAAM,OAAO,cAAc;IAGI;IAFrB,IAAI,GAA+B,IAAI,CAAC;IAEhD,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAE5D,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,GAAG,IAAI,mBAAmB,CAAC;YAClC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG;YAClB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YAC1B,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;YACtC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,2BAA2B;YACrD,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,IAAI,MAAM;YAC5D,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC;YACjD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;gBAClB,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1D,CAAC;YACD,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAC5C,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe;YAC1C,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;SACvC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,KAA8B;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/web-socket.d.ts

@@ -0,0 +1,20 @@
+import type { ManagedSocket, SocketFactory } from "./index.js";
+/** The subset of the standard WebSocket this adapter relies on (no DOM lib needed). */
+export interface WebSocketLike {
+    readyState: number;
+    binaryType: string;
+    send(data: string | ArrayBufferView | ArrayBuffer): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, listener: (event: WebSocketEventLike) => void): void;
+}
+/** The event object a standard WebSocket hands its listeners (message: data; close: code/reason). */
+export interface WebSocketEventLike {
+    readonly data?: string | ArrayBuffer;
+    readonly code?: number;
+    readonly reason?: string;
+}
+/** Factory using the runtime's global WebSocket (no auth headers — same-origin or token-in-URL). */
+export declare const createWebSocketAdapter: SocketFactory;
+/** Wrap an already-constructed WebSocket (e.g. a Workers fetch-upgrade `response.webSocket`). */
+export declare function wrapWebSocket(ws: WebSocketLike): ManagedSocket;
+//# sourceMappingURL=web-socket.d.ts.map

package/dist/web-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-socket.d.ts","sourceRoot":"","sources":["../src/web-socket.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3E,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,WAAW,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;CACrF;AAED,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,oGAAoG;AACpG,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,aAAa,CAyC9D"}

package/dist/web-socket.js

@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: MIT
+//
+// Adapter for WebSocketConnection backed by the standard built-in WebSocket —
+// the one available in the browser, Cloudflare Workers, and Bun (and Node 21+).
+// It has no ping frame, so verify() falls back to readyState and keepalive must
+// use an app-level message (keepAliveMessage). Headers cannot be set on the
+// WebSocket constructor in the browser; on Workers, auth-header connections use
+// the fetch-upgrade route — construct the socket yourself and pass it to
+// wrapWebSocket.
+const WEBSOCKET_OPEN = 1;
+/** Factory using the runtime's global WebSocket (no auth headers — same-origin or token-in-URL). */
+export const createWebSocketAdapter = (url) => {
+    const ctor = globalThis.WebSocket;
+    if (!ctor)
+        throw new Error("global WebSocket is not available in this runtime");
+    return wrapWebSocket(new ctor(url));
+};
+/** Wrap an already-constructed WebSocket (e.g. a Workers fetch-upgrade `response.webSocket`). */
+export function wrapWebSocket(ws) {
+    ws.binaryType = "arraybuffer";
+    return {
+        get isOpen() {
+            return ws.readyState === WEBSOCKET_OPEN;
+        },
+        send: (data) => ws.send(data),
+        keepAlivePing: () => {
+            // The standard WebSocket has no ping frame — rely on keepAliveMessage.
+        },
+        verify: async (_timeoutMs) => ws.readyState === WEBSOCKET_OPEN,
+        dispose: () => {
+            try {
+                ws.close();
+            }
+            catch {
+                // best effort
+            }
+        },
+        onOpen: (handler) => {
+            // workerd: after fetch-upgrade + WebSocket.accept(), readyState is already OPEN
+            // and the runtime never emits an "open" event — only sockets that transition
+            // from CONNECTING fire it. queueMicrotask preserves the async onOpen contract
+            // WebSocketConnection expects without waiting for an event that won't come.
+            if (ws.readyState === WEBSOCKET_OPEN) {
+                queueMicrotask(handler);
+                return;
+            }
+            ws.addEventListener("open", () => handler());
+        },
+        onMessage: (handler) => ws.addEventListener("message", (event) => {
+            const payload = event.data;
+            if (typeof payload === "string") {
+                handler(payload, false);
+            }
+            else if (payload) {
+                handler(new Uint8Array(payload), true);
+            }
+        }),
+        onClose: (handler) => ws.addEventListener("close", (event) => handler(event.code ?? 1006, event.reason ?? "")),
+        onError: (handler) => ws.addEventListener("error", () => handler(new Error("WebSocket error"))),
+    };
+}
+//# sourceMappingURL=web-socket.js.map

package/dist/web-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-socket.js","sourceRoot":"","sources":["../src/web-socket.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,yEAAyE;AACzE,iBAAiB;AAoBjB,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,oGAAoG;AACpG,MAAM,CAAC,MAAM,sBAAsB,GAAkB,CAAC,GAAG,EAAiB,EAAE;IAC1E,MAAM,IAAI,GAAI,UAAiE,CAAC,SAAS,CAAC;IAC1F,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAChF,OAAO,aAAa,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,iGAAiG;AACjG,MAAM,UAAU,aAAa,CAAC,EAAiB;IAC7C,EAAE,CAAC,UAAU,GAAG,aAAa,CAAC;IAC9B,OAAO;QACL,IAAI,MAAM;YACR,OAAO,EAAE,CAAC,UAAU,KAAK,cAAc,CAAC;QAC1C,CAAC;QACD,IAAI,EAAE,CAAC,IAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,aAAa,EAAE,GAAG,EAAE;YAClB,uEAAuE;QACzE,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,UAAkB,EAAoB,EAAE,CAAC,EAAE,CAAC,UAAU,KAAK,cAAc;QACxF,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,CAAC;gBACH,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;QACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;YAClB,gFAAgF;YAChF,6EAA6E;YAC7E,8EAA8E;YAC9E,4EAA4E;YAC5E,IAAI,EAAE,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;gBACrC,cAAc,CAAC,OAAO,CAAC,CAAC;gBACxB,OAAO;YACT,CAAC;YACD,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;YAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC;QACJ,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC9G,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;KAChG,CAAC;AACJ,CAAC"}

package/dist/workers.d.ts

@@ -0,0 +1,26 @@
+import type { ManagedSocket } from "./index.js";
+import { type WebSocketLike } from "./web-socket.js";
+/** The Workers WebSocket adds accept(); the upgrade response carries it. */
+type WorkersWebSocket = WebSocketLike & {
+    accept(): void;
+};
+export interface WorkersDurableObjectWebSocketContext {
+    acceptWebSocket(socket: WorkersWebSocket): void;
+}
+export interface WorkersInboundSocket {
+    readonly socket: ManagedSocket;
+    readonly response: Response;
+    readonly clientWebSocket: WorkersWebSocket;
+    readonly serverWebSocket: WorkersWebSocket;
+    readonly controller?: WorkersInboundSocketController;
+}
+export interface WorkersInboundSocketController {
+    message(data: string | ArrayBuffer): void;
+    close(code: number, reason: string): void;
+    error(err?: Error): void;
+}
+/** Open an auth-header WebSocket from a Worker via fetch upgrade. Async — await before use. */
+export declare function createWorkersSocket(url: string, headers: Record<string, string>): Promise<ManagedSocket>;
+export declare function createWorkersInboundSocket(ctx?: WorkersDurableObjectWebSocketContext): WorkersInboundSocket;
+export {};
+//# sourceMappingURL=workers.d.ts.map

package/dist/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../src/workers.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEpE,4EAA4E;AAC5E,KAAK,gBAAgB,GAAG,aAAa,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAAC;AAO3D,MAAM,WAAW,oCAAoC;IACnD,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,8BAA8B,CAAC;CACtD;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC1B;AAKD,+FAA+F;AAC/F,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAU9G;AASD,wBAAgB,0BAA0B,CAAC,GAAG,CAAC,EAAE,oCAAoC,GAAG,oBAAoB,CA4B3G"}

package/dist/workers.js

@@ -0,0 +1,122 @@
+// SPDX-License-Identifier: MIT
+//
+// Cloudflare Workers socket adapter. The built-in WebSocket constructor can't
+// set request headers, so auth-header provider connections (Deepgram's
+// `Authorization: Token`, Cartesia's `X-API-Key`) are opened with a `fetch`
+// upgrade and the returned `response.webSocket`, then `accept()`-ed before use.
+//
+// Pattern from Cloudflare's own agents/voice package (workers-ai-providers.ts):
+//   const resp = await fetch(url, { headers: { Upgrade: "websocket", ...auth } });
+//   const ws = resp.webSocket; ws.accept();
+import { wrapWebSocket } from "./web-socket.js";
+/** Open an auth-header WebSocket from a Worker via fetch upgrade. Async — await before use. */
+export async function createWorkersSocket(url, headers) {
+    const doFetch = globalThis.fetch;
+    if (!doFetch)
+        throw new Error("fetch is not available in this runtime");
+    // workerd's fetch() only accepts http(s) schemes; the upgrade is requested on
+    // the http(s) URL with `Upgrade: websocket`, not on a ws(s):// URL.
+    const resp = await doFetch(toHttpUrl(url), { headers: { ...headers, Upgrade: "websocket" } });
+    const ws = resp.webSocket;
+    if (!ws)
+        throw new Error(`WebSocket upgrade failed (status ${String(resp.status ?? "unknown")})`);
+    ws.accept();
+    return wrapWebSocket(ws);
+}
+/** Normalize a ws(s):// provider URL to the http(s):// scheme workerd's fetch requires. */
+function toHttpUrl(url) {
+    if (url.startsWith("wss://"))
+        return `https://${url.slice("wss://".length)}`;
+    if (url.startsWith("ws://"))
+        return `http://${url.slice("ws://".length)}`;
+    return url;
+}
+export function createWorkersInboundSocket(ctx) {
+    const Pair = globalThis.WebSocketPair;
+    if (!Pair)
+        throw new Error("WebSocketPair is not available in this runtime");
+    const pair = new Pair();
+    const client = pair[0];
+    const server = pair[1];
+    let controller;
+    let socket;
+    if (ctx) {
+        ctx.acceptWebSocket(server);
+        const controlled = createControlledSocket(server);
+        socket = controlled.socket;
+        controller = controlled.controller;
+    }
+    else {
+        server.accept();
+        socket = wrapWebSocket(server);
+    }
+    const response = new Response(null, {
+        status: 101,
+        webSocket: client,
+    });
+    return {
+        socket,
+        response,
+        clientWebSocket: client,
+        serverWebSocket: server,
+        controller,
+    };
+}
+function createControlledSocket(ws) {
+    const messageHandlers = new Set();
+    const closeHandlers = new Set();
+    const errorHandlers = new Set();
+    return {
+        socket: {
+            get isOpen() {
+                return ws.readyState === 1;
+            },
+            send: (data) => ws.send(data),
+            keepAlivePing: () => undefined,
+            verify: async () => ws.readyState === 1,
+            dispose: () => {
+                try {
+                    ws.close();
+                }
+                catch {
+                    // best effort
+                }
+            },
+            onOpen: (handler) => {
+                if (ws.readyState === 1)
+                    queueMicrotask(handler);
+            },
+            onMessage: (handler) => {
+                messageHandlers.add(handler);
+            },
+            onClose: (handler) => {
+                closeHandlers.add(handler);
+            },
+            onError: (handler) => {
+                errorHandlers.add(handler);
+            },
+        },
+        controller: {
+            message(data) {
+                if (typeof data === "string") {
+                    for (const handler of messageHandlers)
+                        handler(data, false);
+                    return;
+                }
+                const bytes = new Uint8Array(data);
+                for (const handler of messageHandlers)
+                    handler(bytes, true);
+            },
+            close(code, reason) {
+                for (const handler of closeHandlers)
+                    handler(code, reason);
+            },
+            error(err) {
+                const error = err ?? new Error("WebSocket error");
+                for (const handler of errorHandlers)
+                    handler(error);
+            },
+        },
+    };
+}
+//# sourceMappingURL=workers.js.map

package/dist/workers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuralle-syrinx/ws",
-  "version": "4.4.1",
+  "version": "4.5.0",
   "private": false,
   "description": "Reconnecting WebSocket connection manager for Syrinx provider sockets — verify-before-trust reconnects, ordered replay, keepalive; Node and Workers",
   "keywords": [
@@ -22,26 +22,48 @@
     "url": "https://github.com/kuralle/syrinx/issues"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./node": "./src/node.ts",
-    "./realtime": "./src/realtime-socket.ts",
-    "./web": "./src/web-socket.ts",
-    "./workers": "./src/workers.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
+    "./realtime": {
+      "types": "./dist/realtime-socket.d.ts",
+      "default": "./dist/realtime-socket.js"
+    },
+    "./web": {
+      "types": "./dist/web-socket.d.ts",
+      "default": "./dist/web-socket.js"
+    },
+    "./workers": {
+      "types": "./dist/workers.d.ts",
+      "default": "./dist/workers.js"
+    }
   },
   "dependencies": {
     "ws": "^8.21.0",
-    "@kuralle-syrinx/core": "4.4.1"
+    "@kuralle-syrinx/core": "4.5.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "@types/ws": "^8.5.0",
     "typescript": "^5.7.0",
     "vitest": "^3.2.6"
   },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.build.json"
   }
 }