@lgriffin/esi.ts 10.0.0 → 10.2.0

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

@@ -4,6 +4,17 @@ export declare class RequestDeduplicator implements IDeduplicator {
     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;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,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/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/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

package/dist/core/circuitBreaker/CircuitBreaker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CircuitBreaker.d.ts","sourceRoot":"","sources":["../../../src/core/circuitBreaker/CircuitBreaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACtC,4HAA4H;IAC5H,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,MAAM,CAA0B;IAExC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;gBAI7B,MAAM,GAAE,oBAAyB;IAa7C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,WAAW;IAcnB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA8BpC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBrC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAqCzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAexC,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,YAAY,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrE;IAmBD,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9B,OAAO,IAAI,MAAM;IA0BjB,cAAc,IAAI,UAAU,GAAG,UAAU;IAIzC,OAAO,IAAI,IAAI;IAQf,QAAQ,IAAI,IAAI;IAIhB,OAAO,CAAC,iBAAiB;CAO1B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CASrE"}
+{"version":3,"file":"CircuitBreaker.d.ts","sourceRoot":"","sources":["../../../src/core/circuitBreaker/CircuitBreaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACtC,4HAA4H;IAC5H,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,MAAM,CAA0B;IAExC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;gBAI7B,MAAM,GAAE,oBAAyB;IAa7C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,WAAW;IAcnB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA+BpC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAoBrC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAqCzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAexC,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,YAAY,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrE;IAmBD,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9B,OAAO,IAAI,MAAM;IA0BjB,cAAc,IAAI,UAAU,GAAG,UAAU;IAIzC,OAAO,IAAI,IAAI;IAQf,QAAQ,IAAI,IAAI;IAIhB,OAAO,CAAC,iBAAiB;CAO1B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CASrE"}

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

@@ -0,0 +1,23 @@
+import { CircuitState } from './CircuitBreaker.mjs';
+export interface ICircuitBreaker {
+    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;
+    shutdown(): void;
+    /** Release resources (timers). Optional for backward compatibility. */
+    destroy?(): void;
+    /** Returns the configured key strategy. Optional for backward compatibility. */
+    getKeyStrategy?(): 'resolved' | 'template';
+}
+//# sourceMappingURL=ICircuitBreaker.d.ts.map

package/dist/core/configureApiClient.d.mts

@@ -0,0 +1,18 @@
+import { ApiClient } from './ApiClient.mjs';
+import { RequestDeduplicator } from './RequestDeduplicator.mjs';
+import type { EsiClientConfig } from '../EsiClient.mjs';
+export interface ConfigureApiClientResult {
+    deduplicator: RequestDeduplicator | null;
+}
+/**
+ * Configures an existing ApiClient with the full middleware stack
+ * based on an EsiClientConfig. This is the single source of truth
+ * for how config maps to middleware — used by EsiClient,
+ * CustomEsiClient, and EsiApiFactory.
+ *
+ * The caller is responsible for creating the ApiClient (with baseUrl,
+ * clientId, accessToken) and setting datasource/language/tokenProvider
+ * before calling this function, since those vary by construction surface.
+ */
+export declare function configureApiClient(client: ApiClient, config?: EsiClientConfig): ConfigureApiClientResult;
+//# sourceMappingURL=configureApiClient.d.ts.map

package/dist/core/constants.d.ts

@@ -1,5 +1,5 @@
 export declare const PACKAGE_NAME = "esi.ts";
-export declare const PACKAGE_VERSION = "10.0.0";
-export declare const USER_AGENT = "esi.ts/10.0.0";
+export declare const PACKAGE_VERSION = "10.2.0";
+export declare const USER_AGENT = "esi.ts/10.2.0";
 export declare const COMPATIBILITY_DATE = "2026-05-19";
 //# sourceMappingURL=constants.d.ts.map

package/dist/core/endpoints/EndpointDefinition.d.mts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+export interface DeprecationInfo {
+    message?: string;
+    replacedBy?: string;
+    sunsetDate?: string;
+}
+export interface EndpointDefinition {
+    /** URL template with placeholders, e.g. 'alliances/{allianceId}/' */
+    path: string;
+    /** HTTP method */
+    method: HttpMethod;
+    /** Whether the endpoint requires an auth token */
+    requiresAuth: boolean;
+    /** Path parameter names in method signature order */
+    pathParams?: readonly string[];
+    /** Maps method param name to query string key, e.g. { typeId: 'type_id' } */
+    queryParams?: Record<string, string>;
+    /** Whether the method accepts a body parameter (for POST/PUT/DELETE) */
+    hasBody?: boolean;
+    /** Custom body builder for endpoints that construct body from individual params */
+    bodyBuilder?: (...args: any[]) => unknown;
+    /** Whether this endpoint uses cursor-based pagination (before/after tokens) */
+    cursorPagination?: boolean;
+    /** Mark an endpoint as deprecated with optional migration guidance */
+    deprecated?: DeprecationInfo;
+    /** Zod schema for runtime response validation */
+    responseSchema?: z.ZodType;
+    /** Zod schema for runtime request body validation (opt-in via validateRequest) */
+    requestSchema?: z.ZodType;
+}
+export type EndpointMap = Record<string, EndpointDefinition>;
+/** Convert a readonly string tuple to a tuple of number | string (one per path param) */
+type PathParamArgs<P> = P extends readonly [
+    unknown,
+    ...infer Rest extends readonly unknown[]
+] ? [number | string, ...PathParamArgs<Rest>] : [];
+/** Compute the method parameter tuple from an endpoint definition */
+export type EndpointArgs<D> = D extends {
+    pathParams: infer P extends readonly string[];
+} ? D extends {
+    bodyBuilder: (...args: infer BA) => unknown;
+} ? D extends {
+    queryParams: Record<string, string>;
+} ? [
+    ...PathParamArgs<P>,
+    ...(string | number | boolean | undefined)[],
+    ...BA
+] : [...PathParamArgs<P>, ...BA] : D extends {
+    hasBody: true;
+} ? [...PathParamArgs<P>, body: object] : D extends {
+    queryParams: Record<string, string>;
+} ? [...PathParamArgs<P>, ...(string | number | boolean | undefined)[]] : PathParamArgs<P> : D extends {
+    bodyBuilder: (...args: infer BA) => unknown;
+} ? D extends {
+    queryParams: Record<string, string>;
+} ? [...(string | number | boolean | undefined)[], ...BA] : BA : D extends {
+    hasBody: true;
+} ? [body: object] : D extends {
+    queryParams: Record<string, string>;
+} ? (string | number | boolean | undefined)[] : [];
+export {};
+//# sourceMappingURL=EndpointDefinition.d.ts.map

package/dist/core/endpoints/accessListEndpoints.d.mts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const accessListEndpoints: {
+    readonly getAccessList: {
+        readonly path: "characters/{characterId}/access-lists/{accessListId}";
+        readonly method: "GET";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["characterId", "accessListId"];
+        readonly responseSchema: z.ZodObject<{
+            access_list_id: z.ZodNumber;
+            name: z.ZodString;
+            entries: z.ZodArray<z.ZodObject<{
+                entity_id: z.ZodNumber;
+                entity_type: z.ZodType<(string & {}) | "character" | "corporation" | "alliance", unknown, z.core.$ZodTypeInternals<(string & {}) | "character" | "corporation" | "alliance", unknown>>;
+                access_type: z.ZodType<(string & {}) | "allowed" | "blocked", unknown, z.core.$ZodTypeInternals<(string & {}) | "allowed" | "blocked", unknown>>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+    };
+    readonly getCharacterAccessLists: {
+        readonly path: "characters/{characterId}/access-lists";
+        readonly method: "GET";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["characterId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            access_list_id: z.ZodNumber;
+            name: z.ZodString;
+            entries: z.ZodArray<z.ZodObject<{
+                entity_id: z.ZodNumber;
+                entity_type: z.ZodType<(string & {}) | "character" | "corporation" | "alliance", unknown, z.core.$ZodTypeInternals<(string & {}) | "character" | "corporation" | "alliance", unknown>>;
+                access_type: z.ZodType<(string & {}) | "allowed" | "blocked", unknown, z.core.$ZodTypeInternals<(string & {}) | "allowed" | "blocked", unknown>>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+    };
+};
+//# sourceMappingURL=accessListEndpoints.d.ts.map

package/dist/core/endpoints/allianceEndpoints.d.mts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export declare const allianceEndpoints: {
+    readonly getAllianceById: {
+        readonly path: "alliances/{allianceId}/";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+        readonly pathParams: readonly ["allianceId"];
+        readonly responseSchema: z.ZodObject<{
+            alliance_id: z.ZodOptional<z.ZodNumber>;
+            name: z.ZodString;
+            ticker: z.ZodString;
+            creator_id: z.ZodNumber;
+            creator_corporation_id: z.ZodNumber;
+            executor_corporation_id: z.ZodOptional<z.ZodNumber>;
+            date_founded: z.ZodString;
+            faction_id: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>;
+    };
+    readonly getCorporations: {
+        readonly path: "alliances/{allianceId}/corporations/";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+        readonly pathParams: readonly ["allianceId"];
+        readonly responseSchema: z.ZodArray<z.ZodNumber>;
+    };
+    readonly getIcons: {
+        readonly path: "alliances/{allianceId}/icons/";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+        readonly pathParams: readonly ["allianceId"];
+        readonly responseSchema: z.ZodObject<{
+            px64x64: z.ZodOptional<z.ZodString>;
+            px128x128: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+    };
+    readonly getAlliances: {
+        readonly path: "alliances";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+        readonly responseSchema: z.ZodArray<z.ZodNumber>;
+    };
+};
+//# sourceMappingURL=allianceEndpoints.d.ts.map

package/dist/core/endpoints/assetEndpoints.d.mts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export declare const assetEndpoints: {
+    readonly getCharacterAssets: {
+        readonly path: "characters/{characterId}/assets/";
+        readonly method: "GET";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["characterId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            item_id: z.ZodNumber;
+            type_id: z.ZodNumber;
+            quantity: z.ZodNumber;
+            location_id: z.ZodNumber;
+            location_type: z.ZodType<(string & {}) | "other" | "solar_system" | "station" | "item", unknown, z.core.$ZodTypeInternals<(string & {}) | "other" | "solar_system" | "station" | "item", unknown>>;
+            location_flag: z.ZodString;
+            is_singleton: z.ZodBoolean;
+            is_blueprint_copy: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    };
+    readonly getCorporationAssets: {
+        readonly path: "corporations/{corporationId}/assets/";
+        readonly method: "GET";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["corporationId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            item_id: z.ZodNumber;
+            type_id: z.ZodNumber;
+            quantity: z.ZodNumber;
+            location_id: z.ZodNumber;
+            location_type: z.ZodType<(string & {}) | "other" | "solar_system" | "station" | "item", unknown, z.core.$ZodTypeInternals<(string & {}) | "other" | "solar_system" | "station" | "item", unknown>>;
+            location_flag: z.ZodString;
+            is_singleton: z.ZodBoolean;
+            is_blueprint_copy: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    };
+    readonly postCharacterAssetLocations: {
+        readonly path: "characters/{characterId}/assets/locations/";
+        readonly method: "POST";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["characterId"];
+        readonly bodyBuilder: (itemIds: number[]) => number[];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            item_id: z.ZodNumber;
+            position: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$loose>;
+        }, z.core.$loose>>;
+    };
+    readonly postCharacterAssetNames: {
+        readonly path: "characters/{characterId}/assets/names/";
+        readonly method: "POST";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["characterId"];
+        readonly bodyBuilder: (itemIds: number[]) => number[];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            item_id: z.ZodNumber;
+            name: z.ZodString;
+        }, z.core.$loose>>;
+    };
+    readonly postCorporationAssetLocations: {
+        readonly path: "corporations/{corporationId}/assets/locations/";
+        readonly method: "POST";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["corporationId"];
+        readonly bodyBuilder: (itemIds: number[]) => number[];
+    };
+    readonly postCorporationAssetNames: {
+        readonly path: "corporations/{corporationId}/assets/names/";
+        readonly method: "POST";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["corporationId"];
+        readonly bodyBuilder: (itemIds: number[]) => number[];
+    };
+};
+//# sourceMappingURL=assetEndpoints.d.ts.map

package/dist/core/endpoints/buildEndpointPath.d.mts

@@ -0,0 +1,7 @@
+import { EndpointDefinition } from './EndpointDefinition.mjs';
+export interface EndpointPathResult {
+    path: string;
+    body: unknown;
+}
+export declare function buildEndpointPath(def: EndpointDefinition, args: unknown[], datasource?: string): EndpointPathResult;
+//# sourceMappingURL=buildEndpointPath.d.ts.map