@distilled.cloud/core 0.16.1 → 0.16.3

package/lib/retry-after.js

@@ -0,0 +1,112 @@
+/**
+ * Server-provided retry hint parsing.
+ *
+ * Standardizes parsing of:
+ *   - `Retry-After` (RFC 7231 §7.1.3): `delay-seconds` (integer) or `HTTP-date`.
+ *   - `RateLimit` (IETF draft-ietf-httpapi-ratelimit-headers): structured
+ *     dictionary `r=<remaining>, t=<seconds-until-reset>`.
+ *
+ * Each SDK's `matchError` calls these helpers and attaches the resulting
+ * `Duration` to retryable errors via the optional `retryAfter` field, where
+ * the retry policy will honor it with precedence over the default backoff.
+ *
+ * Services that use bespoke headers or body fields are expected to do their
+ * own parsing in the SDK's `matchError`, optionally falling back to these
+ * helpers for the standard cases.
+ */
+import * as Duration from "effect/Duration";
+import { RETRYABLE_HTTP_STATUSES } from "./errors.js";
+/**
+ * Parse the standard `Retry-After` HTTP header per RFC 7231 §7.1.3.
+ *
+ * Accepts either a non-negative integer number of seconds (the common case)
+ * or an HTTP-date. HTTP-dates in the past produce a zero duration.
+ *
+ * Returns `undefined` when the header is missing or unparseable.
+ */
+export const parseRetryAfter = (headers) => {
+    const raw = headers?.["retry-after"];
+    if (!raw)
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    // delay-seconds: 1*DIGIT (non-negative decimal integer per RFC).
+    if (/^\d+$/.test(trimmed)) {
+        const seconds = Number(trimmed);
+        if (Number.isFinite(seconds) && seconds >= 0) {
+            return Duration.seconds(seconds);
+        }
+    }
+    // Reject anything that *looks* numeric but isn't a valid delay-seconds.
+    // Without this, `Date.parse("-5")` happens to return 0 on some engines and
+    // would silently yield a zero-duration instead of the expected undefined.
+    if (/^[-+]?\d+(?:\.\d+)?$/.test(trimmed))
+        return undefined;
+    // HTTP-date: try Date.parse, which handles RFC 1123 / RFC 850 / asctime.
+    const ts = Date.parse(trimmed);
+    if (!Number.isNaN(ts)) {
+        const ms = Math.max(0, ts - Date.now());
+        return Duration.millis(ms);
+    }
+    return undefined;
+};
+/**
+ * Parse the IETF `RateLimit` structured header.
+ *
+ * Examples:
+ *   `RateLimit: limit=100, remaining=0, reset=30`           (older draft)
+ *   `RateLimit: "default";r=0;t=30`                          (newer draft)
+ *   `RateLimit: r=0, t=30`                                   (compact form)
+ *
+ * Returns the `t` (seconds until reset) value as a Duration, but only when
+ * `r` (remaining quota) is present and equals `0` — i.e., we're actually
+ * rate-limited right now. Returns `undefined` otherwise.
+ */
+export const parseRatelimit = (headers) => {
+    const raw = headers?.["ratelimit"];
+    if (!raw)
+        return undefined;
+    let remaining;
+    let reset;
+    // Tokenize on commas and semicolons; tolerate `key=value` and `key =value`.
+    for (const piece of raw.split(/[,;]/)) {
+        const eq = piece.indexOf("=");
+        if (eq < 0)
+            continue;
+        const key = piece.slice(0, eq).trim().toLowerCase();
+        const value = piece.slice(eq + 1).trim();
+        const num = Number(value);
+        if (!Number.isFinite(num))
+            continue;
+        if (key === "r" || key === "remaining")
+            remaining = num;
+        else if (key === "t" || key === "reset")
+            reset = num;
+    }
+    if (remaining !== undefined && remaining > 0)
+        return undefined;
+    if (reset === undefined || reset < 0)
+        return undefined;
+    return Duration.seconds(reset);
+};
+/**
+ * Convenience: try `Retry-After` first, then `RateLimit`. Returns the first
+ * successful parse, or `undefined` if neither header yields a usable value.
+ */
+export const parseServerRetryHint = (headers) => parseRetryAfter(headers) ?? parseRatelimit(headers);
+/**
+ * Status-gated variant of {@link parseServerRetryHint}. Returns `undefined`
+ * unless `status` is one whose error class actually declares a `retryAfter`
+ * field (see `RETRYABLE_HTTP_STATUSES`). Use this in `matchError` when you
+ * dispatch off a generic `HTTP_STATUS_MAP` lookup that includes both
+ * retryable (429/5xx/423) and non-retryable (4xx) classes — it prevents
+ * stale `retryAfter` properties from being attached to errors like
+ * `BadRequest` or `NotFound` (which would otherwise leak into JSON output).
+ */
+export const parseRetryAfterForStatus = (status, headers) => {
+    if (!RETRYABLE_HTTP_STATUSES.has(status))
+        return undefined;
+    return parseServerRetryHint(headers);
+};
+//# sourceMappingURL=retry-after.js.map

