@lgriffin/esi.ts 6.1.0 → 8.0.0

package/dist/core/RequestDeduplicator.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequestDeduplicator = void 0;
-const loggerUtil_1 = require("./logger/loggerUtil");
-class RequestDeduplicator {
-    inflight = new Map();
-    async dedupe(key, execute) {
-        const existing = this.inflight.get(key);
-        if (existing) {
-            (0, loggerUtil_1.logDebug)(`[Dedup] Coalescing request: ${key}`);
-            return existing;
-        }
-        const promise = execute().finally(() => {
-            this.inflight.delete(key);
-        });
-        this.inflight.set(key, promise);
-        return promise;
-    }
-    get pending() {
-        return this.inflight.size;
-    }
-    clear() {
-        this.inflight.clear();
-    }
-}
-exports.RequestDeduplicator = RequestDeduplicator;

package/dist/core/cache/ETagCacheManager.js

@@ -1,184 +0,0 @@
-"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.js

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

package/dist/core/circuitBreaker/CircuitBreaker.js

@@ -1,156 +0,0 @@
-"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.js

@@ -1,7 +0,0 @@
-"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.3.0';
-exports.USER_AGENT = `${exports.PACKAGE_NAME}/${exports.PACKAGE_VERSION}`;
-exports.COMPATIBILITY_DATE = '2026-05-19';

package/dist/core/endpoints/EndpointDefinition.js

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

package/dist/core/endpoints/accessListEndpoints.js

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

package/dist/core/endpoints/allianceEndpoints.js

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

package/dist/core/endpoints/assetEndpoints.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assetEndpoints = void 0;
-const zod_1 = require("zod");
-const assets_1 = require("../../schemas/assets");
-exports.assetEndpoints = {
-    getCharacterAssets: {
-        path: 'characters/{characterId}/assets/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(assets_1.CharacterAssetSchema),
-    },
-    getCorporationAssets: {
-        path: 'corporations/{corporationId}/assets/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['corporationId'],
-    },
-    postCharacterAssetLocations: {
-        path: 'characters/{characterId}/assets/locations/',
-        method: 'POST',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        bodyBuilder: (itemIds) => itemIds,
-        responseSchema: zod_1.z.array(assets_1.AssetLocationSchema),
-    },
-    postCharacterAssetNames: {
-        path: 'characters/{characterId}/assets/names/',
-        method: 'POST',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        bodyBuilder: (itemIds) => itemIds,
-        responseSchema: zod_1.z.array(assets_1.AssetNameSchema),
-    },
-    postCorporationAssetLocations: {
-        path: 'corporations/{corporationId}/assets/locations/',
-        method: 'POST',
-        requiresAuth: true,
-        pathParams: ['corporationId'],
-        bodyBuilder: (itemIds) => itemIds,
-    },
-    postCorporationAssetNames: {
-        path: 'corporations/{corporationId}/assets/names/',
-        method: 'POST',
-        requiresAuth: true,
-        pathParams: ['corporationId'],
-        bodyBuilder: (itemIds) => itemIds,
-    },
-};

package/dist/core/endpoints/buildEndpointPath.js

@@ -1,44 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildEndpointPath = buildEndpointPath;
-const validation_1 = require("../util/validation");
-function buildEndpointPath(def, args, datasource) {
-    let argIndex = 0;
-    let path = def.path;
-    if (def.pathParams) {
-        for (const param of def.pathParams) {
-            const raw = args[argIndex++];
-            const validated = (0, validation_1.validatePathParam)(param, raw);
-            path = path.replace(`{${param}}`, encodeURIComponent(validated));
-        }
-    }
-    if (def.queryParams) {
-        const queryParts = [];
-        for (const [paramName, queryKey] of Object.entries(def.queryParams)) {
-            const value = args[argIndex++];
-            if (value !== undefined) {
-                const validated = (0, validation_1.validateQueryParam)(paramName, value);
-                queryParts.push(`${queryKey}=${encodeURIComponent(validated)}`);
-            }
-        }
-        if (queryParts.length > 0) {
-            path += (path.includes('?') ? '&' : '?') + queryParts.join('&');
-        }
-    }
-    let body = undefined;
-    if (def.bodyBuilder) {
-        /* eslint-disable @typescript-eslint/no-unsafe-argument */
-        body = def.bodyBuilder(...args.slice(argIndex));
-        /* eslint-enable @typescript-eslint/no-unsafe-argument */
-    }
-    else if (def.hasBody) {
-        // eslint-disable-next-line security/detect-object-injection
-        body = args[argIndex];
-    }
-    if (datasource) {
-        path +=
-            (path.includes('?') ? '&' : '?') +
-                `datasource=${encodeURIComponent(datasource)}`;
-    }
-    return { path, body };
-}

