openai 7.4.0 → 7.6.0

package/realtime/websocket.mjs

@@ -1,15 +1,112 @@
+import { assertBedrockWebSocketOrigin } from "../internal/bedrock.mjs";
 import { OpenAI } from "../index.mjs";
 import { OpenAIError } from "../error.mjs";
-import { OpenAIRealtimeEmitter, buildRealtimeURL, getAzureRealtimeConnection, isAzure, } from "./internal-base.mjs";
+import { OpenAIRealtimeEmitter, buildRealtimeURL, getAzureRealtimeConnection, isAzure, parseRealtimeEvent, } from "./internal-base.mjs";
 import { isRunningInBrowser } from "../internal/detect-platform.mjs";
+/** Identifies browser pages and workers without blocking trusted server runtimes. */
+function isRunningInBrowserOrBrowserWorker() {
+    if (isRunningInBrowser()) {
+        return true;
+    }
+    const scope = globalThis;
+    return (typeof scope.WorkerGlobalScope === 'function' &&
+        scope instanceof scope.WorkerGlobalScope &&
+        typeof scope.WorkerNavigator === 'function' &&
+        scope.navigator instanceof scope.WorkerNavigator &&
+        typeof scope.navigator?.userAgent === 'string' &&
+        scope.navigator.userAgent !== 'Cloudflare-Workers' &&
+        scope.process?.versions?.node === undefined &&
+        scope.Deno === undefined &&
+        scope.Bun === undefined &&
+        scope.EdgeRuntime === undefined &&
+        scope.WebSocketPair === undefined);
+}
+/** Reports whether the runtime supports request headers in native WebSocket options. */
+function supportsWebSocketRequestHeaders() {
+    const scope = globalThis;
+    if (isRunningInBrowserOrBrowserWorker() ||
+        scope.EdgeRuntime !== undefined ||
+        scope.WebSocketPair !== undefined ||
+        scope.navigator?.userAgent === 'Cloudflare-Workers') {
+        return false;
+    }
+    if (scope.Deno !== undefined) {
+        const [major, minor] = (scope.Deno.version?.deno ?? '').split('.').map(Number);
+        return major !== undefined && minor !== undefined && (major > 2 || (major === 2 && minor >= 5));
+    }
+    if (typeof scope.Bun?.version === 'string') {
+        return true;
+    }
+    return (Object.prototype.toString.call(scope.process) === '[object process]' &&
+        typeof scope.process?.versions?.node === 'string');
+}
+/** Removes Azure credentials while preserving the existing public URL redaction contract. */
+function redactAzureCredentials(url, isBearerToken) {
+    let hasApiKey = !isBearerToken;
+    let hasAuthorization = isBearerToken;
+    const parameterNames = [...url.searchParams.keys()];
+    for (const name of parameterNames) {
+        if (name.toLowerCase() === 'api-key') {
+            hasApiKey = true;
+            url.searchParams.delete(name);
+        }
+        else if (name.toLowerCase() === 'authorization') {
+            hasAuthorization = true;
+            url.searchParams.delete(name);
+        }
+    }
+    if (hasApiKey) {
+        url.searchParams.set('api-key', '<REDACTED>');
+    }
+    if (hasAuthorization) {
+        url.searchParams.set('Authorization', '<REDACTED>');
+    }
+}
+/** Opens an Azure native socket with header authentication and a credential-free URL. */
+function createAzureWebSocket(url, apiKey, isBearerToken, protocols) {
+    if (!supportsWebSocketRequestHeaders()) {
+        throw new OpenAIError('Azure OpenAI Realtime credentials require a WebSocket transport that supports request headers; use openai/realtime/ws or a server-side authentication proxy.');
+    }
+    if (!apiKey) {
+        throw new Error('Azure OpenAI Realtime requires an API key');
+    }
+    redactAzureCredentials(url, isBearerToken);
+    const socketURL = new URL(url);
+    socketURL.searchParams.delete('api-key');
+    socketURL.searchParams.delete('Authorization');
+    const headers = isBearerToken ? { Authorization: `Bearer ${apiKey}` } : { 'api-key': apiKey };
+    // @ts-ignore
+    return new WebSocket(socketURL.toString(), { protocols, headers });
+}
+/**
+ * Connects to the Realtime API using the runtime's native `WebSocket` implementation.
+ *
+ * Browser use is blocked by default to prevent secret API-key exposure. Use an
+ * ephemeral Realtime credential in browser clients; set
+ * `dangerouslyAllowBrowser` only after independently securing the credential.
+ * Register an SDK `error` listener and wait for `socket`'s `open` event before
+ * sending Realtime client events.
+ */
 export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
