nlcurl 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -1,41 +1,56 @@
-/**
- * Public API entry point for the NLcURL library. Re-exports all types, classes,
- * and functions that form the stable public surface of the package.
- *
- * @module nlcurl
- */
 export type { HttpMethod, NLcURLRequest, NLcURLSessionConfig, RequestBody, RequestTimings, RetryConfig, TimeoutConfig, ProgressEvent, ProgressCallback, ServerSentEvent } from "./core/request.js";
 export { NLcURLResponse } from "./core/response.js";
 export type { ResponseMeta } from "./core/response.js";
 export { NLcURLError, TLSError, HTTPError, TimeoutError, ProxyError, AbortError, ConnectionError, ProtocolError } from "./core/errors.js";
+export { validateUrlSafety } from "./core/validation.js";
 export { NLcURLSession, type RequestOptions } from "./core/session.js";
 export { createSession, request, get, post, put, patch, del, head } from "./core/client.js";
+export { buildAuthHeader, parseAuthenticateScheme, type AuthConfig, type DigestChallenge as CoreDigestChallenge } from "./core/auth.js";
 export { getProfile, listProfiles, DEFAULT_PROFILE } from "./fingerprints/database.js";
 export type { BrowserProfile, TLSProfile, H2Profile, HeaderProfile } from "./fingerprints/types.js";
 export type { RequestInterceptor, ResponseInterceptor } from "./middleware/interceptor.js";
 export type { RateLimitConfig } from "./middleware/rate-limiter.js";
+export { CircuitBreaker, CircuitState, type CircuitBreakerConfig } from "./middleware/circuit-breaker.js";
+export { parseRetryAfter, getRetryAfterMs } from "./middleware/retry-after.js";
 export type { Logger, LogLevel, LogBindings } from "./utils/logger.js";
-export { ConsoleLogger, SILENT_LOGGER, setDefaultLogger, getDefaultLogger } from "./utils/logger.js";
+export { ConsoleLogger, JsonLogger, SILENT_LOGGER, setDefaultLogger, getDefaultLogger } from "./utils/logger.js";
 export { CookieJar } from "./cookies/jar.js";
 export { isPublicSuffix, getRegistrableDomain } from "./cookies/public-suffix.js";
 export { FormData, type FormFile, type FormValue } from "./http/form-data.js";
 export type { TLSOptions } from "./tls/types.js";
+export { SAFE_DEFAULT_CIPHERS } from "./tls/constants.js";
 export { WebSocketClient, type WebSocketOptions, type WebSocketEvents } from "./ws/client.js";
 export { ja3Hash, ja3String } from "./fingerprints/ja3.js";
+export { ja4Fingerprint, ja4aSection } from "./fingerprints/ja4.js";
 export { akamaiFingerprint } from "./fingerprints/akamai.js";
 export { TLSSessionCache, type SessionTicketEntry, type SessionCacheOptions } from "./tls/session-cache.js";
+export { setKeylogFile, getKeylogFile } from "./tls/keylog.js";
 export { resolveEnvProxy } from "./proxy/env-proxy.js";
 export { SSEParser, parseSSEStream } from "./sse/parser.js";
 export { PerMessageDeflate, type DeflateParams, buildDeflateOffer, parseDeflateResponse } from "./ws/permessage-deflate.js";
-export { isQuicAvailable } from "./http/h3/detection.js";
 export { CacheStore, parseCacheControl } from "./cache/store.js";
 export type { CacheConfig, CacheMode, CacheDirectives, CacheEntry } from "./cache/types.js";
 export { HSTSStore } from "./hsts/store.js";
 export type { HSTSConfig, HSTSEntry, HSTSPreloadEntry } from "./hsts/types.js";
 export { DoHResolver } from "./dns/doh-resolver.js";
