@lgriffin/esi.ts 7.4.0 → 9.0.0

package/dist/core/endpoints/uiEndpoints.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uiEndpoints = void 0;
-exports.uiEndpoints = {
-    setAutopilotWaypoint: {
-        path: 'ui/autopilot/waypoint',
-        method: 'POST',
-        requiresAuth: true,
-        queryParams: {
-            destinationId: 'destination_id',
-            addToBeginning: 'add_to_beginning',
-            clearOtherWaypoints: 'clear_other_waypoints',
-        },
-    },
-    openContractWindow: {
-        path: 'ui/openwindow/contract',
-        method: 'POST',
-        requiresAuth: true,
-        queryParams: { contractId: 'contract_id' },
-    },
-    openInformationWindow: {
-        path: 'ui/openwindow/information',
-        method: 'POST',
-        requiresAuth: true,
-        queryParams: { targetId: 'target_id' },
-    },
-    openMarketDetailsWindow: {
-        path: 'ui/openwindow/marketdetails',
-        method: 'POST',
-        requiresAuth: true,
-        queryParams: { typeId: 'type_id' },
-    },
-    openNewMailWindow: {
-        path: 'ui/openwindow/newmail',
-        method: 'POST',
-        requiresAuth: true,
-        hasBody: true,
-    },
-};

package/dist/core/endpoints/universeEndpoints.js

@@ -1,210 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.universeEndpoints = void 0;
-const zod_1 = require("zod");
-const universe_1 = require("../../schemas/universe");
-exports.universeEndpoints = {
-    getAncestries: {
-        path: 'universe/ancestries',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(universe_1.AncestrySchema),
-    },
-    getAsteroidBeltInfo: {
-        path: 'universe/asteroid_belts/{asteroidBeltId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['asteroidBeltId'],
-        responseSchema: universe_1.AsteroidBeltInfoSchema,
-    },
-    getBloodlines: {
-        path: 'universe/bloodlines',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(universe_1.BloodlineSchema),
-    },
-    getCategories: {
-        path: 'universe/categories',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getCategoryById: {
-        path: 'universe/categories/{categoryId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['categoryId'],
-        responseSchema: universe_1.ItemCategorySchema,
-    },
-    getConstellations: {
-        path: 'universe/constellations',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getConstellationById: {
-        path: 'universe/constellations/{constellationId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['constellationId'],
-        responseSchema: universe_1.ConstellationInfoSchema,
-    },
-    getFactions: {
-        path: 'universe/factions',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(universe_1.FactionSchema),
-    },
-    getGraphics: {
-        path: 'universe/graphics',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getGraphicById: {
-        path: 'universe/graphics/{graphicId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['graphicId'],
-        responseSchema: universe_1.GraphicInfoSchema,
-    },
-    getItemGroups: {
-        path: 'universe/groups',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getItemGroupById: {
-        path: 'universe/groups/{groupId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['groupId'],
-        responseSchema: universe_1.ItemGroupSchema,
-    },
-    postBulkNamesToIds: {
-        path: 'universe/ids',
-        method: 'POST',
-        requiresAuth: false,
-        bodyBuilder: (names) => names,
-        responseSchema: universe_1.BulkIdResultSchema,
-    },
-    getMoonById: {
-        path: 'universe/moons/{moonId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['moonId'],
-        responseSchema: universe_1.MoonInfoSchema,
-    },
-    postNamesAndCategories: {
-        path: 'universe/names',
-        method: 'POST',
-        requiresAuth: false,
-        bodyBuilder: (ids) => ids,
-        responseSchema: zod_1.z.array(universe_1.NameAndCategorySchema),
-    },
-    getPlanetById: {
-        path: 'universe/planets/{planetId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['planetId'],
-        responseSchema: universe_1.PlanetInfoSchema,
-    },
-    getRaces: {
-        path: 'universe/races',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(universe_1.RaceSchema),
-    },
-    getRegions: {
-        path: 'universe/regions',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getRegionById: {
-        path: 'universe/regions/{regionId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['regionId'],
-        responseSchema: universe_1.RegionInfoSchema,
-    },
-    getSchematicById: {
-        path: 'universe/schematics/{schematicId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['schematicId'],
-        responseSchema: universe_1.SchematicInfoSchema,
-    },
-    getStargateById: {
-        path: 'universe/stargates/{stargateId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['stargateId'],
-        responseSchema: universe_1.StargateInfoSchema,
-    },
-    getStarById: {
-        path: 'universe/stars/{starId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['starId'],
-        responseSchema: universe_1.StarInfoSchema,
-    },
-    getStationById: {
-        path: 'universe/stations/{stationId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['stationId'],
-        responseSchema: universe_1.StationInfoSchema,
-    },
-    getStructures: {
-        path: 'universe/structures',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getStructureById: {
-        path: 'universe/structures/{structureId}',
-        method: 'GET',
-        requiresAuth: true,
-        pathParams: ['structureId'],
-        responseSchema: universe_1.StructureInfoSchema,
-    },
-    getSystemJumps: {
-        path: 'universe/system_jumps',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(universe_1.SystemJumpSchema),
-    },
-    getSystemKills: {
-        path: 'universe/system_kills',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(universe_1.SystemKillSchema),
-    },
-    getSystems: {
-        path: 'universe/systems',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getSystemById: {
-        path: 'universe/systems/{systemId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['systemId'],
-        responseSchema: universe_1.SolarSystemInfoSchema,
-    },
-    getTypes: {
-        path: 'universe/types',
-        method: 'GET',
-        requiresAuth: false,
-        responseSchema: zod_1.z.array(zod_1.z.number()),
-    },
-    getTypeById: {
-        path: 'universe/types/{typeId}',
-        method: 'GET',
-        requiresAuth: false,
-        pathParams: ['typeId'],
-        responseSchema: universe_1.TypeInfoSchema,
-    },
-};

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;