package/dist/core/endpoints/calendarEndpoints.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calendarEndpoints = void 0;
-const zod_1 = require("zod");
-const calendar_1 = require("../../schemas/calendar");
-exports.calendarEndpoints = {
-    getCalendarEvents: {
-        path: 'characters/{characterId}/calendar/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(calendar_1.CalendarEventSchema),
-    },
-    getCalendarEventById: {
-        path: 'characters/{characterId}/calendar/{eventId}/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId', 'eventId'],
-        responseSchema: calendar_1.CalendarEventDetailSchema,
-    },
-    getEventAttendees: {
-        path: 'characters/{characterId}/calendar/{eventId}/attendees/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId', 'eventId'],
-        responseSchema: zod_1.z.array(calendar_1.CalendarEventAttendeeSchema),
-    },
-    respondToCalendarEvent: {
-        path: 'characters/{characterId}/calendar/{eventId}/',
-        method: 'PUT',
-        requiresAuth: true,
-        pathParams: ['characterId', 'eventId'],
-        bodyBuilder: (response) => ({ response }),
-    },
-};

package/dist/core/endpoints/characterEndpoints.js

@@ -1,103 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.characterEndpoints = void 0;
-const zod_1 = require("zod");
-const character_1 = require("../../schemas/character");
-exports.characterEndpoints = {
-    getCharacterPublicInfo: {
-        path: 'characters/{characterId}/',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['characterId'],
-        responseSchema: character_1.CharacterInfoSchema,
-    },
-    getAgentsResearch: {
-        path: 'characters/{characterId}/agents_research/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(character_1.AgentResearchSchema),
-    },
-    getBlueprints: {
-        path: 'characters/{characterId}/blueprints/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(character_1.BlueprintSchema),
-    },
-    getRoles: {
-        path: 'characters/{characterId}/roles',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: character_1.CharacterRoleSchema,
-    },
-    getStandings: {
-        path: 'characters/{characterId}/standings',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(character_1.StandingSchema),
-    },
-    getTitles: {
-        path: 'characters/{characterId}/titles',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(character_1.CharacterTitleSchema),
-    },
-    getContactNotifications: {
-        path: 'characters/{characterId}/notifications/contacts/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-    },
-    getCorporationHistory: {
-        path: 'characters/{characterId}/corporationhistory/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(character_1.CorporationHistorySchema),
-    },
-    getJumpFatigue: {
-        path: 'characters/{characterId}/fatigue/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: character_1.JumpFatigueSchema,
-    },
-    getMedals: {
-        path: 'characters/{characterId}/medals/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(character_1.MedalSchema),
-    },
-    getNotifications: {
-        path: 'characters/{characterId}/notifications/',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(character_1.NotificationSchema),
-    },
-    getPortrait: {
-        path: 'characters/{characterId}/portrait/',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['characterId'],
-        responseSchema: character_1.CharacterPortraitSchema,
-    },
-    postCharacterAffiliation: {
-        path: 'characters/affiliation',
-        method: 'POST',
-        requiresAuth: false,
-        hasBody: true,
-    },
-    calculateCspaChargeCost: {
-        path: 'characters/{characterId}/cspa/',
-        method: 'POST',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        hasBody: true,
-    },
-};

package/dist/core/endpoints/cloneEndpoints.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cloneEndpoints = void 0;
-const clones_1 = require("../../schemas/clones");
-exports.cloneEndpoints = {
-    getClones: {
-        path: 'characters/{characterId}/clones',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: clones_1.CloneInfoSchema,
-    },
-    getImplants: {
-        path: 'characters/{characterId}/implants',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-    },
-};