@melara/sdk 0.0.0-stage → 0.1.0

package/esm/lib/realtime.js

@@ -0,0 +1,196 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _RealtimeConnection_socket, _RealtimeConnection_queue, _RealtimeConnection_waiters, _RealtimeConnection_failure, _RealtimeConnection_ended;
+// Modified by Melara for the Melara SDK fork.
+import { en } from "../locales/en.js";
+import { SDK_METADATA, serverURLFromOptions } from "./config.js";
+import { HTTPClient } from "./http.js";
+import { extractSecurity, resolveGlobalSecurity } from "./security.js";
+export class RealtimeError extends Error {
+    constructor(message, code, reason) {
+        super(message);
+        this.code = code;
+        this.reason = reason;
+        this.name = "RealtimeError";
+    }
+}
+const OPEN = 1;
+const NORMAL_CLOSURES = new Set([1000, 1005]);
+/** Unread events a connection holds; past this it ends the session rather than let memory grow without bound. */
+export const REALTIME_QUEUE_LIMIT = 4096;
+const QUEUE_FULL_CLOSE = 4008;
+/** An open Realtime session. Iterate it for server events; it ends when the socket closes. */
+export class RealtimeConnection {
+    constructor(socket) {
+        _RealtimeConnection_socket.set(this, void 0);
+        _RealtimeConnection_queue.set(this, []);
+        _RealtimeConnection_waiters.set(this, []);
+        _RealtimeConnection_failure.set(this, void 0);
+        _RealtimeConnection_ended.set(this, false);
+        __classPrivateFieldSet(this, _RealtimeConnection_socket, socket, "f");
+        socket.onmessage = ({ data }) => {
+            if (typeof data !== "string")
+                return;
+            let event;
+            try {
+                event = JSON.parse(data);
+            }
+            catch {
+                return;
+            }
+            if (event === null || typeof event !== "object" || typeof event.type !== "string")
+                return;
+            const waiter = __classPrivateFieldGet(this, _RealtimeConnection_waiters, "f").shift();
+            if (waiter)
+                waiter({ value: event, done: false });
+            else if (__classPrivateFieldGet(this, _RealtimeConnection_queue, "f").length < REALTIME_QUEUE_LIMIT)
+                __classPrivateFieldGet(this, _RealtimeConnection_queue, "f").push(event);
+            else if (!__classPrivateFieldGet(this, _RealtimeConnection_failure, "f")) {
+                __classPrivateFieldSet(this, _RealtimeConnection_failure, new RealtimeError(en.realtimeQueueFull(REALTIME_QUEUE_LIMIT), QUEUE_FULL_CLOSE), "f");
+                socket.close(QUEUE_FULL_CLOSE, "event_queue_full");
+            }
+        };
+        socket.onclose = ({ code, reason }) => {
+            __classPrivateFieldSet(this, _RealtimeConnection_ended, true, "f");
+            if (!NORMAL_CLOSURES.has(code))
+                __classPrivateFieldSet(this, _RealtimeConnection_failure, __classPrivateFieldGet(this, _RealtimeConnection_failure, "f") ?? new RealtimeError(en.realtimeClosed(code, reason), code, reason), "f");
+            for (const waiter of __classPrivateFieldGet(this, _RealtimeConnection_waiters, "f").splice(0))
+                waiter({ value: undefined, done: true });
+        };
+    }
+    /** The close error, once the session ended abnormally. */
+    get error() {
+        return __classPrivateFieldGet(this, _RealtimeConnection_failure, "f");
+    }
+    send(event) {
+        if (__classPrivateFieldGet(this, _RealtimeConnection_socket, "f").readyState !== OPEN)
+            throw new RealtimeError(en.realtimeNotOpen);
+        __classPrivateFieldGet(this, _RealtimeConnection_socket, "f").send(JSON.stringify(event));
+    }
+    close(code = 1000, reason) {
+        __classPrivateFieldGet(this, _RealtimeConnection_socket, "f").close(code, reason);
+    }
+    async next() {
+        const queued = __classPrivateFieldGet(this, _RealtimeConnection_queue, "f").shift();
+        if (queued)
+            return { value: queued, done: false };
+        if (__classPrivateFieldGet(this, _RealtimeConnection_ended, "f")) {
+            if (__classPrivateFieldGet(this, _RealtimeConnection_failure, "f"))
+                throw __classPrivateFieldGet(this, _RealtimeConnection_failure, "f");
+            return { value: undefined, done: true };
+        }
+        const result = await new Promise(resolve => __classPrivateFieldGet(this, _RealtimeConnection_waiters, "f").push(resolve));
+        if (result.done && __classPrivateFieldGet(this, _RealtimeConnection_failure, "f"))
+            throw __classPrivateFieldGet(this, _RealtimeConnection_failure, "f");
+        return result;
+    }
+    [(_RealtimeConnection_socket = new WeakMap(), _RealtimeConnection_queue = new WeakMap(), _RealtimeConnection_waiters = new WeakMap(), _RealtimeConnection_failure = new WeakMap(), _RealtimeConnection_ended = new WeakMap(), Symbol.asyncIterator)]() {
+        return {
+            next: () => this.next(),
+            return: async () => {
+                this.close();
+                return { value: undefined, done: true };
+            },
+        };
+    }
+}
+/** Converts an inference base address (including `/v1`) into its Realtime WebSocket address for one model. */
+export function realtimeURL(baseURL, model) {
+    const url = new URL(baseURL);
+    url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
+    url.pathname = `${url.pathname.replace(/\/+$/, "")}/realtime`;
+    url.search = "";
+    url.searchParams.set("model", model);
+    return url.toString();
+}
+function open(WebSocketImpl, url, init, signal) {
+    const Impl = WebSocketImpl ?? globalThis.WebSocket;
+    if (!Impl)
+        return Promise.reject(new RealtimeError(en.realtimeWebSocketUnavailable));
+    if (signal?.aborted)
+        return Promise.reject(new RealtimeError(en.requestAbortedByClient));
+    return new Promise((resolve, reject) => {
+        const socket = new Impl(url, init);
+        const abort = () => socket.close(1000);
+        signal?.addEventListener("abort", abort, { once: true });
+        socket.onerror = () => { };
+        socket.onopen = () => {
+            signal?.removeEventListener("abort", abort);
+            resolve(new RealtimeConnection(socket));
+        };
+        socket.onclose = ({ code, reason }) => {
+            signal?.removeEventListener("abort", abort);
+            reject(new RealtimeError(signal?.aborted ? en.requestAbortedByClient : en.realtimeClosed(code, reason), code, reason));
+        };
+    });
+}
+async function authorizationHeaders(options) {
+    const key = await extractSecurity(options.apiKey);
+    const authorization = resolveGlobalSecurity(key == null ? {} : { apiKey: key })?.headers["Authorization"];
+    if (!authorization)
+        throw new RealtimeError(en.apiKeyMissing);
+    return Object.fromEntries(Object.entries({
+        Authorization: authorization,
+        "User-Agent": options.userAgent ?? SDK_METADATA.userAgent,
+        "X-Melara-App-Name": options.appTitle,
+        "X-Melara-App-Url": options.httpReferer,
+    }).filter((entry) => typeof entry[1] === "string" && entry[1] !== ""));
+}
+/** Opens a Realtime session from a trusted server with the client's API key. */
+export async function connectRealtimeServer(options, request) {
+    const baseURL = serverURLFromOptions(options);
+    if (!baseURL)
+        throw new RealtimeError(en.noServerUrlConfigured);
+    const headers = await authorizationHeaders(options);
+    return open(request.WebSocket, realtimeURL(baseURL, request.model), { headers, protocols: ["realtime"] }, request.signal);
+}
+/** Opens a Realtime session in a browser or other untrusted client with a short-lived client secret. */
+export function connectRealtime(request) {
+    return open(request.WebSocket, request.url, ["realtime", `openai-insecure-api-key.${request.clientSecret}`], request.signal);
+}
+/** Creates a short-lived client secret on a trusted server, for a browser to open one Realtime session. */
+export async function createRealtimeClientSecret(options, request) {
+    const baseURL = serverURLFromOptions(options);
+    if (!baseURL)
+        throw new RealtimeError(en.noServerUrlConfigured);
+    const endpoint = new URL(`${baseURL.toString().replace(/\/+$/, "")}/realtime/client_secrets`);
+    const body = {
+        session: { type: "realtime", model: request.model },
+        ...(request.expiresAfterSeconds === undefined
+            ? {}
+            : { expires_after: { anchor: "created_at", seconds: request.expiresAfterSeconds } }),
+    };
+    const response = await (options.httpClient ?? new HTTPClient()).request(new Request(endpoint, {
+        method: "POST",
+        headers: { ...(await authorizationHeaders(options)), "Content-Type": "application/json", Accept: "application/json" },
+        body: JSON.stringify(body),
+        ...(request.signal ? { signal: request.signal } : {}),
+    }));
+    const text = await response.text();
+    if (!response.ok)
+        throw new RealtimeError(en.realtimeClientSecretFailed(response.status), response.status, text);
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch {
+        throw new RealtimeError(en.unexpectedResponseTypeFromApi, response.status);
+    }
+    if (typeof payload.value !== "string" || payload.value === "")
+        throw new RealtimeError(en.unexpectedResponseTypeFromApi, response.status);
+    return {
+        value: payload.value,
+        ...(typeof payload.expires_at === "number" ? { expiresAt: payload.expires_at } : {}),
+        url: realtimeURL(baseURL, request.model),
+    };
+}
+//# sourceMappingURL=realtime.js.map