package/lib/retry-after.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.js","sourceRoot":"","sources":["../src/retry-after.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAWtD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAgB,EACe,EAAE;IACjC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,iEAAiE;IACjE,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC7C,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,2EAA2E;IAC3E,0EAA0E;IAC1E,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3D,yEAAyE;IACzE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAgB,EACe,EAAE;IACjC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,IAAI,SAA6B,CAAC;IAClC,IAAI,KAAyB,CAAC;IAE9B,4EAA4E;IAC5E,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAEpC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,WAAW;YAAE,SAAS,GAAG,GAAG,CAAC;aACnD,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,OAAO;YAAE,KAAK,GAAG,GAAG,CAAC;IACvD,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAAgB,EACe,EAAE,CACjC,eAAe,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,MAAc,EACd,OAAgB,EACe,EAAE;IACjC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/lib/retry.d.ts

@@ -2,22 +2,13 @@
  * Retry Policy System
  *
  * Provides configurable retry policies for API operations.
- * Each SDK creates its own Retry service tag but uses these shared utilities
- * for building retry schedules and policies.
- *
- * @example
- * ```ts
- * import * as Retry from "@distilled.cloud/core/retry";
- *
- * // Use the default retry policy
- * myEffect.pipe(Retry.policy(myRetryService, Retry.makeDefault()))
- *
- * // Disable retries
- * myEffect.pipe(Retry.none(myRetryService))
- * ```
+ * Each SDK creates its own `Retry` Context.Service tag (via
+ * `makeRetryService`) and threads it into `makeAPI({ retry: <SDK>.Retry })`
+ * so that callers can install a blanket retry policy at the layer level
+ * for that SDK without wrapping every call with `Effect.retry`.
  */
 import * as Duration from "effect/Duration";
-import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
 import * as Ref from "effect/Ref";
 import * as Schedule from "effect/Schedule";
 import * as Context from "effect/Context";
@@ -45,23 +36,17 @@ export type Factory = (lastError: Ref.Ref<unknown>) => Options;
 export type Policy = Options | Factory;
 /**
  * Create a typed Retry service class for an SDK.
- * Each SDK should create its own Retry service using this factory.
+ * Each SDK creates its own Retry service using this factory; the SDK's
+ * client wraps `makeAPI` with `retry: <SDK>.Retry` so the policy applies
+ * to every API call below it.
  *
  * @example
  * ```ts
- * // In planetscale-sdk/src/retry.ts
+ * // packages/<sdk>/src/retry.ts
  * export class Retry extends makeRetryService("PlanetScaleRetry") {}
  * ```
  */
 export declare const makeRetryService: (name: string) => Context.ServiceClass<any, string, Policy>;
