openai 6.34.0 → 6.35.0

package/resources/responses/ws.js

@@ -4,181 +4,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResponsesWS = void 0;
 const tslib_1 = require("../../internal/tslib.js");
 const WS = tslib_1.__importStar(require("ws"));
-const internal_base_1 = require("./internal-base.js");
-class ResponsesWS extends internal_base_1.ResponsesEmitter {
+const ws_adapter_node_1 = require("../../internal/ws-adapter-node.js");
+const ws_base_1 = require("./ws-base.js");
+class ResponsesWS extends ws_base_1.ResponsesWSBase {
     constructor(client, options) {
-        super();
-        this.client = client;
-        this.url = (0, internal_base_1.buildURL)(client, {});
-        this.socket = new WS.WebSocket(this.url, {
-            ...options,
-            headers: {
-                ...this.authHeaders(),
-                ...options?.headers,
-            },
-        });
-        this.socket.on('message', (wsEvent) => {
-            const event = (() => {
-                try {
-                    return JSON.parse(wsEvent.toString());
-                }
-                catch (err) {
-                    this._onError(null, 'could not parse websocket event', err);
-                    return null;
-                }
-            })();
-            if (event) {
-                this._emit('event', event);
-                if (event.type === 'error') {
-                    this._onError(event);
-                }
-                else {
-                    // @ts-ignore TS isn't smart enough to get the relationship right here
-                    this._emit(event.type, event);
-                }
-            }
-        });
-        this.socket.on('error', (err) => {
-            this._onError(null, err.message, err);
-        });
-    }
-    send(event) {
-        try {
-            this.socket.send(JSON.stringify(event));
-        }
-        catch (err) {
-            this._onError(null, 'could not send data', err);
+        if (!WS?.WebSocket) {
+            throw new Error('ResponsesWS from "openai/resources/responses/ws" requires the "ws" package but it could not be loaded.');
         }
+        const { reconnect, maxQueueSize, ...wsOptions } = options ?? {};
+        super(client, { reconnect, maxQueueSize });
+        this._wsOptions = wsOptions;
+        this._connectInitial();
     }
-    close(props) {
-        try {
-            this.socket.close(props?.code ?? 1000, props?.reason ?? 'OK');
-        }
-        catch (err) {
-            this._onError(null, 'could not close the connection', err);
-        }
-    }
-    /**
-     * Returns an async iterator over WebSocket lifecycle and message events,
-     * providing an alternative to the event-based `.on()` API.
-     * The iterator will exit if the socket closes but breaking out of the iterator
-     * does not close the socket.
-     *
-     * @example
-     * ```ts
-     * for await (const event of connection.stream()) {
-     *   switch (event.type) {
-     *     case 'message':
-     *       console.log('received:', event.message);
-     *       break;
-     *     case 'error':
-     *       console.error(event.error);
-     *       break;
-     *     case 'close':
-     *       console.log('connection closed');
-     *       break;
-     *   }
-     * }
-     * ```
-     */
-    stream() {
-        return this[Symbol.asyncIterator]();
-    }
-    [Symbol.asyncIterator]() {
-        // Two-queue async iterator: `queue` buffers incoming messages,
-        // `resolvers` buffers waiting next() calls. A push wakes the
-        // oldest next(); a next() drains the oldest message.
-        const queue = [];
-        const resolvers = [];
-        let done = false;
-        const push = (msg) => {
-            queue.push(msg);
-            resolvers.shift()?.();
-        };
-        const onEvent = (event) => {
-            if (event.type === 'error')
-                return; // handled by onEmitterError
-            push({ type: 'message', message: event });
-        };
-        // Catches both API-level and socket-level errors via _onError → _emit('error')
-        const onEmitterError = (err) => {
-            push({ type: 'error', error: err });
-        };
-        const onOpen = () => {
-            push({ type: 'open' });
-        };
-        const flushResolvers = () => {
-            for (let resolver = resolvers.shift(); resolver; resolver = resolvers.shift()) {
-                resolver();
-            }
-        };
-        const onClose = () => {
-            push({ type: 'close' });
-            done = true;
-            flushResolvers();
-            cleanup();
-        };
-        const cleanup = () => {
-            this.off('event', onEvent);
-            this.off('error', onEmitterError);
-            this.socket.off('open', onOpen);
-            this.socket.off('close', onClose);
-        };
-        this.on('event', onEvent);
-        this.on('error', onEmitterError);
-        this.socket.on('open', onOpen);
-        this.socket.on('close', onClose);
-        switch (this.socket.readyState) {
-            case WS.WebSocket.CONNECTING:
-                push({ type: 'connecting' });
-                break;
-            case WS.WebSocket.OPEN:
-                push({ type: 'open' });
-                break;
-            case WS.WebSocket.CLOSING:
-                push({ type: 'closing' });
-                break;
-            case WS.WebSocket.CLOSED:
-                push({ type: 'close' });
-                done = true;
-                cleanup();
-                break;
-        }
-        const resolve = (res) => {
-            if (queue.length > 0) {
-                res({ value: queue.shift(), done: false });
-            }
-            else if (done) {
-                res({ value: undefined, done: true });
-            }
-            else {
-                return false;
-            }
-            return true;
-        };
-        const next = () => new Promise((res) => {
-            if (resolve(res))
-                return;
-            resolvers.push(() => {
-                resolve(res);
-            });
-        });
-        return {
-            next,
-            return: () => {
-                done = true;
-                cleanup();
-                flushResolvers();
-                return Promise.resolve({ value: undefined, done: true });
-            },
-            [Symbol.asyncIterator]() {
-                return this;
+    _createSocket(url, authHeaders) {
+        const ws = new WS.WebSocket(url, {
+            ...this._wsOptions,
+            headers: {
+                ...authHeaders,
+                ...this._wsOptions?.headers,
             },
-        };
-    }
-    authHeaders() {
-        return { Authorization: `Bearer ${this.client.apiKey}` };
-        return {};
+        });
+        return new ws_adapter_node_1.NodeWebSocket(ws);
     }
 }
 exports.ResponsesWS = ResponsesWS;

package/resources/responses/ws.js.map

@@ -1 +1 @@
-{"version":3,"file":"ws.js","sourceRoot":"","sources":["../../src/resources/responses/ws.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,+CAAyB;AACzB,sDAAqG;AAIrG,MAAa,WAAY,SAAQ,gCAAgB;IAK/C,YAAY,MAAc,EAAE,OAA6C;QACvE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,IAAA,wBAAQ,EAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;YACvC,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,WAAW,EAAE;gBACrB,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAsC,CAAC;gBAC7E,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,iCAAiC,EAAE,GAAG,CAAC,CAAC;oBAC5D,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YAEL,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAE3B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC3B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,sEAAsE;oBACtE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,KAAwC;QAC3C,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAwC;QAC5C,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,gCAAgC,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,+DAA+D;QAC/D,6DAA6D;QAC7D,qDAAqD;QACrD,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,IAAI,IAAI,GAAG,KAAK,CAAC;QAEjB,MAAM,IAAI,GAAG,CAAC,GAA2B,EAAE,EAAE;YAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,CAAC,KAAwC,EAAE,EAAE;YAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,CAAC,4BAA4B;YAChE,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,+EAA+E;QAC/E,MAAM,cAAc,GAAG,CAAC,GAAmB,EAAE,EAAE;YAC7C,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,cAAc,GAAG,GAAG,EAAE;YAC1B,KAAK,IAAI,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC9E,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACxB,IAAI,GAAG,IAAI,CAAC;YACZ,cAAc,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEjC,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC/B,KAAK,EAAE,CAAC,SAAS,CAAC,UAAU;gBAC1B,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI;gBACpB,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,EAAE,CAAC,SAAS,CAAC,OAAO;gBACvB,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,EAAE,CAAC,SAAS,CAAC,MAAM;gBACtB,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBACxB,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,EAAE,CAAC;gBACV,MAAM;QACV,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,GAA4D,EAAE,EAAE;YAC/E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,IAAI,EAAE,CAAC;gBAChB,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,MAAM,IAAI,GAAG,GAAoD,EAAE,CACjE,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAClB,IAAI,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO;YACzB,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;gBAClB,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEL,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,GAA6C,EAAE;gBACrD,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,EAAE,CAAC;gBACV,cAAc,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,CAAC,MAAM,CAAC,aAAa,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,WAAW;QACjB,OAAO,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACzD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAjMD,kCAiMC"}
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../../src/resources/responses/ws.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,+CAAyB;AACzB,uEAA+D;AAC/D,0CAAyE;AAOzE,MAAa,WAAY,SAAQ,yBAA8B;IAG7D,YAAY,MAAc,EAAE,OAAqD;QAC/E,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAChE,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAES,aAAa,CAAC,GAAQ,EAAE,WAAmC;QACnE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YAC/B,GAAG,IAAI,CAAC,UAAU;YAClB,OAAO,EAAE;gBACP,GAAG,WAAW;gBACd,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO;aAC5B;SACF,CAAC,CAAC;QACH,OAAO,IAAI,+BAAa,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;CACF;AA1BD,kCA0BC"}

package/resources/responses/ws.mjs

@@ -1,180 +1,26 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import * as WS from 'ws';
-import { ResponsesEmitter, buildURL } from "./internal-base.mjs";
-export class ResponsesWS extends ResponsesEmitter {
+import { NodeWebSocket } from "../../internal/ws-adapter-node.mjs";
+import { ResponsesWSBase } from "./ws-base.mjs";
+export class ResponsesWS extends ResponsesWSBase {
     constructor(client, options) {
-        super();
-        this.client = client;
-        this.url = buildURL(client, {});
-        this.socket = new WS.WebSocket(this.url, {
-            ...options,
-            headers: {
-                ...this.authHeaders(),
-                ...options?.headers,
-            },
-        });
-        this.socket.on('message', (wsEvent) => {
-            const event = (() => {
-                try {
-                    return JSON.parse(wsEvent.toString());
-                }
-                catch (err) {
-                    this._onError(null, 'could not parse websocket event', err);
-                    return null;
-                }
-            })();
-            if (event) {
-                this._emit('event', event);
-                if (event.type === 'error') {
-                    this._onError(event);
-                }
-                else {
-                    // @ts-ignore TS isn't smart enough to get the relationship right here
-                    this._emit(event.type, event);
-                }
-            }
-        });
-        this.socket.on('error', (err) => {
-            this._onError(null, err.message, err);
-        });
-    }
-    send(event) {
-        try {
-            this.socket.send(JSON.stringify(event));
-        }
-        catch (err) {
-            this._onError(null, 'could not send data', err);
+        if (!WS?.WebSocket) {
+            throw new Error('ResponsesWS from "openai/resources/responses/ws" requires the "ws" package but it could not be loaded.');
         }
+        const { reconnect, maxQueueSize, ...wsOptions } = options ?? {};
+        super(client, { reconnect, maxQueueSize });
+        this._wsOptions = wsOptions;
+        this._connectInitial();
     }
-    close(props) {
-        try {
-            this.socket.close(props?.code ?? 1000, props?.reason ?? 'OK');
-        }
-        catch (err) {
-            this._onError(null, 'could not close the connection', err);
-        }
-    }
-    /**
-     * Returns an async iterator over WebSocket lifecycle and message events,
-     * providing an alternative to the event-based `.on()` API.
-     * The iterator will exit if the socket closes but breaking out of the iterator
-     * does not close the socket.
-     *
-     * @example
-     * ```ts
-     * for await (const event of connection.stream()) {
-     *   switch (event.type) {
-     *     case 'message':
-     *       console.log('received:', event.message);
-     *       break;
-     *     case 'error':
-     *       console.error(event.error);
-     *       break;
-     *     case 'close':
-     *       console.log('connection closed');
-     *       break;
-     *   }
-     * }
-     * ```
-     */
-    stream() {
-        return this[Symbol.asyncIterator]();
-    }
-    [Symbol.asyncIterator]() {
-        // Two-queue async iterator: `queue` buffers incoming messages,
-        // `resolvers` buffers waiting next() calls. A push wakes the
-        // oldest next(); a next() drains the oldest message.
-        const queue = [];
-        const resolvers = [];
-        let done = false;
-        const push = (msg) => {
-            queue.push(msg);
-            resolvers.shift()?.();
-        };
-        const onEvent = (event) => {
-            if (event.type === 'error')
-                return; // handled by onEmitterError
-            push({ type: 'message', message: event });
-        };
-        // Catches both API-level and socket-level errors via _onError → _emit('error')
-        const onEmitterError = (err) => {
-            push({ type: 'error', error: err });
-        };
-        const onOpen = () => {
-            push({ type: 'open' });
-        };
-        const flushResolvers = () => {
-            for (let resolver = resolvers.shift(); resolver; resolver = resolvers.shift()) {
-                resolver();
-            }
-        };
-        const onClose = () => {
-            push({ type: 'close' });
-            done = true;
-            flushResolvers();
-            cleanup();
-        };
-        const cleanup = () => {
-            this.off('event', onEvent);
-            this.off('error', onEmitterError);
-            this.socket.off('open', onOpen);
-            this.socket.off('close', onClose);
-        };
-        this.on('event', onEvent);
-        this.on('error', onEmitterError);
-        this.socket.on('open', onOpen);
-        this.socket.on('close', onClose);
-        switch (this.socket.readyState) {
-            case WS.WebSocket.CONNECTING:
-                push({ type: 'connecting' });
-                break;
-            case WS.WebSocket.OPEN:
-                push({ type: 'open' });
-                break;
-            case WS.WebSocket.CLOSING:
-                push({ type: 'closing' });
-                break;
-            case WS.WebSocket.CLOSED:
-                push({ type: 'close' });
-                done = true;
-                cleanup();
-                break;
-        }
-        const resolve = (res) => {
-            if (queue.length > 0) {
-                res({ value: queue.shift(), done: false });
-            }
-            else if (done) {
-                res({ value: undefined, done: true });
-            }
-            else {
-                return false;
-            }
-            return true;
-        };
-        const next = () => new Promise((res) => {
-            if (resolve(res))
-                return;
-            resolvers.push(() => {
-                resolve(res);
-            });
-        });
-        return {
-            next,
-            return: () => {
-                done = true;
-                cleanup();
-                flushResolvers();
-                return Promise.resolve({ value: undefined, done: true });
-            },
-            [Symbol.asyncIterator]() {
-                return this;
+    _createSocket(url, authHeaders) {
+        const ws = new WS.WebSocket(url, {
+            ...this._wsOptions,
+            headers: {
+                ...authHeaders,
+                ...this._wsOptions?.headers,
             },
-        };
-    }
-    authHeaders() {
-        return { Authorization: `Bearer ${this.client.apiKey}` };
-        return {};
+        });
+        return new NodeWebSocket(ws);
     }
 }
 //# sourceMappingURL=ws.mjs.map

package/resources/responses/ws.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ws.mjs","sourceRoot":"","sources":["../../src/resources/responses/ws.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ws.mjs","sourceRoot":"","sources":["../../src/resources/responses/ws.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,KAAK,EAAE,MAAM,IAAI;OACjB,EAAE,aAAa,EAAE;OACjB,EAAE,eAAe,EAA+B;AAOvD,MAAM,OAAO,WAAY,SAAQ,eAA8B;IAG7D,YAAY,MAAc,EAAE,OAAqD;QAC/E,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAChE,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAES,aAAa,CAAC,GAAQ,EAAE,WAAmC;QACnE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YAC/B,GAAG,IAAI,CAAC,UAAU;YAClB,OAAO,EAAE;gBACP,GAAG,WAAW;gBACd,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO;aAC5B;SACF,CAAC,CAAC;QACH,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/src/core/EventEmitter.ts

@@ -96,3 +96,19 @@ export class EventEmitter<EventTypes extends Record<string, (...args: any) => an
     return listeners && listeners.length > 0;
   }
 }
+
+/**
+ * An EventEmitter variant that exposes `_emit()` publicly.
+ *
+ * The base {@link EventEmitter} keeps `_emit` protected so that consumers
+ * can only listen, not dispatch. When you need a separate emitter instance
+ * that your own code can emit on, without exposing emit on the
+ * consumer-facing emitter, use this class.
+ */
+export class InternalEventEmitter<
+  EventTypes extends Record<string, (...args: any) => any>,
+> extends EventEmitter<EventTypes> {
+  override _emit<Event extends keyof EventTypes>(event: Event, ...args: EventParameters<EventTypes, Event>) {
+    super._emit(event, ...args);
+  }
+}

package/src/internal/types.ts

@@ -40,7 +40,6 @@ type OverloadedParameters<T> =
   : T extends (...args: infer A) => unknown ? A
   : never;
 
-/* eslint-disable */
 /**
  * These imports attempt to get types from a parent package's dependencies.
  * Unresolved bare specifiers can trigger [automatic type acquisition][1] in some projects, which
@@ -63,19 +62,18 @@ type OverloadedParameters<T> =
  *
  * [1]: https://www.typescriptlang.org/tsconfig/#typeAcquisition
  */
-/** @ts-ignore For users with \@types/node */
+/** @ts-ignore For users with \@types/node */ /* prettier-ignore */
 type UndiciTypesRequestInit = NotAny<import('../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit>;
-/** @ts-ignore For users with undici */
+/** @ts-ignore For users with undici */ /* prettier-ignore */
 type UndiciRequestInit = NotAny<import('../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici/index.d.ts').RequestInit>;
-/** @ts-ignore For users with \@types/bun */
+/** @ts-ignore For users with \@types/bun */ /* prettier-ignore */
 type BunRequestInit = globalThis.FetchRequestInit;
-/** @ts-ignore For users with node-fetch@2 */
+/** @ts-ignore For users with node-fetch@2 */ /* prettier-ignore */
 type NodeFetch2RequestInit = NotAny<import('../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit>;
-/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */
+/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */ /* prettier-ignore */
 type NodeFetch3RequestInit =  NotAny<import('../node_modules/node-fetch').RequestInit> | NotAny<import('../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/node-fetch').RequestInit>;
-/** @ts-ignore For users who use Deno */
+/** @ts-ignore For users who use Deno */ /* prettier-ignore */
 type FetchRequestInit = NonNullable<OverloadedParameters<typeof fetch>[1]>;
-/* eslint-enable */
 
 type RequestInits =
   | NotAny<UndiciTypesRequestInit>

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/internal/ws-adapter-browser.ts

@@ -0,0 +1,123 @@
+import type { WebSocketLike } from './ws-adapter';
+
+/** A generic event listener callback. */
+type Listener = (...args: any[]) => void;
+
+/** A DOM-style event handler passed to addEventListener/removeEventListener. */
+type DOMEventHandler = (ev: any) => void;
+
+// Minimal browser API type declarations.
+declare class WebSocket {
+  readonly readyState: number;
+  binaryType: string;
+  send(data: string | ArrayBufferLike | ArrayBufferView): void;
+  close(code?: number, reason?: string): void;
+  addEventListener(type: string, listener: DOMEventHandler): void;
+  removeEventListener(type: string, listener: DOMEventHandler): void;
+}
+
+interface MessageEvent {
+  data: any;
+}
+
+interface CloseEvent {
+  code: number;
+  reason: string;
+}
+
+export class BrowserWebSocket implements WebSocketLike {
+  private _ws: WebSocket;
+  private _listenerMap = new Map<string, Map<Listener, DOMEventHandler>>();
+
+  constructor(ws: WebSocket) {
+    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(): WebSocket {
+    return this._ws;
+  }
+
+  get readyState(): number {
+    return this._ws.readyState;
+  }
+
+  send(data: string | ArrayBufferLike | ArrayBufferView): void {
+    this._ws.send(data);
+  }
+
+  close(code?: number, reason?: string): void {
+    this._ws.close(code, reason);
+  }
+
+  on(event: string, listener: Listener): void {
+    const wrapped = this._wrapListener(event, listener);
+    this._listenersFor(event).set(listener, wrapped);
+    this._ws.addEventListener(event, wrapped);
+  }
+
+  off(event: string, listener: Listener): void {
+    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: string, listener: Listener): void {
+    const onceListener: Listener = (...args) => {
+      this.off(event, listener);
+      listener(...args);
+    };
+    const wrapped = this._wrapListener(event, onceListener);
+    this._listenersFor(event).set(listener, wrapped);
+    this._ws.addEventListener(event, wrapped);
+  }
+
+  private _listenersFor(event: string): Map<Listener, DOMEventHandler> {
+    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.
+   */
+  private _wrapListener(event: string, listener: Listener): DOMEventHandler {
+    switch (event) {
+      case 'message':
+        return (ev: MessageEvent) => {
+          const isBinary = typeof ev.data !== 'string';
+          listener(ev.data, isBinary);
+        };
+
+      case 'close':
+        return (ev: CloseEvent) => {
+          listener(ev.code, ev.reason);
+        };
+
+      case 'error':
+        return (ev: any) => {
+          // 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 as any).cause = ev.error;
+          }
+          listener(err);
+        };
+
+      case 'open':
+      default:
+        return listener as DOMEventHandler;
+    }
+  }
+}