openai 7.23.0 → 7.25.0

package/lib/responses/responses-websocket-accumulator.mjs

@@ -0,0 +1,287 @@
+var _ResponsesWebSocketAccumulator_instances, _a, _ResponsesWebSocketAccumulator_context, _ResponsesWebSocketAccumulator_current, _ResponsesWebSocketAccumulator_at, _ResponsesWebSocketAccumulator_copyOutput, _ResponsesWebSocketAccumulator_validateOutputScaffold, _ResponsesWebSocketAccumulator_validateContentPart, _ResponsesWebSocketAccumulator_validateOutputEvent, _ResponsesWebSocketAccumulator_start;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "../../internal/tslib.mjs";
+import { OpenAIError } from "../../core/error.mjs";
+import { ensureCanonicalOutputText, getOutputText } from "../../internal/responses/canonical-output-text.mjs";
+import { accumulateWebSocketOutput, cloneValidatedResponse, createResponseContext, isResponseOutputEvent, } from "../../internal/responses/response-accumulator.mjs";
+import { hasOwn } from "../../internal/utils.mjs";
+import { isObj } from "../../internal/utils/values.mjs";
+// Keep the raw boundary aligned with the generated discriminants. Future wire
+// items still belong to the raw lane and authoritative terminal event.
+const outputItemTypes = {
+    message: true,
+    file_search_call: true,
+    function_call: true,
+    function_call_output: true,
+    web_search_call: true,
+    computer_call: true,
+    computer_call_output: true,
+    reasoning: true,
+    program: true,
+    program_output: true,
+    tool_search_call: true,
+    tool_search_output: true,
+    additional_tools: true,
+    compaction: true,
+    image_generation_call: true,
+    code_interpreter_call: true,
+    local_shell_call: true,
+    local_shell_call_output: true,
+    shell_call: true,
+    shell_call_output: true,
+    apply_patch_call: true,
+    apply_patch_call_output: true,
+    mcp_call: true,
+    mcp_list_tools: true,
+    mcp_approval_request: true,
+    mcp_approval_response: true,
+    custom_tool_call: true,
+    custom_tool_call_output: true,
+};
+/**
+ * Optional, caller-fed reconstruction of one lane's provisional output.
+ *
+ * Feed the raw events returned by lane.receive(). Use a separate instance per
+ * lane. This helper never reads, sends, closes, or registers a listener on a
+ * socket; raw events remain in the caller's hands. Tools remain output data.
+ * Provisional response metadata is preserved as received and is not yet schema
+ * validated. Narrow its unknown fields before use. Omitted fields remain absent.
+ * Raw deltas give per-event progress. Use outputAt(event.output_index) when an
+ * item finishes, or pass its content_index/summary_index to read only a changed
+ * part. For citations use content_index and annotation_index together. A full
+ * current, item, or part read materializes its entire nested contents, so
+ * reserve those reads for when that complete snapshot is needed.
+ *
+ * A socket stream can omit the item/content scaffolding required for deltas.
+ * Such a response is marked unavailable until the next creation or terminal
+ * event. Terminal events, including failures and errors, are retained exactly as
+ * delivered, without filling omitted output from provisional data.
+ */
+export class ResponsesWebSocketAccumulator {
+    constructor() {
+        _ResponsesWebSocketAccumulator_instances.add(this);
+        _ResponsesWebSocketAccumulator_context.set(this, createResponseContext());
+        _ResponsesWebSocketAccumulator_current.set(this, void 0);
+    }
+    /** Materialize the full state. For per-item progress prefer outputAt(). */
+    get current() {
+        if (__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f")?.phase === 'provisional') {
+            if (__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_context, "f").outputTextDirty) {
+                __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f").snapshot.output_text = __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f").snapshot.output
+                    .map((output) => getOutputText(__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_context, "f"), output))
+                    .join('');
+                __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_context, "f").outputTextDirty = false;
+            }
+            return {
+                phase: 'provisional',
+                snapshot: __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_copyOutput).call(_a, __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f").snapshot),
+            };
+        }
+        return structuredClone(__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f"));
+    }
+    // oxlint-disable-next-line anti-slop/no-unknown-returns -- Only the generated output discriminator is validated; every raw nested value must remain unknown to callers.
+    outputAt(outputIndex, part) {
+        if (__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f")?.phase !== 'provisional') {
+            return undefined;
+        }
+        const output = __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_at).call(_a, __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f").snapshot.output, outputIndex);
+        if (!part) {
+            return __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_copyOutput).call(_a, output);
+        }
+        if ('content_index' in part) {
+            if (output?.type === 'message' || output?.type === 'reasoning') {
+                const content = __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_at).call(_a, output.content, part.content_index);
+                if ('annotation_index' in part) {
+                    return __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_copyOutput).call(_a, content?.type === 'output_text'
+                        ? __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_at).call(_a, content.annotations, part.annotation_index)
+                        : undefined);
+                }
+                return __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_copyOutput).call(_a, content);
+            }
+        }
+        else if (output?.type === 'reasoning') {
+            return __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_copyOutput).call(_a, __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_at).call(_a, output.summary, part.summary_index));
+        }
+        return undefined;
+    }
+    /** Drop retained provisional and terminal state without affecting any lane. */
+    reset() {
+        __classPrivateFieldSet(this, _ResponsesWebSocketAccumulator_context, createResponseContext(), "f");
+        __classPrivateFieldSet(this, _ResponsesWebSocketAccumulator_current, undefined, "f");
+    }
+    /** Record one raw lane event. Unknown event types leave the current state unchanged. */
+    add(event) {
+        if (event.type === 'response.completed' ||
+            event.type === 'response.failed' ||
+            event.type === 'response.incomplete' ||
+            event.type === 'error') {
+            __classPrivateFieldSet(this, _ResponsesWebSocketAccumulator_context, createResponseContext(), "f");
+            __classPrivateFieldSet(this, _ResponsesWebSocketAccumulator_current, { phase: 'terminal', event: structuredClone(event) }, "f");
+            return;
+        }
+        try {
+            if (event.type === 'response.created') {
+                __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_instances, "m", _ResponsesWebSocketAccumulator_start).call(this, { response: event.response });
+                return;
+            }
+            if (!isResponseOutputEvent(event) ||
+                __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f")?.phase === 'unavailable' ||
+                __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f")?.phase === 'terminal') {
+                return;
+            }
+            if (__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f")?.phase !== 'provisional') {
+                throw new OpenAIError("Cannot reconstruct WebSocket output before 'response.created'");
+            }
+            const outputEvent = structuredClone(event);
+            __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_validateOutputEvent).call(_a, outputEvent);
+            accumulateWebSocketOutput(outputEvent, __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_current, "f").snapshot, __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_context, "f"));
+        }
+        catch (error) {
+            __classPrivateFieldSet(this, _ResponsesWebSocketAccumulator_current, {
+                phase: 'unavailable',
+                error: error instanceof Error ? error : new OpenAIError('Invalid Responses WebSocket output event'),
+            }, "f");
+        }
+    }
+}
+_a = ResponsesWebSocketAccumulator, _ResponsesWebSocketAccumulator_context = new WeakMap(), _ResponsesWebSocketAccumulator_current = new WeakMap(), _ResponsesWebSocketAccumulator_instances = new WeakSet(), _ResponsesWebSocketAccumulator_at = function _ResponsesWebSocketAccumulator_at(collection, index) {
+    if (!Array.isArray(collection) || index === undefined || !Number.isSafeInteger(index) || index < 0) {
+        return undefined;
+    }
+    return collection[index];
+}, _ResponsesWebSocketAccumulator_copyOutput = function _ResponsesWebSocketAccumulator_copyOutput(value) {
+    if (Array.isArray(value)) {
+        // SAFETY: Copying the array preserves every element's type and order.
+        return value.map((item) => __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_copyOutput).call(_a, item));
+    }
+    if (isObj(value)) {
+        // SAFETY: Copying own data properties preserves the snapshot's JSON shape.
+        // fromEntries defines "__proto__" as an own property instead of invoking a setter.
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_copyOutput).call(_a, item)]));
+    }
+    return value;
+}, _ResponsesWebSocketAccumulator_validateOutputScaffold = function _ResponsesWebSocketAccumulator_validateOutputScaffold(item) {
+    if (!isObj(item) ||
+        !hasOwn(item, 'type') ||
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- An unknown discriminator cannot satisfy the generated typed preview union.
+        typeof item['type'] !== 'string' ||
+        !hasOwn(outputItemTypes, item['type'])) {
+        throw new OpenAIError('Invalid Responses WebSocket output item');
+    }
+    if (item['type'] === 'message') {
+        if (!Array.isArray(item['content'])) {
+            throw new OpenAIError('Invalid Responses WebSocket message content');
+        }
+        for (const part of item['content']) {
+            __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_validateContentPart).call(_a, part);
+        }
+    }
+    if (item['type'] === 'function_call' ||
+        item['type'] === 'custom_tool_call' ||
+        item['type'] === 'mcp_call') {
+        const field = item['type'] === 'custom_tool_call' ? 'input' : 'arguments';
+        if (!hasOwn(item, 'name') ||
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- The caller feeds raw socket events; validate own required tool fields before exposing a typed snapshot.
+            typeof item['name'] !== 'string' ||
+            !hasOwn(item, field) ||
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Missing and numeric tool data cannot be extended as text.
+            typeof item[field] !== 'string') {
+            throw new OpenAIError('Invalid Responses WebSocket tool scaffold');
+        }
+        if (item['type'] === 'mcp_call' &&
+            (!hasOwn(item, 'server_label') ||
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- The server identity on an MCP scaffold is raw data, not a generated decoded string.
+                typeof item['server_label'] !== 'string')) {
+            throw new OpenAIError('Invalid Responses WebSocket MCP server label');
+        }
+    }
+}, _ResponsesWebSocketAccumulator_validateContentPart = function _ResponsesWebSocketAccumulator_validateContentPart(part) {
+    if (!isObj(part) ||
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Raw output_text must not be silently coerced during a later provisional read.
+        (part['type'] === 'output_text' && typeof part['text'] !== 'string')) {
+        throw new OpenAIError('Invalid Responses WebSocket content part');
+    }
+}, _ResponsesWebSocketAccumulator_validateOutputEvent = function _ResponsesWebSocketAccumulator_validateOutputEvent(event) {
+    switch (event.type) {
+        case 'response.output_item.added':
+        case 'response.output_item.done': {
+            __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_validateOutputScaffold).call(_a, event.item);
+            break;
+        }
+        case 'response.content_part.added':
+        case 'response.content_part.done': {
+            __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_validateContentPart).call(_a, event.part);
+            break;
+        }
+        case 'response.function_call_arguments.delta':
+        case 'response.mcp_call_arguments.delta':
+        case 'response.custom_tool_call_input.delta':
+        case 'response.output_text.delta':
+        case 'response.refusal.delta': {
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- The cloned raw event has not been schema-validated; do not coerce data into typed tool arguments.
+            if (typeof event.delta !== 'string') {
+                throw new OpenAIError('Invalid Responses WebSocket tool delta');
+            }
+            break;
+        }
+        case 'response.function_call_arguments.done':
+        case 'response.mcp_call_arguments.done': {
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- A final raw argument payload must satisfy the field exposed by the provisional snapshot.
+            if (typeof event.arguments !== 'string') {
+                throw new OpenAIError('Invalid Responses WebSocket tool arguments');
+            }
+            break;
+        }
+        case 'response.custom_tool_call_input.done': {
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Do not substitute omitted, null or object input for the typed text field.
+            if (typeof event.input !== 'string') {
+                throw new OpenAIError('Invalid Responses WebSocket custom tool input');
+            }
+            break;
+        }
+        case 'response.output_text.done': {
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Only actual wire text can replace the accumulated message text.
+            if (typeof event.text !== 'string') {
+                throw new OpenAIError('Invalid Responses WebSocket completed text');
+            }
+            break;
+        }
+        case 'response.refusal.done': {
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Refusals use their own finalized wire text field.
+            if (typeof event.refusal !== 'string') {
+                throw new OpenAIError('Invalid Responses WebSocket completed refusal');
+            }
+            break;
+        }
+        default: {
+            break;
+        }
+    }
+}, _ResponsesWebSocketAccumulator_start = function _ResponsesWebSocketAccumulator_start(event) {
+    this.reset();
+    if (!isObj(event.response)) {
+        throw new OpenAIError('Responses WebSocket created event must contain a response');
+    }
+    // Only output fields are normalized; omitted response metadata is never invented.
+    const { output, output_text: outputText } = event.response;
+    if ((output !== undefined && !Array.isArray(output)) ||
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Validate optional text from an untyped WebSocket lifecycle before placing it in a typed provisional snapshot.
+        (outputText !== undefined && typeof outputText !== 'string')) {
+        throw new OpenAIError('Invalid Responses WebSocket initial output');
+    }
+    if (output !== undefined) {
+        for (const item of output) {
+            __classPrivateFieldGet(_a, _a, "m", _ResponsesWebSocketAccumulator_validateOutputScaffold).call(_a, item);
+        }
+    }
+    const snapshot = cloneValidatedResponse(__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_context, "f"), {
+        ...event.response,
+        output: output ?? [],
+        output_text: outputText ?? '',
+    });
+    if (outputText === undefined) {
+        ensureCanonicalOutputText(__classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_context, "f"), snapshot);
+    }
+    __classPrivateFieldGet(this, _ResponsesWebSocketAccumulator_context, "f").deferOutputText = true;
+    __classPrivateFieldSet(this, _ResponsesWebSocketAccumulator_current, { phase: 'provisional', snapshot }, "f");
+};
+//# sourceMappingURL=responses-websocket-accumulator.mjs.map

