@xemahq/managed-fetch 0.1.0

package/LICENSE

@@ -0,0 +1,176 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,73 @@
+# @xemahq/managed-fetch
+
+This package belongs to **Layer 1** — a framework-agnostic HTTP SDK with **zero
+runtime dependencies**. It is the managed outbound-fetch / polite-crawl client
+that any ingestion, monitor, or scraper calls instead of bare `fetch`. It is
+fully generic: it knows nothing about any Xema domain concept.
+
+## What it is
+
+`ManagedFetch` wraps the platform `fetch` with the machinery a well-behaved
+outbound caller needs:
+
+- **Per-host rate limiting** — a reservation token bucket per hostname
+  (`requestsPerSecond` + `burst`), with a global default and per-host overrides.
+- **Retry with backoff** — exponential backoff + full jitter on retryable
+  statuses (`429`/`502`/`503`/`504`) and network/timeout errors, honoring
+  `Retry-After` (capped), bounded by `maxRetries`. No infinite loops.
+- **Per-host circuit breaker** — opens after N consecutive call failures, stays
+  open for a cooldown, then half-open probes before closing. States are the
+  closed enum `CircuitState = CLOSED | OPEN | HALF_OPEN`. Fails fast when OPEN.
+- **Conditional requests** — pass prior `{ etag, lastModified }` and the client
+  sends `If-None-Match` / `If-Modified-Since`; a `304 Not Modified` is a
+  first-class success (`result.notModified === true`) for cheap change
+  detection.
+- **User-Agent policy** — a configurable, honest, identifiable UA (client-wide
+  or per-request). No anti-bot evasion beyond setting the header.
+- **Per-request timeouts** — via `AbortController`, with a sane default.
+- **Health probe** — `probe(url)` → `{ healthy, status?, latencyMs }`.
+
+## Usage
+
+```ts
+import { ManagedFetch } from '@xemahq/managed-fetch';
+
+const client = new ManagedFetch({
+  userAgent: 'AcmeCrawler/2.0 (+https://acme.example)',
+  rateLimit: { requestsPerSecond: 1, burst: 3 },
+  perHostRateLimit: { 'api.example.com': { requestsPerSecond: 5, burst: 10 } },
+  retry: { maxRetries: 4, baseDelayMs: 250, maxDelayMs: 15_000 },
+  circuitBreaker: { failureThreshold: 5, cooldownMs: 30_000 },
+});
+
+const res = await client.fetch('https://example.com/feed.json', {
+  conditional: { etag: previousEtag },
+});
+
+if (res.notModified) {
+  // nothing changed — reuse the cached copy
+} else {
+  const body = await res.json();
+  saveEtag(res.etag);
+}
+```
+
+Terminal conditions throw typed errors — never a silent degraded result:
+`CircuitOpenError`, `RateLimitError`, `RequestTimeoutError`,
+`RetriesExhaustedError` (all extend `ManagedFetchError`, each carrying a closed
+`ManagedFetchErrorCode`).
+
+## Invariants
+
+- **State is per-instance / in-memory.** The token bucket and circuit breaker
+  coordinate a single process only. Across horizontally-scaled pods each pod
+  keeps its own state — the effective global rate is `pods × requestsPerSecond`
+  and each pod trips its own breaker. This is intentional; a shared cross-pod
+  budget must be enforced at a shared upstream, not here.
+- **Fail-fast, no silent fallbacks.** Every terminal failure throws a typed
+  error. A malformed URL, an unset transport, or an exceeded rate cap all fail
+  immediately.
+- **Deterministic timing.** Backoff, rate-limit waits, and circuit timing run
+  off an injectable clock (`now` / `sleep` / `random`), so behavior is
+  reproducible and testable with no real sleeping. Timers are used only for the
+  network request timeout — never to drive control flow between retries.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { ManagedFetch, createManagedFetch } from './lib/managed-fetch';
+export { CircuitState } from './lib/circuit-breaker';
+export { ManagedFetchError, ManagedFetchErrorCode, CircuitOpenError, RateLimitError, RequestTimeoutError, RetriesExhaustedError, } from './lib/errors';
+export { computeBackoffMs, parseRetryAfterMs, resolveRetryDelayMs, } from './lib/backoff';
+export { DEFAULT_USER_AGENT, DEFAULT_TIMEOUT_MS, DEFAULT_RATE_LIMIT, DEFAULT_RETRYABLE_STATUSES, DEFAULT_RETRY, DEFAULT_CIRCUIT_BREAKER, } from './lib/defaults';
+export type { FetchImpl, ManagedFetchClock, ManagedFetchConfig, ManagedFetchRequest, ManagedFetchResult, ConditionalTokens, ProbeResult, RateLimitConfig, RetryConfig, CircuitBreakerConfig, } from './lib/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,WAAW,EACX,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CIRCUIT_BREAKER = exports.DEFAULT_RETRY = exports.DEFAULT_RETRYABLE_STATUSES = exports.DEFAULT_RATE_LIMIT = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_USER_AGENT = exports.resolveRetryDelayMs = exports.parseRetryAfterMs = exports.computeBackoffMs = exports.RetriesExhaustedError = exports.RequestTimeoutError = exports.RateLimitError = exports.CircuitOpenError = exports.ManagedFetchErrorCode = exports.ManagedFetchError = exports.CircuitState = exports.createManagedFetch = exports.ManagedFetch = void 0;
+var managed_fetch_1 = require("./lib/managed-fetch");
+Object.defineProperty(exports, "ManagedFetch", { enumerable: true, get: function () { return managed_fetch_1.ManagedFetch; } });
+Object.defineProperty(exports, "createManagedFetch", { enumerable: true, get: function () { return managed_fetch_1.createManagedFetch; } });
+var circuit_breaker_1 = require("./lib/circuit-breaker");
+Object.defineProperty(exports, "CircuitState", { enumerable: true, get: function () { return circuit_breaker_1.CircuitState; } });
+var errors_1 = require("./lib/errors");
+Object.defineProperty(exports, "ManagedFetchError", { enumerable: true, get: function () { return errors_1.ManagedFetchError; } });
+Object.defineProperty(exports, "ManagedFetchErrorCode", { enumerable: true, get: function () { return errors_1.ManagedFetchErrorCode; } });
+Object.defineProperty(exports, "CircuitOpenError", { enumerable: true, get: function () { return errors_1.CircuitOpenError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "RequestTimeoutError", { enumerable: true, get: function () { return errors_1.RequestTimeoutError; } });
+Object.defineProperty(exports, "RetriesExhaustedError", { enumerable: true, get: function () { return errors_1.RetriesExhaustedError; } });
+var backoff_1 = require("./lib/backoff");
+Object.defineProperty(exports, "computeBackoffMs", { enumerable: true, get: function () { return backoff_1.computeBackoffMs; } });
+Object.defineProperty(exports, "parseRetryAfterMs", { enumerable: true, get: function () { return backoff_1.parseRetryAfterMs; } });
+Object.defineProperty(exports, "resolveRetryDelayMs", { enumerable: true, get: function () { return backoff_1.resolveRetryDelayMs; } });
+var defaults_1 = require("./lib/defaults");
+Object.defineProperty(exports, "DEFAULT_USER_AGENT", { enumerable: true, get: function () { return defaults_1.DEFAULT_USER_AGENT; } });
+Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: function () { return defaults_1.DEFAULT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "DEFAULT_RATE_LIMIT", { enumerable: true, get: function () { return defaults_1.DEFAULT_RATE_LIMIT; } });
+Object.defineProperty(exports, "DEFAULT_RETRYABLE_STATUSES", { enumerable: true, get: function () { return defaults_1.DEFAULT_RETRYABLE_STATUSES; } });
+Object.defineProperty(exports, "DEFAULT_RETRY", { enumerable: true, get: function () { return defaults_1.DEFAULT_RETRY; } });
+Object.defineProperty(exports, "DEFAULT_CIRCUIT_BREAKER", { enumerable: true, get: function () { return defaults_1.DEFAULT_CIRCUIT_BREAKER; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAUA,qDAAuE;AAA9D,6GAAA,YAAY,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAEzC,yDAAqD;AAA5C,+GAAA,YAAY,OAAA;AAErB,uCAOsB;AANpB,2GAAA,iBAAiB,OAAA;AACjB,+GAAA,qBAAqB,OAAA;AACrB,0GAAA,gBAAgB,OAAA;AAChB,wGAAA,cAAc,OAAA;AACd,6GAAA,mBAAmB,OAAA;AACnB,+GAAA,qBAAqB,OAAA;AAGvB,yCAIuB;AAHrB,2GAAA,gBAAgB,OAAA;AAChB,4GAAA,iBAAiB,OAAA;AACjB,8GAAA,mBAAmB,OAAA;AAGrB,2CAOwB;AANtB,8GAAA,kBAAkB,OAAA;AAClB,8GAAA,kBAAkB,OAAA;AAClB,8GAAA,kBAAkB,OAAA;AAClB,sHAAA,0BAA0B,OAAA;AAC1B,yGAAA,aAAa,OAAA;AACb,mHAAA,uBAAuB,OAAA"}

package/dist/lib/backoff.d.ts

@@ -0,0 +1,12 @@
+export declare function parseRetryAfterMs(headerValue: string | null | undefined, nowEpochMs: number): number | undefined;
+export declare function computeBackoffMs(attempt: number, baseDelayMs: number, maxDelayMs: number, random: () => number): number;
+export declare function resolveRetryDelayMs(params: {
+    attempt: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    random: () => number;
+    respectRetryAfter: boolean;
+    retryAfterHeader: string | null | undefined;
+    nowEpochMs: number;
+}): number;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/lib/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../src/lib/backoff.ts"],"names":[],"mappings":"AAgBA,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAiBpB;AASD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,MAAM,GACnB,MAAM,CAIR;AAOD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAQT"}

package/dist/lib/backoff.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRetryAfterMs = parseRetryAfterMs;
+exports.computeBackoffMs = computeBackoffMs;
+exports.resolveRetryDelayMs = resolveRetryDelayMs;
+function parseRetryAfterMs(headerValue, nowEpochMs) {
+    if (headerValue === null || headerValue === undefined) {
+        return undefined;
+    }
+    const trimmed = headerValue.trim();
+    if (trimmed === '') {
+        return undefined;
+    }
+    if (/^\d+$/.test(trimmed)) {
+        return Number(trimmed) * 1000;
+    }
+    const dateMs = Date.parse(trimmed);
+    if (!Number.isNaN(dateMs)) {
+        const delta = dateMs - nowEpochMs;
+        return delta > 0 ? delta : 0;
+    }
+    return undefined;
+}
+function computeBackoffMs(attempt, baseDelayMs, maxDelayMs, random) {
+    const exponential = baseDelayMs * 2 ** attempt;
+    const ceiling = Math.min(maxDelayMs, exponential);
+    return Math.floor(random() * ceiling);
+}
+function resolveRetryDelayMs(params) {
+    if (params.respectRetryAfter) {
+        const retryAfter = parseRetryAfterMs(params.retryAfterHeader, params.nowEpochMs);
+        if (retryAfter !== undefined) {
+            return Math.min(params.maxDelayMs, retryAfter);
+        }
+    }
+    return computeBackoffMs(params.attempt, params.baseDelayMs, params.maxDelayMs, params.random);
+}
+//# sourceMappingURL=backoff.js.map

package/dist/lib/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../src/lib/backoff.ts"],"names":[],"mappings":";;AAgBA,8CAoBC;AASD,4CASC;AAOD,kDAgBC;AA7DD,SAAgB,iBAAiB,CAC/B,WAAsC,EACtC,UAAkB;IAElB,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAChC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;QAClC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AASD,SAAgB,gBAAgB,CAC9B,OAAe,EACf,WAAmB,EACnB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,WAAW,GAAG,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;AACxC,CAAC;AAOD,SAAgB,mBAAmB,CAAC,MAQnC;IACC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACjF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAChG,CAAC"}

package/dist/lib/circuit-breaker.d.ts

@@ -0,0 +1,29 @@
+export declare enum CircuitState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export interface CircuitBreakerOptions {
+    failureThreshold: number;
+    cooldownMs: number;
+    halfOpenMaxProbes: number;
+    now: () => number;
+}
+export interface CircuitAcquire {
+    allowed: boolean;
+    cooldownRemainingMs: number;
+}
+export declare class CircuitBreaker {
+    private readonly opts;
+    private state;
+    private consecutiveFailures;
+    private openedAt;
+    private halfOpenProbes;
+    constructor(opts: CircuitBreakerOptions);
+    tryAcquire(): CircuitAcquire;
+    recordSuccess(): void;
+    recordFailure(): void;
+    get current(): CircuitState;
+    private open;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/lib/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/lib/circuit-breaker.ts"],"names":[],"mappings":"AAgBA,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,cAAc;IAE7B,OAAO,EAAE,OAAO,CAAC;IAEjB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,cAAc,CAAK;gBAEE,IAAI,EAAE,qBAAqB;IAcxD,UAAU,IAAI,cAAc;IAyB5B,aAAa,IAAI,IAAI;IAOrB,aAAa,IAAI,IAAI;IAiBrB,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED,OAAO,CAAC,IAAI;CAKb"}

package/dist/lib/circuit-breaker.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.CircuitState = void 0;
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (exports.CircuitState = CircuitState = {}));
+class CircuitBreaker {
+    opts;
+    state = CircuitState.CLOSED;
+    consecutiveFailures = 0;
+    openedAt = 0;
+    halfOpenProbes = 0;
+    constructor(opts) {
+        this.opts = opts;
+        if (opts.failureThreshold <= 0) {
+            throw new RangeError('failureThreshold must be > 0');
+        }
+        if (opts.halfOpenMaxProbes <= 0) {
+            throw new RangeError('halfOpenMaxProbes must be > 0');
+        }
+    }
+    tryAcquire() {
+        const now = this.opts.now();
+        if (this.state === CircuitState.OPEN) {
+            const elapsed = now - this.openedAt;
+            if (elapsed >= this.opts.cooldownMs) {
+                this.state = CircuitState.HALF_OPEN;
+                this.halfOpenProbes = 0;
+            }
+            else {
+                return { allowed: false, cooldownRemainingMs: this.opts.cooldownMs - elapsed };
+            }
+        }
+        if (this.state === CircuitState.HALF_OPEN) {
+            if (this.halfOpenProbes >= this.opts.halfOpenMaxProbes) {
+                return { allowed: false, cooldownRemainingMs: 0 };
+            }
+            this.halfOpenProbes += 1;
+            return { allowed: true, cooldownRemainingMs: 0 };
+        }
+        return { allowed: true, cooldownRemainingMs: 0 };
+    }
+    recordSuccess() {
+        this.consecutiveFailures = 0;
+        this.halfOpenProbes = 0;
+        this.state = CircuitState.CLOSED;
+    }
+    recordFailure() {
+        this.consecutiveFailures += 1;
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.open();
+            return;
+        }
+        if (this.consecutiveFailures >= this.opts.failureThreshold) {
+            this.open();
+        }
+    }
+    get current() {
+        return this.state;
+    }
+    open() {
+        this.state = CircuitState.OPEN;
+        this.openedAt = this.opts.now();
+        this.halfOpenProbes = 0;
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/lib/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/lib/circuit-breaker.ts"],"names":[],"mappings":";;;AAgBA,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,uCAAuB,CAAA;AACzB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAiBD,MAAa,cAAc;IAMI;IALrB,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;IAC5B,mBAAmB,GAAG,CAAC,CAAC;IACxB,QAAQ,GAAG,CAAC,CAAC;IACb,cAAc,GAAG,CAAC,CAAC;IAE3B,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;QACtD,IAAI,IAAI,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,IAAI,CAAC,iBAAiB,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAOD,UAAU;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAE5B,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YACpC,IAAI,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC;gBACpC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC;YACjF,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC;YACpD,CAAC;YACD,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;IAGD,aAAa;QACX,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;IACnC,CAAC;IAGD,aAAa;QACX,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAQD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF;AA9ED,wCA8EC"}

package/dist/lib/clock.d.ts

@@ -0,0 +1,3 @@
+import type { ManagedFetchClock } from './types';
+export declare const defaultClock: ManagedFetchClock;
+//# sourceMappingURL=clock.d.ts.map

package/dist/lib/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/lib/clock.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAyBjD,eAAO,MAAM,YAAY,EAAE,iBAI1B,CAAC"}

package/dist/lib/clock.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultClock = void 0;
+function realSleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        if (ms <= 0) {
+            resolve();
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+exports.defaultClock = {
+    now: () => Date.now(),
+    sleep: realSleep,
+    random: () => Math.random(),
+};
+//# sourceMappingURL=clock.js.map

package/dist/lib/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/lib/clock.ts"],"names":[],"mappings":";;;AAQA,SAAS,SAAS,CAAC,EAAU,EAAE,MAAoB;IACjD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,YAAY,GAAsB;IAC7C,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;CAC5B,CAAC"}

package/dist/lib/defaults.d.ts

@@ -0,0 +1,8 @@
+import type { CircuitBreakerConfig, RateLimitConfig, RetryConfig } from './types';
+export declare const DEFAULT_USER_AGENT = "XemaManagedFetch/1.0 (+https://xema.dev)";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_RATE_LIMIT: Required<RateLimitConfig>;
+export declare const DEFAULT_RETRYABLE_STATUSES: readonly number[];
+export declare const DEFAULT_RETRY: Required<RetryConfig>;
+export declare const DEFAULT_CIRCUIT_BREAKER: Required<CircuitBreakerConfig>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/lib/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/lib/defaults.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAMlF,eAAO,MAAM,kBAAkB,6CAA6C,CAAC;AAE7E,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,eAAe,CAIxD,CAAC;AAGF,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAyB,CAAC;AAElF,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,WAAW,CAM/C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,oBAAoB,CAIlE,CAAC"}

package/dist/lib/defaults.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CIRCUIT_BREAKER = exports.DEFAULT_RETRY = exports.DEFAULT_RETRYABLE_STATUSES = exports.DEFAULT_RATE_LIMIT = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_USER_AGENT = void 0;
+exports.DEFAULT_USER_AGENT = 'XemaManagedFetch/1.0 (+https://xema.dev)';
+exports.DEFAULT_TIMEOUT_MS = 30_000;
+exports.DEFAULT_RATE_LIMIT = {
+    requestsPerSecond: 2,
+    burst: 4,
+    maxQueueMs: 30_000,
+};
+exports.DEFAULT_RETRYABLE_STATUSES = [429, 502, 503, 504];
+exports.DEFAULT_RETRY = {
+    maxRetries: 3,
+    baseDelayMs: 200,
+    maxDelayMs: 10_000,
+    retryableStatuses: exports.DEFAULT_RETRYABLE_STATUSES,
+    respectRetryAfter: true,
+};
+exports.DEFAULT_CIRCUIT_BREAKER = {
+    failureThreshold: 5,
+    cooldownMs: 30_000,
+    halfOpenMaxProbes: 1,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/lib/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/lib/defaults.ts"],"names":[],"mappings":";;;AAUa,QAAA,kBAAkB,GAAG,0CAA0C,CAAC;AAEhE,QAAA,kBAAkB,GAAG,MAAM,CAAC;AAE5B,QAAA,kBAAkB,GAA8B;IAC3D,iBAAiB,EAAE,CAAC;IACpB,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,MAAM;CACnB,CAAC;AAGW,QAAA,0BAA0B,GAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAErE,QAAA,aAAa,GAA0B;IAClD,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,MAAM;IAClB,iBAAiB,EAAE,kCAA0B;IAC7C,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEW,QAAA,uBAAuB,GAAmC;IACrE,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM;IAClB,iBAAiB,EAAE,CAAC;CACrB,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,37 @@
+export declare enum ManagedFetchErrorCode {
+    CIRCUIT_OPEN = "CIRCUIT_OPEN",
+    RATE_LIMITED = "RATE_LIMITED",
+    TIMEOUT = "TIMEOUT",
+    RETRIES_EXHAUSTED = "RETRIES_EXHAUSTED"
+}
+export declare abstract class ManagedFetchError extends Error {
+    abstract readonly code: ManagedFetchErrorCode;
+    readonly host: string;
+    constructor(message: string, host: string, options?: ErrorOptions);
+}
+export declare class CircuitOpenError extends ManagedFetchError {
+    readonly code = ManagedFetchErrorCode.CIRCUIT_OPEN;
+    readonly cooldownRemainingMs: number;
+    constructor(host: string, cooldownRemainingMs: number);
+}
+export declare class RateLimitError extends ManagedFetchError {
+    readonly code = ManagedFetchErrorCode.RATE_LIMITED;
+    readonly requiredWaitMs: number;
+    readonly maxQueueMs: number;
+    constructor(host: string, requiredWaitMs: number, maxQueueMs: number);
+}
+export declare class RequestTimeoutError extends ManagedFetchError {
+    readonly code = ManagedFetchErrorCode.TIMEOUT;
+    readonly timeoutMs: number;
+    constructor(host: string, timeoutMs: number);
+}
+export declare class RetriesExhaustedError extends ManagedFetchError {
+    readonly code = ManagedFetchErrorCode.RETRIES_EXHAUSTED;
+    readonly attempts: number;
+    readonly lastStatus: number | undefined;
+    constructor(host: string, attempts: number, options: {
+        cause?: unknown;
+        lastStatus?: number;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAUA,oBAAY,qBAAqB;IAE/B,YAAY,iBAAiB;IAE7B,YAAY,iBAAiB;IAE7B,OAAO,YAAY;IAEnB,iBAAiB,sBAAsB;CACxC;AAGD,8BAAsB,iBAAkB,SAAQ,KAAK;IACnD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAG9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAMlE;AAGD,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,QAAQ,CAAC,IAAI,sCAAsC;IAGnD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;gBAEzB,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM;CAOtD;AAOD,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,QAAQ,CAAC,IAAI,sCAAsC;IAGnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAGhC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAQrE;AAGD,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,IAAI,iCAAiC;IAG9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI5C;AAGD,qBAAa,qBAAsB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,2CAA2C;IAGxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAWpD"}

package/dist/lib/errors.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetriesExhaustedError = exports.RequestTimeoutError = exports.RateLimitError = exports.CircuitOpenError = exports.ManagedFetchError = exports.ManagedFetchErrorCode = void 0;
+var ManagedFetchErrorCode;
+(function (ManagedFetchErrorCode) {
+    ManagedFetchErrorCode["CIRCUIT_OPEN"] = "CIRCUIT_OPEN";
+    ManagedFetchErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    ManagedFetchErrorCode["TIMEOUT"] = "TIMEOUT";
+    ManagedFetchErrorCode["RETRIES_EXHAUSTED"] = "RETRIES_EXHAUSTED";
+})(ManagedFetchErrorCode || (exports.ManagedFetchErrorCode = ManagedFetchErrorCode = {}));
+class ManagedFetchError extends Error {
+    host;
+    constructor(message, host, options) {
+        super(message, options);
+        this.name = new.target.name;
+        this.host = host;
+    }
+}
+exports.ManagedFetchError = ManagedFetchError;
+class CircuitOpenError extends ManagedFetchError {
+    code = ManagedFetchErrorCode.CIRCUIT_OPEN;
+    cooldownRemainingMs;
+    constructor(host, cooldownRemainingMs) {
+        super(`Circuit breaker is OPEN for host "${host}"; ${cooldownRemainingMs}ms until half-open probe`, host);
+        this.cooldownRemainingMs = cooldownRemainingMs;
+    }
+}
+exports.CircuitOpenError = CircuitOpenError;
+class RateLimitError extends ManagedFetchError {
+    code = ManagedFetchErrorCode.RATE_LIMITED;
+    requiredWaitMs;
+    maxQueueMs;
+    constructor(host, requiredWaitMs, maxQueueMs) {
+        super(`Rate limit for host "${host}" would require waiting ${requiredWaitMs}ms (> maxQueueMs ${maxQueueMs}ms)`, host);
+        this.requiredWaitMs = requiredWaitMs;
+        this.maxQueueMs = maxQueueMs;
+    }
+}
+exports.RateLimitError = RateLimitError;
+class RequestTimeoutError extends ManagedFetchError {
+    code = ManagedFetchErrorCode.TIMEOUT;
+    timeoutMs;
+    constructor(host, timeoutMs) {
+        super(`Request to host "${host}" timed out after ${timeoutMs}ms`, host);
+        this.timeoutMs = timeoutMs;
+    }
+}
+exports.RequestTimeoutError = RequestTimeoutError;
+class RetriesExhaustedError extends ManagedFetchError {
+    code = ManagedFetchErrorCode.RETRIES_EXHAUSTED;
+    attempts;
+    lastStatus;
+    constructor(host, attempts, options) {
+        super(`Exhausted ${attempts} attempt(s) for host "${host}"` +
+            (options.lastStatus !== undefined ? ` (last status ${options.lastStatus})` : ''), host, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.attempts = attempts;
+        this.lastStatus = options.lastStatus;
+    }
+}
+exports.RetriesExhaustedError = RetriesExhaustedError;
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":";;;AAUA,IAAY,qBASX;AATD,WAAY,qBAAqB;IAE/B,sDAA6B,CAAA;IAE7B,sDAA6B,CAAA;IAE7B,4CAAmB,CAAA;IAEnB,gEAAuC,CAAA;AACzC,CAAC,EATW,qBAAqB,qCAArB,qBAAqB,QAShC;AAGD,MAAsB,iBAAkB,SAAQ,KAAK;IAI1C,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAY,EAAE,OAAsB;QAC/D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAExB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAZD,8CAYC;AAGD,MAAa,gBAAiB,SAAQ,iBAAiB;IAC5C,IAAI,GAAG,qBAAqB,CAAC,YAAY,CAAC;IAG1C,mBAAmB,CAAS;IAErC,YAAY,IAAY,EAAE,mBAA2B;QACnD,KAAK,CACH,qCAAqC,IAAI,MAAM,mBAAmB,0BAA0B,EAC5F,IAAI,CACL,CAAC;QACF,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IACjD,CAAC;CACF;AAbD,4CAaC;AAOD,MAAa,cAAe,SAAQ,iBAAiB;IAC1C,IAAI,GAAG,qBAAqB,CAAC,YAAY,CAAC;IAG1C,cAAc,CAAS;IAGvB,UAAU,CAAS;IAE5B,YAAY,IAAY,EAAE,cAAsB,EAAE,UAAkB;QAClE,KAAK,CACH,wBAAwB,IAAI,2BAA2B,cAAc,oBAAoB,UAAU,KAAK,EACxG,IAAI,CACL,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAjBD,wCAiBC;AAGD,MAAa,mBAAoB,SAAQ,iBAAiB;IAC/C,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC;IAGrC,SAAS,CAAS;IAE3B,YAAY,IAAY,EAAE,SAAiB;QACzC,KAAK,CAAC,oBAAoB,IAAI,qBAAqB,SAAS,IAAI,EAAE,IAAI,CAAC,CAAC;QACxE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAVD,kDAUC;AAGD,MAAa,qBAAsB,SAAQ,iBAAiB;IACjD,IAAI,GAAG,qBAAqB,CAAC,iBAAiB,CAAC;IAG/C,QAAQ,CAAS;IAGjB,UAAU,CAAqB;IAExC,YACE,IAAY,EACZ,QAAgB,EAChB,OAAiD;QAEjD,KAAK,CACH,aAAa,QAAQ,yBAAyB,IAAI,GAAG;YACnD,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAClF,IAAI,EACJ,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CACnE,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;CACF;AAvBD,sDAuBC"}

package/dist/lib/managed-fetch.d.ts

@@ -0,0 +1,28 @@
+import { CircuitState } from './circuit-breaker';
+import type { ManagedFetchConfig, ManagedFetchRequest, ManagedFetchResult, ProbeResult } from './types';
+export declare class ManagedFetch {
+    private readonly userAgent;
+    private readonly rateLimit;
+    private readonly perHostRateLimit;
+    private readonly retry;
+    private readonly circuitBreaker;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    private readonly clock;
+    private readonly hosts;
+    constructor(config?: ManagedFetchConfig);
+    fetch(url: string, request?: ManagedFetchRequest): Promise<ManagedFetchResult>;
+    probe(url: string, request?: ManagedFetchRequest): Promise<ProbeResult>;
+    getCircuitState(host: string): CircuitState;
+    private applyRateLimit;
+    private executeWithRetries;
+    private backoff;
+    private executeOnce;
+    private buildHeaders;
+    private buildResult;
+    private isRetryableStatus;
+    private hostOf;
+    private hostState;
+}
+export declare function createManagedFetch(config?: ManagedFetchConfig): ManagedFetch;
+//# sourceMappingURL=managed-fetch.d.ts.map

package/dist/lib/managed-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-fetch.d.ts","sourceRoot":"","sources":["../../src/lib/managed-fetch.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAkB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBjE,OAAO,KAAK,EAIV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EAGZ,MAAM,SAAS,CAAC;AASjB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4C;IAC7E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAE1C,MAAM,GAAE,kBAAuB;IA6BrC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwBlF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAejF,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;YAM7B,cAAc;YAiBd,kBAAkB;YAwDlB,OAAO;YAmBP,WAAW;IAiDzB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,SAAS;CAkBlB;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,YAAY,CAEhF"}

package/dist/lib/managed-fetch.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManagedFetch = void 0;
+exports.createManagedFetch = createManagedFetch;
+const backoff_1 = require("./backoff");
+const circuit_breaker_1 = require("./circuit-breaker");
+const clock_1 = require("./clock");
+const defaults_1 = require("./defaults");
+const errors_1 = require("./errors");
+const token_bucket_1 = require("./token-bucket");
+class ManagedFetch {
+    userAgent;
+    rateLimit;
+    perHostRateLimit;
+    retry;
+    circuitBreaker;
+    timeoutMs;
+    fetchImpl;
+    clock;
+    hosts = new Map();
+    constructor(config = {}) {
+        this.userAgent = config.userAgent ?? defaults_1.DEFAULT_USER_AGENT;
+        this.rateLimit = config.rateLimit ?? defaults_1.DEFAULT_RATE_LIMIT;
+        this.perHostRateLimit = config.perHostRateLimit ?? {};
+        this.retry = { ...defaults_1.DEFAULT_RETRY, ...config.retry };
+        this.circuitBreaker = { ...defaults_1.DEFAULT_CIRCUIT_BREAKER, ...config.circuitBreaker };
+        this.timeoutMs = config.timeoutMs ?? defaults_1.DEFAULT_TIMEOUT_MS;
+        const globalFetch = (config.fetchImpl ?? globalThis.fetch);
+        if (globalFetch === undefined) {
+            throw new TypeError('ManagedFetch: no global `fetch` available; pass `config.fetchImpl` explicitly');
+        }
+        this.fetchImpl = globalFetch;
+        this.clock = {
+            now: config.clock?.now ?? clock_1.defaultClock.now,
+            sleep: config.clock?.sleep ?? clock_1.defaultClock.sleep,
+            random: config.clock?.random ?? clock_1.defaultClock.random,
+        };
+    }
+    async fetch(url, request = {}) {
+        const host = this.hostOf(url);
+        const state = this.hostState(host);
+        const gate = state.circuit.tryAcquire();
+        if (!gate.allowed) {
+            throw new errors_1.CircuitOpenError(host, gate.cooldownRemainingMs);
+        }
+        await this.applyRateLimit(host, state, request.signal);
+        return this.executeWithRetries(url, host, state, request);
+    }
+    async probe(url, request = {}) {
+        const host = this.hostOf(url);
+        const start = this.clock.now();
+        try {
+            const res = await this.executeOnce(url, host, {
+                ...request,
+                method: request.method ?? 'HEAD',
+            });
+            return { healthy: res.ok, status: res.status, latencyMs: this.clock.now() - start };
+        }
+        catch {
+            return { healthy: false, latencyMs: this.clock.now() - start };
+        }
+    }
+    getCircuitState(host) {
+        return this.hosts.get(host)?.circuit.current ?? circuit_breaker_1.CircuitState.CLOSED;
+    }
+    async applyRateLimit(host, state, signal) {
+        const waitMs = state.bucket.reserve();
+        if (waitMs <= 0) {
+            return;
+        }
+        if (waitMs > state.maxQueueMs) {
+            state.bucket.refund();
+            throw new errors_1.RateLimitError(host, waitMs, state.maxQueueMs);
+        }
+        await this.clock.sleep(waitMs, signal);
+    }
+    async executeWithRetries(url, host, state, request) {
+        const totalAttempts = this.retry.maxRetries + 1;
+        let lastError;
+        for (let attempt = 0; attempt < totalAttempts; attempt += 1) {
+            const isLastAttempt = attempt === totalAttempts - 1;
+            let response;
+            try {
+                response = await this.executeOnce(url, host, request);
+            }
+            catch (err) {
+                if (request.signal?.aborted) {
+                    throw err;
+                }
+                lastError = err;
+                if (isLastAttempt) {
+                    state.circuit.recordFailure();
+                    if (err instanceof errors_1.RequestTimeoutError && this.retry.maxRetries === 0) {
+                        throw err;
+                    }
+                    throw new errors_1.RetriesExhaustedError(host, totalAttempts, { cause: err });
+                }
+                await this.backoff(attempt, null, request.signal);
+                continue;
+            }
+            if (this.isRetryableStatus(response.status)) {
+                if (isLastAttempt) {
+                    state.circuit.recordFailure();
+                    throw new errors_1.RetriesExhaustedError(host, totalAttempts, { lastStatus: response.status });
+                }
+                await this.backoff(attempt, response.headers.get('retry-after'), request.signal);
+                continue;
+            }
+            state.circuit.recordSuccess();
+            return this.buildResult(url, response);
+        }
+        throw new errors_1.RetriesExhaustedError(host, totalAttempts, { cause: lastError });
+    }
+    async backoff(attempt, retryAfterHeader, signal) {
+        const delayMs = (0, backoff_1.resolveRetryDelayMs)({
+            attempt,
+            baseDelayMs: this.retry.baseDelayMs,
+            maxDelayMs: this.retry.maxDelayMs,
+            random: this.clock.random,
+            respectRetryAfter: this.retry.respectRetryAfter,
+            retryAfterHeader,
+            nowEpochMs: this.clock.now(),
+        });
+        if (delayMs > 0) {
+            await this.clock.sleep(delayMs, signal);
+        }
+    }
+    async executeOnce(url, host, request) {
+        const timeoutMs = request.timeoutMs ?? this.timeoutMs;
+        const controller = new AbortController();
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, timeoutMs);
+        const external = request.signal;
+        const onExternalAbort = () => controller.abort();
+        if (external) {
+            if (external.aborted) {
+                controller.abort();
+            }
+            else {
+                external.addEventListener('abort', onExternalAbort, { once: true });
+            }
+        }
+        const init = {
+            method: request.method ?? 'GET',
+            headers: this.buildHeaders(request),
+            signal: controller.signal,
+        };
+        if (request.body !== undefined) {
+            init.body = request.body;
+        }
+        try {
+            return await this.fetchImpl(url, init);
+        }
+        catch (err) {
+            if (timedOut) {
+                throw new errors_1.RequestTimeoutError(host, timeoutMs);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+            external?.removeEventListener('abort', onExternalAbort);
+        }
+    }
+    buildHeaders(request) {
+        const headers = {
+            'user-agent': request.userAgent ?? this.userAgent,
+        };
+        if (request.conditional?.etag !== undefined) {
+            headers['if-none-match'] = request.conditional.etag;
+        }
+        if (request.conditional?.lastModified !== undefined) {
+            headers['if-modified-since'] = request.conditional.lastModified;
+        }
+        if (request.headers) {
+            for (const [key, value] of Object.entries(request.headers)) {
+                headers[key] = value;
+            }
+        }
+        return headers;
+    }
+    buildResult(url, response) {
+        const notModified = response.status === 304;
+        const etag = response.headers.get('etag') ?? undefined;
+        const lastModified = response.headers.get('last-modified') ?? undefined;
+        return {
+            url,
+            status: response.status,
+            ok: response.ok,
+            notModified,
+            fromCache: notModified,
+            headers: response.headers,
+            raw: response,
+            ...(etag !== undefined ? { etag } : {}),
+            ...(lastModified !== undefined ? { lastModified } : {}),
+            text: () => response.text(),
+            json: () => response.json(),
+            arrayBuffer: () => response.arrayBuffer(),
+        };
+    }
+    isRetryableStatus(status) {
+        return this.retry.retryableStatuses.includes(status);
+    }
+    hostOf(url) {
+        return new URL(url).hostname;
+    }
+    hostState(host) {
+        const existing = this.hosts.get(host);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const rl = this.perHostRateLimit[host] ?? this.rateLimit;
+        const state = {
+            bucket: new token_bucket_1.TokenBucket({
+                requestsPerSecond: rl.requestsPerSecond,
+                burst: rl.burst,
+                now: this.clock.now,
+            }),
+            circuit: new circuit_breaker_1.CircuitBreaker({ ...this.circuitBreaker, now: this.clock.now }),
+            maxQueueMs: rl.maxQueueMs ?? defaults_1.DEFAULT_RATE_LIMIT.maxQueueMs,
+        };
+        this.hosts.set(host, state);
+        return state;
+    }
+}
+exports.ManagedFetch = ManagedFetch;
+function createManagedFetch(config = {}) {
+    return new ManagedFetch(config);
+}
+//# sourceMappingURL=managed-fetch.js.map

package/dist/lib/managed-fetch.js.map

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

package/dist/lib/token-bucket.d.ts

@@ -0,0 +1,16 @@
+export interface TokenBucketOptions {
+    requestsPerSecond: number;
+    burst: number;
+    now: () => number;
+}
+export declare class TokenBucket {
+    private readonly opts;
+    private readonly refillPerMs;
+    private readonly capacity;
+    private tokens;
+    private lastRefill;
+    constructor(opts: TokenBucketOptions);
+    reserve(): number;
+    refund(): void;
+}
+//# sourceMappingURL=token-bucket.d.ts.map

package/dist/lib/token-bucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.d.ts","sourceRoot":"","sources":["../../src/lib/token-bucket.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEE,IAAI,EAAE,kBAAkB;IAkBrD,OAAO,IAAI,MAAM;IAyBjB,MAAM,IAAI,IAAI;CAGf"}

package/dist/lib/token-bucket.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenBucket = void 0;
+class TokenBucket {
+    opts;
+    refillPerMs;
+    capacity;
+    tokens;
+    lastRefill;
+    constructor(opts) {
+        this.opts = opts;
+        if (opts.requestsPerSecond <= 0) {
+            throw new RangeError('requestsPerSecond must be > 0');
+        }
+        if (opts.burst <= 0) {
+            throw new RangeError('burst must be > 0');
+        }
+        this.refillPerMs = opts.requestsPerSecond / 1000;
+        this.capacity = opts.burst;
+        this.tokens = opts.burst;
+        this.lastRefill = opts.now();
+    }
+    reserve() {
+        const now = this.opts.now();
+        const elapsed = now - this.lastRefill;
+        if (elapsed > 0) {
+            this.tokens = Math.min(this.capacity, this.tokens + elapsed * this.refillPerMs);
+            this.lastRefill = now;
+        }
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return 0;
+        }
+        const deficit = 1 - this.tokens;
+        const waitMs = deficit / this.refillPerMs;
+        this.tokens -= 1;
+        return waitMs;
+    }
+    refund() {
+        this.tokens = Math.min(this.capacity, this.tokens + 1);
+    }
+}
+exports.TokenBucket = TokenBucket;
+//# sourceMappingURL=token-bucket.js.map

package/dist/lib/token-bucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.js","sourceRoot":"","sources":["../../src/lib/token-bucket.ts"],"names":[],"mappings":";;;AAwBA,MAAa,WAAW;IAMO;IALZ,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,MAAM,CAAS;IACf,UAAU,CAAS;IAE3B,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;QACnD,IAAI,IAAI,CAAC,iBAAiB,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAOD,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YAChF,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,OAAO,CAAC,CAAC;QACX,CAAC;QAID,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IAMD,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;CACF;AApDD,kCAoDC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,67 @@
+export type ManagedFetchBody = RequestInit['body'];
+export type FetchImpl = (input: string, init: RequestInit) => Promise<Response>;
+export interface ManagedFetchClock {
+    now: () => number;
+    sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
+    random: () => number;
+}
+export interface RateLimitConfig {
+    requestsPerSecond: number;
+    burst: number;
+    maxQueueMs?: number;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    retryableStatuses?: readonly number[];
+    respectRetryAfter?: boolean;
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    cooldownMs: number;
+    halfOpenMaxProbes?: number;
+}
+export interface ManagedFetchConfig {
+    userAgent?: string;
+    rateLimit?: RateLimitConfig;
+    perHostRateLimit?: Readonly<Record<string, RateLimitConfig>>;
+    retry?: RetryConfig;
+    circuitBreaker?: CircuitBreakerConfig;
+    timeoutMs?: number;
+    fetchImpl?: FetchImpl;
+    clock?: Partial<ManagedFetchClock>;
+}
+export interface ConditionalTokens {
+    etag?: string;
+    lastModified?: string;
+}
+export interface ManagedFetchRequest {
+    method?: string;
+    headers?: Readonly<Record<string, string>>;
+    body?: ManagedFetchBody;
+    userAgent?: string;
+    timeoutMs?: number;
+    conditional?: ConditionalTokens;
+    signal?: AbortSignal;
+}
+export interface ManagedFetchResult {
+    url: string;
+    status: number;
+    ok: boolean;
+    notModified: boolean;
+    fromCache: boolean;
+    headers: Headers;
+    etag?: string;
+    lastModified?: string;
+    raw: Response;
+    text(): Promise<string>;
+    json<T = unknown>(): Promise<T>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export interface ProbeResult {
+    healthy: boolean;
+    status?: number;
+    latencyMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAOnD,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAShF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,eAAe;IAE9B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,KAAK,EAAE,MAAM,CAAC;IAOd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,WAAW;IAE1B,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,MAAM,WAAW,oBAAoB;IAEnC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAGD,MAAM,WAAW,kBAAkB;IAMjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAE7D,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAEtC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,iBAAiB;IAEhC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,mBAAmB;IAElC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE3C,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD,MAAM,WAAW,kBAAkB;IAEjC,GAAG,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,EAAE,EAAE,OAAO,CAAC;IAKZ,WAAW,EAAE,OAAO,CAAC;IAErB,SAAS,EAAE,OAAO,CAAC;IAEnB,OAAO,EAAE,OAAO,CAAC;IAEjB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,GAAG,EAAE,QAAQ,CAAC;IAEd,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAGD,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,OAAO,CAAC;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@xemahq/managed-fetch",
+  "version": "0.1.0",
+  "description": "Layer-1 managed outbound-fetch / polite-crawl HTTP client. A domain-agnostic wrapper any ingestion/monitor/scraper calls instead of bare `fetch`: per-host token-bucket rate limiting, exponential backoff+jitter with Retry-After, a per-host circuit breaker, first-class conditional (ETag / If-Modified-Since → 304) change-detection, configurable User-Agent, per-request timeouts, and a health probe. Fail-fast with typed errors; all rate-limit/circuit state is per-instance and in-memory. Zero runtime dependencies.",
+  "license": "Apache-2.0",
+  "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
+  "homepage": "https://xema.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-kernel-sdk.git",
+    "directory": "packages/sdks/managed-fetch"
+  },
+  "bugs": "https://github.com/xema-dev/xema-kernel-sdk/issues",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "25.2.3",
+    "jest": "^30.3.0",
+    "prettier": "3.6.2",
+    "ts-jest": "^29.4.9",
+    "typescript": "5.9.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./dist/lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "test": "jest --config jest.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}