@lgriffin/esi.ts 5.0.0 → 5.2.0

package/dist/core/ApiRequestHandler.js

@@ -6,6 +6,10 @@ 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 esi_cache_ttls_generated_1 = require("./endpoints/esi-cache-ttls.generated");
+const retry_1 = require("./util/retry");
+const sleep_1 = require("./util/sleep");
+const CircuitBreaker_1 = require("./circuitBreaker/CircuitBreaker");
 const STATUS_MESSAGES = {
     201: 'Created',
     204: 'No Content',
@@ -38,8 +42,41 @@ function resolveCircuitBreaker(client) {
     return client.getCircuitBreaker();
 }
 // --- Pure helpers ---
+const stringUtil_1 = require("./util/stringUtil");
+function lookupSpecTtl(method, templatePath) {
+    const normalized = templatePath
+        .replace(/\/$/, '')
+        .replace(/\{(\w+)\}/g, (_, name) => `{${(0, stringUtil_1.camelToSnake)(name)}}`);
+    const key = `${method}:${normalized}`;
+    const seconds = esi_cache_ttls_generated_1.esiCacheTtls[key];
+    return typeof seconds === 'number' ? seconds * 1000 : undefined;
+}
+function trySpecAwareCacheHit(client, url, method, templatePath) {
+    if (method !== 'GET' || !templatePath)
+        return null;
+    const specTtlMs = lookupSpecTtl(method, templatePath);
+    if (!specTtlMs)
+        return null;
+    const cache = resolveCache(client);
+    if (!cache)
+        return null;
+    const entry = cache.get(url);
+    if (!entry)
+        return null;
+    const age = Date.now() - entry.timestamp;
+    if (age < specTtlMs) {
+        (0, loggerUtil_1.logDebug)(`Spec-aware cache hit for ${url} (age=${Math.round(age / 1000)}s, ttl=${Math.round(specTtlMs / 1000)}s)`);
+        return {
+            headers: entry.headers,
+            body: entry.data,
+            fromCache: true,
+            cacheHitType: 'spec-ttl',
+        };
+    }
+    return null;
+}
 const parseCacheControlTtl = (headers) => {
-    const cacheControl = headers['cache-control'] || headers['Cache-Control'];
+    const cacheControl = headers['cache-control'] ?? headers['Cache-Control'];
     if (!cacheControl)
         return undefined;
     const match = /max-age=(\d+)/.exec(cacheControl);
@@ -89,6 +126,7 @@ function handleEarlyStatus(client, status, url, parsed, useETag) {
                     headers: { ...cachedEntry.headers, ...parsed.raw },
                     body: cachedEntry.data,
                     fromCache: true,
+                    cacheHitType: 'etag-304',
                 };
             }
         }
@@ -108,6 +146,7 @@ function tryStaleCacheResponse(client, url, parsed) {
         body: cachedEntry.data,
         fromCache: true,
         stale: true,
+        cacheHitType: 'stale-on-error',
     };
 }
 function cacheResponse(client, url, method, endpoint, parsed, data, useETag) {
@@ -141,7 +180,7 @@ function handleCursorPagination(parsed, data) {
     };
     return { headers: parsed.raw, body: data, cursors };
 }
-async function handleOffsetPagination(client, endpoint, method, requiresAuth, parsed, data, body, url, useETag, pageFetch) {
+async function handleOffsetPagination(client, endpoint, method, requiresAuth, parsed, data, body, url, useETag, pageFetch, templatePath) {
     const totalPages = parsed.xPages;
     if (totalPages <= 1) {
         return { headers: parsed.raw, body: data };
@@ -153,7 +192,7 @@ async function handleOffsetPagination(client, endpoint, method, requiresAuth, pa
             maxPages: Math.min(totalPages, 1000),
             stopOnEmptyPage: true,
             maxRetries: 3,
-        }, pageFetch);
+        }, pageFetch, templatePath);
         cacheResponse(client, url, method, endpoint, parsed, allData, useETag);
         return { headers: parsed.raw, body: allData };
     }
