@lgriffin/esi.ts 2.0.0 → 5.0.0

package/dist/core/ApiRequestHandler.js

@@ -0,0 +1,369 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRequest = void 0;
+const error_1 = require("../core/util/error");
+const loggerUtil_1 = require("../core/logger/loggerUtil");
+const headersUtil_1 = require("../core/util/headersUtil");
+const PaginationHandler_1 = require("./pagination/PaginationHandler");
+const constants_1 = require("./constants");
+const STATUS_MESSAGES = {
+    201: 'Created',
+    204: 'No Content',
+    304: 'Not Modified',
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Resource not found',
+    420: 'Error Limited',
+    422: 'Unprocessable Entity',
+    429: 'Too many requests',
+    500: 'Internal server error',
+    503: 'Service Unavailable',
+    504: 'Gateway Timeout',
+    520: 'Internal server error, did the request terminate too soon?',
+};
+// --- Dependency resolution ---
+function resolveCache(client) {
+    return client.getCache();
+}
+function resolveRateLimiter(client) {
+    const limiter = client.getRateLimiter();
+    if (!limiter) {
+        throw (0, error_1.buildError)('No rate limiter configured on ApiClient. ' +
+            'Set one via apiClient.setRateLimiter(new RateLimiter()).', 'CONFIGURATION_ERROR');
+    }
+    return limiter;
+}
+function resolveCircuitBreaker(client) {
+    return client.getCircuitBreaker();
+}
+// --- Pure helpers ---
+const parseCacheControlTtl = (headers) => {
+    const cacheControl = headers['cache-control'] || headers['Cache-Control'];
+    if (!cacheControl)
+        return undefined;
+    const match = /max-age=(\d+)/.exec(cacheControl);
+    return match ? parseInt(match[1], 10) * 1000 : undefined;
+};
+function buildRequestHeaders(client, url, method, requiresAuth, useETag, body) {
+    const headers = {
+        accept: 'gzip, deflate, br',
+        'User-Agent': constants_1.USER_AGENT,
+        'X-Compatibility-Date': constants_1.COMPATIBILITY_DATE,
+    };
+    if (requiresAuth) {
+        const authHeader = client.getAuthorizationHeader();
+        if (!authHeader) {
+            throw (0, error_1.buildError)('Authorization header is required but not provided', 'NO_AUTH_TOKEN');
+        }
+        headers['Authorization'] = authHeader;
+    }
+    const cache = resolveCache(client);
+    if (useETag && method === 'GET' && cache) {
+        const cachedETag = cache.getETag(url);
+        if (cachedETag) {
+            headers['If-None-Match'] = cachedETag;
+            (0, loggerUtil_1.logDebug)(`Adding If-None-Match header: ${cachedETag}`);
+        }
+    }
+    if (body) {
+        headers['Content-Type'] = 'application/json';
+    }
+    return headers;
+}
+function handleEarlyStatus(client, status, url, parsed, useETag) {
+    if (status === 201) {
+        return { headers: parsed.raw, body: undefined };
+    }
+    if (status === 204) {
+        (0, loggerUtil_1.logInfo)(`No Content for endpoint: ${url}`);
+        return { headers: parsed.raw, body: undefined };
+    }
+    if (status === 304) {
+        const cache = resolveCache(client);
+        if (useETag && cache) {
+            const cachedEntry = cache.get(url);
+            if (cachedEntry) {
+                (0, loggerUtil_1.logInfo)(`Cache hit (304) for endpoint: ${url}`);
+                return {
+                    headers: { ...cachedEntry.headers, ...parsed.raw },
+                    body: cachedEntry.data,
+                    fromCache: true,
+                };
+            }
+        }
+        throw new error_1.EsiError(304, 'Not Modified — no cached data available', url, parsed.requestId ?? undefined);
+    }
+    return null;
+}
+function tryStaleCacheResponse(client, url, parsed) {
+    const cache = resolveCache(client);
+    if (!cache)
+        return null;
+    const cachedEntry = cache.get(url);
+    if (!cachedEntry)
+        return null;
+    return {
+        headers: { ...cachedEntry.headers, ...parsed.raw },
+        body: cachedEntry.data,
+        fromCache: true,
+        stale: true,
+    };
+}
+function cacheResponse(client, url, method, endpoint, parsed, data, useETag) {
+    const cache = resolveCache(client);
+    if (useETag && method === 'GET' && cache && parsed.etag) {
+        const ttl = parseCacheControlTtl(parsed.raw);
+        cache.set(url, parsed.etag, data, parsed.raw, ttl);
+        const ttlInfo = ttl ? ` (ttl=${ttl}ms)` : '';
+        (0, loggerUtil_1.logDebug)(`Cached response for ${url} with ETag ${parsed.etag}${ttlInfo}`);
+    }
+    if (method !== 'GET' && cache) {
+        cache.deleteByPath(endpoint.split('?')[0]);
+    }
+}
+async function parseJsonBody(response, _url) {
+    try {
+        return (await response.json());
+    }
+    catch (jsonError) {
+        const msg = jsonError instanceof Error ? jsonError.message : String(jsonError);
+        (0, loggerUtil_1.logError)(`Failed to parse JSON response: ${msg}`);
+        throw (0, error_1.buildError)(`Invalid JSON response: ${msg}`, 'JSON_PARSE_ERROR');
+    }
+}
+function handleCursorPagination(parsed, data) {
+    if (!parsed.hasCursorPagination)
+        return null;
+    const cursors = {
+        before: parsed.cursorBefore,
+        after: parsed.cursorAfter,
+    };
+    return { headers: parsed.raw, body: data, cursors };
+}
+async function handleOffsetPagination(client, endpoint, method, requiresAuth, parsed, data, body, url, useETag, pageFetch) {
+    const totalPages = parsed.xPages;
+    if (totalPages <= 1) {
+        return { headers: parsed.raw, body: data };
+    }
+    (0, loggerUtil_1.logInfo)(`Found ${totalPages} pages, fetching additional pages with rate limiting...`);
+    try {
+        const firstPageData = Array.isArray(data) ? data : [data];
+        const allData = await PaginationHandler_1.PaginationHandler.fetchRemainingPages(client, endpoint, method, requiresAuth, firstPageData, totalPages, body, {
+            maxPages: Math.min(totalPages, 1000),
+            stopOnEmptyPage: true,
+            maxRetries: 3,
+        }, pageFetch);
+        cacheResponse(client, url, method, endpoint, parsed, allData, useETag);
+        return { headers: parsed.raw, body: allData };
+    }
+    catch (paginationError) {
+        const msg = paginationError instanceof Error
+            ? paginationError.message
+            : String(paginationError);
+        (0, loggerUtil_1.logWarn)(`Pagination failed, returning first page only: ${msg}`);
+        return { headers: parsed.raw, body: data };
+    }
+}
+// --- Response interceptor wrapper ---
+async function applyResponseInterceptors(client, result, url, endpoint, method, startTime) {
+    const middleware = client.getMiddleware();
+    if (!middleware.hasInterceptors())
+        return result;
+    const responseCtx = {
+        url,
+        endpoint,
+        method,
+        status: 200,
+        headers: result.headers,
+        body: result.body,
+        durationMs: Date.now() - startTime,
+        fromCache: result.fromCache ?? false,
+    };
+    const modified = await middleware.applyResponseInterceptors(responseCtx);
+    return {
+        ...result,
+        headers: modified.headers,
+        body: modified.body,
+    };
+}
+// --- Main request functions ---
+async function applyRequestMiddleware(client, url, endpoint, method, headers, body) {
+    const middleware = client.getMiddleware();
+    if (!middleware.hasInterceptors()) {
+        return { url, headers, body };
+    }
+    const reqCtx = {
+        url,
+        endpoint,
+        method,
+        headers: { ...headers },
+        body,
+    };
+    const modified = await middleware.applyRequestInterceptors(reqCtx);
+    return {
+        url: modified.url,
+        headers: modified.headers,
+        body: modified.body,
+    };
+}
+function handleErrorResponse(client, response, url, parsed, useETag) {
+    const errorMessage = STATUS_MESSAGES[response.status] || response.statusText;
+    if (response.status >= 500 && useETag) {
+        const staleResult = tryStaleCacheResponse(client, url, parsed);
+        if (staleResult) {
+            (0, loggerUtil_1.logWarn)(`${errorMessage} for ${url} — serving stale cache`);
+            return staleResult;
+        }
+    }
+    if (response.status === 420 || response.status === 429) {
+        (0, loggerUtil_1.logWarn)(`Rate limited (${response.status}) on ${url}`);
+    }
+    throw new error_1.EsiError(response.status, errorMessage, url, parsed.requestId ?? undefined);
+}
+function wrapError(error) {
+    if (error instanceof error_1.EsiError) {
+        throw error;
+    }
+    if (error instanceof Error) {
+        (0, loggerUtil_1.logError)(`Unexpected error: ${error.message}`);
+        throw (0, error_1.buildError)(error.message, 'ESIJS_ERROR');
+    }
+    (0, loggerUtil_1.logError)(`Unexpected error: ${String(error)}`);
+    throw (0, error_1.buildError)(String(error), 'ESIJS_ERROR');
+}
+async function executeSingleFetch(client, endpoint, method, body, requiresAuth, useETag) {
+    const rawUrl = `${client.getLink()}/${endpoint}`;
+    const builtHeaders = buildRequestHeaders(client, rawUrl, method, requiresAuth, useETag, body);
+    const req = await applyRequestMiddleware(client, rawUrl, endpoint, method, builtHeaders, body);
+    const options = {
+        method,
+        headers: req.headers,
+        body: req.body ? JSON.stringify(req.body) : undefined,
+    };
+    const url = req.url;
+    (0, loggerUtil_1.logInfo)(`Hitting endpoint: ${url}`);
+    const cb = resolveCircuitBreaker(client);
+    if (cb)
+        cb.checkCircuit(endpoint);
+    const rateLimiter = resolveRateLimiter(client);
+    await rateLimiter.checkRateLimit();
+    const timeoutMs = client.getTimeout();
+    const controller = new AbortController();
+    const timer = globalThis.setTimeout(() => controller.abort(), timeoutMs);
+    options.signal = controller.signal;
+    let response;
+    try {
+        response = await fetch(url, options);
+    }
+    catch (err) {
+        clearTimeout(timer);
+        if (err instanceof Error && err.name === 'AbortError') {
+            throw new error_1.EsiError(0, `Request timed out after ${timeoutMs}ms`, url);
+        }
+        throw err;
+    }
+    clearTimeout(timer);
+    const parsed = (0, headersUtil_1.parseHeaders)(response.headers);
+    rateLimiter.updateFromResponse(parsed.raw, response.status);
+    if (cb) {
+        if (response.status >= 500 ||
+            response.status === 420 ||
+            response.status === 429) {
+            cb.recordFailure(endpoint, response.status);
+        }
+        else {
+            cb.recordSuccess(endpoint);
+        }
+    }
+    if (parsed.warning) {
+        (0, loggerUtil_1.logWarn)(`ESI Warning ${parsed.warning.code} for ${url}: ${parsed.warning.message}`);
+    }
+    return { response, parsed, url };
+}
+async function fetchOnePage(client, endpoint, method, body, requiresAuth = false, useETag = false) {
+    const { response, parsed, url } = await executeSingleFetch(client, endpoint, method, body, requiresAuth, useETag);
+    if (!response.ok) {
+        throw new error_1.EsiError(response.status, STATUS_MESSAGES[response.status] || response.statusText, url, parsed.requestId ?? undefined);
+    }
+    const data = await parseJsonBody(response, url);
+    return { data, parsed, url };
+}
+const executeRequest = async (client, endpoint, method, body, requiresAuth = false, useETag = true) => {
+    const startTime = Date.now();
+    const finish = (r) => {
+        const rawUrl = `${client.getLink()}/${endpoint}`;
+        return applyResponseInterceptors(client, r, rawUrl, endpoint, method, startTime);
+    };
+    try {
+        const { response, parsed, url } = await executeSingleFetch(client, endpoint, method, body, requiresAuth, useETag);
+        if (response.status === 201) {
+            let data;
+            try {
+                data = (await response.json());
+            }
+            catch {
+                data = undefined;
+            }
+            return finish({ headers: parsed.raw, body: data });
+        }
+        const earlyResult = handleEarlyStatus(client, response.status, url, parsed, useETag);
+        if (earlyResult)
+            return finish(earlyResult);
+        if (!response.ok) {
+            const staleOrThrow = handleErrorResponse(client, response, url, parsed, useETag);
+            return finish(staleOrThrow);
+        }
+        const data = await parseJsonBody(response, url);
+        cacheResponse(client, url, method, endpoint, parsed, data, useETag);
+        const cursorResult = handleCursorPagination(parsed, data);
+        if (cursorResult)
+            return finish(cursorResult);
+        const pageFetch = async (paginatedEndpoint) => {
+            const result = await fetchOnePage(client, paginatedEndpoint, method, body, requiresAuth);
+            return Array.isArray(result.data)
+                ? result.data
+                : [result.data];
+        };
+        const paginatedResult = await handleOffsetPagination(client, endpoint, method, requiresAuth, parsed, data, body, url, useETag, pageFetch);
+        return finish(paginatedResult);
+    }
+    catch (error) {
+        wrapError(error);
+    }
+};
+const handleRequest = async (client, endpoint, method, body, requiresAuth = false, useETag = true) => {
+    const doExecute = () => executeRequest(client, endpoint, method, body, requiresAuth, useETag);
+    const dedup = client.getDeduplicator();
+    const canDedup = dedup && method === 'GET' && !body;
+    try {
+        return canDedup
+            ? await dedup.dedupe(endpoint, doExecute)
+            : await doExecute();
+    }
+    catch (error) {
+        if (error instanceof error_1.EsiError &&
+            error.statusCode === 401 &&
+            requiresAuth &&
+            client.hasTokenProvider()) {
+            (0, loggerUtil_1.logInfo)('Received 401, attempting token refresh...');
+            try {
+                await client.refreshToken();
+                (0, loggerUtil_1.logInfo)('Token refreshed, retrying request');
+                return await executeRequest(client, endpoint, method, body, requiresAuth, useETag);
+            }
+            catch (refreshError) {
+                if (refreshError instanceof error_1.EsiError) {
+                    throw refreshError;
+                }
+                const msg = refreshError instanceof Error
+                    ? refreshError.message
+                    : String(refreshError);
+                (0, loggerUtil_1.logError)(`Token refresh failed: ${msg}`);
+                throw (0, error_1.buildError)(`Token refresh failed: ${msg}`, 'TOKEN_REFRESH_FAILED');
+            }
+        }
+        throw error;
+    }
+};
+exports.handleRequest = handleRequest;

