openai 6.34.0 → 6.36.0

package/internal/ws-adapter-browser.mjs

@@ -0,0 +1,84 @@
+export class BrowserWebSocket {
+    constructor(ws) {
+        this._listenerMap = new Map();
+        this._ws = ws;
+        this._ws.binaryType = 'arraybuffer';
+    }
+    /** The underlying platform-specific socket. Code that accesses this will not be isomorphic across server and browser environments. */
+    get platformSocket() {
+        return this._ws;
+    }
+    get readyState() {
+        return this._ws.readyState;
+    }
+    send(data) {
+        this._ws.send(data);
+    }
+    close(code, reason) {
+        this._ws.close(code, reason);
+    }
+    on(event, listener) {
+        const wrapped = this._wrapListener(event, listener);
+        this._listenersFor(event).set(listener, wrapped);
+        this._ws.addEventListener(event, wrapped);
+    }
+    off(event, listener) {
+        const byListener = this._listenerMap.get(event);
+        if (!byListener)
+            return;
+        const wrapped = byListener.get(listener);
+        if (wrapped) {
+            byListener.delete(listener);
+            this._ws.removeEventListener(event, wrapped);
+        }
+    }
+    once(event, listener) {
+        const onceListener = (...args) => {
+            this.off(event, listener);
+            listener(...args);
+        };
+        const wrapped = this._wrapListener(event, onceListener);
+        this._listenersFor(event).set(listener, wrapped);
+        this._ws.addEventListener(event, wrapped);
+    }
+    _listenersFor(event) {
+        let map = this._listenerMap.get(event);
+        if (!map) {
+            map = new Map();
+            this._listenerMap.set(event, map);
+        }
+        return map;
+    }
+    /**
+     * Converts browser event objects to positional arguments matching the
+     * {@link WebSocketLike} interface.
+     */
+    _wrapListener(event, listener) {
+        switch (event) {
+            case 'message':
+                return (ev) => {
+                    const isBinary = typeof ev.data !== 'string';
+                    listener(ev.data, isBinary);
+                };
+            case 'close':
+                return (ev) => {
+                    listener(ev.code, ev.reason);
+                };
+            case 'error':
+                return (ev) => {
+                    // Some environments provide an ErrorEvent with a `.message`;
+                    // fall back to a generic message when the event carries nothing.
+                    const message = ev?.message || ev?.error?.message || 'WebSocket error';
+                    const err = new Error(message);
+                    if (ev?.error) {
+                        err.cause = ev.error;
+                    }
+                    listener(err);
+                };
+            case 'open':
+            default:
+                return listener;
+        }
+    }
+}
+//# sourceMappingURL=ws-adapter-browser.mjs.map

package/internal/ws-adapter-browser.mjs.map

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

package/internal/ws-adapter-node.d.mts