package/lib/responses/responses-websocket-accumulator.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openai",
-  "version": "7.23.0",
+  "version": "7.25.0",
   "description": "The official TypeScript library for the OpenAI API",
   "author": "OpenAI <support@openai.com>",
   "types": "./index.d.ts",

package/realtime/translations/ws.d.mts

@@ -0,0 +1,84 @@
+import * as WS from 'ws';
+import type { OpenAI } from "../../client.mjs";
+import { EventEmitter } from "../../lib/EventEmitter.mjs";
+import { NodeWebSocket } from "../../internal/ws-adapter-node.mjs";
+import type { RealtimeTranslationClientEvent, RealtimeTranslationServerEvent } from "../../resources/realtime/realtime.mjs";
+import { OpenAIRealtimeError } from "../internal-base.mjs";
+/** An event envelope, including event types added by the service in the future. */
+export interface RealtimeTranslationEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/** Options for a Node.js translation session. */
+export interface RealtimeTranslationConnectOptions {
+    /** Translation model used to create the session. */
+    model: string;
+    /** Node `ws` options. Redirects are always disabled. */
+    options?: (Omit<WS.ClientOptions, 'headers'> & {
+        /** Case-insensitive overrides; null removes a default and undefined preserves it. */
+        headers?: Record<string, string | null | undefined> | undefined;
+    }) | undefined;
+}
+type TranslationEvents = {
+    event: (event: RealtimeTranslationServerEvent | RealtimeTranslationEvent) => void;
+    error: (error: OpenAIRealtimeError) => void;
+} & {
+    [Type in Exclude<RealtimeTranslationServerEvent['type'], 'error'>]: (event: Extract<RealtimeTranslationServerEvent, {
+        type: Type;
+    }>) => void;
+};
+/**
+ * Node.js translation WebSocket. Install the optional `ws` peer dependency.
+ * Wait for `socket` to open before sending. Events are never buffered or replayed.
+ * Compression is off by default; set `options.perMessageDeflate` to opt in.
+ */
+export declare class OpenAIRealtimeTranslationWS extends EventEmitter<TranslationEvents> {
+    /** Adapter exposing lifecycle events and the underlying Node socket as `platformSocket`. */
+    readonly socket: NodeWebSocket;
+    /** The configured endpoint and model for this connection. */
+    readonly url: URL;
+    /** Sends the protocol close once; use `finish` to await trailing output. */
+    readonly session: {
+        close: () => void;
+    };
+    private _inputClosed;
+    private _terminalReceived;
+    private _terminalDelivered;
+    private _transportClosed;
+    private _failure;
+    private _finishPromise;
+    private _resolveFinish;
+    private _rejectFinish;
+    private _finishTimer;
+    private _closeTimer;
+    private _signal;
+    private constructor();
+    /** Resolves the API key and starts connecting; resolves before the socket opens. */
+    static create(client: OpenAI, props: RealtimeTranslationConnectOptions): Promise<OpenAIRealtimeTranslationWS>;
+    /** Sends a typed event, future event envelope, or raw JSON envelope after the socket opens. */
+    send(event: RealtimeTranslationClientEvent | RealtimeTranslationEvent | string): void;
+    /**
+     * Stops input, sends `session.close` once, and delivers all events through `session.closed`.
+     * The first call owns the finite deadline and optional cancellation signal. Repeated calls
+     * share its result. API error events remain observable and do not end the drain.
+     * A timeout, abort, or transport failure rejects; no connection or input is replayed.
+     * Resolves after terminal delivery and transport closure. The deadline includes transport
+     * cleanup; a stalled close handshake is terminated and rejects the operation.
+     */
+    finish({ timeoutMs, signal }: {
+        timeoutMs: number;
+        signal?: AbortSignal | undefined;
+    }): Promise<void>;
+    /** Closes the transport without waiting for terminal output. Prefer `finish` for a complete session. */
+    close(): void;
+    private _onMessage;
+    private _onError;
+    private _reportError;
+    private _onClose;
+    private _onAbort;
+    private _fail;
+    private _settleFinish;
+    private _closeTransport;
+}
+export {};
+//# sourceMappingURL=ws.d.mts.map

