npm - @nextn/outbound-guard - Versions diffs - 0.1.2 → 0.1.3 - Mend

@nextn/outbound-guard 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md CHANGED Viewed

@@ -1,472 +1,136 @@
-# outbound-guard
-A small, opinionated **Node.js HTTP client** that protects your service from slow or failing upstreams by enforcing:
-- concurrency limits (in-flight cap)
-- bounded queue (backpressure)
-- request timeouts
-This is a **library**, not a service.
-It is **process-local**, **in-memory**, and intentionally simple.
----
-## Why this exists
-Most production outages don’t start inside your service.
-They start when you call **something you don’t control**:
-- partner APIs
-- payment gateways
-- internal services under load
-- flaky dependencies
-Without protection, outbound calls cause:
-- unbounded concurrency
-- growing queues
-- long tail latency
-- cascading failures
-`outbound-guard` puts **hard limits** around outbound HTTP calls so your Node.js process stays alive and predictable under stress.
----
-## What this library does (in practice)
-outbound-guard is built around a single idea:
-collapse duplicate work first, then apply limits.
-Most failures don’t come from too many different requests —
-they come from too many identical requests hitting a slow dependency.
-This library solves that problem before it escalates.
-For every outbound HTTP request, it enforces:
-### 1. GET micro-cache + request coalescing (core feature)
-This is the most important feature in `outbound-guard`.
-When enabled, identical GET requests are **collapsed into a single upstream call**.
-- One request becomes the **leader**
-- All others become **followers**
-- Only **one upstream request** is ever in flight
-- Followers either:
-  - receive cached data immediately, or
-  - fail fast when limits are reached
-This prevents the most common real-world failure mode:
-**thundering herds on slow but healthy upstreams**.
-This is not long-lived caching.
-It is **short-lived, in-process, burst protection**.
-### 2. Concurrency limits
-- At most `maxInFlight` requests execute at once.
-- Prevents connection exhaustion and event-loop overload.
-### 3. Bounded queue (backpressure)
-- Excess requests wait in a FIFO queue (up to `maxQueue`).
-- If the queue is full → **reject immediately**.
-- If waiting too long → **reject with a timeout**.
-Failing early is a feature.
-### 4. Request timeouts
-- Every request has a hard timeout via `AbortController`.
-- No hanging promises.
-### 5. Observability hooks
-- Emits lifecycle events (queueing, failures, breaker transitions)
-- Exposes a lightweight `snapshot()` for debugging
-No metrics backend required.
----
-## The failure mode this library is designed to stop
-#### Thundering herd on slow GET requests
-This is how many production incidents start:
-- Traffic spikes
-- Many requests trigger the **same GET**
-- The upstream slows down (not down — just slow)
-- Node starts N identical outbound requests
-- Queues grow, retries multiply, latency explodes
-- Eventually the process collapses
-Timeouts and retries don’t fix this.
-They **amplify it**.
-### What outbound-guard does differently
-With `microCache` enabled:
-- Only **one upstream GET** is ever in flight per key
-- All concurrent identical requests share it
-- While refreshing:
-  - previous data is served (within bounds)
-  - or failures surface quickly
-- Retries happen **once**, not per caller
-This keeps:
-- upstream traffic flat
-- latency predictable
-- failures visible instead of hidden
-This is **request coalescing**, not caching.
-## Why the micro-cache is intentionally different
-Most HTTP clients do one of two things:
-1. Cache aggressively and risk serving bad data
-2. Don’t cache at all and collapse under burst load
-`outbound-guard` does neither.
-Its micro-cache is:
-- GET-only
-- short-lived
-- bounded by time and memory
-- aware of in-flight requests
-The goal is **operational stability**, not freshness guarantees.
-If the upstream is:
-- slow → callers don’t pile up
-- failing → failures surface quickly
-- recovered → traffic resumes cleanly
-This design keeps failure behavior honest.
----
-## How to tune micro-cache safely
-Most users only need to understand **two knobs**.
----
-### `maxWaiters`
-Controls how many concurrent callers are allowed to wait for the leader.
-```ts
-maxWaiters: 10
-````
-* Low value → aggressive load shedding
-* High value → tolerate more fan-in
-If this fills quickly, it means:
-> “This upstream is too slow for current traffic.”
-That’s a signal, not a bug.
----
-### `followerTimeoutMs`
-Controls how long followers are willing to wait once.
-```ts
-followerTimeoutMs: 5000
-```
-* Followers wait at most once
-* No per-request retries
-* No silent backlog growth
-If this expires:
-* followers fail fast
-* queues drain
-* the system stays responsive
-This prevents **“slow death by waiting”**.
----
-## Retry settings (leader-only)
-Retries apply **only to the leader**.
-```ts
-retry: {
-  maxAttempts: 3,
-  baseDelayMs: 50,
-  maxDelayMs: 200,
-  retryOnStatus: [503],
-}
-```
-### What this means
-* **`maxAttempts`**
-  total leader tries (including first)
-* **`baseDelayMs`**
-  initial backoff
-* **`maxDelayMs`**
-  cap on exponential backoff
-* **`retryOnStatus`**
-  retry only when the upstream explicitly signals trouble
-Followers never retry.
-Retries never multiply under load.
-```
-```
-### How outbound-guard helps
-When `microCache` is enabled:
-- **Only one real GET request** is sent upstream.
-- All concurrent identical GETs **share the same in-flight request**.
-- If the upstream takes 5 seconds, deduplication lasts for the full 5 seconds.
-- After success, the response is cached briefly (default: 1 seconds).
-- Requests during that window are served immediately — no new upstream calls.
-This dramatically reduces:
-- outbound request count
-- upstream pressure
-- cost
-- tail latency
-- failure amplification
-This is **request coalescing**, not long-lived caching.
-It is intentionally:
-- GET-only
-- short-lived
-- in-memory
-- process-local
-The goal is load shedding and cost reduction by collapsing duplicate work under concurrent load — not durability guarantees.
--------------
-## What this library does NOT do (by design)
-- ❌ No persistence
-- ❌ No Redis / Kafka
-- ❌ No retries by default
-- ❌ No distributed coordination
-- ❌ No service discovery
-This library provides **resilience**, not **durability**.
-If you need guaranteed delivery, pair it with:
-- a database outbox
-- a job queue
-- a message broker
----
-## Installation
-```bash
-npm install outbound-guard
-````
-(Node.js ≥ 20)
----
-## Basic usage
-```ts
-import { ResilientHttpClient } from "outbound-guard";
-const client = new ResilientHttpClient({
-  maxInFlight: 20,
-  maxQueue: 100,
-  enqueueTimeoutMs: 200,
-  requestTimeoutMs: 5000,
-  microCache: {
-    enabled: true,
-    // short-lived cache window
-    ttlMs: 1000,
-    maxStaleMs: 800,
-    // protect against fan-in explosions
-    maxWaiters: 10,
-    followerTimeoutMs: 5000,
-    // leader-only retries
-    retry: {
-      maxAttempts: 3,
-      baseDelayMs: 50,
-      maxDelayMs: 200,
-      retryOnStatus: [503],
-    },
-  },
-});
-// Use it instead of fetch/axios directly
-await client.request({
-  method: "GET",
-  url: "https://third-party.example.com/config",
-});
-console.log(res.status, res.body);
-```
-That’s it.
-Everything else happens automatically.
----
-## Error handling
-Errors are **explicit and typed**:
-* `QueueFullError`
-* `QueueTimeoutError`
-* `RequestTimeoutError`
-Example:
-```ts
-try {
-  await client.request({ method: "GET", url });
-} catch (err) {
-  if (err instanceof CircuitOpenError) {
-    // upstream is unhealthy → fail fast
-  }
-}
-```
----
-## Observability
-### Events
-```ts
-client.on("request:failure", (e) => {
-  console.error("request failed", e.error);
-});
-```
-### Snapshot
-```ts
-const snap = client.snapshot();
-console.log(snap.inFlight);
-console.log(snap.queueDepth);
-console.log(snap.breakers);
-```
-Useful for logs, debugging, or ad-hoc metrics.
----
-## Demo (local, no deployment)
-This repo includes a demo that visibly shows request coalescing, backpressure, and recovery under load.
-### Terminal A — flaky upstream
-```bash
-npm run demo:upstream
-```
-### Terminal B — load generator
-```bash
-npm run demo:loadgen
-```
-You will see patterns like:
-=== burst: cold-start ===
-ok-1 ok-1 ok-1 ...
-=== burst: cached ===
-ok-1 ok-1 ok-1 ...
-=== burst: refresh-with-stale ===
-ok-1 ok-1 ok-2
-=== burst: failure ===
-ok-2 ok-2 ok-2
-=== burst: recovered ===
-ok-3 ok-3 ok-4
-This shows:
-only one upstream hit per burst
-cached responses during spikes
-safe reuse during refresh
-fast recovery without restart
----
-## When should you use this?
-Good fit if you:
-* call external APIs from Node.js
-* run BFFs or API gateways
-* send webhooks
-* run background workers
-* want predictable failure under load
----
-## When should you NOT use this?
-Not a good fit if you need:
-* durable delivery across restarts
-* distributed rate limiting
-* cross-process coordination
-* heavy retry orchestration
-This library is **not** a service mesh.
----
-## Design philosophy
-* Explicit > clever
-* Fail fast > degrade silently
-* Small surface area > feature creep
-* In-process resilience first
-See `docs/DESIGN.md` for details.
----
-## License
-MIT
-```
+# outbound-guard
+Process-local Node.js HTTP client that collapses duplicate GETs and wraps every outbound call with per-host limits, bounded queueing, timeouts, and a small health gate. Its goal is simple: stop thundering herds and keep your service predictable when upstreams are slow or flaky.
+## Highlights
+- Request coalescing + short-lived GET micro-cache (leader/followers, stale-while-refresh)
+- Per-base-URL limiter with bounded FIFO queue (maxQueue = maxInFlight * 10)
+- Lightweight health gate (OPEN → CLOSED → HALF_OPEN probe) with queue flush on close
+- Hard per-attempt timeouts and leader-only retries (no retry amplification)
+- Zero deps beyond `undici`; entirely in-memory and process-local
+## Install
+```bash
+npm install @nextn/outbound-guard
+# Node 18+ (tested on 20)
+```
+## Quick start
+```ts
+import { ResilientHttpClient } from "@nextn/outbound-guard";
+const client = new ResilientHttpClient({
+  // applied per base URL (protocol + host + port)
+  maxInFlight: 20,
+  requestTimeoutMs: 5_000,
+  microCache: {
+    enabled: true,
+    ttlMs: 1_000,          // fresh window
+    maxStaleMs: 10_000,    // serve stale while refreshing
+    maxEntries: 500,
+    maxWaiters: 1_000,     // concurrent followers per key
+    followerTimeoutMs: 5_000,
+    retry: {
+      maxAttempts: 3,
+      baseDelayMs: 50,
+      maxDelayMs: 200,
+      retryOnStatus: [429, 502, 503, 504], // leader-only
+    },
+  },
+});
+const res = await client.request({
+  method: "GET",
+  url: "https://third-party.example.com/config",
+});
+console.log(res.status, Buffer.from(res.body).toString("utf8"));
+```
+`res.body` is a `Uint8Array`; convert with `Buffer.from(res.body)` or `TextDecoder` as needed.
+## How it works
+### Micro-cache and request coalescing (GET only)
+- Keyed by `GET ${normalizedUrl}` by default (hostname lowercased, default ports stripped). Override via `microCache.keyFn`.
+- One caller becomes **leader**; identical concurrent GETs become **followers** and wait for the leader result.
+- Fresh window: successful 2xx responses are cached for `ttlMs`.
+- Stale-while-refresh: after `ttlMs`, followers can be served from the previous value while a new leader refreshes, up to `maxStaleMs`.
+- Follower guardrails: reject immediately when `maxWaiters` is exceeded or when waiting longer than `followerTimeoutMs`.
+- Failure handling: if a refresh fails but stale data is within `maxStaleMs`, stale is served; otherwise the error is surfaced.
+- Leader-only retry: optional exponential backoff for retryable statuses so retries do not multiply under fan-in.
+### Concurrency and queueing
+- Limits are per base URL (`protocol://host:port`).
+- At most `maxInFlight` requests run at once; overflow enters a bounded FIFO queue sized at `maxInFlight * 10` (internal for now).
+- If the queue is full, a `QueueFullError` is thrown immediately. Queued waiters are rejected if the upstream is marked unhealthy.
+### Health gate (tiny circuit breaker)
+- Tracks outcomes per base URL. Hard failures (request timeouts or unknown errors) and soft failures (429, 502, 503, 504) feed the window.
+- Closes immediately after 3 consecutive hard failures, or when (with ≥10 samples) hard-fail rate ≥30% or total fail rate ≥50%.
+- CLOSED: new requests fail fast with `UpstreamUnhealthyError` (micro-cache can still serve stale if available).
+- Cooldown uses exponential backoff: starts at ~1s with jitter, doubles up to 30s. When cooldown elapses, the circuit moves to HALF_OPEN.
+- HALF_OPEN: exactly one probe is allowed; other calls get `HalfOpenRejectedError`. A successful probe reopens; a failing probe recloses.
+- Per-host isolation: a bad upstream does not poison other hosts.
+### Timeouts and retries
+- `requestTimeoutMs` is enforced per attempt with `AbortController`; hanging upstreams become `RequestTimeoutError`.
+- Retries are opt-in and apply only to GET leaders via `microCache.retry`. Followers never retry, so retries cannot explode under load.
+## API surface
+```ts
+await client.request({
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS",
+  url: "https://example.com/resource",
+  headers?: Record<string, string>,
+  body?: string | Uint8Array | Buffer,
+});
+client.snapshot(); // { inFlight, queueDepth }
+client.on(eventName, handler); // see below for event names
+```
+### Errors
+All exported errors extend `ResilientHttpError`:
+- `QueueFullError` – queue capacity hit for that base URL.
+- `RequestTimeoutError` – per-attempt timeout exceeded.
+- `UpstreamUnhealthyError` – circuit is CLOSED for the base URL.
+- `HalfOpenRejectedError` – circuit is HALF_OPEN and the call was not the probe.
+### Events
+The client is an `EventEmitter`. Useful hooks:
+- `request:start | request:success | request:failure | request:rejected`
+- `health:closed | health:half_open | health:open`
+- `microcache:retry | microcache:refresh_failed`
+Event payloads include the request, requestId, status/duration when available, and error objects on failures.
+## Demo (local)
+Visualize coalescing and backpressure without deploying anything:
+```bash
+npm run demo:upstream   # terminal A: flaky upstream
+npm run demo:loadgen    # terminal B: bursts against the client
+```
+Watch how bursts collapse to a single upstream hit, stale responses are served during refresh, and failures recover cleanly.
+## When to use
+- Calling external APIs or partner services from Node.js
+- BFFs/API gateways that must isolate upstream slowness
+- Webhook senders or background workers that need predictable failure behavior
+## When not to use
+- If you need durable delivery across restarts (use queues/outbox)
+- If you need cross-process coordination or distributed rate limiting
+- If you need a service mesh or long-lived caching
+## Design stance
+- Favor explicit limits over hidden buffers
+- Fail fast instead of building invisible backlogs
+- Keep the surface small; stay in-process and dependency-light

package/dist/index.cjs CHANGED Viewed

@@ -422,11 +422,13 @@ var ResilientHttpClient = class extends import_node_events.EventEmitter {
     }
     const requestId = genRequestId();
     const start = Date.now();