@@ -0,0 +1,27 @@
+import type * as WS from 'ws';
+import type { WebSocketLike } from "./ws-adapter.mjs";
+/** A generic event listener callback. */
+type Listener = (...args: any[]) => void;
+export declare class NodeWebSocket implements WebSocketLike {
+    private _ws;
+    /** Maps `(event, originalListener)` -> wrapped listener for correct `off()` removal. */
+    private _listenerMap;
+    constructor(ws: WS.WebSocket);
+    /** The underlying platform-specific socket. Code that accesses this will not be isomorphic across server and browser environments. */
+    get platformSocket(): WS.WebSocket;
+    get readyState(): number;
+    send(data: string | ArrayBufferLike | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    on(event: string, listener: Listener): void;
+    off(event: string, listener: Listener): void;
+    once(event: string, listener: Listener): void;
+    private _listenersFor;
+    /**
+     * Normalizes `ws` message payloads: text frames become strings,
+     * binary frames stay as `Buffer`, and fragmented frames are merged.
+     */
+    private static _normalizeMessageData;
+    private _wrapListener;
+}
+export {};
+//# sourceMappingURL=ws-adapter-node.d.mts.map

package/internal/ws-adapter-node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-adapter-node.d.mts","sourceRoot":"","sources":["../src/internal/ws-adapter-node.ts"],"names":[],"mappings":"OAAO,KAAK,KAAK,EAAE,MAAM,IAAI;OACtB,KAAK,EAAE,aAAa,EAAE;AAE7B,yCAAyC;AACzC,KAAK,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEzC,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,GAAG,CAAe;IAE1B,wFAAwF;IACxF,OAAO,CAAC,YAAY,CAA8C;gBAEtD,EAAE,EAAE,EAAE,CAAC,SAAS;IAI5B,sIAAsI;IACtI,IAAI,cAAc,IAAI,EAAE,CAAC,SAAS,CAEjC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,IAAI;IAI5D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAM3C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAU5C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAU7C,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAepC,OAAO,CAAC,aAAa;CAiBtB"}

package/internal/ws-adapter-node.d.ts

@@ -0,0 +1,27 @@
+import type * as WS from 'ws';
+import type { WebSocketLike } from "./ws-adapter.js";
+/** A generic event listener callback. */
+type Listener = (...args: any[]) => void;
+export declare class NodeWebSocket implements WebSocketLike {
+    private _ws;
+    /** Maps `(event, originalListener)` -> wrapped listener for correct `off()` removal. */
+    private _listenerMap;
+    constructor(ws: WS.WebSocket);
+    /** The underlying platform-specific socket. Code that accesses this will not be isomorphic across server and browser environments. */
+    get platformSocket(): WS.WebSocket;
+    get readyState(): number;
+    send(data: string | ArrayBufferLike | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    on(event: string, listener: Listener): void;
+    off(event: string, listener: Listener): void;
+    once(event: string, listener: Listener): void;
+    private _listenersFor;
+    /**
+     * Normalizes `ws` message payloads: text frames become strings,
+     * binary frames stay as `Buffer`, and fragmented frames are merged.
+     */
+    private static _normalizeMessageData;
+    private _wrapListener;
+}
+export {};
+//# sourceMappingURL=ws-adapter-node.d.ts.map

package/internal/ws-adapter-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-adapter-node.d.ts","sourceRoot":"","sources":["../src/internal/ws-adapter-node.ts"],"names":[],"mappings":"OAAO,KAAK,KAAK,EAAE,MAAM,IAAI;OACtB,KAAK,EAAE,aAAa,EAAE;AAE7B,yCAAyC;AACzC,KAAK,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEzC,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,GAAG,CAAe;IAE1B,wFAAwF;IACxF,OAAO,CAAC,YAAY,CAA8C;gBAEtD,EAAE,EAAE,EAAE,CAAC,SAAS;IAI5B,sIAAsI;IACtI,IAAI,cAAc,IAAI,EAAE,CAAC,SAAS,CAEjC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,IAAI;IAI5D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAM3C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAU5C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAU7C,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAepC,OAAO,CAAC,aAAa;CAiBtB"}

package/internal/ws-adapter-node.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeWebSocket = void 0;
+class NodeWebSocket {
+    constructor(ws) {
+        /** Maps `(event, originalListener)` -> wrapped listener for correct `off()` removal. */
+        this._listenerMap = new Map();
+        this._ws = ws;
+    }
+    /** The underlying platform-specific socket. Code that accesses this will not be isomorphic across server and browser environments. */
+    get platformSocket() {
+        return this._ws;
+    }
+    get readyState() {
+        return this._ws.readyState;
+    }
+    send(data) {
+        this._ws.send(data);
+    }
+    close(code, reason) {
+        this._ws.close(code, reason);
+    }
+    on(event, listener) {
+        const wrapped = this._wrapListener(event, listener);
+        this._listenersFor(event).set(listener, wrapped);
+        this._ws.on(event, wrapped);
+    }
+    off(event, listener) {
+        const byListener = this._listenerMap.get(event);
+        if (!byListener)
+            return;
+        const wrapped = byListener.get(listener);
+        if (wrapped) {
+            byListener.delete(listener);
+            this._ws.removeListener(event, wrapped);
+        }
+    }
+    once(event, listener) {
+        const onceListener = (...args) => {
+            this.off(event, listener);
+            listener(...args);
+        };
+        const wrapped = this._wrapListener(event, onceListener);
+        this._listenersFor(event).set(listener, wrapped);
+        this._ws.on(event, wrapped);
+    }
+    _listenersFor(event) {
+        let map = this._listenerMap.get(event);
+        if (!map) {
+            map = new Map();
+            this._listenerMap.set(event, map);
+        }
+        return map;
+    }
+    /**
+     * Normalizes `ws` message payloads: text frames become strings,
+     * binary frames stay as `Buffer`, and fragmented frames are merged.
+     */
+    static _normalizeMessageData(data, isBinary) {
+        if (!isBinary) {
+            if (Array.isArray(data))
+                return Buffer.concat(data).toString();
+            if (data instanceof ArrayBuffer)
+                return Buffer.from(data).toString();
+            return data.toString();
+        }
+        if (Array.isArray(data))
+            return Buffer.concat(data);
+        if (data instanceof ArrayBuffer)
+            return Buffer.from(data);
+        return data;
+    }
+    _wrapListener(event, listener) {
+        switch (event) {
+            case 'message':
+                return (data, isBinary) => {
+                    listener(NodeWebSocket._normalizeMessageData(data, isBinary), isBinary);
+                };
+            case 'close':
+                return (code, reason) => {
+                    listener(code, reason.toString());
+                };
+            // 'open' and 'error' pass through unchanged
+            default:
+                return listener;
+        }
+    }
+}
+exports.NodeWebSocket = NodeWebSocket;
+//# sourceMappingURL=ws-adapter-node.js.map

package/internal/ws-adapter-node.js.map

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

package/internal/ws-adapter-node.mjs

@@ -0,0 +1,86 @@
+export class NodeWebSocket {
+    constructor(ws) {
+        /** Maps `(event, originalListener)` -> wrapped listener for correct `off()` removal. */
+        this._listenerMap = new Map();
+        this._ws = ws;
+    }
+    /** The underlying platform-specific socket. Code that accesses this will not be isomorphic across server and browser environments. */
+    get platformSocket() {
+        return this._ws;
+    }
+    get readyState() {
+        return this._ws.readyState;
+    }
+    send(data) {
+        this._ws.send(data);
+    }
+    close(code, reason) {
+        this._ws.close(code, reason);
+    }
+    on(event, listener) {
+        const wrapped = this._wrapListener(event, listener);
+        this._listenersFor(event).set(listener, wrapped);
+        this._ws.on(event, wrapped);
+    }
+    off(event, listener) {
+        const byListener = this._listenerMap.get(event);
+        if (!byListener)
+            return;
+        const wrapped = byListener.get(listener);
+        if (wrapped) {
+            byListener.delete(listener);
+            this._ws.removeListener(event, wrapped);
+        }
+    }
+    once(event, listener) {
+        const onceListener = (...args) => {
+            this.off(event, listener);
+            listener(...args);
+        };
+        const wrapped = this._wrapListener(event, onceListener);
+        this._listenersFor(event).set(listener, wrapped);
+        this._ws.on(event, wrapped);
+    }
+    _listenersFor(event) {
+        let map = this._listenerMap.get(event);
+        if (!map) {
+            map = new Map();
+            this._listenerMap.set(event, map);
+        }
+        return map;
+    }
+    /**
+     * Normalizes `ws` message payloads: text frames become strings,
+     * binary frames stay as `Buffer`, and fragmented frames are merged.
+     */
+    static _normalizeMessageData(data, isBinary) {
+        if (!isBinary) {
+            if (Array.isArray(data))
+                return Buffer.concat(data).toString();
+            if (data instanceof ArrayBuffer)
+                return Buffer.from(data).toString();
+            return data.toString();
+        }
+        if (Array.isArray(data))
+            return Buffer.concat(data);
+        if (data instanceof ArrayBuffer)
+            return Buffer.from(data);
+        return data;
+    }
+    _wrapListener(event, listener) {
+        switch (event) {
+            case 'message':
+                return (data, isBinary) => {
+                    listener(NodeWebSocket._normalizeMessageData(data, isBinary), isBinary);
+                };
+            case 'close':
+                return (code, reason) => {
+                    listener(code, reason.toString());
+                };
+            // 'open' and 'error' pass through unchanged
+            default:
+                return listener;
+        }
+    }
+}
+//# sourceMappingURL=ws-adapter-node.mjs.map

package/internal/ws-adapter-node.mjs.map

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

package/internal/ws-adapter.d.mts

@@ -0,0 +1,24 @@
+/**
+ * Normalized WebSocket interface that abstracts over the `ws` package (Node.js)
+ * and the native WebSocket API (browser).
+ */
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string | ArrayBufferLike | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    on(event: 'open', listener: () => void): void;
+    on(event: 'message', listener: (data: string | ArrayBuffer | ArrayBufferView, isBinary: boolean) => void): void;
+    on(event: 'close', listener: (code: number, reason: string) => void): void;
+    on(event: 'error', listener: (err: Error) => void): void;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+    once(event: string, listener: (...args: any[]) => void): void;
+}
+/** Standard WebSocket readyState values (RFC 6455). */
+export declare const ReadyState: {
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
+};
+//# sourceMappingURL=ws-adapter.d.mts.map

package/internal/ws-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-adapter.d.mts","sourceRoot":"","sources":["../src/internal/ws-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC9C,EAAE,CACA,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,GAClF,IAAI,CAAC;IACR,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAE5D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED,uDAAuD;AACvD,eAAO,MAAM,UAAU;;;;;CAKb,CAAC"}

package/internal/ws-adapter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Normalized WebSocket interface that abstracts over the `ws` package (Node.js)
+ * and the native WebSocket API (browser).
+ */
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string | ArrayBufferLike | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    on(event: 'open', listener: () => void): void;
+    on(event: 'message', listener: (data: string | ArrayBuffer | ArrayBufferView, isBinary: boolean) => void): void;
+    on(event: 'close', listener: (code: number, reason: string) => void): void;
+    on(event: 'error', listener: (err: Error) => void): void;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+    once(event: string, listener: (...args: any[]) => void): void;
+}
+/** Standard WebSocket readyState values (RFC 6455). */
+export declare const ReadyState: {
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
+};
+//# sourceMappingURL=ws-adapter.d.ts.map

