@lgriffin/esi.ts 9.7.0 → 10.2.0

package/dist/clients/WarsClient.d.mts

@@ -0,0 +1,33 @@
+import { ApiClient } from '../core/ApiClient.mjs';
+import { BaseEsiClient } from './BaseEsiClient.mjs';
+import { warEndpoints } from '../core/endpoints/warEndpoints.mjs';
+import { War, KillmailSummary } from '../types/api-responses.mjs';
+import { PageResult } from '../core/pagination/AsyncPaginationIterator.mjs';
+export declare class WarsClient extends BaseEsiClient<typeof warEndpoints> {
+    constructor(client: ApiClient);
+    /**
+     * Retrieves a list of all war IDs, ordered by war ID descending.
+     *
+     * @returns A list of war IDs
+     */
+    getWars(): Promise<number[]>;
+    /**
+     * Retrieves detailed information about a specific war, including aggressors, defenders, and status.
+     *
+     * @param warId - The ID of the war
+     * @returns Detailed war information
+     */
+    getWarById(warId: number): Promise<War>;
+    /**
+     * Retrieves the killmail summaries associated with a specific war.
+     *
+     * @param warId - The ID of the war
+     * @returns A list of killmail summaries for the war
+     */
+    getWarKillmails(warId: number): Promise<KillmailSummary[]>;
+    fetchAllWars(concurrency?: number): Promise<number[]>;
+    fetchAllWarKillmails(warId: number, concurrency?: number): Promise<KillmailSummary[]>;
+    streamWars(): AsyncGenerator<PageResult<number>, void, undefined>;
+    streamWarKillmails(warId: number): AsyncGenerator<PageResult<KillmailSummary>, void, undefined>;
+}
+//# sourceMappingURL=WarsClient.d.ts.map

package/dist/core/ApiClient.d.mts

@@ -0,0 +1,73 @@
+import { MiddlewareManager, RequestInterceptor, ResponseInterceptor } from './middleware/Middleware.mjs';
+import { ICache } from './cache/ICache.mjs';
+import { IRateLimiter } from './rateLimiter/IRateLimiter.mjs';
+import { ICircuitBreaker } from './circuitBreaker/ICircuitBreaker.mjs';
+import { IDeduplicator } from './IDeduplicator.mjs';
+import { IRetryStrategy } from './IRetryStrategy.mjs';
+import { RetryConfig } from './util/retry.mjs';
+import type { ILogger } from './logger/ILogger.mjs';
+export type EsiDatasource = 'tranquility' | 'singularity';
+export type TokenProvider = () => Promise<string>;
+export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export declare class ApiClient {
+    private clientId;
+    private link;
+    private accessToken?;
+    private datasource?;
+    private tokenProvider?;
+    private refreshInFlight?;
+    private middleware;
+    private cache;
+    private rateLimiter;
+    private circuitBreaker;
+    private timeout;
+    private deduplicator;
+    private retryConfig;
+    private retryStrategy;
+    private validateResponse;
+    private validateRequest;
+    private language?;
+    private compatibilityDate?;
+    private fetchFn;
+    private logger;
+    constructor(clientId: string, link: string, accessToken?: string | undefined);
+    getTimeout(): number;
+    setTimeout(timeout: number): void;
+    getCache(): ICache | null;
+    setCache(cache: ICache | null): void;
+    getRateLimiter(): IRateLimiter | null;
+    setRateLimiter(limiter: IRateLimiter | null): void;
+    getCircuitBreaker(): ICircuitBreaker | null;
+    setCircuitBreaker(cb: ICircuitBreaker | null): void;
+    getDeduplicator(): IDeduplicator | null;
+    setDeduplicator(dedup: IDeduplicator | null): void;
+    getRetryConfig(): RetryConfig | null;
+    setRetryConfig(config: RetryConfig | null): void;
+    getRetryStrategy(): IRetryStrategy | null;
+    setRetryStrategy(strategy: IRetryStrategy | null): void;
+    getValidateResponse(): boolean;
+    setValidateResponse(validate: boolean): void;
+    getValidateRequest(): boolean;
+    setValidateRequest(validate: boolean): void;
+    getFetch(): FetchLike;
+    setFetch(fn: FetchLike): void;
+    getMiddleware(): MiddlewareManager;
+    addRequestInterceptor(fn: RequestInterceptor): () => void;
+    addResponseInterceptor(fn: ResponseInterceptor): () => void;
+    getAuthorizationHeader(): string | undefined;
+    getLink(): string;
+    getDatasource(): EsiDatasource | undefined;
+    setDatasource(datasource: EsiDatasource | undefined): void;
+    getLanguage(): string | undefined;
+    setLanguage(language: string | undefined): void;
+    getCompatibilityDate(): string | undefined;
+    setCompatibilityDate(date: string | undefined): void;
+    setAccessToken(token: string): void;
+    setTokenProvider(provider: TokenProvider | undefined): void;
+    getLogger(): ILogger | null;
+    setLogger(logger: ILogger | null): void;
+    hasTokenProvider(): boolean;
+    toJSON(): Record<string, unknown>;
+    refreshToken(): Promise<string>;
+}
+//# sourceMappingURL=ApiClient.d.ts.map

