@lgriffin/esi.ts 2.0.0 → 5.0.0

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

@@ -0,0 +1,71 @@
+import { ICache, CacheEntry } from './ICache';
+export type { CacheEntry } from './ICache';
+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;
+    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.map

@@ -0,0 +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"}

package/dist/core/cache/ETagCacheManager.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ETagCacheManager = void 0;
+const loggerUtil_1 = require("../logger/loggerUtil");
+class ETagCacheManager {
+    cache = new Map();
+    config;
+    cleanupTimer;
+    hits = 0;
+    misses = 0;
+    constructor(config = {}) {
+        this.config = {
+            maxEntries: config.maxEntries ?? 1000,
+            defaultTtl: config.defaultTtl ?? 5 * 60 * 1000, // 5 minutes default
+            cleanupInterval: config.cleanupInterval ?? 60 * 1000, // 1 minute cleanup
+        };
+        this.startCleanupTimer();
+        (0, loggerUtil_1.logInfo)(`ETag cache manager initialized with ${this.config.maxEntries} max entries`);
+    }
+    /**
+     * Get cached data if ETag matches
+     */
+    get(url) {
+        const entry = this.cache.get(url);
+        if (!entry) {
+            this.misses++;
+            return null;
+        }
+        if (this.isExpired(entry)) {
+            this.cache.delete(url);
+            this.misses++;
+            (0, loggerUtil_1.logDebug)(`Cache entry expired for ${url}`);
+            return null;
+        }
+        this.hits++;
+        (0, loggerUtil_1.logDebug)(`Cache hit for ${url} with ETag ${entry.etag}`);
+        return entry;
+    }
+    /**
+     * Get ETag for a URL (for If-None-Match header)
+     */
+    getETag(url) {
+        const entry = this.get(url);
+        return entry ? entry.etag : null;
+    }
+    /**
+     * Set cache entry
+     */
+    set(url, etag, data, headers, customTtl) {
+        // Remove oldest entries if cache is full
+        if (this.cache.size >= this.config.maxEntries) {
+            this.evictOldest();
+        }
+        const entry = {
+            etag,
+            data,
+            headers,
+            timestamp: Date.now(),
+            ttl: customTtl ?? this.config.defaultTtl,
+        };
+        this.cache.set(url, entry);
+        (0, loggerUtil_1.logDebug)(`Cached response for ${url} with ETag ${etag}`);
+    }
+    /**
+     * Check if cached data exists and is valid
+     */
+    has(url) {
+        const entry = this.cache.get(url);
+        return entry !== undefined && !this.isExpired(entry);
+    }
+    /**
+     * Clear specific cache entry
+     */
+    delete(url) {
+        return this.cache.delete(url);
+    }
+    /**
+     * Delete all cache entries whose URL contains the given path segment
+     */
+    deleteByPath(pathSegment) {
+        let count = 0;
+        for (const key of this.cache.keys()) {
+            if (key.includes(pathSegment)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        if (count > 0) {
+            (0, loggerUtil_1.logDebug)(`Invalidated ${count} cache entries matching ${pathSegment}`);
+        }
+        return count;
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+        (0, loggerUtil_1.logInfo)('ETag cache cleared');
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        let oldest = Infinity;
+        let newest = -Infinity;
+        for (const entry of this.cache.values()) {
+            if (entry.timestamp < oldest)
+                oldest = entry.timestamp;
+            if (entry.timestamp > newest)
+                newest = entry.timestamp;
+        }
+        const total = this.hits + this.misses;
+        return {
+            totalEntries: this.cache.size,
+            maxEntries: this.config.maxEntries,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total > 0 ? this.hits / total : 0,
+            oldestEntry: this.cache.size > 0 ? oldest : null,
+            newestEntry: this.cache.size > 0 ? newest : null,
+        };
+    }
+    /**
+     * Update cache configuration
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+        (0, loggerUtil_1.logInfo)('ETag cache configuration updated');
+    }
+    /**
+     * Cleanup expired entries
+     */
+    cleanup() {
+        const beforeSize = this.cache.size;
+        for (const [url, entry] of this.cache.entries()) {
+            if (this.isExpired(entry)) {
+                this.cache.delete(url);
+            }
+        }
+        const cleanedCount = beforeSize - this.cache.size;
+        if (cleanedCount > 0) {
+            (0, loggerUtil_1.logDebug)(`Cleaned up ${cleanedCount} expired cache entries`);
+        }
+        return cleanedCount;
+    }
+    /**
+     * Shutdown cache manager
+     */
+    shutdown() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+        }
+        (0, loggerUtil_1.logInfo)('ETag cache manager shut down');
+    }
+    isExpired(entry) {
+        if (!entry.ttl)
+            return false;
+        return Date.now() - entry.timestamp > entry.ttl;
+    }
+    evictOldest() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.timestamp < oldestTime) {
+                oldestTime = entry.timestamp;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            (0, loggerUtil_1.logDebug)(`Evicted oldest cache entry: ${oldestKey}`);
+        }
+    }
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, this.config.cleanupInterval);
+        // Don't prevent process exit (important for test runners and CLI tools)
+        this.cleanupTimer.unref();
+    }
+}
+exports.ETagCacheManager = ETagCacheManager;

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