package/internal/ws-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-adapter.d.ts","sourceRoot":"","sources":["../src/internal/ws-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC9C,EAAE,CACA,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,GAClF,IAAI,CAAC;IACR,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAE5D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED,uDAAuD;AACvD,eAAO,MAAM,UAAU;;;;;CAKb,CAAC"}

package/internal/ws-adapter.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadyState = void 0;
+/** Standard WebSocket readyState values (RFC 6455). */
+exports.ReadyState = {
+    CONNECTING: 0,
+    OPEN: 1,
+    CLOSING: 2,
+    CLOSED: 3,
+};
+//# sourceMappingURL=ws-adapter.js.map

package/internal/ws-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-adapter.js","sourceRoot":"","sources":["../src/internal/ws-adapter.ts"],"names":[],"mappings":";;;AAuBA,uDAAuD;AAC1C,QAAA,UAAU,GAAG;IACxB,UAAU,EAAE,CAAC;IACb,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;CACD,CAAC"}

package/internal/ws-adapter.mjs

@@ -0,0 +1,8 @@
+/** Standard WebSocket readyState values (RFC 6455). */
+export const ReadyState = {
+    CONNECTING: 0,
+    OPEN: 1,
+    CLOSING: 2,
+    CLOSED: 3,
+};
+//# sourceMappingURL=ws-adapter.mjs.map