package/dist/core/ApiClient.d.ts

@@ -5,6 +5,7 @@ import { ICircuitBreaker } from './circuitBreaker/ICircuitBreaker';
 import { IDeduplicator } from './IDeduplicator';
 import { IRetryStrategy } from './IRetryStrategy';
 import { RetryConfig } from './util/retry';
+import type { ILogger } from './logger/ILogger';
 export type EsiDatasource = 'tranquility' | 'singularity';
 export type TokenProvider = () => Promise<string>;
 export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
@@ -28,6 +29,7 @@ export declare class ApiClient {
     private language?;
     private compatibilityDate?;
     private fetchFn;
+    private logger;
     constructor(clientId: string, link: string, accessToken?: string | undefined);
     getTimeout(): number;
     setTimeout(timeout: number): void;
@@ -62,6 +64,8 @@ export declare class ApiClient {
     setCompatibilityDate(date: string | undefined): void;
     setAccessToken(token: string): void;
     setTokenProvider(provider: TokenProvider | undefined): void;
+    getLogger(): ILogger | null;
+    setLogger(logger: ILogger | null): void;
     hasTokenProvider(): boolean;
     toJSON(): Record<string, unknown>;
     refreshToken(): Promise<string>;

package/dist/core/ApiClient.d.ts.map

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

package/dist/core/ApiClientBuilder.d.mts

@@ -0,0 +1,24 @@
+import { ApiClient, FetchLike } from './ApiClient.mjs';
+import { IRateLimiter } from './rateLimiter/IRateLimiter.mjs';
+import { ICache } from './cache/ICache.mjs';
+import { CircuitBreaker } from './circuitBreaker/CircuitBreaker.mjs';
+export declare class ApiClientBuilder {
+    private clientId;
+    private link;
+    private accessToken?;
+    private rateLimiter?;
+    private cache?;
+    private circuitBreaker?;
+    private _timeout?;
+    private _fetch?;
+    setClientId(clientId: string): ApiClientBuilder;
+    setLink(link: string): ApiClientBuilder;
+    setAccessToken(accessToken?: string): ApiClientBuilder;
+    setRateLimiter(limiter: IRateLimiter): ApiClientBuilder;
+    setCache(cache: ICache): ApiClientBuilder;
+    setCircuitBreaker(cb: CircuitBreaker): ApiClientBuilder;
+    setTimeout(timeout: number): ApiClientBuilder;
+    setFetch(fn: FetchLike): ApiClientBuilder;
+    build(): ApiClient;
+}
+//# sourceMappingURL=ApiClientBuilder.d.ts.map

package/dist/core/ApiRequestHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiRequestHandler.d.ts","sourceRoot":"","sources":["../../src/core/ApiRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmBxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAqI5D,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EACjB,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,OAAO,OAAO,EACd,eAAc,OAAe,EAC7B,eAAe,MAAM,EACrB,iBAAiB,MAAM,KACtB,OAAO,CAAC,kBAAkB,CA6B5B,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS,EACjB,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,OAAO,OAAO,EACd,eAAc,OAAe,EAC7B,UAAS,OAAc,EACvB,eAAe,MAAM,EACrB,iBAAiB,MAAM,KACtB,OAAO,CAAC,kBAAkB,CAoD5B,CAAC"}
+{"version":3,"file":"ApiRequestHandler.d.ts","sourceRoot":"","sources":["../../src/core/ApiRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAwBxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAgL5D,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EACjB,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,OAAO,OAAO,EACd,eAAc,OAAe,EAC7B,eAAe,MAAM,EACrB,iBAAiB,MAAM,KACtB,OAAO,CAAC,kBAAkB,CA8B5B,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS,EACjB,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,OAAO,OAAO,EACd,eAAc,OAAe,EAC7B,UAAS,OAAc,EACvB,eAAe,MAAM,EACrB,iBAAiB,MAAM,KACtB,OAAO,CAAC,kBAAkB,CAsE5B,CAAC"}

package/dist/core/BatchRequestHandler.d.mts

@@ -0,0 +1,12 @@
+import { EsiError } from './util/error.mjs';
+export interface BatchOptions {
+    concurrency?: number;
+    onProgress?: (completed: number, total: number) => void;
+}
+export interface BatchResult<K, T> {
+    results: Map<K, T>;
+    errors: Map<K, EsiError | Error>;
+}
+export declare function batchFetch<K, T>(keys: K[], fetcher: (key: K) => Promise<T>, options?: BatchOptions): Promise<BatchResult<K, T>>;
+export declare function batchPost<T>(ids: number[], poster: (chunk: number[]) => Promise<T[]>, chunkSize?: number): Promise<T[]>;
+//# sourceMappingURL=BatchRequestHandler.d.ts.map

package/dist/core/BatchRequestHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BatchRequestHandler.d.ts","sourceRoot":"","sources":["../../src/core/BatchRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,EAAE,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;CAClC;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EACnC,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC/B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAqD5B;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EAAE,EACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,EACzC,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC,CAiBd"}
+{"version":3,"file":"BatchRequestHandler.d.ts","sourceRoot":"","sources":["../../src/core/BatchRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,EAAE,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;CAClC;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EACnC,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC/B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA8D5B;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EAAE,EACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,EACzC,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC,CAmBd"}

package/dist/core/ClientRegistry.d.mts

@@ -0,0 +1,45 @@
+import { ApiClient } from './ApiClient.mjs';
+import { AllianceClient } from '../clients/AllianceClient.mjs';
+import { AssetsClient } from '../clients/AssetsClient.mjs';
+import { CalendarClient } from '../clients/CalendarClient.mjs';
+import { CharacterClient } from '../clients/CharacterClient.mjs';
+import { ClonesClient } from '../clients/ClonesClient.mjs';
+import { ContactsClient } from '../clients/ContactsClient.mjs';
+import { ContractsClient } from '../clients/ContractsClient.mjs';
+import { CorporationsClient } from '../clients/CorporationsClient.mjs';
+import { CorporationProjectsClient } from '../clients/CorporationProjectsClient.mjs';
+import { DogmaClient } from '../clients/DogmaClient.mjs';
+import { FactionClient } from '../clients/FactionClient.mjs';
+import { FittingsClient } from '../clients/FittingsClient.mjs';
+import { FleetClient } from '../clients/FleetClient.mjs';
+import { IncursionsClient } from '../clients/IncursionsClient.mjs';
+import { IndustryClient } from '../clients/IndustryClient.mjs';
+import { InsuranceClient } from '../clients/InsuranceClient.mjs';
+import { KillmailsClient } from '../clients/KillmailsClient.mjs';
+import { LocationClient } from '../clients/LocationClient.mjs';
+import { LoyaltyClient } from '../clients/LoyaltyClient.mjs';
+import { MailClient } from '../clients/MailClient.mjs';
+import { MarketClient } from '../clients/MarketClient.mjs';
+import { PiClient } from '../clients/PiClient.mjs';
+import { RouteClient } from '../clients/RouteClient.mjs';
+import { SearchClient } from '../clients/SearchClient.mjs';
+import { CharacterSkillsClient } from '../clients/SkillsClient.mjs';
+import { SovereigntyClient } from '../clients/SovereigntyClient.mjs';
+import { StatusClient } from '../clients/StatusClient.mjs';
+import { UiClient } from '../clients/UiClient.mjs';
+import { UniverseClient } from '../clients/UniverseClient.mjs';
+import { WalletClient } from '../clients/WalletClient.mjs';
+import { WarsClient } from '../clients/WarsClient.mjs';
+import { MetaClient } from '../clients/MetaClient.mjs';
+import { FreelanceJobsClient } from '../clients/FreelanceJobsClient.mjs';
+import { SkyhooksClient } from '../clients/SkyhooksClient.mjs';
+import { MercenaryClient } from '../clients/MercenaryClient.mjs';
+import { AccessListsClient } from '../clients/AccessListsClient.mjs';
+import { CosmeticsClient } from '../clients/CosmeticsClient.mjs';
+import { ParagonHubClient } from '../clients/ParagonHubClient.mjs';
+import { MilitaryCampaignsClient } from '../clients/MilitaryCampaignsClient.mjs';
+export type ApiClientType = 'alliance' | 'assets' | 'calendar' | 'characters' | 'clones' | 'contacts' | 'contracts' | 'corporations' | 'corporationProjects' | 'dogma' | 'factions' | 'fittings' | 'fleets' | 'incursions' | 'industry' | 'insurance' | 'killmails' | 'location' | 'loyalty' | 'mail' | 'market' | 'pi' | 'route' | 'search' | 'skills' | 'sovereignty' | 'status' | 'ui' | 'universe' | 'wallet' | 'wars' | 'meta' | 'freelanceJobs' | 'skyhooks' | 'cosmetics' | 'paragonHub' | 'mercenary' | 'militaryCampaigns' | 'accessLists';
+export type ClientInstance = AllianceClient | AssetsClient | CalendarClient | CharacterClient | ClonesClient | ContactsClient | ContractsClient | CorporationsClient | CorporationProjectsClient | DogmaClient | FactionClient | FittingsClient | FleetClient | IncursionsClient | IndustryClient | InsuranceClient | KillmailsClient | LocationClient | LoyaltyClient | MailClient | MarketClient | PiClient | RouteClient | SearchClient | CharacterSkillsClient | SovereigntyClient | StatusClient | UiClient | UniverseClient | WalletClient | WarsClient | MetaClient | FreelanceJobsClient | SkyhooksClient | CosmeticsClient | ParagonHubClient | MercenaryClient | MilitaryCampaignsClient | AccessListsClient;
+export declare function createClientInstance(name: ApiClientType, apiClient: ApiClient): ClientInstance;
+export { AllianceClient, AssetsClient, CalendarClient, CharacterClient, ClonesClient, ContactsClient, ContractsClient, CorporationsClient, CorporationProjectsClient, DogmaClient, FactionClient, FittingsClient, FleetClient, IncursionsClient, IndustryClient, InsuranceClient, KillmailsClient, LocationClient, LoyaltyClient, MailClient, MarketClient, PiClient, RouteClient, SearchClient, CharacterSkillsClient, SovereigntyClient, StatusClient, UiClient, UniverseClient, WalletClient, WarsClient, MetaClient, FreelanceJobsClient, SkyhooksClient, CosmeticsClient, ParagonHubClient, MercenaryClient, MilitaryCampaignsClient, AccessListsClient, };
+//# sourceMappingURL=ClientRegistry.d.ts.map

package/dist/core/EsiDiagnostics.d.mts

@@ -0,0 +1,35 @@
+import { ApiClient } from './ApiClient.mjs';
+import { ETagCacheConfig } from './cache/ETagCacheManager.mjs';
+import { RequestDeduplicator } from './RequestDeduplicator.mjs';
+export interface CacheStats {
+    totalEntries: number;
+    maxEntries: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    oldestEntry: number | null;
+    newestEntry: number | null;
+}
+export interface CircuitBreakerStats {
+    totalCircuits: number;
+    openCircuits: number;
+    circuits: Record<string, {
+        state: 'closed' | 'open' | 'half-open';
+        failures: number;
+    }>;
+}
+export declare class EsiDiagnostics {
+    private apiClient;
+    private etagCacheEnabled;
+    private deduplicator;
+    constructor(apiClient: ApiClient, etagCacheEnabled: boolean, deduplicator: RequestDeduplicator | null);
+    getCacheStats(): CacheStats | null;
+    clearCache(): void;
+    updateCacheConfig(newConfig: Partial<ETagCacheConfig>): void;
+    getCircuitBreakerStats(): CircuitBreakerStats | null;
+    resetCircuitBreaker(endpoint?: string): void;
+    getDeduplicatorStats(): {
+        pendingRequests: number;
+    } | null;
+}
+//# sourceMappingURL=EsiDiagnostics.d.ts.map

package/dist/core/IDeduplicator.d.mts

@@ -0,0 +1,22 @@
+export interface IDeduplicator {
+    dedupe<T>(key: string, execute: () => Promise<T>): Promise<T>;
+    readonly pending: number;
+    clear(): void;
+    /**
+     * Stop new callers joining in-flight requests whose key contains
+     * `pathSegment`, and report how many were detached.
+     *
+     * Called after a write succeeds. A read that starts after a DELETE has
+     * completed must not be answered by a GET that was sent before it: the
+     * response is pre-write data, and the caller has every reason to expect
+     * otherwise. Detaching leaves the in-flight request running and its existing
+     * joiners untouched — they asked before the write and their answer is still
+     * the one they asked for. It only removes the entry new callers would join.
+     *
+     * Optional, so a deduplicator written against an earlier version of this
+     * interface still satisfies it. A deduplicator that does not implement it
+     * keeps the old behaviour, which is why the pipeline calls it with `?.`.
+     */
+    detachByPath?(pathSegment: string): number;
+}
+//# sourceMappingURL=IDeduplicator.d.ts.map

package/dist/core/IDeduplicator.d.ts

@@ -2,5 +2,21 @@ export interface IDeduplicator {
     dedupe<T>(key: string, execute: () => Promise<T>): Promise<T>;
     readonly pending: number;
     clear(): void;
+    /**
+     * Stop new callers joining in-flight requests whose key contains
+     * `pathSegment`, and report how many were detached.
+     *
+     * Called after a write succeeds. A read that starts after a DELETE has
+     * completed must not be answered by a GET that was sent before it: the
+     * response is pre-write data, and the caller has every reason to expect
+     * otherwise. Detaching leaves the in-flight request running and its existing
+     * joiners untouched — they asked before the write and their answer is still
+     * the one they asked for. It only removes the entry new callers would join.
+     *
+     * Optional, so a deduplicator written against an earlier version of this
+     * interface still satisfies it. A deduplicator that does not implement it
+     * keeps the old behaviour, which is why the pipeline calls it with `?.`.
+     */
+    detachByPath?(pathSegment: string): number;
 }
 //# sourceMappingURL=IDeduplicator.d.ts.map

package/dist/core/IDeduplicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IDeduplicator.d.ts","sourceRoot":"","sources":["../../src/core/IDeduplicator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"IDeduplicator.d.ts","sourceRoot":"","sources":["../../src/core/IDeduplicator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C"}

package/dist/core/IRetryStrategy.d.mts

@@ -0,0 +1,5 @@
+import { RetryContext } from './RetryStrategy.mjs';
+export interface IRetryStrategy {
+    execute<T>(operation: () => Promise<T>, context: RetryContext): Promise<T>;
+}
+//# sourceMappingURL=IRetryStrategy.d.ts.map

package/dist/core/RequestDeduplicator.d.mts

@@ -0,0 +1,21 @@
+import { IDeduplicator } from './IDeduplicator.mjs';
+export declare class RequestDeduplicator implements IDeduplicator {
+    private inflight;
+    private client;
+    setClient(client: import('./ApiClient.mjs').ApiClient | null): void;
+    dedupe<T>(key: string, execute: () => Promise<T>): Promise<T>;
+    /**
+     * Drop the in-flight entries whose key contains `pathSegment`, so a call
+     * made after a write cannot join a request sent before it.
+     *
+     * The requests themselves keep running and whoever already joined them still
+     * gets their answer. Only the map entry goes, which is what new callers look
+     * in. Matching is `includes`, the same rule ETagCacheManager.deleteByPath
+     * uses, so one written path invalidates the cache and detaches the reads of
+     * it by the same test.
+     */
+    detachByPath(pathSegment: string): number;
+    get pending(): number;
+    clear(): void;
+}
+//# sourceMappingURL=RequestDeduplicator.d.ts.map

package/dist/core/RequestDeduplicator.d.ts

@@ -1,7 +1,20 @@
 import { IDeduplicator } from './IDeduplicator';
 export declare class RequestDeduplicator implements IDeduplicator {
     private inflight;
+    private client;
+    setClient(client: import('./ApiClient').ApiClient | null): void;
     dedupe<T>(key: string, execute: () => Promise<T>): Promise<T>;
+    /**
+     * Drop the in-flight entries whose key contains `pathSegment`, so a call
+     * made after a write cannot join a request sent before it.
+     *
+     * The requests themselves keep running and whoever already joined them still
+     * gets their answer. Only the map entry goes, which is what new callers look
+     * in. Matching is `includes`, the same rule ETagCacheManager.deleteByPath
+     * uses, so one written path invalidates the cache and detaches the reads of
+     * it by the same test.
+     */
+    detachByPath(pathSegment: string): number;
     get pending(): number;
     clear(): void;
 }

package/dist/core/RequestDeduplicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequestDeduplicator.d.ts","sourceRoot":"","sources":["../../src/core/RequestDeduplicator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAuC;IAEjD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAenE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"RequestDeduplicator.d.ts","sourceRoot":"","sources":["../../src/core/RequestDeduplicator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,MAAM,CAAgD;IAE9D,SAAS,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAIzD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBnE;;;;;;;;;OASG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAiBzC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/RetryStrategy.d.mts

@@ -0,0 +1,21 @@
+import { ApiClient } from './ApiClient.mjs';
+import { RetryConfig } from './util/retry.mjs';
+import { IRetryStrategy } from './IRetryStrategy.mjs';
+export interface RetryContext {
+    client?: ApiClient;
+    endpoint: string;
+    method: string;
+    requiresAuth: boolean;
+    refreshToken?: () => Promise<void>;
+    /** @deprecated Unused — after refresh the strategy re-enters the main operation loop. */
+    retryOperation?: () => Promise<unknown>;
+}
+export declare class RetryStrategy implements IRetryStrategy {
+    private readonly maxRetries;
+    private readonly baseDelayMs;
+    private readonly maxDelayMs;
+    private readonly retryMutations;
+    constructor(config?: RetryConfig);
+    execute<T>(operation: () => Promise<T>, context: RetryContext): Promise<T>;
+}
+//# sourceMappingURL=RetryStrategy.d.ts.map

package/dist/core/RetryStrategy.d.ts

@@ -1,6 +1,8 @@
+import { ApiClient } from './ApiClient';
 import { RetryConfig } from './util/retry';
 import { IRetryStrategy } from './IRetryStrategy';
 export interface RetryContext {
+    client?: ApiClient;
     endpoint: string;
     method: string;
     requiresAuth: boolean;

package/dist/core/RetryStrategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RetryStrategy.d.ts","sourceRoot":"","sources":["../../src/core/RetryStrategy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAc,MAAM,cAAc,CAAC;AAIvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,MAAM,CAAC,EAAE,WAAW;IAO1B,OAAO,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC;CAsEd"}
+{"version":3,"file":"RetryStrategy.d.ts","sourceRoot":"","sources":["../../src/core/RetryStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAc,MAAM,cAAc,CAAC;AAIvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,MAAM,CAAC,EAAE,WAAW;IAO1B,OAAO,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC;CA8Ed"}

package/dist/core/cache/ETagCacheManager.d.mts

@@ -0,0 +1,75 @@
+import { ApiClient } from '../ApiClient.mjs';
+import { ICache, CacheEntry } from './ICache.mjs';
+export type { CacheEntry } from './ICache.mjs';
+export interface ETagCacheConfig {
+    maxEntries?: number;
+    defaultTtl?: number;
+    cleanupInterval?: number;
+}
+export declare class ETagCacheManager implements ICache {
+    private cache;
+    private config;
+    private cleanupTimer?;
+    private hits;
+    private misses;
+    private client;
+    setClient(client: ApiClient | null): void;
+    private log;
+    constructor(config?: ETagCacheConfig);
+    /**
+     * Get cached data if ETag matches
+     */
+    get(url: string): CacheEntry | null;
+    /**
+     * Get ETag for a URL (for If-None-Match header)
+     */
+    getETag(url: string): string | null;
+    /**
+     * Set cache entry
+     */
+    set(url: string, etag: string, data: unknown, headers: Record<string, string>, customTtl?: number): void;
+    /**
+     * Check if cached data exists and is valid
+     */
+    has(url: string): boolean;
+    /**
+     * Clear specific cache entry
+     */
+    delete(url: string): boolean;
+    /**
+     * Delete all cache entries whose URL contains the given path segment
+     */
+    deleteByPath(pathSegment: string): number;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        totalEntries: number;
+        maxEntries: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+        oldestEntry: number | null;
+        newestEntry: number | null;
+    };
+    /**
+     * Update cache configuration
+     */
+    updateConfig(newConfig: Partial<ETagCacheConfig>): void;
+    /**
+     * Cleanup expired entries
+     */
+    cleanup(): number;
+    /**
+     * Shutdown cache manager
+     */
+    shutdown(): void;
+    private isExpired;
+    private evictOldest;
+    private startCleanupTimer;
+}
+//# sourceMappingURL=ETagCacheManager.d.ts.map

package/dist/core/cache/ETagCacheManager.d.ts

@@ -1,3 +1,4 @@
+import { ApiClient } from '../ApiClient';
 import { ICache, CacheEntry } from './ICache';
 export type { CacheEntry } from './ICache';
 export interface ETagCacheConfig {
@@ -11,6 +12,9 @@ export declare class ETagCacheManager implements ICache {
     private cleanupTimer?;
     private hits;
     private misses;
+    private client;
+    setClient(client: ApiClient | null): void;
+    private log;
     constructor(config?: ETagCacheConfig);
     /**
      * Get cached data if ETag matches

package/dist/core/cache/ETagCacheManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ETagCacheManager.d.ts","sourceRoot":"","sources":["../../../src/core/cache/ETagCacheManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9C,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,GAAE,eAAoB;IAaxC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoBnC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,GAAG,CACD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAkBP;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAczC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B;IAoBD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAKvD;;OAEG;IACH,OAAO,IAAI,MAAM;IAiBjB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,iBAAiB;CAO1B"}
+{"version":3,"file":"ETagCacheManager.d.ts","sourceRoot":"","sources":["../../../src/core/cache/ETagCacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9C,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAA0B;IAExC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAIzC,OAAO,CAAC,GAAG;gBAWC,MAAM,GAAE,eAAoB;IAexC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoBnC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,GAAG,CACD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAmBP;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAoBzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B;IAoBD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAOvD;;OAEG;IACH,OAAO,IAAI,MAAM;IAmBjB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,iBAAiB;CAO1B"}

package/dist/core/cache/ICache.d.mts

@@ -0,0 +1,27 @@
+export interface CacheEntry {
+    etag: string;
+    data: unknown;
+    headers: Record<string, string>;
+    timestamp: number;
+    ttl?: number;
+}
+export interface ICache {
+    get(url: string): CacheEntry | null;
+    getETag(url: string): string | null;
+    set(url: string, etag: string, data: unknown, headers: Record<string, string>, customTtl?: number): void;
+    has(url: string): boolean;
+    delete(url: string): boolean;
+    deleteByPath(pathSegment: string): number;
+    clear(): void;
+    getStats(): {
+        totalEntries: number;
+        maxEntries: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+        oldestEntry: number | null;
+        newestEntry: number | null;
+    };
+    shutdown(): void;
+}
+//# sourceMappingURL=ICache.d.ts.map

package/dist/core/cache/cacheKey.d.ts

@@ -1,3 +1,14 @@
 import { ApiClient } from '../ApiClient';
+/** The ETag cache key for a request: its URL, scoped to the identity. */
 export declare function buildCacheKey(url: string, client: ApiClient, requiresAuth?: boolean): string;
+/**
+ * The deduplication key for an in-flight request: its endpoint, scoped to the
+ * identity.
+ *
+ * Coalescing has to draw the same line the cache does. Two concurrent GETs to
+ * one authenticated endpoint under different tokens are two different
+ * questions, and answering both from one response hands one caller the other
+ * identity's data.
+ */
+export declare function buildDedupeKey(endpoint: string, client: ApiClient, requiresAuth?: boolean): string;
 //# sourceMappingURL=cacheKey.d.ts.map

package/dist/core/cache/cacheKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cacheKey.d.ts","sourceRoot":"","sources":["../../../src/core/cache/cacheKey.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,YAAY,GAAE,OAAe,GAC5B,MAAM,CASR"}
+{"version":3,"file":"cacheKey.d.ts","sourceRoot":"","sources":["../../../src/core/cache/cacheKey.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA8BzC,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,YAAY,GAAE,OAAe,GAC5B,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,YAAY,GAAE,OAAe,GAC5B,MAAM,CAER"}

package/dist/core/circuitBreaker/CircuitBreaker.d.mts

@@ -0,0 +1,52 @@
+import { ApiClient } from '../ApiClient.mjs';
+import { ICircuitBreaker } from './ICircuitBreaker.mjs';
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerConfig {
+    failureThreshold?: number;
+    resetTimeoutMs?: number;
+    halfOpenMaxAttempts?: number;
+    staleThresholdMs?: number;
+    /** 'resolved' (default, current behavior) | 'template' (group by endpoint template path) */
+    keyStrategy?: 'resolved' | 'template';
+    /** Interval in ms for automatic cleanup of stale circuits. 0 or undefined disables. Recommended value: staleThresholdMs. */
+    cleanupIntervalMs?: number;
+}
+export declare class CircuitBreaker implements ICircuitBreaker {
+    private circuits;
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private readonly halfOpenMaxAttempts;
+    private readonly staleThresholdMs;
+    private readonly keyStrategy;
+    private cleanupTimer;
+    private client;
+    setClient(client: ApiClient | null): void;
+    constructor(config?: CircuitBreakerConfig);
+    private getKey;
+    private getOrCreate;
+    checkCircuit(endpoint: string): void;
+    recordSuccess(endpoint: string): void;
+    recordFailure(endpoint: string, statusCode: number): void;
+    getState(endpoint: string): CircuitState;
+    getStats(): {
+        totalCircuits: number;
+        openCircuits: number;
+        circuits: Record<string, {
+            state: CircuitState;
+            failures: number;
+        }>;
+    };
+    reset(endpoint?: string): void;
+    cleanup(): number;
+    getKeyStrategy(): 'resolved' | 'template';
+    destroy(): void;
+    shutdown(): void;
+    private startCleanupTimer;
+}
+export declare class CircuitOpenError extends Error {
+    readonly endpoint: string;
+    readonly failures: number;
+    readonly retryAfterMs: number;
+    constructor(endpoint: string, failures: number, retryAfterMs: number);
+}
+//# sourceMappingURL=CircuitBreaker.d.ts.map