@lgriffin/esi.ts 7.4.0 → 8.0.0

package/dist/core/endpoints/walletEndpoints.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.walletEndpoints = void 0;
-const zod_1 = require("zod");
-const wallet_1 = require("../../schemas/wallet");
-const corporation_1 = require("../../schemas/corporation");
-exports.walletEndpoints = {
-    getCharacterWallet: {
-        path: 'characters/{characterId}/wallet',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.number(),
-    },
-    getCharacterWalletJournal: {
-        path: 'characters/{characterId}/wallet/journal',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(wallet_1.WalletJournalSchema),
-    },
-    getCharacterWalletTransactions: {
-        path: 'characters/{characterId}/wallet/transactions',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['characterId'],
-        responseSchema: zod_1.z.array(wallet_1.WalletTransactionSchema),
-    },
-    getCorporationWallets: {
-        path: 'corporations/{corporationId}/wallets',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['corporationId'],
-        responseSchema: zod_1.z.array(corporation_1.CorporationWalletDivisionSchema),
-    },
-    getCorporationWalletJournal: {
-        path: 'corporations/{corporationId}/wallets/{division}/journal',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['corporationId', 'division'],
-        responseSchema: zod_1.z.array(wallet_1.WalletJournalSchema),
-    },
-    getCorporationWalletTransactions: {
-        path: 'corporations/{corporationId}/wallets/{division}/transactions',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['corporationId', 'division'],
-        responseSchema: zod_1.z.array(wallet_1.WalletTransactionSchema),
-    },
-};