-/**
- * Provides a custom retry policy for API calls.
- */
-export declare const policy: (Service: any, optionsOrFactory: Policy) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, unknown, unknown>;
-/**
- * Disables all automatic retries.
- */
-export declare const none: (Service: any) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, unknown, unknown>;
 /**
  * Custom jittered schedule helper.
  * Adds random jitter between 0-50ms to avoid thundering herd.
@@ -71,21 +56,70 @@ export declare const jittered: <Input, Error, Env>(self: Schedule.Schedule<unkno
  * Cap delay at a maximum duration.
  */
 export declare const capped: (max: Duration.Duration) => <Input, Error, Env>(self: Schedule.Schedule<Duration.Duration, Input, Error, Env>) => Schedule.Schedule<Duration.Duration, Input, Error, Env>;
+/**
+ * Default cap (milliseconds) on how long we'll honor a server-provided
+ * `Retry-After` / `RateLimit` hint. A misbehaving server can otherwise park
+ * us forever.
+ */
+export declare const DEFAULT_SERVER_RETRY_HINT_CAP_MS = 60000;
+/**
+ * Optional override for the server-hint cap, in milliseconds. When provided
+ * via `Layer.succeed(ServerRetryHintCapMs, n)`, that value wins over the
+ * environment.
+ *
+ * @example
+ * ```ts
+ * Effect.retry(op, policy).pipe(
+ *   Effect.provide(serverRetryHintCapLayer(120_000)),
+ * )
+ * ```
+ */
+export declare const ServerRetryHintCapMs: Context.Service<number, number>;
+/**
+ * Layer that pins the server `retryAfter` cap to a fixed value (milliseconds).
+ */
+export declare const serverRetryHintCapLayer: (capMs: number) => Layer.Layer<number, never, never>;
+/**
+ * Effective cap when neither {@link ServerRetryHintCapMs} nor
+ * `DISTILLED_SERVER_RETRY_HINT_CAP_MS` is set: {@link DEFAULT_SERVER_RETRY_HINT_CAP_MS}.
+ *
+ * Reads `process.env.DISTILLED_SERVER_RETRY_HINT_CAP_MS` when present (must be
+ * a non-negative finite integer; invalid values are ignored). Undefined
+ * `process` (some edge runtimes) falls back to the default.
+ */
+export declare const readServerRetryHintCapMsFromEnv: () => number;
 /**
  * Creates the default retry policy.
  *
  * This policy:
  * - Retries transient errors (throttling, server, network, locked errors)
- * - Uses exponential backoff starting at 100ms with a factor of 2
+ * - Honors `error.retryAfter` (server-provided hint) with precedence, capped
+ *   by {@link DEFAULT_SERVER_RETRY_HINT_CAP_MS} by default; override with
+ *   `DISTILLED_SERVER_RETRY_HINT_CAP_MS` or {@link ServerRetryHintCapMs}
+ * - Otherwise uses exponential backoff starting at 100ms with a factor of 2
  * - Ensures at least 500ms delay for throttling errors
  * - Limits to 5 retry attempts
  * - Applies jitter to avoid thundering herd
  */
 export declare const makeDefault: Factory;
+/**
+ * Factory for the throttling-only retry policy. Honors server hints when
+ * present so callers using `<SDK>.Retry.throttling` get correct backoff.
+ */
+export declare const throttlingFactory: Factory;
 /**
  * Retry options that retries all throttling errors indefinitely.
+ *
+ * Note: prefer {@link throttlingFactory} when you want server-hint honoring.
+ * This static `Options` form does not have access to `lastError` and so
+ * cannot read `error.retryAfter`.
  */
 export declare const throttlingOptions: Options;
+/**
+ * Factory for the transient retry policy. Honors server hints when present
+ * so callers using `<SDK>.Retry.transient` get correct backoff.
+ */
+export declare const transientFactory: Factory;
 /**
  * Retry options that retries all transient errors indefinitely.
  *
@@ -94,6 +128,8 @@ export declare const throttlingOptions: Options;
  * 2. Server errors
  * 3. Network errors
  * 4. Locked errors (423)
+ *
+ * Note: prefer {@link transientFactory} when you want server-hint honoring.
  */
 export declare const transientOptions: Options;
 //# sourceMappingURL=retry.d.ts.map