package/realtime/translations/ws.d.mts.map

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

package/realtime/translations/ws.d.ts

@@ -0,0 +1,84 @@
+import * as WS from 'ws';
+import type { OpenAI } from "../../client.js";
+import { EventEmitter } from "../../lib/EventEmitter.js";
+import { NodeWebSocket } from "../../internal/ws-adapter-node.js";
+import type { RealtimeTranslationClientEvent, RealtimeTranslationServerEvent } from "../../resources/realtime/realtime.js";
+import { OpenAIRealtimeError } from "../internal-base.js";
+/** An event envelope, including event types added by the service in the future. */
+export interface RealtimeTranslationEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/** Options for a Node.js translation session. */
+export interface RealtimeTranslationConnectOptions {
+    /** Translation model used to create the session. */
+    model: string;
+    /** Node `ws` options. Redirects are always disabled. */
+    options?: (Omit<WS.ClientOptions, 'headers'> & {
+        /** Case-insensitive overrides; null removes a default and undefined preserves it. */
+        headers?: Record<string, string | null | undefined> | undefined;
+    }) | undefined;
+}
+type TranslationEvents = {
+    event: (event: RealtimeTranslationServerEvent | RealtimeTranslationEvent) => void;
+    error: (error: OpenAIRealtimeError) => void;
+} & {
+    [Type in Exclude<RealtimeTranslationServerEvent['type'], 'error'>]: (event: Extract<RealtimeTranslationServerEvent, {
+        type: Type;
+    }>) => void;
+};
+/**
+ * Node.js translation WebSocket. Install the optional `ws` peer dependency.
+ * Wait for `socket` to open before sending. Events are never buffered or replayed.
+ * Compression is off by default; set `options.perMessageDeflate` to opt in.
+ */
+export declare class OpenAIRealtimeTranslationWS extends EventEmitter<TranslationEvents> {
+    /** Adapter exposing lifecycle events and the underlying Node socket as `platformSocket`. */
+    readonly socket: NodeWebSocket;
+    /** The configured endpoint and model for this connection. */
+    readonly url: URL;
+    /** Sends the protocol close once; use `finish` to await trailing output. */
+    readonly session: {
+        close: () => void;
+    };
+    private _inputClosed;
+    private _terminalReceived;
+    private _terminalDelivered;
+    private _transportClosed;
+    private _failure;
+    private _finishPromise;
+    private _resolveFinish;
+    private _rejectFinish;
+    private _finishTimer;
+    private _closeTimer;
+    private _signal;
+    private constructor();
+    /** Resolves the API key and starts connecting; resolves before the socket opens. */
+    static create(client: OpenAI, props: RealtimeTranslationConnectOptions): Promise<OpenAIRealtimeTranslationWS>;
+    /** Sends a typed event, future event envelope, or raw JSON envelope after the socket opens. */
+    send(event: RealtimeTranslationClientEvent | RealtimeTranslationEvent | string): void;
+    /**
+     * Stops input, sends `session.close` once, and delivers all events through `session.closed`.
+     * The first call owns the finite deadline and optional cancellation signal. Repeated calls
+     * share its result. API error events remain observable and do not end the drain.
+     * A timeout, abort, or transport failure rejects; no connection or input is replayed.
+     * Resolves after terminal delivery and transport closure. The deadline includes transport
+     * cleanup; a stalled close handshake is terminated and rejects the operation.
+     */
+    finish({ timeoutMs, signal }: {
+        timeoutMs: number;
+        signal?: AbortSignal | undefined;
+    }): Promise<void>;
+    /** Closes the transport without waiting for terminal output. Prefer `finish` for a complete session. */
+    close(): void;
+    private _onMessage;
+    private _onError;
+    private _reportError;
+    private _onClose;
+    private _onAbort;
+    private _fail;
+    private _settleFinish;
+    private _closeTransport;
+}
+export {};
+//# sourceMappingURL=ws.d.ts.map

package/realtime/translations/ws.d.ts.map

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