package/dist/core/ClientRegistry.d.ts

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

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

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

package/dist/core/ClientRegistry.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessListsClient = exports.MercenaryClient = exports.SkyhooksClient = exports.FreelanceJobsClient = exports.MetaClient = exports.WarsClient = exports.WalletClient = exports.UniverseClient = exports.UiClient = exports.StatusClient = exports.SovereigntyClient = exports.CharacterSkillsClient = exports.SearchClient = exports.RouteClient = exports.PiClient = exports.MarketClient = exports.MailClient = exports.LoyaltyClient = exports.LocationClient = exports.KillmailsClient = exports.InsuranceClient = exports.IndustryClient = exports.IncursionsClient = exports.FleetClient = exports.FittingsClient = exports.FactionClient = exports.DogmaClient = exports.CorporationsClient = exports.ContractsClient = exports.ContactsClient = exports.ClonesClient = exports.CharacterClient = exports.CalendarClient = exports.AssetsClient = exports.AllianceClient = void 0;
+exports.createClientInstance = createClientInstance;
+const AllianceClient_1 = require("../clients/AllianceClient");
+Object.defineProperty(exports, "AllianceClient", { enumerable: true, get: function () { return AllianceClient_1.AllianceClient; } });
+const AssetsClient_1 = require("../clients/AssetsClient");
+Object.defineProperty(exports, "AssetsClient", { enumerable: true, get: function () { return AssetsClient_1.AssetsClient; } });
+const CalendarClient_1 = require("../clients/CalendarClient");
+Object.defineProperty(exports, "CalendarClient", { enumerable: true, get: function () { return CalendarClient_1.CalendarClient; } });
+const CharacterClient_1 = require("../clients/CharacterClient");
+Object.defineProperty(exports, "CharacterClient", { enumerable: true, get: function () { return CharacterClient_1.CharacterClient; } });
+const ClonesClient_1 = require("../clients/ClonesClient");
+Object.defineProperty(exports, "ClonesClient", { enumerable: true, get: function () { return ClonesClient_1.ClonesClient; } });
+const ContactsClient_1 = require("../clients/ContactsClient");
+Object.defineProperty(exports, "ContactsClient", { enumerable: true, get: function () { return ContactsClient_1.ContactsClient; } });
+const ContractsClient_1 = require("../clients/ContractsClient");
+Object.defineProperty(exports, "ContractsClient", { enumerable: true, get: function () { return ContractsClient_1.ContractsClient; } });
+const CorporationsClient_1 = require("../clients/CorporationsClient");
+Object.defineProperty(exports, "CorporationsClient", { enumerable: true, get: function () { return CorporationsClient_1.CorporationsClient; } });
+const DogmaClient_1 = require("../clients/DogmaClient");
+Object.defineProperty(exports, "DogmaClient", { enumerable: true, get: function () { return DogmaClient_1.DogmaClient; } });
+const FactionClient_1 = require("../clients/FactionClient");
+Object.defineProperty(exports, "FactionClient", { enumerable: true, get: function () { return FactionClient_1.FactionClient; } });
+const FittingsClient_1 = require("../clients/FittingsClient");
+Object.defineProperty(exports, "FittingsClient", { enumerable: true, get: function () { return FittingsClient_1.FittingsClient; } });
+const FleetClient_1 = require("../clients/FleetClient");
+Object.defineProperty(exports, "FleetClient", { enumerable: true, get: function () { return FleetClient_1.FleetClient; } });
+const IncursionsClient_1 = require("../clients/IncursionsClient");
+Object.defineProperty(exports, "IncursionsClient", { enumerable: true, get: function () { return IncursionsClient_1.IncursionsClient; } });
+const IndustryClient_1 = require("../clients/IndustryClient");
+Object.defineProperty(exports, "IndustryClient", { enumerable: true, get: function () { return IndustryClient_1.IndustryClient; } });
+const InsuranceClient_1 = require("../clients/InsuranceClient");
+Object.defineProperty(exports, "InsuranceClient", { enumerable: true, get: function () { return InsuranceClient_1.InsuranceClient; } });
+const KillmailsClient_1 = require("../clients/KillmailsClient");
+Object.defineProperty(exports, "KillmailsClient", { enumerable: true, get: function () { return KillmailsClient_1.KillmailsClient; } });
+const LocationClient_1 = require("../clients/LocationClient");
+Object.defineProperty(exports, "LocationClient", { enumerable: true, get: function () { return LocationClient_1.LocationClient; } });
+const LoyaltyClient_1 = require("../clients/LoyaltyClient");
+Object.defineProperty(exports, "LoyaltyClient", { enumerable: true, get: function () { return LoyaltyClient_1.LoyaltyClient; } });
+const MailClient_1 = require("../clients/MailClient");
+Object.defineProperty(exports, "MailClient", { enumerable: true, get: function () { return MailClient_1.MailClient; } });
+const MarketClient_1 = require("../clients/MarketClient");
+Object.defineProperty(exports, "MarketClient", { enumerable: true, get: function () { return MarketClient_1.MarketClient; } });
+const PiClient_1 = require("../clients/PiClient");
+Object.defineProperty(exports, "PiClient", { enumerable: true, get: function () { return PiClient_1.PiClient; } });
+const RouteClient_1 = require("../clients/RouteClient");
+Object.defineProperty(exports, "RouteClient", { enumerable: true, get: function () { return RouteClient_1.RouteClient; } });
+const SearchClient_1 = require("../clients/SearchClient");
+Object.defineProperty(exports, "SearchClient", { enumerable: true, get: function () { return SearchClient_1.SearchClient; } });
+const SkillsClient_1 = require("../clients/SkillsClient");
+Object.defineProperty(exports, "CharacterSkillsClient", { enumerable: true, get: function () { return SkillsClient_1.CharacterSkillsClient; } });
+const SovereigntyClient_1 = require("../clients/SovereigntyClient");
+Object.defineProperty(exports, "SovereigntyClient", { enumerable: true, get: function () { return SovereigntyClient_1.SovereigntyClient; } });
+const StatusClient_1 = require("../clients/StatusClient");
+Object.defineProperty(exports, "StatusClient", { enumerable: true, get: function () { return StatusClient_1.StatusClient; } });
+const UiClient_1 = require("../clients/UiClient");
+Object.defineProperty(exports, "UiClient", { enumerable: true, get: function () { return UiClient_1.UiClient; } });
+const UniverseClient_1 = require("../clients/UniverseClient");
+Object.defineProperty(exports, "UniverseClient", { enumerable: true, get: function () { return UniverseClient_1.UniverseClient; } });
+const WalletClient_1 = require("../clients/WalletClient");
+Object.defineProperty(exports, "WalletClient", { enumerable: true, get: function () { return WalletClient_1.WalletClient; } });
+const WarsClient_1 = require("../clients/WarsClient");
+Object.defineProperty(exports, "WarsClient", { enumerable: true, get: function () { return WarsClient_1.WarsClient; } });
+const MetaClient_1 = require("../clients/MetaClient");
+Object.defineProperty(exports, "MetaClient", { enumerable: true, get: function () { return MetaClient_1.MetaClient; } });
+const FreelanceJobsClient_1 = require("../clients/FreelanceJobsClient");
+Object.defineProperty(exports, "FreelanceJobsClient", { enumerable: true, get: function () { return FreelanceJobsClient_1.FreelanceJobsClient; } });
+const SkyhooksClient_1 = require("../clients/SkyhooksClient");
+Object.defineProperty(exports, "SkyhooksClient", { enumerable: true, get: function () { return SkyhooksClient_1.SkyhooksClient; } });
+const MercenaryClient_1 = require("../clients/MercenaryClient");
+Object.defineProperty(exports, "MercenaryClient", { enumerable: true, get: function () { return MercenaryClient_1.MercenaryClient; } });
+const AccessListsClient_1 = require("../clients/AccessListsClient");
+Object.defineProperty(exports, "AccessListsClient", { enumerable: true, get: function () { return AccessListsClient_1.AccessListsClient; } });
+const clientFactories = {
+    alliance: AllianceClient_1.AllianceClient,
+    assets: AssetsClient_1.AssetsClient,
+    calendar: CalendarClient_1.CalendarClient,
+    characters: CharacterClient_1.CharacterClient,
+    clones: ClonesClient_1.ClonesClient,
+    contacts: ContactsClient_1.ContactsClient,
+    contracts: ContractsClient_1.ContractsClient,
+    corporations: CorporationsClient_1.CorporationsClient,
+    dogma: DogmaClient_1.DogmaClient,
+    factions: FactionClient_1.FactionClient,
+    fittings: FittingsClient_1.FittingsClient,
+    fleets: FleetClient_1.FleetClient,
+    incursions: IncursionsClient_1.IncursionsClient,
+    industry: IndustryClient_1.IndustryClient,
+    insurance: InsuranceClient_1.InsuranceClient,
+    killmails: KillmailsClient_1.KillmailsClient,
+    location: LocationClient_1.LocationClient,
+    loyalty: LoyaltyClient_1.LoyaltyClient,
+    mail: MailClient_1.MailClient,
+    market: MarketClient_1.MarketClient,
+    pi: PiClient_1.PiClient,
+    route: RouteClient_1.RouteClient,
+    search: SearchClient_1.SearchClient,
+    skills: SkillsClient_1.CharacterSkillsClient,
+    sovereignty: SovereigntyClient_1.SovereigntyClient,
+    status: StatusClient_1.StatusClient,
+    ui: UiClient_1.UiClient,
+    universe: UniverseClient_1.UniverseClient,
+    wallet: WalletClient_1.WalletClient,
+    wars: WarsClient_1.WarsClient,
+    meta: MetaClient_1.MetaClient,
+    freelanceJobs: FreelanceJobsClient_1.FreelanceJobsClient,
+    skyhooks: SkyhooksClient_1.SkyhooksClient,
+    mercenary: MercenaryClient_1.MercenaryClient,
+    accessLists: AccessListsClient_1.AccessListsClient,
+};
+function createClientInstance(name, apiClient) {
+    // eslint-disable-next-line security/detect-object-injection
+    return new clientFactories[name](apiClient);
+}
+const allClientTypes = Object.keys(clientFactories);