package/dist/core/endpoints/warEndpoints.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.warEndpoints = void 0;
-const zod_1 = require("zod");
-const wars_1 = require("../../schemas/wars");
-const killmails_1 = require("../../schemas/killmails");
-exports.warEndpoints = {
-    getWars: {
-        path: 'wars',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getWarById: {
-        path: 'wars/{warId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['warId'],
-        responseSchema: wars_1.WarSchema,
-    },
-    getWarKillmails: {
-        path: 'wars/{warId}/killmails',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['warId'],
-        responseSchema: zod_1.z.array(killmails_1.KillmailSummarySchema),
-    },
-};

package/dist/core/logger/ILogger.js

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

package/dist/core/logger/logger.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const winston_1 = require("winston");
-const { combine, timestamp, printf, colorize } = winston_1.format;
-// Define custom log format
-const logFormat = printf(({ level, message, timestamp }) => {
-    return `${String(timestamp)} [${String(level)}]: ${String(message)}`;
-});
-// Create Winston logger instance — console only by default.
-// Libraries should not write to files; the consuming application controls logging.
-const logger = (0, winston_1.createLogger)({
-    level: process.env.ESI_LOG_LEVEL || 'warn',
-    format: combine(colorize(), timestamp(), logFormat),
-    transports: [new winston_1.transports.Console()],
-});
-exports.default = logger;

package/dist/core/logger/loggerUtil.js

@@ -1,30 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logDebug = exports.logWarn = exports.logError = exports.logInfo = exports.getLogger = exports.setLogger = void 0;
-const logger_1 = __importDefault(require("./logger"));
-let activeLogger = logger_1.default;
-const setLogger = (customLogger) => {
-    activeLogger = customLogger;
-};
-exports.setLogger = setLogger;
-const getLogger = () => activeLogger;
-exports.getLogger = getLogger;
-const logInfo = (message) => {
-    activeLogger.info(message);
-};
-exports.logInfo = logInfo;
-const logError = (message) => {
-    activeLogger.error(message);
-};
-exports.logError = logError;
-const logWarn = (message) => {
-    activeLogger.warn(message);
-};
-exports.logWarn = logWarn;
-const logDebug = (message) => {
-    activeLogger.debug(message);
-};
-exports.logDebug = logDebug;

package/dist/core/middleware/Middleware.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MiddlewareManager = void 0;
-class MiddlewareManager {
-    requestInterceptors = [];
-    responseInterceptors = [];
-    addRequestInterceptor(fn) {
-        this.requestInterceptors.push(fn);
-        return () => {
-            this.requestInterceptors = this.requestInterceptors.filter((i) => i !== fn);
-        };
-    }
-    addResponseInterceptor(fn) {
-        this.responseInterceptors.push(fn);
-        return () => {
-            this.responseInterceptors = this.responseInterceptors.filter((i) => i !== fn);
-        };
-    }
-    async applyRequestInterceptors(context) {
-        let ctx = context;
-        for (const interceptor of this.requestInterceptors) {
-            ctx = await interceptor(ctx);
-        }
-        return ctx;
-    }
-    async applyResponseInterceptors(context) {
-        let ctx = context;
-        for (const interceptor of this.responseInterceptors) {
-            ctx = await interceptor(ctx);
-        }
-        return ctx;
-    }
-    hasInterceptors() {
-        return (this.requestInterceptors.length > 0 ||
-            this.responseInterceptors.length > 0);
-    }
-    clear() {
-        this.requestInterceptors = [];
-        this.responseInterceptors = [];
-    }
-}
-exports.MiddlewareManager = MiddlewareManager;

package/dist/core/pagination/AsyncPaginationIterator.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchPages = fetchPages;
-const ApiRequestHandler_1 = require("../ApiRequestHandler");
-const loggerUtil_1 = require("../logger/loggerUtil");
-function extractArray(body) {
-    if (Array.isArray(body))
-        return body;
-    if (body !== undefined && body !== null)
-        return [body];
-    return [];
-}
-async function* fetchPages(client, endpoint, method, requiresAuth = false, body) {
-    const firstResponse = await (0, ApiRequestHandler_1.handleSinglePageRequest)(client, endpoint, method, body, requiresAuth);
-    const totalPages = parseInt(firstResponse.headers['x-pages'] || '1', 10);
-    yield { data: extractArray(firstResponse.body), page: 1, totalPages };
-    for (let page = 2; page <= totalPages; page++) {
-        const sep = endpoint.includes('?') ? '&' : '?';
-        const pagedEndpoint = `${endpoint}${sep}page=${page}`;
-        (0, loggerUtil_1.logInfo)(`Fetching page ${page}/${totalPages}: ${pagedEndpoint}`);
-        const response = await (0, ApiRequestHandler_1.handleSinglePageRequest)(client, pagedEndpoint, method, body, requiresAuth);
-        const pageData = extractArray(response.body);
-        if (pageData.length === 0)
-            break;
-        yield { data: pageData, page, totalPages };
-    }
-}

package/dist/core/pagination/CursorPaginationHandler.js

@@ -1,148 +0,0 @@
-"use strict";
-/**
- * Cursor-based Pagination Handler for ESI API calls.
- *
- * New ESI routes (starting with Corporation Projects) use opaque
- * before/after cursor tokens instead of page numbers.
- *
- * Response headers:
- *   x-cursor-before  – token to fetch data preceding the current batch
- *   x-cursor-after   – token to fetch data following the current batch
- *
- * Query parameters:
- *   before=<token>    – crawl backwards
- *   after=<token>     – crawl forwards
- *
- * An empty result array signals the beginning/end of the dataset.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CursorPaginationHandler = void 0;
-const loggerUtil_1 = require("../logger/loggerUtil");
-const constants_1 = require("../constants");
-const sleep_1 = require("../util/sleep");
-class CursorPaginationHandler {
-    static DEFAULT_OPTIONS = {
-        maxPages: 1000,
-        maxRetries: 3,
-        retryDelayMs: 1000,
-    };
-    /**
-     * Fetch a single cursor page, returning data + cursor tokens.
-     */
-    static async fetchPage(client, endpoint, method, requiresAuth, cursor, body) {
-        const url = this.buildUrl(client, endpoint, cursor);
-        (0, loggerUtil_1.logInfo)(`Cursor fetch: ${url}`);
-        const response = await fetch(url, {
-            method,
-            headers: {
-                accept: 'gzip, deflate, br',
-                'User-Agent': constants_1.USER_AGENT,
-                'X-Compatibility-Date': constants_1.COMPATIBILITY_DATE,
-                ...(requiresAuth
-                    ? { Authorization: client.getAuthorizationHeader() }
-                    : {}),
-            },
-            body: body ? JSON.stringify(body) : undefined,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-        }
-        let data;
-        try {
-            const parsed = await response.json();
-            data = Array.isArray(parsed) ? parsed : [parsed];
-        }
-        catch (jsonError) {
-            throw new Error(`Invalid JSON response: ${jsonError instanceof Error ? jsonError.message : String(jsonError)}`);
-        }
-        const cursors = this.extractCursors(response.headers);
-        return { data, cursors };
-    }
-    /**
-     * Auto-fetch all pages by following `after` tokens until an empty
-     * response is received.  Combines the caller-supplied first page
-     * data with all subsequent pages.
-     */
-    static async fetchAll(client, endpoint, method, requiresAuth, firstPageData, firstCursors, body, options = {}) {
-        const opts = { ...this.DEFAULT_OPTIONS, ...options };
-        const rateLimiter = client.getRateLimiter();
-        const allData = [...firstPageData];
-        let afterToken = firstCursors.after;
-        let pageCount = 1;
-        let consecutiveFailures = 0;
-        while (afterToken && pageCount < opts.maxPages) {
-            try {
-                if (rateLimiter)
-                    await rateLimiter.checkRateLimit();
-                const page = await this.fetchPageWithRetry(client, endpoint, method, requiresAuth, { after: afterToken }, body, opts);
-                consecutiveFailures = 0;
-                pageCount++;
-                if (page.data.length === 0) {
-                    (0, loggerUtil_1.logInfo)('Cursor pagination: empty page received, dataset complete.');
-                    break;
-                }
-                allData.push(...page.data);
-                afterToken = page.cursors.after;
-                (0, loggerUtil_1.logInfo)(`Cursor page ${pageCount} fetched (${page.data.length} items)`);
-            }
-            catch (error) {
-                consecutiveFailures++;
-                (0, loggerUtil_1.logError)(`Cursor page fetch failed: ${error instanceof Error ? error.message : String(error)}`);
-                if (consecutiveFailures >= opts.maxRetries) {
-                    (0, loggerUtil_1.logWarn)(`${consecutiveFailures} consecutive failures. Stopping cursor pagination.`);
-                    break;
-                }
-            }
-        }
-        (0, loggerUtil_1.logInfo)(`Cursor pagination complete. ${allData.length} total items from ${pageCount} pages.`);
-        return allData;
-    }
-    /**
-     * Fetch a single cursor page with retry logic.
-     */
-    static async fetchPageWithRetry(client, endpoint, method, requiresAuth, cursor, body, options) {
-        let lastError = null;
-        for (let attempt = 1; attempt <= options.maxRetries; attempt++) {
-            try {
-                return await this.fetchPage(client, endpoint, method, requiresAuth, cursor, body);
-            }
-            catch (error) {
-                lastError = error;
-                (0, loggerUtil_1.logWarn)(`Cursor fetch attempt ${attempt}/${options.maxRetries} failed: ${error instanceof Error ? error.message : String(error)}`);
-                if (attempt < options.maxRetries) {
-                    await (0, sleep_1.sleep)(options.retryDelayMs * attempt);
-                }
-            }
-        }
-        throw lastError || new Error('Cursor page fetch failed after all retries');
-    }
-    /**
-     * Extract cursor tokens from response headers.
-     */
-    static extractCursors(headers) {
-        const get = (name) => headers.get(name) || null;
-        return {
-            before: get('x-cursor-before'),
-            after: get('x-cursor-after'),
-        };
-    }
-    /**
-     * Build a URL with cursor query parameters appended.
-     */
-    static buildUrl(client, endpoint, cursor) {
-        let url = `${client.getLink()}/${endpoint}`;
-        if (!cursor)
-            return url;
-        const parts = [];
-        if (cursor.before)
-            parts.push(`before=${encodeURIComponent(cursor.before)}`);
-        if (cursor.after)
-            parts.push(`after=${encodeURIComponent(cursor.after)}`);
-        if (parts.length > 0) {
-            const separator = url.includes('?') ? '&' : '?';
-            url += separator + parts.join('&');
-        }
-        return url;
-    }
-}
-exports.CursorPaginationHandler = CursorPaginationHandler;

package/dist/core/pagination/PaginationHandler.js

@@ -1,115 +0,0 @@
-"use strict";
-/**
- * Pagination Handler for ESI API calls
- * Handles pagination with proper error handling and empty page detection
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaginationHandler = void 0;
-const loggerUtil_1 = require("../logger/loggerUtil");
-const constants_1 = require("../constants");
-const sleep_1 = require("../util/sleep");
-class PaginationHandler {
-    static DEFAULT_OPTIONS = {
-        maxPages: 1000, // Reasonable limit to prevent infinite loops
-        maxRetries: 3,
-        retryDelayMs: 1000,
-        stopOnEmptyPage: true,
-    };
-    /**
-     * Fetch remaining pages (2..totalPages) and combine with first page data.
-     * The caller has already fetched page 1 and knows the total page count.
-     */
-    static async fetchRemainingPages(client, endpoint, method, requiresAuth, firstPageData, totalPages, body, options = {}, pageFetch, templatePath) {
-        const opts = { ...this.DEFAULT_OPTIONS, ...options };
-        const rateLimiter = client.getRateLimiter();
-        const allData = [...firstPageData];
-        const effectiveMaxPage = Math.min(totalPages, opts.maxPages);
-        if (effectiveMaxPage <= 1) {
-            return allData;
-        }
-        (0, loggerUtil_1.logInfo)(`Fetching pages 2-${effectiveMaxPage} for ${endpoint}...`);
-        let consecutiveFailures = 0;
-        for (let page = 2; page <= effectiveMaxPage; page++) {
-            try {
-                if (rateLimiter)
-                    await rateLimiter.checkRateLimit(templatePath, method);
-                const pageData = await this.fetchPageWithRetry(client, endpoint, method, page, requiresAuth, body, opts, pageFetch);
-                consecutiveFailures = 0;
-                if (opts.stopOnEmptyPage && (!pageData || pageData.length === 0)) {
-                    (0, loggerUtil_1.logWarn)(`Page ${page} is empty. Stopping pagination.`);
-                    break;
-                }
-                allData.push(...pageData);
-                (0, loggerUtil_1.logInfo)(`Fetched page ${page}/${effectiveMaxPage} (${pageData.length} items)`);
-            }
-            catch (error) {
-                consecutiveFailures++;
-                (0, loggerUtil_1.logError)(`Failed to fetch page ${page}: ${error instanceof Error ? error.message : String(error)}`);
-                if (consecutiveFailures >= opts.maxRetries) {
-                    (0, loggerUtil_1.logWarn)(`${consecutiveFailures} consecutive failures. Stopping pagination.`);
-                    break;
-                }
-            }
-        }
-        (0, loggerUtil_1.logInfo)(`Pagination complete. Fetched ${allData.length} total items from up to ${effectiveMaxPage} pages.`);
-        return allData;
-    }
-    /**
-     * Fetch a single page with retry logic
-     */
-    static async fetchPageWithRetry(client, endpoint, method, page, requiresAuth, body, options, pageFetch) {
-        let lastError = null;
-        for (let attempt = 1; attempt <= options.maxRetries; attempt++) {
-            try {
-                return await this.fetchSinglePage(client, endpoint, method, page, requiresAuth, body, pageFetch);
-            }
-            catch (error) {
-                lastError = error;
-                (0, loggerUtil_1.logWarn)(`Attempt ${attempt}/${options.maxRetries} failed for page ${page}: ${error instanceof Error ? error.message : String(error)}`);
-                if (attempt < options.maxRetries) {
-                    await (0, sleep_1.sleep)(options.retryDelayMs * attempt);
-                }
-            }
-        }
-        throw (lastError ||
-            new Error(`Failed to fetch page ${page} after ${options.maxRetries} attempts`));
-    }
-    /**
-     * Fetch a single page.
-     * Preserves any existing query params on the endpoint and appends page=N.
-     */
-    static async fetchSinglePage(client, endpoint, method, page, requiresAuth, body, pageFetch) {
-        const separator = endpoint.includes('?') ? '&' : '?';
-        const paginatedEndpoint = `${endpoint}${separator}page=${page}`;
-        if (pageFetch) {
-            (0, loggerUtil_1.logInfo)(`Fetching page ${page} via pipeline: ${paginatedEndpoint}`);
-            return pageFetch(paginatedEndpoint);
-        }
-        const url = `${client.getLink()}/${paginatedEndpoint}`;
-        (0, loggerUtil_1.logInfo)(`Fetching page ${page}: ${url}`);
-        const response = await fetch(url, {
-            method,
-            headers: {
-                accept: 'gzip, deflate, br',
-                'User-Agent': constants_1.USER_AGENT,
-                'X-Compatibility-Date': constants_1.COMPATIBILITY_DATE,
-                ...(requiresAuth
-                    ? { Authorization: client.getAuthorizationHeader() }
-                    : {}),
-            },
-            body: body ? JSON.stringify(body) : undefined,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-        }
-        let data;
-        try {
-            data = (await response.json());
-        }
-        catch (jsonError) {
-            throw new Error(`Invalid JSON response for page ${page}: ${jsonError instanceof Error ? jsonError.message : String(jsonError)}`);
-        }
-        return Array.isArray(data) ? data : [data];
-    }
-}
-exports.PaginationHandler = PaginationHandler;

package/dist/core/rateLimiter/IRateLimiter.js

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