package/lib/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAO1C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAMvC;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,SAAU,MAAM,8CACP,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,MAAM,YACP,GAAG,oBAAoB,MAAM,MACtC,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,uCACiC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,IAAI,YACL,GAAG,MACZ,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,uCAIrC,CAAC;AAMN;;;GAGG;AACH,eAAO,MAAM,QAAQ,2HAEpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,QAAS,QAAQ,CAAC,QAAQ,kJAK1C,CAAC;AAMJ;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,OAkBxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAO/B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAO9B,CAAC"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAO1C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAMvC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,SAAU,MAAM,8CACP,CAAC;AAMvC;;;GAGG;AACH,eAAO,MAAM,QAAQ,2HAEpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,QAAS,QAAQ,CAAC,QAAQ,kJAK1C,CAAC;AAMJ;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAIvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,iCAEhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAAW,MAAM,sCACT,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,QAAO,MASlD,CAAC;AAwDF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,EAAE,OAaxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAQ9B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAO/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAQ7B,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAO9B,CAAC"}

package/lib/retry.js

@@ -2,24 +2,16 @@
  * Retry Policy System
  *
  * Provides configurable retry policies for API operations.
- * Each SDK creates its own Retry service tag but uses these shared utilities
- * for building retry schedules and policies.
- *
- * @example
- * ```ts
- * import * as Retry from "@distilled.cloud/core/retry";
- *
- * // Use the default retry policy
- * myEffect.pipe(Retry.policy(myRetryService, Retry.makeDefault()))
- *
- * // Disable retries
- * myEffect.pipe(Retry.none(myRetryService))
- * ```
+ * Each SDK creates its own `Retry` Context.Service tag (via
+ * `makeRetryService`) and threads it into `makeAPI({ retry: <SDK>.Retry })`
+ * so that callers can install a blanket retry policy at the layer level
+ * for that SDK without wrapping every call with `Effect.retry`.
  */
 import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
 import { pipe } from "effect/Function";
 import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
 import * as Ref from "effect/Ref";
 import * as Schedule from "effect/Schedule";
 import * as Context from "effect/Context";
@@ -29,23 +21,17 @@ import { isThrottling, isTransientError } from "./category.js";
 // ============================================================================
 /**
  * Create a typed Retry service class for an SDK.
- * Each SDK should create its own Retry service using this factory.
+ * Each SDK creates its own Retry service using this factory; the SDK's
+ * client wraps `makeAPI` with `retry: <SDK>.Retry` so the policy applies
+ * to every API call below it.
  *
  * @example
  * ```ts
- * // In planetscale-sdk/src/retry.ts
+ * // packages/<sdk>/src/retry.ts
  * export class Retry extends makeRetryService("PlanetScaleRetry") {}
  * ```
  */
 export const makeRetryService = (name) => Context.Service()(name);
-/**
- * Provides a custom retry policy for API calls.
- */
-export const policy = (Service, optionsOrFactory) => (effect) => Effect.provide(effect, Layer.succeed(Service, optionsOrFactory));
-/**
- * Disables all automatic retries.
- */
-export const none = (Service) => (effect) => Effect.provide(effect, Layer.succeed(Service, { while: () => false }));
 // ============================================================================
 // Retry Schedule Utilities
 // ============================================================================
