eve-esi-types 2.0.4-beta → 2.0.5-beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-esi-types",
-  "version": "2.0.4-beta",
+  "version": "2.0.5-beta",
   "description": "Extracted the main type of ESI. use for ESI request response types",
   "main": "src/index.d.ts",
   "scripts": {
@@ -13,6 +13,16 @@
     "type": "git",
     "url": "git+ssh://git@github.com/jeffy-g/eve-esi-types.git"
   },
+  "files": [
+    "v2",
+    "src",
+    "v2.mjs",
+    "LICENSE",
+    "README.md",
+    "package.json",
+    "tsconfig.json",
+    "esi-request.mjs"
+  ],
   "keywords": [
     "eve",
     "esi",

package/v2/post_universe_ids_ok.d.ts

@@ -1,220 +1,86 @@
 /*!
  * ESI endpoint: /universe/ids/
  */
-/**
- * agents array
- *
- * @maxItems 500
- */
-type PostUniverseIdsAgents = PostUniverseIdsAgent[];
-/**
- * alliances array
- *
- * @maxItems 500
- */
-type PostUniverseIdsAlliances = PostUniverseIdsAlliance[];
-/**
- * characters array
- *
- * @maxItems 500
- */
-type PostUniverseIdsCharacters = PostUniverseIdsCharacter[];
-/**
- * constellations array
- *
- * @maxItems 500
- */
-type PostUniverseIdsConstellations = PostUniverseIdsConstellation[];
-/**
- * corporations array
- *
- * @maxItems 500
- */
-type PostUniverseIdsCorporations = PostUniverseIdsCorporation[];
-/**
- * factions array
- *
- * @maxItems 500
- */
-type PostUniverseIdsFactions = PostUniverseIdsFaction[];
-/**
- * inventory_types array
- *
- * @maxItems 500
- */
-type PostUniverseIdsInventoryTypes = PostUniverseIdsInventoryType[];
-/**
- * regions array
- *
- * @maxItems 500
- */
-type PostUniverseIdsRegions = PostUniverseIdsRegion[];
-/**
- * stations array
- *
- * @maxItems 500
- */
-type PostUniverseIdsStations = PostUniverseIdsStation[];
-/**
- * systems array
- *
- * @maxItems 500
- */
-type PostUniverseIdsSystems = PostUniverseIdsSystem[];
 
 /**
- * 200 ok object
- */
-interface PostUniverseIdsOk {
-  agents?: PostUniverseIdsAgents;
-  alliances?: PostUniverseIdsAlliances;
-  characters?: PostUniverseIdsCharacters;
-  constellations?: PostUniverseIdsConstellations;
-  corporations?: PostUniverseIdsCorporations;
-  factions?: PostUniverseIdsFactions;
-  inventory_types?: PostUniverseIdsInventoryTypes;
-  regions?: PostUniverseIdsRegions;
-  stations?: PostUniverseIdsStations;
-  systems?: PostUniverseIdsSystems;
-  [k: string]: unknown | undefined;
-}
-/**
- * agent object
- */
-interface PostUniverseIdsAgent {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * alliance object
- */
-interface PostUniverseIdsAlliance {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * character object
- */
-interface PostUniverseIdsCharacter {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * constellation object
- */
-interface PostUniverseIdsConstellation {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * corporation object
- */
-interface PostUniverseIdsCorporation {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * faction object
- */
-interface PostUniverseIdsFaction {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * inventory_type object
- */
-interface PostUniverseIdsInventoryType {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * region object
- */
-interface PostUniverseIdsRegion {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * station object
- */
-interface PostUniverseIdsStation {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
-/**
- * system object
- */
-interface PostUniverseIdsSystem {
-  /**
-   * id integer
-   */
-  id?: number;
-  /**
-   * name string
-   */
-  name?: string;
-  [k: string]: unknown | undefined;
-}
+ * shared interface
+ */
+interface PostUniverseIdsEntity {
+    /**
+     * id integer
+     */
+    id?: number;
+    /**
+     * name string
+     */
+    name?: string;
+    [k: string]: unknown | undefined;
+  }
+  
+  /**
+   * 200 ok object
+   */
+  interface PostUniverseIdsOk {
+    /**
+     * agents array
+     *
+     * @maxItems 500
+     */
+    agents?: PostUniverseIdsEntity[];
+    /**
+     * alliances array
+     *
+     * @maxItems 500
+     */
+    alliances?: PostUniverseIdsEntity[];
+    /**
+     * characters array
+     *
+     * @maxItems 500
+     */
+    characters?: PostUniverseIdsEntity[];
+    /**
+     * constellations array
+     *
+     * @maxItems 500
+     */
+    constellations?: PostUniverseIdsEntity[];
+    /**
+     * corporations array
+     *
+     * @maxItems 500
+     */
+    corporations?: PostUniverseIdsEntity[];
+    /**
+     * factions array
+     *
+     * @maxItems 500
+     */
+    factions?: PostUniverseIdsEntity[];
+    /**
+     * inventory_types array
+     *
+     * @maxItems 500
+     */
+    inventory_types?: PostUniverseIdsEntity[];
+    /**
+     * regions array
+     *
+     * @maxItems 500
+     */
+    regions?: PostUniverseIdsEntity[];
+    /**
+     * stations array
+     *
+     * @maxItems 500
+     */
+    stations?: PostUniverseIdsEntity[];
+    /**
+     * systems array
+     *
+     * @maxItems 500
+     */
+    systems?: PostUniverseIdsEntity[];
+    [k: string]: unknown | undefined;
+  }
+  

package/esi-request.mts

@@ -1,309 +0,0 @@
-/*!
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
-  Released under the MIT license
-  https://opensource.org/licenses/mit-license.php
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-*/
-// - - - - - - - - - - - - - - - - - - - -
-//               imports
-// - - - - - - - - - - - - - - - - - - - -
-import type { TESIResponseOKMap } from "./src";
-// import type { TESIResponseOKMap } from "eve-esi-types";
-
-
-// - - - - - - - - - - - - - - - - - - - -
-//           constants, types
-// - - - - - - - - - - - - - - - - - - - -
-// shorthands
-const log = console.log;
-const isArray = Array.isArray;
-/**
- * enable/disable console.log
- */
-let LOG = false;
-/**
- * this always `https://esi.evetech.net`
- */
-const BASE = "https://esi.evetech.net";
-
-
-type TRequestMethod = "get" | "post" | "put" | "delete";
-type ESIRequestOptions = {
-    /**
-     * query params for ESI request.
-     */
-    queries?: Record<string, any>;
-    /**
-     * will need it for `POST` request etc.
-     */
-    body?: any;
-    /** 
-     * if want response data with ignore error then can be set to `true`.
-     */
-    ignoreError?: boolean;
-    /**
-     * cancel request immediately
-     */
-    cancelable?: AbortController;
-
-    /**
-     * Can be an empty object if no authentication is required.description
-     */
-    token?: string;
-};
-/**
- * @typedef {import("./src").TESIResponseOKMap} TESIResponseOKMap
- */
-/**
- * @typedef ESIRequestOptions
- * @prop {Record<string, any>} [queries] query params for ESI request.
- * @prop {any} [body] will need it for `POST` request etc.
- * @prop {boolean} [ignoreError]  if want response data with ignore error then can be set to `true`.
- * @prop {AbortController} [cancelable] cancel request immediately
- * @prop {string} [token] Can be an empty object if no authentication is required.description
- */
-
-
-// - - - - - - - - - - - - - - - - - - - -
-//        module vars, functions
-// - - - - - - - - - - - - - - - - - - - -
-/**
- * Get the number of currently executing ESI requests
- */
-let ax: number = 0;
-/**
- * simple named error class.
- */
-class ESIRequesError extends Error {}
-/**
- * throws when x-esi-error-limit-remain header value is "0". (http status: 420)
- */
-class ESIErrorLimitReachedError extends Error {
-    constructor() {
-        super("Cannot continue ESI request because 'x-esi-error-limit-remain' is zero!");
-    }
-    valueOf(): number {
-        return 420;
-    }
-}
-/**
- * fetch the extra pages
- * 
- *   + if the `x-pages` header property ware more than 1
- * 
- * @param {string} endpointUrl
- * @param {RequestInit} rqopt request options
- * @param {Record<string, any>} qs queries
- * @param {number} pc pageCount
- */
-const fetchP = async <T extends any>(endpointUrl: string, rqopt: RequestInit, qs: Record<string, any>, pc: number) => {
-    const rqs: Promise<T>[] = [];
-    const rqp = new URLSearchParams(qs);
-    for (let i = 2; i <= pc; ) {
-        rqp.set("page", (i++) + "");
-        ax++;
-        rqs.push(
-            fetch(`${endpointUrl}?${rqp + ""}`, rqopt).then(
-                res => res.json()
-            ).catch(reason => {
-                console.warn(reason);
-                return [] as T;
-            }).finally(() => {
-                ax--;
-            })
-        );
-    }
-    return Promise.all(rqs).then(jsons => {
-        // DEVNOTE: let check the page 2, type is array?
-        if (isArray(jsons[0])) {
-            let combined: any[] = [];
-            for (let i = 0, end = jsons.length; i < end;) {
-                combined = combined.concat(jsons[i++]);
-            }
-            return combined as T;
-        }
-
-        LOG && log("> > > pages result are object < < < --", jsons);
-        return null;
-    });
-};
-
-/** ### replace (C)urly (B)races (T)oken
- * 
- * @example
- * "/characters/{character_id}/skills"
- * // ->
- * "/characters/<char.character_id>/skills"
- *
- * @param {string} endpoint e.g - "/characters/{character_id}/"
- * @param {number[]} ids
- * @returns fragment of qualified endpoint uri or null.
- */
-const replaceCbt = (endpoint: string, ids: number[]) => {
-    const re = /{([\w]+)}/g;
-    /** @type {RegExpExecArray?} */
-    let m: RegExpExecArray | null;
-    let idx = 0
-    while (m = re.exec(endpoint)) {
-        endpoint = endpoint.replace(m[0], ids[idx++] + "");
-    }
-    return endpoint;
-};
-/**
- * 
- * @param {string} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
- *   + The version parameter can be omitted by using `<version>/<endpoint>`
- */
-const curl = (endp: string) => {
-    endp = endp.replace(/^\/+|\/+$/g, "");
-    return `${BASE}/latest/${endp}/`;
-};
-
-
-// - - - - - - - - - - - - - - - - - - - -
-//            main functions
-// - - - - - - - - - - - - - - - - - - - -
-/**
- * fire ESI request
- * @template {"get" | "post" | "put" | "delete"} M
- * @template {keyof TESIResponseOKMap[M]} EP
- * @template {TESIResponseOKMap[M][EP]} R
- * 
- * @param {M} mthd
- * @param {EP} endp - The endpoint to request.
- * @param {number | number[] | ESIRequestOptions} [pathParams] - Optional path parameters.
- * @param {ESIRequestOptions} [opt] - default is empty object {}. `body` is json string
- * @returns {Promise<R>} - The response from the endpoint.
- * @throws
- * @async
- */
-export async function fire<
-    M extends TRequestMethod,
-    EP extends keyof TESIResponseOKMap[M],
-    R extends TESIResponseOKMap[M][EP]
->(
-    mthd: M, endp: EP, pathParams?: number | number[] | ESIRequestOptions,
-    opt: ESIRequestOptions = {}
-): Promise<R> {
-
-    if (typeof pathParams === "number") {
-        pathParams = /** @type {number[]} */([pathParams]);
-    }
-    if (isArray(pathParams)) {
-        // @ts-ignore actualy endp is string
-        endp = replaceCbt(endp, pathParams) as EP;
-    } else {
-        // When only options are provided
-        opt = /** @type {ESIRequestOptions} */(pathParams) as ESIRequestOptions || opt;
-    }
-
-    /** @type {RequestInit} */
-    const rqopt: RequestInit = {
-        method: mthd,
-        mode: "cors",
-        cache: "no-cache",
-        signal: opt.cancelable?.signal,
-        headers: {}
-    };
-    const qss: Record<string, string> = {
-        // language: "en",
-    };
-
-    if (opt.queries) {
-        // Object.assign(queries, options.queries); Object.assign is too slow
-        const oqs = opt.queries;
-        for (const k of Object.keys(oqs)) {
-            qss[k] = oqs[k] as string;
-        }
-    }
-    // DEVNOTE: when datasource is not empty string. (e.g - "singularity"
-    // in this case must specify datasource.
-    // disabled since `REMOVING DATASOURCE SINGULARITY`
-    // if (opt.datasource === "singularity") {
-    //     opt.datasource = "tranquility";
-    // }
-    if (opt.token) {
-        // @ts-ignore The header is indeed an object
-        (rqopt.headers as any).authorization = `Bearer ${opt.token}`;
-    }
-    if (opt.body) { // means "POST" method etc
-        // @ts-ignore The header is indeed an object
-        (rqopt.headers as any)["content-type"] = "application/json";
-        rqopt.body = JSON.stringify(opt.body);
-    }
-
-    // @ts-ignore actualy endp is string
-    const endpointUrl = curl(endp);
-    ax++;
-    try {
-        // @ts-ignore A silly type error will appear, but ignore it.
-        const res = await fetch(
-            `${endpointUrl}?${new URLSearchParams(qss) + ""}`, rqopt
-        ).finally(() => {
-            ax--;
-        });
-
-        const stat = res.status;
-        if (!res.ok && !opt.ignoreError) {
-            if (stat === 420) {
-                opt.cancelable && opt.cancelable.abort();
-                throw new ESIErrorLimitReachedError();
-            } else {
-                // @ts-ignore actualy endp is string
-                throw new ESIRequesError(`maybe network disconneted or otherwise request data are invalid. (endpoint=${endp}, http status=${stat})`);
-            }
-        } else {
-            // DEVNOTE: - 204 No Content
-            if (stat === 204) {
-                // this result is empty, decided to return status code.
-                return /** @type {R} */({ status: stat }) as unknown as R;
-            }
-
-            /** @type {R} */
-            const data: R = await res.json();
-            if (opt.ignoreError) {
-                // meaning `forceJson`?
-                return data;
-            }
-            // - - - - x-pages response.
-            // +undefined is NaN
-            // @ts-ignore becouse +null is 0
-            const pc = +res.headers.get("x-pages")!;
-            // has remaining pages? NaN > 1 === false !isNaN(pageCount)
-            if (pc > 1) {
-                LOG && log('found "x-pages" header, pages: %d', pc);
-                const remData = await fetchP<R>(endpointUrl, rqopt, qss, pc);
-                // finally, decide product data.
-                if (isArray(data) && isArray(remData)) {
-                    // DEVNOTE: 2019/7/23 15:01:48 - types
-                    return /** @type {R} */(data.concat(remData)) as unknown as R;
-                } else {
-                    // @ts-ignore TODO: fix type
-                    remData && Object.assign(data, remData);
-                }
-            }
-
-            return data;
-        }
-
-    } catch (e) {
-        // @ts-ignore actualy endp is string
-        throw new ESIRequesError(`unknown error occurred, message: ${(e as Error).message}, endpoint=${endp}`);
-    }
-}
-
-// It should complete correctly.
-async function getEVEStatus() {
-    return fire("get", "/status/");
-}
-
-// type following and run
-// node esi-request.mjs
-// or yarn test
-getEVEStatus().then(eveStatus => console.log(eveStatus));
-// {
-//     "players": 16503,
-//     "server_version": "2794925",
-//     "start_time": "2025-01-21T11:02:34Z"
-// }

package/snippet.ts

@@ -1,49 +0,0 @@
-
-import type { TESIResponseOKMap } from "./v2";
-
-type ESIRequestOptions = {
-  /**
-   * query params for ESI request.
-   */
-  queries?: Record<string, any>;
-  /**
-   * will need it for `POST` request etc.
-   */
-  body?: any;
-  /** 
-   * if want response data with ignore error then can be set to `true`.
-   */
-  ignoreError?: boolean;
-  /**
-   * cancel request immediately
-   */
-  cancelable?: AbortController;
-
-  /**
-   * Can be an empty object if no authentication is required.description
-   */
-  token?: string;
-
-  auth?: true;
-};
-// type ESIRequestSig<
-//   POpt extends Record<string, any>,
-//   M extends TESIEntryMethod = TESIEntryMethod,
-//   EP extends keyof TESIResponseOKMap[M] = keyof TESIResponseOKMap[M],
-//   Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], POpt> = IdentifyParameters<TESIResponseOKMap[M][EP], POpt>,
-//   R extends InferESIResponseResult<M, EP> = InferESIResponseResult<M, EP>
-// > = {
-//   method: M;
-//   endpoint: EP;
-//   option: Opt;
-//   result: R;
-// };
-export type ESIRequestSig = <
-  M extends TESIEntryMethod,
-  EP extends keyof TESIResponseOKMap[M],
-  Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], ESIRequestOptions>,
-  R extends InferESIResponseResult<M, EP>
->(
-  method: M, endpoint: EP, pathParams?: number | number[] | Opt,
-  option?: Opt
-) => Promise<R>;

package/v2.mts

@@ -1,320 +0,0 @@
-/*!
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
-  Released under the MIT license
-  https://opensource.org/licenses/mit-license.php
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-*/
-// - - - - - - - - - - - - - - - - - - - -
-//               imports
-// - - - - - - - - - - - - - - - - - - - -
-import type { TESIResponseOKMap } from "./v2";
-// import type { TESIResponseOKMap } from "eve-esi-types";
-
-
-// - - - - - - - - - - - - - - - - - - - -
-//           constants, types
-// - - - - - - - - - - - - - - - - - - - -
-// shorthands
-const log = console.log;
-const isArray = Array.isArray;
-/**
- * enable/disable console.log
- */
-let LOG = false;
-/**
- * this always `https://esi.evetech.net`
- */
-const BASE = "https://esi.evetech.net";
-
-
-type ESIRequestOptions = {
-    /**
-     * query params for ESI request.
-     */
-    queries?: Record<string, any>;
-    /**
-     * will need it for `POST` request etc.
-     */
-    body?: any;
-    /** 
-     * if want response data with ignore error then can be set to `true`.
-     */
-    ignoreError?: boolean;
-    /**
-     * cancel request immediately
-     */
-    cancelable?: AbortController;
-
-    /**
-     * Can be an empty object if no authentication is required.description
-     */
-    token?: string;
-
-    auth?: true;
-};
-/**
- * @typedef {import("./v2").TESIResponseOKMap} TESIResponseOKMap
- */
-/**
- * @typedef ESIRequestOptions
- * @prop {Record<string, any>} [queries] query params for ESI request.
- * @prop {any} [body] will need it for `POST` request etc.
- * @prop {boolean} [ignoreError]  if want response data with ignore error then can be set to `true`.
- * @prop {AbortController} [cancelable] cancel request immediately
- * @prop {string} [token] Can be an empty object if no authentication is required.description
- * @prop {true=} [auth] Can be an empty object if no authentication is required.description
- */
-
-
-// - - - - - - - - - - - - - - - - - - - -
-//        module vars, functions
-// - - - - - - - - - - - - - - - - - - - -
-/**
- * Get the number of currently executing ESI requests
- */
-let ax: number = 0;
-/**
- * simple named error class.
- */
-class ESIRequesError extends Error {}
-/**
- * throws when x-esi-error-limit-remain header value is "0". (http status: 420)
- */
-class ESIErrorLimitReachedError extends Error {
-    constructor() {
-        super("Cannot continue ESI request because 'x-esi-error-limit-remain' is zero!");
-    }
-    valueOf(): number {
-        return 420;
-    }
-}
-/**
- * fetch the extra pages
- * 
- *   + if the `x-pages` header property ware more than 1
- * 
- * @param {string} endpointUrl
- * @param {RequestInit} rqopt request options
- * @param {Record<string, any>} qs queries
- * @param {number} pc pageCount
- */
-const fetchP = async <T extends any>(endpointUrl: string, rqopt: RequestInit, qs: Record<string, any>, pc: number) => {
-    const rqs: Promise<T>[] = [];
-    const rqp = new URLSearchParams(qs);
-    for (let i = 2; i <= pc; ) {
-        rqp.set("page", (i++) + "");
-        ax++;
-        rqs.push(
-            fetch(`${endpointUrl}?${rqp + ""}`, rqopt).then(
-                res => res.json()
-            ).catch(reason => {
-                console.warn(reason);
-                return [] as T;
-            }).finally(() => {
-                ax--;
-            })
-        );
-    }
-    return Promise.all(rqs).then(jsons => {
-        // DEVNOTE: let check the page 2, type is array?
-        if (isArray(jsons[0])) {
-            let combined: any[] = [];
-            for (let i = 0, end = jsons.length; i < end;) {
-                combined = combined.concat(jsons[i++]);
-            }
-            return combined as T;
-        }
-
-        LOG && log("> > > pages result are object < < < --", jsons);
-        return null;
-    });
-};
-
-/** ### replace (C)urly (B)races (T)oken
- * 
- * @example
- * "/characters/{character_id}/skills"
- * // ->
- * "/characters/<char.character_id>/skills"
- *
- * @param {string} endpoint e.g - "/characters/{character_id}/"
- * @param {number[]} ids
- * @returns fragment of qualified endpoint uri or null.
- */
-const replaceCbt = (endpoint: string, ids: number[]) => {
-    const re = /{([\w]+)}/g;
-    /** @type {RegExpExecArray?} */
-    let m: RegExpExecArray | null;
-    let idx = 0
-    while (m = re.exec(endpoint)) {
-        endpoint = endpoint.replace(m[0], ids[idx++] + "");
-    }
-    return endpoint;
-};
-/**
- * 
- * @param {string} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
- *   + The version parameter can be omitted by using `<version>/<endpoint>`
- */
-const curl = (endp: string) => {
-    endp = endp.replace(/^\/+|\/+$/g, "");
-    return `${BASE}/latest/${endp}/`;
-};
-
-
-// - - - - - - - - - - - - - - - - - - - -
-//            main functions
-// - - - - - - - - - - - - - - - - - - - -
-// It should complete correctly.
-async function getEVEStatus() {
-    try {
-        const ok = await fire("get", "/characters/{character_id}/ship/", 994562, { auth: true, token: "<accessToken of 994562>" });
-        console.log(ok);
-    } catch (error) {
-        console.error("Failed to get character ship -", error);
-    }
-    return fire("get", "/status/");
-}
-
-/**
- * fire ESI request
- * @template {TESIEntryMethod} M
- * @template {keyof TESIResponseOKMap[M]} EP
- * @template {IdentifyParameters<TESIResponseOKMap[M][EP], ESIRequestOptions>} Opt
- * @template {InferESIResponseResult<M, EP>} R
- * 
- * @param {M} mthd
- * @param {EP} endp - The endpoint to request.
- * @param {number | number[] | Opt} [pathParams] - Optional path parameters.
- * @param {Opt} [opt] - default is empty object {}. `body` is json string
- * @returns {Promise<R>} - The response from the endpoint.
- * @throws
- * @async
- */
-export async function fire<
-    M extends TESIEntryMethod,
-    EP extends keyof TESIResponseOKMap[M],
-    Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], ESIRequestOptions>,
-    R extends InferESIResponseResult<M, EP>
->(
-    mthd: M, endp: EP, pathParams?: number | number[] | Opt,
-    opt: Opt = {} as Opt
-): Promise<R> {
-
-    if (typeof pathParams === "number") {
-        pathParams = /** @type {number[]} */([pathParams]);
-    }
-    if (isArray(pathParams)) {
-        // @ts-ignore actualy endp is string
-        endp = replaceCbt(endp as string, pathParams) as EP;
-    }
-    // When only options are provided
-    // @ts- ignore 
-    opt = /** @type {Opt} */(pathParams) as Opt || opt || /** @type {Opt} */({}) as Opt;
-
-    /** @type {RequestInit} */
-    const rqopt: RequestInit = {
-        method: mthd,
-        mode: "cors",
-        cache: "no-cache",
-        // @ts-ignore 
-        signal: opt.cancelable?.signal,
-        headers: {}
-    };
-    const qss: Record<string, string> = {
-        language: "en",
-    };
-
-    if (opt.queries) {
-        // Object.assign(queries, options.queries); Object.assign is too slow
-        const oqs = opt.queries;
-        for (const k of Object.keys(oqs)) {
-            qss[k] = oqs[k] as string;
-        }
-    }
-    // DEVNOTE: when datasource is not empty string. (e.g - "singularity"
-    // in this case must specify datasource.
-    // disabled since `REMOVING DATASOURCE SINGULARITY`
-    // if (opt.datasource === "singularity") {
-    //     opt.datasource = "tranquility";
-    // }
-    if (opt.auth) {
-        // @ts-ignore The header is indeed an object
-        (rqopt.headers as any).authorization = `Bearer ${opt.token}`;
-    }
-    if (opt.body) { // means "POST" method etc
-        // @ts-ignore The header is indeed an object
-        (rqopt.headers as any)["content-type"] = "application/json";
-        rqopt.body = JSON.stringify(opt.body);
-    }
-
-    // @ts-ignore actualy endp is string
-    const endpointUrl = curl(endp);
-    ax++;
-    try {
-        // @ts-ignore A silly type error will appear, but ignore it.
-        const res = await fetch(
-            `${endpointUrl}?${new URLSearchParams(qss) + ""}`, rqopt
-        ).finally(() => {
-            ax--;
-        });
-
-        const stat = res.status;
-        if (!res.ok && !opt.ignoreError) {
-            if (stat === 420) {
-                opt.cancelable && opt.cancelable.abort();
-                throw new ESIErrorLimitReachedError();
-            } else {
-                // console.log(res);
-                throw new ESIRequesError(`${res.statusText} (status=${stat})`);
-            }
-        } else {
-            // DEVNOTE: - 204 No Content
-            if (stat === 204) {
-                // this result is empty, decided to return status code.
-                return /** @type {R} */({ status: stat }) as unknown as R;
-            }
-
-            /** @type {R} */
-            const data: R = await res.json();
-            if (opt.ignoreError) {
-                // meaning `forceJson`?
-                return data;
-            }
-            // - - - - x-pages response.
-            // +undefined is NaN
-            // @ts-ignore becouse +null is 0
-            const pc = +res.headers.get("x-pages")!;
-            // has remaining pages? NaN > 1 === false !isNaN(pageCount)
-            if (pc > 1) {
-                LOG && log('found "x-pages" header, pages: %d', pc);
-                const remData = await fetchP<R>(endpointUrl, rqopt, qss, pc);
-                // finally, decide product data.
-                if (isArray(data) && isArray(remData)) {
-                    // DEVNOTE: 2019/7/23 15:01:48 - types
-                    return /** @type {R} */(data.concat(remData)) as unknown as R;
-                } else {
-                    // @ts-ignore TODO: fix type
-                    remData && Object.assign(data, remData);
-                }
-            }
-
-            return data;
-        }
-
-    } catch (e) {
-        // @ts-ignore actualy endp is string
-        throw new ESIRequesError(`message: ${(e as Error).message}, endpoint=${endp}`);
-    }
-}
-
-// type following and run
-// node v2.mjs
-// or yarn test:v2
-getEVEStatus().then(eveStatus => console.log(eveStatus));
-// {
-//     "players": 16503,
-//     "server_version": "2794925",
-//     "start_time": "2025-01-21T11:02:34Z"
-// }