+export { DNSCache, type DNSCacheConfig, type DNSCacheEntry } from "./dns/cache.js";
 export { HTTPSRRResolver, type HTTPSRRResult } from "./dns/https-rr.js";
 export type { DoHConfig, DNSConfig, DNSRecord, SVCBRecord, ResolvedAddress } from "./dns/types.js";
 export { RTYPE, SvcParamKey } from "./dns/types.js";
 export { AltSvcStore, type AltSvcEntry } from "./http/alt-svc.js";
-export { parseECHConfigList, generateGreaseECH, type ECHConfig, type ECHParameters, type ECHOptions } from "./tls/ech.js";
+export { parseLinkHeader, type EarlyHint, type EarlyHintsCallback } from "./http/early-hints.js";
+export { compressBody, shouldCompress, type RequestEncoding } from "./utils/compression.js";
+export { parseECHConfigList, generateGreaseECH, parseECHRetryConfigs, shouldRetryECH, type ECHConfig, type ECHParameters, type ECHOptions } from "./tls/ech.js";
+export { parseOCSPResponse, isOCSPValid, validateOCSPStapling, OCSPResponseStatus, OCSPCertStatus, type OCSPResult } from "./tls/ocsp.js";
+export { parseSCTList, validateSCTs, extractSCTsFromSocket, SCTVersion, SCTHashAlgorithm, SCTSignatureAlgorithm, type SCT, type SCTValidationResult } from "./tls/ct.js";
+export { canSendEarlyData, prepareEarlyData, checkEarlyDataAccepted, type EarlyDataConfig, type EarlyDataResult } from "./tls/early-data.js";
+export { isValidTrailerField, serializeTrailers, parseTrailers, buildTrailerHeader } from "./http/trailers.js";
+export { buildUploadCreationHeaders, buildUploadResumeHeaders, buildUploadOffsetHeaders, parseUploadOffset, isUploadComplete, splitIntoChunks, parseUploadUrl, type UploadSession, type ResumableUploadConfig } from "./http/resumable-upload.js";
+export { RangeCache, parseContentRange, parseRangeHeader, type ContentRange, type RangeSegment, type RangeCacheEntry } from "./cache/range.js";
+export { parseNoVarySearch, urlsMatchWithNoVarySearch, normalizeUrlForCache, type NoVarySearchDirective } from "./cache/no-vary-search.js";
+export { CacheGroupStore, parseCacheGroups, type CacheGroup } from "./cache/groups.js";
+export { DictionaryStore, parseUseAsDictionary, computeDictionaryHash, buildAvailableDictionaryHeader, buildDictionaryAcceptEncoding, type CompressionDictionary, type DictionaryConfig } from "./utils/dictionary-transport.js";
+export { isTFOSupported, buildTFOSocketOptions, getTFOStatus, type TFOOptions } from "./utils/tcp-fast-open.js";
+export { DoTResolver, DOT_SERVERS, type DoTConfig } from "./dns/dot-resolver.js";
+export { parseProxyAuthenticate, parseDigestChallenge, buildDigestAuth, buildBasicProxyAuth, buildProxyAuthorization, type ProxyAuthConfig, type ProxyAuthScheme, type DigestChallenge } from "./proxy/auth.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnM,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE1I,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExI,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEvF,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEpG,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAE3F,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE1G,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE/E,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEjH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE9E,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE5G,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAE5H,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEjG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEhK,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1I,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,GAAG,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEzK,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE7I,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE/G,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAElP,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE/I,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAE3I,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEjO,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEhH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,25 +1,46 @@
 export { NLcURLResponse } from "./core/response.js";
 export { NLcURLError, TLSError, HTTPError, TimeoutError, ProxyError, AbortError, ConnectionError, ProtocolError } from "./core/errors.js";
+export { validateUrlSafety } from "./core/validation.js";
 export { NLcURLSession } from "./core/session.js";
 export { createSession, request, get, post, put, patch, del, head } from "./core/client.js";
+export { buildAuthHeader, parseAuthenticateScheme } from "./core/auth.js";
 export { getProfile, listProfiles, DEFAULT_PROFILE } from "./fingerprints/database.js";