package/internal/ws-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-adapter.mjs","sourceRoot":"","sources":["../src/internal/ws-adapter.ts"],"names":[],"mappings":"AAuBA,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU,EAAE,CAAC;IACb,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;CACD,CAAC"}

package/internal/ws.d.mts

@@ -0,0 +1,80 @@
+/** Reconnection event passed to the `onReconnecting` handler and event listeners. */
+export interface ReconnectingEvent<Parameters = Record<string, unknown>> {
+    /** Which retry attempt this is (1-based). */
+    readonly attempt: number;
+    /** Total attempts that will be made. */
+    readonly maxAttempts: number;
+    /** Delay in ms before this attempt connects. */
+    readonly delay: number;
+    /** The WebSocket close code that triggered reconnection. */
+    readonly closeCode: number;
+    /** The current query parameters. */
+    readonly parameters: (Parameters & Record<string, unknown>) | undefined;
+}
+/**
+ * Optional overrides returned from the `onReconnecting` handler
+ * to customize the next reconnection attempt.
+ */
+export type ReconnectingOverrides<Parameters = Record<string, unknown>> = {
+    /**
+     * If provided, assigns the query parameters for the next connection.
+     * Set to `undefined` to clear all query parameters.
+     */
+    parameters?: (Parameters & Record<string, unknown>) | undefined;
+} | {
+    /**
+     * If set, will stop attempting to reconnect.
+     */
+    abort: true;
+};
+/**
+ * Raw data types that can be sent over a WebSocket without serialization.
+ */
+export type RawWebSocketData = string | ArrayBufferLike | ArrayBufferView | ArrayBufferView[];
+export type UnsentMessage<T> = {
+    type: 'message';
+    message: T;
+} | {
+    type: 'raw';
+    data: RawWebSocketData;
+};
+/**
+ * Flatten `ArrayBufferView[]` fragments into a single `Uint8Array` so that
+ * `ws.send()` transmits the correct bytes.
+ */
+export declare function flattenRawData(data: RawWebSocketData): Exclude<RawWebSocketData, ArrayBufferView[]>;
+/**
+ * A bounded queue for outgoing WebSocket messages. JSON messages are
+ * serialized on enqueue; raw messages are stored as-is. The queue enforces
+ * a configurable byte-size limit and can return the original messages via
+ * {@link drain} when the connection permanently closes.
+ */
+export declare class SendQueue<T = unknown> {
+    private _queue;
+    private _bytes;
+    private _maxBytes;
+    constructor(maxBytes?: number);
+    /**
+     * Serialize and enqueue a JSON message. Returns `true` if the message was
+     * accepted, `false` if it would exceed the byte-size limit.
+     */
+    enqueue(event: T): boolean;
+    /**
+     * Enqueue raw data without serialization. Returns `true` if the data was
+     * accepted, `false` if it would exceed the byte-size limit.
+     */
+    enqueueRaw(data: RawWebSocketData): boolean;
+    /**
+     * Send every queued message via `send`. If `send` throws, the failing
+     * message and all subsequent messages are re-queued and the error is
+     * re-thrown so the caller can report it.
+     */
+    flush(send: (data: RawWebSocketData) => void): void;
+    /**
+     * Drain the queue and return the unsent messages. JSON messages are
+     * deserialized back to their original form. Resets byte tracking to zero.
+     */
+    drain(): UnsentMessage<T>[];
+}
+export declare function isRecoverableClose(code: number): boolean;
+//# sourceMappingURL=ws.d.mts.map