@@ -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/ICache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICache.d.ts","sourceRoot":"","sources":["../../../src/core/cache/ICache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,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,CAAC;IACR,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;IACd,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,CAAC;IACF,QAAQ,IAAI,IAAI,CAAC;CAClB"}

package/dist/core/cache/ICache.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,39 @@
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerConfig {
+    failureThreshold?: number;
+    resetTimeoutMs?: number;
+    halfOpenMaxAttempts?: number;
+    staleThresholdMs?: number;
+}
+export declare class CircuitBreaker {
+    private circuits;
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private readonly halfOpenMaxAttempts;
+    private readonly staleThresholdMs;
+    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;
+    shutdown(): void;
+}
+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

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitBreaker.d.ts","sourceRoot":"","sources":["../../../src/core/circuitBreaker/CircuitBreaker.ts"],"names":[],"mappings":"AAEA,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;CAC3B;AASD,qBAAa,cAAc;IACzB,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;gBAE9B,MAAM,GAAE,oBAAyB;IAO7C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,WAAW;IAcnB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA0BpC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAcrC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAyBzD,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;IAoBjB,QAAQ,IAAI,IAAI;CAGjB;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/CircuitBreaker.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitOpenError = exports.CircuitBreaker = void 0;
+const loggerUtil_1 = require("../logger/loggerUtil");
+class CircuitBreaker {
+    circuits = new Map();
+    failureThreshold;
+    resetTimeoutMs;
+    halfOpenMaxAttempts;
+    staleThresholdMs;
+    constructor(config = {}) {
+        this.failureThreshold = config.failureThreshold ?? 5;
+        this.resetTimeoutMs = config.resetTimeoutMs ?? 30_000;
+        this.halfOpenMaxAttempts = config.halfOpenMaxAttempts ?? 1;
+        this.staleThresholdMs = config.staleThresholdMs ?? 3_600_000;
+    }
+    getKey(endpoint) {
+        return endpoint.split('?')[0];
+    }
+    getOrCreate(key) {
+        let record = this.circuits.get(key);
+        if (!record) {
+            record = {
+                state: 'closed',
+                failures: 0,
+                lastFailureTime: 0,
+                halfOpenAttempts: 0,
+            };
+            this.circuits.set(key, record);
+        }
+        return record;
+    }
+    checkCircuit(endpoint) {
+        const key = this.getKey(endpoint);
+        const record = this.getOrCreate(key);
+        if (record.state === 'closed')
+            return;
+        if (record.state === 'open') {
+            const elapsed = Date.now() - record.lastFailureTime;
+            if (elapsed >= this.resetTimeoutMs) {
+                record.state = 'half-open';
+                record.halfOpenAttempts = 0;
+                (0, loggerUtil_1.logInfo)(`Circuit half-open for ${key}, allowing probe request`);
+                return;
+            }
+            const remainingMs = this.resetTimeoutMs - elapsed;
+            throw new CircuitOpenError(key, record.failures, remainingMs);
+        }
+        if (record.state === 'half-open') {
+            if (record.halfOpenAttempts >= this.halfOpenMaxAttempts) {
+                throw new CircuitOpenError(key, record.failures, this.resetTimeoutMs);
+            }
+            record.halfOpenAttempts++;
+        }
+    }
+    recordSuccess(endpoint) {
+        const key = this.getKey(endpoint);
+        const record = this.circuits.get(key);
+        if (!record)
+            return;
+        if (record.state === 'half-open') {
+            (0, loggerUtil_1.logInfo)(`Circuit closed for ${key} after successful probe`);
+        }
+        record.state = 'closed';
+        record.failures = 0;
+        record.halfOpenAttempts = 0;
+    }
+    recordFailure(endpoint, statusCode) {
+        if (statusCode < 500 && statusCode !== 420 && statusCode !== 429)
+            return;
+        const key = this.getKey(endpoint);
+        const record = this.getOrCreate(key);
+        record.failures++;
+        record.lastFailureTime = Date.now();
+        if (record.state === 'half-open') {
+            record.state = 'open';
+            (0, loggerUtil_1.logWarn)(`Circuit re-opened for ${key} after failed probe (${record.failures} failures)`);
+            return;
+        }
+        if (record.failures >= this.failureThreshold) {
+            record.state = 'open';
+            (0, loggerUtil_1.logWarn)(`Circuit opened for ${key} after ${record.failures} consecutive failures`);
+        }
+    }
+    getState(endpoint) {
+        const key = this.getKey(endpoint);
+        const record = this.circuits.get(key);
+        if (!record)
+            return 'closed';
+        if (record.state === 'open') {
+            const elapsed = Date.now() - record.lastFailureTime;
+            if (elapsed >= this.resetTimeoutMs) {
+                return 'half-open';
+            }
+        }
+        return record.state;
+    }
+    getStats() {
+        const circuits = {};
+        let openCircuits = 0;
+        for (const [key, record] of this.circuits.entries()) {
+            const state = this.getState(key);
+            // eslint-disable-next-line security/detect-object-injection
+            circuits[key] = { state, failures: record.failures };
+            if (state === 'open')
+                openCircuits++;
+        }
+        return {
+            totalCircuits: this.circuits.size,
+            openCircuits,
+            circuits,
+        };
+    }
+    reset(endpoint) {
+        if (endpoint) {
+            this.circuits.delete(this.getKey(endpoint));
+        }
+        else {
+            this.circuits.clear();
+        }
+    }
+    cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [key, record] of this.circuits.entries()) {
+            if (record.state === 'closed' &&
+                record.failures === 0 &&
+                record.lastFailureTime > 0 &&
+                now - record.lastFailureTime > this.staleThresholdMs) {
+                this.circuits.delete(key);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            (0, loggerUtil_1.logInfo)(`Circuit breaker cleanup: removed ${cleaned} stale circuits`);
+        }
+        return cleaned;
+    }
+    shutdown() {
+        this.circuits.clear();
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+class CircuitOpenError extends Error {
+    endpoint;
+    failures;
+    retryAfterMs;
+    constructor(endpoint, failures, retryAfterMs) {
+        super(`Circuit breaker open for ${endpoint} after ${failures} failures (retry after ${Math.ceil(retryAfterMs / 1000)}s)`);
+        this.name = 'CircuitOpenError';
+        this.endpoint = endpoint;
+        this.failures = failures;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+exports.CircuitOpenError = CircuitOpenError;

package/dist/core/constants.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,UAAU,iBAAuC,CAAC;AAC/D,eAAO,MAAM,kBAAkB,eAAe,CAAC"}

package/dist/core/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPATIBILITY_DATE = exports.USER_AGENT = exports.PACKAGE_VERSION = exports.PACKAGE_NAME = void 0;
+exports.PACKAGE_NAME = 'esi.ts';
+exports.PACKAGE_VERSION = '5.0.0';
+exports.USER_AGENT = `${exports.PACKAGE_NAME}/${exports.PACKAGE_VERSION}`;
+exports.COMPATIBILITY_DATE = '2026-05-19';

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

@@ -0,0 +1,50 @@
+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;
+}
+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;
+} ? [...PathParamArgs<P>, ...BA] : D extends {
+    hasBody: true;
+} ? [...PathParamArgs<P>, body: object] : D extends {
+    queryParams: Record<string, string>;
+} ? [...PathParamArgs<P>, ...(string | number | undefined)[]] : PathParamArgs<P> : D extends {
+    bodyBuilder: (...args: infer BA) => unknown;
+} ? BA : D extends {
+    hasBody: true;
+} ? [body: object] : D extends {
+    queryParams: Record<string, string>;
+} ? (string | number | undefined)[] : [];
+export {};
+//# sourceMappingURL=EndpointDefinition.d.ts.map

package/dist/core/endpoints/EndpointDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointDefinition.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/EndpointDefinition.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mFAAmF;IAEnF,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IAC1C,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAI7D,yFAAyF;AACzF,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS;IACzC,OAAO;IACP,GAAG,MAAM,IAAI,SAAS,SAAS,OAAO,EAAE;CACzC,GACG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,GACzC,EAAE,CAAC;AAEP,qEAAqE;AACrE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS;IACtC,UAAU,EAAE,MAAM,CAAC,SAAS,SAAS,MAAM,EAAE,CAAC;CAC/C,GACG,CAAC,SAAS;IAAE,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAA;CAAE,GACvD,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAC5B,CAAC,SAAS;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACzB,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GACnC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC/C,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,GACzD,aAAa,CAAC,CAAC,CAAC,GACtB,CAAC,SAAS;IAAE,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAA;CAAE,GACvD,EAAE,GACF,CAAC,SAAS;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACzB,CAAC,IAAI,EAAE,MAAM,CAAC,GACd,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC/C,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,GAC/B,EAAE,CAAC"}

package/dist/core/endpoints/EndpointDefinition.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,9 @@
+export declare const accessListEndpoints: {
+    readonly getAccessList: {
+        readonly path: "access-lists/{accessListId}";
+        readonly method: "GET";
+        readonly requiresAuth: true;
+        readonly pathParams: readonly ["accessListId"];
+    };
+};
+//# sourceMappingURL=accessListEndpoints.d.ts.map

package/dist/core/endpoints/accessListEndpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessListEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/accessListEndpoints.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB;;;;;;;CAOA,CAAC"}

package/dist/core/endpoints/accessListEndpoints.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.accessListEndpoints = void 0;
+exports.accessListEndpoints = {
+    getAccessList: {
+        path: 'access-lists/{accessListId}',
+        method: 'GET',
+        requiresAuth: true,
+        pathParams: ['accessListId'],
+    },
+};

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

@@ -0,0 +1,26 @@
+export declare const allianceEndpoints: {
+    readonly getAllianceById: {
+        readonly path: "alliances/{allianceId}/";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+        readonly pathParams: readonly ["allianceId"];
+    };
+    readonly getCorporations: {
+        readonly path: "alliances/{allianceId}/corporations/";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+        readonly pathParams: readonly ["allianceId"];
+    };
+    readonly getIcons: {
+        readonly path: "alliances/{allianceId}/icons/";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+        readonly pathParams: readonly ["allianceId"];
+    };
+    readonly getAlliances: {
+        readonly path: "alliances";
+        readonly method: "GET";
+        readonly requiresAuth: false;
+    };
+};
+//# sourceMappingURL=allianceEndpoints.d.ts.map

package/dist/core/endpoints/allianceEndpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allianceEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/allianceEndpoints.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;CAwBE,CAAC"}

package/dist/core/endpoints/allianceEndpoints.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allianceEndpoints = void 0;
+exports.allianceEndpoints = {
+    getAllianceById: {
+        path: 'alliances/{allianceId}/',
+        method: 'GET',
+        requiresAuth: false,
+        pathParams: ['allianceId'],
+    },
+    getCorporations: {
+        path: 'alliances/{allianceId}/corporations/',
+        method: 'GET',
+        requiresAuth: false,
+        pathParams: ['allianceId'],
+    },
+    getIcons: {
+        path: 'alliances/{allianceId}/icons/',
+        method: 'GET',
+        requiresAuth: false,
+        pathParams: ['allianceId'],
+    },
+    getAlliances: {
+        path: 'alliances',
+        method: 'GET',
+        requiresAuth: false,
+    },
+};