+    let acquired = false;
     try {
       if (this.healthEnabled && h.state === "HALF_OPEN") {
         await limiter.acquireNoQueue();
       } else {
         await limiter.acquire();
+        acquired = true;
       }
     } catch (err) {
       this.emit("request:rejected", { requestId, request: req, error: err });
@@ -463,7 +465,7 @@ var ResilientHttpClient = class extends import_node_events.EventEmitter {
       if (this.healthEnabled && h.state === "HALF_OPEN") {
         h.probeInFlight = false;
       }
-      limiter.release();
+      if (acquired) limiter.release();
     }
   }
   /* ---------------- microcache ---------------- */

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/client.ts","../src/errors.ts","../src/limiter.ts","../src/http.ts"],"sourcesContent":["// src/index.ts\r\nexport * from \"./client.js\";\r\nexport * from \"./types.js\";\r\nexport * from \"./errors.js\";\r\n","// src/client.ts\r\nimport { EventEmitter } from \"node:events\";\r\nimport { ConcurrencyLimiter } from \"./limiter.js\";\r\nimport { doHttpRequest } from \"./http.js\";\r\nimport {\r\n QueueFullError,\r\n RequestTimeoutError,\r\n ResilientHttpError,\r\n HalfOpenRejectedError,\r\n UpstreamUnhealthyError,\r\n} from \"./errors.js\";\r\nimport type {\r\n MicroCacheOptions,\r\n ResilientHttpClientOptions,\r\n ResilientRequest,\r\n ResilientResponse,\r\n} from \"./types.js\";\r\n\r\n/* ---------------------------- helpers ---------------------------- /\r\n\r\nfunction normalizeUrlForKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return u.toString();\r\n}\r\n\r\nfunction baseUrlKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return `${u.protocol}//${u.host}`;\r\n}\r\n\r\nfunction defaultMicroCacheKeyFn(req: ResilientRequest): string {\r\n return `GET ${normalizeUrlForKey(req.url)}`;\r\n}\r\n\r\nfunction genRequestId(): string {\r\n return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\r\n}\r\n\r\nfunction sleep(ms: number): Promise<void> {\r\n return new Promise((r) => setTimeout(r, ms));\r\n}\r\n\r\nfunction clamp(n: number, lo: number, hi: number): number {\r\n return Math.max(lo, Math.min(hi, n));\r\n}\r\n\r\nfunction jitterMs(ms: number): number {\r\n const mult = 0.8 + Math.random() 0.4; // [0.8, 1.2]\r\n return Math.round(ms * mult);\r\n}\r\n\r\n\r\n/* ---------------------------- health ---------------------------- /\r\n\r\ntype HealthState = \"OPEN\" \| \"CLOSED\" \| \"HALF_OPEN\";\r\ntype Outcome = \"SUCCESS\" \| \"HARD_FAIL\" \| \"SOFT_FAIL\";\r\n\r\ntype HealthTracker = {\r\n state: HealthState;\r\n\r\n window: Outcome[];\r\n windowSize: number; // 20\r\n minSamples: number; // 10\r\n\r\n consecutiveHardFails: number; // trip at 3\r\n\r\n cooldownBaseMs: number; // 1000\r\n cooldownCapMs: number; // 30000\r\n cooldownMs: number; // current backoff\r\n cooldownUntil: number;\r\n\r\n probeInFlight: boolean; // probeConcurrency=1\r\n probeRemaining: number; // 1 probe per half-open\r\n\r\n stableNonHard: number; // reset backoff after 5 non-hard after open\r\n};\r\n\r\nconst SOFT_FAIL_STATUSES = new Set([429, 502, 503, 504]);\r\n\r\nfunction classifyHttpStatus(status: number): Outcome {\r\n if (status >= 200 && status < 300) return \"SUCCESS\";\r\n if (SOFT_FAIL_STATUSES.has(status)) return \"SOFT_FAIL\";\r\n return \"SUCCESS\"; // do not penalize health for other statuses (incl 4xx except 429)\r\n}\r\n\r\nfunction computeRates(window: Outcome[]) {\r\n const total = window.length;\r\n let hard = 0;\r\n let soft = 0;\r\n for (const o of window) {\r\n if (o === \"HARD_FAIL\") hard += 1;\r\n else if (o === \"SOFT_FAIL\") soft += 1;\r\n }\r\n return {\r\n total,\r\n hard,\r\n soft,\r\n hardFailRate: total === 0 ? 0 : hard / total,\r\n failRate: total === 0 ? 0 : (hard + soft) / total,\r\n };\r\n}\r\n\r\n/\r\n Only HTTP-layer failures should count as HARD_FAIL.\r\n * Control-plane rejections must NOT poison health.\r\n /\r\nfunction shouldCountAsHardFail(err: unknown): boolean {\r\n if (err instanceof UpstreamUnhealthyError) return false;\r\n if (err instanceof HalfOpenRejectedError) return false;\r\n if (err instanceof QueueFullError) return false;\r\n\r\n // if your http layer throws this, it's a real hard fail (timeout)\r\n if (err instanceof RequestTimeoutError) return true;\r\n\r\n // If it’s a known library error but not one of the above, be conservative:\r\n // treat it as NOT a health signal unless it’s clearly HTTP-related.\r\n if (err instanceof ResilientHttpError) return false;\r\n\r\n // Unknown thrown error: assume it's an HTTP/network failure.\r\n return true;\r\n}\r\n\r\n/ ---------------------------- microcache types ---------------------------- /\r\n\r\ntype CacheEntry = {\r\n createdAt: number;\r\n expiresAt: number;\r\n value: ResilientResponse;\r\n};\r\n\r\ntype InFlightGroup = {\r\n promise: Promise<ResilientResponse>;\r\n windowStartMs: number;\r\n waiters: number;\r\n};\r\n\r\n/ ---------------------------- client ---------------------------- /\r\n\r\nexport class ResilientHttpClient extends EventEmitter {\r\n private readonly requestTimeoutMs: number;\r\n private readonly healthEnabled: boolean;\r\n\r\n private readonly limiters = new Map<string, ConcurrencyLimiter>();\r\n private readonly health = new Map<string, HealthTracker>();\r\n\r\n private readonly microCache?: Required<\r\n Pick<\r\n MicroCacheOptions,\r\n \| \"enabled\"\r\n \| \"ttlMs\"\r\n \| \"maxStaleMs\"\r\n \| \"maxEntries\"\r\n \| \"maxWaiters\"\r\n \| \"followerTimeoutMs\"\r\n \| \"keyFn\"\r\n >\r\n > & {\r\n retry?: {\r\n maxAttempts: number;\r\n baseDelayMs: number;\r\n maxDelayMs: number;\r\n retryOnStatus: number[];\r\n };\r\n };\r\n\r\n private cache?: Map<string, CacheEntry>;\r\n private inFlight?: Map<string, InFlightGroup>;\r\n\r\n private microCacheReqCount = 0;\r\n private readonly cleanupEveryNRequests = 100;\r\n\r\n constructor(private readonly opts: ResilientHttpClientOptions) {\r\n super();\r\n this.requestTimeoutMs = opts.requestTimeoutMs;\r\n this.healthEnabled = opts.health?.enabled ?? true;\r\n\r\n const mc = opts.microCache;\r\n if (mc?.enabled) {\r\n const retry = mc.retry\r\n ? {\r\n maxAttempts: mc.retry.maxAttempts ?? 3,\r\n baseDelayMs: mc.retry.baseDelayMs ?? 50,\r\n maxDelayMs: mc.retry.maxDelayMs ?? 200,\r\n retryOnStatus: mc.retry.retryOnStatus ?? [429, 502, 503, 504],\r\n }\r\n : undefined;\r\n\r\n this.microCache = {\r\n enabled: true,\r\n ttlMs: mc.ttlMs ?? 1000,\r\n maxStaleMs: mc.maxStaleMs ?? 10_000,\r\n maxEntries: mc.maxEntries ?? 500,\r\n maxWaiters: mc.maxWaiters ?? 1000,\r\n followerTimeoutMs: mc.followerTimeoutMs ?? 5000,\r\n keyFn: mc.keyFn ?? defaultMicroCacheKeyFn,\r\n retry,\r\n };\r\n\r\n this.cache = new Map();\r\n this.inFlight = new Map();\r\n }\r\n }\r\n\r\n async request(req: ResilientRequest): Promise<ResilientResponse> {\r\n if (this.microCache?.enabled && req.method === \"GET\" && req.body == null) {\r\n return this.requestWithMicroCache(req);\r\n }\r\n return this.execute(req, { allowProbe: false });\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number } {\r\n let inFlight = 0;\r\n let queueDepth = 0;\r\n for (const l of this.limiters.values()) {\r\n const s = l.snapshot();\r\n inFlight += s.inFlight;\r\n queueDepth += s.queueDepth;\r\n }\r\n return { inFlight, queueDepth };\r\n }\r\n\r\n / ---------------- internals ---------------- /\r\n\r\n private getLimiter(baseKey: string): ConcurrencyLimiter {\r\n let l = this.limiters.get(baseKey);\r\n if (!l) {\r\n l = new ConcurrencyLimiter({\r\n maxInFlight: this.opts.maxInFlight,\r\n maxQueue: this.opts.maxInFlight 10, // hidden factor\r\n });\r\n this.limiters.set(baseKey, l);\r\n }\r\n return l;\r\n }\r\n\r\n private getHealth(baseKey: string): HealthTracker {\r\n let h = this.health.get(baseKey);\r\n if (!h) {\r\n h = {\r\n state: \"OPEN\",\r\n window: [],\r\n windowSize: 20,\r\n minSamples: 10,\r\n consecutiveHardFails: 0,\r\n cooldownBaseMs: 1000,\r\n cooldownCapMs: 30_000,\r\n cooldownMs: 1000,\r\n cooldownUntil: 0,\r\n probeInFlight: false,\r\n probeRemaining: 0,\r\n stableNonHard: 0,\r\n };\r\n this.health.set(baseKey, h);\r\n }\r\n return h;\r\n }\r\n\r\n private closeHealth(baseKey: string, reason: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") return;\r\n\r\n h.state = \"CLOSED\";\r\n h.cooldownUntil = Date.now() + jitterMs(h.cooldownMs);\r\n h.cooldownMs = Math.min(h.cooldownMs * 2, h.cooldownCapMs);\r\n\r\n // reject queued immediately\r\n this.getLimiter(baseKey).flush(new UpstreamUnhealthyError(baseKey, \"CLOSED\"));\r\n\r\n const rates = computeRates(h.window);\r\n this.emit(\"health:closed\", {\r\n baseUrl: baseKey,\r\n reason,\r\n cooldownMs: h.cooldownUntil - Date.now(),\r\n hardFailRate: rates.hardFailRate,\r\n failRate: rates.failRate,\r\n samples: rates.total,\r\n });\r\n }\r\n\r\n private halfOpenHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state !== \"CLOSED\") return;\r\n\r\n h.state = \"HALF_OPEN\";\r\n h.probeInFlight = false;\r\n h.probeRemaining = 1;\r\n this.emit(\"health:half_open\", { baseUrl: baseKey });\r\n }\r\n\r\n private openHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n h.state = \"OPEN\";\r\n h.window = [];\r\n h.consecutiveHardFails = 0;\r\n h.probeInFlight = false;\r\n h.probeRemaining = 0;\r\n h.stableNonHard = 0;\r\n this.emit(\"health:open\", { baseUrl: baseKey });\r\n }\r\n\r\n private recordOutcome(baseKey: string, outcome: Outcome): void {\r\n const h = this.getHealth(baseKey);\r\n\r\n h.window.push(outcome);\r\n while (h.window.length > h.windowSize) h.window.shift();\r\n\r\n if (outcome === \"HARD_FAIL\") h.consecutiveHardFails += 1;\r\n else h.consecutiveHardFails = 0;\r\n\r\n // stabilization (reset backoff after 5 non-hard in OPEN)\r\n if (h.state === \"OPEN\") {\r\n if (outcome !== \"HARD_FAIL\") {\r\n h.stableNonHard += 1;\r\n if (h.stableNonHard >= 5) {\r\n h.cooldownMs = h.cooldownBaseMs;\r\n }\r\n } else {\r\n h.stableNonHard = 0;\r\n }\r\n }\r\n\r\n if (!this.healthEnabled) return;\r\n\r\n if (h.consecutiveHardFails >= 3) {\r\n this.closeHealth(baseKey, \"3 consecutive hard failures\");\r\n return;\r\n }\r\n\r\n const rates = computeRates(h.window);\r\n if (rates.total >= h.minSamples) {\r\n if (rates.hardFailRate >= 0.3) {\r\n this.closeHealth(baseKey, \"hardFailRate >= 30%\");\r\n return;\r\n }\r\n if (rates.failRate >= 0.5) {\r\n this.closeHealth(baseKey, \"failRate >= 50%\");\r\n return;\r\n }\r\n }\r\n }\r\n\r\n private async execute(req: ResilientRequest, opts: { allowProbe: boolean }): Promise<ResilientResponse> {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const limiter = this.getLimiter(baseKey);\r\n\r\n if (this.healthEnabled) {\r\n if (h.state === \"CLOSED\") {\r\n if (Date.now() >= h.cooldownUntil) {\r\n this.halfOpenHealth(baseKey);\r\n } else {\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n if (h.state === \"HALF_OPEN\") {\r\n if (!opts.allowProbe) throw new HalfOpenRejectedError(baseKey);\r\n if (h.probeRemaining <= 0 \|\| h.probeInFlight) throw new HalfOpenRejectedError(baseKey);\r\n h.probeInFlight = true;\r\n h.probeRemaining -= 1;\r\n }\r\n }\r\n\r\n const requestId = genRequestId();\r\n const start = Date.now();\r\n\r\n try {\r\n // Probes should not wait in queue.\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n await limiter.acquireNoQueue();\r\n } else {\r\n await limiter.acquire();\r\n }\r\n } catch (err) {\r\n this.emit(\"request:rejected\", { requestId, request: req, error: err });\r\n throw err;\r\n }\r\n\r\n this.emit(\"request:start\", { requestId, request: req });\r\n\r\n try {\r\n const res = await doHttpRequest(req, this.requestTimeoutMs);\r\n const durationMs = Date.now() - start;\r\n\r\n const outcome = classifyHttpStatus(res.status);\r\n this.recordOutcome(baseKey, outcome);\r\n\r\n // Probe decision\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome, status: res.status });\r\n if (res.status >= 200 && res.status < 300) {\r\n this.openHealth(baseKey);\r\n } else {\r\n this.closeHealth(baseKey, `probe failed status=${res.status}`);\r\n }\r\n }\r\n\r\n this.emit(\"request:success\", { requestId, request: req, status: res.status, durationMs });\r\n return res;\r\n } catch (err) {\r\n const durationMs = Date.now() - start;\r\n\r\n if (shouldCountAsHardFail(err)) {\r\n this.recordOutcome(baseKey, \"HARD_FAIL\");\r\n }\r\n\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome: \"HARD_FAIL\", error: err });\r\n this.closeHealth(baseKey, \"probe hard failure\");\r\n }\r\n\r\n this.emit(\"request:failure\", { requestId, request: req, error: err, durationMs });\r\n throw err;\r\n } finally {\r\n // Clear probe flag (if any)\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n h.probeInFlight = false;\r\n }\r\n limiter.release();\r\n }\r\n }\r\n\r\n /* ---------------- microcache ---------------- /\r\n\r\n private cloneResponse(res: ResilientResponse): ResilientResponse {\r\n return { status: res.status, headers: { ...res.headers }, body: new Uint8Array(res.body) };\r\n }\r\n\r\n private maybeCleanupExpired(cache: Map<string, CacheEntry>, maxStaleMs: number): void {\r\n this.microCacheReqCount++;\r\n if (this.microCacheReqCount % this.cleanupEveryNRequests !== 0) return;\r\n\r\n const now = Date.now();\r\n for (const [k, v] of cache.entries()) {\r\n if (now - v.createdAt > maxStaleMs) cache.delete(k);\r\n }\r\n }\r\n\r\n private evictIfNeeded(cache: Map<string, CacheEntry>, maxEntries: number): void {\r\n while (cache.size >= maxEntries) {\r\n const oldestKey = cache.keys().next().value as string \| undefined;\r\n if (!oldestKey) break;\r\n cache.delete(oldestKey);\r\n }\r\n }\r\n\r\n private isRetryableStatus(status: number, retryOnStatus: number[]): boolean {\r\n return retryOnStatus.includes(status);\r\n }\r\n\r\n private computeBackoffMs(attemptIndex: number, baseDelayMs: number, maxDelayMs: number): number {\r\n const exp = baseDelayMs Math.pow(2, attemptIndex - 1);\r\n const capped = clamp(exp, baseDelayMs, maxDelayMs);\r\n const jitter = 0.5 + Math.random();\r\n return Math.round(capped * jitter);\r\n }\r\n\r\n private async fetchWithLeaderRetry(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const retry = mc.retry;\r\n if (!retry) return this.execute(req, { allowProbe: false });\r\n\r\n const { maxAttempts, baseDelayMs, maxDelayMs, retryOnStatus } = retry;\r\n\r\n let last: ResilientResponse \| undefined;\r\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\r\n const res = await this.execute(req, { allowProbe: false });\r\n last = res;\r\n\r\n if (this.isRetryableStatus(res.status, retryOnStatus) && attempt < maxAttempts) {\r\n const delay = this.computeBackoffMs(attempt, baseDelayMs, maxDelayMs);\r\n this.emit(\"microcache:retry\", { url: req.url, attempt, maxAttempts, reason: `status ${res.status}`, delayMs: delay });\r\n await sleep(delay);\r\n continue;\r\n }\r\n return res;\r\n }\r\n return last!;\r\n }\r\n\r\n private async requestWithMicroCache(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const cache = this.cache!;\r\n const inFlight = this.inFlight!;\r\n\r\n this.maybeCleanupExpired(cache, mc.maxStaleMs);\r\n\r\n const key = mc.keyFn(req);\r\n const now = Date.now();\r\n\r\n const hit0 = cache.get(key);\r\n if (hit0 && now - hit0.createdAt > mc.maxStaleMs) cache.delete(key);\r\n\r\n const hit = cache.get(key);\r\n if (hit && now < hit.expiresAt) return this.cloneResponse(hit.value);\r\n\r\n // If CLOSED: serve stale if allowed else fail fast\r\n if (this.healthEnabled) {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") {\r\n const staleAllowed = !!hit && now - hit.createdAt <= mc.maxStaleMs;\r\n if (staleAllowed) return this.cloneResponse(hit!.value);\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n const group = inFlight.get(key);\r\n if (group) {\r\n const h = cache.get(key);\r\n const staleAllowed = !!h && now - h.createdAt <= mc.maxStaleMs;\r\n\r\n if (h && staleAllowed) return this.cloneResponse(h.value);\r\n\r\n const age = now - group.windowStartMs;\r\n if (age > mc.followerTimeoutMs) {\r\n const err = new Error(`Follower window closed for key=${key}`);\r\n (err as any).name = \"FollowerWindowClosedError\";\r\n throw err;\r\n }\r\n\r\n if (group.waiters >= mc.maxWaiters) {\r\n const err = new Error(`Too many followers for key=${key}`);\r\n (err as any).name = \"TooManyWaitersError\";\r\n throw err;\r\n }\r\n\r\n group.waiters += 1;\r\n try {\r\n const res = await group.promise;\r\n return this.cloneResponse(res);\r\n } finally {\r\n group.waiters -= 1;\r\n }\r\n }\r\n\r\n const prev = cache.get(key);\r\n const prevStaleAllowed = !!prev && now - prev.createdAt <= mc.maxStaleMs;\r\n\r\n const promise = (async () => {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const allowProbe = this.healthEnabled && h.state === \"HALF_OPEN\";\r\n\r\n const res = allowProbe\r\n ? await this.execute(req, { allowProbe: true })\r\n : await this.fetchWithLeaderRetry(req);\r\n\r\n if (res.status >= 200 && res.status < 300) {\r\n this.evictIfNeeded(cache, mc.maxEntries);\r\n const t = Date.now();\r\n cache.set(key, { value: this.cloneResponse(res), createdAt: t, expiresAt: t + mc.ttlMs });\r\n }\r\n return res;\r\n })();\r\n\r\n inFlight.set(key, { promise, windowStartMs: Date.now(), waiters: 0 });\r\n\r\n try {\r\n const res = await promise;\r\n\r\n if (!(res.status >= 200 && res.status < 300) && prev && prevStaleAllowed) {\r\n return this.cloneResponse(prev.value);\r\n }\r\n\r\n return this.cloneResponse(res);\r\n } catch (err) {\r\n if (prev && prevStaleAllowed) {\r\n this.emit(\"microcache:refresh_failed\", { key, url: req.url, error: err });\r\n return this.cloneResponse(prev.value);\r\n }\r\n throw err;\r\n } finally {\r\n inFlight.delete(key);\r\n }\r\n }\r\n}\r\n","export abstract class ResilientHttpError extends Error {\r\n public readonly name: string;\r\n constructor(message: string) {\r\n super(message);\r\n this.name = this.constructor.name;\r\n }\r\n}\r\n\r\nexport class QueueFullError extends ResilientHttpError {\r\n constructor(public readonly maxQueue: number) {\r\n super(`Queue is full (maxQueue=${maxQueue}).`);\r\n }\r\n}\r\n\r\nexport class QueueTimeoutError extends ResilientHttpError {\r\n constructor(public readonly enqueueTimeoutMs: number) {\r\n super(`Queue wait exceeded (enqueueTimeoutMs=${enqueueTimeoutMs}).`);\r\n }\r\n}\r\n\r\nexport class RequestTimeoutError extends ResilientHttpError {\r\n constructor(public readonly requestTimeoutMs: number) {\r\n super(`Request timed out (requestTimeoutMs=${requestTimeoutMs}).`);\r\n }\r\n}\r\n\r\n\r\n\r\nexport class UpstreamError extends ResilientHttpError {\r\n constructor(public readonly status: number) {\r\n super(`Upstream returned error status=${status}.`);\r\n }\r\n}\r\n\r\n\r\n\r\n\r\nexport class UpstreamUnhealthyError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string, public readonly state: string) {\r\n super(`Upstream is unhealthy (state=${state}, baseUrl=${baseUrl}).`);\r\n }\r\n}\r\n\r\nexport class HalfOpenRejectedError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string) {\r\n super(`Upstream is HALF_OPEN (probe only) for baseUrl=${baseUrl}.`);\r\n }\r\n}\r\n","// src/limiter.ts\r\nimport { QueueFullError } from \"./errors.js\";\r\n\r\ntype ResolveFn = () => void;\r\ntype RejectFn = (err: unknown) => void;\r\n\r\ninterface Waiter {\r\n resolve: ResolveFn;\r\n reject: RejectFn;\r\n}\r\n\r\n/*\r\n Process-local concurrency limiter with bounded FIFO queue.\r\n \r\n - maxInFlight: concurrent permits\r\n * - maxQueue: bounded burst buffer\r\n * - No enqueue-timeout by design.\r\n \r\n Also supports:\r\n * - flush(err): reject all queued waiters immediately\r\n * - acquireNoQueue(): for probes (must start now or fail)\r\n /\r\nexport class ConcurrencyLimiter {\r\n private readonly maxInFlight: number;\r\n private readonly maxQueue: number;\r\n\r\n private inFlight = 0;\r\n private queue: Waiter[] = [];\r\n\r\n constructor(opts: { maxInFlight: number; maxQueue: number }) {\r\n if (!Number.isFinite(opts.maxInFlight) \|\| opts.maxInFlight <= 0) {\r\n throw new Error(`maxInFlight must be > 0 (got ${opts.maxInFlight})`);\r\n }\r\n if (!Number.isFinite(opts.maxQueue) \|\| opts.maxQueue < 0) {\r\n throw new Error(`maxQueue must be >= 0 (got ${opts.maxQueue})`);\r\n }\r\n\r\n this.maxInFlight = opts.maxInFlight;\r\n this.maxQueue = opts.maxQueue;\r\n }\r\n\r\n acquire(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n\r\n if (this.maxQueue === 0 \|\| this.queue.length >= this.maxQueue) {\r\n return Promise.reject(new QueueFullError(this.maxQueue));\r\n }\r\n\r\n return new Promise<void>((resolve, reject) => {\r\n this.queue.push({ resolve, reject });\r\n });\r\n }\r\n\r\n /\r\n Acquire without queueing: either start now or fail.\r\n * Used for HALF_OPEN probes so recovery never waits behind backlog.\r\n /\r\n acquireNoQueue(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n // treat as queue full (we don't want a new error type)\r\n return Promise.reject(new QueueFullError(0));\r\n }\r\n\r\n release(): void {\r\n if (this.inFlight <= 0) {\r\n throw new Error(\"release() called when inFlight is already 0\");\r\n }\r\n\r\n const next = this.queue.shift();\r\n if (next) {\r\n next.resolve(); // transfer permit\r\n return;\r\n }\r\n\r\n this.inFlight -= 1;\r\n }\r\n\r\n flush(err: unknown): void {\r\n const q = this.queue;\r\n this.queue = [];\r\n for (const w of q) w.reject(err);\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number; maxInFlight: number; maxQueue: number } {\r\n return {\r\n inFlight: this.inFlight,\r\n queueDepth: this.queue.length,\r\n maxInFlight: this.maxInFlight,\r\n maxQueue: this.maxQueue,\r\n };\r\n }\r\n}\r\n","// src/http.ts\r\nimport { request as undiciRequest } from \"undici\";\r\nimport { RequestTimeoutError } from \"./errors.js\";\r\nimport type { ResilientRequest, ResilientResponse } from \"./types.js\";\r\n\r\nfunction normalizeHeaders(headers: any): Record<string, string> {\r\n const out: Record<string, string> = {};\r\n if (!headers) return out;\r\n\r\n // undici headers are an object-like structure (headers: Record<string, string \| string[]>)\r\n for (const [k, v] of Object.entries(headers)) {\r\n if (Array.isArray(v)) out[k.toLowerCase()] = v.join(\", \");\r\n else if (typeof v === \"string\") out[k.toLowerCase()] = v;\r\n else out[k.toLowerCase()] = String(v);\r\n }\r\n return out;\r\n}\r\n\r\n/\r\n Execute a single HTTP request with a hard timeout using AbortController.\r\n * No retries. No breaker. Just raw outbound I/O with a timeout.\r\n */\r\nexport async function doHttpRequest(\r\n req: ResilientRequest,\r\n requestTimeoutMs: number\r\n): Promise<ResilientResponse> {\r\n const ac = new AbortController();\r\n const timer = setTimeout(() => ac.abort(), requestTimeoutMs);\r\n\r\n try {\r\n const res = await undiciRequest(req.url, {\r\n method: req.method,\r\n headers: req.headers,\r\n body: req.body as any,\r\n signal: ac.signal,\r\n });\r\n\r\n const body = await res.body.arrayBuffer();\r\n return {\r\n status: res.statusCode,\r\n headers: normalizeHeaders(res.headers),\r\n body: new Uint8Array(body),\r\n };\r\n } catch (err: any) {\r\n // undici throws AbortError on abort\r\n if (err?.name === \"AbortError\") {\r\n throw new RequestTimeoutError(requestTimeoutMs);\r\n }\r\n throw err;\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n}\r\n"],"mappings":"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","names":["undiciRequest"]}
1	+ {"version":3,"sources":["../src/index.ts","../src/client.ts","../src/errors.ts","../src/limiter.ts","../src/http.ts"],"sourcesContent":["// src/index.ts\r\nexport * from \"./client.js\";\r\nexport * from \"./types.js\";\r\nexport * from \"./errors.js\";\r\n","// src/client.ts\r\nimport { EventEmitter } from \"node:events\";\r\nimport { ConcurrencyLimiter } from \"./limiter.js\";\r\nimport { doHttpRequest } from \"./http.js\";\r\nimport {\r\n QueueFullError,\r\n RequestTimeoutError,\r\n ResilientHttpError,\r\n HalfOpenRejectedError,\r\n UpstreamUnhealthyError,\r\n} from \"./errors.js\";\r\nimport type {\r\n MicroCacheOptions,\r\n ResilientHttpClientOptions,\r\n ResilientRequest,\r\n ResilientResponse,\r\n} from \"./types.js\";\r\n\r\n/* ---------------------------- helpers ---------------------------- /\r\n\r\nfunction normalizeUrlForKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return u.toString();\r\n}\r\n\r\nfunction baseUrlKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return `${u.protocol}//${u.host}`;\r\n}\r\n\r\nfunction defaultMicroCacheKeyFn(req: ResilientRequest): string {\r\n return `GET ${normalizeUrlForKey(req.url)}`;\r\n}\r\n\r\nfunction genRequestId(): string {\r\n return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\r\n}\r\n\r\nfunction sleep(ms: number): Promise<void> {\r\n return new Promise((r) => setTimeout(r, ms));\r\n}\r\n\r\nfunction clamp(n: number, lo: number, hi: number): number {\r\n return Math.max(lo, Math.min(hi, n));\r\n}\r\n\r\nfunction jitterMs(ms: number): number {\r\n const mult = 0.8 + Math.random() 0.4; // [0.8, 1.2]\r\n return Math.round(ms * mult);\r\n}\r\n\r\n\r\n/* ---------------------------- health ---------------------------- /\r\n\r\ntype HealthState = \"OPEN\" \| \"CLOSED\" \| \"HALF_OPEN\";\r\ntype Outcome = \"SUCCESS\" \| \"HARD_FAIL\" \| \"SOFT_FAIL\";\r\n\r\ntype HealthTracker = {\r\n state: HealthState;\r\n\r\n window: Outcome[];\r\n windowSize: number; // 20\r\n minSamples: number; // 10\r\n\r\n consecutiveHardFails: number; // trip at 3\r\n\r\n cooldownBaseMs: number; // 1000\r\n cooldownCapMs: number; // 30000\r\n cooldownMs: number; // current backoff\r\n cooldownUntil: number;\r\n\r\n probeInFlight: boolean; // probeConcurrency=1\r\n probeRemaining: number; // 1 probe per half-open\r\n\r\n stableNonHard: number; // reset backoff after 5 non-hard after open\r\n};\r\n\r\nconst SOFT_FAIL_STATUSES = new Set([429, 502, 503, 504]);\r\n\r\nfunction classifyHttpStatus(status: number): Outcome {\r\n if (status >= 200 && status < 300) return \"SUCCESS\";\r\n if (SOFT_FAIL_STATUSES.has(status)) return \"SOFT_FAIL\";\r\n return \"SUCCESS\"; // do not penalize health for other statuses (incl 4xx except 429)\r\n}\r\n\r\nfunction computeRates(window: Outcome[]) {\r\n const total = window.length;\r\n let hard = 0;\r\n let soft = 0;\r\n for (const o of window) {\r\n if (o === \"HARD_FAIL\") hard += 1;\r\n else if (o === \"SOFT_FAIL\") soft += 1;\r\n }\r\n return {\r\n total,\r\n hard,\r\n soft,\r\n hardFailRate: total === 0 ? 0 : hard / total,\r\n failRate: total === 0 ? 0 : (hard + soft) / total,\r\n };\r\n}\r\n\r\n/\r\n Only HTTP-layer failures should count as HARD_FAIL.\r\n * Control-plane rejections must NOT poison health.\r\n /\r\nfunction shouldCountAsHardFail(err: unknown): boolean {\r\n if (err instanceof UpstreamUnhealthyError) return false;\r\n if (err instanceof HalfOpenRejectedError) return false;\r\n if (err instanceof QueueFullError) return false;\r\n\r\n // if your http layer throws this, it's a real hard fail (timeout)\r\n if (err instanceof RequestTimeoutError) return true;\r\n\r\n // If it’s a known library error but not one of the above, be conservative:\r\n // treat it as NOT a health signal unless it’s clearly HTTP-related.\r\n if (err instanceof ResilientHttpError) return false;\r\n\r\n // Unknown thrown error: assume it's an HTTP/network failure.\r\n return true;\r\n}\r\n\r\n/ ---------------------------- microcache types ---------------------------- /\r\n\r\ntype CacheEntry = {\r\n createdAt: number;\r\n expiresAt: number;\r\n value: ResilientResponse;\r\n};\r\n\r\ntype InFlightGroup = {\r\n promise: Promise<ResilientResponse>;\r\n windowStartMs: number;\r\n waiters: number;\r\n};\r\n\r\n/ ---------------------------- client ---------------------------- /\r\n\r\nexport class ResilientHttpClient extends EventEmitter {\r\n private readonly requestTimeoutMs: number;\r\n private readonly healthEnabled: boolean;\r\n\r\n private readonly limiters = new Map<string, ConcurrencyLimiter>();\r\n private readonly health = new Map<string, HealthTracker>();\r\n\r\n private readonly microCache?: Required<\r\n Pick<\r\n MicroCacheOptions,\r\n \| \"enabled\"\r\n \| \"ttlMs\"\r\n \| \"maxStaleMs\"\r\n \| \"maxEntries\"\r\n \| \"maxWaiters\"\r\n \| \"followerTimeoutMs\"\r\n \| \"keyFn\"\r\n >\r\n > & {\r\n retry?: {\r\n maxAttempts: number;\r\n baseDelayMs: number;\r\n maxDelayMs: number;\r\n retryOnStatus: number[];\r\n };\r\n };\r\n\r\n private cache?: Map<string, CacheEntry>;\r\n private inFlight?: Map<string, InFlightGroup>;\r\n\r\n private microCacheReqCount = 0;\r\n private readonly cleanupEveryNRequests = 100;\r\n\r\n constructor(private readonly opts: ResilientHttpClientOptions) {\r\n super();\r\n this.requestTimeoutMs = opts.requestTimeoutMs;\r\n this.healthEnabled = opts.health?.enabled ?? true;\r\n\r\n const mc = opts.microCache;\r\n if (mc?.enabled) {\r\n const retry = mc.retry\r\n ? {\r\n maxAttempts: mc.retry.maxAttempts ?? 3,\r\n baseDelayMs: mc.retry.baseDelayMs ?? 50,\r\n maxDelayMs: mc.retry.maxDelayMs ?? 200,\r\n retryOnStatus: mc.retry.retryOnStatus ?? [429, 502, 503, 504],\r\n }\r\n : undefined;\r\n\r\n this.microCache = {\r\n enabled: true,\r\n ttlMs: mc.ttlMs ?? 1000,\r\n maxStaleMs: mc.maxStaleMs ?? 10_000,\r\n maxEntries: mc.maxEntries ?? 500,\r\n maxWaiters: mc.maxWaiters ?? 1000,\r\n followerTimeoutMs: mc.followerTimeoutMs ?? 5000,\r\n keyFn: mc.keyFn ?? defaultMicroCacheKeyFn,\r\n retry,\r\n };\r\n\r\n this.cache = new Map();\r\n this.inFlight = new Map();\r\n }\r\n }\r\n\r\n async request(req: ResilientRequest): Promise<ResilientResponse> {\r\n if (this.microCache?.enabled && req.method === \"GET\" && req.body == null) {\r\n return this.requestWithMicroCache(req);\r\n }\r\n return this.execute(req, { allowProbe: false });\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number } {\r\n let inFlight = 0;\r\n let queueDepth = 0;\r\n for (const l of this.limiters.values()) {\r\n const s = l.snapshot();\r\n inFlight += s.inFlight;\r\n queueDepth += s.queueDepth;\r\n }\r\n return { inFlight, queueDepth };\r\n }\r\n\r\n / ---------------- internals ---------------- /\r\n\r\n private getLimiter(baseKey: string): ConcurrencyLimiter {\r\n let l = this.limiters.get(baseKey);\r\n if (!l) {\r\n l = new ConcurrencyLimiter({\r\n maxInFlight: this.opts.maxInFlight,\r\n maxQueue: this.opts.maxInFlight 10, // hidden factor\r\n });\r\n this.limiters.set(baseKey, l);\r\n }\r\n return l;\r\n }\r\n\r\n private getHealth(baseKey: string): HealthTracker {\r\n let h = this.health.get(baseKey);\r\n if (!h) {\r\n h = {\r\n state: \"OPEN\",\r\n window: [],\r\n windowSize: 20,\r\n minSamples: 10,\r\n consecutiveHardFails: 0,\r\n cooldownBaseMs: 1000,\r\n cooldownCapMs: 30_000,\r\n cooldownMs: 1000,\r\n cooldownUntil: 0,\r\n probeInFlight: false,\r\n probeRemaining: 0,\r\n stableNonHard: 0,\r\n };\r\n this.health.set(baseKey, h);\r\n }\r\n return h;\r\n }\r\n\r\n private closeHealth(baseKey: string, reason: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") return;\r\n\r\n h.state = \"CLOSED\";\r\n h.cooldownUntil = Date.now() + jitterMs(h.cooldownMs);\r\n h.cooldownMs = Math.min(h.cooldownMs * 2, h.cooldownCapMs);\r\n\r\n // reject queued immediately\r\n this.getLimiter(baseKey).flush(new UpstreamUnhealthyError(baseKey, \"CLOSED\"));\r\n\r\n const rates = computeRates(h.window);\r\n this.emit(\"health:closed\", {\r\n baseUrl: baseKey,\r\n reason,\r\n cooldownMs: h.cooldownUntil - Date.now(),\r\n hardFailRate: rates.hardFailRate,\r\n failRate: rates.failRate,\r\n samples: rates.total,\r\n });\r\n }\r\n\r\n private halfOpenHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state !== \"CLOSED\") return;\r\n\r\n h.state = \"HALF_OPEN\";\r\n h.probeInFlight = false;\r\n h.probeRemaining = 1;\r\n this.emit(\"health:half_open\", { baseUrl: baseKey });\r\n }\r\n\r\n private openHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n h.state = \"OPEN\";\r\n h.window = [];\r\n h.consecutiveHardFails = 0;\r\n h.probeInFlight = false;\r\n h.probeRemaining = 0;\r\n h.stableNonHard = 0;\r\n this.emit(\"health:open\", { baseUrl: baseKey });\r\n }\r\n\r\n private recordOutcome(baseKey: string, outcome: Outcome): void {\r\n const h = this.getHealth(baseKey);\r\n\r\n h.window.push(outcome);\r\n while (h.window.length > h.windowSize) h.window.shift();\r\n\r\n if (outcome === \"HARD_FAIL\") h.consecutiveHardFails += 1;\r\n else h.consecutiveHardFails = 0;\r\n\r\n // stabilization (reset backoff after 5 non-hard in OPEN)\r\n if (h.state === \"OPEN\") {\r\n if (outcome !== \"HARD_FAIL\") {\r\n h.stableNonHard += 1;\r\n if (h.stableNonHard >= 5) {\r\n h.cooldownMs = h.cooldownBaseMs;\r\n }\r\n } else {\r\n h.stableNonHard = 0;\r\n }\r\n }\r\n\r\n if (!this.healthEnabled) return;\r\n\r\n if (h.consecutiveHardFails >= 3) {\r\n this.closeHealth(baseKey, \"3 consecutive hard failures\");\r\n return;\r\n }\r\n\r\n const rates = computeRates(h.window);\r\n if (rates.total >= h.minSamples) {\r\n if (rates.hardFailRate >= 0.3) {\r\n this.closeHealth(baseKey, \"hardFailRate >= 30%\");\r\n return;\r\n }\r\n if (rates.failRate >= 0.5) {\r\n this.closeHealth(baseKey, \"failRate >= 50%\");\r\n return;\r\n }\r\n }\r\n }\r\n\r\n private async execute(req: ResilientRequest, opts: { allowProbe: boolean }): Promise<ResilientResponse> {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const limiter = this.getLimiter(baseKey);\r\n\r\n if (this.healthEnabled) {\r\n if (h.state === \"CLOSED\") {\r\n if (Date.now() >= h.cooldownUntil) {\r\n this.halfOpenHealth(baseKey);\r\n } else {\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n if (h.state === \"HALF_OPEN\") {\r\n if (!opts.allowProbe) throw new HalfOpenRejectedError(baseKey);\r\n if (h.probeRemaining <= 0 \|\| h.probeInFlight) throw new HalfOpenRejectedError(baseKey);\r\n h.probeInFlight = true;\r\n h.probeRemaining -= 1;\r\n }\r\n }\r\n\r\n const requestId = genRequestId();\r\n const start = Date.now();\r\n let acquired = false;\r\n try {\r\n // Probes should not wait in queue.\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n await limiter.acquireNoQueue();\r\n } else {\r\n await limiter.acquire();\r\n acquired = true;\r\n }\r\n } catch (err) {\r\n this.emit(\"request:rejected\", { requestId, request: req, error: err });\r\n throw err;\r\n }\r\n\r\n this.emit(\"request:start\", { requestId, request: req });\r\n\r\n try {\r\n const res = await doHttpRequest(req, this.requestTimeoutMs);\r\n const durationMs = Date.now() - start;\r\n\r\n const outcome = classifyHttpStatus(res.status);\r\n this.recordOutcome(baseKey, outcome);\r\n\r\n // Probe decision\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome, status: res.status });\r\n if (res.status >= 200 && res.status < 300) {\r\n this.openHealth(baseKey);\r\n } else {\r\n this.closeHealth(baseKey, `probe failed status=${res.status}`);\r\n }\r\n }\r\n\r\n this.emit(\"request:success\", { requestId, request: req, status: res.status, durationMs });\r\n return res;\r\n } catch (err) {\r\n const durationMs = Date.now() - start;\r\n\r\n if (shouldCountAsHardFail(err)) {\r\n this.recordOutcome(baseKey, \"HARD_FAIL\");\r\n }\r\n\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome: \"HARD_FAIL\", error: err });\r\n this.closeHealth(baseKey, \"probe hard failure\");\r\n }\r\n\r\n this.emit(\"request:failure\", { requestId, request: req, error: err, durationMs });\r\n throw err;\r\n } finally {\r\n // Clear probe flag (if any)\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n h.probeInFlight = false;\r\n }\r\n if (acquired) limiter.release();\r\n }\r\n }\r\n\r\n /* ---------------- microcache ---------------- /\r\n\r\n private cloneResponse(res: ResilientResponse): ResilientResponse {\r\n return { status: res.status, headers: { ...res.headers }, body: new Uint8Array(res.body) };\r\n }\r\n\r\n private maybeCleanupExpired(cache: Map<string, CacheEntry>, maxStaleMs: number): void {\r\n this.microCacheReqCount++;\r\n if (this.microCacheReqCount % this.cleanupEveryNRequests !== 0) return;\r\n\r\n const now = Date.now();\r\n for (const [k, v] of cache.entries()) {\r\n if (now - v.createdAt > maxStaleMs) cache.delete(k);\r\n }\r\n }\r\n\r\n private evictIfNeeded(cache: Map<string, CacheEntry>, maxEntries: number): void {\r\n while (cache.size >= maxEntries) {\r\n const oldestKey = cache.keys().next().value as string \| undefined;\r\n if (!oldestKey) break;\r\n cache.delete(oldestKey);\r\n }\r\n }\r\n\r\n private isRetryableStatus(status: number, retryOnStatus: number[]): boolean {\r\n return retryOnStatus.includes(status);\r\n }\r\n\r\n private computeBackoffMs(attemptIndex: number, baseDelayMs: number, maxDelayMs: number): number {\r\n const exp = baseDelayMs Math.pow(2, attemptIndex - 1);\r\n const capped = clamp(exp, baseDelayMs, maxDelayMs);\r\n const jitter = 0.5 + Math.random();\r\n return Math.round(capped * jitter);\r\n }\r\n\r\n private async fetchWithLeaderRetry(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const retry = mc.retry;\r\n if (!retry) return this.execute(req, { allowProbe: false });\r\n\r\n const { maxAttempts, baseDelayMs, maxDelayMs, retryOnStatus } = retry;\r\n\r\n let last: ResilientResponse \| undefined;\r\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\r\n const res = await this.execute(req, { allowProbe: false });\r\n last = res;\r\n\r\n if (this.isRetryableStatus(res.status, retryOnStatus) && attempt < maxAttempts) {\r\n const delay = this.computeBackoffMs(attempt, baseDelayMs, maxDelayMs);\r\n this.emit(\"microcache:retry\", { url: req.url, attempt, maxAttempts, reason: `status ${res.status}`, delayMs: delay });\r\n await sleep(delay);\r\n continue;\r\n }\r\n return res;\r\n }\r\n return last!;\r\n }\r\n\r\n private async requestWithMicroCache(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const cache = this.cache!;\r\n const inFlight = this.inFlight!;\r\n\r\n this.maybeCleanupExpired(cache, mc.maxStaleMs);\r\n\r\n const key = mc.keyFn(req);\r\n const now = Date.now();\r\n\r\n const hit0 = cache.get(key);\r\n if (hit0 && now - hit0.createdAt > mc.maxStaleMs) cache.delete(key);\r\n\r\n const hit = cache.get(key);\r\n if (hit && now < hit.expiresAt) return this.cloneResponse(hit.value);\r\n\r\n // If CLOSED: serve stale if allowed else fail fast\r\n if (this.healthEnabled) {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") {\r\n const staleAllowed = !!hit && now - hit.createdAt <= mc.maxStaleMs;\r\n if (staleAllowed) return this.cloneResponse(hit!.value);\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n const group = inFlight.get(key);\r\n if (group) {\r\n const h = cache.get(key);\r\n const staleAllowed = !!h && now - h.createdAt <= mc.maxStaleMs;\r\n\r\n if (h && staleAllowed) return this.cloneResponse(h.value);\r\n\r\n const age = now - group.windowStartMs;\r\n if (age > mc.followerTimeoutMs) {\r\n const err = new Error(`Follower window closed for key=${key}`);\r\n (err as any).name = \"FollowerWindowClosedError\";\r\n throw err;\r\n }\r\n\r\n if (group.waiters >= mc.maxWaiters) {\r\n const err = new Error(`Too many followers for key=${key}`);\r\n (err as any).name = \"TooManyWaitersError\";\r\n throw err;\r\n }\r\n\r\n group.waiters += 1;\r\n try {\r\n const res = await group.promise;\r\n return this.cloneResponse(res);\r\n } finally {\r\n group.waiters -= 1;\r\n }\r\n }\r\n\r\n const prev = cache.get(key);\r\n const prevStaleAllowed = !!prev && now - prev.createdAt <= mc.maxStaleMs;\r\n\r\n const promise = (async () => {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const allowProbe = this.healthEnabled && h.state === \"HALF_OPEN\";\r\n\r\n const res = allowProbe\r\n ? await this.execute(req, { allowProbe: true })\r\n : await this.fetchWithLeaderRetry(req);\r\n\r\n if (res.status >= 200 && res.status < 300) {\r\n this.evictIfNeeded(cache, mc.maxEntries);\r\n const t = Date.now();\r\n cache.set(key, { value: this.cloneResponse(res), createdAt: t, expiresAt: t + mc.ttlMs });\r\n }\r\n return res;\r\n })();\r\n\r\n inFlight.set(key, { promise, windowStartMs: Date.now(), waiters: 0 });\r\n\r\n try {\r\n const res = await promise;\r\n\r\n if (!(res.status >= 200 && res.status < 300) && prev && prevStaleAllowed) {\r\n return this.cloneResponse(prev.value);\r\n }\r\n\r\n return this.cloneResponse(res);\r\n } catch (err) {\r\n if (prev && prevStaleAllowed) {\r\n this.emit(\"microcache:refresh_failed\", { key, url: req.url, error: err });\r\n return this.cloneResponse(prev.value);\r\n }\r\n throw err;\r\n } finally {\r\n inFlight.delete(key);\r\n }\r\n }\r\n}\r\n","export abstract class ResilientHttpError extends Error {\r\n public readonly name: string;\r\n constructor(message: string) {\r\n super(message);\r\n this.name = this.constructor.name;\r\n }\r\n}\r\n\r\nexport class QueueFullError extends ResilientHttpError {\r\n constructor(public readonly maxQueue: number) {\r\n super(`Queue is full (maxQueue=${maxQueue}).`);\r\n }\r\n}\r\n\r\nexport class QueueTimeoutError extends ResilientHttpError {\r\n constructor(public readonly enqueueTimeoutMs: number) {\r\n super(`Queue wait exceeded (enqueueTimeoutMs=${enqueueTimeoutMs}).`);\r\n }\r\n}\r\n\r\nexport class RequestTimeoutError extends ResilientHttpError {\r\n constructor(public readonly requestTimeoutMs: number) {\r\n super(`Request timed out (requestTimeoutMs=${requestTimeoutMs}).`);\r\n }\r\n}\r\n\r\n\r\n\r\nexport class UpstreamError extends ResilientHttpError {\r\n constructor(public readonly status: number) {\r\n super(`Upstream returned error status=${status}.`);\r\n }\r\n}\r\n\r\n\r\n\r\n\r\nexport class UpstreamUnhealthyError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string, public readonly state: string) {\r\n super(`Upstream is unhealthy (state=${state}, baseUrl=${baseUrl}).`);\r\n }\r\n}\r\n\r\nexport class HalfOpenRejectedError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string) {\r\n super(`Upstream is HALF_OPEN (probe only) for baseUrl=${baseUrl}.`);\r\n }\r\n}\r\n","// src/limiter.ts\r\nimport { QueueFullError } from \"./errors.js\";\r\n\r\ntype ResolveFn = () => void;\r\ntype RejectFn = (err: unknown) => void;\r\n\r\ninterface Waiter {\r\n resolve: ResolveFn;\r\n reject: RejectFn;\r\n}\r\n\r\n/*\r\n Process-local concurrency limiter with bounded FIFO queue.\r\n \r\n - maxInFlight: concurrent permits\r\n * - maxQueue: bounded burst buffer\r\n * - No enqueue-timeout by design.\r\n \r\n Also supports:\r\n * - flush(err): reject all queued waiters immediately\r\n * - acquireNoQueue(): for probes (must start now or fail)\r\n /\r\nexport class ConcurrencyLimiter {\r\n private readonly maxInFlight: number;\r\n private readonly maxQueue: number;\r\n\r\n private inFlight = 0;\r\n private queue: Waiter[] = [];\r\n\r\n constructor(opts: { maxInFlight: number; maxQueue: number }) {\r\n if (!Number.isFinite(opts.maxInFlight) \|\| opts.maxInFlight <= 0) {\r\n throw new Error(`maxInFlight must be > 0 (got ${opts.maxInFlight})`);\r\n }\r\n if (!Number.isFinite(opts.maxQueue) \|\| opts.maxQueue < 0) {\r\n throw new Error(`maxQueue must be >= 0 (got ${opts.maxQueue})`);\r\n }\r\n\r\n this.maxInFlight = opts.maxInFlight;\r\n this.maxQueue = opts.maxQueue;\r\n }\r\n\r\n acquire(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n\r\n if (this.maxQueue === 0 \|\| this.queue.length >= this.maxQueue) {\r\n return Promise.reject(new QueueFullError(this.maxQueue));\r\n }\r\n\r\n return new Promise<void>((resolve, reject) => {\r\n this.queue.push({ resolve, reject });\r\n });\r\n }\r\n\r\n /\r\n Acquire without queueing: either start now or fail.\r\n * Used for HALF_OPEN probes so recovery never waits behind backlog.\r\n /\r\n acquireNoQueue(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n // treat as queue full (we don't want a new error type)\r\n return Promise.reject(new QueueFullError(0));\r\n }\r\n\r\n release(): void {\r\n if (this.inFlight <= 0) {\r\n throw new Error(\"release() called when inFlight is already 0\");\r\n }\r\n\r\n const next = this.queue.shift();\r\n if (next) {\r\n next.resolve(); // transfer permit\r\n return;\r\n }\r\n\r\n this.inFlight -= 1;\r\n }\r\n\r\n flush(err: unknown): void {\r\n const q = this.queue;\r\n this.queue = [];\r\n for (const w of q) w.reject(err);\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number; maxInFlight: number; maxQueue: number } {\r\n return {\r\n inFlight: this.inFlight,\r\n queueDepth: this.queue.length,\r\n maxInFlight: this.maxInFlight,\r\n maxQueue: this.maxQueue,\r\n };\r\n }\r\n}\r\n","// src/http.ts\r\nimport { request as undiciRequest } from \"undici\";\r\nimport { RequestTimeoutError } from \"./errors.js\";\r\nimport type { ResilientRequest, ResilientResponse } from \"./types.js\";\r\n\r\nfunction normalizeHeaders(headers: any): Record<string, string> {\r\n const out: Record<string, string> = {};\r\n if (!headers) return out;\r\n\r\n // undici headers are an object-like structure (headers: Record<string, string \| string[]>)\r\n for (const [k, v] of Object.entries(headers)) {\r\n if (Array.isArray(v)) out[k.toLowerCase()] = v.join(\", \");\r\n else if (typeof v === \"string\") out[k.toLowerCase()] = v;\r\n else out[k.toLowerCase()] = String(v);\r\n }\r\n return out;\r\n}\r\n\r\n/\r\n Execute a single HTTP request with a hard timeout using AbortController.\r\n * No retries. No breaker. Just raw outbound I/O with a timeout.\r\n */\r\nexport async function doHttpRequest(\r\n req: ResilientRequest,\r\n requestTimeoutMs: number\r\n): Promise<ResilientResponse> {\r\n const ac = new AbortController();\r\n const timer = setTimeout(() => ac.abort(), requestTimeoutMs);\r\n\r\n try {\r\n const res = await undiciRequest(req.url, {\r\n method: req.method,\r\n headers: req.headers,\r\n body: req.body as any,\r\n signal: ac.signal,\r\n });\r\n\r\n const body = await res.body.arrayBuffer();\r\n return {\r\n status: res.statusCode,\r\n headers: normalizeHeaders(res.headers),\r\n body: new Uint8Array(body),\r\n };\r\n } catch (err: any) {\r\n // undici throws AbortError on abort\r\n if (err?.name === \"AbortError\") {\r\n throw new RequestTimeoutError(requestTimeoutMs);\r\n }\r\n throw err;\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n}\r\n"],"mappings":"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","names":["undiciRequest"]}

package/dist/index.js CHANGED Viewed

@@ -389,11 +389,13 @@ var ResilientHttpClient = class extends EventEmitter {
     }
     const requestId = genRequestId();
     const start = Date.now();
+    let acquired = false;
     try {
       if (this.healthEnabled && h.state === "HALF_OPEN") {
         await limiter.acquireNoQueue();
       } else {
         await limiter.acquire();
+        acquired = true;
       }
     } catch (err) {
       this.emit("request:rejected", { requestId, request: req, error: err });
@@ -430,7 +432,7 @@ var ResilientHttpClient = class extends EventEmitter {
       if (this.healthEnabled && h.state === "HALF_OPEN") {
         h.probeInFlight = false;
       }
-      limiter.release();
+      if (acquired) limiter.release();
     }
   }
   /* ---------------- microcache ---------------- */

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/client.ts","../src/errors.ts","../src/limiter.ts","../src/http.ts"],"sourcesContent":["// src/client.ts\r\nimport { EventEmitter } from \"node:events\";\r\nimport { ConcurrencyLimiter } from \"./limiter.js\";\r\nimport { doHttpRequest } from \"./http.js\";\r\nimport {\r\n QueueFullError,\r\n RequestTimeoutError,\r\n ResilientHttpError,\r\n HalfOpenRejectedError,\r\n UpstreamUnhealthyError,\r\n} from \"./errors.js\";\r\nimport type {\r\n MicroCacheOptions,\r\n ResilientHttpClientOptions,\r\n ResilientRequest,\r\n ResilientResponse,\r\n} from \"./types.js\";\r\n\r\n/* ---------------------------- helpers ---------------------------- /\r\n\r\nfunction normalizeUrlForKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return u.toString();\r\n}\r\n\r\nfunction baseUrlKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return `${u.protocol}//${u.host}`;\r\n}\r\n\r\nfunction defaultMicroCacheKeyFn(req: ResilientRequest): string {\r\n return `GET ${normalizeUrlForKey(req.url)}`;\r\n}\r\n\r\nfunction genRequestId(): string {\r\n return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\r\n}\r\n\r\nfunction sleep(ms: number): Promise<void> {\r\n return new Promise((r) => setTimeout(r, ms));\r\n}\r\n\r\nfunction clamp(n: number, lo: number, hi: number): number {\r\n return Math.max(lo, Math.min(hi, n));\r\n}\r\n\r\nfunction jitterMs(ms: number): number {\r\n const mult = 0.8 + Math.random() 0.4; // [0.8, 1.2]\r\n return Math.round(ms * mult);\r\n}\r\n\r\n\r\n/* ---------------------------- health ---------------------------- /\r\n\r\ntype HealthState = \"OPEN\" \| \"CLOSED\" \| \"HALF_OPEN\";\r\ntype Outcome = \"SUCCESS\" \| \"HARD_FAIL\" \| \"SOFT_FAIL\";\r\n\r\ntype HealthTracker = {\r\n state: HealthState;\r\n\r\n window: Outcome[];\r\n windowSize: number; // 20\r\n minSamples: number; // 10\r\n\r\n consecutiveHardFails: number; // trip at 3\r\n\r\n cooldownBaseMs: number; // 1000\r\n cooldownCapMs: number; // 30000\r\n cooldownMs: number; // current backoff\r\n cooldownUntil: number;\r\n\r\n probeInFlight: boolean; // probeConcurrency=1\r\n probeRemaining: number; // 1 probe per half-open\r\n\r\n stableNonHard: number; // reset backoff after 5 non-hard after open\r\n};\r\n\r\nconst SOFT_FAIL_STATUSES = new Set([429, 502, 503, 504]);\r\n\r\nfunction classifyHttpStatus(status: number): Outcome {\r\n if (status >= 200 && status < 300) return \"SUCCESS\";\r\n if (SOFT_FAIL_STATUSES.has(status)) return \"SOFT_FAIL\";\r\n return \"SUCCESS\"; // do not penalize health for other statuses (incl 4xx except 429)\r\n}\r\n\r\nfunction computeRates(window: Outcome[]) {\r\n const total = window.length;\r\n let hard = 0;\r\n let soft = 0;\r\n for (const o of window) {\r\n if (o === \"HARD_FAIL\") hard += 1;\r\n else if (o === \"SOFT_FAIL\") soft += 1;\r\n }\r\n return {\r\n total,\r\n hard,\r\n soft,\r\n hardFailRate: total === 0 ? 0 : hard / total,\r\n failRate: total === 0 ? 0 : (hard + soft) / total,\r\n };\r\n}\r\n\r\n/\r\n Only HTTP-layer failures should count as HARD_FAIL.\r\n * Control-plane rejections must NOT poison health.\r\n /\r\nfunction shouldCountAsHardFail(err: unknown): boolean {\r\n if (err instanceof UpstreamUnhealthyError) return false;\r\n if (err instanceof HalfOpenRejectedError) return false;\r\n if (err instanceof QueueFullError) return false;\r\n\r\n // if your http layer throws this, it's a real hard fail (timeout)\r\n if (err instanceof RequestTimeoutError) return true;\r\n\r\n // If it’s a known library error but not one of the above, be conservative:\r\n // treat it as NOT a health signal unless it’s clearly HTTP-related.\r\n if (err instanceof ResilientHttpError) return false;\r\n\r\n // Unknown thrown error: assume it's an HTTP/network failure.\r\n return true;\r\n}\r\n\r\n/ ---------------------------- microcache types ---------------------------- /\r\n\r\ntype CacheEntry = {\r\n createdAt: number;\r\n expiresAt: number;\r\n value: ResilientResponse;\r\n};\r\n\r\ntype InFlightGroup = {\r\n promise: Promise<ResilientResponse>;\r\n windowStartMs: number;\r\n waiters: number;\r\n};\r\n\r\n/ ---------------------------- client ---------------------------- /\r\n\r\nexport class ResilientHttpClient extends EventEmitter {\r\n private readonly requestTimeoutMs: number;\r\n private readonly healthEnabled: boolean;\r\n\r\n private readonly limiters = new Map<string, ConcurrencyLimiter>();\r\n private readonly health = new Map<string, HealthTracker>();\r\n\r\n private readonly microCache?: Required<\r\n Pick<\r\n MicroCacheOptions,\r\n \| \"enabled\"\r\n \| \"ttlMs\"\r\n \| \"maxStaleMs\"\r\n \| \"maxEntries\"\r\n \| \"maxWaiters\"\r\n \| \"followerTimeoutMs\"\r\n \| \"keyFn\"\r\n >\r\n > & {\r\n retry?: {\r\n maxAttempts: number;\r\n baseDelayMs: number;\r\n maxDelayMs: number;\r\n retryOnStatus: number[];\r\n };\r\n };\r\n\r\n private cache?: Map<string, CacheEntry>;\r\n private inFlight?: Map<string, InFlightGroup>;\r\n\r\n private microCacheReqCount = 0;\r\n private readonly cleanupEveryNRequests = 100;\r\n\r\n constructor(private readonly opts: ResilientHttpClientOptions) {\r\n super();\r\n this.requestTimeoutMs = opts.requestTimeoutMs;\r\n this.healthEnabled = opts.health?.enabled ?? true;\r\n\r\n const mc = opts.microCache;\r\n if (mc?.enabled) {\r\n const retry = mc.retry\r\n ? {\r\n maxAttempts: mc.retry.maxAttempts ?? 3,\r\n baseDelayMs: mc.retry.baseDelayMs ?? 50,\r\n maxDelayMs: mc.retry.maxDelayMs ?? 200,\r\n retryOnStatus: mc.retry.retryOnStatus ?? [429, 502, 503, 504],\r\n }\r\n : undefined;\r\n\r\n this.microCache = {\r\n enabled: true,\r\n ttlMs: mc.ttlMs ?? 1000,\r\n maxStaleMs: mc.maxStaleMs ?? 10_000,\r\n maxEntries: mc.maxEntries ?? 500,\r\n maxWaiters: mc.maxWaiters ?? 1000,\r\n followerTimeoutMs: mc.followerTimeoutMs ?? 5000,\r\n keyFn: mc.keyFn ?? defaultMicroCacheKeyFn,\r\n retry,\r\n };\r\n\r\n this.cache = new Map();\r\n this.inFlight = new Map();\r\n }\r\n }\r\n\r\n async request(req: ResilientRequest): Promise<ResilientResponse> {\r\n if (this.microCache?.enabled && req.method === \"GET\" && req.body == null) {\r\n return this.requestWithMicroCache(req);\r\n }\r\n return this.execute(req, { allowProbe: false });\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number } {\r\n let inFlight = 0;\r\n let queueDepth = 0;\r\n for (const l of this.limiters.values()) {\r\n const s = l.snapshot();\r\n inFlight += s.inFlight;\r\n queueDepth += s.queueDepth;\r\n }\r\n return { inFlight, queueDepth };\r\n }\r\n\r\n / ---------------- internals ---------------- /\r\n\r\n private getLimiter(baseKey: string): ConcurrencyLimiter {\r\n let l = this.limiters.get(baseKey);\r\n if (!l) {\r\n l = new ConcurrencyLimiter({\r\n maxInFlight: this.opts.maxInFlight,\r\n maxQueue: this.opts.maxInFlight 10, // hidden factor\r\n });\r\n this.limiters.set(baseKey, l);\r\n }\r\n return l;\r\n }\r\n\r\n private getHealth(baseKey: string): HealthTracker {\r\n let h = this.health.get(baseKey);\r\n if (!h) {\r\n h = {\r\n state: \"OPEN\",\r\n window: [],\r\n windowSize: 20,\r\n minSamples: 10,\r\n consecutiveHardFails: 0,\r\n cooldownBaseMs: 1000,\r\n cooldownCapMs: 30_000,\r\n cooldownMs: 1000,\r\n cooldownUntil: 0,\r\n probeInFlight: false,\r\n probeRemaining: 0,\r\n stableNonHard: 0,\r\n };\r\n this.health.set(baseKey, h);\r\n }\r\n return h;\r\n }\r\n\r\n private closeHealth(baseKey: string, reason: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") return;\r\n\r\n h.state = \"CLOSED\";\r\n h.cooldownUntil = Date.now() + jitterMs(h.cooldownMs);\r\n h.cooldownMs = Math.min(h.cooldownMs * 2, h.cooldownCapMs);\r\n\r\n // reject queued immediately\r\n this.getLimiter(baseKey).flush(new UpstreamUnhealthyError(baseKey, \"CLOSED\"));\r\n\r\n const rates = computeRates(h.window);\r\n this.emit(\"health:closed\", {\r\n baseUrl: baseKey,\r\n reason,\r\n cooldownMs: h.cooldownUntil - Date.now(),\r\n hardFailRate: rates.hardFailRate,\r\n failRate: rates.failRate,\r\n samples: rates.total,\r\n });\r\n }\r\n\r\n private halfOpenHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state !== \"CLOSED\") return;\r\n\r\n h.state = \"HALF_OPEN\";\r\n h.probeInFlight = false;\r\n h.probeRemaining = 1;\r\n this.emit(\"health:half_open\", { baseUrl: baseKey });\r\n }\r\n\r\n private openHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n h.state = \"OPEN\";\r\n h.window = [];\r\n h.consecutiveHardFails = 0;\r\n h.probeInFlight = false;\r\n h.probeRemaining = 0;\r\n h.stableNonHard = 0;\r\n this.emit(\"health:open\", { baseUrl: baseKey });\r\n }\r\n\r\n private recordOutcome(baseKey: string, outcome: Outcome): void {\r\n const h = this.getHealth(baseKey);\r\n\r\n h.window.push(outcome);\r\n while (h.window.length > h.windowSize) h.window.shift();\r\n\r\n if (outcome === \"HARD_FAIL\") h.consecutiveHardFails += 1;\r\n else h.consecutiveHardFails = 0;\r\n\r\n // stabilization (reset backoff after 5 non-hard in OPEN)\r\n if (h.state === \"OPEN\") {\r\n if (outcome !== \"HARD_FAIL\") {\r\n h.stableNonHard += 1;\r\n if (h.stableNonHard >= 5) {\r\n h.cooldownMs = h.cooldownBaseMs;\r\n }\r\n } else {\r\n h.stableNonHard = 0;\r\n }\r\n }\r\n\r\n if (!this.healthEnabled) return;\r\n\r\n if (h.consecutiveHardFails >= 3) {\r\n this.closeHealth(baseKey, \"3 consecutive hard failures\");\r\n return;\r\n }\r\n\r\n const rates = computeRates(h.window);\r\n if (rates.total >= h.minSamples) {\r\n if (rates.hardFailRate >= 0.3) {\r\n this.closeHealth(baseKey, \"hardFailRate >= 30%\");\r\n return;\r\n }\r\n if (rates.failRate >= 0.5) {\r\n this.closeHealth(baseKey, \"failRate >= 50%\");\r\n return;\r\n }\r\n }\r\n }\r\n\r\n private async execute(req: ResilientRequest, opts: { allowProbe: boolean }): Promise<ResilientResponse> {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const limiter = this.getLimiter(baseKey);\r\n\r\n if (this.healthEnabled) {\r\n if (h.state === \"CLOSED\") {\r\n if (Date.now() >= h.cooldownUntil) {\r\n this.halfOpenHealth(baseKey);\r\n } else {\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n if (h.state === \"HALF_OPEN\") {\r\n if (!opts.allowProbe) throw new HalfOpenRejectedError(baseKey);\r\n if (h.probeRemaining <= 0 \|\| h.probeInFlight) throw new HalfOpenRejectedError(baseKey);\r\n h.probeInFlight = true;\r\n h.probeRemaining -= 1;\r\n }\r\n }\r\n\r\n const requestId = genRequestId();\r\n const start = Date.now();\r\n\r\n try {\r\n // Probes should not wait in queue.\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n await limiter.acquireNoQueue();\r\n } else {\r\n await limiter.acquire();\r\n }\r\n } catch (err) {\r\n this.emit(\"request:rejected\", { requestId, request: req, error: err });\r\n throw err;\r\n }\r\n\r\n this.emit(\"request:start\", { requestId, request: req });\r\n\r\n try {\r\n const res = await doHttpRequest(req, this.requestTimeoutMs);\r\n const durationMs = Date.now() - start;\r\n\r\n const outcome = classifyHttpStatus(res.status);\r\n this.recordOutcome(baseKey, outcome);\r\n\r\n // Probe decision\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome, status: res.status });\r\n if (res.status >= 200 && res.status < 300) {\r\n this.openHealth(baseKey);\r\n } else {\r\n this.closeHealth(baseKey, `probe failed status=${res.status}`);\r\n }\r\n }\r\n\r\n this.emit(\"request:success\", { requestId, request: req, status: res.status, durationMs });\r\n return res;\r\n } catch (err) {\r\n const durationMs = Date.now() - start;\r\n\r\n if (shouldCountAsHardFail(err)) {\r\n this.recordOutcome(baseKey, \"HARD_FAIL\");\r\n }\r\n\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome: \"HARD_FAIL\", error: err });\r\n this.closeHealth(baseKey, \"probe hard failure\");\r\n }\r\n\r\n this.emit(\"request:failure\", { requestId, request: req, error: err, durationMs });\r\n throw err;\r\n } finally {\r\n // Clear probe flag (if any)\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n h.probeInFlight = false;\r\n }\r\n limiter.release();\r\n }\r\n }\r\n\r\n /* ---------------- microcache ---------------- /\r\n\r\n private cloneResponse(res: ResilientResponse): ResilientResponse {\r\n return { status: res.status, headers: { ...res.headers }, body: new Uint8Array(res.body) };\r\n }\r\n\r\n private maybeCleanupExpired(cache: Map<string, CacheEntry>, maxStaleMs: number): void {\r\n this.microCacheReqCount++;\r\n if (this.microCacheReqCount % this.cleanupEveryNRequests !== 0) return;\r\n\r\n const now = Date.now();\r\n for (const [k, v] of cache.entries()) {\r\n if (now - v.createdAt > maxStaleMs) cache.delete(k);\r\n }\r\n }\r\n\r\n private evictIfNeeded(cache: Map<string, CacheEntry>, maxEntries: number): void {\r\n while (cache.size >= maxEntries) {\r\n const oldestKey = cache.keys().next().value as string \| undefined;\r\n if (!oldestKey) break;\r\n cache.delete(oldestKey);\r\n }\r\n }\r\n\r\n private isRetryableStatus(status: number, retryOnStatus: number[]): boolean {\r\n return retryOnStatus.includes(status);\r\n }\r\n\r\n private computeBackoffMs(attemptIndex: number, baseDelayMs: number, maxDelayMs: number): number {\r\n const exp = baseDelayMs Math.pow(2, attemptIndex - 1);\r\n const capped = clamp(exp, baseDelayMs, maxDelayMs);\r\n const jitter = 0.5 + Math.random();\r\n return Math.round(capped * jitter);\r\n }\r\n\r\n private async fetchWithLeaderRetry(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const retry = mc.retry;\r\n if (!retry) return this.execute(req, { allowProbe: false });\r\n\r\n const { maxAttempts, baseDelayMs, maxDelayMs, retryOnStatus } = retry;\r\n\r\n let last: ResilientResponse \| undefined;\r\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\r\n const res = await this.execute(req, { allowProbe: false });\r\n last = res;\r\n\r\n if (this.isRetryableStatus(res.status, retryOnStatus) && attempt < maxAttempts) {\r\n const delay = this.computeBackoffMs(attempt, baseDelayMs, maxDelayMs);\r\n this.emit(\"microcache:retry\", { url: req.url, attempt, maxAttempts, reason: `status ${res.status}`, delayMs: delay });\r\n await sleep(delay);\r\n continue;\r\n }\r\n return res;\r\n }\r\n return last!;\r\n }\r\n\r\n private async requestWithMicroCache(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const cache = this.cache!;\r\n const inFlight = this.inFlight!;\r\n\r\n this.maybeCleanupExpired(cache, mc.maxStaleMs);\r\n\r\n const key = mc.keyFn(req);\r\n const now = Date.now();\r\n\r\n const hit0 = cache.get(key);\r\n if (hit0 && now - hit0.createdAt > mc.maxStaleMs) cache.delete(key);\r\n\r\n const hit = cache.get(key);\r\n if (hit && now < hit.expiresAt) return this.cloneResponse(hit.value);\r\n\r\n // If CLOSED: serve stale if allowed else fail fast\r\n if (this.healthEnabled) {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") {\r\n const staleAllowed = !!hit && now - hit.createdAt <= mc.maxStaleMs;\r\n if (staleAllowed) return this.cloneResponse(hit!.value);\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n const group = inFlight.get(key);\r\n if (group) {\r\n const h = cache.get(key);\r\n const staleAllowed = !!h && now - h.createdAt <= mc.maxStaleMs;\r\n\r\n if (h && staleAllowed) return this.cloneResponse(h.value);\r\n\r\n const age = now - group.windowStartMs;\r\n if (age > mc.followerTimeoutMs) {\r\n const err = new Error(`Follower window closed for key=${key}`);\r\n (err as any).name = \"FollowerWindowClosedError\";\r\n throw err;\r\n }\r\n\r\n if (group.waiters >= mc.maxWaiters) {\r\n const err = new Error(`Too many followers for key=${key}`);\r\n (err as any).name = \"TooManyWaitersError\";\r\n throw err;\r\n }\r\n\r\n group.waiters += 1;\r\n try {\r\n const res = await group.promise;\r\n return this.cloneResponse(res);\r\n } finally {\r\n group.waiters -= 1;\r\n }\r\n }\r\n\r\n const prev = cache.get(key);\r\n const prevStaleAllowed = !!prev && now - prev.createdAt <= mc.maxStaleMs;\r\n\r\n const promise = (async () => {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const allowProbe = this.healthEnabled && h.state === \"HALF_OPEN\";\r\n\r\n const res = allowProbe\r\n ? await this.execute(req, { allowProbe: true })\r\n : await this.fetchWithLeaderRetry(req);\r\n\r\n if (res.status >= 200 && res.status < 300) {\r\n this.evictIfNeeded(cache, mc.maxEntries);\r\n const t = Date.now();\r\n cache.set(key, { value: this.cloneResponse(res), createdAt: t, expiresAt: t + mc.ttlMs });\r\n }\r\n return res;\r\n })();\r\n\r\n inFlight.set(key, { promise, windowStartMs: Date.now(), waiters: 0 });\r\n\r\n try {\r\n const res = await promise;\r\n\r\n if (!(res.status >= 200 && res.status < 300) && prev && prevStaleAllowed) {\r\n return this.cloneResponse(prev.value);\r\n }\r\n\r\n return this.cloneResponse(res);\r\n } catch (err) {\r\n if (prev && prevStaleAllowed) {\r\n this.emit(\"microcache:refresh_failed\", { key, url: req.url, error: err });\r\n return this.cloneResponse(prev.value);\r\n }\r\n throw err;\r\n } finally {\r\n inFlight.delete(key);\r\n }\r\n }\r\n}\r\n","export abstract class ResilientHttpError extends Error {\r\n public readonly name: string;\r\n constructor(message: string) {\r\n super(message);\r\n this.name = this.constructor.name;\r\n }\r\n}\r\n\r\nexport class QueueFullError extends ResilientHttpError {\r\n constructor(public readonly maxQueue: number) {\r\n super(`Queue is full (maxQueue=${maxQueue}).`);\r\n }\r\n}\r\n\r\nexport class QueueTimeoutError extends ResilientHttpError {\r\n constructor(public readonly enqueueTimeoutMs: number) {\r\n super(`Queue wait exceeded (enqueueTimeoutMs=${enqueueTimeoutMs}).`);\r\n }\r\n}\r\n\r\nexport class RequestTimeoutError extends ResilientHttpError {\r\n constructor(public readonly requestTimeoutMs: number) {\r\n super(`Request timed out (requestTimeoutMs=${requestTimeoutMs}).`);\r\n }\r\n}\r\n\r\n\r\n\r\nexport class UpstreamError extends ResilientHttpError {\r\n constructor(public readonly status: number) {\r\n super(`Upstream returned error status=${status}.`);\r\n }\r\n}\r\n\r\n\r\n\r\n\r\nexport class UpstreamUnhealthyError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string, public readonly state: string) {\r\n super(`Upstream is unhealthy (state=${state}, baseUrl=${baseUrl}).`);\r\n }\r\n}\r\n\r\nexport class HalfOpenRejectedError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string) {\r\n super(`Upstream is HALF_OPEN (probe only) for baseUrl=${baseUrl}.`);\r\n }\r\n}\r\n","// src/limiter.ts\r\nimport { QueueFullError } from \"./errors.js\";\r\n\r\ntype ResolveFn = () => void;\r\ntype RejectFn = (err: unknown) => void;\r\n\r\ninterface Waiter {\r\n resolve: ResolveFn;\r\n reject: RejectFn;\r\n}\r\n\r\n/*\r\n Process-local concurrency limiter with bounded FIFO queue.\r\n \r\n - maxInFlight: concurrent permits\r\n * - maxQueue: bounded burst buffer\r\n * - No enqueue-timeout by design.\r\n \r\n Also supports:\r\n * - flush(err): reject all queued waiters immediately\r\n * - acquireNoQueue(): for probes (must start now or fail)\r\n /\r\nexport class ConcurrencyLimiter {\r\n private readonly maxInFlight: number;\r\n private readonly maxQueue: number;\r\n\r\n private inFlight = 0;\r\n private queue: Waiter[] = [];\r\n\r\n constructor(opts: { maxInFlight: number; maxQueue: number }) {\r\n if (!Number.isFinite(opts.maxInFlight) \|\| opts.maxInFlight <= 0) {\r\n throw new Error(`maxInFlight must be > 0 (got ${opts.maxInFlight})`);\r\n }\r\n if (!Number.isFinite(opts.maxQueue) \|\| opts.maxQueue < 0) {\r\n throw new Error(`maxQueue must be >= 0 (got ${opts.maxQueue})`);\r\n }\r\n\r\n this.maxInFlight = opts.maxInFlight;\r\n this.maxQueue = opts.maxQueue;\r\n }\r\n\r\n acquire(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n\r\n if (this.maxQueue === 0 \|\| this.queue.length >= this.maxQueue) {\r\n return Promise.reject(new QueueFullError(this.maxQueue));\r\n }\r\n\r\n return new Promise<void>((resolve, reject) => {\r\n this.queue.push({ resolve, reject });\r\n });\r\n }\r\n\r\n /\r\n Acquire without queueing: either start now or fail.\r\n * Used for HALF_OPEN probes so recovery never waits behind backlog.\r\n /\r\n acquireNoQueue(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n // treat as queue full (we don't want a new error type)\r\n return Promise.reject(new QueueFullError(0));\r\n }\r\n\r\n release(): void {\r\n if (this.inFlight <= 0) {\r\n throw new Error(\"release() called when inFlight is already 0\");\r\n }\r\n\r\n const next = this.queue.shift();\r\n if (next) {\r\n next.resolve(); // transfer permit\r\n return;\r\n }\r\n\r\n this.inFlight -= 1;\r\n }\r\n\r\n flush(err: unknown): void {\r\n const q = this.queue;\r\n this.queue = [];\r\n for (const w of q) w.reject(err);\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number; maxInFlight: number; maxQueue: number } {\r\n return {\r\n inFlight: this.inFlight,\r\n queueDepth: this.queue.length,\r\n maxInFlight: this.maxInFlight,\r\n maxQueue: this.maxQueue,\r\n };\r\n }\r\n}\r\n","// src/http.ts\r\nimport { request as undiciRequest } from \"undici\";\r\nimport { RequestTimeoutError } from \"./errors.js\";\r\nimport type { ResilientRequest, ResilientResponse } from \"./types.js\";\r\n\r\nfunction normalizeHeaders(headers: any): Record<string, string> {\r\n const out: Record<string, string> = {};\r\n if (!headers) return out;\r\n\r\n // undici headers are an object-like structure (headers: Record<string, string \| string[]>)\r\n for (const [k, v] of Object.entries(headers)) {\r\n if (Array.isArray(v)) out[k.toLowerCase()] = v.join(\", \");\r\n else if (typeof v === \"string\") out[k.toLowerCase()] = v;\r\n else out[k.toLowerCase()] = String(v);\r\n }\r\n return out;\r\n}\r\n\r\n/\r\n Execute a single HTTP request with a hard timeout using AbortController.\r\n * No retries. No breaker. Just raw outbound I/O with a timeout.\r\n */\r\nexport async function doHttpRequest(\r\n req: ResilientRequest,\r\n requestTimeoutMs: number\r\n): Promise<ResilientResponse> {\r\n const ac = new AbortController();\r\n const timer = setTimeout(() => ac.abort(), requestTimeoutMs);\r\n\r\n try {\r\n const res = await undiciRequest(req.url, {\r\n method: req.method,\r\n headers: req.headers,\r\n body: req.body as any,\r\n signal: ac.signal,\r\n });\r\n\r\n const body = await res.body.arrayBuffer();\r\n return {\r\n status: res.statusCode,\r\n headers: normalizeHeaders(res.headers),\r\n body: new Uint8Array(body),\r\n };\r\n } catch (err: any) {\r\n // undici throws AbortError on abort\r\n if (err?.name === \"AbortError\") {\r\n throw new RequestTimeoutError(requestTimeoutMs);\r\n }\r\n throw err;\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n}\r\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../src/client.ts","../src/errors.ts","../src/limiter.ts","../src/http.ts"],"sourcesContent":["// src/client.ts\r\nimport { EventEmitter } from \"node:events\";\r\nimport { ConcurrencyLimiter } from \"./limiter.js\";\r\nimport { doHttpRequest } from \"./http.js\";\r\nimport {\r\n QueueFullError,\r\n RequestTimeoutError,\r\n ResilientHttpError,\r\n HalfOpenRejectedError,\r\n UpstreamUnhealthyError,\r\n} from \"./errors.js\";\r\nimport type {\r\n MicroCacheOptions,\r\n ResilientHttpClientOptions,\r\n ResilientRequest,\r\n ResilientResponse,\r\n} from \"./types.js\";\r\n\r\n/* ---------------------------- helpers ---------------------------- /\r\n\r\nfunction normalizeUrlForKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return u.toString();\r\n}\r\n\r\nfunction baseUrlKey(rawUrl: string): string {\r\n const u = new URL(rawUrl);\r\n u.hostname = u.hostname.toLowerCase();\r\n\r\n const isHttpDefault = u.protocol === \"http:\" && u.port === \"80\";\r\n const isHttpsDefault = u.protocol === \"https:\" && u.port === \"443\";\r\n if (isHttpDefault \|\| isHttpsDefault) u.port = \"\";\r\n\r\n return `${u.protocol}//${u.host}`;\r\n}\r\n\r\nfunction defaultMicroCacheKeyFn(req: ResilientRequest): string {\r\n return `GET ${normalizeUrlForKey(req.url)}`;\r\n}\r\n\r\nfunction genRequestId(): string {\r\n return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\r\n}\r\n\r\nfunction sleep(ms: number): Promise<void> {\r\n return new Promise((r) => setTimeout(r, ms));\r\n}\r\n\r\nfunction clamp(n: number, lo: number, hi: number): number {\r\n return Math.max(lo, Math.min(hi, n));\r\n}\r\n\r\nfunction jitterMs(ms: number): number {\r\n const mult = 0.8 + Math.random() 0.4; // [0.8, 1.2]\r\n return Math.round(ms * mult);\r\n}\r\n\r\n\r\n/* ---------------------------- health ---------------------------- /\r\n\r\ntype HealthState = \"OPEN\" \| \"CLOSED\" \| \"HALF_OPEN\";\r\ntype Outcome = \"SUCCESS\" \| \"HARD_FAIL\" \| \"SOFT_FAIL\";\r\n\r\ntype HealthTracker = {\r\n state: HealthState;\r\n\r\n window: Outcome[];\r\n windowSize: number; // 20\r\n minSamples: number; // 10\r\n\r\n consecutiveHardFails: number; // trip at 3\r\n\r\n cooldownBaseMs: number; // 1000\r\n cooldownCapMs: number; // 30000\r\n cooldownMs: number; // current backoff\r\n cooldownUntil: number;\r\n\r\n probeInFlight: boolean; // probeConcurrency=1\r\n probeRemaining: number; // 1 probe per half-open\r\n\r\n stableNonHard: number; // reset backoff after 5 non-hard after open\r\n};\r\n\r\nconst SOFT_FAIL_STATUSES = new Set([429, 502, 503, 504]);\r\n\r\nfunction classifyHttpStatus(status: number): Outcome {\r\n if (status >= 200 && status < 300) return \"SUCCESS\";\r\n if (SOFT_FAIL_STATUSES.has(status)) return \"SOFT_FAIL\";\r\n return \"SUCCESS\"; // do not penalize health for other statuses (incl 4xx except 429)\r\n}\r\n\r\nfunction computeRates(window: Outcome[]) {\r\n const total = window.length;\r\n let hard = 0;\r\n let soft = 0;\r\n for (const o of window) {\r\n if (o === \"HARD_FAIL\") hard += 1;\r\n else if (o === \"SOFT_FAIL\") soft += 1;\r\n }\r\n return {\r\n total,\r\n hard,\r\n soft,\r\n hardFailRate: total === 0 ? 0 : hard / total,\r\n failRate: total === 0 ? 0 : (hard + soft) / total,\r\n };\r\n}\r\n\r\n/\r\n Only HTTP-layer failures should count as HARD_FAIL.\r\n * Control-plane rejections must NOT poison health.\r\n /\r\nfunction shouldCountAsHardFail(err: unknown): boolean {\r\n if (err instanceof UpstreamUnhealthyError) return false;\r\n if (err instanceof HalfOpenRejectedError) return false;\r\n if (err instanceof QueueFullError) return false;\r\n\r\n // if your http layer throws this, it's a real hard fail (timeout)\r\n if (err instanceof RequestTimeoutError) return true;\r\n\r\n // If it’s a known library error but not one of the above, be conservative:\r\n // treat it as NOT a health signal unless it’s clearly HTTP-related.\r\n if (err instanceof ResilientHttpError) return false;\r\n\r\n // Unknown thrown error: assume it's an HTTP/network failure.\r\n return true;\r\n}\r\n\r\n/ ---------------------------- microcache types ---------------------------- /\r\n\r\ntype CacheEntry = {\r\n createdAt: number;\r\n expiresAt: number;\r\n value: ResilientResponse;\r\n};\r\n\r\ntype InFlightGroup = {\r\n promise: Promise<ResilientResponse>;\r\n windowStartMs: number;\r\n waiters: number;\r\n};\r\n\r\n/ ---------------------------- client ---------------------------- /\r\n\r\nexport class ResilientHttpClient extends EventEmitter {\r\n private readonly requestTimeoutMs: number;\r\n private readonly healthEnabled: boolean;\r\n\r\n private readonly limiters = new Map<string, ConcurrencyLimiter>();\r\n private readonly health = new Map<string, HealthTracker>();\r\n\r\n private readonly microCache?: Required<\r\n Pick<\r\n MicroCacheOptions,\r\n \| \"enabled\"\r\n \| \"ttlMs\"\r\n \| \"maxStaleMs\"\r\n \| \"maxEntries\"\r\n \| \"maxWaiters\"\r\n \| \"followerTimeoutMs\"\r\n \| \"keyFn\"\r\n >\r\n > & {\r\n retry?: {\r\n maxAttempts: number;\r\n baseDelayMs: number;\r\n maxDelayMs: number;\r\n retryOnStatus: number[];\r\n };\r\n };\r\n\r\n private cache?: Map<string, CacheEntry>;\r\n private inFlight?: Map<string, InFlightGroup>;\r\n\r\n private microCacheReqCount = 0;\r\n private readonly cleanupEveryNRequests = 100;\r\n\r\n constructor(private readonly opts: ResilientHttpClientOptions) {\r\n super();\r\n this.requestTimeoutMs = opts.requestTimeoutMs;\r\n this.healthEnabled = opts.health?.enabled ?? true;\r\n\r\n const mc = opts.microCache;\r\n if (mc?.enabled) {\r\n const retry = mc.retry\r\n ? {\r\n maxAttempts: mc.retry.maxAttempts ?? 3,\r\n baseDelayMs: mc.retry.baseDelayMs ?? 50,\r\n maxDelayMs: mc.retry.maxDelayMs ?? 200,\r\n retryOnStatus: mc.retry.retryOnStatus ?? [429, 502, 503, 504],\r\n }\r\n : undefined;\r\n\r\n this.microCache = {\r\n enabled: true,\r\n ttlMs: mc.ttlMs ?? 1000,\r\n maxStaleMs: mc.maxStaleMs ?? 10_000,\r\n maxEntries: mc.maxEntries ?? 500,\r\n maxWaiters: mc.maxWaiters ?? 1000,\r\n followerTimeoutMs: mc.followerTimeoutMs ?? 5000,\r\n keyFn: mc.keyFn ?? defaultMicroCacheKeyFn,\r\n retry,\r\n };\r\n\r\n this.cache = new Map();\r\n this.inFlight = new Map();\r\n }\r\n }\r\n\r\n async request(req: ResilientRequest): Promise<ResilientResponse> {\r\n if (this.microCache?.enabled && req.method === \"GET\" && req.body == null) {\r\n return this.requestWithMicroCache(req);\r\n }\r\n return this.execute(req, { allowProbe: false });\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number } {\r\n let inFlight = 0;\r\n let queueDepth = 0;\r\n for (const l of this.limiters.values()) {\r\n const s = l.snapshot();\r\n inFlight += s.inFlight;\r\n queueDepth += s.queueDepth;\r\n }\r\n return { inFlight, queueDepth };\r\n }\r\n\r\n / ---------------- internals ---------------- /\r\n\r\n private getLimiter(baseKey: string): ConcurrencyLimiter {\r\n let l = this.limiters.get(baseKey);\r\n if (!l) {\r\n l = new ConcurrencyLimiter({\r\n maxInFlight: this.opts.maxInFlight,\r\n maxQueue: this.opts.maxInFlight 10, // hidden factor\r\n });\r\n this.limiters.set(baseKey, l);\r\n }\r\n return l;\r\n }\r\n\r\n private getHealth(baseKey: string): HealthTracker {\r\n let h = this.health.get(baseKey);\r\n if (!h) {\r\n h = {\r\n state: \"OPEN\",\r\n window: [],\r\n windowSize: 20,\r\n minSamples: 10,\r\n consecutiveHardFails: 0,\r\n cooldownBaseMs: 1000,\r\n cooldownCapMs: 30_000,\r\n cooldownMs: 1000,\r\n cooldownUntil: 0,\r\n probeInFlight: false,\r\n probeRemaining: 0,\r\n stableNonHard: 0,\r\n };\r\n this.health.set(baseKey, h);\r\n }\r\n return h;\r\n }\r\n\r\n private closeHealth(baseKey: string, reason: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") return;\r\n\r\n h.state = \"CLOSED\";\r\n h.cooldownUntil = Date.now() + jitterMs(h.cooldownMs);\r\n h.cooldownMs = Math.min(h.cooldownMs * 2, h.cooldownCapMs);\r\n\r\n // reject queued immediately\r\n this.getLimiter(baseKey).flush(new UpstreamUnhealthyError(baseKey, \"CLOSED\"));\r\n\r\n const rates = computeRates(h.window);\r\n this.emit(\"health:closed\", {\r\n baseUrl: baseKey,\r\n reason,\r\n cooldownMs: h.cooldownUntil - Date.now(),\r\n hardFailRate: rates.hardFailRate,\r\n failRate: rates.failRate,\r\n samples: rates.total,\r\n });\r\n }\r\n\r\n private halfOpenHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n if (h.state !== \"CLOSED\") return;\r\n\r\n h.state = \"HALF_OPEN\";\r\n h.probeInFlight = false;\r\n h.probeRemaining = 1;\r\n this.emit(\"health:half_open\", { baseUrl: baseKey });\r\n }\r\n\r\n private openHealth(baseKey: string): void {\r\n const h = this.getHealth(baseKey);\r\n h.state = \"OPEN\";\r\n h.window = [];\r\n h.consecutiveHardFails = 0;\r\n h.probeInFlight = false;\r\n h.probeRemaining = 0;\r\n h.stableNonHard = 0;\r\n this.emit(\"health:open\", { baseUrl: baseKey });\r\n }\r\n\r\n private recordOutcome(baseKey: string, outcome: Outcome): void {\r\n const h = this.getHealth(baseKey);\r\n\r\n h.window.push(outcome);\r\n while (h.window.length > h.windowSize) h.window.shift();\r\n\r\n if (outcome === \"HARD_FAIL\") h.consecutiveHardFails += 1;\r\n else h.consecutiveHardFails = 0;\r\n\r\n // stabilization (reset backoff after 5 non-hard in OPEN)\r\n if (h.state === \"OPEN\") {\r\n if (outcome !== \"HARD_FAIL\") {\r\n h.stableNonHard += 1;\r\n if (h.stableNonHard >= 5) {\r\n h.cooldownMs = h.cooldownBaseMs;\r\n }\r\n } else {\r\n h.stableNonHard = 0;\r\n }\r\n }\r\n\r\n if (!this.healthEnabled) return;\r\n\r\n if (h.consecutiveHardFails >= 3) {\r\n this.closeHealth(baseKey, \"3 consecutive hard failures\");\r\n return;\r\n }\r\n\r\n const rates = computeRates(h.window);\r\n if (rates.total >= h.minSamples) {\r\n if (rates.hardFailRate >= 0.3) {\r\n this.closeHealth(baseKey, \"hardFailRate >= 30%\");\r\n return;\r\n }\r\n if (rates.failRate >= 0.5) {\r\n this.closeHealth(baseKey, \"failRate >= 50%\");\r\n return;\r\n }\r\n }\r\n }\r\n\r\n private async execute(req: ResilientRequest, opts: { allowProbe: boolean }): Promise<ResilientResponse> {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const limiter = this.getLimiter(baseKey);\r\n\r\n if (this.healthEnabled) {\r\n if (h.state === \"CLOSED\") {\r\n if (Date.now() >= h.cooldownUntil) {\r\n this.halfOpenHealth(baseKey);\r\n } else {\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n if (h.state === \"HALF_OPEN\") {\r\n if (!opts.allowProbe) throw new HalfOpenRejectedError(baseKey);\r\n if (h.probeRemaining <= 0 \|\| h.probeInFlight) throw new HalfOpenRejectedError(baseKey);\r\n h.probeInFlight = true;\r\n h.probeRemaining -= 1;\r\n }\r\n }\r\n\r\n const requestId = genRequestId();\r\n const start = Date.now();\r\n let acquired = false;\r\n try {\r\n // Probes should not wait in queue.\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n await limiter.acquireNoQueue();\r\n } else {\r\n await limiter.acquire();\r\n acquired = true;\r\n }\r\n } catch (err) {\r\n this.emit(\"request:rejected\", { requestId, request: req, error: err });\r\n throw err;\r\n }\r\n\r\n this.emit(\"request:start\", { requestId, request: req });\r\n\r\n try {\r\n const res = await doHttpRequest(req, this.requestTimeoutMs);\r\n const durationMs = Date.now() - start;\r\n\r\n const outcome = classifyHttpStatus(res.status);\r\n this.recordOutcome(baseKey, outcome);\r\n\r\n // Probe decision\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome, status: res.status });\r\n if (res.status >= 200 && res.status < 300) {\r\n this.openHealth(baseKey);\r\n } else {\r\n this.closeHealth(baseKey, `probe failed status=${res.status}`);\r\n }\r\n }\r\n\r\n this.emit(\"request:success\", { requestId, request: req, status: res.status, durationMs });\r\n return res;\r\n } catch (err) {\r\n const durationMs = Date.now() - start;\r\n\r\n if (shouldCountAsHardFail(err)) {\r\n this.recordOutcome(baseKey, \"HARD_FAIL\");\r\n }\r\n\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n this.emit(\"health:probe\", { baseUrl: baseKey, outcome: \"HARD_FAIL\", error: err });\r\n this.closeHealth(baseKey, \"probe hard failure\");\r\n }\r\n\r\n this.emit(\"request:failure\", { requestId, request: req, error: err, durationMs });\r\n throw err;\r\n } finally {\r\n // Clear probe flag (if any)\r\n if (this.healthEnabled && h.state === \"HALF_OPEN\") {\r\n h.probeInFlight = false;\r\n }\r\n if (acquired) limiter.release();\r\n }\r\n }\r\n\r\n /* ---------------- microcache ---------------- /\r\n\r\n private cloneResponse(res: ResilientResponse): ResilientResponse {\r\n return { status: res.status, headers: { ...res.headers }, body: new Uint8Array(res.body) };\r\n }\r\n\r\n private maybeCleanupExpired(cache: Map<string, CacheEntry>, maxStaleMs: number): void {\r\n this.microCacheReqCount++;\r\n if (this.microCacheReqCount % this.cleanupEveryNRequests !== 0) return;\r\n\r\n const now = Date.now();\r\n for (const [k, v] of cache.entries()) {\r\n if (now - v.createdAt > maxStaleMs) cache.delete(k);\r\n }\r\n }\r\n\r\n private evictIfNeeded(cache: Map<string, CacheEntry>, maxEntries: number): void {\r\n while (cache.size >= maxEntries) {\r\n const oldestKey = cache.keys().next().value as string \| undefined;\r\n if (!oldestKey) break;\r\n cache.delete(oldestKey);\r\n }\r\n }\r\n\r\n private isRetryableStatus(status: number, retryOnStatus: number[]): boolean {\r\n return retryOnStatus.includes(status);\r\n }\r\n\r\n private computeBackoffMs(attemptIndex: number, baseDelayMs: number, maxDelayMs: number): number {\r\n const exp = baseDelayMs Math.pow(2, attemptIndex - 1);\r\n const capped = clamp(exp, baseDelayMs, maxDelayMs);\r\n const jitter = 0.5 + Math.random();\r\n return Math.round(capped * jitter);\r\n }\r\n\r\n private async fetchWithLeaderRetry(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const retry = mc.retry;\r\n if (!retry) return this.execute(req, { allowProbe: false });\r\n\r\n const { maxAttempts, baseDelayMs, maxDelayMs, retryOnStatus } = retry;\r\n\r\n let last: ResilientResponse \| undefined;\r\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\r\n const res = await this.execute(req, { allowProbe: false });\r\n last = res;\r\n\r\n if (this.isRetryableStatus(res.status, retryOnStatus) && attempt < maxAttempts) {\r\n const delay = this.computeBackoffMs(attempt, baseDelayMs, maxDelayMs);\r\n this.emit(\"microcache:retry\", { url: req.url, attempt, maxAttempts, reason: `status ${res.status}`, delayMs: delay });\r\n await sleep(delay);\r\n continue;\r\n }\r\n return res;\r\n }\r\n return last!;\r\n }\r\n\r\n private async requestWithMicroCache(req: ResilientRequest): Promise<ResilientResponse> {\r\n const mc = this.microCache!;\r\n const cache = this.cache!;\r\n const inFlight = this.inFlight!;\r\n\r\n this.maybeCleanupExpired(cache, mc.maxStaleMs);\r\n\r\n const key = mc.keyFn(req);\r\n const now = Date.now();\r\n\r\n const hit0 = cache.get(key);\r\n if (hit0 && now - hit0.createdAt > mc.maxStaleMs) cache.delete(key);\r\n\r\n const hit = cache.get(key);\r\n if (hit && now < hit.expiresAt) return this.cloneResponse(hit.value);\r\n\r\n // If CLOSED: serve stale if allowed else fail fast\r\n if (this.healthEnabled) {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n if (h.state === \"CLOSED\") {\r\n const staleAllowed = !!hit && now - hit.createdAt <= mc.maxStaleMs;\r\n if (staleAllowed) return this.cloneResponse(hit!.value);\r\n throw new UpstreamUnhealthyError(baseKey, \"CLOSED\");\r\n }\r\n }\r\n\r\n const group = inFlight.get(key);\r\n if (group) {\r\n const h = cache.get(key);\r\n const staleAllowed = !!h && now - h.createdAt <= mc.maxStaleMs;\r\n\r\n if (h && staleAllowed) return this.cloneResponse(h.value);\r\n\r\n const age = now - group.windowStartMs;\r\n if (age > mc.followerTimeoutMs) {\r\n const err = new Error(`Follower window closed for key=${key}`);\r\n (err as any).name = \"FollowerWindowClosedError\";\r\n throw err;\r\n }\r\n\r\n if (group.waiters >= mc.maxWaiters) {\r\n const err = new Error(`Too many followers for key=${key}`);\r\n (err as any).name = \"TooManyWaitersError\";\r\n throw err;\r\n }\r\n\r\n group.waiters += 1;\r\n try {\r\n const res = await group.promise;\r\n return this.cloneResponse(res);\r\n } finally {\r\n group.waiters -= 1;\r\n }\r\n }\r\n\r\n const prev = cache.get(key);\r\n const prevStaleAllowed = !!prev && now - prev.createdAt <= mc.maxStaleMs;\r\n\r\n const promise = (async () => {\r\n const baseKey = baseUrlKey(req.url);\r\n const h = this.getHealth(baseKey);\r\n const allowProbe = this.healthEnabled && h.state === \"HALF_OPEN\";\r\n\r\n const res = allowProbe\r\n ? await this.execute(req, { allowProbe: true })\r\n : await this.fetchWithLeaderRetry(req);\r\n\r\n if (res.status >= 200 && res.status < 300) {\r\n this.evictIfNeeded(cache, mc.maxEntries);\r\n const t = Date.now();\r\n cache.set(key, { value: this.cloneResponse(res), createdAt: t, expiresAt: t + mc.ttlMs });\r\n }\r\n return res;\r\n })();\r\n\r\n inFlight.set(key, { promise, windowStartMs: Date.now(), waiters: 0 });\r\n\r\n try {\r\n const res = await promise;\r\n\r\n if (!(res.status >= 200 && res.status < 300) && prev && prevStaleAllowed) {\r\n return this.cloneResponse(prev.value);\r\n }\r\n\r\n return this.cloneResponse(res);\r\n } catch (err) {\r\n if (prev && prevStaleAllowed) {\r\n this.emit(\"microcache:refresh_failed\", { key, url: req.url, error: err });\r\n return this.cloneResponse(prev.value);\r\n }\r\n throw err;\r\n } finally {\r\n inFlight.delete(key);\r\n }\r\n }\r\n}\r\n","export abstract class ResilientHttpError extends Error {\r\n public readonly name: string;\r\n constructor(message: string) {\r\n super(message);\r\n this.name = this.constructor.name;\r\n }\r\n}\r\n\r\nexport class QueueFullError extends ResilientHttpError {\r\n constructor(public readonly maxQueue: number) {\r\n super(`Queue is full (maxQueue=${maxQueue}).`);\r\n }\r\n}\r\n\r\nexport class QueueTimeoutError extends ResilientHttpError {\r\n constructor(public readonly enqueueTimeoutMs: number) {\r\n super(`Queue wait exceeded (enqueueTimeoutMs=${enqueueTimeoutMs}).`);\r\n }\r\n}\r\n\r\nexport class RequestTimeoutError extends ResilientHttpError {\r\n constructor(public readonly requestTimeoutMs: number) {\r\n super(`Request timed out (requestTimeoutMs=${requestTimeoutMs}).`);\r\n }\r\n}\r\n\r\n\r\n\r\nexport class UpstreamError extends ResilientHttpError {\r\n constructor(public readonly status: number) {\r\n super(`Upstream returned error status=${status}.`);\r\n }\r\n}\r\n\r\n\r\n\r\n\r\nexport class UpstreamUnhealthyError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string, public readonly state: string) {\r\n super(`Upstream is unhealthy (state=${state}, baseUrl=${baseUrl}).`);\r\n }\r\n}\r\n\r\nexport class HalfOpenRejectedError extends ResilientHttpError {\r\n constructor(public readonly baseUrl: string) {\r\n super(`Upstream is HALF_OPEN (probe only) for baseUrl=${baseUrl}.`);\r\n }\r\n}\r\n","// src/limiter.ts\r\nimport { QueueFullError } from \"./errors.js\";\r\n\r\ntype ResolveFn = () => void;\r\ntype RejectFn = (err: unknown) => void;\r\n\r\ninterface Waiter {\r\n resolve: ResolveFn;\r\n reject: RejectFn;\r\n}\r\n\r\n/*\r\n Process-local concurrency limiter with bounded FIFO queue.\r\n \r\n - maxInFlight: concurrent permits\r\n * - maxQueue: bounded burst buffer\r\n * - No enqueue-timeout by design.\r\n \r\n Also supports:\r\n * - flush(err): reject all queued waiters immediately\r\n * - acquireNoQueue(): for probes (must start now or fail)\r\n /\r\nexport class ConcurrencyLimiter {\r\n private readonly maxInFlight: number;\r\n private readonly maxQueue: number;\r\n\r\n private inFlight = 0;\r\n private queue: Waiter[] = [];\r\n\r\n constructor(opts: { maxInFlight: number; maxQueue: number }) {\r\n if (!Number.isFinite(opts.maxInFlight) \|\| opts.maxInFlight <= 0) {\r\n throw new Error(`maxInFlight must be > 0 (got ${opts.maxInFlight})`);\r\n }\r\n if (!Number.isFinite(opts.maxQueue) \|\| opts.maxQueue < 0) {\r\n throw new Error(`maxQueue must be >= 0 (got ${opts.maxQueue})`);\r\n }\r\n\r\n this.maxInFlight = opts.maxInFlight;\r\n this.maxQueue = opts.maxQueue;\r\n }\r\n\r\n acquire(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n\r\n if (this.maxQueue === 0 \|\| this.queue.length >= this.maxQueue) {\r\n return Promise.reject(new QueueFullError(this.maxQueue));\r\n }\r\n\r\n return new Promise<void>((resolve, reject) => {\r\n this.queue.push({ resolve, reject });\r\n });\r\n }\r\n\r\n /\r\n Acquire without queueing: either start now or fail.\r\n * Used for HALF_OPEN probes so recovery never waits behind backlog.\r\n /\r\n acquireNoQueue(): Promise<void> {\r\n if (this.inFlight < this.maxInFlight) {\r\n this.inFlight += 1;\r\n return Promise.resolve();\r\n }\r\n // treat as queue full (we don't want a new error type)\r\n return Promise.reject(new QueueFullError(0));\r\n }\r\n\r\n release(): void {\r\n if (this.inFlight <= 0) {\r\n throw new Error(\"release() called when inFlight is already 0\");\r\n }\r\n\r\n const next = this.queue.shift();\r\n if (next) {\r\n next.resolve(); // transfer permit\r\n return;\r\n }\r\n\r\n this.inFlight -= 1;\r\n }\r\n\r\n flush(err: unknown): void {\r\n const q = this.queue;\r\n this.queue = [];\r\n for (const w of q) w.reject(err);\r\n }\r\n\r\n snapshot(): { inFlight: number; queueDepth: number; maxInFlight: number; maxQueue: number } {\r\n return {\r\n inFlight: this.inFlight,\r\n queueDepth: this.queue.length,\r\n maxInFlight: this.maxInFlight,\r\n maxQueue: this.maxQueue,\r\n };\r\n }\r\n}\r\n","// src/http.ts\r\nimport { request as undiciRequest } from \"undici\";\r\nimport { RequestTimeoutError } from \"./errors.js\";\r\nimport type { ResilientRequest, ResilientResponse } from \"./types.js\";\r\n\r\nfunction normalizeHeaders(headers: any): Record<string, string> {\r\n const out: Record<string, string> = {};\r\n if (!headers) return out;\r\n\r\n // undici headers are an object-like structure (headers: Record<string, string \| string[]>)\r\n for (const [k, v] of Object.entries(headers)) {\r\n if (Array.isArray(v)) out[k.toLowerCase()] = v.join(\", \");\r\n else if (typeof v === \"string\") out[k.toLowerCase()] = v;\r\n else out[k.toLowerCase()] = String(v);\r\n }\r\n return out;\r\n}\r\n\r\n/\r\n Execute a single HTTP request with a hard timeout using AbortController.\r\n * No retries. No breaker. Just raw outbound I/O with a timeout.\r\n */\r\nexport async function doHttpRequest(\r\n req: ResilientRequest,\r\n requestTimeoutMs: number\r\n): Promise<ResilientResponse> {\r\n const ac = new AbortController();\r\n const timer = setTimeout(() => ac.abort(), requestTimeoutMs);\r\n\r\n try {\r\n const res = await undiciRequest(req.url, {\r\n method: req.method,\r\n headers: req.headers,\r\n body: req.body as any,\r\n signal: ac.signal,\r\n });\r\n\r\n const body = await res.body.arrayBuffer();\r\n return {\r\n status: res.statusCode,\r\n headers: normalizeHeaders(res.headers),\r\n body: new Uint8Array(body),\r\n };\r\n } catch (err: any) {\r\n // undici throws AbortError on abort\r\n if (err?.name === \"AbortError\") {\r\n throw new RequestTimeoutError(requestTimeoutMs);\r\n }\r\n throw err;\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@nextn/outbound-guard",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",