@@ -222,7 +261,7 @@ function handleErrorResponse(client, response, url, parsed, useETag) {
     throw new error_1.EsiError(response.status, errorMessage, url, parsed.requestId ?? undefined);
 }
 function wrapError(error) {
-    if (error instanceof error_1.EsiError) {
+    if (error instanceof error_1.EsiError || error instanceof CircuitBreaker_1.CircuitOpenError) {
         throw error;
     }
     if (error instanceof Error) {
@@ -232,7 +271,7 @@ function wrapError(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) {
+async function executeSingleFetch(client, endpoint, method, body, requiresAuth, useETag, requestTimeout, templatePath) {
     const rawUrl = `${client.getLink()}/${endpoint}`;
     const builtHeaders = buildRequestHeaders(client, rawUrl, method, requiresAuth, useETag, body);
     const req = await applyRequestMiddleware(client, rawUrl, endpoint, method, builtHeaders, body);
@@ -247,8 +286,8 @@ async function executeSingleFetch(client, endpoint, method, body, requiresAuth,
     if (cb)
         cb.checkCircuit(endpoint);
     const rateLimiter = resolveRateLimiter(client);
-    await rateLimiter.checkRateLimit();
-    const timeoutMs = client.getTimeout();
+    await rateLimiter.checkRateLimit(templatePath, method, req.headers);
+    const timeoutMs = requestTimeout ?? client.getTimeout();
     const controller = new AbortController();
     const timer = globalThis.setTimeout(() => controller.abort(), timeoutMs);
     options.signal = controller.signal;
@@ -259,13 +298,13 @@ async function executeSingleFetch(client, endpoint, method, body, requiresAuth,
     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 new error_1.TimeoutError(timeoutMs, url);
         }
         throw err;
     }
     clearTimeout(timer);
     const parsed = (0, headersUtil_1.parseHeaders)(response.headers);
-    rateLimiter.updateFromResponse(parsed.raw, response.status);
+    rateLimiter.updateFromResponse(parsed.raw, response.status, templatePath, method, req.headers);
     if (cb) {
         if (response.status >= 500 ||
             response.status === 420 ||
@@ -281,22 +320,23 @@ async function executeSingleFetch(client, endpoint, method, body, requiresAuth,
     }
     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);
+async function fetchOnePage(client, endpoint, method, body, requiresAuth = false, useETag = false, requestTimeout, templatePath) {
+    const { response, parsed, url } = await executeSingleFetch(client, endpoint, method, body, requiresAuth, useETag, requestTimeout, templatePath);
     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 executeRequest = async (client, endpoint, method, body, requiresAuth = false, useETag = true, requestTimeout, templatePath) => {
     const startTime = Date.now();
     const finish = (r) => {
+        r.responseTimeMs = Date.now() - startTime;
         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);
+        const { response, parsed, url } = await executeSingleFetch(client, endpoint, method, body, requiresAuth, useETag, requestTimeout, templatePath);
         if (response.status === 201) {
             let data;
             try {
@@ -320,50 +360,76 @@ const executeRequest = async (client, endpoint, method, body, requiresAuth = fal
         if (cursorResult)
             return finish(cursorResult);
         const pageFetch = async (paginatedEndpoint) => {
-            const result = await fetchOnePage(client, paginatedEndpoint, method, body, requiresAuth);
+            const result = await fetchOnePage(client, paginatedEndpoint, method, body, requiresAuth, false, requestTimeout, templatePath);
             return Array.isArray(result.data)
                 ? result.data
                 : [result.data];
         };
-        const paginatedResult = await handleOffsetPagination(client, endpoint, method, requiresAuth, parsed, data, body, url, useETag, pageFetch);
+        const paginatedResult = await handleOffsetPagination(client, endpoint, method, requiresAuth, parsed, data, body, url, useETag, pageFetch, templatePath);
         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 handleRequest = async (client, endpoint, method, body, requiresAuth = false, useETag = true, templatePath, requestTimeout) => {
+    const rawUrl = `${client.getLink()}/${endpoint}`;
+    const specHit = trySpecAwareCacheHit(client, rawUrl, method, templatePath);
+    if (specHit)
+        return specHit;
+    const doExecute = () => executeRequest(client, endpoint, method, body, requiresAuth, useETag, requestTimeout, templatePath);
     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);
+    const retryConfig = client.getRetryConfig();
+    const maxRetries = retryConfig?.maxRetries ?? 0;
+    const canRetryMethod = method === 'GET' || retryConfig?.retryMutations === true;
+    const baseDelayMs = retryConfig?.baseDelayMs ?? 1000;
+    const maxDelayMs = retryConfig?.maxDelayMs ?? 30000;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return canDedup
+                ? await dedup.dedupe(endpoint, doExecute)
+                : await doExecute();
+        }
+        catch (error) {
+            if (error instanceof CircuitBreaker_1.CircuitOpenError) {
+                throw error;
             }
-            catch (refreshError) {
-                if (refreshError instanceof error_1.EsiError) {
-                    throw refreshError;
+            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, requestTimeout);
+                }
+                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');
                 }
-                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');
             }
+            if (error instanceof error_1.EsiError &&
+                error.retryable &&
+                canRetryMethod &&
+                attempt < maxRetries) {
+                const delay = (0, retry_1.retryDelay)(attempt, baseDelayMs, maxDelayMs);
+                (0, loggerUtil_1.logWarn)(`Request to ${endpoint} failed (${error.statusCode}), retrying in ${Math.round(delay)}ms (attempt ${attempt + 1}/${maxRetries})`);
+                await (0, sleep_1.sleep)(delay);
+                lastError = error;
+                continue;
+            }
+            throw error;
         }
-        throw error;
     }
+    throw lastError;
 };
 exports.handleRequest = handleRequest;

package/dist/core/BatchRequestHandler.d.ts

@@ -0,0 +1,12 @@
+import { EsiError } from './util/error';
+export interface BatchOptions {
+    concurrency?: number;
+    onProgress?: (completed: number, total: number) => void;
+}
+export interface BatchResult<K, T> {
+    results: Map<K, T>;
+    errors: Map<K, EsiError | Error>;
+}
+export declare function batchFetch<K, T>(keys: K[], fetcher: (key: K) => Promise<T>, options?: BatchOptions): Promise<BatchResult<K, T>>;
+export declare function batchPost<T>(ids: number[], poster: (chunk: number[]) => Promise<T[]>, chunkSize?: number): Promise<T[]>;
+//# sourceMappingURL=BatchRequestHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchRequestHandler.d.ts","sourceRoot":"","sources":["../../src/core/BatchRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,EAAE,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;CAClC;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EACnC,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC/B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAqD5B;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EAAE,EACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,EACzC,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC,CAiBd"}

package/dist/core/BatchRequestHandler.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchFetch = batchFetch;
+exports.batchPost = batchPost;
+const error_1 = require("./util/error");
+const loggerUtil_1 = require("./logger/loggerUtil");
+async function batchFetch(keys, fetcher, options = {}) {
+    const concurrency = options.concurrency ?? 20;
+    const results = new Map();
+    const errors = new Map();
+    let completed = 0;
+    let running = 0;
+    let index = 0;
+    (0, loggerUtil_1.logInfo)(`Batch fetch: ${keys.length} items, concurrency=${concurrency}`);
+    return new Promise((resolve) => {
+        function next() {
+            while (running < concurrency && index < keys.length) {
+                const currentIndex = index++;
+                const key = keys[currentIndex];
+                running++;
+                fetcher(key)
+                    .then((result) => {
+                    results.set(key, result);
+                })
+                    .catch((err) => {
+                    const error = err instanceof error_1.EsiError || err instanceof Error
+                        ? err
+                        : new Error(String(err));
+                    errors.set(key, error);
+                })
+                    .finally(() => {
+                    running--;
+                    completed++;
+                    if (options.onProgress) {
+                        options.onProgress(completed, keys.length);
+                    }
+                    if (completed === keys.length) {
+                        (0, loggerUtil_1.logDebug)(`Batch complete: ${results.size} succeeded, ${errors.size} failed`);
+                        resolve({ results, errors });
+                    }
+                    else {
+                        next();
+                    }
+                });
+            }
+        }
+        if (keys.length === 0) {
+            resolve({ results, errors });
+            return;
+        }
+        next();
+    });
+}
+async function batchPost(ids, poster, chunkSize = 1000) {
+    const chunks = [];
+    for (let i = 0; i < ids.length; i += chunkSize) {
+        chunks.push(ids.slice(i, i + chunkSize));
+    }
+    (0, loggerUtil_1.logInfo)(`Batch POST: ${ids.length} IDs in ${chunks.length} chunks of ${chunkSize}`);
+    const results = [];
+    for (const chunk of chunks) {
+        const chunkResult = await poster(chunk);
+        results.push(...chunkResult);
+    }
+    return results;
+}

package/dist/core/constants.d.ts

@@ -1,5 +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 PACKAGE_VERSION = "5.2.0";
+export declare const USER_AGENT = "esi.ts/5.2.0";
 export declare const COMPATIBILITY_DATE = "2026-05-19";
 //# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"createClient.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/createClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAmB,MAAM,2BAA2B,CAAC;AAKzE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI;KACzC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAC/D,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACvC,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAmBF,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAChD,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,aAAa,CAAC,CAAC,CAAC,CA8HlB;AAGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,KAAK,GAAG,OAAO,EAClE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,EAChE,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,EAAE,EAC1C,SAAS,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GACA,OAAO,CAAC,KAAK,EAAE,CAAC,CA0BlB"}
+{"version":3,"file":"createClient.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/createClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAmB,MAAM,2BAA2B,CAAC;AAKzE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI;KACzC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAC/D,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACvC,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AA8BF,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAChD,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,aAAa,CAAC,CAAC,CAAC,CAkIlB;AAGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,KAAK,GAAG,OAAO,EAClE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,EAChE,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,EAAE,EAC1C,SAAS,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GACA,OAAO,CAAC,KAAK,EAAE,CAAC,CA0BlB"}

package/dist/core/endpoints/createClient.js

@@ -12,6 +12,10 @@ function buildMeta(response) {
         fromCache: response.fromCache ?? false,
         stale: response.stale ?? false,
     };
+    if (response.cacheHitType)
+        meta.cacheHitType = response.cacheHitType;
+    if (response.responseTimeMs !== undefined)
+        meta.responseTimeMs = response.responseTimeMs;
     const w = (0, headersUtil_1.parseWarning)(response.headers['warning']);
     if (w)
         meta.warning = w;
@@ -21,6 +25,14 @@ function buildMeta(response) {
         meta.date = response.headers['date'];
     if (response.headers['content-language'])
         meta.contentLanguage = response.headers['content-language'];
+    if (response.headers['x-ratelimit-remaining']) {
+        meta.rateLimit = {
+            remaining: parseInt(response.headers['x-ratelimit-remaining'], 10),
+            limit: parseInt(response.headers['x-ratelimit-limit'] ?? '0', 10),
+            used: parseInt(response.headers['x-ratelimit-used'] ?? '0', 10),
+            group: response.headers['x-ratelimit-group'] ?? null,
+        };
+    }
     return meta;
 }
 /* eslint-disable sonarjs/cognitive-complexity */
@@ -96,7 +108,7 @@ function createClient(apiClient, endpoints, options) {
                         path += (path.includes('?') ? '&' : '?') + parts.join('&');
                     }
                 }
-                const response = await (0, ApiRequestHandler_1.handleRequest)(apiClient, path, def.method, body, def.requiresAuth);
+                const response = await (0, ApiRequestHandler_1.handleRequest)(apiClient, path, def.method, body, def.requiresAuth, true, def.path);
                 const responseBody = response.body;
                 let data;
                 if (Array.isArray(responseBody)) {
@@ -117,7 +129,7 @@ function createClient(apiClient, endpoints, options) {
                 }
                 return cursorResult;
             }
-            const response = await (0, ApiRequestHandler_1.handleRequest)(apiClient, path, def.method, body, def.requiresAuth);
+            const response = await (0, ApiRequestHandler_1.handleRequest)(apiClient, path, def.method, body, def.requiresAuth, true, def.path);
             if (returnMetadata) {
                 return { data: response.body, meta: buildMeta(response) };
             }

package/dist/core/endpoints/esi-cache-ttls.generated.d.ts

@@ -0,0 +1,2 @@
+export declare const esiCacheTtls: Record<string, number>;
+//# sourceMappingURL=esi-cache-ttls.generated.d.ts.map

package/dist/core/endpoints/esi-cache-ttls.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esi-cache-ttls.generated.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/esi-cache-ttls.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwH/C,CAAC"}

package/dist/core/endpoints/esi-cache-ttls.generated.js

@@ -0,0 +1,126 @@
+"use strict";
+// Auto-generated from ESI Swagger spec — do not edit manually
+// Endpoints with cache TTLs: 119
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.esiCacheTtls = void 0;
+exports.esiCacheTtls = {
+    'GET:alliances': 3600,
+    'GET:alliances/{alliance_id}': 3600,
+    'GET:alliances/{alliance_id}/contacts': 300,
+    'GET:alliances/{alliance_id}/contacts/labels': 300,
+    'GET:alliances/{alliance_id}/corporations': 3600,
+    'GET:characters/{character_id}': 604800,
+    'GET:characters/{character_id}/agents_research': 3600,
+    'GET:characters/{character_id}/assets': 3600,
+    'GET:characters/{character_id}/attributes': 120,
+    'GET:characters/{character_id}/blueprints': 3600,
+    'GET:characters/{character_id}/calendar': 5,
+    'GET:characters/{character_id}/calendar/{event_id}': 5,
+    'PUT:characters/{character_id}/calendar/{event_id}': 5,
+    'GET:characters/{character_id}/calendar/{event_id}/attendees': 600,
+    'GET:characters/{character_id}/clones': 120,
+    'GET:characters/{character_id}/contacts': 300,
+    'GET:characters/{character_id}/contacts/labels': 300,
+    'GET:characters/{character_id}/contracts': 300,
+    'GET:characters/{character_id}/contracts/{contract_id}/bids': 300,
+    'GET:characters/{character_id}/contracts/{contract_id}/items': 3600,
+    'GET:characters/{character_id}/corporationhistory': 86400,
+    'GET:characters/{character_id}/fatigue': 300,
+    'GET:characters/{character_id}/fittings': 300,
+    'GET:characters/{character_id}/fleet': 60,
+    'GET:characters/{character_id}/implants': 120,
+    'GET:characters/{character_id}/industry/jobs': 300,
+    'GET:characters/{character_id}/killmails/recent': 300,
+    'GET:characters/{character_id}/location': 5,
+    'GET:characters/{character_id}/loyalty/points': 3600,
+    'GET:characters/{character_id}/mail': 30,
+    'GET:characters/{character_id}/mail/{mail_id}': 30,
+    'GET:characters/{character_id}/mail/labels': 30,
+    'GET:characters/{character_id}/mail/lists': 120,
+    'GET:characters/{character_id}/medals': 3600,
+    'GET:characters/{character_id}/mining': 600,
+    'GET:characters/{character_id}/notifications': 600,
+    'GET:characters/{character_id}/notifications/contacts': 600,
+    'GET:characters/{character_id}/online': 60,
+    'GET:characters/{character_id}/orders': 1200,
+    'GET:characters/{character_id}/orders/history': 3600,
+    'GET:characters/{character_id}/planets': 600,
+    'GET:characters/{character_id}/roles': 3600,
+    'GET:characters/{character_id}/search': 3600,
+    'GET:characters/{character_id}/ship': 5,
+    'GET:characters/{character_id}/skillqueue': 120,
+    'GET:characters/{character_id}/skills': 120,
+    'GET:characters/{character_id}/standings': 3600,
+    'GET:characters/{character_id}/titles': 3600,
+    'GET:characters/{character_id}/wallet': 120,
+    'GET:characters/{character_id}/wallet/journal': 3600,
+    'GET:characters/{character_id}/wallet/transactions': 3600,
+    'POST:characters/affiliation': 3600,
+    'GET:contracts/public/{region_id}': 1800,
+    'GET:contracts/public/bids/{contract_id}': 300,
+    'GET:contracts/public/items/{contract_id}': 3600,
+    'GET:corporation/{corporation_id}/mining/extractions': 1800,
+    'GET:corporation/{corporation_id}/mining/observers': 3600,
+    'GET:corporation/{corporation_id}/mining/observers/{observer_id}': 3600,
+    'GET:corporations/{corporation_id}': 3600,
+    'GET:corporations/{corporation_id}/alliancehistory': 3600,
+    'GET:corporations/{corporation_id}/assets': 3600,
+    'GET:corporations/{corporation_id}/blueprints': 3600,
+    'GET:corporations/{corporation_id}/contacts': 300,
+    'GET:corporations/{corporation_id}/contacts/labels': 300,
+    'GET:corporations/{corporation_id}/containers/logs': 600,
+    'GET:corporations/{corporation_id}/contracts': 300,
+    'GET:corporations/{corporation_id}/contracts/{contract_id}/bids': 3600,
+    'GET:corporations/{corporation_id}/contracts/{contract_id}/items': 3600,
+    'GET:corporations/{corporation_id}/customs_offices': 3600,
+    'GET:corporations/{corporation_id}/divisions': 3600,
+    'GET:corporations/{corporation_id}/facilities': 3600,
+    'GET:corporations/{corporation_id}/icons': 3600,
+    'GET:corporations/{corporation_id}/industry/jobs': 300,
+    'GET:corporations/{corporation_id}/killmails/recent': 300,
+    'GET:corporations/{corporation_id}/medals': 3600,
+    'GET:corporations/{corporation_id}/medals/issued': 3600,
+    'GET:corporations/{corporation_id}/members': 3600,
+    'GET:corporations/{corporation_id}/members/limit': 3600,
+    'GET:corporations/{corporation_id}/members/titles': 3600,
+    'GET:corporations/{corporation_id}/membertracking': 3600,
+    'GET:corporations/{corporation_id}/orders': 1200,
+    'GET:corporations/{corporation_id}/orders/history': 3600,
+    'GET:corporations/{corporation_id}/roles': 3600,
+    'GET:corporations/{corporation_id}/roles/history': 3600,
+    'GET:corporations/{corporation_id}/shareholders': 3600,
+    'GET:corporations/{corporation_id}/standings': 3600,
+    'GET:corporations/{corporation_id}/starbases': 3600,
+    'GET:corporations/{corporation_id}/starbases/{starbase_id}': 3600,
+    'GET:corporations/{corporation_id}/structures': 3600,
+    'GET:corporations/{corporation_id}/titles': 3600,
+    'GET:corporations/{corporation_id}/wallets': 300,
+    'GET:corporations/{corporation_id}/wallets/{division}/journal': 3600,
+    'GET:corporations/{corporation_id}/wallets/{division}/transactions': 3600,
+    'GET:fleets/{fleet_id}': 5,
+    'GET:fleets/{fleet_id}/members': 5,
+    'GET:fleets/{fleet_id}/wings': 5,
+    'GET:fw/systems': 1800,
+    'GET:incursions': 300,
+    'GET:industry/facilities': 3600,
+    'GET:industry/systems': 3600,
+    'GET:insurance/prices': 3600,
+    'GET:killmails/{killmail_id}/{killmail_hash}': 30758400,
+    'GET:markets/{region_id}/orders': 300,
+    'GET:markets/{region_id}/types': 600,
+    'GET:markets/prices': 3600,
+    'GET:markets/structures/{structure_id}': 300,
+    'GET:route/{origin}/{destination}': 86400,
+    'GET:sovereignty/campaigns': 5,
+    'GET:sovereignty/map': 3600,
+    'GET:sovereignty/structures': 120,
+    'GET:status': 30,
+    'GET:universe/schematics/{schematic_id}': 3600,
+    'GET:universe/structures': 3600,
+    'GET:universe/structures/{structure_id}': 3600,
+    'GET:universe/system_jumps': 3600,
+    'GET:universe/system_kills': 3600,
+    'GET:wars': 3600,
+    'GET:wars/{war_id}': 3600,
+    'GET:wars/{war_id}/killmails': 3600,
+};

package/dist/core/endpoints/esi-rate-limit-groups.generated.d.ts

@@ -0,0 +1,7 @@
+export interface RateLimitGroupSpec {
+    group: string;
+    maxTokens: number;
+    windowSizeMs: number;
+}
+export declare const esiRateLimitGroups: Record<string, RateLimitGroupSpec>;
+//# sourceMappingURL=esi-rate-limit-groups.generated.d.ts.map

package/dist/core/endpoints/esi-rate-limit-groups.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esi-rate-limit-groups.generated.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/esi-rate-limit-groups.generated.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAmJjE,CAAC"}