@astroway/sdk 0.1.0-alpha.1

package/dist/retry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Retry helper. Default — 2 retries, exponential backoff with full jitter,
+ * on connection errors / 408 / 409 / 429 / 5xx. Honors `Retry-After`
+ * (seconds or HTTP-date) when present on 429.
+ *
+ * openapi-fetch middleware can't trigger a re-fetch internally, so the SDK
+ * wraps each call with `fetchWithRetry()` from inside its custom `fetch`
+ * adapter — see src/index.ts.
+ */
+export interface RetryOptions {
+    /** Number of retries on top of the initial request. Default 2 — total 3 attempts. */
+    maxRetries?: number;
+    /** Base delay in ms. Default 250. Actual: random(0, base * 2^attempt). */
+    baseDelayMs?: number;
+    /** Max delay cap per attempt. Default 30_000. */
+    maxDelayMs?: number;
+    /** Status codes considered retryable. Default 408/409/429/5xx. */
+    retryableStatuses?: ReadonlySet<number>;
+}
+export declare function fetchWithRetry(doFetch: () => Promise<Response>, opts?: RetryOptions): Promise<Response>;
+//# 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;;;;;;;;GAQG;AAIH,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACzC;AAmBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAChC,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,QAAQ,CAAC,CAsBnB"}

package/dist/retry.js

@@ -0,0 +1,53 @@
+/**
+ * Retry helper. Default — 2 retries, exponential backoff with full jitter,
+ * on connection errors / 408 / 409 / 429 / 5xx. Honors `Retry-After`
+ * (seconds or HTTP-date) when present on 429.
+ *
+ * openapi-fetch middleware can't trigger a re-fetch internally, so the SDK
+ * wraps each call with `fetchWithRetry()` from inside its custom `fetch`
+ * adapter — see src/index.ts.
+ */
+const DEFAULT_RETRYABLE = new Set([408, 409, 429, 500, 502, 503, 504]);
+function parseRetryAfter(header) {
+    if (!header)
+        return undefined;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return seconds * 1000;
+    const parsed = Date.parse(header);
+    if (!Number.isNaN(parsed)) {
+        const wait = parsed - Date.now();
+        return wait > 0 ? wait : 0;
+    }
+    return undefined;
+}
+function jitterDelay(attempt, baseDelayMs, maxDelayMs) {
+    const upper = Math.min(maxDelayMs, baseDelayMs * 2 ** attempt);
+    return Math.floor(Math.random() * upper);
+}
+export async function fetchWithRetry(doFetch, opts = {}) {
+    const maxRetries = opts.maxRetries ?? 2;
+    const baseDelayMs = opts.baseDelayMs ?? 250;
+    const maxDelayMs = opts.maxDelayMs ?? 30_000;
+    const retryable = opts.retryableStatuses ?? DEFAULT_RETRYABLE;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const res = await doFetch();
+            if (!retryable.has(res.status) || attempt === maxRetries)
+                return res;
+            const retryAfterMs = parseRetryAfter(res.headers.get('retry-after'));
+            const delay = retryAfterMs ?? jitterDelay(attempt, baseDelayMs, maxDelayMs);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+        catch (e) {
+            lastError = e;
+            if (attempt === maxRetries)
+                throw e;
+            const delay = jitterDelay(attempt, baseDelayMs, maxDelayMs);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError ?? new Error('retry loop exhausted without response');
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAa5F,SAAS,eAAe,CAAC,MAAqB;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,OAAO,GAAG,IAAI,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,WAAmB,EAAE,UAAkB;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgC,EAChC,OAAqB,EAAE;IAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC;IAE9D,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,KAAK,UAAU;gBAAE,OAAO,GAAG,CAAC;YACrE,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;YACrE,MAAM,KAAK,GAAG,YAAY,IAAI,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAC5E,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAC,CAAC;YACd,IAAI,OAAO,KAAK,UAAU;gBAAE,MAAM,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAC5D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AACxE,CAAC"}