package/dist/core/EsiDiagnostics.d.ts

@@ -0,0 +1,35 @@
+import { ApiClient } from './ApiClient';
+import { ETagCacheConfig } from './cache/ETagCacheManager';
+import { RequestDeduplicator } from './RequestDeduplicator';
+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/EsiDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EsiDiagnostics.d.ts","sourceRoot":"","sources":["../../src/core/EsiDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAoB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CACd,MAAM,EACN;QAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAC7D,CAAC;CACH;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,YAAY;gBAFZ,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,OAAO,EACzB,YAAY,EAAE,mBAAmB,GAAG,IAAI;IAGlD,aAAa,IAAI,UAAU,GAAG,IAAI;IAMlC,UAAU,IAAI,IAAI;IAOlB,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAO5D,sBAAsB,IAAI,mBAAmB,GAAG,IAAI;IAKpD,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAO5C,oBAAoB,IAAI;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAK3D"}

package/dist/core/EsiDiagnostics.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EsiDiagnostics = void 0;
+class EsiDiagnostics {
+    apiClient;
+    etagCacheEnabled;
+    deduplicator;
+    constructor(apiClient, etagCacheEnabled, deduplicator) {
+        this.apiClient = apiClient;
+        this.etagCacheEnabled = etagCacheEnabled;
+        this.deduplicator = deduplicator;
+    }
+    getCacheStats() {
+        if (!this.etagCacheEnabled)
+            return null;
+        const cache = this.apiClient.getCache();
+        return cache ? cache.getStats() : null;
+    }
+    clearCache() {
+        const cache = this.apiClient.getCache();
+        if (cache) {
+            cache.clear();
+        }
+    }
+    updateCacheConfig(newConfig) {
+        const cache = this.apiClient.getCache();
+        if (cache) {
+            cache.updateConfig(newConfig);
+        }
+    }
+    getCircuitBreakerStats() {
+        const cb = this.apiClient.getCircuitBreaker();
+        return cb ? cb.getStats() : null;
+    }
+    resetCircuitBreaker(endpoint) {
+        const cb = this.apiClient.getCircuitBreaker();
+        if (cb) {
+            cb.reset(endpoint);
+        }
+    }
+    getDeduplicatorStats() {
+        return this.deduplicator
+            ? { pendingRequests: this.deduplicator.pending }
+            : null;
+    }
+}
+exports.EsiDiagnostics = EsiDiagnostics;

package/dist/core/RequestDeduplicator.d.ts

@@ -0,0 +1,7 @@
+export declare class RequestDeduplicator {
+    private inflight;
+    dedupe<T>(key: string, execute: () => Promise<T>): Promise<T>;
+    get pending(): number;
+    clear(): void;
+}
+//# sourceMappingURL=RequestDeduplicator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RequestDeduplicator.d.ts","sourceRoot":"","sources":["../../src/core/RequestDeduplicator.ts"],"names":[],"mappings":"AAEA,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAuC;IAEjD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAenE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/RequestDeduplicator.js

@@ -0,0 +1,26 @@
+"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;