-export { ConsoleLogger, SILENT_LOGGER, setDefaultLogger, getDefaultLogger } from "./utils/logger.js";
+export { CircuitBreaker, CircuitState } from "./middleware/circuit-breaker.js";
+export { parseRetryAfter, getRetryAfterMs } from "./middleware/retry-after.js";
+export { ConsoleLogger, JsonLogger, SILENT_LOGGER, setDefaultLogger, getDefaultLogger } from "./utils/logger.js";
 export { CookieJar } from "./cookies/jar.js";
 export { isPublicSuffix, getRegistrableDomain } from "./cookies/public-suffix.js";
 export { FormData } from "./http/form-data.js";
+export { SAFE_DEFAULT_CIPHERS } from "./tls/constants.js";
 export { WebSocketClient } from "./ws/client.js";
 export { ja3Hash, ja3String } from "./fingerprints/ja3.js";
+export { ja4Fingerprint, ja4aSection } from "./fingerprints/ja4.js";
 export { akamaiFingerprint } from "./fingerprints/akamai.js";
 export { TLSSessionCache } from "./tls/session-cache.js";
+export { setKeylogFile, getKeylogFile } from "./tls/keylog.js";
 export { resolveEnvProxy } from "./proxy/env-proxy.js";
 export { SSEParser, parseSSEStream } from "./sse/parser.js";
 export { PerMessageDeflate, buildDeflateOffer, parseDeflateResponse } from "./ws/permessage-deflate.js";
-export { isQuicAvailable } from "./http/h3/detection.js";
 export { CacheStore, parseCacheControl } from "./cache/store.js";
 export { HSTSStore } from "./hsts/store.js";
 export { DoHResolver } from "./dns/doh-resolver.js";
+export { DNSCache } from "./dns/cache.js";
 export { HTTPSRRResolver } from "./dns/https-rr.js";
 export { RTYPE, SvcParamKey } from "./dns/types.js";
 export { AltSvcStore } from "./http/alt-svc.js";