package/internal/ws.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.mts","sourceRoot":"","sources":["../src/internal/ws.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjE,GACD;IACE;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;AAE9F,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAWzG;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAGnG;AAoBD;;;;;GAKG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,GAAE,MAAkB;IAIxC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAW1B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAW3C;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAenD;;;OAGG;IACH,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;CAS5B;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiCxD"}

package/internal/ws.d.ts

@@ -0,0 +1,80 @@
+/** Reconnection event passed to the `onReconnecting` handler and event listeners. */
+export interface ReconnectingEvent<Parameters = Record<string, unknown>> {
+    /** Which retry attempt this is (1-based). */
+    readonly attempt: number;
+    /** Total attempts that will be made. */
+    readonly maxAttempts: number;
+    /** Delay in ms before this attempt connects. */
+    readonly delay: number;
+    /** The WebSocket close code that triggered reconnection. */
+    readonly closeCode: number;
+    /** The current query parameters. */
+    readonly parameters: (Parameters & Record<string, unknown>) | undefined;
+}
+/**
+ * Optional overrides returned from the `onReconnecting` handler
+ * to customize the next reconnection attempt.
+ */
+export type ReconnectingOverrides<Parameters = Record<string, unknown>> = {
+    /**
+     * If provided, assigns the query parameters for the next connection.
+     * Set to `undefined` to clear all query parameters.
+     */
+    parameters?: (Parameters & Record<string, unknown>) | undefined;
+} | {
+    /**
+     * If set, will stop attempting to reconnect.
+     */
+    abort: true;
+};
+/**
+ * Raw data types that can be sent over a WebSocket without serialization.
+ */
+export type RawWebSocketData = string | ArrayBufferLike | ArrayBufferView | ArrayBufferView[];
+export type UnsentMessage<T> = {
+    type: 'message';
+    message: T;
+} | {
+    type: 'raw';
+    data: RawWebSocketData;
+};
+/**
+ * Flatten `ArrayBufferView[]` fragments into a single `Uint8Array` so that
+ * `ws.send()` transmits the correct bytes.
+ */
+export declare function flattenRawData(data: RawWebSocketData): Exclude<RawWebSocketData, ArrayBufferView[]>;
+/**
+ * A bounded queue for outgoing WebSocket messages. JSON messages are
+ * serialized on enqueue; raw messages are stored as-is. The queue enforces
+ * a configurable byte-size limit and can return the original messages via
+ * {@link drain} when the connection permanently closes.
+ */
+export declare class SendQueue<T = unknown> {
+    private _queue;
+    private _bytes;
+    private _maxBytes;
+    constructor(maxBytes?: number);
+    /**
+     * Serialize and enqueue a JSON message. Returns `true` if the message was
+     * accepted, `false` if it would exceed the byte-size limit.
+     */
+    enqueue(event: T): boolean;
+    /**
+     * Enqueue raw data without serialization. Returns `true` if the data was
+     * accepted, `false` if it would exceed the byte-size limit.
+     */
+    enqueueRaw(data: RawWebSocketData): boolean;
+    /**
+     * Send every queued message via `send`. If `send` throws, the failing
+     * message and all subsequent messages are re-queued and the error is
+     * re-thrown so the caller can report it.
+     */
+    flush(send: (data: RawWebSocketData) => void): void;
+    /**
+     * Drain the queue and return the unsent messages. JSON messages are
+     * deserialized back to their original form. Resets byte tracking to zero.
+     */
+    drain(): UnsentMessage<T>[];
+}
+export declare function isRecoverableClose(code: number): boolean;
+//# sourceMappingURL=ws.d.ts.map

package/internal/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/internal/ws.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjE,GACD;IACE;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;AAE9F,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAWzG;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAGnG;AAoBD;;;;;GAKG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,GAAE,MAAkB;IAIxC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;IAW1B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAW3C;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAenD;;;OAGG;IACH,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;CAS5B;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiCxD"}