package/esm/lib/realtime.js.map

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

package/esm/lib/retries.d.ts

@@ -0,0 +1,38 @@
+export type BackoffStrategy = {
+    initialInterval: number;
+    maxInterval: number;
+    exponent: number;
+    maxElapsedTime: number;
+};
+export type RetryConfig = {
+    strategy: "none";
+} | {
+    strategy: "backoff";
+    backoff?: BackoffStrategy;
+    retryConnectionErrors?: boolean;
+};
+/**
+ * PermanentError is an error that is not recoverable. Throwing this error will
+ * cause a retry loop to terminate.
+ */
+export declare class PermanentError extends Error {
+    /** The underlying cause of the error. */
+    readonly cause: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * TemporaryError is an error is used to signal that an HTTP request can be
+ * retried as part of a retry loop. If retry attempts are exhausted and this
+ * error is thrown, the response will be returned to the caller.
+ */
+export declare class TemporaryError extends Error {
+    response: Response;
+    constructor(message: string, response: Response);
+}
+export declare function retry(fetchFn: () => Promise<Response>, options: {
+    config: RetryConfig;
+    statusCodes: string[];
+}): Promise<Response>;
+//# sourceMappingURL=retries.d.ts.map

package/esm/lib/retries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retries.d.ts","sourceRoot":"","sources":["../../src/lib/retries.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,eAAe,GAAG;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AASF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IACE,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEN;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,yCAAyC;IACzC,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAgB3D;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,EAAE,QAAQ,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAOhD;AAED,wBAAsB,KAAK,CACzB,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAChC,OAAO,EAAE;IACP,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,GACA,OAAO,CAAC,QAAQ,CAAC,CAanB"}

package/esm/lib/retries.js

@@ -0,0 +1,157 @@
+// Modified by Melara for the Melara SDK fork.
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b24a69d15639
+ */
+import { en } from "../locales/en.js";
+import { isConnectionError, isTimeoutError } from "./http.js";
+const defaultBackoff = {
+    initialInterval: 500,
+    maxInterval: 60000,
+    exponent: 1.5,
+    maxElapsedTime: 3600000,
+};
+/**
+ * PermanentError is an error that is not recoverable. Throwing this error will
+ * cause a retry loop to terminate.
+ */
+export class PermanentError extends Error {
+    constructor(message, options) {
+        let msg = message;
+        if (options?.cause) {
+            msg += `: ${options.cause}`;
+        }
+        super(msg, options);
+        this.name = "PermanentError";
+        // In older runtimes, the cause field would not have been assigned through
+        // the super() call.
+        if (typeof this.cause === "undefined") {
+            this.cause = options?.cause;
+        }
+        Object.setPrototypeOf(this, PermanentError.prototype);
+    }
+}
+/**
+ * TemporaryError is an error is used to signal that an HTTP request can be
+ * retried as part of a retry loop. If retry attempts are exhausted and this
+ * error is thrown, the response will be returned to the caller.
+ */
+export class TemporaryError extends Error {
+    constructor(message, response) {
+        super(message);
+        this.response = response;
+        this.name = "TemporaryError";
+        Object.setPrototypeOf(this, TemporaryError.prototype);
+    }
+}
+export async function retry(fetchFn, options) {
+    switch (options.config.strategy) {
+        case "backoff":
+            return retryBackoff(wrapFetcher(fetchFn, {
+                statusCodes: options.statusCodes,
+                retryConnectionErrors: !!options.config.retryConnectionErrors,
+            }), options.config.backoff ?? defaultBackoff);
+        default:
+            return await fetchFn();
+    }
+}
+function wrapFetcher(fn, options) {
+    return async () => {
+        try {
+            const res = await fn();
+            if (isRetryableResponse(res, options.statusCodes)) {
+                throw new TemporaryError(en.responseFailedWithRetryableStatusCode, res);
+            }
+            return res;
+        }
+        catch (err) {
+            if (err instanceof TemporaryError) {
+                throw err;
+            }
+            if (options.retryConnectionErrors &&
+                (isTimeoutError(err) || isConnectionError(err))) {
+                throw err;
+            }
+            throw new PermanentError(en.permanentError, { cause: err });
+        }
+    };
+}
+const codeRangeRE = new RegExp("^[0-9]xx$", "i");
+function isRetryableResponse(res, statusCodes) {
+    const actual = `${res.status}`;
+    return statusCodes.some((code) => {
+        if (!codeRangeRE.test(code)) {
+            return code === actual;
+        }
+        const expectFamily = code.charAt(0);
+        if (!expectFamily) {
+            throw new Error(en.invalidStatusCodeRange);
+        }
+        const actualFamily = actual.charAt(0);
+        if (!actualFamily) {
+            throw new Error(en.invalidResponseStatusCode(actual));
+        }
+        return actualFamily === expectFamily;
+    });
+}
+async function retryBackoff(fn, strategy) {
+    const { maxElapsedTime, initialInterval, exponent, maxInterval } = strategy;
+    const start = Date.now();
+    let x = 0;
+    while (true) {
+        try {
+            const res = await fn();
+            return res;
+        }
+        catch (err) {
+            if (err instanceof PermanentError) {
+                throw err.cause;
+            }
+            const elapsed = Date.now() - start;
+            if (elapsed > maxElapsedTime) {
+                if (err instanceof TemporaryError) {
+                    return err.response;
+                }
+                throw err;
+            }
+            let retryInterval = 0;
+            if (err instanceof TemporaryError) {
+                retryInterval = retryIntervalFromResponse(err.response);
+            }
+            if (retryInterval <= 0) {
+                retryInterval =
+                    initialInterval * Math.pow(x, exponent) + Math.random() * 1000;
+            }
+            const d = Math.min(retryInterval, maxInterval);
+            await delay(d);
+            x++;
+        }
+    }
+}
+function retryIntervalFromResponse(res) {
+    const retryAfterMsVal = res.headers.get("retry-after-ms");
+    if (retryAfterMsVal) {
+        const parsedMs = Number(retryAfterMsVal);
+        if (Number.isFinite(parsedMs) && parsedMs >= 0) {
+            return parsedMs;
+        }
+    }
+    const retryVal = res.headers.get("retry-after") || "";
+    if (!retryVal) {
+        return 0;
+    }
+    const parsedNumber = Number(retryVal);
+    if (Number.isInteger(parsedNumber)) {
+        return parsedNumber * 1000;
+    }
+    const parsedDate = Date.parse(retryVal);
+    if (Number.isInteger(parsedDate)) {
+        const deltaMS = parsedDate - Date.now();
+        return deltaMS > 0 ? Math.ceil(deltaMS) : 0;
+    }
+    return 0;
+}
+async function delay(delay) {
+    return new Promise((resolve) => setTimeout(resolve, delay));
+}
+//# sourceMappingURL=retries.js.map

package/esm/lib/retries.js.map

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

package/esm/lib/reusable-stream.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A reusable readable stream that allows multiple consumers to read from the same source stream
+ * concurrently while it's actively streaming, without forcing consumers to wait for full buffering.
+ *
+ * Key features:
+ * - Multiple concurrent consumers with independent read positions
+ * - New consumers can attach while streaming is active
+ * - Efficient memory management with automatic cleanup
+ * - Each consumer can read at their own pace
+ */
+export declare class ReusableReadableStream<T> {
+    private sourceStream;
+    private buffer;
+    private consumers;
+    private nextConsumerId;
+    private sourceReader;
+    private sourceComplete;
+    private sourceError;
+    private pumpStarted;
+    constructor(sourceStream: ReadableStream<T>);
+    /**
+     * Create a new consumer that can independently iterate over the stream.
+     * Multiple consumers can be created and will all receive the same data.
+     */
+    createConsumer(): AsyncIterableIterator<T>;
+    /**
+     * Start pumping data from the source stream into the buffer
+     */
+    private startPump;
+    /**
+     * Notify all waiting consumers that new data is available
+     */
+    private notifyAllConsumers;
+    /**
+     * Cancel the source stream and all consumers
+     */
+    cancel(): Promise<void>;
+}
+//# sourceMappingURL=reusable-stream.d.ts.map

package/esm/lib/reusable-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-stream.d.ts","sourceRoot":"","sources":["../../src/lib/reusable-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,sBAAsB,CAAC,CAAC;IASvB,OAAO,CAAC,YAAY;IARhC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,WAAW,CAAS;gBAER,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;IAEnD;;;OAGG;IACH,cAAc,IAAI,qBAAqB,CAAC,CAAC,CAAC;IAgH1C;;OAEG;IACH,OAAO,CAAC,SAAS;IAmCjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB9B"}

package/esm/lib/reusable-stream.js

@@ -0,0 +1,192 @@
+/**
+ * A reusable readable stream that allows multiple consumers to read from the same source stream
+ * concurrently while it's actively streaming, without forcing consumers to wait for full buffering.
+ *
+ * Key features:
+ * - Multiple concurrent consumers with independent read positions
+ * - New consumers can attach while streaming is active
+ * - Efficient memory management with automatic cleanup
+ * - Each consumer can read at their own pace
+ */
+export class ReusableReadableStream {
+    constructor(sourceStream) {
+        this.sourceStream = sourceStream;
+        this.buffer = [];
+        this.consumers = new Map();
+        this.nextConsumerId = 0;
+        this.sourceReader = null;
+        this.sourceComplete = false;
+        this.sourceError = null;
+        this.pumpStarted = false;
+    }
+    /**
+     * Create a new consumer that can independently iterate over the stream.
+     * Multiple consumers can be created and will all receive the same data.
+     */
+    createConsumer() {
+        const consumerId = this.nextConsumerId++;
+        const state = {
+            position: 0,
+            waitingPromise: null,
+            cancelled: false,
+        };
+        this.consumers.set(consumerId, state);
+        // Start pumping the source stream if not already started
+        if (!this.pumpStarted) {
+            this.startPump();
+        }
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        return {
+            async next() {
+                const consumer = self.consumers.get(consumerId);
+                if (!consumer) {
+                    return {
+                        done: true,
+                        value: undefined,
+                    };
+                }
+                if (consumer.cancelled) {
+                    return {
+                        done: true,
+                        value: undefined,
+                    };
+                }
+                // If we have buffered data at this position, return it
+                if (consumer.position < self.buffer.length) {
+                    const value = self.buffer[consumer.position];
+                    consumer.position++;
+                    // Note: We don't clean up buffer to allow sequential/reusable access
+                    return {
+                        done: false,
+                        value,
+                    };
+                }
+                // If source is complete and we've read everything, we're done
+                if (self.sourceComplete) {
+                    self.consumers.delete(consumerId);
+                    return {
+                        done: true,
+                        value: undefined,
+                    };
+                }
+                // If source had an error, propagate it
+                if (self.sourceError) {
+                    self.consumers.delete(consumerId);
+                    throw self.sourceError;
+                }
+                // Set up the waiting promise FIRST to avoid race condition
+                // where source completes after the check but before promise is set
+                const waitPromise = new Promise((resolve, reject) => {
+                    consumer.waitingPromise = {
+                        resolve,
+                        reject,
+                    };
+                    // Immediately check if we should resolve after setting up the promise
+                    // This handles the case where data arrived or source completed
+                    // between our initial checks and promise creation
+                    if (self.sourceComplete || self.sourceError || consumer.position < self.buffer.length) {
+                        resolve();
+                    }
+                });
+                await waitPromise;
+                // Clear the promise reference after it resolves
+                consumer.waitingPromise = null;
+                // Recursively try again after waking up
+                return this.next();
+            },
+            async return() {
+                const consumer = self.consumers.get(consumerId);
+                if (consumer) {
+                    consumer.cancelled = true;
+                    self.consumers.delete(consumerId);
+                }
+                return {
+                    done: true,
+                    value: undefined,
+                };
+            },
+            async throw(e) {
+                const consumer = self.consumers.get(consumerId);
+                if (consumer) {
+                    consumer.cancelled = true;
+                    self.consumers.delete(consumerId);
+                }
+                throw e;
+            },
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+        };
+    }
+    /**
+     * Start pumping data from the source stream into the buffer
+     */
+    startPump() {
+        if (this.pumpStarted) {
+            return;
+        }
+        this.pumpStarted = true;
+        this.sourceReader = this.sourceStream.getReader();
+        void (async () => {
+            try {
+                while (true) {
+                    const result = await this.sourceReader.read();
+                    if (result.done) {
+                        this.sourceComplete = true;
+                        this.notifyAllConsumers();
+                        break;
+                    }
+                    // Add to buffer
+                    this.buffer.push(result.value);
+                    // Notify waiting consumers
+                    this.notifyAllConsumers();
+                }
+            }
+            catch (error) {
+                this.sourceError = error instanceof Error ? error : new Error(String(error));
+                this.notifyAllConsumers();
+            }
+            finally {
+                if (this.sourceReader) {
+                    this.sourceReader.releaseLock();
+                }
+            }
+        })();
+    }
+    /**
+     * Notify all waiting consumers that new data is available
+     */
+    notifyAllConsumers() {
+        for (const consumer of this.consumers.values()) {
+            if (consumer.waitingPromise) {
+                if (this.sourceError) {
+                    consumer.waitingPromise.reject(this.sourceError);
+                }
+                else {
+                    consumer.waitingPromise.resolve();
+                }
+                consumer.waitingPromise = null;
+            }
+        }
+    }
+    /**
+     * Cancel the source stream and all consumers
+     */
+    async cancel() {
+        // Cancel all consumers
+        for (const consumer of this.consumers.values()) {
+            consumer.cancelled = true;
+            if (consumer.waitingPromise) {
+                consumer.waitingPromise.resolve();
+            }
+        }
+        this.consumers.clear();
+        // Cancel the source stream
+        if (this.sourceReader) {
+            await this.sourceReader.cancel();
+            this.sourceReader.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=reusable-stream.js.map