openai 7.3.0 → 7.5.0

package/core/streaming.mjs

@@ -1,20 +1,33 @@
 var _Stream_client;
 import { __classPrivateFieldGet, __classPrivateFieldSet } from "../internal/tslib.mjs";
-import { OpenAIError } from "./error.mjs";
-import { makeReadableStream } from "../internal/shims.mjs";
+import { OpenAIError, APIError } from "./error.mjs";
+import { makeReadableStream, ReadableStreamToAsyncIterable } from "../internal/shims.mjs";
 import { findDoubleNewlineIndex, LineDecoder } from "../internal/decoders/line.mjs";
-import { ReadableStreamToAsyncIterable } from "../internal/shims.mjs";
 import { isAbortError } from "../internal/errors.mjs";
 import { encodeUTF8 } from "../internal/utils/bytes.mjs";
 import { loggerFor } from "../internal/utils/log.mjs";
-import { APIError } from "./error.mjs";
+/**
+ * A single-consumption asynchronous API response stream.
+ *
+ * Use {@link Stream.tee} when two consumers need the same events. Breaking out of
+ * a response-backed stream early aborts its request; branches created by `tee()`
+ * instead share {@link Stream.controller} for explicit cancellation.
+ */
 export class Stream {
+    /** Wraps an asynchronous event iterator and the controller that owns its request. */
     constructor(iterator, controller, client) {
-        this.iterator = iterator;
         _Stream_client.set(this, void 0);
+        this.iterator = iterator;
         this.controller = controller;
         __classPrivateFieldSet(this, _Stream_client, client, "f");
     }
+    /**
+     * Decodes an SSE response into parsed JSON events.
+     *
+     * The resulting stream can be consumed only once, ignores events after `[DONE]`, and
+     * surfaces API error payloads as `APIError` instances. When
+     * `synthesizeEventData` is enabled, each item also includes its SSE event name.
+     */
     static fromSSEResponse(response, controller, client, synthesizeEventData) {
         let consumed = false;
         const logger = client ? loggerFor(client) : console;
@@ -24,13 +37,12 @@ export class Stream {
             }
             consumed = true;
             let done = false;
+            let receivedCompletionSentinel = false;
             try {
                 for await (const sse of _iterSSEMessages(response, controller)) {
-                    if (done)
-                        continue;
                     if (sse.data.startsWith('[DONE]')) {
-                        done = true;
-                        continue;
+                        receivedCompletionSentinel = true;
+                        break;
                     }
                     if (sse.event === null || !sse.event.startsWith('thread.')) {
                         let data;
@@ -57,25 +69,29 @@ export class Stream {
                             console.error(`From chunk:`, sse.raw);
                             throw e;
                         }
-                        // TODO: Is this where the error should be thrown?
-                        if (sse.event == 'error') {
+                        // SSE error events surface as APIError instances.
+                        if (sse.event === 'error') {
                             throw new APIError(undefined, data.error, data.message, undefined);
                         }
-                        yield { event: sse.event, data: data };
+                        yield { event: sse.event, data };
                     }
                 }
                 done = true;
             }
             catch (e) {
-                // If the user calls `stream.controller.abort()`, we should exit without throwing.
-                if (isAbortError(e))
+                // Abort errors and cleanup failures after the completion sentinel are non-fatal.
+                if (receivedCompletionSentinel ||
+                    isAbortError(e) ||
+                    (controller.signal.aborted && e === controller.signal.reason)) {
                     return;
+                }
                 throw e;
             }
             finally {
                 // If the user `break`s, abort the ongoing request.
-                if (!done)
+                if (!done) {
                     controller.abort();
+                }
             }
         }
         return new Stream(iterator, controller, client);
@@ -93,7 +109,7 @@ export class Stream {
             let cancelPromise;
             const cancel = () => {
                 cancelPromise ?? (cancelPromise = reader.cancel());
-                cancelPromise.catch(() => { });
+                cancelPromise.catch(() => undefined);
             };
             controller.signal.addEventListener('abort', cancel, { once: true });
             try {
@@ -107,26 +123,31 @@ export class Stream {
                         closed = true;
                         break;
                     }
-                    if (controller.signal.aborted)
+                    if (controller.signal.aborted) {
                         return;
+                    }
                     for (const line of lineDecoder.decode(chunk)) {
-                        if (controller.signal.aborted)
+                        if (controller.signal.aborted) {
                             return;
+                        }
                         yield line;
                     }
                 }
-                if (controller.signal.aborted)
+                if (controller.signal.aborted) {
                     return;
+                }
                 for (const line of lineDecoder.flush()) {
-                    if (controller.signal.aborted)
+                    if (controller.signal.aborted) {
                         return;
+                    }
                     yield line;
                 }
             }
             finally {
                 controller.signal.removeEventListener('abort', cancel);
-                if (!closed)
+                if (!closed) {
                     cancel();
+                }
                 reader.releaseLock();
             }
         }
@@ -138,27 +159,32 @@ export class Stream {
             let done = false;
             try {
                 for await (const line of iterLines()) {
-                    if (done)
+                    if (done) {
                         continue;
-                    if (line)
+                    }
+                    if (line) {
                         yield JSON.parse(line);
+                    }
                 }
                 done = true;
             }
             catch (e) {
                 // If the user calls `stream.controller.abort()`, we should exit without throwing.
-                if (controller.signal.aborted || isAbortError(e))
+                if (controller.signal.aborted || isAbortError(e)) {
                     return;
+                }
                 throw e;
             }
             finally {
                 // If the user `break`s, abort the ongoing request.
-                if (!done)
+                if (!done) {
                     controller.abort();
+                }
             }
         }
         return new Stream(iterator, controller, client);
     }
