@0xinsider/mcp 2.14.0 → 2.14.3

package/dist/sdk/stream.d.ts

@@ -85,7 +85,7 @@ export interface StreamOptions extends StreamFilters {
      * remains valid across replicas and process restarts while retained. When
      * omitted the stream starts from the live head.
      */
-    lastEventId?: number | string;
+    lastEventId?: number | string | undefined;
     /** Cooperative cancellation; abort to close the stream. */
     signal?: AbortSignal;
     /** Invoked once for the resync marker frame, if one is emitted. */
@@ -104,7 +104,7 @@ export interface StreamOptions extends StreamFilters {
      * transport progress.
      */
     cursor?: {
-        seq?: number;
+        seq?: number | undefined;
     };
     /**
      * Byte ceiling for one undelivered frame (#16248). Default
@@ -115,9 +115,28 @@ export interface StreamOptions extends StreamFilters {
      * A positive finite integer; the largest real frame is a few KB.
      */
     maxFrameBytes?: number;
+    /**
+     * Deadline for response headers and a finite refusal body, per connection.
+     * Default `DEFAULT_TIMEOUT_MS` (15 seconds); `null` explicitly disables it.
+     * Cleared once a readable `text/event-stream` response is established.
+     * Independent of the client's REST `timeoutMs` and the stream's lifetime.
+     */
+    openTimeoutMs?: number | null;
+    /** Maximum refusal body bytes retained before cancellation. Default 64 KiB. */
+    maxErrorBodyBytes?: number;
 }
 /** Default for `StreamOptions.maxFrameBytes`: 1 MiB. */
 export declare const DEFAULT_MAX_STREAM_FRAME_BYTES = 1048576;
+/** Default for `StreamOptions.maxErrorBodyBytes`: 64 KiB. */
+export declare const DEFAULT_MAX_STREAM_ERROR_BODY_BYTES = 65536;
+/** A refusal's HTTP error retains this diagnostic as `cause`, without raw text. */
+export type StreamRefusalBodyErrorReason = "absent" | "empty" | "invalid_json" | "too_large" | "deadline_exceeded" | "read_failed";
+export declare class StreamRefusalBodyError extends Error {
+    readonly reason: StreamRefusalBodyErrorReason;
+    readonly bytes: number;
+    readonly maxBytes: number;
+    constructor(reason: StreamRefusalBodyErrorReason, bytes: number, maxBytes: number, cause?: unknown);
+}
 /** What the stream did that the SSE contract does not allow. */
 export type StreamProtocolErrorReason = 
 /** A 2xx whose `Content-Type` is not `text/event-stream`. */
@@ -156,8 +175,8 @@ export declare class StreamProtocolError extends Error {
     readonly mediaType: string | undefined;
     constructor(reason: StreamProtocolErrorReason, detail: {
         lastSeq: number | undefined;
-        frameId?: number;
-        event?: string;
+        frameId?: number | undefined;
+        event?: string | undefined;
         bytes?: number;
         mediaType?: string | null;
     });
@@ -179,7 +198,7 @@ export type StreamEvent = {
  * `StreamEvent`: `kind: "event"` carries the `FeedEnvelope`, `kind: "resync"`
  * carries the `ResyncMarker`.
  *
- * Pass `options.cursor` (a `{ seq?: number }` object) to have the last
+ * Pass `options.cursor` (a `{ seq?: number | undefined }` object) to have the last
  * delivered `seq` written back as frames arrive; reconnect with
  * `lastEventId: cursor.seq` to resume after a transport drop.
  *
@@ -274,7 +293,8 @@ export declare class StreamRetryDeferredError extends Error {
  * - Aborting `signal` ends the iterator without throwing, during a connection
  *   or a backoff. Each connection's body reader is cancelled when it ends, so
  *   reconnects do not accumulate sockets.
- * - No request deadline applies, as with `streamFeed`.
+ * - `openTimeoutMs` bounds only opening and refusal reads; healthy streams
+ *   have no lifetime deadline, as with `streamFeed`.
  *
  * `options.cursor`, when passed, tracks the last delivered seq across every
  * connection -- delivered, not processed (#16247). This loop resumes from it,
@@ -495,8 +515,8 @@ export interface CheckpointedStreamHandlers {
  */
 export declare function consumeStreamCheckpointed(client: OxinsiderApiClient, handlers: CheckpointedStreamHandlers, options?: CheckpointedStreamOptions): Promise<void>;
 export interface ParsedSseFrame {
-    event?: string;
-    id?: number;
+    event?: string | undefined;
+    id?: number | undefined;
     data: string;
 }
 /** Parse one SSE frame (without the trailing blank line). */

package/dist/sdk/stream.d.ts.map

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

package/dist/sdk/stream.js

@@ -45,11 +45,25 @@
  *   Comment lines (`: keep-alive`), LF and CRLF framing, unknown SSE fields
  *   and unknown-but-valid envelope `type`s are compatible as before.
  */
-import { resolveApiUrl } from "./client.js";
-import { errorFromResponse, OxinsiderApiError } from "./errors.js";
+import { DEFAULT_TIMEOUT_MS, resolveApiUrl, } from "./client.js";
+import { errorFromResponse, OxinsiderApiError, RequestTimeoutError, } from "./errors.js";
 import { RETRY_AFTER_CEILING_MS, retryAfterSeconds, waitUnlessAborted, } from "./retry.js";
 /** Default for `StreamOptions.maxFrameBytes`: 1 MiB. */
 export const DEFAULT_MAX_STREAM_FRAME_BYTES = 1_048_576;
+/** Default for `StreamOptions.maxErrorBodyBytes`: 64 KiB. */
+export const DEFAULT_MAX_STREAM_ERROR_BODY_BYTES = 65_536;
+export class StreamRefusalBodyError extends Error {
+    reason;
+    bytes;
+    maxBytes;
+    constructor(reason, bytes, maxBytes, cause) {
+        super(`0xinsider stream refusal body ${reason} (${String(bytes)} bytes read; limit ${String(maxBytes)})`, { cause });
+        this.reason = reason;
+        this.bytes = bytes;
+        this.maxBytes = maxBytes;
+        this.name = "StreamRefusalBodyError";
+    }
+}
 /**
  * The stream broke the SSE contract (#16248). The connection is closed and
  * the reader released before this is thrown. `lastSeq` is the last sequence
@@ -113,6 +127,163 @@ function assertMaxFrameBytes(value) {
     }
     return value;
 }
+/** Validate transport options before a reconnect can spend an attempt. */
+function streamConnectionOptions(options) {
+    const maxFrameBytes = assertMaxFrameBytes(options.maxFrameBytes ?? DEFAULT_MAX_STREAM_FRAME_BYTES);
+    const maxErrorBodyBytes = options.maxErrorBodyBytes ?? DEFAULT_MAX_STREAM_ERROR_BODY_BYTES;
+    if (!Number.isSafeInteger(maxErrorBodyBytes) || maxErrorBodyBytes < 1) {
+        throw new Error(`maxErrorBodyBytes must be a positive safe integer, got ${String(maxErrorBodyBytes)}`);
+    }
+    const openTimeoutMs = options.openTimeoutMs === undefined
+        ? DEFAULT_TIMEOUT_MS
+        : options.openTimeoutMs;
+    // Node's timer contract clamps larger values to 1 ms. Reject rather than
+    // making a requested long opening window expire immediately.
+    if (openTimeoutMs !== null &&
+        (!Number.isInteger(openTimeoutMs) ||
+            openTimeoutMs < 1 ||
+            openTimeoutMs > 2_147_483_647)) {
+        throw new Error(`openTimeoutMs must be an integer from 1 to 2147483647 ms or null, got ${String(openTimeoutMs)}`);
+    }
+    return { maxFrameBytes, maxErrorBodyBytes, openTimeoutMs };
+}
+/** Clear only the owned opening timer; caller cancellation lives until disposal. */
+function streamConnectionSignal(timeoutMs, caller) {
+    const controller = new AbortController();
+    let timer;
+    const established = () => {
+        clearTimeout(timer);
+        timer = undefined;
+    };
+    const onCallerAbort = () => {
+        established();
+        controller.abort(caller?.reason);
+    };
+    // Manual forwarding supports every Node >=18, including versions without
+    // AbortSignal.any, and allows both sources to be disposed explicitly.
+    if (caller?.aborted)
+        onCallerAbort();
+    else
+        caller?.addEventListener("abort", onCallerAbort, { once: true });
+    if (!controller.signal.aborted && timeoutMs !== null) {
+        timer = setTimeout(() => controller.abort(new RequestTimeoutError("getStream", timeoutMs)), timeoutMs);
+    }
+    return {
+        signal: controller.signal,
+        established,
+        dispose: () => {
+            established();
+            caller?.removeEventListener("abort", onCallerAbort);
+        },
+    };
+}
+/** Bound injected readers too: their stream may not observe fetch's signal. */
+async function streamWork(work, signal) {
+    let onAbort;
+    const aborted = new Promise((_, reject) => {
+        onAbort = () => {
+            const reason = signal.reason;
+            reject(reason);
+        };
+        if (signal.aborted)
+            onAbort();
+        else
+            signal.addEventListener("abort", onAbort, { once: true });
+    });
+    try {
+        return await Promise.race([aborted, work]);
+    }
+    finally {
+        if (onAbort)
+            signal.removeEventListener("abort", onAbort);
+    }
+}
+const STREAM_CLEANUP_TIMEOUT_MS = 2_000;
+/** A non-cooperative injected cancel cannot hold a reconnect indefinitely. */
+async function cancelStreamBody(cancel) {
+    if (!cancel)
+        return undefined;
+    let timer;
+    const cancelled = Promise.resolve()
+        .then(cancel)
+        .then(() => undefined, (cause) => new Error("0xinsider stream body cancellation failed", { cause }));
+    const deadline = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(new Error(`0xinsider stream body cancellation did not settle within ${String(STREAM_CLEANUP_TIMEOUT_MS)} ms; completion is unknown`)), STREAM_CLEANUP_TIMEOUT_MS);
+    });
+    try {
+        return await Promise.race([cancelled, deadline]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Preserve HTTP classification when cleanup also fails. */
+function withStreamCleanupCause(primary, cleanup) {
+    if (primary instanceof Error) {
+        const cause = primary.cause;
+        try {
+            primary.cause =
+                cause === undefined
+                    ? cleanup
+                    : new AggregateError([cause, cleanup], "Stream failure and body cleanup failure");
+            return primary;
+        }
+        catch (annotationFailure) {
+            return new AggregateError([primary, cleanup, annotationFailure], "Stream failure could not retain its cleanup diagnostic", { cause: primary });
+        }
+    }
+    return new AggregateError([primary, cleanup], "Stream failure and body cleanup failure", { cause: primary });
+}
+async function streamRefusal(response, reader, signal, maxBytes, caller) {
+    const retryAfter = retryAfterSeconds(response);
+    const requestId = response.headers.get("x-request-id");
+    let bytes = 0;
+    let body = null;
+    let diagnostic;
+    if (!reader)
+        diagnostic = new StreamRefusalBodyError("absent", bytes, maxBytes);
+    else {
+        const decoder = new TextDecoder();
+        let text = "";
+        try {
+            for (;;) {
+                const { value, done } = await streamWork(reader.read(), signal);
+                if (done)
+                    break;
+                bytes += value.byteLength;
+                if (bytes > maxBytes) {
+                    diagnostic = new StreamRefusalBodyError("too_large", bytes, maxBytes);
+                    break;
+                }
+                text += decoder.decode(value, { stream: true });
+            }
+            if (!diagnostic) {
+                text += decoder.decode();
+                if (text === "")
+                    diagnostic = new StreamRefusalBodyError("empty", bytes, maxBytes);
+                else {
+                    try {
+                        body = JSON.parse(text);
+                    }
+                    catch {
+                        diagnostic = new StreamRefusalBodyError("invalid_json", bytes, maxBytes);
+                    }
+                }
+            }
+        }
+        catch (cause) {
+            if (caller?.aborted)
+                throw caller.reason;
+            diagnostic = new StreamRefusalBodyError(signal.aborted ? "deadline_exceeded" : "read_failed", bytes, maxBytes, cause);
+        }
+    }
+    const error = errorFromResponse(response.status, body, retryAfter, {
+        requestId,
+    });
+    if (diagnostic)
+        error.cause = diagnostic;
+    return error;
+}
 /** `Content-Type` names an event stream: `text/event-stream`, with or without parameters. */
 export function isEventStreamMediaType(contentType) {
     if (contentType === null)
@@ -125,7 +296,7 @@ export function isEventStreamMediaType(contentType) {
  * `StreamEvent`: `kind: "event"` carries the `FeedEnvelope`, `kind: "resync"`
  * carries the `ResyncMarker`.
  *
- * Pass `options.cursor` (a `{ seq?: number }` object) to have the last
+ * Pass `options.cursor` (a `{ seq?: number | undefined }` object) to have the last
  * delivered `seq` written back as frames arrive; reconnect with
  * `lastEventId: cursor.seq` to resume after a transport drop.
  *
@@ -135,7 +306,7 @@ export function isEventStreamMediaType(contentType) {
  * }
  */
 export async function* streamFeed(client, options = {}) {
-    const maxFrameBytes = assertMaxFrameBytes(options.maxFrameBytes ?? DEFAULT_MAX_STREAM_FRAME_BYTES);
+    const { maxFrameBytes, maxErrorBodyBytes, openTimeoutMs } = streamConnectionOptions(options);
     const apiKey = client.getApiKey();
     // The sandbox takes no credential; it answers the stream route with a 400
     // saying streams are not simulated, and that answer is the server's to
@@ -150,41 +321,73 @@ export async function* streamFeed(client, options = {}) {
     if (options.lastEventId !== undefined) {
         headers.set("last-event-id", String(options.lastEventId));
     }
-    const fetchImpl = client.getFetch();
-    const response = await fetchImpl(url, {
-        method: "GET",
-        headers,
-        signal: options.signal,
-    });
-    if (!response.ok) {
-        const body = await safeText(response);
-        throw errorFromResponse(response.status, tryParse(body), retryAfterSeconds(response), { requestId: response.headers.get("x-request-id") });
-    }
-    // A 2xx that is not an event stream (an HTML page from a proxy, a JSON body
-    // from a route that moved) used to read as an empty stream that closed
-    // cleanly, which the reconnect loop then retried as an outage (#16248).
-    const mediaType = response.headers.get("content-type");
-    if (!isEventStreamMediaType(mediaType)) {
-        await response.body?.cancel().catch(() => undefined);
-        throw new StreamProtocolError("unexpected_media_type", {
-            lastSeq: undefined,
-            mediaType,
-        });
-    }
-    if (!response.body) {
-        throw new Error("Stream response has no readable body");
-    }
-    const reader = response.body.getReader();
-    const decoder = new TextDecoder();
-    const encoder = new TextEncoder();
-    let buffer = "";
-    // Bytes of `buffer`: exact, since every chunk adds its own byte length and
-    // a cut re-measures the remainder. Bounded by `maxFrameBytes`.
-    let bufferedBytes = 0;
-    let lastSeq;
+    const connection = streamConnectionSignal(openTimeoutMs, options.signal);
+    let response;
+    let reader;
+    let failure;
+    let failed = false;
     try {
+        connection.signal.throwIfAborted();
+        const pendingResponse = client.getFetch()(url, {
+            method: "GET",
+            headers,
+            signal: connection.signal,
+        });
+        try {
+            response = await streamWork(pendingResponse, connection.signal);
+        }
+        catch (error) {
+            // An injected fetch may ignore abort. Observe its eventual response and
+            // cancel it instead of abandoning a late connection. The timeout error
+            // keeps any cleanup diagnostic; an uncooperative fetch itself is outside
+            // the SDK's control.
+            pendingResponse.then(async (lateResponse) => {
+                const body = lateResponse.body;
+                const cleanup = await cancelStreamBody(body ? () => body.cancel(error) : undefined);
+                if (cleanup)
+                    withStreamCleanupCause(error, cleanup);
+            }, (lateFailure) => {
+                if (lateFailure !== error && error instanceof Error) {
+                    withStreamCleanupCause(error, new Error("Opening fetch failed after cancellation", {
+                        cause: lateFailure,
+                    }));
+                }
+            });
+            throw error;
+        }
+        if (!response.ok) {
+            try {
+                reader = response.body?.getReader();
+            }
+            catch (cause) {
+                const error = errorFromResponse(response.status, null, retryAfterSeconds(response), {
+                    requestId: response.headers.get("x-request-id"),
+                });
+                error.cause = new StreamRefusalBodyError("read_failed", 0, maxErrorBodyBytes, cause);
+                throw error;
+            }
+            throw await streamRefusal(response, reader, connection.signal, maxErrorBodyBytes, options.signal);
+        }
+        const mediaType = response.headers.get("content-type");
+        if (!isEventStreamMediaType(mediaType)) {
+            throw new StreamProtocolError("unexpected_media_type", {
+                lastSeq: undefined,
+                mediaType,
+            });
+        }
+        if (!response.body)
+            throw new Error("Stream response has no readable body");
+        reader = response.body.getReader();
+        connection.established();
+        const decoder = new TextDecoder();
+        const encoder = new TextEncoder();
+        let buffer = "";
+        // Bytes of `buffer`: exact, since every chunk adds its own byte length and
+        // a cut re-measures the remainder. Bounded by `maxFrameBytes`.
+        let bufferedBytes = 0;
+        let lastSeq;
         for (;;) {
-            const { value, done } = await reader.read();
+            const { value, done } = await streamWork(reader.read(), connection.signal);
             if (done)
                 break;
             buffer += decoder.decode(value, { stream: true });
@@ -236,18 +439,25 @@ export async function* streamFeed(client, options = {}) {
             }
         }
     }
+    catch (error) {
+        failed = true;
+        failure = error;
+        throw error;
+    }
     finally {
-        // `releaseLock()` detaches the reader but leaves the body -- and the
-        // underlying HTTP connection -- open. Any early exit from the consumer
-        // loop (`break`, `return`, or a throw from a handler) runs this block via
-        // the generator's `return()`, so without `cancel()` every early exit leaks
-        // one open connection to the SSE endpoint. The documented reconnect loop
-        // makes that one leak per reconnect, until the process runs out of sockets
-        // or the server's per-user SSE lease cap rejects the user's own
-        // reconnects. `cancel()` releases the lock as part of cancelling, and can
-        // reject on an already-errored stream, so the rejection is swallowed to
-        // keep the `finally` non-throwing (#9682).
-        await reader.cancel().catch(() => undefined);
+        // Cancel even when the consumer breaks, and always release the lock.
+        // Cancellation failures remain visible without replacing an HTTP status.
+        connection.dispose();
+        const ownedReader = reader;
+        const ownedBody = response?.body;
+        const cleanup = await cancelStreamBody(ownedReader
+            ? () => ownedReader.cancel(failure)
+            : ownedBody
+                ? () => ownedBody.cancel(failure)
+                : undefined);
+        ownedReader?.releaseLock();
+        if (cleanup)
+            throw failed ? withStreamCleanupCause(failure, cleanup) : cleanup;
     }
 }
 /** Default for `ResilientStreamOptions.maxReconnects`. */
@@ -353,7 +563,7 @@ function streamBackoffMs(attempt) {
     return ceiling / 2 + Math.random() * (ceiling / 2);
 }
 function assertMaxRetryAfterMs(value) {
-    if (Number.isNaN(value) || value < 0) {
+    if (typeof value !== "number" || Number.isNaN(value) || value < 0) {
         throw new Error(`maxRetryAfterMs must be a non-negative number of milliseconds or Infinity, got ${String(value)}`);
     }
     return value;
@@ -381,7 +591,8 @@ function assertMaxRetryAfterMs(value) {
  * - Aborting `signal` ends the iterator without throwing, during a connection
  *   or a backoff. Each connection's body reader is cancelled when it ends, so
  *   reconnects do not accumulate sockets.
- * - No request deadline applies, as with `streamFeed`.
+ * - `openTimeoutMs` bounds only opening and refusal reads; healthy streams
+ *   have no lifetime deadline, as with `streamFeed`.
  *
  * `options.cursor`, when passed, tracks the last delivered seq across every
  * connection -- delivered, not processed (#16247). This loop resumes from it,
@@ -406,6 +617,7 @@ export async function* streamFeedResilient(client, options = {}) {
         throw new Error(`maxReconnects must be a non-negative integer, got ${String(maxReconnects)}`);
     }
     const retryAfterCeilingMs = assertMaxRetryAfterMs(maxRetryAfterMs);
+    const connectionOptions = streamConnectionOptions(streamOptions);
     // The one configuration error `streamFeed` throws before any request; it
     // would otherwise count as a transport failure and burn every reconnect.
     if (!client.getApiKey() && !client.isSandbox()) {
@@ -422,6 +634,7 @@ export async function* streamFeedResilient(client, options = {}) {
         try {
             for await (const frame of streamFeed(client, {
                 ...streamOptions,
+                ...connectionOptions,
                 cursor,
                 lastEventId: cursor.seq ?? initialLastEventId,
             })) {
@@ -607,6 +820,12 @@ export async function consumeStreamCheckpointed(client, handlers, options = {})
     if (!Number.isInteger(maxHandlerRetries) || maxHandlerRetries < 0) {
         throw new Error(`maxHandlerRetries must be a non-negative integer, got ${String(maxHandlerRetries)}`);
     }
+    streamConnectionOptions(streamOptions);
+    const maxReconnects = streamOptions.maxReconnects ?? DEFAULT_MAX_STREAM_RECONNECTS;
+    if (!Number.isInteger(maxReconnects) || maxReconnects < 0) {
+        throw new Error(`maxReconnects must be a non-negative integer, got ${String(maxReconnects)}`);
+    }
+    assertMaxRetryAfterMs(streamOptions.maxRetryAfterMs ?? DEFAULT_MAX_STREAM_RETRY_AFTER_MS);
     const signal = streamOptions.signal;
     // The caller's received cursor, if they passed one. It keeps its delivery
     // meaning: this consumer mirrors every frame into it and never reads it
@@ -829,7 +1048,7 @@ export function decodeStreamFrame(parsed, lastSeq) {
         if (!isPlainObject(payload)) {
             throw new StreamProtocolError("invalid_resync", detail);
         }
-        if ("type" in payload && payload.type !== "resync") {
+        if ("type" in payload && payload["type"] !== "resync") {
             throw new StreamProtocolError("invalid_resync", detail);
         }
         return {
@@ -844,8 +1063,8 @@ export function decodeStreamFrame(parsed, lastSeq) {
     if (!isPlainObject(payload)) {
         throw new StreamProtocolError("invalid_envelope", detail);
     }
-    const seq = typeof payload.seq === "number" && Number.isFinite(payload.seq)
-        ? payload.seq
+    const seq = typeof payload["seq"] === "number" && Number.isFinite(payload["seq"])
+        ? payload["seq"]
         : parsed.id;
     if (seq === undefined || !Number.isFinite(seq)) {
         throw new StreamProtocolError("unusable_sequence", detail);
@@ -892,13 +1111,13 @@ const permanentTerminalErrors = new WeakSet();
  * consumer's reconnect path like any 5xx.
  */
 function terminalStreamError(payload, detail) {
-    if (!isPlainObject(payload) || !isPlainObject(payload.error)) {
+    if (!isPlainObject(payload) || !isPlainObject(payload["error"])) {
         return new StreamProtocolError("invalid_envelope", detail);
     }
-    const body = payload.error;
-    const retry = payload.retry === true;
-    const code = typeof body.code === "string" ? body.code : undefined;
-    const reason = typeof body.reason === "string" ? body.reason : undefined;
+    const body = payload["error"];
+    const retry = payload["retry"] === true;
+    const code = typeof body["code"] === "string" ? body["code"] : undefined;
+    const reason = typeof body["reason"] === "string" ? body["reason"] : undefined;
     const status = reason !== undefined && STREAM_ERROR_UNAVAILABLE_REASONS.has(reason)
         ? 503
         : ((code !== undefined ? STREAM_ERROR_CODE_STATUS[code] : undefined) ??
@@ -911,22 +1130,4 @@ function terminalStreamError(payload, detail) {
 function isPlainObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function tryParse(text) {
-    if (text === null || text === "")
-        return null;
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}
-async function safeText(response) {
-    try {
-        return await response.text();
-    }
-    catch {
-        return "";
-    }
-}
 //# sourceMappingURL=stream.js.map