openai 7.15.0 → 7.17.0

package/resources/live/internal-base.js

@@ -8,13 +8,19 @@ const error_1 = require("../../core/error.js");
 class WebSocketError extends error_1.OpenAIError {
     constructor(message, event) {
         super(message);
-        this.error = event ?? undefined;
+        Object.defineProperty(this, 'error', {
+            value: event ?? undefined,
+            writable: true,
+            configurable: true,
+            enumerable: false,
+        });
     }
 }
 exports.WebSocketError = WebSocketError;
 class LiveEmitter extends EventEmitter_1.EventEmitter {
     _onError(event, message, cause) {
-        message = message ?? safeJSONStringify(event) ?? 'unknown error';
+        const safeMessage = safeWebSocketErrorMessage(event, message);
+        message = safeMessage ?? 'unknown error';
         if (!this._hasListener('error')) {
             const error = new WebSocketError(message +
                 `\n\nTo resolve these unhandled rejection errors you should bind an \`error\` callback, e.g. \`ws.on('error', (error) => ...)\` `, event);
@@ -37,12 +43,22 @@ function buildURL(client, parameters) {
     url.protocol = url.protocol === 'http:' || url.protocol === 'ws:' ? 'ws:' : 'wss:';
     return url;
 }
-function safeJSONStringify(value) {
+function safeWebSocketErrorMessage(event, message) {
+    if (typeof message === 'string')
+        return message;
+    if (typeof event !== 'object' || event === null)
+        return undefined;
     try {
-        return JSON.stringify(value);
+        const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+        const nestedMessage = typeof error === 'object' && error !== null
+            ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+            : undefined;
+        const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+        const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+        return typeof candidate === 'string' ? candidate : undefined;
     }
     catch {
-        return null;
+        return undefined;
     }
 }
 //# sourceMappingURL=internal-base.js.map

package/resources/live/internal-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-base.js","sourceRoot":"","sources":["../../src/resources/live/internal-base.ts"],"names":[],"mappings":";AAAA,qFAAqF;;;AAyFrF,4BAMC;AA3FD,6DAAuD;AACvD,+CAA+C;AAa/C,MAAa,cAAe,SAAQ,mBAAW;IAM7C,YAAY,OAAe,EAAE,KAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,SAAS,CAAC;IAClC,CAAC;CACF;AAXD,wCAWC;AAmBD,MAAsB,WAAY,SAAQ,2BAA6B;IAkB3D,QAAQ,CAAC,KAAgC,EAAE,OAA4B,EAAE,KAAW;QAC5F,OAAO,GAAG,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC;QAEjE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,cAAc,CAC9B,OAAO;gBACL,iIAAiI,EACnI,KAAK,CACN,CAAC;YACF,aAAa;YACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,aAAa;QACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF;AAvCD,kCAuCC;AAED,SAAgB,QAAQ,CAAC,MAAc,EAAE,UAAmC;IAC1E,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC;IAChC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"internal-base.js","sourceRoot":"","sources":["../../src/resources/live/internal-base.ts"],"names":[],"mappings":";AAAA,qFAAqF;;;AAkGrF,4BAMC;AApGD,6DAAuD;AACvD,+CAA+C;AAa/C,MAAa,cAAe,SAAQ,mBAAW;IAS7C,YAAY,OAAe,EAAE,KAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;YACnC,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;CACF;AAnBD,wCAmBC;AAmBD,MAAsB,WAAY,SAAQ,2BAA6B;IAkB3D,QAAQ,CAAC,KAAgC,EAAE,OAA4B,EAAE,KAAW;QAC5F,MAAM,WAAW,GAAG,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,GAAG,WAAW,IAAI,eAAe,CAAC;QAEzC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,cAAc,CAC9B,OAAO;gBACL,iIAAiI,EACnI,KAAK,CACN,CAAC;YACF,aAAa;YACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,aAAa;QACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF;AAxCD,kCAwCC;AAED,SAAgB,QAAQ,CAAC,MAAc,EAAE,UAAmC;IAC1E,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC;IAChC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc,EAAE,OAAgB;IACjE,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC;QACrE,MAAM,aAAa,GACjB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YACzC,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK;YAC1D,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,YAAY,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC;QAC9E,MAAM,SAAS,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;QACnF,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/resources/live/internal-base.mjs

@@ -4,12 +4,18 @@ import { OpenAIError } from "../../core/error.mjs";
 export class WebSocketError extends OpenAIError {
     constructor(message, event) {
         super(message);
-        this.error = event ?? undefined;
+        Object.defineProperty(this, 'error', {
+            value: event ?? undefined,
+            writable: true,
+            configurable: true,
+            enumerable: false,
+        });
     }
 }
 export class LiveEmitter extends EventEmitter {
     _onError(event, message, cause) {
-        message = message ?? safeJSONStringify(event) ?? 'unknown error';
+        const safeMessage = safeWebSocketErrorMessage(event, message);
+        message = safeMessage ?? 'unknown error';
         if (!this._hasListener('error')) {
             const error = new WebSocketError(message +
                 `\n\nTo resolve these unhandled rejection errors you should bind an \`error\` callback, e.g. \`ws.on('error', (error) => ...)\` `, event);
@@ -31,12 +37,22 @@ export function buildURL(client, parameters) {
     url.protocol = url.protocol === 'http:' || url.protocol === 'ws:' ? 'ws:' : 'wss:';
     return url;
 }
-function safeJSONStringify(value) {
+function safeWebSocketErrorMessage(event, message) {
+    if (typeof message === 'string')
+        return message;
+    if (typeof event !== 'object' || event === null)
+        return undefined;
     try {
-        return JSON.stringify(value);
+        const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+        const nestedMessage = typeof error === 'object' && error !== null
+            ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+            : undefined;
+        const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+        const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+        return typeof candidate === 'string' ? candidate : undefined;
     }
     catch {
-        return null;
+        return undefined;
     }
 }
 //# sourceMappingURL=internal-base.mjs.map

package/resources/live/internal-base.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal-base.mjs","sourceRoot":"","sources":["../../src/resources/live/internal-base.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAIrF,OAAO,EAAE,YAAY,EAAE,oCAAgC;AACvD,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAa/C,MAAM,OAAO,cAAe,SAAQ,WAAW;IAM7C,YAAY,OAAe,EAAE,KAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,SAAS,CAAC;IAClC,CAAC;CACF;AAmBD,MAAM,OAAgB,WAAY,SAAQ,YAA6B;IAkB3D,QAAQ,CAAC,KAAgC,EAAE,OAA4B,EAAE,KAAW;QAC5F,OAAO,GAAG,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC;QAEjE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,cAAc,CAC9B,OAAO;gBACL,iIAAiI,EACnI,KAAK,CACN,CAAC;YACF,aAAa;YACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,aAAa;QACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,UAAmC;IAC1E,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC;IAChC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"internal-base.mjs","sourceRoot":"","sources":["../../src/resources/live/internal-base.ts"],"names":[],"mappings":"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"}

package/resources/live/sideband/internal-base.d.mts

@@ -30,6 +30,9 @@ export type SidebandStreamMessage = {
 export declare class WebSocketError extends OpenAIError {
     /**
      * The error data that the API sent back in an error event.
+     *
+     * This property is non-enumerable to avoid exposing the event through
+     * JSON serialization, object spread, or Object.assign.
      */
     error?: LiveAPI.ErrorEvent | undefined;
     constructor(message: string, event: LiveAPI.ErrorEvent | null);

package/resources/live/sideband/internal-base.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-base.d.mts","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"internal-base.d.mts","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,oBAAgB;AACnC,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAE,MAAM,EAAE,4BAAwB;AACzC,OAAO,EAAE,YAAY,EAAE,uCAAmC;AAC1D,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,iCAA6B;AAC/F,OAAO,EAAE,oBAAoB,EAAE,sBAAkB;AAEjD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,CAAA;CAAE,GACxG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC,kBAAkB,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAE7C,qBAAa,cAAe,SAAQ,WAAW;IAC7C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,GAAG,IAAI;CAU9D;AAED,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D,KAAK,eAAe,GAAG,QAAQ,CAC7B;IACE,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,kBAAkB,KAAK,IAAI,CAAC;IACvD,GAAG,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,KAAK,IAAI,CAAC;IACvG,YAAY,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,KAAK,IAAI,CAAC;IACvE,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,GAAG;KACD,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CACpF,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,KACjE,OAAO;CACb,CACF,CAAC;AAEF,8BAAsB,eAAgB,SAAQ,YAAY,CAAC,eAAe,CAAC;IACzE;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,kBAAkB,GAAG,IAAI;IAE1D;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAE9C;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAE9D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAClE,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;CAuBlF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAMjF"}

package/resources/live/sideband/internal-base.d.ts

@@ -30,6 +30,9 @@ export type SidebandStreamMessage = {
 export declare class WebSocketError extends OpenAIError {
     /**
      * The error data that the API sent back in an error event.
+     *
+     * This property is non-enumerable to avoid exposing the event through
+     * JSON serialization, object spread, or Object.assign.
      */
     error?: LiveAPI.ErrorEvent | undefined;
     constructor(message: string, event: LiveAPI.ErrorEvent | null);

package/resources/live/sideband/internal-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-base.d.ts","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"internal-base.d.ts","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":"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"}

package/resources/live/sideband/internal-base.js

@@ -9,13 +9,19 @@ const path_1 = require("../../../internal/utils/path.js");
 class WebSocketError extends error_1.OpenAIError {
     constructor(message, event) {
         super(message);
-        this.error = event ?? undefined;
+        Object.defineProperty(this, 'error', {
+            value: event ?? undefined,
+            writable: true,
+            configurable: true,
+            enumerable: false,
+        });
     }
 }
 exports.WebSocketError = WebSocketError;
 class SidebandEmitter extends EventEmitter_1.EventEmitter {
     _onError(event, message, cause) {
-        message = message ?? safeJSONStringify(event) ?? 'unknown error';
+        const safeMessage = safeWebSocketErrorMessage(event, message);
+        message = safeMessage ?? 'unknown error';
         if (!this._hasListener('error')) {
             const error = new WebSocketError(message +
                 `\n\nTo resolve these unhandled rejection errors you should bind an \`error\` callback, e.g. \`ws.on('error', (error) => ...)\` `, event);
@@ -38,12 +44,22 @@ function buildURL(client, parameters) {
     url.protocol = url.protocol === 'http:' || url.protocol === 'ws:' ? 'ws:' : 'wss:';
     return url;
 }
-function safeJSONStringify(value) {
+function safeWebSocketErrorMessage(event, message) {
+    if (typeof message === 'string')
+        return message;
+    if (typeof event !== 'object' || event === null)
+        return undefined;
     try {
-        return JSON.stringify(value);
+        const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+        const nestedMessage = typeof error === 'object' && error !== null
+            ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+            : undefined;
+        const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+        const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+        return typeof candidate === 'string' ? candidate : undefined;
     }
     catch {
-        return null;
+        return undefined;
     }
 }
 //# sourceMappingURL=internal-base.js.map

package/resources/live/sideband/internal-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-base.js","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":";AAAA,qFAAqF;;;AA4FrF,4BAMC;AA7FD,gEAA0D;AAC1D,kDAAkD;AAClD,0DAAoD;AAcpD,MAAa,cAAe,SAAQ,mBAAW;IAM7C,YAAY,OAAe,EAAE,KAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,SAAS,CAAC;IAClC,CAAC;CACF;AAXD,wCAWC;AAmBD,MAAsB,eAAgB,SAAQ,2BAA6B;IAkB/D,QAAQ,CAAC,KAAgC,EAAE,OAA4B,EAAE,KAAW;QAC5F,OAAO,GAAG,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC;QAEjE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,cAAc,CAC9B,OAAO;gBACL,iIAAiI,EACnI,KAAK,CACN,CAAC;YACF,aAAa;YACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,aAAa;QACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF;AAvCD,0CAuCC;AAED,SAAgB,QAAQ,CAAC,MAAc,EAAE,UAAmC;IAC1E,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAA,kBAAkB,KAAK,SAAS,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"internal-base.js","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":"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"}

package/resources/live/sideband/internal-base.mjs

@@ -5,12 +5,18 @@ import { path } from "../../../internal/utils/path.mjs";
 export class WebSocketError extends OpenAIError {
     constructor(message, event) {
         super(message);
-        this.error = event ?? undefined;
+        Object.defineProperty(this, 'error', {
+            value: event ?? undefined,
+            writable: true,
+            configurable: true,
+            enumerable: false,
+        });
     }
 }
 export class SidebandEmitter extends EventEmitter {
     _onError(event, message, cause) {
-        message = message ?? safeJSONStringify(event) ?? 'unknown error';
+        const safeMessage = safeWebSocketErrorMessage(event, message);
+        message = safeMessage ?? 'unknown error';
         if (!this._hasListener('error')) {
             const error = new WebSocketError(message +
                 `\n\nTo resolve these unhandled rejection errors you should bind an \`error\` callback, e.g. \`ws.on('error', (error) => ...)\` `, event);
@@ -32,12 +38,22 @@ export function buildURL(client, parameters) {
     url.protocol = url.protocol === 'http:' || url.protocol === 'ws:' ? 'ws:' : 'wss:';
     return url;
 }
-function safeJSONStringify(value) {
+function safeWebSocketErrorMessage(event, message) {
+    if (typeof message === 'string')
+        return message;
+    if (typeof event !== 'object' || event === null)
+        return undefined;
     try {
-        return JSON.stringify(value);
+        const error = Object.getOwnPropertyDescriptor(event, 'error')?.value;
+        const nestedMessage = typeof error === 'object' && error !== null
+            ? Object.getOwnPropertyDescriptor(error, 'message')?.value
+            : undefined;
+        const eventMessage = Object.getOwnPropertyDescriptor(event, 'message')?.value;
+        const candidate = typeof nestedMessage === 'string' ? nestedMessage : eventMessage;
+        return typeof candidate === 'string' ? candidate : undefined;
     }
     catch {
-        return null;
+        return undefined;
     }
 }
 //# sourceMappingURL=internal-base.mjs.map

package/resources/live/sideband/internal-base.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal-base.mjs","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAKrF,OAAO,EAAE,YAAY,EAAE,uCAAmC;AAC1D,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAcpD,MAAM,OAAO,cAAe,SAAQ,WAAW;IAM7C,YAAY,OAAe,EAAE,KAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,SAAS,CAAC;IAClC,CAAC;CACF;AAmBD,MAAM,OAAgB,eAAgB,SAAQ,YAA6B;IAkB/D,QAAQ,CAAC,KAAgC,EAAE,OAA4B,EAAE,KAAW;QAC5F,OAAO,GAAG,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC;QAEjE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,cAAc,CAC9B,OAAO;gBACL,iIAAiI,EACnI,KAAK,CACN,CAAC;YACF,aAAa;YACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,aAAa;QACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,UAAmC;IAC1E,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAA,kBAAkB,KAAK,SAAS,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"internal-base.mjs","sourceRoot":"","sources":["../../../src/resources/live/sideband/internal-base.ts"],"names":[],"mappings":"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"}

package/resources/live/sideband/ws-base.d.mts

@@ -1,6 +1,6 @@
 import { SidebandEmitter, SidebandStreamMessage } from "./internal-base.mjs";
 import { type WebSocketLike } from "../../../internal/ws-adapter.mjs";
-import { type RawWebSocketData, type ReconnectingEvent, type ReconnectingOverrides } from "../../../internal/ws.mjs";
+import { type WebSocketStreamOptions, type RawWebSocketData, type ReconnectingEvent, type ReconnectingOverrides } from "../../../internal/ws.mjs";
 import * as SidebandAPI from "./sideband.mjs";
 import { OpenAI } from "../../../client.mjs";
 export interface SidebandWSParameters extends Record<string, unknown> {
@@ -38,11 +38,11 @@ export interface SidebandWSBaseOptions {
      */
     reconnect?: SidebandWSReconnectOptions | null | undefined;
     /**
-     * Maximum size of the outgoing message queue in bytes.
-     * Messages queued while the socket is connecting or reconnecting are held
-     * in memory up to this limit. Once the limit is reached, new messages are
-     * discarded and an `error` event is emitted.
-     * Default: 1 MB
+     * Byte budget for outgoing messages queued while the socket is connecting
+     * or reconnecting. An empty queue accepts one message even if it exceeds
+     * this budget. Further messages are discarded and an `error` event is emitted
+     * if the total queued size would exceed the budget.
+     * Default: 1 MiB (1,048,576 bytes).
      */
     maxQueueSize?: number | undefined;
 }
@@ -77,6 +77,11 @@ export declare abstract class SidebandWSBase<TSocket extends WebSocketLike> exte
      * The iterator will exit if the socket closes but exiting the iterator
      * does not close the socket.
      *
+     * Pass `maxBufferedEvents` to limit queued records for this iterator, including
+     * lifecycle events. Overflow discards its backlog and rejects `next()` with a
+     * WebSocketError; the shared socket and other iterators remain active.
+     * Omitted means unlimited. This is an event-count limit, not a byte limit.
+     *
      * @example
      * ```ts
      * for await (const event of client.stream()) {
@@ -94,8 +99,8 @@ export declare abstract class SidebandWSBase<TSocket extends WebSocketLike> exte
      * }
      * ```
      */
-    stream(): AsyncIterableIterator<SidebandStreamMessage>;
-    [Symbol.asyncIterator](): AsyncIterableIterator<SidebandStreamMessage>;
+    stream(options?: WebSocketStreamOptions): AsyncIterableIterator<SidebandStreamMessage>;
+    [Symbol.asyncIterator](options?: WebSocketStreamOptions): AsyncIterableIterator<SidebandStreamMessage>;
     private _connect;
     private _canReconnect;
     private _reconnect;

package/resources/live/sideband/ws-base.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-base.d.mts","sourceRoot":"","sources":["../../../src/resources/live/sideband/ws-base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAA4B,4BAAwB;AAGnG,OAAO,EAAE,KAAK,aAAa,EAAc,yCAAqC;AAC9E,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE3B,iCAA6B;AAC9B,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAE,MAAM,EAAE,4BAAwB;AAGzC,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,cAAc,CACZ,KAAK,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,GAC7C,qBAAqB,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAEtD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,0BAA0B,GAAG,IAAI,GAAG,SAAS,CAAC;IAE1D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,8BAAsB,cAAc,CAAC,OAAO,SAAS,aAAa,CAAE,SAAQ,eAAe;IACzF,GAAG,EAAG,GAAG,CAAC;IACV,MAAM,EAAG,OAAO,CAAC;IAEjB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/D,OAAO,CAAC,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAc;IAGtC,OAAO,CAAC,eAAe,CAKlB;gBAEO,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,SAAS;IAQzG,oDAAoD;IACpD,SAAS,CAAC,eAAe,IAAI,IAAI;IAKjC,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAExF,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,kBAAkB;IAsB1C,OAAO,CAAC,IAAI,EAAE,gBAAgB;IAsB9B,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAe9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,IAAI,qBAAqB,CAAC,qBAAqB,CAAC;IAItD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,qBAAqB,CAAC;IAwJtE,OAAO,CAAC,QAAQ;IA2DhB,OAAO,CAAC,aAAa;YAQP,UAAU;IA+IxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAMjD"}
+{"version":3,"file":"ws-base.d.mts","sourceRoot":"","sources":["../../../src/resources/live/sideband/ws-base.ts"],"names":[],"mappings":"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"}

package/resources/live/sideband/ws-base.d.ts

@@ -1,6 +1,6 @@
 import { SidebandEmitter, SidebandStreamMessage } from "./internal-base.js";
 import { type WebSocketLike } from "../../../internal/ws-adapter.js";
-import { type RawWebSocketData, type ReconnectingEvent, type ReconnectingOverrides } from "../../../internal/ws.js";
+import { type WebSocketStreamOptions, type RawWebSocketData, type ReconnectingEvent, type ReconnectingOverrides } from "../../../internal/ws.js";
 import * as SidebandAPI from "./sideband.js";
 import { OpenAI } from "../../../client.js";
 export interface SidebandWSParameters extends Record<string, unknown> {
@@ -38,11 +38,11 @@ export interface SidebandWSBaseOptions {
      */
     reconnect?: SidebandWSReconnectOptions | null | undefined;
     /**
-     * Maximum size of the outgoing message queue in bytes.
-     * Messages queued while the socket is connecting or reconnecting are held
-     * in memory up to this limit. Once the limit is reached, new messages are
-     * discarded and an `error` event is emitted.
-     * Default: 1 MB
+     * Byte budget for outgoing messages queued while the socket is connecting
+     * or reconnecting. An empty queue accepts one message even if it exceeds
+     * this budget. Further messages are discarded and an `error` event is emitted
+     * if the total queued size would exceed the budget.
+     * Default: 1 MiB (1,048,576 bytes).
      */
     maxQueueSize?: number | undefined;
 }
@@ -77,6 +77,11 @@ export declare abstract class SidebandWSBase<TSocket extends WebSocketLike> exte
      * The iterator will exit if the socket closes but exiting the iterator
      * does not close the socket.
      *
+     * Pass `maxBufferedEvents` to limit queued records for this iterator, including
+     * lifecycle events. Overflow discards its backlog and rejects `next()` with a
+     * WebSocketError; the shared socket and other iterators remain active.
+     * Omitted means unlimited. This is an event-count limit, not a byte limit.
+     *
      * @example
      * ```ts
      * for await (const event of client.stream()) {
@@ -94,8 +99,8 @@ export declare abstract class SidebandWSBase<TSocket extends WebSocketLike> exte
      * }
      * ```
      */
-    stream(): AsyncIterableIterator<SidebandStreamMessage>;
-    [Symbol.asyncIterator](): AsyncIterableIterator<SidebandStreamMessage>;
+    stream(options?: WebSocketStreamOptions): AsyncIterableIterator<SidebandStreamMessage>;
+    [Symbol.asyncIterator](options?: WebSocketStreamOptions): AsyncIterableIterator<SidebandStreamMessage>;
     private _connect;
     private _canReconnect;
     private _reconnect;

package/resources/live/sideband/ws-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-base.d.ts","sourceRoot":"","sources":["../../../src/resources/live/sideband/ws-base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAA4B,2BAAwB;AAGnG,OAAO,EAAE,KAAK,aAAa,EAAc,wCAAqC;AAC9E,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE3B,gCAA6B;AAC9B,OAAO,KAAK,WAAW,sBAAmB;AAC1C,OAAO,EAAE,MAAM,EAAE,2BAAwB;AAGzC,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,cAAc,CACZ,KAAK,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,GAC7C,qBAAqB,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAEtD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,0BAA0B,GAAG,IAAI,GAAG,SAAS,CAAC;IAE1D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,8BAAsB,cAAc,CAAC,OAAO,SAAS,aAAa,CAAE,SAAQ,eAAe;IACzF,GAAG,EAAG,GAAG,CAAC;IACV,MAAM,EAAG,OAAO,CAAC;IAEjB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/D,OAAO,CAAC,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAc;IAGtC,OAAO,CAAC,eAAe,CAKlB;gBAEO,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,SAAS;IAQzG,oDAAoD;IACpD,SAAS,CAAC,eAAe,IAAI,IAAI;IAKjC,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAExF,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,kBAAkB;IAsB1C,OAAO,CAAC,IAAI,EAAE,gBAAgB;IAsB9B,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAe9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,IAAI,qBAAqB,CAAC,qBAAqB,CAAC;IAItD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,qBAAqB,CAAC;IAwJtE,OAAO,CAAC,QAAQ;IA2DhB,OAAO,CAAC,aAAa;YAQP,UAAU;IA+IxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAMjD"}
+{"version":3,"file":"ws-base.d.ts","sourceRoot":"","sources":["../../../src/resources/live/sideband/ws-base.ts"],"names":[],"mappings":"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"}

package/resources/live/sideband/ws-base.js

@@ -91,6 +91,11 @@ class SidebandWSBase extends internal_base_1.SidebandEmitter {
      * The iterator will exit if the socket closes but exiting the iterator
      * does not close the socket.
      *
+     * Pass `maxBufferedEvents` to limit queued records for this iterator, including
+     * lifecycle events. Overflow discards its backlog and rejects `next()` with a
+     * WebSocketError; the shared socket and other iterators remain active.
+     * Omitted means unlimited. This is an event-count limit, not a byte limit.
+     *
      * @example
      * ```ts
      * for await (const event of client.stream()) {
@@ -108,23 +113,50 @@ class SidebandWSBase extends internal_base_1.SidebandEmitter {
      * }
      * ```
      */
-    stream() {
-        return this[Symbol.asyncIterator]();
+    stream(options) {
+        return options === undefined ? this[Symbol.asyncIterator]() : this[Symbol.asyncIterator](options);
     }
-    [Symbol.asyncIterator]() {
+    [Symbol.asyncIterator](options) {
         if (!this.socket) {
             throw new error_1.OpenAIError('Internal error: failed to initialize socket. Please report this issue.');
         }
+        const maxBufferedEvents = (0, ws_1.getMaxBufferedEvents)(options);
         // 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 queueHead = 0;
+        let resolverHead = 0;
         let done = false;
+        let failure;
         let currentSocket = this.socket;
+        const wakeResolver = () => {
+            if (resolverHead >= resolvers.length)
+                return;
+            const resolver = resolvers[resolverHead];
+            resolvers[resolverHead] = undefined;
+            resolverHead += 1;
+            if (resolverHead >= 64 && resolverHead * 2 >= resolvers.length) {
+                resolvers.splice(0, resolverHead);
+                resolverHead = 0;
+            }
+            resolver?.();
+        };
         const push = (msg) => {
+            if (done)
+                return;
+            if (maxBufferedEvents !== undefined && queue.length - queueHead >= maxBufferedEvents) {
+                failure = new internal_base_1.WebSocketError(`WebSocket stream exceeded maxBufferedEvents (${maxBufferedEvents})`, null);
+                done = true;
+                queue.length = 0;
+                queueHead = 0;
+                cleanup();
+                flushResolvers();
+                return;
+            }
             queue.push(msg);
-            resolvers.shift()?.();
+            wakeResolver();
         };
         const onEvent = (event) => {
             if (event.type === 'error')
@@ -148,9 +180,14 @@ class SidebandWSBase extends internal_base_1.SidebandEmitter {
             push({ type: 'reconnected' });
         };
         const flushResolvers = () => {
-            for (let resolver = resolvers.shift(); resolver; resolver = resolvers.shift()) {
-                resolver();
+            while (resolverHead < resolvers.length) {
+                const resolver = resolvers[resolverHead];
+                resolvers[resolverHead] = undefined;
+                resolverHead += 1;
+                resolver?.();
             }
+            resolvers.length = 0;
+            resolverHead = 0;
         };
         const onClose = (code, reason, unsent) => {
             push({ type: 'close', code, reason, unsent });
@@ -158,8 +195,10 @@ class SidebandWSBase extends internal_base_1.SidebandEmitter {
             flushResolvers();
             cleanup();
         };
-        const onSocketSwap = (oldSocket, newSocket) => {
-            oldSocket.off('open', onOpen);
+        const onSocketSwap = (_oldSocket, newSocket) => {
+            if (currentSocket === newSocket)
+                return;
+            currentSocket.off('open', onOpen);
             newSocket.on('open', onOpen);
             currentSocket = newSocket;
         };
@@ -213,9 +252,19 @@ class SidebandWSBase extends internal_base_1.SidebandEmitter {
                     break;
             }
         }
-        const resolve = (res) => {
-            if (queue.length > 0) {
-                res({ value: queue.shift(), done: false });
+        const resolve = (res, reject) => {
+            if (failure) {
+                reject(failure);
+            }
+            else if (queueHead < queue.length) {
+                const queued = queue[queueHead];
+                queue[queueHead] = undefined;
+                queueHead += 1;
+                if (queueHead >= 64 && queueHead * 2 >= queue.length) {
+                    queue.splice(0, queueHead);
+                    queueHead = 0;
+                }
+                res({ value: queued, done: false });
             }
             else if (done) {
                 res({ value: undefined, done: true });
@@ -225,17 +274,19 @@ class SidebandWSBase extends internal_base_1.SidebandEmitter {
             }
             return true;
         };
-        const next = () => new Promise((res) => {
-            if (resolve(res))
+        const next = () => new Promise((res, reject) => {
+            if (resolve(res, reject))
                 return;
             resolvers.push(() => {
-                resolve(res);
+                resolve(res, reject);
             });
         });
         return {
             next,
             return: () => {
                 done = true;
+                queue.length = 0;
+                queueHead = 0;
                 cleanup();
                 flushResolvers();
                 return Promise.resolve({ value: undefined, done: true });
@@ -263,6 +314,26 @@ class SidebandWSBase extends internal_base_1.SidebandEmitter {
                 this._emit('raw', data);
                 return;
             }
+            if (event === null ||
+                typeof event !== 'object' ||
+                Array.isArray(event) ||
+                !Object.prototype.hasOwnProperty.call(event, 'type') ||
+                typeof event.type !== 'string') {
+                this._onError(null, 'received invalid WebSocket event: expected an object with an own string type', undefined);
+                return;
+            }
+            const eventType = event.type;
+            const reservedEventType = eventType === 'raw' ||
+                eventType === 'close' ||
+                eventType === 'event' ||
+                eventType === 'reconnecting' ||
+                eventType === 'reconnected' ||
+                eventType === 'open' ||
+                eventType === 'error';
+            if (reservedEventType && eventType !== 'error') {
+                this._onError(null, 'received reserved WebSocket event type', undefined);
+                return;
+            }
             this._emit('event', event);
             if (event.type === 'error') {
                 this._onError(event);