@0xinsider/sdk 0.14.0-bootstrap.0

package/dist/retry.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `Retry-After` parsing and the waits it drives, shared by the REST retry
+ * loop (`client.ts`) and the SSE reconnect loop (`stream.ts`) so the two
+ * cannot read the same header differently (#16249).
+ *
+ * Two facts shape this module:
+ *
+ * 1. `Retry-After` is either delta-seconds or an HTTP-date (RFC 9110 §10.2.3,
+ *    https://www.rfc-editor.org/rfc/rfc9110.html#name-retry-after). Both
+ *    loops parsed only the number and treated a date as "no header".
+ * 2. Node schedules a `setTimeout` delay above 2147483647 ms (about 24.8 days)
+ *    as 1 ms, with a warning
+ *    (https://nodejs.org/api/timers.html#settimeoutcallback-delay-args). The
+ *    stream loop multiplied any `Retry-After` by 1000 and handed it straight
+ *    to the timer, so a long server-requested wait -- `monthly_quota_exceeded`
+ *    names the first of next month -- would have reconnected at once, the
+ *    opposite of what the server asked.
+ *
+ * The policy is therefore: parse both forms into a non-negative number of
+ * seconds; never wait in-process past a ceiling the caller can see (60 s by
+ * default, the same for REST and SSE); when the server asks for longer, hand
+ * the caller a typed error carrying the not-before instant and the resume
+ * context, never a clamped earlier retry; and when a caller opts into waiting
+ * longer, wait in timer-sized chunks so the timer range is never exceeded.
+ */
+/**
+ * The largest delay one `setTimeout` can hold in Node (2^31 - 1 ms). A larger
+ * value is scheduled as 1 ms, so every wait here is cut into chunks of at
+ * most this size.
+ */
+export declare const MAX_TIMER_DELAY_MS = 2147483647;
+/**
+ * The longest server-requested wait either loop holds in-process by default.
+ * A `Retry-After` beyond it is the caller's to schedule: the REST loop throws
+ * the response's error (`retryAfterSeconds`, `retryAt`), the stream loop
+ * throws `StreamRetryDeferredError`.
+ */
+export declare const RETRY_AFTER_CEILING_MS = 60000;
+/**
+ * Parse a `Retry-After` header value into seconds to wait, or `null` when
+ * there is no usable value.
+ *
+ * - Delta-seconds: a finite, non-negative number (`"60"`, `"1.5"`). A negative
+ *   or non-finite number (`"-1"`, `"Infinity"`, `"NaN"`) is `null`: the
+ *   grammar does not allow it, and guessing a wait from it would be inventing
+ *   a server instruction.
+ * - HTTP-date (`"Wed, 01 Oct 2026 00:00:00 GMT"`): the seconds from `nowMs`
+ *   to that instant. A date already past is `0` (the server said "after an
+ *   instant that has passed", which is "now"), never negative.
+ * - Anything else (`""`, `"soon"`) is `null`.
+ *
+ * `null` means "as if the header were absent": the caller falls back to its
+ * own backoff. It never means "retry at once".
+ */
+export declare function parseRetryAfter(header: string | null | undefined, nowMs?: number): number | null;
+/** `parseRetryAfter` over a response's `Retry-After` header. */
+export declare function retryAfterSeconds(response: Response): number | null;
+/**
+ * Resolve after `ms`, or reject with the signal's reason the moment it
+ * aborts. A wait longer than `MAX_TIMER_DELAY_MS` runs as consecutive timers
+ * of at most that size, so it is never handed to `setTimeout` as one value
+ * that Node would schedule as 1 ms. `ms` must be a non-negative number;
+ * `Infinity` is refused because it can never elapse.
+ */
+export declare function sleepUnlessAborted(ms: number, signal: AbortSignal | undefined): Promise<void>;
+/** Resolve `true` after `ms`, or `false` the moment `signal` aborts. */
+export declare function waitUnlessAborted(ms: number, signal: AbortSignal | undefined): Promise<boolean>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAgB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,GAAE,MAAmB,GACzB,MAAM,GAAG,IAAI,CAaf;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAEnE;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/retry.js

@@ -0,0 +1,125 @@
+/**
+ * `Retry-After` parsing and the waits it drives, shared by the REST retry
+ * loop (`client.ts`) and the SSE reconnect loop (`stream.ts`) so the two
+ * cannot read the same header differently (#16249).
+ *
+ * Two facts shape this module:
+ *
+ * 1. `Retry-After` is either delta-seconds or an HTTP-date (RFC 9110 §10.2.3,
+ *    https://www.rfc-editor.org/rfc/rfc9110.html#name-retry-after). Both
+ *    loops parsed only the number and treated a date as "no header".
+ * 2. Node schedules a `setTimeout` delay above 2147483647 ms (about 24.8 days)
+ *    as 1 ms, with a warning
+ *    (https://nodejs.org/api/timers.html#settimeoutcallback-delay-args). The
+ *    stream loop multiplied any `Retry-After` by 1000 and handed it straight
+ *    to the timer, so a long server-requested wait -- `monthly_quota_exceeded`
+ *    names the first of next month -- would have reconnected at once, the
+ *    opposite of what the server asked.
+ *
+ * The policy is therefore: parse both forms into a non-negative number of
+ * seconds; never wait in-process past a ceiling the caller can see (60 s by
+ * default, the same for REST and SSE); when the server asks for longer, hand
+ * the caller a typed error carrying the not-before instant and the resume
+ * context, never a clamped earlier retry; and when a caller opts into waiting
+ * longer, wait in timer-sized chunks so the timer range is never exceeded.
+ */
+/**
+ * The largest delay one `setTimeout` can hold in Node (2^31 - 1 ms). A larger
+ * value is scheduled as 1 ms, so every wait here is cut into chunks of at
+ * most this size.
+ */
+export const MAX_TIMER_DELAY_MS = 2_147_483_647;
+/**
+ * The longest server-requested wait either loop holds in-process by default.
+ * A `Retry-After` beyond it is the caller's to schedule: the REST loop throws
+ * the response's error (`retryAfterSeconds`, `retryAt`), the stream loop
+ * throws `StreamRetryDeferredError`.
+ */
+export const RETRY_AFTER_CEILING_MS = 60_000;
+/**
+ * Parse a `Retry-After` header value into seconds to wait, or `null` when
+ * there is no usable value.
+ *
+ * - Delta-seconds: a finite, non-negative number (`"60"`, `"1.5"`). A negative
+ *   or non-finite number (`"-1"`, `"Infinity"`, `"NaN"`) is `null`: the
+ *   grammar does not allow it, and guessing a wait from it would be inventing
+ *   a server instruction.
+ * - HTTP-date (`"Wed, 01 Oct 2026 00:00:00 GMT"`): the seconds from `nowMs`
+ *   to that instant. A date already past is `0` (the server said "after an
+ *   instant that has passed", which is "now"), never negative.
+ * - Anything else (`""`, `"soon"`) is `null`.
+ *
+ * `null` means "as if the header were absent": the caller falls back to its
+ * own backoff. It never means "retry at once".
+ */
+export function parseRetryAfter(header, nowMs = Date.now()) {
+    if (header === null || header === undefined)
+        return null;
+    const text = header.trim();
+    if (text === "")
+        return null;
+    // `Number("")` is 0 and `Number(" 5 ")` is 5, so the trim above and the
+    // empty check keep a blank header from reading as "retry now".
+    const delta = Number(text);
+    if (!Number.isNaN(delta)) {
+        return Number.isFinite(delta) && delta >= 0 ? delta : null;
+    }
+    const dateMs = Date.parse(text);
+    if (Number.isNaN(dateMs))
+        return null;
+    return Math.max(0, (dateMs - nowMs) / 1000);
+}
+/** `parseRetryAfter` over a response's `Retry-After` header. */
+export function retryAfterSeconds(response) {
+    return parseRetryAfter(response.headers.get("retry-after"));
+}
+/**
+ * Resolve after `ms`, or reject with the signal's reason the moment it
+ * aborts. A wait longer than `MAX_TIMER_DELAY_MS` runs as consecutive timers
+ * of at most that size, so it is never handed to `setTimeout` as one value
+ * that Node would schedule as 1 ms. `ms` must be a non-negative number;
+ * `Infinity` is refused because it can never elapse.
+ */
+export async function sleepUnlessAborted(ms, signal) {
+    if (!(ms >= 0) || !Number.isFinite(ms)) {
+        throw new RangeError(`sleepUnlessAborted needs a finite non-negative delay, got ${String(ms)}`);
+    }
+    const notBefore = Date.now() + ms;
+    let remaining = ms;
+    for (;;) {
+        await timerUnlessAborted(Math.min(remaining, MAX_TIMER_DELAY_MS), signal);
+        remaining = notBefore - Date.now();
+        if (remaining <= 0)
+            return;
+    }
+}
+/** Resolve `true` after `ms`, or `false` the moment `signal` aborts. */
+export async function waitUnlessAborted(ms, signal) {
+    try {
+        await sleepUnlessAborted(ms, signal);
+        return true;
+    }
+    catch (error) {
+        if (signal?.aborted)
+            return false;
+        throw error;
+    }
+}
+function timerUnlessAborted(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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