+    /**
+     * Immediately opens a native WebSocket session or attaches to an existing call.
+     *
+     * Clients with function-based credentials must use
+     * {@link OpenAIRealtimeWebSocket.create}; Azure clients should use
+     * {@link OpenAIRealtimeWebSocket.azure}. An ephemeral credential whose value
+     * starts with `ek_` is permitted in browser runtimes automatically.
+     *
+     * @param props Exactly one model, transcription intent, or call ID, plus browser-safety settings.
+     * @param client Existing client whose endpoint and API key should be reused.
+     * @throws {OpenAIError} If browser access would expose an unapproved credential.
+     */
     constructor(props, client) {
         super();
         const hasProvider = typeof client?._options?.apiKey === 'function';
         const dangerouslyAllowBrowser = props.dangerouslyAllowBrowser ??
             client?._options?.dangerouslyAllowBrowser ??
             (client?.apiKey?.startsWith('ek_') ? true : null);
-        if (!dangerouslyAllowBrowser && isRunningInBrowser()) {
+        if (!dangerouslyAllowBrowser && isRunningInBrowserOrBrowserWorker()) {
             throw new OpenAIError("It looks like you're running in a browser-like environment.\n\nThis is disabled by default, as it risks exposing your secret API credentials to attackers.\n\nYou can avoid this error by creating an ephemeral session token:\nhttps://platform.openai.com/docs/api-reference/realtime-sessions\n");
         }
         client ?? (client = new OpenAI({ dangerouslyAllowBrowser }));
@@ -21,15 +118,27 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
         }
         this.url = buildRealtimeURL(client, props);
         props.onURL?.(this.url);
-        // @ts-ignore
-        this.socket = new WebSocket(this.url.toString(), [
-            'realtime',
-            ...(isAzure(client) ? [] : [`openai-insecure-api-key.${client.apiKey}`]),
-        ]);
+        if (this.url.protocol !== 'wss:') {
+            throw new OpenAIError('Realtime WebSocket URLs must use the wss: protocol.');
+        }
+        assertBedrockWebSocketOrigin(client, this.url);
+        const azure = isAzure(client);
+        const protocols = ['realtime', ...(azure ? [] : [`openai-insecure-api-key.${client.apiKey}`])];
+        this.socket = azure
+            ? createAzureWebSocket(this.url, client.apiKey, props.__resolvedApiKey === true, protocols)
+            : new WebSocket(this.url.toString(), protocols);
         this.socket.addEventListener('message', (websocketEvent) => {
             const event = (() => {
                 try {
-                    return JSON.parse(websocketEvent.data.toString());
+                    const parsedEvent = parseRealtimeEvent(websocketEvent.data.toString());
+                    if (typeof parsedEvent !== 'object' ||
+                        parsedEvent === null ||
+                        Array.isArray(parsedEvent) ||
+                        !Object.getOwnPropertyDescriptor(parsedEvent, 'type') ||
+                        typeof parsedEvent.type !== 'string') {
+                        throw new TypeError('Realtime WebSocket event must be an object with a string type.');
+                    }
+                    return parsedEvent;
                 }
                 catch (err) {
                     this._onError(null, 'could not parse websocket event', err);
@@ -50,18 +159,36 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
         this.socket.addEventListener('error', (event) => {
             this._onError(null, event.message, null);
         });
-        if (isAzure(client)) {
-            if (this.url.searchParams.get('Authorization') !== null) {
-                this.url.searchParams.set('Authorization', '<REDACTED>');
-            }
-            else {
-                this.url.searchParams.set('api-key', '<REDACTED>');
-            }
-        }
     }
+    /**
+     * Resolves a client's current API credential before opening a native Realtime WebSocket.
+     *
+     * Use this factory instead of the constructor when the client's `apiKey` is a function.
+     *
+     * @param client OpenAI client that owns the endpoint and refreshable or static credential.
+     * @param props Exactly one model, transcription intent, or call ID, plus browser-safety settings.
+     */
     static async create(client, props) {
-        return new OpenAIRealtimeWebSocket({ ...props, __resolvedApiKey: await client._callApiKey() }, client);
+        const resolvedApiKey = await client._callApiKey();
+        const url = buildRealtimeURL(client, props);
+        assertBedrockWebSocketOrigin(client, url);
+        return new OpenAIRealtimeWebSocket({
+            ...props,
+            buildRealtimeURL: () => url,
+            __resolvedApiKey: resolvedApiKey,
+        }, client);
     }
+    /**
+     * Opens a native Azure deployment or transcription session, or an existing sideband call.
+     *
+     * Azure credentials are sent in WebSocket handshake headers and never appear
+     * in the native socket URL. Browser WebSockets cannot set these headers;
+     * use a server-side authentication proxy or the Node.js `ws` transport.
+     *
+     * @param client Azure OpenAI client that supplies the endpoint and credential.
+     * @param options Deployment, transcription intent, or call ID, plus browser-safety settings.
+     * @throws {Error} If the Azure credential or required deployment is unavailable.
+     */
     static async azure(client, options = {}) {
         const connection = getAzureRealtimeConnection(client, options);
         const isApiKeyProvider = await client._callApiKey();
@@ -69,23 +196,17 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
         if (!apiKey) {
             throw new Error('Azure OpenAI Realtime requires an API key');
         }
-        const azureApiKey = apiKey;
-        function onURL(url) {
-            if (isApiKeyProvider) {
-                url.searchParams.set('Authorization', `Bearer ${azureApiKey}`);
-            }
-            else {
-                url.searchParams.set('api-key', azureApiKey);
-            }
-        }
         const { dangerouslyAllowBrowser } = options;
         return new OpenAIRealtimeWebSocket({
             ...connection,
-            onURL,
-            ...(dangerouslyAllowBrowser ? { dangerouslyAllowBrowser } : {}),
+            ...(dangerouslyAllowBrowser === undefined ? {} : { dangerouslyAllowBrowser }),
             __resolvedApiKey: isApiKeyProvider,
         }, client);
     }
+    /**
+     * Serializes and sends a Realtime client event after the native WebSocket has opened.
+     * Serialization and transport failures are delivered to the SDK `error` event.
+     */
     send(event) {
         try {
             this.socket.send(JSON.stringify(event));
@@ -94,6 +215,10 @@ export class OpenAIRealtimeWebSocket extends OpenAIRealtimeEmitter {
             this._onError(null, 'could not send data', err);
         }
     }
+    /**
+     * Closes the WebSocket with status code `1000` and reason `OK` by default.
+     * Connection-closing failures are delivered to the SDK `error` event.
+     */
     close(props) {
         try {
             this.socket.close(props?.code ?? 1000, props?.reason ?? 'OK');

package/realtime/websocket.mjs.map

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

package/realtime/ws.d.mts

@@ -1,23 +1,78 @@
 import * as WS from 'ws';
-import { AzureOpenAI, OpenAI } from "../index.mjs";
+import type { AzureOpenAI } from "../index.mjs";
+import { OpenAI } from "../index.mjs";
 import type { RealtimeClientEvent } from "../resources/realtime/realtime.mjs";
-import { OpenAIRealtimeEmitter, type AzureRealtimeConnectionConfig, type RealtimeConnectionConfig } from "./internal-base.mjs";
+import { OpenAIRealtimeEmitter } from "./internal-base.mjs";
+import type { AzureRealtimeConnectionConfig, RealtimeConnectionConfig } from "./internal-base.mjs";
+/**
+ * Connects to the Realtime API using the Node.js `ws` WebSocket implementation.
+ *
+ * Install the optional `ws` peer dependency before importing this entrypoint.
+ * Subscribe to `socket`'s `open` and `close` events for connection lifecycle,
+ * and register an SDK `error` listener for API or transport failures.
+ */
 export declare class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
+    /** Secure Realtime WebSocket URL with its model, transcription intent, or call ID. */
     url: URL;
+    /** Underlying `ws.WebSocket` instance for connection lifecycle and transport events. */
     socket: WS.WebSocket;
+    /**
+     * Immediately opens a model or transcription session, or attaches to an existing call.
+     *
+     * Pass an existing OpenAI client as the second argument to reuse its endpoint
+     * and static credentials. Clients with function-based credentials must use
+     * {@link OpenAIRealtimeWS.create}; Azure clients should use
+     * {@link OpenAIRealtimeWS.azure}.
+     *
+     * @param props Exactly one model, transcription intent, or call ID, plus `ws` client settings.
+     * @param client Existing client whose endpoint and API key should be reused.
+     */
     constructor(props: RealtimeConnectionConfig & {
+        /** Options passed directly to the underlying `ws.WebSocket` constructor. */
         options?: WS.ClientOptions | undefined;
-        /** @internal */ __resolvedApiKey?: boolean;
+        /** Indicates that a function-based credential was resolved by an async factory. @internal */
+        __resolvedApiKey?: boolean;
     }, client?: Pick<OpenAI, 'apiKey' | 'baseURL'>);
+    /**
+     * Resolves a client's current API credential before opening a Realtime connection.
+     *
+     * Use this factory instead of the constructor when the client's `apiKey` is a function.
+     *
+     * @param client OpenAI client that owns the endpoint and refreshable or static credential.
+     * @param props Exactly one model, transcription intent, or call ID, plus `ws` client settings.
+     */
     static create(client: Pick<OpenAI, 'apiKey' | 'baseURL' | '_callApiKey'>, props: RealtimeConnectionConfig & {
+        /** Options passed directly to the underlying `ws.WebSocket` constructor. */
         options?: WS.ClientOptions | undefined;
     }): Promise<OpenAIRealtimeWS>;
+    /**
+     * Opens an Azure deployment or transcription session, or an existing sideband call.
+     *
+     * Static Azure API keys are sent in the `api-key` header; function-based
+     * credentials are resolved first and sent as bearer credentials. The client's
+     * configured deployment is used unless a deployment, transcription intent, or call ID is supplied.
+     *
+     * @param client Azure OpenAI client that supplies the endpoint and credential.
+     * @param props Deployment, transcription intent, or call ID, plus `ws` connection settings.
+     * @throws {Error} If the Azure credential or required deployment is unavailable.
+     */
     static azure(client: Pick<AzureOpenAI, '_callApiKey' | 'apiVersion' | 'apiKey' | 'baseURL' | 'deploymentName'>, props?: AzureRealtimeConnectionConfig & {
+        /** Options passed directly to the underlying `ws.WebSocket` constructor. */
         options?: WS.ClientOptions | undefined;
     }): Promise<OpenAIRealtimeWS>;
+    /**
+     * Serializes and sends a Realtime client event after the WebSocket has opened.
+     * Serialization and transport failures are delivered to the SDK `error` event.
+     */
     send(event: RealtimeClientEvent): void;
+    /**
+     * Closes the WebSocket with status code `1000` and reason `OK` by default.
+     * Connection-closing failures are delivered to the SDK `error` event.
+     */
     close(props?: {
+        /** WebSocket close status code; defaults to `1000`. */
         code: number;
+        /** WebSocket close reason; defaults to `OK`. */
         reason: string;
     }): void;
 }

package/realtime/ws.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.mts","sourceRoot":"","sources":["../src/realtime/ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,qBAAiB;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAuB,2CAAuC;AAC/F,OAAO,EACL,qBAAqB,EAIrB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC9B,4BAAwB;AAEzB,qBAAa,gBAAiB,SAAQ,qBAAqB;IACzD,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;gBAGnB,KAAK,EAAE,wBAAwB,GAAG;QAChC,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;QACvC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC7C,EACD,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;WAiDhC,MAAM,CACjB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC,EAC1D,KAAK,EAAE,wBAAwB,GAAG;QAAE,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAA;KAAE,GAC3E,OAAO,CAAC,gBAAgB,CAAC;WAIf,KAAK,CAChB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC,EACjG,KAAK,GAAE,6BAA6B,GAAG;QAAE,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAA;KAAO,GACrF,OAAO,CAAC,gBAAgB,CAAC;IAuB5B,IAAI,CAAC,KAAK,EAAE,mBAAmB;IAQ/B,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAO/C"}
+{"version":3,"file":"ws.d.mts","sourceRoot":"","sources":["../src/realtime/ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAiB;AAC5C,OAAO,EAAE,MAAM,EAAE,qBAAiB;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,2CAAuC;AAC1E,OAAO,EACL,qBAAqB,EAKtB,4BAAwB;AACzB,OAAO,KAAK,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,4BAAwB;AAE/F;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,qBAAqB;IACzD,sFAAsF;IACtF,GAAG,EAAE,GAAG,CAAC;IAET,wFAAwF;IACxF,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;IAErB;;;;;;;;;;OAUG;gBAED,KAAK,EAAE,wBAAwB,GAAG;QAChC,4EAA4E;QAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;QAEvC,6FAA6F;QAC7F,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,EACD,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAmE7C;;;;;;;OAOG;WACU,MAAM,CACjB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC,EAC1D,KAAK,EAAE,wBAAwB,GAAG;QAChC,4EAA4E;QAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;KACxC,GACA,OAAO,CAAC,gBAAgB,CAAC;IAc5B;;;;;;;;;;OAUG;WACU,KAAK,CAChB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC,EACjG,KAAK,GAAE,6BAA6B,GAAG;QACrC,4EAA4E;QAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;KACnC,GACL,OAAO,CAAC,gBAAgB,CAAC;IAuB5B;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAQtC;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE;QACZ,uDAAuD;QACvD,IAAI,EAAE,MAAM,CAAC;QAEb,gDAAgD;QAChD,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI;CAOT"}

package/realtime/ws.d.ts

@@ -1,23 +1,78 @@
 import * as WS from 'ws';
-import { AzureOpenAI, OpenAI } from "../index.js";
+import type { AzureOpenAI } from "../index.js";
+import { OpenAI } from "../index.js";
 import type { RealtimeClientEvent } from "../resources/realtime/realtime.js";
-import { OpenAIRealtimeEmitter, type AzureRealtimeConnectionConfig, type RealtimeConnectionConfig } from "./internal-base.js";
+import { OpenAIRealtimeEmitter } from "./internal-base.js";
+import type { AzureRealtimeConnectionConfig, RealtimeConnectionConfig } from "./internal-base.js";
+/**
+ * Connects to the Realtime API using the Node.js `ws` WebSocket implementation.
+ *
+ * Install the optional `ws` peer dependency before importing this entrypoint.
+ * Subscribe to `socket`'s `open` and `close` events for connection lifecycle,
+ * and register an SDK `error` listener for API or transport failures.
+ */
 export declare class OpenAIRealtimeWS extends OpenAIRealtimeEmitter {
+    /** Secure Realtime WebSocket URL with its model, transcription intent, or call ID. */
     url: URL;
+    /** Underlying `ws.WebSocket` instance for connection lifecycle and transport events. */
     socket: WS.WebSocket;
+    /**
+     * Immediately opens a model or transcription session, or attaches to an existing call.
+     *
+     * Pass an existing OpenAI client as the second argument to reuse its endpoint
+     * and static credentials. Clients with function-based credentials must use
+     * {@link OpenAIRealtimeWS.create}; Azure clients should use
+     * {@link OpenAIRealtimeWS.azure}.
+     *
+     * @param props Exactly one model, transcription intent, or call ID, plus `ws` client settings.
+     * @param client Existing client whose endpoint and API key should be reused.
+     */
     constructor(props: RealtimeConnectionConfig & {
+        /** Options passed directly to the underlying `ws.WebSocket` constructor. */
         options?: WS.ClientOptions | undefined;
-        /** @internal */ __resolvedApiKey?: boolean;
+        /** Indicates that a function-based credential was resolved by an async factory. @internal */
+        __resolvedApiKey?: boolean;
     }, client?: Pick<OpenAI, 'apiKey' | 'baseURL'>);
+    /**
+     * Resolves a client's current API credential before opening a Realtime connection.
+     *
+     * Use this factory instead of the constructor when the client's `apiKey` is a function.
+     *
+     * @param client OpenAI client that owns the endpoint and refreshable or static credential.
+     * @param props Exactly one model, transcription intent, or call ID, plus `ws` client settings.
+     */
     static create(client: Pick<OpenAI, 'apiKey' | 'baseURL' | '_callApiKey'>, props: RealtimeConnectionConfig & {
+        /** Options passed directly to the underlying `ws.WebSocket` constructor. */
         options?: WS.ClientOptions | undefined;
     }): Promise<OpenAIRealtimeWS>;
+    /**
+     * Opens an Azure deployment or transcription session, or an existing sideband call.
+     *
+     * Static Azure API keys are sent in the `api-key` header; function-based
+     * credentials are resolved first and sent as bearer credentials. The client's
+     * configured deployment is used unless a deployment, transcription intent, or call ID is supplied.
+     *
+     * @param client Azure OpenAI client that supplies the endpoint and credential.
+     * @param props Deployment, transcription intent, or call ID, plus `ws` connection settings.
+     * @throws {Error} If the Azure credential or required deployment is unavailable.
+     */
     static azure(client: Pick<AzureOpenAI, '_callApiKey' | 'apiVersion' | 'apiKey' | 'baseURL' | 'deploymentName'>, props?: AzureRealtimeConnectionConfig & {
+        /** Options passed directly to the underlying `ws.WebSocket` constructor. */
         options?: WS.ClientOptions | undefined;
     }): Promise<OpenAIRealtimeWS>;
+    /**
+     * Serializes and sends a Realtime client event after the WebSocket has opened.
+     * Serialization and transport failures are delivered to the SDK `error` event.
+     */
     send(event: RealtimeClientEvent): void;
+    /**
+     * Closes the WebSocket with status code `1000` and reason `OK` by default.
+     * Connection-closing failures are delivered to the SDK `error` event.
+     */
     close(props?: {
+        /** WebSocket close status code; defaults to `1000`. */
         code: number;
+        /** WebSocket close reason; defaults to `OK`. */
         reason: string;
     }): void;
 }

package/realtime/ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/realtime/ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAiB;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAuB,0CAAuC;AAC/F,OAAO,EACL,qBAAqB,EAIrB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC9B,2BAAwB;AAEzB,qBAAa,gBAAiB,SAAQ,qBAAqB;IACzD,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;gBAGnB,KAAK,EAAE,wBAAwB,GAAG;QAChC,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;QACvC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC7C,EACD,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;WAiDhC,MAAM,CACjB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC,EAC1D,KAAK,EAAE,wBAAwB,GAAG;QAAE,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAA;KAAE,GAC3E,OAAO,CAAC,gBAAgB,CAAC;WAIf,KAAK,CAChB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC,EACjG,KAAK,GAAE,6BAA6B,GAAG;QAAE,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAA;KAAO,GACrF,OAAO,CAAC,gBAAgB,CAAC;IAuB5B,IAAI,CAAC,KAAK,EAAE,mBAAmB;IAQ/B,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAO/C"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/realtime/ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAiB;AAC5C,OAAO,EAAE,MAAM,EAAE,oBAAiB;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,0CAAuC;AAC1E,OAAO,EACL,qBAAqB,EAKtB,2BAAwB;AACzB,OAAO,KAAK,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,2BAAwB;AAE/F;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,qBAAqB;IACzD,sFAAsF;IACtF,GAAG,EAAE,GAAG,CAAC;IAET,wFAAwF;IACxF,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;IAErB;;;;;;;;;;OAUG;gBAED,KAAK,EAAE,wBAAwB,GAAG;QAChC,4EAA4E;QAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;QAEvC,6FAA6F;QAC7F,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,EACD,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAmE7C;;;;;;;OAOG;WACU,MAAM,CACjB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC,EAC1D,KAAK,EAAE,wBAAwB,GAAG;QAChC,4EAA4E;QAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;KACxC,GACA,OAAO,CAAC,gBAAgB,CAAC;IAc5B;;;;;;;;;;OAUG;WACU,KAAK,CAChB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC,EACjG,KAAK,GAAE,6BAA6B,GAAG;QACrC,4EAA4E;QAC5E,OAAO,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC;KACnC,GACL,OAAO,CAAC,gBAAgB,CAAC;IAuB5B;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAQtC;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE;QACZ,uDAAuD;QACvD,IAAI,EAAE,MAAM,CAAC;QAEb,gDAAgD;QAChD,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI;CAOT"}

package/realtime/ws.js

@@ -3,9 +3,29 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAIRealtimeWS = void 0;
 const tslib_1 = require("../internal/tslib.js");
 const WS = tslib_1.__importStar(require("ws"));
+const bedrock_1 = require("../internal/bedrock.js");
+const ws_1 = require("../internal/ws.js");
 const index_1 = require("../index.js");
 const internal_base_1 = require("./internal-base.js");
+/**
+ * Connects to the Realtime API using the Node.js `ws` WebSocket implementation.
+ *
+ * Install the optional `ws` peer dependency before importing this entrypoint.
+ * Subscribe to `socket`'s `open` and `close` events for connection lifecycle,
+ * and register an SDK `error` listener for API or transport failures.
+ */
 class OpenAIRealtimeWS extends internal_base_1.OpenAIRealtimeEmitter {
+    /**
+     * Immediately opens a model or transcription session, or attaches to an existing call.
+     *
+     * Pass an existing OpenAI client as the second argument to reuse its endpoint
+     * and static credentials. Clients with function-based credentials must use
+     * {@link OpenAIRealtimeWS.create}; Azure clients should use
+     * {@link OpenAIRealtimeWS.azure}.
+     *
+     * @param props Exactly one model, transcription intent, or call ID, plus `ws` client settings.
+     * @param client Existing client whose endpoint and API key should be reused.
+     */
     constructor(props, client) {
         super();
         client ?? (client = new index_1.OpenAI());
@@ -17,17 +37,27 @@ class OpenAIRealtimeWS extends internal_base_1.OpenAIRealtimeEmitter {
             ].join('\n'));
         }
         this.url = (0, internal_base_1.buildRealtimeURL)(client, props);
-        this.socket = new WS.WebSocket(this.url, {
+        (0, bedrock_1.assertBedrockWebSocketOrigin)(client, this.url);
+        const headers = {
+            ...props.options?.headers,
+            ...((0, internal_base_1.isAzure)(client) && !props.__resolvedApiKey ? {} : { Authorization: `Bearer ${client.apiKey}` }),
+        };
+        this.socket = new WS.WebSocket(this.url, (0, ws_1.protectWebSocketOptionsFromCredentialRedirects)({
             ...props.options,
-            headers: {
-                ...props.options?.headers,
-                ...((0, internal_base_1.isAzure)(client) && !props.__resolvedApiKey ? {} : { Authorization: `Bearer ${client.apiKey}` }),
-            },
-        });
+            headers,
+        }));
         this.socket.on('message', (wsEvent) => {
             const event = (() => {
                 try {
-                    return JSON.parse(wsEvent.toString());
+                    const parsedEvent = (0, internal_base_1.parseRealtimeEvent)(wsEvent.toString());
+                    if (typeof parsedEvent !== 'object' ||
+                        parsedEvent === null ||
+                        Array.isArray(parsedEvent) ||
+                        !Object.getOwnPropertyDescriptor(parsedEvent, 'type') ||
+                        typeof parsedEvent.type !== 'string') {
+                        throw new TypeError('Realtime WebSocket event must be an object with a string type.');
+                    }
+                    return parsedEvent;
                 }
                 catch (err) {
                     this._onError(null, 'could not parse websocket event', err);
@@ -49,9 +79,35 @@ class OpenAIRealtimeWS extends internal_base_1.OpenAIRealtimeEmitter {
             this._onError(null, err.message, err);
         });
     }
+    /**
+     * Resolves a client's current API credential before opening a Realtime connection.
+     *
+     * Use this factory instead of the constructor when the client's `apiKey` is a function.
+     *
+     * @param client OpenAI client that owns the endpoint and refreshable or static credential.
+     * @param props Exactly one model, transcription intent, or call ID, plus `ws` client settings.
+     */
     static async create(client, props) {
-        return new OpenAIRealtimeWS({ ...props, __resolvedApiKey: await client._callApiKey() }, client);
+        const resolvedApiKey = await client._callApiKey();
+        const url = (0, internal_base_1.buildRealtimeURL)(client, props);
+        (0, bedrock_1.assertBedrockWebSocketOrigin)(client, url);
+        return new OpenAIRealtimeWS({
+            ...props,
+            buildRealtimeURL: () => url,
+            __resolvedApiKey: resolvedApiKey,
+        }, client);
     }
+    /**
+     * Opens an Azure deployment or transcription session, or an existing sideband call.
+     *
+     * Static Azure API keys are sent in the `api-key` header; function-based
+     * credentials are resolved first and sent as bearer credentials. The client's
+     * configured deployment is used unless a deployment, transcription intent, or call ID is supplied.
+     *
+     * @param client Azure OpenAI client that supplies the endpoint and credential.
+     * @param props Deployment, transcription intent, or call ID, plus `ws` connection settings.
+     * @throws {Error} If the Azure credential or required deployment is unavailable.
+     */
     static async azure(client, props = {}) {
         const connection = (0, internal_base_1.getAzureRealtimeConnection)(client, props);
         const isApiKeyProvider = await client._callApiKey();
@@ -71,6 +127,10 @@ class OpenAIRealtimeWS extends internal_base_1.OpenAIRealtimeEmitter {
             __resolvedApiKey: isApiKeyProvider,
         }, client);
     }
+    /**
+     * Serializes and sends a Realtime client event after the WebSocket has opened.
+     * Serialization and transport failures are delivered to the SDK `error` event.
+     */
     send(event) {
         try {
             this.socket.send(JSON.stringify(event));
@@ -79,6 +139,10 @@ class OpenAIRealtimeWS extends internal_base_1.OpenAIRealtimeEmitter {
             this._onError(null, 'could not send data', err);
         }
     }
+    /**
+     * Closes the WebSocket with status code `1000` and reason `OK` by default.
+     * Connection-closing failures are delivered to the SDK `error` event.
+     */
     close(props) {
         try {
             this.socket.close(props?.code ?? 1000, props?.reason ?? 'OK');

package/realtime/ws.js.map

@@ -1 +1 @@
-{"version":3,"file":"ws.js","sourceRoot":"","sources":["../src/realtime/ws.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../src/realtime/ws.ts"],"names":[],"mappings":";;;;AAAA,+CAAyB;AACzB,oDAAmE;AACnE,0CAAgF;AAEhF,uCAAkC;AAElC,sDAMyB;AAGzB;;;;;;GAMG;AACH,MAAa,gBAAiB,SAAQ,qCAAqB;IAOzD;;;;;;;;;;OAUG;IACH,YACE,KAMC,EACD,MAA2C;QAE3C,KAAK,EAAE,CAAC;QACR,MAAM,KAAN,MAAM,GAAK,IAAI,cAAM,EAAE,EAAC;QACxB,MAAM,WAAW,GAAG,OAAQ,MAAc,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,CAAC;QAC5E,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb;gBACE,8DAA8D;gBAC9D,yEAAyE;aAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,IAAA,gCAAgB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAA,sCAA4B,EAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG;YACd,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO;YACzB,GAAG,CAAC,IAAA,uBAAO,EAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;SACpG,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC,SAAS,CAC5B,IAAI,CAAC,GAAG,EACR,IAAA,mDAA8C,EAAC;YAC7C,GAAG,KAAK,CAAC,OAAO;YAChB,OAAO;SACR,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC;oBACH,MAAM,WAAW,GAAG,IAAA,kCAAkB,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAE3D,IACE,OAAO,WAAW,KAAK,QAAQ;wBAC/B,WAAW,KAAK,IAAI;wBACpB,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;wBAC1B,CAAC,MAAM,CAAC,wBAAwB,CAAC,WAAW,EAAE,MAAM,CAAC;wBACrD,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,EACpC,CAAC;wBACD,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAC;oBACxF,CAAC;oBAED,OAAO,WAAW,CAAC;gBACrB,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,4EAA4E;oBAC5E,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;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,MAA0D,EAC1D,KAGC;QAED,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,IAAA,gCAAgB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAA,sCAA4B,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,OAAO,IAAI,gBAAgB,CACzB;YACE,GAAG,KAAK;YACR,gBAAgB,EAAE,GAAG,EAAE,CAAC,GAAG;YAC3B,gBAAgB,EAAE,cAAc;SACjC,EACD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAChB,MAAiG,EACjG,QAGI,EAAE;QAEN,MAAM,UAAU,GAAG,IAAA,0CAA0B,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,gBAAgB,CACzB;YACE,GAAG,UAAU;YACb,OAAO,EAAE;gBACP,GAAG,KAAK,CAAC,OAAO;gBAChB,OAAO,EAAE;oBACP,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO;oBACzB,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;iBACnD;aACF;YACD,gBAAgB,EAAE,gBAAgB;SACnC,EACD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAA0B;QAC7B,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;;;OAGG;IACH,KAAK,CAAC,KAML;QACC,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;CACF;AA9LD,4CA8LC"}