@dofek/provider-http 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Asher Cohen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @dofek/provider-http
+
+Fetch-compatible HTTP helpers for provider integrations that need typed rate-limit
+and service-unavailable errors, `Retry-After` parsing, and optional adaptive
+request admission.
+
+## Install
+
+```sh
+npm install @dofek/provider-http
+```
+
+Requires Node.js 22.14 or newer and its built-in
+[`fetch`](https://nodejs.org/api/globals.html#fetch) implementation.
+
+## Usage
+
+```ts
+import {
+  createRateLimitAwareFetch,
+  ProviderRateLimitError,
+} from "@dofek/provider-http";
+
+const providerFetch = createRateLimitAwareFetch(fetch, {
+  providerId: "example",
+});
+
+try {
+  const response = await providerFetch("https://api.example.com/data");
+  if (!response.ok) {
+    throw new Error(`Provider returned HTTP ${response.status}`);
+  }
+  console.log(await response.json());
+} catch (error) {
+  if (error instanceof ProviderRateLimitError) {
+    console.log(`Retry after ${error.retryAfterSeconds ?? "an unknown number of"} seconds`);
+  } else {
+    throw error;
+  }
+}
+```
+
+## Public API
+
+| Import | Main exports |
+| --- | --- |
+| `@dofek/provider-http` | `createRateLimitAwareFetch`, `fetchWithRateLimitHandling`, `parseRetryAfterHeader`, `isServiceUnavailableStatus`, `ProviderRateLimitError`, `ProviderServiceUnavailableError`, and their option/store types |
+| `@dofek/provider-http/rate-limit` | Alias of the root rate-limit API |
+| `@dofek/provider-http/adaptive-rate-limit` | Adaptive budget state, serialization, admission-delay calculations, Strava quota parsing, defaults, constants, and `AdaptiveRateLimitStore` |
+
+`AdaptiveRateLimitStore` is an interface: applications provide persistence and
+coordination appropriate to their runtime.
+
+## Error and request behavior
+
+- HTTP `429` throws `ProviderRateLimitError`.
+- HTTP `502`, `503`, and `504` throw `ProviderServiceUnavailableError`.
+- Both errors expose the provider, status, response body, scope, optional user,
+  and parsed `retryAfterSeconds`.
+- Other HTTP error responses are returned unchanged, so callers must check
+  `response.ok`.
+- These helpers do not retry automatically. The caller decides whether and when
+  to retry; an adaptive store can delay admission before a request.
+
+No authentication or environment variables are required by this package.
+
+## License and contributing
+
+[MIT](./LICENSE). Source is in the
+[Dofek repository](https://github.com/Asherlc/dofek/tree/main/packages/provider-http).
+Please [open an issue](https://github.com/Asherlc/dofek/issues) for bugs or API
+proposals, or [submit a pull request](https://github.com/Asherlc/dofek/pulls).

package/dist/adaptive-rate-limit.d.ts

@@ -0,0 +1,70 @@
+import type { ProviderRateLimitScope } from "./rate-limit-types.ts";
+/** Rolling window for request budget tally (5 minutes). */
+export declare const ADAPTIVE_RATE_WINDOW_MS: number;
+export declare const ADAPTIVE_THROTTLE_MIN_MS = 500;
+export declare const ADAPTIVE_THROTTLE_MAX_MS = 30000;
+export declare const ADAPTIVE_THROTTLE_DECREASE_MS = 100;
+export declare const ADAPTIVE_THROTTLE_INCREASE_FACTOR = 2;
+export declare const ADAPTIVE_BUDGET_SAFETY_RATIO = 0.8;
+export declare const ADAPTIVE_DEFAULT_INFERRED_BUDGET = 40;
+/**
+ * Minimum rolling-window requests observed at a 429 before shrinking inferred budget.
+ * Step-chain sync jobs may hit a limit after only a few HTTP calls in a fresh window;
+ * skipping early learning avoids permanent over-throttling.
+ */
+export declare const ADAPTIVE_MIN_REQUESTS_FOR_BUDGET_LEARNING = 8;
+export declare const DEFAULT_PROVIDER_THROTTLE_MS: Readonly<Record<string, number>>;
+/** Providers that run one BullMQ job per sync step (not one job per full sync). */
+export declare const STEP_CHAIN_SYNC_PROVIDERS: ReadonlySet<string>;
+/**
+ * Typical HTTP calls per step-chain sync job (auth refresh, bootstrap, one data call).
+ * Used to align BullMQ job pacing with HTTP-level adaptive budgets.
+ */
+export declare const DEFAULT_HTTP_REQUESTS_PER_SYNC_JOB: Readonly<Record<string, number>>;
+/** Seed inferred budgets for step-chain providers before the first 429 observation. */
+export declare const DEFAULT_PROVIDER_INFERRED_BUDGET: Readonly<Record<string, number>>;
+export interface StravaRateLimitQuota {
+    shortLimit: number;
+    shortUsage: number;
+    dailyLimit: number;
+    dailyUsage: number;
+}
+export interface ProviderAdaptiveRateState {
+    providerId: string;
+    scope: ProviderRateLimitScope;
+    userId: string | null;
+    windowStartMs: number;
+    requestCount: number;
+    throttleMs: number;
+    lastRequestMs: number | null;
+    inferredBudget: number | null;
+    observedCooldownSeconds: number | null;
+    stravaShortLimit: number | null;
+    stravaShortUsage: number | null;
+    stravaDailyLimit: number | null;
+    stravaDailyUsage: number | null;
+}
+export type { AdaptiveRateLimitStore } from "./rate-limit-types.ts";
+export declare function defaultThrottleMs(providerId: string): number;
+export declare function defaultInferredBudget(providerId: string): number | null;
+export declare function httpRequestsPerSyncJob(providerId: string): number;
+export declare function isStepChainSyncProvider(providerId: string): boolean;
+export declare function parseStravaRateLimitHeaders(headers: Headers): StravaRateLimitQuota | null;
+export declare function blendObservedCooldown(previous: number | null, observedSeconds: number): number;
+export declare function slideAdaptiveWindow(state: ProviderAdaptiveRateState, nowMs: number): ProviderAdaptiveRateState;
+export declare function decreaseThrottleMs(throttleMs: number): number;
+export declare function increaseThrottleMs(throttleMs: number): number;
+export declare function learnInferredBudget(current: number | null, requestsAtLimit: number, providerId?: string): number | null;
+export declare function admissionDelayMs(state: ProviderAdaptiveRateState, nowMs: number): number;
+export declare function throttleDelayMs(state: ProviderAdaptiveRateState, nowMs: number): number;
+export declare function createInitialAdaptiveState(providerId: string, scope: ProviderRateLimitScope, userId: string | null, nowMs?: number): ProviderAdaptiveRateState;
+export declare function applyStravaQuota(state: ProviderAdaptiveRateState, quota: StravaRateLimitQuota): ProviderAdaptiveRateState;
+export declare function recordAdaptiveRequest(state: ProviderAdaptiveRateState, nowMs: number): ProviderAdaptiveRateState;
+/** Updates throttle timing without consuming a step-chain sync job budget slot. */
+export declare function recordAdaptiveThrottleTouch(state: ProviderAdaptiveRateState, nowMs: number): ProviderAdaptiveRateState;
+export declare function recordAdaptiveRateLimit(state: ProviderAdaptiveRateState, retryAfterSeconds: number | null | undefined): ProviderAdaptiveRateState;
+export declare const ADAPTIVE_RATE_STORAGE_KEY_PREFIX = "provider-adaptive-rate";
+export declare function adaptiveRateLimitStorageKey(providerId: string, scope: ProviderRateLimitScope, userId: string | null): string;
+export declare function serializeAdaptiveRateState(state: ProviderAdaptiveRateState): string;
+export declare function parseAdaptiveRateState(raw: string | null): ProviderAdaptiveRateState | null;
+//# sourceMappingURL=adaptive-rate-limit.d.ts.map

package/dist/adaptive-rate-limit.d.ts.map

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

package/dist/adaptive-rate-limit.js

@@ -0,0 +1,272 @@
+/** Rolling window for request budget tally (5 minutes). */
+export const ADAPTIVE_RATE_WINDOW_MS = 5 * 60 * 1000;
+export const ADAPTIVE_THROTTLE_MIN_MS = 500;
+export const ADAPTIVE_THROTTLE_MAX_MS = 30_000;
+export const ADAPTIVE_THROTTLE_DECREASE_MS = 100;
+export const ADAPTIVE_THROTTLE_INCREASE_FACTOR = 2;
+export const ADAPTIVE_BUDGET_SAFETY_RATIO = 0.8;
+export const ADAPTIVE_DEFAULT_INFERRED_BUDGET = 40;
+/**
+ * Minimum rolling-window requests observed at a 429 before shrinking inferred budget.
+ * Step-chain sync jobs may hit a limit after only a few HTTP calls in a fresh window;
+ * skipping early learning avoids permanent over-throttling.
+ */
+export const ADAPTIVE_MIN_REQUESTS_FOR_BUDGET_LEARNING = 8;
+export const DEFAULT_PROVIDER_THROTTLE_MS = {
+    strava: 10_000,
+    garmin: 5_000,
+    whoop: 1_000,
+};
+/** Providers that run one BullMQ job per sync step (not one job per full sync). */
+export const STEP_CHAIN_SYNC_PROVIDERS = new Set(["garmin", "whoop"]);
+/**
+ * Typical HTTP calls per step-chain sync job (auth refresh, bootstrap, one data call).
+ * Used to align BullMQ job pacing with HTTP-level adaptive budgets.
+ */
+export const DEFAULT_HTTP_REQUESTS_PER_SYNC_JOB = {
+    garmin: 2,
+    whoop: 3,
+};
+/** Seed inferred budgets for step-chain providers before the first 429 observation. */
+export const DEFAULT_PROVIDER_INFERRED_BUDGET = {
+    // Garmin's unofficial API is IP-based; keep the default budget conservative.
+    garmin: 20,
+    whoop: ADAPTIVE_DEFAULT_INFERRED_BUDGET,
+};
+export function defaultThrottleMs(providerId) {
+    return DEFAULT_PROVIDER_THROTTLE_MS[providerId] ?? 1_000;
+}
+export function defaultInferredBudget(providerId) {
+    return DEFAULT_PROVIDER_INFERRED_BUDGET[providerId] ?? null;
+}
+export function httpRequestsPerSyncJob(providerId) {
+    return DEFAULT_HTTP_REQUESTS_PER_SYNC_JOB[providerId] ?? 1;
+}
+export function isStepChainSyncProvider(providerId) {
+    return STEP_CHAIN_SYNC_PROVIDERS.has(providerId);
+}
+export function parseStravaRateLimitHeaders(headers) {
+    const limitHeader = headers.get("X-RateLimit-Limit");
+    const usageHeader = headers.get("X-RateLimit-Usage");
+    if (!limitHeader || !usageHeader)
+        return null;
+    const [shortLimitRaw, dailyLimitRaw] = limitHeader.split(",");
+    const [shortUsageRaw, dailyUsageRaw] = usageHeader.split(",");
+    const shortLimit = Number.parseInt(shortLimitRaw ?? "", 10);
+    const dailyLimit = Number.parseInt(dailyLimitRaw ?? "", 10);
+    const shortUsage = Number.parseInt(shortUsageRaw ?? "", 10);
+    const dailyUsage = Number.parseInt(dailyUsageRaw ?? "", 10);
+    if (!Number.isFinite(shortLimit) ||
+        !Number.isFinite(dailyLimit) ||
+        !Number.isFinite(shortUsage) ||
+        !Number.isFinite(dailyUsage)) {
+        return null;
+    }
+    return { shortLimit, shortUsage, dailyLimit, dailyUsage };
+}
+export function blendObservedCooldown(previous, observedSeconds) {
+    if (!Number.isFinite(observedSeconds) || observedSeconds <= 0)
+        return previous ?? observedSeconds;
+    if (previous == null)
+        return observedSeconds;
+    return Math.round(previous * 0.7 + observedSeconds * 0.3);
+}
+export function slideAdaptiveWindow(state, nowMs) {
+    if (nowMs - state.windowStartMs < ADAPTIVE_RATE_WINDOW_MS)
+        return state;
+    return {
+        ...state,
+        windowStartMs: nowMs,
+        requestCount: 0,
+    };
+}
+export function decreaseThrottleMs(throttleMs) {
+    return Math.max(ADAPTIVE_THROTTLE_MIN_MS, throttleMs - ADAPTIVE_THROTTLE_DECREASE_MS);
+}
+export function increaseThrottleMs(throttleMs) {
+    return Math.min(ADAPTIVE_THROTTLE_MAX_MS, throttleMs * ADAPTIVE_THROTTLE_INCREASE_FACTOR);
+}
+export function learnInferredBudget(current, requestsAtLimit, providerId) {
+    if (requestsAtLimit <= 0)
+        return current;
+    if (requestsAtLimit < ADAPTIVE_MIN_REQUESTS_FOR_BUDGET_LEARNING) {
+        return current ?? (providerId ? defaultInferredBudget(providerId) : null);
+    }
+    const candidate = Math.max(1, requestsAtLimit - 1);
+    if (current == null)
+        return candidate;
+    return Math.min(current, candidate);
+}
+export function admissionDelayMs(state, nowMs) {
+    let delayMs = Math.max(throttleDelayMs(state, nowMs), budgetAdmissionDelayMs(state));
+    if (state.providerId === "strava" &&
+        state.stravaShortLimit != null &&
+        state.stravaShortUsage != null) {
+        const remaining = state.stravaShortLimit - state.stravaShortUsage;
+        if (remaining <= 2) {
+            delayMs = Math.max(delayMs, state.throttleMs * 4);
+        }
+        else if (remaining <= 5) {
+            delayMs = Math.max(delayMs, state.throttleMs * 2);
+        }
+        else {
+            const windowMs = 15 * 60 * 1000;
+            const pacedDelay = Math.ceil(windowMs / remaining);
+            delayMs = Math.max(delayMs, Math.min(pacedDelay, ADAPTIVE_THROTTLE_MAX_MS));
+        }
+    }
+    return delayMs;
+}
+export function throttleDelayMs(state, nowMs) {
+    if (state.lastRequestMs == null)
+        return 0;
+    const elapsed = nowMs - state.lastRequestMs;
+    return elapsed < state.throttleMs ? state.throttleMs - elapsed : 0;
+}
+function budgetAdmissionDelayMs(state) {
+    if (state.inferredBudget == null)
+        return 0;
+    const softCap = Math.floor(state.inferredBudget * ADAPTIVE_BUDGET_SAFETY_RATIO);
+    const effectiveRequestCount = isStepChainSyncProvider(state.providerId)
+        ? Math.ceil(state.requestCount / httpRequestsPerSyncJob(state.providerId))
+        : state.requestCount;
+    const effectiveSoftCap = isStepChainSyncProvider(state.providerId)
+        ? Math.max(1, Math.floor(softCap / httpRequestsPerSyncJob(state.providerId)))
+        : softCap;
+    if (effectiveRequestCount >= effectiveSoftCap) {
+        return state.throttleMs;
+    }
+    return 0;
+}
+export function createInitialAdaptiveState(providerId, scope, userId, nowMs = Date.now()) {
+    return {
+        providerId,
+        scope,
+        userId,
+        windowStartMs: nowMs,
+        requestCount: 0,
+        throttleMs: defaultThrottleMs(providerId),
+        lastRequestMs: null,
+        inferredBudget: defaultInferredBudget(providerId),
+        observedCooldownSeconds: null,
+        stravaShortLimit: null,
+        stravaShortUsage: null,
+        stravaDailyLimit: null,
+        stravaDailyUsage: null,
+    };
+}
+export function applyStravaQuota(state, quota) {
+    return {
+        ...state,
+        stravaShortLimit: quota.shortLimit,
+        stravaShortUsage: quota.shortUsage,
+        stravaDailyLimit: quota.dailyLimit,
+        stravaDailyUsage: quota.dailyUsage,
+    };
+}
+export function recordAdaptiveRequest(state, nowMs) {
+    const slid = slideAdaptiveWindow(state, nowMs);
+    return {
+        ...slid,
+        requestCount: slid.requestCount + 1,
+        lastRequestMs: nowMs,
+        throttleMs: decreaseThrottleMs(slid.throttleMs),
+    };
+}
+/** Updates throttle timing without consuming a step-chain sync job budget slot. */
+export function recordAdaptiveThrottleTouch(state, nowMs) {
+    const slid = slideAdaptiveWindow(state, nowMs);
+    return {
+        ...slid,
+        lastRequestMs: nowMs,
+        throttleMs: decreaseThrottleMs(slid.throttleMs),
+    };
+}
+export function recordAdaptiveRateLimit(state, retryAfterSeconds) {
+    const observedCooldown = retryAfterSeconds != null && retryAfterSeconds > 0
+        ? blendObservedCooldown(state.observedCooldownSeconds, retryAfterSeconds)
+        : state.observedCooldownSeconds;
+    return {
+        ...state,
+        throttleMs: increaseThrottleMs(state.throttleMs),
+        inferredBudget: learnInferredBudget(state.inferredBudget, state.requestCount, state.providerId),
+        observedCooldownSeconds: observedCooldown,
+    };
+}
+export const ADAPTIVE_RATE_STORAGE_KEY_PREFIX = "provider-adaptive-rate";
+export function adaptiveRateLimitStorageKey(providerId, scope, userId) {
+    return scope === "provider"
+        ? `${ADAPTIVE_RATE_STORAGE_KEY_PREFIX}:${providerId}:provider`
+        : `${ADAPTIVE_RATE_STORAGE_KEY_PREFIX}:${providerId}:user:${userId ?? "unknown"}`;
+}
+export function serializeAdaptiveRateState(state) {
+    return JSON.stringify(state);
+}
+export function parseAdaptiveRateState(raw) {
+    if (!raw)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const providerId = Reflect.get(parsed, "providerId");
+    const scope = Reflect.get(parsed, "scope");
+    const userId = Reflect.get(parsed, "userId");
+    const windowStartMs = Reflect.get(parsed, "windowStartMs");
+    const requestCount = Reflect.get(parsed, "requestCount");
+    const throttleMs = Reflect.get(parsed, "throttleMs");
+    const lastRequestMs = Reflect.get(parsed, "lastRequestMs");
+    const inferredBudget = Reflect.get(parsed, "inferredBudget");
+    const observedCooldownSeconds = Reflect.get(parsed, "observedCooldownSeconds");
+    const stravaShortLimit = Reflect.get(parsed, "stravaShortLimit");
+    const stravaShortUsage = Reflect.get(parsed, "stravaShortUsage");
+    const stravaDailyLimit = Reflect.get(parsed, "stravaDailyLimit");
+    const stravaDailyUsage = Reflect.get(parsed, "stravaDailyUsage");
+    if (typeof providerId !== "string")
+        return null;
+    if (scope !== "provider" && scope !== "user")
+        return null;
+    if (userId !== null && typeof userId !== "string")
+        return null;
+    if (typeof windowStartMs !== "number" || !Number.isFinite(windowStartMs))
+        return null;
+    if (typeof requestCount !== "number" || !Number.isFinite(requestCount))
+        return null;
+    if (typeof throttleMs !== "number" || !Number.isFinite(throttleMs))
+        return null;
+    if (lastRequestMs !== null &&
+        (typeof lastRequestMs !== "number" || !Number.isFinite(lastRequestMs))) {
+        return null;
+    }
+    return {
+        providerId,
+        scope,
+        userId,
+        windowStartMs,
+        requestCount,
+        throttleMs,
+        lastRequestMs,
+        inferredBudget: typeof inferredBudget === "number" && Number.isFinite(inferredBudget) ? inferredBudget : null,
+        observedCooldownSeconds: typeof observedCooldownSeconds === "number" && Number.isFinite(observedCooldownSeconds)
+            ? observedCooldownSeconds
+            : null,
+        stravaShortLimit: typeof stravaShortLimit === "number" && Number.isFinite(stravaShortLimit)
+            ? stravaShortLimit
+            : null,
+        stravaShortUsage: typeof stravaShortUsage === "number" && Number.isFinite(stravaShortUsage)
+            ? stravaShortUsage
+            : null,
+        stravaDailyLimit: typeof stravaDailyLimit === "number" && Number.isFinite(stravaDailyLimit)
+            ? stravaDailyLimit
+            : null,
+        stravaDailyUsage: typeof stravaDailyUsage === "number" && Number.isFinite(stravaDailyUsage)
+            ? stravaDailyUsage
+            : null,
+    };
+}
+//# sourceMappingURL=adaptive-rate-limit.js.map

package/dist/adaptive-rate-limit.js.map

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

package/dist/rate-limit-types.d.ts

@@ -0,0 +1,45 @@
+export type ProviderRateLimitScope = "provider" | "user";
+export type ProviderHttpErrorScope = ProviderRateLimitScope;
+export interface ProviderRateLimitErrorOptions {
+    message: string;
+    providerId: string;
+    statusCode: number;
+    responseBody: string;
+    scope?: ProviderRateLimitScope;
+    userId?: string | null;
+    retryAfterSeconds?: number | null;
+}
+export interface ProviderServiceUnavailableErrorOptions {
+    message: string;
+    providerId: string;
+    statusCode: number;
+    responseBody: string;
+    scope?: ProviderHttpErrorScope;
+    userId?: string | null;
+    retryAfterSeconds?: number | null;
+}
+export declare class ProviderRateLimitError extends Error {
+    readonly providerId: string;
+    readonly statusCode: number;
+    readonly responseBody: string;
+    readonly scope: ProviderRateLimitScope;
+    readonly userId: string | null;
+    readonly retryAfterSeconds: number | null;
+    constructor(options: ProviderRateLimitErrorOptions);
+}
+export declare class ProviderServiceUnavailableError extends Error {
+    readonly providerId: string;
+    readonly statusCode: number;
+    readonly responseBody: string;
+    readonly scope: ProviderHttpErrorScope;
+    readonly userId: string | null;
+    readonly retryAfterSeconds: number | null;
+    constructor(options: ProviderServiceUnavailableErrorOptions);
+}
+export interface AdaptiveRateLimitStore {
+    awaitAdmission(providerId: string, scope: ProviderRateLimitScope, userId: string | null): Promise<void>;
+    recordSuccess(providerId: string, scope: ProviderRateLimitScope, userId: string | null, responseHeaders?: Headers): Promise<void>;
+    recordRateLimit(error: ProviderRateLimitError): Promise<void>;
+    getLearnedCooldownSeconds(providerId: string): Promise<number | null>;
+}
+//# sourceMappingURL=rate-limit-types.d.ts.map

package/dist/rate-limit-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-types.d.ts","sourceRoot":"","sources":["../src/rate-limit-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,MAAM,CAAC;AACzD,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE5D,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sCAAsC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE9B,OAAO,EAAE,6BAA6B;CAUnD;AAED,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE9B,OAAO,EAAE,sCAAsC;CAU5D;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvE"}

package/dist/rate-limit-types.js

@@ -0,0 +1,37 @@
+export class ProviderRateLimitError extends Error {
+    providerId;
+    statusCode;
+    responseBody;
+    scope;
+    userId;
+    retryAfterSeconds;
+    constructor(options) {
+        super(options.message);
+        this.name = "ProviderRateLimitError";
+        this.providerId = options.providerId;
+        this.statusCode = options.statusCode;
+        this.responseBody = options.responseBody;
+        this.scope = options.scope ?? "provider";
+        this.userId = options.userId ?? null;
+        this.retryAfterSeconds = options.retryAfterSeconds ?? null;
+    }
+}
+export class ProviderServiceUnavailableError extends Error {
+    providerId;
+    statusCode;
+    responseBody;
+    scope;
+    userId;
+    retryAfterSeconds;
+    constructor(options) {
+        super(options.message);
+        this.name = "ProviderServiceUnavailableError";
+        this.providerId = options.providerId;
+        this.statusCode = options.statusCode;
+        this.responseBody = options.responseBody;
+        this.scope = options.scope ?? "provider";
+        this.userId = options.userId ?? null;
+        this.retryAfterSeconds = options.retryAfterSeconds ?? null;
+    }
+}
+//# sourceMappingURL=rate-limit-types.js.map

package/dist/rate-limit-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-types.js","sourceRoot":"","sources":["../src/rate-limit-types.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,YAAY,CAAS;IACrB,KAAK,CAAyB;IAC9B,MAAM,CAAgB;IACtB,iBAAiB,CAAgB;IAE1C,YAAY,OAAsC;QAChD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAC/C,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,YAAY,CAAS;IACrB,KAAK,CAAyB;IAC9B,MAAM,CAAgB;IACtB,iBAAiB,CAAgB;IAE1C,YAAY,OAA+C;QACzD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;IAC7D,CAAC;CACF"}

package/dist/rate-limit.d.ts

@@ -0,0 +1,26 @@
+import type { AdaptiveRateLimitStore } from "./rate-limit-types.ts";
+import { ProviderRateLimitError, type ProviderRateLimitScope, ProviderServiceUnavailableError } from "./rate-limit-types.ts";
+export type { AdaptiveRateLimitStore, ProviderHttpErrorScope, ProviderRateLimitErrorOptions, ProviderRateLimitScope, ProviderServiceUnavailableErrorOptions, } from "./rate-limit-types.ts";
+export { ProviderRateLimitError, ProviderServiceUnavailableError };
+export interface FetchRateLimitHandlingOptions {
+    createRateLimitError: (response: Response, responseBody: string) => Error;
+    createServiceUnavailableError?: (response: Response, responseBody: string) => Error;
+}
+export interface RateLimitAwareFetchOptions {
+    providerId: string;
+    scope?: ProviderRateLimitScope;
+    userId?: string | null;
+    createRateLimitError?: (response: Response, responseBody: string) => Error;
+    createServiceUnavailableError?: (response: Response, responseBody: string) => Error;
+    adaptiveStore?: AdaptiveRateLimitStore;
+}
+/**
+ * Parses an HTTP `Retry-After` header value, which may be either a number of
+ * seconds or an HTTP-date. Returns the delay in seconds, or null when absent or
+ * unparseable.
+ */
+export declare function parseRetryAfterHeader(header: string | null | undefined): number | null;
+export declare function isServiceUnavailableStatus(statusCode: number): boolean;
+export declare function fetchWithRateLimitHandling(fetchFn: typeof globalThis.fetch, input: RequestInfo | URL, init: RequestInit | undefined, options: FetchRateLimitHandlingOptions): Promise<Response>;
+export declare function createRateLimitAwareFetch(fetchFn: typeof globalThis.fetch, options: RateLimitAwareFetchOptions): typeof globalThis.fetch;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,+BAA+B,EAChC,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,sCAAsC,GACvC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,CAAC;AAEnE,MAAM,WAAW,6BAA6B;IAC5C,oBAAoB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,KAAK,KAAK,CAAC;IAC1E,6BAA6B,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,KAAK,KAAK,CAAC;CACrF;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,KAAK,KAAK,CAAC;IAC3E,6BAA6B,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,KAAK,KAAK,CAAC;IACpF,aAAa,CAAC,EAAE,sBAAsB,CAAC;CACxC;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUtF;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,OAAO,UAAU,CAAC,KAAK,EAChC,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,QAAQ,CAAC,CAqBnB;AAsCD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,UAAU,CAAC,KAAK,EAChC,OAAO,EAAE,0BAA0B,GAClC,OAAO,UAAU,CAAC,KAAK,CA+CzB"}

package/dist/rate-limit.js

@@ -0,0 +1,90 @@
+import { ProviderRateLimitError, ProviderServiceUnavailableError, } from "./rate-limit-types.js";
+export { ProviderRateLimitError, ProviderServiceUnavailableError };
+const rateLimitAwareFetches = new WeakSet();
+/**
+ * Parses an HTTP `Retry-After` header value, which may be either a number of
+ * seconds or an HTTP-date. Returns the delay in seconds, or null when absent or
+ * unparseable.
+ */
+export function parseRetryAfterHeader(header) {
+    if (!header)
+        return null;
+    const seconds = Number.parseInt(header, 10);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return seconds;
+    const retryAt = Date.parse(header);
+    if (Number.isNaN(retryAt))
+        return null;
+    return Math.max(0, Math.ceil((retryAt - Date.now()) / 1000));
+}
+export function isServiceUnavailableStatus(statusCode) {
+    return statusCode === 502 || statusCode === 503 || statusCode === 504;
+}
+export async function fetchWithRateLimitHandling(fetchFn, input, init, options) {
+    const response = init === undefined ? await fetchFn(input) : await fetchFn(input, init);
+    if (response.status === 429) {
+        const responseBody = await response.text();
+        throw options.createRateLimitError(response, responseBody);
+    }
+    if (isServiceUnavailableStatus(response.status)) {
+        const responseBody = await response.text();
+        const createServiceUnavailableError = options.createServiceUnavailableError ??
+            ((unavailableResponse, unavailableResponseBody) => createDefaultServiceUnavailableError("unknown", "provider", null, unavailableResponse, unavailableResponseBody));
+        throw createServiceUnavailableError(response, responseBody);
+    }
+    return response;
+}
+function createDefaultRateLimitError(providerId, scope, userId, response, responseBody) {
+    return new ProviderRateLimitError({
+        message: `${providerId} API rate limit exceeded (${response.status}): ${responseBody}`,
+        providerId,
+        statusCode: response.status,
+        responseBody,
+        scope,
+        userId,
+        retryAfterSeconds: parseRetryAfterHeader(response.headers.get("Retry-After")),
+    });
+}
+function createDefaultServiceUnavailableError(providerId, scope, userId, response, responseBody) {
+    return new ProviderServiceUnavailableError({
+        message: `${providerId} API service unavailable (${response.status}): ${responseBody}`,
+        providerId,
+        statusCode: response.status,
+        responseBody,
+        scope,
+        userId,
+        retryAfterSeconds: parseRetryAfterHeader(response.headers.get("Retry-After")),
+    });
+}
+export function createRateLimitAwareFetch(fetchFn, options) {
+    if (rateLimitAwareFetches.has(fetchFn))
+        return fetchFn;
+    const rateLimitFetch = async (input, init) => {
+        const scope = options.scope ?? "provider";
+        const userId = options.userId ?? null;
+        if (options.adaptiveStore) {
+            await options.adaptiveStore.awaitAdmission(options.providerId, scope, userId);
+        }
+        try {
+            const response = await fetchWithRateLimitHandling(fetchFn, input, init, {
+                createRateLimitError: options.createRateLimitError ??
+                    ((response, responseBody) => createDefaultRateLimitError(options.providerId, scope, userId, response, responseBody)),
+                createServiceUnavailableError: options.createServiceUnavailableError ??
+                    ((response, responseBody) => createDefaultServiceUnavailableError(options.providerId, scope, userId, response, responseBody)),
+            });
+            if (options.adaptiveStore && response.ok) {
+                await options.adaptiveStore.recordSuccess(options.providerId, scope, userId, response.headers);
+            }
+            return response;
+        }
+        catch (err) {
+            if (options.adaptiveStore && err instanceof ProviderRateLimitError) {
+                await options.adaptiveStore.recordRateLimit(err);
+            }
+            throw err;
+        }
+    };
+    rateLimitAwareFetches.add(rateLimitFetch);
+    return rateLimitFetch;
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@dofek/provider-http",
+  "version": "0.1.0",
+  "description": "Rate-limit-aware Fetch utilities and typed provider HTTP errors",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Asherlc/dofek.git",
+    "directory": "packages/provider-http"
+  },
+  "homepage": "https://github.com/Asherlc/dofek/tree/main/packages/provider-http#readme",
+  "bugs": "https://github.com/Asherlc/dofek/issues",
+  "keywords": [
+    "fetch",
+    "http",
+    "rate-limit",
+    "retry-after",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/rate-limit.d.ts",
+      "import": "./dist/rate-limit.js"
+    },
+    "./rate-limit": {
+      "types": "./dist/rate-limit.d.ts",
+      "import": "./dist/rate-limit.js"
+    },
+    "./adaptive-rate-limit": {
+      "types": "./dist/adaptive-rate-limit.d.ts",
+      "import": "./dist/adaptive-rate-limit.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepack": "pnpm run build",
+    "test": "vitest run src",
+    "typecheck": "tsc --noEmit"
+  },
+  "gitHead": "ac95258c753c7e75b57da7ae47426d22b78e8c01"
+}