@lgriffin/esi.ts 7.4.0 → 9.0.0

package/dist/core/pagination/CursorPaginationHandler.d.ts

@@ -23,28 +23,37 @@ export interface CursorPage<T = unknown> {
     data: T[];
     cursors: CursorTokens;
 }
+export type CursorPageFetcher = (endpoint: string, cursor?: {
+    before?: string;
+    after?: string;
+}) => Promise<CursorPage>;
 export interface CursorPaginationOptions {
     maxPages?: number;
-    maxRetries?: number;
-    retryDelayMs?: number;
 }
 export declare class CursorPaginationHandler {
     private static readonly DEFAULT_OPTIONS;
     /**
      * Fetch a single cursor page, returning data + cursor tokens.
+     *
+     * When no `pageFetch` callback is provided, the request is routed
+     * through the standard request pipeline (rate limiter, circuit
+     * breaker, timeout, middleware) instead of a raw `fetch()`.
      */
     static fetchPage(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, cursor?: {
         before?: string;
         after?: string;
-    }, body?: unknown): Promise<CursorPage>;
+    }, body?: unknown, pageFetch?: CursorPageFetcher): Promise<CursorPage>;
     /**
      * Auto-fetch all pages by following `after` tokens until an empty
      * response is received.  Combines the caller-supplied first page
      * data with all subsequent pages.
      */
-    static fetchAll(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], firstCursors: CursorTokens, body?: unknown, options?: CursorPaginationOptions): Promise<unknown[]>;
+    static fetchAll(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], firstCursors: CursorTokens, body?: unknown, options?: CursorPaginationOptions, pageFetch?: CursorPageFetcher): Promise<unknown[]>;
     /**
      * Fetch a single cursor page with retry logic.
+     *
+     * Delegates to the configured `IRetryStrategy` (exponential backoff
+     * with jitter) instead of implementing a custom retry loop.
      */
     private static fetchPageWithRetry;
     /**
@@ -52,8 +61,8 @@ export declare class CursorPaginationHandler {
      */
     static extractCursors(headers: Headers): CursorTokens;
     /**
-     * Build a URL with cursor query parameters appended.
+     * Build an endpoint path with cursor query parameters appended.
      */
-    private static buildUrl;
+    private static buildEndpointWithCursor;
 }
 //# sourceMappingURL=CursorPaginationHandler.d.ts.map

package/dist/core/pagination/CursorPaginationHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CursorPaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/CursorPaginationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAIrC;IAEF;;OAEG;WACU,SAAS,CACpB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC;IAqCtB;;;;OAIG;WACU,QAAQ,CACnB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,YAAY,EAAE,YAAY,EAC1B,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,EAAE,CAAC;IAwDrB;;OAEG;mBACkB,kBAAkB;IAmCvC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAQrD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CAmBxB"}
+{"version":3,"file":"CursorPaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/CursorPaginationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAUzC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACzC,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAErC;IAEF;;;;;;OAMG;WACU,SAAS,CACpB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAuCtB;;;;OAIG;WACU,QAAQ,CACnB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,YAAY,EAAE,YAAY,EAC1B,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,OAAO,EAAE,CAAC;IAwDrB;;;;;OAKG;mBACkB,kBAAkB;IAiCvC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAQrD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAiBvC"}

package/dist/core/pagination/PaginationHandler.d.ts

@@ -5,8 +5,6 @@
 import { ApiClient } from '../ApiClient';
 export interface PaginationOptions {
     maxPages?: number;
-    maxRetries?: number;
-    retryDelayMs?: number;
     stopOnEmptyPage?: boolean;
 }
 export type PageFetcher = (paginatedEndpoint: string) => Promise<unknown[]>;
@@ -16,15 +14,18 @@ export declare class PaginationHandler {
      * Fetch remaining pages (2..totalPages) and combine with first page data.
      * The caller has already fetched page 1 and knows the total page count.
      */
-    static fetchRemainingPages(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], totalPages: number, body?: unknown, options?: PaginationOptions, pageFetch?: PageFetcher, templatePath?: string): Promise<unknown[]>;
+    static fetchRemainingPages(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], totalPages: number, body: unknown, options: PaginationOptions, pageFetch: PageFetcher, templatePath?: string): Promise<unknown[]>;
     /**
-     * Fetch a single page with retry logic
+     * Fetch a single page with retry logic.
+     *
+     * Delegates to the configured `IRetryStrategy` (exponential backoff
+     * with jitter) instead of implementing a custom retry loop.
      */
     private static fetchPageWithRetry;
     /**
-     * Fetch a single page.
+     * Build a paginated endpoint path.
      * Preserves any existing query params on the endpoint and appends page=N.
      */
-    private static fetchSinglePage;
+    private static buildPaginatedEndpoint;
 }
 //# sourceMappingURL=PaginationHandler.d.ts.map

package/dist/core/pagination/PaginationHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/PaginationHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAE5E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKrC;IAEF;;;OAGG;WACU,mBAAmB,CAC9B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,EAC/B,SAAS,CAAC,EAAE,WAAW,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC;IA8DrB;;OAEG;mBACkB,kBAAkB;IA2CvC;;;OAGG;mBACkB,eAAe;CAiDrC"}
+{"version":3,"file":"PaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/PaginationHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAE5E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAGrC;IAEF;;;OAGG;WACU,mBAAmB,CAC9B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,WAAW,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC;IAmDrB;;;;;OAKG;mBACkB,kBAAkB;IA2BvC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAOtC"}