-export { parseECHConfigList, generateGreaseECH } from "./tls/ech.js";
+export { parseLinkHeader } from "./http/early-hints.js";
+export { compressBody, shouldCompress } from "./utils/compression.js";
+export { parseECHConfigList, generateGreaseECH, parseECHRetryConfigs, shouldRetryECH } from "./tls/ech.js";
+export { parseOCSPResponse, isOCSPValid, validateOCSPStapling, OCSPResponseStatus, OCSPCertStatus } from "./tls/ocsp.js";
+export { parseSCTList, validateSCTs, extractSCTsFromSocket, SCTVersion, SCTHashAlgorithm, SCTSignatureAlgorithm } from "./tls/ct.js";
+export { canSendEarlyData, prepareEarlyData, checkEarlyDataAccepted } from "./tls/early-data.js";
+export { isValidTrailerField, serializeTrailers, parseTrailers, buildTrailerHeader } from "./http/trailers.js";
+export { buildUploadCreationHeaders, buildUploadResumeHeaders, buildUploadOffsetHeaders, parseUploadOffset, isUploadComplete, splitIntoChunks, parseUploadUrl } from "./http/resumable-upload.js";
+export { RangeCache, parseContentRange, parseRangeHeader } from "./cache/range.js";
+export { parseNoVarySearch, urlsMatchWithNoVarySearch, normalizeUrlForCache } from "./cache/no-vary-search.js";
+export { CacheGroupStore, parseCacheGroups } from "./cache/groups.js";
+export { DictionaryStore, parseUseAsDictionary, computeDictionaryHash, buildAvailableDictionaryHeader, buildDictionaryAcceptEncoding } from "./utils/dictionary-transport.js";
+export { isTFOSupported, buildTFOSocketOptions, getTFOStatus } from "./utils/tcp-fast-open.js";
+export { DoTResolver, DOT_SERVERS } from "./dns/dot-resolver.js";
+export { parseProxyAuthenticate, parseDigestChallenge, buildDigestAuth, buildBasicProxyAuth, buildProxyAuthorization } from "./proxy/auth.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE1I,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AASvF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErG,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAiC,MAAM,qBAAqB,CAAC;AAI9E,OAAO,EAAE,eAAe,EAA+C,MAAM,gBAAgB,CAAC;AAE9F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAqD,MAAM,wBAAwB,CAAC;AAE5G,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAsB,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAE5H,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAsB,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAuD,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,44 @@
+/** Circuit breaker states. */
+export declare const enum CircuitState {
+    CLOSED = 0,
+    OPEN = 1,
+    HALF_OPEN = 2
+}
+/** Configuration for the circuit breaker. */
+export interface CircuitBreakerConfig {
+    /** Number of consecutive failures before opening the circuit. */
+    failureThreshold: number;
+    /** Time in ms the circuit stays open before allowing a probe request. */
+    resetTimeoutMs: number;
+    /** Number of successful probe requests to close the circuit (default: 1). */
+    successThreshold?: number;
+    /** Optional predicate to determine if a status code is a failure. */
+    isFailure?: (statusCode: number) => boolean;
+}
+/** Per-origin circuit breaker for preventing cascading failures. */
+export declare class CircuitBreaker {
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private readonly successThreshold;
+    private readonly isFailure;
+    private readonly circuits;
+    constructor(config: CircuitBreakerConfig);
+    /**
+     * Check if a request to the given origin should be allowed.
+     * Throws if the circuit is open and not yet ready for a probe.
+     */
+    allowRequest(origin: string): void;
+    /** Record a successful request to the origin. */
+    recordSuccess(origin: string): void;
+    /** Record a failed request or a failure status code. */
+    recordFailure(origin: string): void;
+    /** Record a response and automatically classify as success/failure. */
+    recordResponse(origin: string, statusCode: number): void;
+    /** Get the current state of the circuit for an origin. */
+    getState(origin: string): CircuitState;
+    /** Reset a specific origin's circuit. */
+    reset(origin: string): void;
+    /** Reset all circuits. */
+    resetAll(): void;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/middleware/circuit-breaker.ts"],"names":[],"mappings":"AAEA,8BAA8B;AAC9B,0BAAkB,YAAY;IAC5B,MAAM,IAAI;IACV,IAAI,IAAI;IACR,SAAS,IAAI;CACd;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAC7C;AAED,oEAAoE;AACpE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAEhD,MAAM,EAAE,oBAAoB;IAOxC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAclC,iDAAiD;IACjD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAenC,wDAAwD;IACxD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAoBnC,uEAAuE;IACvE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQxD,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAItC,yCAAyC;IACzC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3B,0BAA0B;IAC1B,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/middleware/circuit-breaker.js

@@ -0,0 +1,96 @@
+import { NLcURLError } from "../core/errors.js";
+/** Circuit breaker states. */
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState[CircuitState["CLOSED"] = 0] = "CLOSED";
+    CircuitState[CircuitState["OPEN"] = 1] = "OPEN";
+    CircuitState[CircuitState["HALF_OPEN"] = 2] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+/** Per-origin circuit breaker for preventing cascading failures. */
+export class CircuitBreaker {
+    failureThreshold;
+    resetTimeoutMs;
+    successThreshold;
+    isFailure;
+    circuits = new Map();
+    constructor(config) {
+        this.failureThreshold = config.failureThreshold;
+        this.resetTimeoutMs = config.resetTimeoutMs;
+        this.successThreshold = config.successThreshold ?? 1;
+        this.isFailure = config.isFailure ?? ((s) => s >= 500);
+    }
+    /**
+     * Check if a request to the given origin should be allowed.
+     * Throws if the circuit is open and not yet ready for a probe.
+     */
+    allowRequest(origin) {
+        const entry = this.circuits.get(origin);
+        if (!entry)
+            return;
+        if (entry.state === CircuitState.OPEN) {
+            if (Date.now() >= entry.openedAt + this.resetTimeoutMs) {
+                entry.state = CircuitState.HALF_OPEN;
+                entry.halfOpenSuccesses = 0;
+            }
+            else {
+                throw new NLcURLError(`Circuit breaker open for ${origin} — failing fast`, "ERR_CIRCUIT_OPEN");
+            }
+        }
+    }
+    /** Record a successful request to the origin. */
+    recordSuccess(origin) {
+        const entry = this.circuits.get(origin);
+        if (!entry)
+            return;
+        if (entry.state === CircuitState.HALF_OPEN) {
+            entry.halfOpenSuccesses++;
+            if (entry.halfOpenSuccesses >= this.successThreshold) {
+                entry.state = CircuitState.CLOSED;
+                entry.consecutiveFailures = 0;
+            }
+        }
+        else if (entry.state === CircuitState.CLOSED) {
+            entry.consecutiveFailures = 0;
+        }
+    }
+    /** Record a failed request or a failure status code. */
+    recordFailure(origin) {
+        let entry = this.circuits.get(origin);
+        if (!entry) {
+            entry = { state: CircuitState.CLOSED, consecutiveFailures: 0, openedAt: 0, halfOpenSuccesses: 0 };
+            this.circuits.set(origin, entry);
+        }
+        if (entry.state === CircuitState.HALF_OPEN) {
+            entry.state = CircuitState.OPEN;
+            entry.openedAt = Date.now();
+            return;
+        }
+        entry.consecutiveFailures++;
+        if (entry.consecutiveFailures >= this.failureThreshold) {
+            entry.state = CircuitState.OPEN;
+            entry.openedAt = Date.now();
+        }
+    }
+    /** Record a response and automatically classify as success/failure. */
+    recordResponse(origin, statusCode) {
+        if (this.isFailure(statusCode)) {
+            this.recordFailure(origin);
+        }
+        else {
+            this.recordSuccess(origin);
+        }
+    }
+    /** Get the current state of the circuit for an origin. */
+    getState(origin) {
+        return this.circuits.get(origin)?.state ?? CircuitState.CLOSED;
+    }
+    /** Reset a specific origin's circuit. */
+    reset(origin) {
+        this.circuits.delete(origin);
+    }
+    /** Reset all circuits. */
+    resetAll() {
+        this.circuits.clear();
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

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

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

package/dist/middleware/interceptor.d.ts

@@ -1,58 +1,39 @@
 import type { NLcURLRequest } from "../core/request.js";
 import { NLcURLResponse } from "../core/response.js";
-/**
- * A function that inspects and optionally transforms an outgoing request before
- * it is sent. May be synchronous or asynchronous.
- *
- * @callback RequestInterceptor
- * @param {NLcURLRequest} request - The outgoing request descriptor.
- * @returns {NLcURLRequest | Promise<NLcURLRequest>} The (potentially modified) request.
- */
+/** Function that transforms a request before it is sent. */
 export type RequestInterceptor = (request: NLcURLRequest) => NLcURLRequest | Promise<NLcURLRequest>;
-/**
- * A function that inspects and optionally transforms an incoming response before
- * it is returned to the caller. May be synchronous or asynchronous.
- *
- * @callback ResponseInterceptor
- * @param {NLcURLResponse} response - The received response.
- * @returns {NLcURLResponse | Promise<NLcURLResponse>} The (potentially modified) response.
- */
+/** Function that transforms a response after it is received. */
 export type ResponseInterceptor = (response: NLcURLResponse) => NLcURLResponse | Promise<NLcURLResponse>;
-/**
- * Maintains ordered lists of request and response interceptors and applies
- * them sequentially. Interceptors are invoked in the order they were added.
- */
+/** Ordered chain of request and response interceptors. */
 export declare class InterceptorChain {
     private readonly requestInterceptors;
     private readonly responseInterceptors;
     /**
-     * Registers a request interceptor. Interceptors are applied in registration order.
+     * Register a request interceptor.
      *
-     * @param {RequestInterceptor} fn - Interceptor function to add.
+     * @param {RequestInterceptor} fn - Interceptor function.
      * @returns {this} This instance for chaining.
      */
     addRequestInterceptor(fn: RequestInterceptor): this;
     /**
-     * Registers a response interceptor. Interceptors are applied in registration order.
+     * Register a response interceptor.
      *
-     * @param {ResponseInterceptor} fn - Interceptor function to add.
+     * @param {ResponseInterceptor} fn - Interceptor function.
      * @returns {this} This instance for chaining.
      */
     addResponseInterceptor(fn: ResponseInterceptor): this;
     /**
-     * Passes `request` through all registered request interceptors in order and
-     * returns the final transformed request.
+     * Run all request interceptors in order.
      *
-     * @param {NLcURLRequest} request - Originating request descriptor.
-     * @returns {Promise<NLcURLRequest>} The request after all interceptors have run.
+     * @param {NLcURLRequest} request - Original request.
+     * @returns {Promise<NLcURLRequest>} Transformed request.
      */
     processRequest(request: NLcURLRequest): Promise<NLcURLRequest>;
     /**
-     * Passes `response` through all registered response interceptors in order and
-     * returns the final transformed response.
+     * Run all response interceptors in order.
      *
-     * @param {NLcURLResponse} response - Received response.
-     * @returns {Promise<NLcURLResponse>} The response after all interceptors have run.
+     * @param {NLcURLResponse} response - Original response.
+     * @returns {Promise<NLcURLResponse>} Transformed response.
      */
     processResponse(response: NLcURLResponse): Promise<NLcURLResponse>;
 }

package/dist/middleware/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAEpG;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEzG;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAKnD;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAKrD;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAQpE;;;;;;OAMG;IACG,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAOzE"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAEpG,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEzG,0DAA0D;AAC1D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAKnD;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAKrD;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAQpE;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAOzE"}

package/dist/middleware/interceptor.js

@@ -1,14 +1,11 @@
-/**
- * Maintains ordered lists of request and response interceptors and applies
- * them sequentially. Interceptors are invoked in the order they were added.
- */
+/** Ordered chain of request and response interceptors. */
 export class InterceptorChain {
     requestInterceptors = [];
     responseInterceptors = [];
     /**
-     * Registers a request interceptor. Interceptors are applied in registration order.
+     * Register a request interceptor.
      *
-     * @param {RequestInterceptor} fn - Interceptor function to add.
+     * @param {RequestInterceptor} fn - Interceptor function.
      * @returns {this} This instance for chaining.
      */
     addRequestInterceptor(fn) {
@@ -16,9 +13,9 @@ export class InterceptorChain {
         return this;
     }
     /**
-     * Registers a response interceptor. Interceptors are applied in registration order.
+     * Register a response interceptor.
      *
-     * @param {ResponseInterceptor} fn - Interceptor function to add.
+     * @param {ResponseInterceptor} fn - Interceptor function.
      * @returns {this} This instance for chaining.
      */
     addResponseInterceptor(fn) {
@@ -26,11 +23,10 @@ export class InterceptorChain {
         return this;
     }
     /**
-     * Passes `request` through all registered request interceptors in order and
-     * returns the final transformed request.
+     * Run all request interceptors in order.
      *
-     * @param {NLcURLRequest} request - Originating request descriptor.
-     * @returns {Promise<NLcURLRequest>} The request after all interceptors have run.
+     * @param {NLcURLRequest} request - Original request.
+     * @returns {Promise<NLcURLRequest>} Transformed request.
      */
     async processRequest(request) {
         let req = request;
@@ -40,11 +36,10 @@ export class InterceptorChain {
         return req;
     }
     /**
-     * Passes `response` through all registered response interceptors in order and
-     * returns the final transformed response.
+     * Run all response interceptors in order.
      *
-     * @param {NLcURLResponse} response - Received response.
-     * @returns {Promise<NLcURLResponse>} The response after all interceptors have run.
+     * @param {NLcURLResponse} response - Original response.
+     * @returns {Promise<NLcURLResponse>} Transformed response.
      */
     async processResponse(response) {
         let resp = response;

package/dist/middleware/interceptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,mBAAmB,GAAyB,EAAE,CAAC;IAC/C,oBAAoB,GAA0B,EAAE,CAAC;IAElE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAsB;QAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,EAAuB;QAC5C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,OAAsB;QACzC,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1C,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,QAAwB;QAC5C,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3C,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AASA,0DAA0D;AAC1D,MAAM,OAAO,gBAAgB;IACV,mBAAmB,GAAyB,EAAE,CAAC;IAC/C,oBAAoB,GAA0B,EAAE,CAAC;IAElE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAsB;QAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,EAAuB;QAC5C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAsB;QACzC,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1C,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,QAAwB;QAC5C,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3C,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/middleware/rate-limiter.d.ts

@@ -1,19 +1,11 @@
-/**
- * Configuration options for a token-bucket rate limiter.
- *
- * @typedef  {Object} RateLimitConfig
- * @property {number} maxRequests - Maximum number of requests allowed per `windowMs` interval.
- * @property {number} windowMs    - Duration of the rate-limiting window in milliseconds.
- */
+/** Configuration for the token-bucket rate limiter. */
 export interface RateLimitConfig {
+    /** Maximum number of requests allowed per window. */
     maxRequests: number;
+    /** Window duration in milliseconds. */
     windowMs: number;
 }
-/**
- * Token-bucket rate limiter. Callers must call {@link RateLimiter.acquire} and
- * await the returned promise before sending each request. Requests that would
- * exceed the configured rate are queued and granted once the window refills.
- */
+/** Token-bucket rate limiter for outgoing requests. */
 export declare class RateLimiter {
     private readonly maxRequests;
     private readonly windowMs;
@@ -21,16 +13,15 @@ export declare class RateLimiter {
     private lastRefill;
     private waitQueue;
     /**
-     * Creates a new RateLimiter.
+     * Create a new rate limiter.
      *
-     * @param {RateLimitConfig} config - Rate-limit parameters.
+     * @param {RateLimitConfig} config - Rate limit configuration.
      */
     constructor(config: RateLimitConfig);
     /**
-     * Acquires a rate-limit token. Resolves immediately when a token is
-     * available, or waits until the current window refills.
+     * Acquire a token, waiting if the rate limit has been reached.
      *
-     * @returns {Promise<void>} Resolves once a token has been granted to the caller.
+     * @returns {Promise<void>} Promise that resolves when a token is available.
      */
     acquire(): Promise<void>;
     private drain;

package/dist/middleware/rate-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAyB;IAE1C;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAQnC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,MAAM;CAYf"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uDAAuD;AACvD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAyB;IAE1C;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAQnC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,MAAM;CAYf"}

package/dist/middleware/rate-limiter.js

@@ -1,9 +1,5 @@
 import { validateRateLimitConfig } from "../core/validation.js";
-/**
- * Token-bucket rate limiter. Callers must call {@link RateLimiter.acquire} and
- * await the returned promise before sending each request. Requests that would
- * exceed the configured rate are queued and granted once the window refills.
- */
+/** Token-bucket rate limiter for outgoing requests. */
 export class RateLimiter {
     maxRequests;
     windowMs;
@@ -11,9 +7,9 @@ export class RateLimiter {
     lastRefill;
     waitQueue = [];
     /**
-     * Creates a new RateLimiter.
+     * Create a new rate limiter.
      *
-     * @param {RateLimitConfig} config - Rate-limit parameters.
+     * @param {RateLimitConfig} config - Rate limit configuration.
      */
     constructor(config) {
         validateRateLimitConfig(config);
@@ -23,10 +19,9 @@ export class RateLimiter {
         this.lastRefill = Date.now();
     }
     /**
-     * Acquires a rate-limit token. Resolves immediately when a token is
-     * available, or waits until the current window refills.
+     * Acquire a token, waiting if the rate limit has been reached.
      *
-     * @returns {Promise<void>} Resolves once a token has been granted to the caller.
+     * @returns {Promise<void>} Promise that resolves when a token is available.
      */
     async acquire() {
         this.refill();
@@ -38,7 +33,9 @@ export class RateLimiter {
             this.waitQueue.push(resolve);
             const elapsed = Date.now() - this.lastRefill;
             const waitMs = Math.max(1, this.windowMs - elapsed);
-            setTimeout(() => this.drain(), waitMs);
+            setTimeout(() => {
+                this.drain();
+            }, waitMs);
         });
     }
     drain() {
@@ -51,7 +48,9 @@ export class RateLimiter {
         if (this.waitQueue.length > 0) {
             const elapsed = Date.now() - this.lastRefill;
             const waitMs = Math.max(1, this.windowMs - elapsed);
-            setTimeout(() => this.drain(), waitMs);
+            setTimeout(() => {
+                this.drain();
+            }, waitMs);
         }
     }
     refill() {

package/dist/middleware/rate-limiter.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAchE;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACL,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,SAAS,GAAsB,EAAE,CAAC;IAE1C;;;;OAIG;IACH,YAAY,MAAuB;QACjC,uBAAuB,CAAC,MAA4C,CAAC,CAAC;QACtE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACrC,IAAI,EAAE,CAAC;QACT,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAUhE,uDAAuD;AACvD,MAAM,OAAO,WAAW;IACL,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,SAAS,GAAsB,EAAE,CAAC;IAE1C;;;;OAIG;IACH,YAAY,MAAuB;QACjC,uBAAuB,CAAC,MAA4C,CAAC,CAAC;QACtE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC,EAAE,MAAM,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACrC,IAAI,EAAE,CAAC;QACT,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC,EAAE,MAAM,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/middleware/retry-after.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse a Retry-After header value into milliseconds.
+ *
+ * @param {string} value - Raw Retry-After header (seconds or HTTP date).
+ * @returns {number|undefined} Delay in milliseconds, or `undefined` if unparseable.
+ */
+export declare function parseRetryAfter(value: string): number | undefined;
+/**
+ * Extract the retry delay from response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @returns {number|undefined} Delay in milliseconds, or `undefined` if no Retry-After header.
+ */
+export declare function getRetryAfterMs(headers: Record<string, string>): number | undefined;
+//# sourceMappingURL=retry-after.d.ts.map

package/dist/middleware/retry-after.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.d.ts","sourceRoot":"","sources":["../../src/middleware/retry-after.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAInF"}

package/dist/middleware/retry-after.js

@@ -0,0 +1,36 @@
+/**
+ * Parse a Retry-After header value into milliseconds.
+ *
+ * @param {string} value - Raw Retry-After header (seconds or HTTP date).
+ * @returns {number|undefined} Delay in milliseconds, or `undefined` if unparseable.
+ */
+export function parseRetryAfter(value) {
+    if (!value)
+        return undefined;
+    const trimmed = value.trim();
+    if (/^\d+$/.test(trimmed)) {
+        const seconds = parseInt(trimmed, 10);
+        if (Number.isFinite(seconds) && seconds >= 0) {
+            return seconds * 1000;
+        }
+    }
+    const date = new Date(trimmed);
+    if (!Number.isNaN(date.getTime())) {
+        const delayMs = date.getTime() - Date.now();
+        return Math.max(0, delayMs);
+    }
+    return undefined;
+}
+/**
+ * Extract the retry delay from response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @returns {number|undefined} Delay in milliseconds, or `undefined` if no Retry-After header.
+ */
+export function getRetryAfterMs(headers) {
+    const value = headers["retry-after"];
+    if (!value)
+        return undefined;
+    return parseRetryAfter(value);
+}
+//# sourceMappingURL=retry-after.js.map