+    /** Starts consuming this stream; attempting to consume it again throws. */
     [(_Stream_client = new WeakMap(), Symbol.asyncIterator)]() {
         return this.iterator();
     }
@@ -170,18 +196,16 @@ export class Stream {
         const left = [];
         const right = [];
         const iterator = this.iterator();
-        const teeIterator = (queue) => {
-            return {
-                next: () => {
-                    if (queue.length === 0) {
-                        const result = iterator.next();
-                        left.push(result);
-                        right.push(result);
-                    }
-                    return queue.shift();
-                },
-            };
-        };
+        const teeIterator = (queue) => ({
+            next: () => {
+                if (queue.length === 0) {
+                    const result = iterator.next();
+                    left.push(result);
+                    right.push(result);
+                }
+                return queue.shift();
+            },
+        });
         return [
             new Stream(() => teeIterator(left), this.controller, __classPrivateFieldGet(this, _Stream_client, "f")),
             new Stream(() => teeIterator(right), this.controller, __classPrivateFieldGet(this, _Stream_client, "f")),
@@ -193,17 +217,17 @@ export class Stream {
      * which can be turned back into a Stream with `Stream.fromReadableStream()`.
      */
     toReadableStream() {
-        const self = this;
         let iter;
         return makeReadableStream({
-            async start() {
-                iter = self[Symbol.asyncIterator]();
+            start: async () => {
+                iter = this[Symbol.asyncIterator]();
             },
             async pull(ctrl) {
                 try {
                     const { value, done } = await iter.next();
-                    if (done)
+                    if (done) {
                         return ctrl.close();
+                    }
                     const bytes = encodeUTF8(JSON.stringify(value) + '\n');
                     ctrl.enqueue(bytes);
                 }
@@ -217,10 +241,15 @@ export class Stream {
         });
     }
 }
+/**
+ * Decodes complete SSE records from a response and aborts when its body is absent.
+ *
+ * @yields {ServerSentEvent} Each decoded server-sent event in wire order.
+ */
 export async function* _iterSSEMessages(response, controller) {
     if (!response.body) {
         controller.abort();
-        if (typeof globalThis.navigator !== 'undefined' &&
+        if (globalThis.navigator !== undefined &&
             globalThis.navigator.product === 'ReactNative') {
             throw new OpenAIError(`The default react-native fetch implementation does not support streaming. Please use expo/fetch: https://docs.expo.dev/versions/latest/sdk/expo/#expofetch-api`);
         }
@@ -232,41 +261,73 @@ export async function* _iterSSEMessages(response, controller) {
     for await (const sseChunk of iterSSEChunks(iter)) {
         for (const line of lineDecoder.decode(sseChunk)) {
             const sse = sseDecoder.decode(line);
-            if (sse)
+            if (sse) {
                 yield sse;
+            }
         }
     }
     for (const line of lineDecoder.flush()) {
         const sse = sseDecoder.decode(line);
-        if (sse)
+        if (sse) {
             yield sse;
+        }
     }
 }
+// A `\r\n\r\n` separator may retain up to three bytes from the previous chunk.
+const DOUBLE_NEWLINE_DELIMITER_MAX_OVERLAP_BYTES = 3;
 /**
  * Given an async iterable iterator, iterates over it and yields full
  * SSE chunks, i.e. yields when a double new-line is encountered.
+ *
+ * @yields {Uint8Array} A complete SSE chunk.
  */
 async function* iterSSEChunks(iterator) {
     let data = new Uint8Array();
+    let dataStart = 0;
+    let dataEnd = 0;
+    let searchStartIndex = 0;
     for await (const chunk of iterator) {
         if (chunk == null) {
             continue;
         }
-        const binaryChunk = chunk instanceof ArrayBuffer ? new Uint8Array(chunk)
-            : typeof chunk === 'string' ? encodeUTF8(chunk)
-                : chunk;
-        let newData = new Uint8Array(data.length + binaryChunk.length);
-        newData.set(data);
-        newData.set(binaryChunk, data.length);
-        data = newData;
+        let binaryChunk;
+        if (chunk instanceof ArrayBuffer) {
+            binaryChunk = new Uint8Array(chunk);
+        }
+        else if (typeof chunk === 'string') {
+            binaryChunk = encodeUTF8(chunk);
+        }
+        else {
+            binaryChunk = chunk;
+        }
+        if (dataEnd + binaryChunk.length > data.length) {
+            const bufferedLength = dataEnd - dataStart;
+            // Compact only when it reclaims substantial space without moving a large live tail repeatedly.
+            if (dataStart >= data.length / 2 && bufferedLength + binaryChunk.length <= data.length) {
+                data.copyWithin(0, dataStart, dataEnd);
+            }
+            else {
+                const newData = new Uint8Array(Math.max(data.length * 2, bufferedLength + binaryChunk.length));
+                newData.set(data.subarray(dataStart, dataEnd));
+                data = newData;
+            }
+            searchStartIndex -= dataStart;
+            dataStart = 0;
+            dataEnd = bufferedLength;
+        }
+        data.set(binaryChunk, dataEnd);
+        dataEnd += binaryChunk.length;
         let patternIndex;
-        while ((patternIndex = findDoubleNewlineIndex(data)) !== -1) {
-            yield data.slice(0, patternIndex);
-            data = data.slice(patternIndex);
+        while ((patternIndex = findDoubleNewlineIndex(data.subarray(searchStartIndex, dataEnd))) !== -1) {
+            patternIndex += searchStartIndex;
+            yield data.slice(dataStart, patternIndex);
+            dataStart = patternIndex;
+            searchStartIndex = dataStart;
         }
+        searchStartIndex = Math.max(dataStart, dataEnd - DOUBLE_NEWLINE_DELIMITER_MAX_OVERLAP_BYTES);
     }
-    if (data.length > 0) {
-        yield data;
+    if (dataEnd > dataStart) {
+        yield data.slice(dataStart, dataEnd);
     }
 }
 class SSEDecoder {
@@ -277,12 +338,13 @@ class SSEDecoder {
     }
     decode(line) {
         if (line.endsWith('\r')) {
-            line = line.substring(0, line.length - 1);
+            line = line.slice(0, -1);
         }
         if (!line) {
             // empty line and we didn't previously encounter any messages
-            if (!this.event && !this.data.length)
+            if (!this.event && !this.data.length) {
                 return null;
+            }
             const sse = {
                 event: this.event,
                 data: this.data.join('\n'),
@@ -297,9 +359,10 @@ class SSEDecoder {
         if (line.startsWith(':')) {
             return null;
         }
-        let [fieldname, _, value] = partition(line, ':');
+        const [fieldname, , initialValue] = partition(line, ':');
+        let value = initialValue;
         if (value.startsWith(' ')) {
-            value = value.substring(1);
+            value = value.slice(1);
         }
         if (fieldname === 'event') {
             this.event = value;
@@ -313,7 +376,7 @@ class SSEDecoder {
 function partition(str, delimiter) {
     const index = str.indexOf(delimiter);
     if (index !== -1) {
-        return [str.substring(0, index), delimiter, str.substring(index + delimiter.length)];
+        return [str.slice(0, index), delimiter, str.slice(index + delimiter.length)];
     }
     return [str, '', ''];
 }

package/core/streaming.mjs.map

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

package/helpers/audio.d.mts

@@ -1,9 +1,38 @@
+/**
+ * Plays audio from a Node.js readable stream, fetch response, or `File`.
+ *
+ * This helper is supported only in Node.js-compatible runtimes and requires
+ * the `ffplay` executable from FFmpeg to be available on `PATH`. Audio is
+ * streamed to `ffplay` without first buffering the complete input.
+ *
+ * @param input Audio data in a format recognized by `ffplay`.
+ * @throws {Error} If playback is unsupported, `ffplay` cannot start or exits
+ * unsuccessfully, the response has no body, or reading the audio input fails.
+ */
 export declare function playAudio(input: NodeJS.ReadableStream | Response | File): Promise<void>;
+/** Controls microphone selection and when an in-progress recording is finalized. */
 type RecordAudioOptions = {
+    /** Stops recording when aborted and resolves with the audio captured so far. */
     signal?: AbortSignal;
+    /** Zero-based audio-input device number passed to FFmpeg; defaults to `0`. */
     device?: number;
+    /** Positive recording duration in milliseconds; nonpositive values disable the timeout. */
     timeout?: number;
 };
+/**
+ * Records microphone audio into a mono, 24 kHz WAV `File` named `audio.wav`.
+ *
+ * This helper is supported only in Node.js-compatible runtimes and requires
+ * the `ffmpeg` executable from FFmpeg to be available on `PATH`. Recording
+ * continues until the FFmpeg process exits, the supplied signal is aborted, or
+ * a positive timeout elapses. Aborting or timing out finalizes and returns the
+ * audio captured so far instead of rejecting.
+ *
+ * @param options Audio-input device, optional abort signal, and recording timeout.
+ * @returns The captured WAV file with MIME type `audio/wav`.
+ * @throws {Error} If recording is unsupported, `ffmpeg` cannot start, or the
+ * recording process exits unsuccessfully before an intentional stop.
+ */
 export declare function recordAudio(options?: RecordAudioOptions): Promise<File>;
 export {};
 //# sourceMappingURL=audio.d.mts.map

package/helpers/audio.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.mts","sourceRoot":"","sources":["../src/helpers/audio.ts"],"names":[],"mappings":"AAwEA,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;AAED,KAAK,kBAAkB,GAAG;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAiEF,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,iBAQjE"}
+{"version":3,"file":"audio.d.mts","sourceRoot":"","sources":["../src/helpers/audio.ts"],"names":[],"mappings":"AA+EA;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;AAED,oFAAoF;AACpF,KAAK,kBAAkB,GAAG;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAsGF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF"}

package/helpers/audio.d.ts

@@ -1,9 +1,38 @@
+/**
+ * Plays audio from a Node.js readable stream, fetch response, or `File`.
+ *
+ * This helper is supported only in Node.js-compatible runtimes and requires
+ * the `ffplay` executable from FFmpeg to be available on `PATH`. Audio is
+ * streamed to `ffplay` without first buffering the complete input.
+ *
+ * @param input Audio data in a format recognized by `ffplay`.
+ * @throws {Error} If playback is unsupported, `ffplay` cannot start or exits
+ * unsuccessfully, the response has no body, or reading the audio input fails.
+ */
 export declare function playAudio(input: NodeJS.ReadableStream | Response | File): Promise<void>;
+/** Controls microphone selection and when an in-progress recording is finalized. */
 type RecordAudioOptions = {
+    /** Stops recording when aborted and resolves with the audio captured so far. */
     signal?: AbortSignal;
+    /** Zero-based audio-input device number passed to FFmpeg; defaults to `0`. */
     device?: number;
+    /** Positive recording duration in milliseconds; nonpositive values disable the timeout. */
     timeout?: number;
 };
+/**
+ * Records microphone audio into a mono, 24 kHz WAV `File` named `audio.wav`.
+ *
+ * This helper is supported only in Node.js-compatible runtimes and requires
+ * the `ffmpeg` executable from FFmpeg to be available on `PATH`. Recording
+ * continues until the FFmpeg process exits, the supplied signal is aborted, or
+ * a positive timeout elapses. Aborting or timing out finalizes and returns the
+ * audio captured so far instead of rejecting.
+ *
+ * @param options Audio-input device, optional abort signal, and recording timeout.
+ * @returns The captured WAV file with MIME type `audio/wav`.
+ * @throws {Error} If recording is unsupported, `ffmpeg` cannot start, or the
+ * recording process exits unsuccessfully before an intentional stop.
+ */
 export declare function recordAudio(options?: RecordAudioOptions): Promise<File>;
 export {};
 //# sourceMappingURL=audio.d.ts.map

package/helpers/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/helpers/audio.ts"],"names":[],"mappings":"AAwEA,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;AAED,KAAK,kBAAkB,GAAG;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAiEF,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,iBAQjE"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/helpers/audio.ts"],"names":[],"mappings":"AA+EA;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;AAED,oFAAoF;AACpF,KAAK,kBAAkB,GAAG;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAsGF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF"}