package/dist/core/rateLimiter/RateLimiter.d.ts

@@ -19,9 +19,9 @@ export declare class RateLimiter implements IRateLimiter {
     private readonly decelerationThreshold;
     private readonly userKeyExtractor?;
     private lastRequestTime;
+    private minDelayChain;
     private isTestMode;
-    private errorLimitRemain;
-    private errorLimitReset;
+    private globalErrorLimit;
     private defaultBuckets;
     private userBuckets;
     private fallbackBucket;
@@ -32,12 +32,18 @@ export declare class RateLimiter implements IRateLimiter {
     private createBucketFromSpec;
     private createBucketForGroup;
     private lookupGroupSpec;
+    private resolveUserSet;
     private resolveBucketMap;
+    private resolveErrorLimit;
     private getBucket;
     private cleanupStaleUsers;
     updateFromResponse(headers: Record<string, string>, statusCode: number, templatePath?: string, method?: string, requestHeaders?: Record<string, string>): void;
     updateRateLimitInfo(headers: Record<string, string>): void;
     checkRateLimit(templatePath?: string, method?: string, requestHeaders?: Record<string, string>): Promise<void>;
+    /**
+     * Serializes min-delay waits so concurrent callers cannot all read the same
+     * lastRequestTime and fire together after sleeping.
+     */
     private enforceMinDelay;
     getStatus(): RateLimitInfo;
     getGroupStatus(group: string): RateLimitGroupStatus | undefined;

package/dist/core/rateLimiter/RateLimiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../../src/core/rateLimiter/RateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AASpE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;CAChE;AAmBD,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAEtB;IAEZ,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,UAAU,CAAkB;IAEpC,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,eAAe,CAAa;IAEpC,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,cAAc,CAAc;IAEpC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAU;gBAEzC,MAAM,CAAC,EAAE,iBAAiB;IAUtC,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,iBAAiB;IAazB,kBAAkB,CAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,IAAI;IAyCP,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIpD,cAAc,CAClB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;YA8DF,eAAe;IAgB7B,SAAS,IAAI,aAAa;IAyC1B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAa/D,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAexD,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI/C,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAelC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,KAAK,IAAI,IAAI;CASd"}
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../../src/core/rateLimiter/RateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAUpE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;CAChE;AA0BD,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAEtB;IAEZ,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,UAAU,CAAkB;IAEpC,OAAO,CAAC,gBAAgB,CAA+C;IAEvE,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,cAAc,CAAc;IAEpC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAU;gBAEzC,MAAM,CAAC,EAAE,iBAAiB;IAUtC,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,iBAAiB;IAazB,kBAAkB,CAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,IAAI;IA0CP,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIpD,cAAc,CAClB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;IA+EhB;;;OAGG;YACW,eAAe;IAuB7B,SAAS,IAAI,aAAa;IAyC1B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAa/D,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAexD,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI/C,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAelC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,KAAK,IAAI,IAAI;CASd"}

package/dist/core/requestPipeline/cachePolicy.d.ts

@@ -0,0 +1,31 @@
+import { ApiClient } from '../ApiClient';
+import { ICache } from '../cache/ICache';
+import { ParsedHeaders } from '../util/headersUtil';
+export interface EsiHandlerResponse {
+    headers: Record<string, string>;
+    body: unknown;
+    status?: number;
+    fromCache?: boolean;
+    stale?: boolean;
+    cacheHitType?: 'spec-ttl' | 'etag-304' | 'stale-on-error';
+    responseTimeMs?: number;
+    cursors?: import('../pagination/CursorPaginationHandler').CursorTokens;
+}
+/**
+ * Look up the spec-defined cache TTL for a given method + template path.
+ * Returns TTL in milliseconds, or undefined if not found.
+ */
+export declare function lookupSpecTtl(method: string, templatePath: string): number | undefined;
+/**
+ * Attempt a spec-aware cache hit (TTL-based, no network request).
+ */
+export declare function trySpecAwareCacheHit(client: ApiClient, url: string, method: string, templatePath: string | undefined, resolveCache: (client: ApiClient) => ICache | null): EsiHandlerResponse | null;
+/**
+ * Attempt to return a stale cached response (used on server errors).
+ */
+export declare function tryStaleCacheResponse(client: ApiClient, url: string, parsed: ParsedHeaders, resolveCache: (client: ApiClient) => ICache | null): EsiHandlerResponse | null;
+/**
+ * Cache a successful response, or invalidate cache for non-GET methods.
+ */
+export declare function cacheResponse(client: ApiClient, url: string, method: string, endpoint: string, parsed: ParsedHeaders, data: unknown, useETag: boolean, resolveCache: (client: ApiClient) => ICache | null, templatePath?: string): void;
+//# sourceMappingURL=cachePolicy.d.ts.map

package/dist/core/requestPipeline/cachePolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cachePolicy.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/cachePolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,uCAAuC,EAAE,YAAY,CAAC;CACxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAOpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,GACjD,kBAAkB,GAAG,IAAI,CAsB3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,GACjD,kBAAkB,GAAG,IAAI,CAa3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,EAClD,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAgBN"}

package/dist/core/requestPipeline/dependencies.d.ts

@@ -0,0 +1,10 @@
+import { ApiClient } from '../ApiClient';
+import { ICache } from '../cache/ICache';
+import { IRateLimiter } from '../rateLimiter/IRateLimiter';
+import { ICircuitBreaker } from '../circuitBreaker/ICircuitBreaker';
+import { IRetryStrategy } from '../IRetryStrategy';
+export declare function resolveCache(client: ApiClient): ICache | null;
+export declare function resolveRateLimiter(client: ApiClient): IRateLimiter;
+export declare function resolveCircuitBreaker(client: ApiClient): ICircuitBreaker | null;
+export declare function resolveRetryStrategy(client: ApiClient): IRetryStrategy;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/core/requestPipeline/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,CAUlE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,GAChB,eAAe,GAAG,IAAI,CAExB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAKtE"}

package/dist/core/requestPipeline/fetchExecution.d.ts

@@ -0,0 +1,28 @@
+import { ApiClient } from '../ApiClient';
+import { ParsedHeaders } from '../util/headersUtil';
+import { ICache } from '../cache/ICache';
+import { IRateLimiter } from '../rateLimiter/IRateLimiter';
+import { ICircuitBreaker } from '../circuitBreaker/ICircuitBreaker';
+export interface RawFetchResult {
+    response: Response;
+    parsed: ParsedHeaders;
+    url: string;
+}
+export interface SingleFetchResult {
+    data: unknown;
+    parsed: ParsedHeaders;
+    url: string;
+}
+/**
+ * Execute a single HTTP fetch with rate limiting, circuit breaker, and timeout.
+ */
+export declare function executeSingleFetch(client: ApiClient, endpoint: string, method: string, body: unknown, requiresAuth: boolean, useETag: boolean, resolveCache: (client: ApiClient) => ICache | null, resolveRateLimiter: (client: ApiClient) => IRateLimiter, resolveCircuitBreaker: (client: ApiClient) => ICircuitBreaker | null, requestTimeout?: number, templatePath?: string): Promise<RawFetchResult>;
+/**
+ * Parse a JSON response body, throwing on parse failure.
+ */
+export declare function parseJsonBody(response: Response, _url: string): Promise<unknown>;
+/**
+ * Fetch a single page: execute the fetch, check for errors, parse JSON.
+ */
+export declare function fetchOnePage(client: ApiClient, endpoint: string, method: string, body: unknown, requiresAuth: boolean, useETag: boolean, resolveCache: (client: ApiClient) => ICache | null, resolveRateLimiter: (client: ApiClient) => IRateLimiter, resolveCircuitBreaker: (client: ApiClient) => ICircuitBreaker | null, requestTimeout?: number, templatePath?: string): Promise<SingleFetchResult>;
+//# sourceMappingURL=fetchExecution.d.ts.map

package/dist/core/requestPipeline/fetchExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchExecution.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/fetchExecution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAgB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAMpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,EAClD,kBAAkB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,YAAY,EACvD,qBAAqB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,eAAe,GAAG,IAAI,EACpE,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,CAAC,CAoGzB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,EAClD,kBAAkB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,YAAY,EACvD,qBAAqB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,eAAe,GAAG,IAAI,EACpE,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA0B5B"}

package/dist/core/requestPipeline/headers.d.ts

@@ -0,0 +1,11 @@
+import { ApiClient } from '../ApiClient';
+import { ICache } from '../cache/ICache';
+/**
+ * Parse Cache-Control header to extract max-age TTL in milliseconds.
+ */
+export declare const parseCacheControlTtl: (headers: Record<string, string>) => number | undefined;
+/**
+ * Build the request headers for an ESI API call.
+ */
+export declare function buildRequestHeaders(client: ApiClient, url: string, method: string, requiresAuth: boolean, useETag: boolean, body: unknown, resolveCache: (client: ApiClient) => ICache | null): HeadersInit;
+//# sourceMappingURL=headers.d.ts.map

package/dist/core/requestPipeline/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,MAAM,GAAG,SAKX,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,GACjD,WAAW,CAsCb"}

package/dist/core/requestPipeline/index.d.ts

@@ -0,0 +1,10 @@
+export { buildRequestHeaders, parseCacheControlTtl } from './headers';
+export { lookupSpecTtl, trySpecAwareCacheHit, tryStaleCacheResponse, cacheResponse, } from './cachePolicy';
+export type { EsiHandlerResponse } from './cachePolicy';
+export { STATUS_MESSAGES, handleEarlyStatus, handleErrorResponse, wrapError, } from './statusHandling';
+export { handleCursorPagination, handleOffsetPagination, } from './paginationOrchestration';
+export { applyRequestMiddleware, applyResponseInterceptors, } from './middlewareBridge';
+export { executeSingleFetch, fetchOnePage, parseJsonBody, } from './fetchExecution';
+export type { RawFetchResult, SingleFetchResult } from './fetchExecution';
+export { resolveCache, resolveRateLimiter, resolveCircuitBreaker, resolveRetryStrategy, } from './dependencies';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/requestPipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/core/requestPipeline/middlewareBridge.d.ts

@@ -0,0 +1,15 @@
+import { ApiClient } from '../ApiClient';
+import { EsiHandlerResponse } from './cachePolicy';
+/**
+ * Apply request interceptors from the middleware pipeline.
+ */
+export declare function applyRequestMiddleware(client: ApiClient, url: string, endpoint: string, method: string, headers: Record<string, string>, body: unknown): Promise<{
+    url: string;
+    headers: Record<string, string>;
+    body: unknown;
+}>;
+/**
+ * Apply response interceptors from the middleware pipeline.
+ */
+export declare function applyResponseInterceptors(client: ApiClient, result: EsiHandlerResponse, url: string, endpoint: string, method: string, startTime: number): Promise<EsiHandlerResponse>;
+//# sourceMappingURL=middlewareBridge.d.ts.map

package/dist/core/requestPipeline/middlewareBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareBridge.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/middlewareBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAkB1E;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAqB7B"}

package/dist/core/requestPipeline/paginationOrchestration.d.ts

@@ -0,0 +1,15 @@
+import { ApiClient } from '../ApiClient';
+import { ParsedHeaders } from '../util/headersUtil';
+import { PageFetcher } from '../pagination/PaginationHandler';
+import { ICache } from '../cache/ICache';
+import { EsiHandlerResponse } from './cachePolicy';
+/**
+ * Handle cursor-based pagination. Returns null if the response
+ * does not contain cursor pagination headers.
+ */
+export declare function handleCursorPagination(parsed: ParsedHeaders, data: unknown): EsiHandlerResponse | null;
+/**
+ * Handle offset-based pagination. Fetches remaining pages if xPages > 1.
+ */
+export declare function handleOffsetPagination(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, parsed: ParsedHeaders, data: unknown, body: unknown, url: string, useETag: boolean, pageFetch: PageFetcher, resolveCache: (client: ApiClient) => ICache | null, templatePath?: string): Promise<EsiHandlerResponse>;
+//# sourceMappingURL=paginationOrchestration.d.ts.map

package/dist/core/requestPipeline/paginationOrchestration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginationOrchestration.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/paginationOrchestration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAEL,WAAW,EACZ,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAiB,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAElE;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,OAAO,GACZ,kBAAkB,GAAG,IAAI,CAS3B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,EAClD,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,kBAAkB,CAAC,CA2D7B"}

package/dist/core/requestPipeline/statusHandling.d.ts

@@ -0,0 +1,18 @@
+import { ApiClient } from '../ApiClient';
+import { ICache } from '../cache/ICache';
+import { ParsedHeaders } from '../util/headersUtil';
+import { EsiHandlerResponse } from './cachePolicy';
+export declare const STATUS_MESSAGES: Record<number, string>;
+/**
+ * Handle early-return HTTP statuses (201, 204, 304).
+ */
+export declare function handleEarlyStatus(client: ApiClient, status: number, url: string, parsed: ParsedHeaders, useETag: boolean, resolveCache: (client: ApiClient) => ICache | null): EsiHandlerResponse | null;
+/**
+ * Handle error HTTP responses (4xx, 5xx). May serve stale cache on 5xx.
+ */
+export declare function handleErrorResponse(client: ApiClient, response: Response, url: string, parsed: ParsedHeaders, useETag: boolean, resolveCache: (client: ApiClient) => ICache | null): EsiHandlerResponse | never;
+/**
+ * Wrap an unknown error into an EsiError or rethrow known errors.
+ */
+export declare function wrapError(error: unknown): never;
+//# sourceMappingURL=statusHandling.d.ts.map

package/dist/core/requestPipeline/statusHandling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusHandling.d.ts","sourceRoot":"","sources":["../../../src/core/requestPipeline/statusHandling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,EAAyB,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE1E,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAelD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,GACjD,kBAAkB,GAAG,IAAI,CAkC3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,GACjD,kBAAkB,GAAG,KAAK,CA0B5B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAU/C"}

package/dist/core/util/error.d.ts

@@ -1,3 +1,4 @@
+export declare function sanitizeUrl(url?: string): string | undefined;
 export declare class EsiError extends Error {
     readonly statusCode: number;
     readonly requestId?: string | undefined;
@@ -23,10 +24,14 @@ export declare class TimeoutError extends EsiError {
 }
 export declare function isTimeout(error: unknown): error is TimeoutError;
 export declare function isRetryable(error: unknown): error is EsiError;
+import { CircuitOpenError } from '../circuitBreaker/CircuitBreaker';
+export declare function isCircuitOpen(error: unknown): error is CircuitOpenError;
 export declare const buildError: (message: string, type?: string, url?: string) => Error;
+export type ValidationDirection = 'request' | 'response';
 export declare class EsiValidationError extends EsiError {
     readonly validationError: unknown;
-    constructor(url: string, zodError: unknown, requestId?: string);
+    readonly direction: ValidationDirection;
+    constructor(url: string, zodError: unknown, requestId?: string, direction?: ValidationDirection);
 }
 export declare function isValidationError(error: unknown): error is EsiValidationError;
 //# sourceMappingURL=error.d.ts.map

package/dist/core/util/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/core/util/error.ts"],"names":[],"mappings":"AAiBA,qBAAa,QAAS,SAAQ,KAAK;aAIf,UAAU,EAAE,MAAM;aAGlB,SAAS,CAAC,EAAE,MAAM;IANpC,SAAgB,GAAG,CAAC,EAAE,MAAM,CAAC;gBAGX,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACI,SAAS,CAAC,EAAE,MAAM,YAAA;IAOpC,aAAa,IAAI,OAAO;IAIxB,UAAU,IAAI,OAAO;IAIrB,cAAc,IAAI,OAAO;IAIzB,WAAW,IAAI,OAAO;IAItB,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,OAAO;IAIpB,IAAI,SAAS,IAAI,OAAO,CASvB;CACF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE7D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE/D;AAED,qBAAa,YAAa,SAAQ,QAAQ;aAEtB,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EACjC,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM;CAKrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE7D;AAED,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAM,MAAgB,EACtB,MAAM,MAAM,KACX,KAMF,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAgB,eAAe,EAAE,OAAO,CAAC;gBAE7B,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;CAK/D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAE7E"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/core/util/error.ts"],"names":[],"mappings":"AAcA,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAc5D;AAED,qBAAa,QAAS,SAAQ,KAAK;aAIf,UAAU,EAAE,MAAM;aAGlB,SAAS,CAAC,EAAE,MAAM;IANpC,SAAgB,GAAG,CAAC,EAAE,MAAM,CAAC;gBAGX,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACI,SAAS,CAAC,EAAE,MAAM,YAAA;IAOpC,aAAa,IAAI,OAAO;IAIxB,UAAU,IAAI,OAAO;IAIrB,cAAc,IAAI,OAAO;IAIzB,WAAW,IAAI,OAAO;IAItB,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,OAAO;IAIpB,IAAI,SAAS,IAAI,OAAO,CASvB;CACF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE7D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE/D;AAED,qBAAa,YAAa,SAAQ,QAAQ;aAEtB,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EACjC,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM;CAKrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE7D;AAID,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAEvE;AAED,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAM,MAAgB,EACtB,MAAM,MAAM,KACX,KAMF,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,SAAS,EAAE,mBAAmB,CAAC;gBAG7C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,GAAE,mBAAgC;CAS9C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAE7E"}

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+export { EsiError, TimeoutError, EsiValidationError, isEsiError, isRateLimited, isNotFound, isUnauthorized, isForbidden, isServerError, isTimeout, isRetryable, isValidationError, sanitizeUrl, } from './core/util/error';
+export type { ValidationDirection } from './core/util/error';
+export { CircuitOpenError } from './core/circuitBreaker/CircuitBreaker';
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/errors.js

@@ -0,0 +1,196 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/errors.ts
+var errors_exports = {};
+__export(errors_exports, {
+  CircuitOpenError: () => CircuitOpenError,
+  EsiError: () => EsiError,
+  EsiValidationError: () => EsiValidationError,
+  TimeoutError: () => TimeoutError,
+  isEsiError: () => isEsiError,
+  isForbidden: () => isForbidden,
+  isNotFound: () => isNotFound,
+  isRateLimited: () => isRateLimited,
+  isRetryable: () => isRetryable,
+  isServerError: () => isServerError,
+  isTimeout: () => isTimeout,
+  isUnauthorized: () => isUnauthorized,
+  isValidationError: () => isValidationError,
+  sanitizeUrl: () => sanitizeUrl
+});
+module.exports = __toCommonJS(errors_exports);
+
+// src/core/logger/logger.ts
+var import_pino = __toESM(require("pino"));
+var pinoLogger = (0, import_pino.default)({ level: process.env.ESI_LOG_LEVEL || "warn" });
+
+// src/core/circuitBreaker/CircuitBreaker.ts
+var CircuitOpenError = class extends Error {
+  endpoint;
+  failures;
+  retryAfterMs;
+  constructor(endpoint, failures, retryAfterMs) {
+    super(
+      `Circuit breaker open for ${endpoint} after ${failures} failures (retry after ${Math.ceil(retryAfterMs / 1e3)}s)`
+    );
+    this.name = "CircuitOpenError";
+    this.endpoint = endpoint;
+    this.failures = failures;
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+
+// src/core/util/error.ts
+var SENSITIVE_PARAMS = [
+  "token",
+  "access_token",
+  "api_key",
+  "refresh_token",
+  "client_secret",
+  "code",
+  "key",
+  "secret",
+  "auth",
+  "password",
+  "bearer"
+];
+function sanitizeUrl(url) {
+  if (!url) return url;
+  try {
+    const parsed = new URL(url);
+    for (const param of SENSITIVE_PARAMS) {
+      if (parsed.searchParams.has(param)) {
+        parsed.searchParams.set(param, "[REDACTED]");
+      }
+    }
+    return parsed.toString();
+  } catch {
+    const qIndex = url.indexOf("?");
+    return qIndex >= 0 ? url.substring(0, qIndex) + "?[params-redacted]" : url;
+  }
+}
+var EsiError = class extends Error {
+  constructor(statusCode, message, url, requestId) {
+    super(message);
+    this.statusCode = statusCode;
+    this.requestId = requestId;
+    this.name = "EsiError";
+    this.url = sanitizeUrl(url);
+  }
+  statusCode;
+  requestId;
+  url;
+  isRateLimited() {
+    return this.statusCode === 420 || this.statusCode === 429;
+  }
+  isNotFound() {
+    return this.statusCode === 404;
+  }
+  isUnauthorized() {
+    return this.statusCode === 401;
+  }
+  isForbidden() {
+    return this.statusCode === 403;
+  }
+  isServerError() {
+    return this.statusCode >= 500;
+  }
+  isTimeout() {
+    return this.statusCode === 0;
+  }
+  get retryable() {
+    return this.statusCode === 0 || this.statusCode === 420 || this.statusCode === 429 || this.statusCode === 502 || this.statusCode === 503 || this.statusCode === 504;
+  }
+};
+function isEsiError(error) {
+  return error instanceof EsiError;
+}
+function isRateLimited(error) {
+  return error instanceof EsiError && error.isRateLimited();
+}
+function isNotFound(error) {
+  return error instanceof EsiError && error.isNotFound();
+}
+function isUnauthorized(error) {
+  return error instanceof EsiError && error.isUnauthorized();
+}
+function isForbidden(error) {
+  return error instanceof EsiError && error.isForbidden();
+}
+function isServerError(error) {
+  return error instanceof EsiError && error.isServerError();
+}
+var TimeoutError = class extends EsiError {
+  constructor(timeoutMs, url, requestId) {
+    super(0, `Request timed out after ${timeoutMs}ms`, url, requestId);
+    this.timeoutMs = timeoutMs;
+    this.name = "TimeoutError";
+  }
+  timeoutMs;
+};
+function isTimeout(error) {
+  return error instanceof TimeoutError;
+}
+function isRetryable(error) {
+  return error instanceof EsiError && error.retryable;
+}
+var EsiValidationError = class extends EsiError {
+  validationError;
+  direction;
+  constructor(url, zodError, requestId, direction = "response") {
+    const safeUrl = sanitizeUrl(url) ?? url;
+    const label = direction === "request" ? "Request body" : "Response";
+    super(0, `${label} validation failed for ${safeUrl}`, url, requestId);
+    this.name = "EsiValidationError";
+    this.validationError = zodError;
+    this.direction = direction;
+  }
+};
+function isValidationError(error) {
+  return error instanceof EsiValidationError;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CircuitOpenError,
+  EsiError,
+  EsiValidationError,
+  TimeoutError,
+  isEsiError,
+  isForbidden,
+  isNotFound,
+  isRateLimited,
+  isRetryable,
+  isServerError,
+  isTimeout,
+  isUnauthorized,
+  isValidationError,
+  sanitizeUrl
+});
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/core/logger/logger.ts","../src/core/circuitBreaker/CircuitBreaker.ts","../src/core/util/error.ts"],"sourcesContent":["export {\n  EsiError,\n  TimeoutError,\n  EsiValidationError,\n  isEsiError,\n  isRateLimited,\n  isNotFound,\n  isUnauthorized,\n  isForbidden,\n  isServerError,\n  isTimeout,\n  isRetryable,\n  isValidationError,\n  sanitizeUrl,\n} from './core/util/error';\nexport type { ValidationDirection } from './core/util/error';\n\nexport { CircuitOpenError } from './core/circuitBreaker/CircuitBreaker';\n","import pino from 'pino';\nimport { ILogger } from './ILogger';\n\nconst pinoLogger = pino({ level: process.env.ESI_LOG_LEVEL || 'warn' });\n\nconst logger: ILogger = {\n  info: (msg: string) => {\n    pinoLogger.info(msg);\n  },\n  warn: (msg: string) => {\n    pinoLogger.warn(msg);\n  },\n  error: (msg: string) => {\n    pinoLogger.error(msg);\n  },\n  debug: (msg: string) => {\n    pinoLogger.debug(msg);\n  },\n};\n\nexport default logger;\n","import { logWarn, logInfo } from '../logger/loggerUtil';\nimport { ICircuitBreaker } from './ICircuitBreaker';\n\nexport type CircuitState = 'closed' | 'open' | 'half-open';\n\nexport interface CircuitBreakerConfig {\n  failureThreshold?: number;\n  resetTimeoutMs?: number;\n  halfOpenMaxAttempts?: number;\n  staleThresholdMs?: number;\n  /** 'resolved' (default, current behavior) | 'template' (group by endpoint template path) */\n  keyStrategy?: 'resolved' | 'template';\n  /** Interval in ms for automatic cleanup of stale circuits. 0 or undefined disables. Recommended value: staleThresholdMs. */\n  cleanupIntervalMs?: number;\n}\n\ninterface CircuitRecord {\n  state: CircuitState;\n  failures: number;\n  lastFailureTime: number;\n  halfOpenAttempts: number;\n}\n\nexport class CircuitBreaker implements ICircuitBreaker {\n  private circuits: Map<string, CircuitRecord> = new Map();\n  private readonly failureThreshold: number;\n  private readonly resetTimeoutMs: number;\n  private readonly halfOpenMaxAttempts: number;\n  private readonly staleThresholdMs: number;\n  private readonly keyStrategy: 'resolved' | 'template';\n  private cleanupTimer: ReturnType<typeof setInterval> | null = null;\n\n  constructor(config: CircuitBreakerConfig = {}) {\n    this.failureThreshold = config.failureThreshold ?? 5;\n    this.resetTimeoutMs = config.resetTimeoutMs ?? 30_000;\n    this.halfOpenMaxAttempts = config.halfOpenMaxAttempts ?? 1;\n    this.staleThresholdMs = config.staleThresholdMs ?? 3_600_000;\n    this.keyStrategy = config.keyStrategy ?? 'resolved';\n\n    const cleanupIntervalMs = config.cleanupIntervalMs;\n    if (cleanupIntervalMs !== undefined && cleanupIntervalMs > 0) {\n      this.startCleanupTimer(cleanupIntervalMs);\n    }\n  }\n\n  private getKey(endpoint: string): string {\n    return endpoint.split('?')[0]!;\n  }\n\n  private getOrCreate(key: string): CircuitRecord {\n    let record = this.circuits.get(key);\n    if (!record) {\n      record = {\n        state: 'closed',\n        failures: 0,\n        lastFailureTime: 0,\n        halfOpenAttempts: 0,\n      };\n      this.circuits.set(key, record);\n    }\n    return record;\n  }\n\n  checkCircuit(endpoint: string): void {\n    const key = this.getKey(endpoint);\n    const record = this.getOrCreate(key);\n\n    if (record.state === 'closed') return;\n\n    if (record.state === 'open') {\n      const elapsed = Date.now() - record.lastFailureTime;\n      if (elapsed >= this.resetTimeoutMs) {\n        record.state = 'half-open';\n        record.halfOpenAttempts = 0;\n        logInfo(`Circuit half-open for ${key}, allowing probe request`);\n        return;\n      }\n      const remainingMs = this.resetTimeoutMs - elapsed;\n      throw new CircuitOpenError(key, record.failures, remainingMs);\n    }\n\n    if (record.state === 'half-open') {\n      if (record.halfOpenAttempts >= this.halfOpenMaxAttempts) {\n        throw new CircuitOpenError(key, record.failures, this.resetTimeoutMs);\n      }\n      record.halfOpenAttempts++;\n    }\n  }\n\n  recordSuccess(endpoint: string): void {\n    const key = this.getKey(endpoint);\n    const record = this.circuits.get(key);\n    if (!record) return;\n\n    if (record.state === 'half-open') {\n      logInfo(`Circuit closed for ${key} after successful probe`);\n    }\n\n    record.state = 'closed';\n    record.failures = 0;\n    record.halfOpenAttempts = 0;\n  }\n\n  recordFailure(endpoint: string, statusCode: number): void {\n    // statusCode 0 = network/timeout; 420/429 = rate limited; >=500 = server errors\n    if (\n      statusCode !== 0 &&\n      statusCode < 500 &&\n      statusCode !== 420 &&\n      statusCode !== 429\n    ) {\n      return;\n    }\n\n    const key = this.getKey(endpoint);\n    const record = this.getOrCreate(key);\n\n    record.failures++;\n    record.lastFailureTime = Date.now();\n\n    if (record.state === 'half-open') {\n      record.state = 'open';\n      logWarn(\n        `Circuit re-opened for ${key} after failed probe (${record.failures} failures)`,\n      );\n      return;\n    }\n\n    if (record.failures >= this.failureThreshold) {\n      record.state = 'open';\n      logWarn(\n        `Circuit opened for ${key} after ${record.failures} consecutive failures`,\n      );\n    }\n  }\n\n  getState(endpoint: string): CircuitState {\n    const key = this.getKey(endpoint);\n    const record = this.circuits.get(key);\n    if (!record) return 'closed';\n\n    if (record.state === 'open') {\n      const elapsed = Date.now() - record.lastFailureTime;\n      if (elapsed >= this.resetTimeoutMs) {\n        return 'half-open';\n      }\n    }\n\n    return record.state;\n  }\n\n  getStats(): {\n    totalCircuits: number;\n    openCircuits: number;\n    circuits: Record<string, { state: CircuitState; failures: number }>;\n  } {\n    const circuits: Record<string, { state: CircuitState; failures: number }> =\n      {};\n    let openCircuits = 0;\n\n    for (const [key, record] of this.circuits.entries()) {\n      const state = this.getState(key);\n      // eslint-disable-next-line security/detect-object-injection\n      circuits[key] = { state, failures: record.failures };\n      if (state === 'open') openCircuits++;\n    }\n\n    return {\n      totalCircuits: this.circuits.size,\n      openCircuits,\n      circuits,\n    };\n  }\n\n  reset(endpoint?: string): void {\n    if (endpoint) {\n      this.circuits.delete(this.getKey(endpoint));\n    } else {\n      this.circuits.clear();\n    }\n  }\n\n  cleanup(): number {\n    const now = Date.now();\n    let cleaned = 0;\n    for (const [key, record] of this.circuits.entries()) {\n      if (\n        record.state === 'closed' &&\n        record.failures === 0 &&\n        record.lastFailureTime > 0 &&\n        now - record.lastFailureTime > this.staleThresholdMs\n      ) {\n        this.circuits.delete(key);\n        cleaned++;\n      }\n    }\n    if (cleaned > 0) {\n      logInfo(`Circuit breaker cleanup: removed ${cleaned} stale circuits`);\n    }\n    return cleaned;\n  }\n\n  getKeyStrategy(): 'resolved' | 'template' {\n    return this.keyStrategy;\n  }\n\n  destroy(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = null;\n    }\n    this.circuits.clear();\n  }\n\n  shutdown(): void {\n    this.destroy();\n  }\n\n  private startCleanupTimer(intervalMs: number): void {\n    this.cleanupTimer = setInterval(() => {\n      this.cleanup();\n    }, intervalMs);\n    // Don't prevent process exit (important for test runners and CLI tools)\n    this.cleanupTimer.unref();\n  }\n}\n\nexport class CircuitOpenError extends Error {\n  readonly endpoint: string;\n  readonly failures: number;\n  readonly retryAfterMs: number;\n\n  constructor(endpoint: string, failures: number, retryAfterMs: number) {\n    super(\n      `Circuit breaker open for ${endpoint} after ${failures} failures (retry after ${Math.ceil(retryAfterMs / 1000)}s)`,\n    );\n    this.name = 'CircuitOpenError';\n    this.endpoint = endpoint;\n    this.failures = failures;\n    this.retryAfterMs = retryAfterMs;\n  }\n}\n","const SENSITIVE_PARAMS = [\n  'token',\n  'access_token',\n  'api_key',\n  'refresh_token',\n  'client_secret',\n  'code',\n  'key',\n  'secret',\n  'auth',\n  'password',\n  'bearer',\n];\n\nexport function sanitizeUrl(url?: string): string | undefined {\n  if (!url) return url;\n  try {\n    const parsed = new URL(url);\n    for (const param of SENSITIVE_PARAMS) {\n      if (parsed.searchParams.has(param)) {\n        parsed.searchParams.set(param, '[REDACTED]');\n      }\n    }\n    return parsed.toString();\n  } catch {\n    const qIndex = url.indexOf('?');\n    return qIndex >= 0 ? url.substring(0, qIndex) + '?[params-redacted]' : url;\n  }\n}\n\nexport class EsiError extends Error {\n  public readonly url?: string;\n\n  constructor(\n    public readonly statusCode: number,\n    message: string,\n    url?: string,\n    public readonly requestId?: string,\n  ) {\n    super(message);\n    this.name = 'EsiError';\n    this.url = sanitizeUrl(url);\n  }\n\n  isRateLimited(): boolean {\n    return this.statusCode === 420 || this.statusCode === 429;\n  }\n\n  isNotFound(): boolean {\n    return this.statusCode === 404;\n  }\n\n  isUnauthorized(): boolean {\n    return this.statusCode === 401;\n  }\n\n  isForbidden(): boolean {\n    return this.statusCode === 403;\n  }\n\n  isServerError(): boolean {\n    return this.statusCode >= 500;\n  }\n\n  isTimeout(): boolean {\n    return this.statusCode === 0;\n  }\n\n  get retryable(): boolean {\n    return (\n      this.statusCode === 0 ||\n      this.statusCode === 420 ||\n      this.statusCode === 429 ||\n      this.statusCode === 502 ||\n      this.statusCode === 503 ||\n      this.statusCode === 504\n    );\n  }\n}\n\nexport function isEsiError(error: unknown): error is EsiError {\n  return error instanceof EsiError;\n}\n\nexport function isRateLimited(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isRateLimited();\n}\n\nexport function isNotFound(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isNotFound();\n}\n\nexport function isUnauthorized(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isUnauthorized();\n}\n\nexport function isForbidden(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isForbidden();\n}\n\nexport function isServerError(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isServerError();\n}\n\nexport class TimeoutError extends EsiError {\n  constructor(\n    public readonly timeoutMs: number,\n    url?: string,\n    requestId?: string,\n  ) {\n    super(0, `Request timed out after ${timeoutMs}ms`, url, requestId);\n    this.name = 'TimeoutError';\n  }\n}\n\nexport function isTimeout(error: unknown): error is TimeoutError {\n  return error instanceof TimeoutError;\n}\n\nexport function isRetryable(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.retryable;\n}\n\n// Re-export CircuitOpenError for the type guard — avoid forcing consumers\n// to import from the circuitBreaker subpath just for error checking.\nimport { CircuitOpenError } from '../circuitBreaker/CircuitBreaker';\n\nexport function isCircuitOpen(error: unknown): error is CircuitOpenError {\n  return error instanceof CircuitOpenError;\n}\n\nexport const buildError = (\n  message: string,\n  type: string = 'ERROR',\n  url?: string,\n): Error => {\n  const error = new Error(`[${type}] ${message}`);\n  if (url) {\n    (error as Error & { url: string }).url = url;\n  }\n  return error;\n};\n\nexport type ValidationDirection = 'request' | 'response';\n\nexport class EsiValidationError extends EsiError {\n  public readonly validationError: unknown;\n  public readonly direction: ValidationDirection;\n\n  constructor(\n    url: string,\n    zodError: unknown,\n    requestId?: string,\n    direction: ValidationDirection = 'response',\n  ) {\n    const safeUrl = sanitizeUrl(url) ?? url;\n    const label = direction === 'request' ? 'Request body' : 'Response';\n    super(0, `${label} validation failed for ${safeUrl}`, url, requestId);\n    this.name = 'EsiValidationError';\n    this.validationError = zodError;\n    this.direction = direction;\n  }\n}\n\nexport function isValidationError(error: unknown): error is EsiValidationError {\n  return error instanceof EsiValidationError;\n}\n"],"mappings":"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","names":["pino"]}