@@ -59,6 +45,91 @@ export const jittered = Schedule.addDelay(() => Effect.succeed(Duration.millis(M
  */
 export const capped = (max) => Schedule.modifyDelay((duration) => Effect.succeed(Duration.isGreaterThan(duration, max) ? Duration.millis(5000) : duration));
 // ============================================================================
+// Server Hint Helpers
+// ============================================================================
+/**
+ * Default cap (milliseconds) on how long we'll honor a server-provided
+ * `Retry-After` / `RateLimit` hint. A misbehaving server can otherwise park
+ * us forever.
+ */
+export const DEFAULT_SERVER_RETRY_HINT_CAP_MS = 60_000;
+const ENV_SERVER_RETRY_HINT_CAP_MS = "DISTILLED_SERVER_RETRY_HINT_CAP_MS";
+/**
+ * Optional override for the server-hint cap, in milliseconds. When provided
+ * via `Layer.succeed(ServerRetryHintCapMs, n)`, that value wins over the
+ * environment.
+ *
+ * @example
+ * ```ts
+ * Effect.retry(op, policy).pipe(
+ *   Effect.provide(serverRetryHintCapLayer(120_000)),
+ * )
+ * ```
+ */
+export const ServerRetryHintCapMs = Context.Service("@distilled.cloud/core/ServerRetryHintCapMs");
+/**
+ * Layer that pins the server `retryAfter` cap to a fixed value (milliseconds).
+ */
+export const serverRetryHintCapLayer = (capMs) => Layer.succeed(ServerRetryHintCapMs, capMs);
+/**
+ * Effective cap when neither {@link ServerRetryHintCapMs} nor
+ * `DISTILLED_SERVER_RETRY_HINT_CAP_MS` is set: {@link DEFAULT_SERVER_RETRY_HINT_CAP_MS}.
+ *
+ * Reads `process.env.DISTILLED_SERVER_RETRY_HINT_CAP_MS` when present (must be
+ * a non-negative finite integer; invalid values are ignored). Undefined
+ * `process` (some edge runtimes) falls back to the default.
+ */
+export const readServerRetryHintCapMsFromEnv = () => {
+    if (typeof process === "undefined" || process.env === undefined) {
+        return DEFAULT_SERVER_RETRY_HINT_CAP_MS;
+    }
+    const raw = process.env[ENV_SERVER_RETRY_HINT_CAP_MS];
+    if (raw === undefined || raw === "")
+        return DEFAULT_SERVER_RETRY_HINT_CAP_MS;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0)
+        return DEFAULT_SERVER_RETRY_HINT_CAP_MS;
+    return Math.trunc(n);
+};
+const resolveServerRetryHintCapMs = () => Effect.gen(function* () {
+    const fromLayer = yield* Effect.serviceOption(ServerRetryHintCapMs);
+    return Option.match(fromLayer, {
+        onNone: () => readServerRetryHintCapMsFromEnv(),
+        onSome: (n) => Number.isFinite(n) && n >= 0
+            ? Math.trunc(n)
+            : readServerRetryHintCapMsFromEnv(),
+    });
+});
+/**
+ * Extract a server-provided retry hint (in milliseconds) from an error's
+ * optional `retryAfter` field, capped by the effective server-hint cap
+ * (see {@link ServerRetryHintCapMs} and {@link readServerRetryHintCapMsFromEnv}).
+ *
+ * Returns `undefined` when the error doesn't carry a hint.
+ */
+const serverHintMillis = (error, capMs) => {
+    const hint = error
+        ?.retryAfter;
+    if (!Duration.isDuration(hint))
+        return undefined;
+    return Math.min(Duration.toMillis(hint), capMs);
+};
+/**
+ * Schedule modifier that honors `error.retryAfter` (set by the SDK's
+ * `matchError` from `Retry-After` / `RateLimit` headers) with precedence
+ * over the input delay. Falls back to the original delay when no hint is
+ * present.
+ */
+const honorServerHint = (lastError, baseline) => Schedule.modifyDelay(Effect.fnUntraced(function* (duration) {
+    const capMs = yield* resolveServerRetryHintCapMs();
+    const error = yield* Ref.get(lastError);
+    const hint = serverHintMillis(error, capMs);
+    if (hint !== undefined)
+        return hint;
+    const adjusted = baseline ? baseline(duration, error) : duration;
+    return Duration.toMillis(adjusted);
+}));
+// ============================================================================
 // Default Retry Policies
 // ============================================================================
 /**
@@ -66,30 +137,50 @@ export const capped = (max) => Schedule.modifyDelay((duration) => Effect.succeed
  *
  * This policy:
  * - Retries transient errors (throttling, server, network, locked errors)
- * - Uses exponential backoff starting at 100ms with a factor of 2
+ * - Honors `error.retryAfter` (server-provided hint) with precedence, capped
+ *   by {@link DEFAULT_SERVER_RETRY_HINT_CAP_MS} by default; override with
+ *   `DISTILLED_SERVER_RETRY_HINT_CAP_MS` or {@link ServerRetryHintCapMs}
+ * - Otherwise uses exponential backoff starting at 100ms with a factor of 2
  * - Ensures at least 500ms delay for throttling errors
  * - Limits to 5 retry attempts
  * - Applies jitter to avoid thundering herd
  */
 export const makeDefault = (lastError) => ({
     while: (error) => isTransientError(error),
-    schedule: pipe(Schedule.exponential(100, 2), Schedule.modifyDelay(Effect.fnUntraced(function* (duration) {
-        const error = yield* Ref.get(lastError);
-        if (isThrottling(error)) {
-            if (Duration.toMillis(duration) < 500) {
-                return Duration.toMillis(Duration.millis(500));
-            }
+    schedule: pipe(Schedule.exponential(100, 2), honorServerHint(lastError, (duration, error) => {
+        if (isThrottling(error) && Duration.toMillis(duration) < 500) {
+            return Duration.millis(500);
         }
-        return Duration.toMillis(duration);
-    })), Schedule.both(Schedule.recurs(5)), jittered),
+        return duration;
+    }), Schedule.both(Schedule.recurs(5)), jittered),
+});
+/**
+ * Factory for the throttling-only retry policy. Honors server hints when
+ * present so callers using `<SDK>.Retry.throttling` get correct backoff.
+ */
+export const throttlingFactory = (lastError) => ({
+    while: (error) => isThrottling(error),
+    schedule: pipe(Schedule.exponential(1000, 2), honorServerHint(lastError), capped(Duration.seconds(5)), jittered),
 });
 /**
  * Retry options that retries all throttling errors indefinitely.
+ *
+ * Note: prefer {@link throttlingFactory} when you want server-hint honoring.
+ * This static `Options` form does not have access to `lastError` and so
+ * cannot read `error.retryAfter`.
  */
 export const throttlingOptions = {
     while: (error) => isThrottling(error),
     schedule: pipe(Schedule.exponential(1000, 2), capped(Duration.seconds(5)), jittered),
 };
+/**
+ * Factory for the transient retry policy. Honors server hints when present
+ * so callers using `<SDK>.Retry.transient` get correct backoff.
+ */
+export const transientFactory = (lastError) => ({
+    while: isTransientError,
+    schedule: pipe(Schedule.exponential(1000, 2), honorServerHint(lastError), capped(Duration.seconds(5)), jittered),
+});
 /**
  * Retry options that retries all transient errors indefinitely.
  *
@@ -98,6 +189,8 @@ export const throttlingOptions = {
  * 2. Server errors
  * 3. Network errors
  * 4. Locked errors (423)
+ *
+ * Note: prefer {@link transientFactory} when you want server-hint honoring.
  */
 export const transientOptions = {
     while: isTransientError,

package/lib/retry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@distilled.cloud/core",
-  "version": "0.16.1",
+  "version": "0.16.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/alchemy-run/distilled",
@@ -43,6 +43,11 @@
       "bun": "./src/retry.ts",
       "default": "./lib/retry.js"
     },
+    "./retry-after": {
+      "types": "./lib/retry-after.d.ts",
+      "bun": "./src/retry-after.ts",
+      "default": "./lib/retry-after.js"
+    },
     "./sensitive": {
       "types": "./lib/sensitive.d.ts",
       "bun": "./src/sensitive.ts",