@depup/openai 7.34.0-depup.0 → 7.36.0-depup.0

package/internal/responses-ws-credentials.mjs

@@ -1,104 +1,8 @@
-import { OpenAIError } from "../core/error.mjs";
-import { resolveRealtimeAPIKey } from "./realtime-credentials.mjs";
-import { buildWebSocketOptions, mergeWebSocketAuthHeaders, snapshotWebSocketCredentials, WEBSOCKET_METADATA_HEADERS, } from "./ws.mjs";
-/**
- * Keep caller credential admission distinct from the hook's final provider-key transform.
- * The latter reuses captured base headers so no caller getters are reread after the refresh.
- */
-function buildResponsesWebSocketOptions(client, authHeaders, options, prepared) {
-    if (prepared) {
-        return prepared.apiKey === undefined
-            ? mergeWebSocketAuthHeaders(prepared.options, authHeaders, prepared.removedHeaders)
-            : buildWebSocketOptions(client, authHeaders, prepared.options, prepared.removedHeaders, true);
-    }
-    if (!client._hasApiKeyProvider()) {
-        return buildWebSocketOptions(client, authHeaders, options);
-    }
-    const removedHeaders = new Set();
-    const provided = buildWebSocketOptions(client, {}, options, removedHeaders);
-    return snapshotWebSocketCredentials(provided, WEBSOCKET_METADATA_HEADERS)
-        ? provided
-        : buildWebSocketOptions(client, authHeaders, provided, removedHeaders, true);
-}
-/**
- * Classify reconnect credentials without treating the previous SDK key as a caller override.
- * Capture routing and caller options before any asynchronous key refresh.
- */
-function prepareResponsesWebSocketReconnect(client, socketOptions, initialAuthUsedAPIKey) {
-    const removedHeaders = new Set();
-    const options = buildWebSocketOptions(client, {}, socketOptions, removedHeaders);
-    let authentication;
-    if (snapshotWebSocketCredentials(options, WEBSOCKET_METADATA_HEADERS)) {
-        authentication = 'provided';
-    }
-    else if (removedHeaders.has('authorization') ||
-        options.headers?.['authorization'] !== undefined ||
-        !initialAuthUsedAPIKey) {
-        authentication = 'cached';
-    }
-    else {
-        authentication = 'refresh';
-    }
-    return { options, removedHeaders, authentication };
-}
-/** Per-connection Responses credential state shared by the stable and beta Node transports. */
-export class ResponsesWebSocketCredentials {
+import { WebSocketCredentials } from "./ws-credentials.mjs";
+/** Preserves the stable and beta Responses credential helper's constructor. */
+export class ResponsesWebSocketCredentials extends WebSocketCredentials {
     constructor() {
-        this.initialAuthUsedAPIKey = false;
-    }
-    get preparedAPIKey() {
-        return this.prepared?.apiKey;
-    }
-    trackInitialHeaders(client, headers, hasSocket) {
-        if (!hasSocket() && client._hasApiKeyProvider()) {
-            this.initialAPIKey = headers['Authorization']?.slice('Bearer '.length);
-        }
-    }
-    usesAPIKey(client, headers) {
-        // Hooks can read the SDK key without delegating. Only use an ordinary cached property here:
-        // invoking custom/Bedrock getters could validate credentials a caller-owned socket never sends.
-        const apiKey = this.initialAPIKey ??
-            (client._hasApiKeyProvider() ? Object.getOwnPropertyDescriptor(client, 'apiKey')?.value : undefined);
-        if (!apiKey) {
-            return false;
-        }
-        // Metadata containing a copy of a credential does not make it the socket's authentication.
-        return snapshotWebSocketCredentials({
-            headers: Object.fromEntries(Object.entries(headers).map(([name, value]) => [name, value?.includes(apiKey) ? value : ''])),
-        }, WEBSOCKET_METADATA_HEADERS);
-    }
-    build(client, authHeaders, options, initialAuthUsedAPIKey) {
-        if (initialAuthUsedAPIKey !== undefined) {
-            this.initialAuthUsedAPIKey = initialAuthUsedAPIKey;
-            this.initialAPIKey = undefined;
-        }
-        const socketOptions = buildResponsesWebSocketOptions(client, authHeaders, options, this.prepared);
-        if (client._hasApiKeyProvider() &&
-            !authHeaders['Authorization'] &&
-            !snapshotWebSocketCredentials(socketOptions, WEBSOCKET_METADATA_HEADERS)) {
-            throw new OpenAIError('Cannot open a Responses WebSocket with an unresolved function-based apiKey. Resolve it before constructing the WebSocket or provide explicit WebSocket credentials.');
-        }
-        return socketOptions;
-    }
-    async prepare(client, socketOptions, authHeaders, createSocket) {
-        const { options, removedHeaders, authentication } = prepareResponsesWebSocketReconnect(client, socketOptions, this.initialAuthUsedAPIKey);
-        const createPreparedSocket = (url, headers, apiKey) => {
-            const previous = this.prepared;
-            this.prepared = { options, removedHeaders, apiKey };
-            try {
-                // Resolve headers inside the scope so legacy zero-argument overrides see this attempt's key.
-                return createSocket(url, apiKey === undefined ? headers : authHeaders(apiKey));
-            }
-            finally {
-                this.prepared = previous;
-            }
-        };
-        if (authentication !== 'refresh') {
-            const headers = authentication === 'provided' ? {} : authHeaders();
-            return (url) => createPreparedSocket(url, headers);
-        }
-        const { commit } = await resolveRealtimeAPIKey(client, true);
-        return (url) => createPreparedSocket(url, {}, commit());
+        super('Responses');
     }
 }
 //# sourceMappingURL=responses-ws-credentials.mjs.map

package/internal/responses-ws-credentials.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"responses-ws-credentials.mjs","sourceRoot":"","sources":["../src/internal/responses-ws-credentials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"responses-ws-credentials.mjs","sourceRoot":"","sources":["../src/internal/responses-ws-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,6BAAyB;AAExD,+EAA+E;AAC/E,MAAM,OAAO,6BAA8B,SAAQ,oBAAoB;IACrE;QACE,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;CACF"}

package/internal/ws-connection-controller.d.mts

@@ -0,0 +1,95 @@
+import type { WebSocketLike } from "./ws-adapter.mjs";
+import type { RawWebSocketData, ReconnectingEvent, ReconnectingOverrides, UnsentMessage, WebSocketStreamOptions } from "./ws.mjs";
+export interface WebSocketReconnectOptions<TParameters> {
+    onReconnecting: ((event: ReconnectingEvent<TParameters>) => ReconnectingOverrides<TParameters>) | ((event: ReconnectingEvent<TParameters>) => void);
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+}
+export interface WebSocketConnectionOptions<TParameters> {
+    reconnect?: WebSocketReconnectOptions<TParameters> | null | undefined;
+    maxQueueSize?: number | undefined;
+}
+export type WebSocketStreamMessage<TClientEvent, TServerEvent, TError, TParameters> = {
+    type: 'connecting' | 'open' | 'closing';
+} | {
+    type: 'close';
+    code: number;
+    reason: string;
+    unsent: UnsentMessage<TClientEvent>[];
+} | {
+    type: 'reconnecting';
+    reconnect: ReconnectingEvent<TParameters>;
+} | {
+    type: 'reconnected';
+} | {
+    type: 'message';
+    message: TServerEvent;
+} | {
+    type: 'raw';
+    data: RawWebSocketData;
+} | {
+    type: 'error';
+    error: TError;
+};
+interface ConnectionOwner<TSocket> {
+    socket: TSocket;
+    url: URL;
+}
+/** API types, decoding and request policy stay with the binding and its SDK helpers. */
+export interface WebSocketConnectionHooks<TSocket, TClientEvent, TServerEvent, TError, TParameters> {
+    buildURL: () => URL;
+    createSocket: (url: URL) => TSocket;
+    parameters: TParameters | null | undefined;
+    isErrorEvent: (event: TServerEvent) => boolean;
+    onMessage: (data: string | ArrayBuffer | ArrayBufferView, isBinary: boolean) => void;
+    onSocketError?: (socket: TSocket, error: Error) => void;
+    onError: (message: string, cause?: unknown) => void;
+    createError: (message: string) => TError;
+    subscribe: (onEvent: (event: TServerEvent) => void, onRaw: (data: RawWebSocketData) => void, onError: (error: TError) => void) => void;
+    unsubscribe: (onEvent: (event: TServerEvent) => void, onRaw: (data: RawWebSocketData) => void, onError: (error: TError) => void) => void;
+    emitReconnecting: (event: ReconnectingEvent<TParameters>) => void;
+    emitReconnected: () => void;
+    emitClose: (code: number, reason: string, unsent: UnsentMessage<TClientEvent>[]) => void;
+    /** Existing transports with async credential refresh cancel it when close wins. */
+    prepareReconnectSocket?: () => Promise<(url: URL) => TSocket>;
+    /** Preserve whether a failed queued write remains in the legacy unsent list. */
+    requeueFailed?: boolean;
+}
+type WebSocketParameters = NonNullable<ReconnectingEvent['parameters']>;
+/** Shared connection lifecycle; public fields and event listeners remain on the binding. */
+export declare class WebSocketConnection<TSocket extends WebSocketLike, TClientEvent, TServerEvent, TError extends Error, TParameters extends WebSocketParameters = WebSocketParameters> {
+    private _reconnectOptions;
+    private _sendQueue;
+    private _isReconnecting;
+    private _intentionallyClosed;
+    private _closeCode;
+    private _closeReason;
+    private _lastCloseCode;
+    private _lastCloseReason;
+    private _internalEvents;
+    private readonly _owner;
+    private readonly _hooks;
+    constructor(owner: ConnectionOwner<TSocket>, hooks: WebSocketConnectionHooks<TSocket, TClientEvent, TServerEvent, TError, TParameters>, options?: WebSocketConnectionOptions<TParameters>);
+    private _cancelRefresh;
+    send(event: TClientEvent): void;
+    sendRaw(data: RawWebSocketData): void;
+    close(props?: {
+        code: number;
+        reason: string;
+    }): void;
+    iterate(options?: WebSocketStreamOptions): AsyncIterableIterator<WebSocketStreamMessage<TClientEvent, TServerEvent, TError, TParameters>>;
+    connect(createSocket?: (url: URL) => TSocket, url?: URL): TSocket;
+    private _canReconnect;
+    private _abortReconnect;
+    private _notifyReconnecting;
+    private _reconnect;
+    private _flushSendQueue;
+    /**
+     * Emits the public `close` event with unsent messages and the internal
+     * `close` event used by the async iterator.
+     */
+    private _emitPermanentClose;
+}
+export {};
+//# sourceMappingURL=ws-connection-controller.d.mts.map

package/internal/ws-connection-controller.d.mts.map

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

package/internal/ws-connection-controller.d.ts

@@ -0,0 +1,95 @@
+import type { WebSocketLike } from "./ws-adapter.js";
+import type { RawWebSocketData, ReconnectingEvent, ReconnectingOverrides, UnsentMessage, WebSocketStreamOptions } from "./ws.js";
+export interface WebSocketReconnectOptions<TParameters> {
+    onReconnecting: ((event: ReconnectingEvent<TParameters>) => ReconnectingOverrides<TParameters>) | ((event: ReconnectingEvent<TParameters>) => void);
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+}
+export interface WebSocketConnectionOptions<TParameters> {
+    reconnect?: WebSocketReconnectOptions<TParameters> | null | undefined;
+    maxQueueSize?: number | undefined;
+}
+export type WebSocketStreamMessage<TClientEvent, TServerEvent, TError, TParameters> = {
+    type: 'connecting' | 'open' | 'closing';
+} | {
+    type: 'close';
+    code: number;
+    reason: string;
+    unsent: UnsentMessage<TClientEvent>[];
+} | {
+    type: 'reconnecting';
+    reconnect: ReconnectingEvent<TParameters>;
+} | {
+    type: 'reconnected';
+} | {
+    type: 'message';
+    message: TServerEvent;
+} | {
+    type: 'raw';
+    data: RawWebSocketData;
+} | {
+    type: 'error';
+    error: TError;
+};
+interface ConnectionOwner<TSocket> {
+    socket: TSocket;
+    url: URL;
+}
+/** API types, decoding and request policy stay with the binding and its SDK helpers. */
+export interface WebSocketConnectionHooks<TSocket, TClientEvent, TServerEvent, TError, TParameters> {
+    buildURL: () => URL;
+    createSocket: (url: URL) => TSocket;
+    parameters: TParameters | null | undefined;
+    isErrorEvent: (event: TServerEvent) => boolean;
+    onMessage: (data: string | ArrayBuffer | ArrayBufferView, isBinary: boolean) => void;
+    onSocketError?: (socket: TSocket, error: Error) => void;
+    onError: (message: string, cause?: unknown) => void;
+    createError: (message: string) => TError;
+    subscribe: (onEvent: (event: TServerEvent) => void, onRaw: (data: RawWebSocketData) => void, onError: (error: TError) => void) => void;
+    unsubscribe: (onEvent: (event: TServerEvent) => void, onRaw: (data: RawWebSocketData) => void, onError: (error: TError) => void) => void;
+    emitReconnecting: (event: ReconnectingEvent<TParameters>) => void;
+    emitReconnected: () => void;
+    emitClose: (code: number, reason: string, unsent: UnsentMessage<TClientEvent>[]) => void;
+    /** Existing transports with async credential refresh cancel it when close wins. */
+    prepareReconnectSocket?: () => Promise<(url: URL) => TSocket>;
+    /** Preserve whether a failed queued write remains in the legacy unsent list. */
+    requeueFailed?: boolean;
+}
+type WebSocketParameters = NonNullable<ReconnectingEvent['parameters']>;
+/** Shared connection lifecycle; public fields and event listeners remain on the binding. */
+export declare class WebSocketConnection<TSocket extends WebSocketLike, TClientEvent, TServerEvent, TError extends Error, TParameters extends WebSocketParameters = WebSocketParameters> {
+    private _reconnectOptions;
+    private _sendQueue;
+    private _isReconnecting;
+    private _intentionallyClosed;
+    private _closeCode;
+    private _closeReason;
+    private _lastCloseCode;
+    private _lastCloseReason;
+    private _internalEvents;
+    private readonly _owner;
+    private readonly _hooks;
+    constructor(owner: ConnectionOwner<TSocket>, hooks: WebSocketConnectionHooks<TSocket, TClientEvent, TServerEvent, TError, TParameters>, options?: WebSocketConnectionOptions<TParameters>);
+    private _cancelRefresh;
+    send(event: TClientEvent): void;
+    sendRaw(data: RawWebSocketData): void;
+    close(props?: {
+        code: number;
+        reason: string;
+    }): void;
+    iterate(options?: WebSocketStreamOptions): AsyncIterableIterator<WebSocketStreamMessage<TClientEvent, TServerEvent, TError, TParameters>>;
+    connect(createSocket?: (url: URL) => TSocket, url?: URL): TSocket;
+    private _canReconnect;
+    private _abortReconnect;
+    private _notifyReconnecting;
+    private _reconnect;
+    private _flushSendQueue;
+    /**
+     * Emits the public `close` event with unsent messages and the internal
+     * `close` event used by the async iterator.
+     */
+    private _emitPermanentClose;
+}
+export {};
+//# sourceMappingURL=ws-connection-controller.d.ts.map

package/internal/ws-connection-controller.d.ts.map

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