eve-esi-types 2.3.2 → 2.3.4

package/lib/console-util.d.mts

@@ -0,0 +1,15 @@
+declare global {
+    interface String {
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+    }
+}
+/**
+ * @param {boolean} enable
+ */
+export declare function defineColors(enable: boolean): void;
+export declare function getLogger(banner: string, logSelector?: string): (...args: any[]) => void;

package/lib/console-util.mjs

@@ -0,0 +1,102 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file eve-esi-types/lib/console-util.mts
+ */
+import { isNode } from "./constants.mjs";
+let colorsDefined = false;
+/**
+ * @param {boolean} enable
+ */
+export function defineColors(enable) {
+    if (isNode)
+        return;
+    if (!colorsDefined) {
+        colorsDefined = true;
+        Object.defineProperties(String.prototype, {
+            red: {
+                get() { return enable ? `<span style="color: red">${this}</span>` : this; }
+            },
+            green: {
+                get() { return enable ? `<span style="color: green">${this}</span>` : this; }
+            },
+            yellow: {
+                get() { return enable ? `<span style="color: yellow">${this}</span>` : this; }
+            },
+            blue: {
+                get() { return enable ? `<span style="color: blue">${this}</span>` : this; }
+            },
+            magenta: {
+                get() { return enable ? `<span style="color: #FF00FF">${this}</span>` : this; }
+            },
+            cyan: {
+                get() { return enable ? `<span style="color: #00FFFF">${this}</span>` : this; }
+            },
+        });
+    }
+}
+/**
+ * @param {string} jsonString
+ */
+const jsonBeautify = (jsonString) => {
+    const re = /("(?:[^"\\]|\\.)*"(?:\s*:)?)|(-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?)|\b(true|false)\b|\b(null)\b/gm;
+    return jsonString.replace(re, (m, key_or_str, num, bool, nul) => {
+        if (key_or_str) { // key
+            let clz;
+            const last = m.length - 1;
+            if (m[last] === ":") {
+                m = m.substring(0, last);
+                clz = "key";
+            }
+            else {
+                clz = "string";
+            }
+            let tag = `<span class="${clz}">${m}</span>`;
+            clz === "key" && (tag += ":");
+            return tag;
+        }
+        if (num) { // number
+            return `<span class="number">${m}</span>`;
+        }
+        if (bool) { // boolean
+            return `<span class="bool">${m}</span>`;
+        }
+        if (nul) { // null
+            return `<span class="nul">${m}</span>`;
+        }
+        return m;
+    });
+};
+export function getLogger(banner, logSelector = ".log-frame") {
+    /** @type {Element=} */
+    const logElement = isNode ? void 0 : document.querySelector(logSelector) || void 0;
+    defineColors(!!logElement);
+    if (!logElement) {
+        return console.log.bind(console, banner);
+    }
+    else {
+        /** @type {function(...any): void} */
+        const log = (...data) => {
+            let text = banner;
+            for (const d of data) {
+                if (typeof d === "object") {
+                    const json = JSON.stringify(d, null, 2);
+                    text += jsonBeautify(json);
+                }
+                else {
+                    text += " " + d;
+                }
+            }
+            requestAnimationFrame(() => {
+                logElement.innerHTML += text + "\n";
+                logElement.scrollTop = 999999;
+            });
+        };
+        return log;
+    }
+}

package/lib/constants.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Dummy import
+ * @import * as cc from "colors.ts";
+ */
+/**
+ * will almost certainly be able to detect if you are in a nodejs environment
+ *
+ * @date 2020/5/9
+ */
+export declare const isNode: boolean;

package/lib/constants.mjs

@@ -0,0 +1,23 @@
+/**
+ * Dummy import
+ * @import * as cc from "colors.ts";
+ */
+/**
+ * will almost certainly be able to detect if you are in a nodejs environment
+ *
+ * @date 2020/5/9
+ */
+export const isNode = await (async () => {
+    let returnValue;
+    if (typeof process === "object") {
+        returnValue = typeof process.versions === "object" && /\d+\.\d+\.\d+/.test(process.versions.node);
+        if (returnValue) {
+            await import("colors.ts");
+        }
+    }
+    else {
+        // modId = "https://cdn.jsdelivr.net/npm/colors.ts@1.0.20/+esm";
+        returnValue = false;
+    }
+    return returnValue;
+})();

package/lib/esi-error-types.d.ts

@@ -1,3 +1,14 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file eve-esi-types/lib/esi-error-types.d.ts
+ * @since 2.3.2
+ */
 
 type TEVEErrorBase = {
   /**
@@ -34,8 +45,9 @@ export type TESIErrorStatMap = {
  * const res = await fetch("<URL with ESI endpoint>");
  * const status = res.status;
  * if (status >= 400) {
+ *   const esiError = await res.json() as TESIErrorStatMap[typeof status];
  *   const errorType: TESIErrorWithStat<typeof status> = {
- *     status, ...res.json() 
+ *     status, ...esiError
  *   };
  *   console.log(errorType);
  *   throw new Error(`message="${res.statusText}", status=${status}`);
@@ -43,7 +55,6 @@ export type TESIErrorStatMap = {
  * ```
  * 
  * @date 2025/3/3
- * @since 2.4.0
  */
 export type TESIErrorWithStat<Stat extends TClientErrorStats | TServerErrorStats> = {
   status: Stat;

package/lib/request-api.mjs

@@ -14,7 +14,7 @@ import * as util from "./rq-util.mjs";
 //           constants, types
 // - - - - - - - - - - - - - - - - - - - -
 // shorthands
-const log = console.log;
+const log = util.getUniversalLogger("[request-api]: ");
 const DEBUG = util.isDebug();
 /**
  * @typedef {import("../v2").IESIRequestFunction<util.ESIRequestOptions>} IESIRequestFunction
@@ -36,29 +36,24 @@ const DEBUG = util.isDebug();
  * @returns A Promise object containing the response data
  * @throws {ESIRequesError}
  */
-// @ts-expect-error
-export const request = async (method, endpoint, pathParams, opt) => {
+export const request = /** @type {IESIRequestFunction} */ (async (method, endpoint, pathParams, opt) => {
     if (typeof pathParams === "number") {
-        // @ts-expect-error
-        pathParams = [pathParams];
+        pathParams = /** @type {typeof pathParams} */ ([pathParams]);
     }
     if (Array.isArray(pathParams)) {
-        // @ts-expect-error actualy endp is string
         endpoint = util.replaceCbt(endpoint, pathParams);
     }
     // When only options are provided
     const actualOpt = /** @type {NonNullable<typeof opt>} */ (opt || pathParams || {});
     const { rqopt, qss } = util.initOptions(method, actualOpt);
-    // @ts-expect-error actualy endp is string
     const endpointUrl = util.curl(endpoint);
     const up = new URLSearchParams(qss);
     const url = `${endpointUrl}${up.size ? `?${up}` : ""}`;
     DEBUG && log(url);
     try {
         const res = await fetch(url, rqopt);
-        const { status } = res;
         // The parameters are different for successful and error responses.
-        if (util.isSuccess(status)) {
+        if (util.isSuccess(res.status)) {
             return util.handleSuccessResponse(res, endpointUrl, rqopt, up);
         }
         // else if (isError(status)) {}
@@ -68,7 +63,7 @@ export const request = async (method, endpoint, pathParams, opt) => {
     catch (e) {
         log(e);
     }
-};
+});
 //
 // implements rest methods of `request` (IESIRequestFunction)
 //

package/lib/rq-util.d.mts

@@ -5,9 +5,20 @@
 //  https://opensource.org/licenses/mit-license.php
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
-import "colors.ts";
+/// <reference types="../v2"/>
+// - - - - - - - - - - - - - - - - - - - -
+//               imports
+// - - - - - - - - - - - - - - - - - - - -
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
 import type { TESIRequestFunctionMethods } from "../v2";
 import type { TESIErrorStats } from "./esi-error-types";
+export { isNode } from "./constants.mjs";
 /**
  * this always `https://esi.evetech.net`
  */
@@ -86,7 +97,7 @@ export declare const handleSuccessResponse: (response: Response, endpointUrl: st
  *
  * @param {Response} res
  * @param {string} endpointUrl
- * @param {AbortController} abortable
+ * @param {AbortController=} abortable
  * @returns {Promise<void>}
  */
 export declare const handleESIError: (res: Response, endpointUrl: string, abortable?: AbortController) => Promise<void>;
@@ -110,13 +121,15 @@ export declare const isDebug: () => boolean;
  */
 export declare const is: (opt: string) => boolean;
 /**
+ * NOTE: In `initOptions`, if `auth=true`, then `token` can be set to a valid `accessToken` to successfully complete an authenticated request.
+ *
  * @param {string} method
  * @param {ESIRequestOptions} opt
- * @returns {{ rqopt: RequestInit, qss: Record<string, string> }}
+ * @returns {{ rqopt: RequestInit, qss: Record<string, any> }}
  */
 export declare const initOptions: (method: string, opt: ESIRequestOptions) => {
     rqopt: RequestInit;
-    qss: Record<string, string>;
+    qss: Record<string, any>;
 };
 /**
  * fetch the extra pages
@@ -125,12 +138,12 @@ export declare const initOptions: (method: string, opt: ESIRequestOptions) => {
  * @template {any} T
  * @param {string} endpointUrl
  * @param {RequestInit} rqopt request options
- * @param {URLSearchParams} rqp queries
+ * @param {URLSearchParams} usp queries
  * @param {number} pc pageCount
  * @param {(minus?: number) => void=} increment
  * @returns {Promise<T | null>}
  */
-export declare const fetchP: <T extends unknown>(endpointUrl: string, rqopt: RequestInit, rqp: URLSearchParams, pc: number, increment?: (minus?: Truthy) => void) => Promise<T | null>;
+export declare const fetchP: <T extends unknown>(endpointUrl: string, rqopt: RequestInit, usp: URLSearchParams, pc: number, increment?: (minus?: Truthy) => void) => Promise<T | null>;
 /** ### replace (C)urly (B)races (T)oken
  *
  * @example
@@ -138,24 +151,26 @@ export declare const fetchP: <T extends unknown>(endpointUrl: string, rqopt: Req
  * // ->
  * "/characters/<char.character_id>/skills"
  *
- * @param {string} endpoint e.g - "/characters/{character_id}/"
+ * @template {unknown} T
+ * @param {T} endpoint e.g - "/characters/{character_id}/"
  * @param {number[]} ids
- * @returns {string | null} fragment of qualified endpoint uri or null.
+ * @returns {T} fragment of qualified endpoint uri or null.
  */
-export declare const replaceCbt: (endpoint: string, ids: number[]) => string;
+export declare const replaceCbt: <T extends unknown>(endpoint: T, ids: number[]) => T;
 /**
- *
- * @param {string} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
+ * @template {unknown} T
+ * @param {T} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
  *   + The version parameter is forced to apply `latest`
  * @returns {string}
  */
-export declare const curl: (endp: string) => string;
+export declare const curl: <T extends unknown>(endp: T) => string;
 /**
  * @date 2020/03/31
  * @version 2.1
  * @type {() => Promise<string>}
  */
 export declare function getSDEVersion(): Promise<string>;
+export declare const getUniversalLogger: (banner: string, logSelector?: string) => (...args: any[]) => void;
 export declare function getLogger(): {
     clog: (...args: any[]) => void;
     rlog: (...args: any[]) => void;

package/lib/rq-util.mjs

@@ -9,12 +9,14 @@
 // - - - - - - - - - - - - - - - - - - - -
 //               imports
 // - - - - - - - - - - - - - - - - - - - -
-import "colors.ts";
+import { isNode } from "./constants.mjs";
+export { isNode } from "./constants.mjs";
+import * as consoleUtil from "./console-util.mjs";
 // - - - - - - - - - - - - - - - - - - - -
 //           constants, types
 // - - - - - - - - - - - - - - - - - - - -
 // shorthands
-const log = console.log;
+const log = consoleUtil.getLogger("[request-util]:");
 const isArray = Array.isArray;
 /**
  * enable/disable console.log
@@ -98,7 +100,7 @@ export const handleSuccessResponse = async (response, endpointUrl, requestOpt, u
  *
  * @param {Response} res
  * @param {string} endpointUrl
- * @param {AbortController} abortable
+ * @param {AbortController=} abortable
  * @returns {Promise<void>}
  */
 export const handleESIError = async (res, endpointUrl, abortable) => {
@@ -110,13 +112,12 @@ export const handleESIError = async (res, endpointUrl, abortable) => {
         status, ...esiError
     };
     // log ESI Error details
-    console.warn(errorType);
+    log(errorType);
     if (status === 420) {
         abortable && abortable.abort();
         throw new ESIErrorLimitReachedError();
     }
     else {
-        // console.log(res);
         throw new ESIRequesError(`${res.statusText} (status=${status}, url=${endpointUrl})`);
     }
 };
@@ -153,17 +154,42 @@ export const isError = (stat) => {
  * @returns {boolean}
  */
 export const isDebug = () => {
-    return process.argv.includes("-debug");
+    return is("debug");
 };
 /**
  * @param {string} opt
  * @returns {boolean}
  */
-export const is = (opt) => process.argv.includes(`-${opt}`);
+export const is = (opt) => {
+    if (isNode) {
+        return process.argv.includes(`-${opt}`);
+    }
+    else {
+        const q = location.search || location.hash;
+        if (q) {
+            //* ctt
+            const entries = q.substring(1).split("&");
+            for (const entry of entries) {
+                const [key, /*value*/] = entry.split("=");
+                if (key === opt)
+                    return true;
+            }
+            /*/
+            const usp = new URLSearchParams(q.substring(1));
+            for (const [key, value] of usp.entries()) {
+                if (key === opt) return true;
+            }
+            //*/
+        }
+    }
+    return false;
+};
 /**
+ * NOTE: In `initOptions`, if `auth=true`, then `token` can be set to a valid `accessToken` to successfully complete an authenticated request.
+ *
  * @param {string} method
  * @param {ESIRequestOptions} opt
- * @returns {{ rqopt: RequestInit, qss: Record<string, string> }}
+ * @returns {{ rqopt: RequestInit, qss: Record<string, any> }}
  */
 export const initOptions = (method, opt) => {
     /** @type {RequestInit} */
@@ -174,14 +200,17 @@ export const initOptions = (method, opt) => {
         signal: opt.cancelable?.signal,
         headers: {}
     };
-    /** @type {Record<string, string>} */
+    /** @type {Record<string, any>} */
     const qss = {
-    // language: "en",
+        // CAVEAT: If the language parameter is not set, some endpoints such as "/universe/ids/" may return incomplete results.
+        // Therefore, the language parameter should always be set.
+        language: "en",
     };
     if (opt.query) {
         // Object.assign(query, options.query); Object.assign is too slow
         const oqs = opt.query;
-        Object.keys(oqs).forEach(k => qss[k] = oqs[k]);
+        for (const key in oqs)
+            qss[key] = oqs[key];
     }
     if (opt.auth) {
         // @ts-ignore The header is indeed an object
@@ -201,17 +230,17 @@ export const initOptions = (method, opt) => {
  * @template {any} T
  * @param {string} endpointUrl
  * @param {RequestInit} rqopt request options
- * @param {URLSearchParams} rqp queries
+ * @param {URLSearchParams} usp queries
  * @param {number} pc pageCount
  * @param {(minus?: number) => void=} increment
  * @returns {Promise<T | null>}
  */
-export const fetchP = async (endpointUrl, rqopt, rqp, pc, increment = () => { }) => {
+export const fetchP = async (endpointUrl, rqopt, usp, pc, increment = () => { }) => {
     const rqs = [];
     for (let i = 2; i <= pc;) {
-        rqp.set("page", (i++) + "");
+        usp.set("page", (i++) + "");
         increment();
-        rqs.push(fetch(`${endpointUrl}?${rqp + ""}`, rqopt).then(res => res.json()).catch(reason => {
+        rqs.push(fetch(`${endpointUrl}?${usp + ""}`, rqopt).then(res => res.json()).catch(reason => {
             console.warn(reason);
             return [];
         }).finally(() => {
@@ -238,23 +267,25 @@ export const fetchP = async (endpointUrl, rqopt, rqp, pc, increment = () => { })
  * // ->
  * "/characters/<char.character_id>/skills"
  *
- * @param {string} endpoint e.g - "/characters/{character_id}/"
+ * @template {unknown} T
+ * @param {T} endpoint e.g - "/characters/{character_id}/"
  * @param {number[]} ids
- * @returns {string | null} fragment of qualified endpoint uri or null.
+ * @returns {T} fragment of qualified endpoint uri or null.
  */
 export const replaceCbt = (endpoint, ids) => {
     let idx = 0;
+    // @ts-expect-error
     return endpoint.replace(/{([\w]+)}/g, $0 => ids[idx++] + "");
 };
 /**
- *
- * @param {string} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
+ * @template {unknown} T
+ * @param {T} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
  *   + The version parameter is forced to apply `latest`
  * @returns {string}
  */
 export const curl = (endp) => {
-    endp = endp.replace(/^\/+|\/+$/g, "");
-    return `${BASE}/latest/${endp}/`;
+    // @ts-expect-error
+    return `${BASE}/latest/${endp.replace(/^\/+|\/+$/g, "")}/`;
 };
 /**
  * @date 2020/03/31
@@ -280,9 +311,12 @@ export async function getSDEVersion() {
         return "sde-202Xxxxx-TRANQUILITY";
     }
 }
+export const getUniversalLogger = (banner, logSelector = ".log-frame") => {
+    return consoleUtil.getLogger(banner, logSelector);
+};
 export function getLogger() {
-    const clog = console.log.bind(console, '- - -> Get the character data of "CCP Zoetrope"'.magenta);
-    const rlog = console.log.bind(console, "- - -> Run ESI request".cyan);
+    const clog = consoleUtil.getLogger('- - -> Get the character data of "CCP Zoetrope"'.magenta);
+    const rlog = consoleUtil.getLogger("- - -> Run ESI request".cyan);
     return { clog, rlog };
 }
 /**
@@ -314,7 +348,6 @@ function fireWithoutAuth(fn, method, endpoint, pathParams, opt) {
     }
     return fn[method](endpoint, pathParams, opt);
 }
-// It should complete correctly.
 /**
  * #### Fire a request that does not require authentication.
  *
@@ -323,17 +356,18 @@ function fireWithoutAuth(fn, method, endpoint, pathParams, opt) {
  */
 export async function fireRequestsDoesNotRequireAuth(fn) {
     const { clog, rlog } = getLogger();
+    const ID_CCP_Zoetrope = 2112625428;
     try {
         // - - - - - - - - - - - -
         //       Character
         // - - - - - - - - - - - -
         // Here, I borrow data from "CCP Zoetrope".
         clog();
-        await fireWithoutAuth(fn, "get", "/characters/{character_id}/", 2112625428).then(log);
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/", ID_CCP_Zoetrope).then(log);
         clog('(portrait)');
-        await fireWithoutAuth(fn, "get", "/characters/{character_id}/portrait/", 2112625428).then(log);
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/portrait/", ID_CCP_Zoetrope).then(log);
         clog('(affiliation)');
-        const affiliation = await fireWithoutAuth(fn, "post", "/characters/affiliation/", { body: [2112625428] });
+        const affiliation = await fireWithoutAuth(fn, "post", "/characters/affiliation/", { body: [ID_CCP_Zoetrope] });
         log(affiliation);
         clog('(corporation)');
         await fireWithoutAuth(fn, "get", "/corporations/{corporation_id}/", affiliation[0].corporation_id).then(log);
@@ -346,6 +380,7 @@ export async function fireRequestsDoesNotRequireAuth(fn) {
         const ids = await fireWithoutAuth(fn, "post", "/universe/ids/", { body: ["the forge", "plex"] });
         log(ids.inventory_types, ids.regions);
         rlog(`get:/markets/${ids?.regions?.[0].id}/orders/?type_id=${ids?.inventory_types?.[0].id}, item PLEX`.green);
+        // in this case, "order_type" is required
         const orders = await fireWithoutAuth(fn, "get", "/markets/{region_id}/orders/", ids?.regions?.[0].id, {
             query: {
                 // page: 1,
@@ -366,29 +401,23 @@ export async function fireRequestsDoesNotRequireAuth(fn) {
         //  The following is code to observe the behavior of completion by generics.
         //  Authentication is required, so an error will occur.
         // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
-        let ok = await fireWithoutAuth(fn, "get", "/characters/{character_id}/ship/", 994562, {
+        let willFailed = await fireWithoutAuth(fn, "get", "/characters/{character_id}/ship/", ID_CCP_Zoetrope, {
             auth: true,
             ignoreError: true,
             token: "token.token.token"
         });
         // in this case, "categories" and "search" is required
-        await fireWithoutAuth(fn, "get", "/characters/{character_id}/search/", 994562, {
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/search/", ID_CCP_Zoetrope, {
             query: {
                 categories: ["agent"],
                 search: "ok"
             },
             auth: true
         });
-        // in this case, "order_type" is required
-        await fireWithoutAuth(fn, "get", "/markets/{region_id}/orders/", 994562, {
-            query: {
-                order_type: "all"
-            },
-        });
         // TODO: want TypeScript semantics to throw an error because there is a required query parameter, but it's not possible
         //   Or rather, I don't know how to do it.
         await fireWithoutAuth(fn, "get", "/characters/{character_id}/search/");
-        log(ok);
+        log(willFailed);
     }
     catch (e) {
         console.error("Failed to request -", e);

package/lib/tagged-request-api.d.mts

@@ -18,9 +18,9 @@ import type { ESIRequestOptions } from "./rq-util.mjs";
  *    const esiRequest = taggedApi.injectESIRequestBody(...);
  *    const ret = await esiRequest.universe.get("/universe/structures/", { query: { filter: "market" }});
  *
- * @template {Record<string, unknown>} Opt
- * @param {TESIRequestFunctionSignature<{}>} requestBody
- * @returns {XESI.TaggedESIRequestMap}
+ * @template {Record<string, unknown>} Opt - The options type for the request.
+ * @param {TESIRequestFunctionSignature<Opt>} requestBody - The function signature for the ESI request.
+ * @returns {XESI.TaggedESIRequestMap} - The tagged ESI request map.
  * @since 2.3
  */
 export declare function injectESIRequestBody<Opt extends Record<string, unknown>>(requestBody: TESIRequestFunctionSignature<Opt>): XESI.TaggedESIRequestMap<Opt>;
@@ -29,6 +29,7 @@ export declare function injectESIRequestBody<Opt extends Record<string, unknown>
  */
 /**
  * Injects the minimal implementation of ESI requests into `XESI.TaggedESIRequestMap`.
+ *
  * @since 2.3
  * @type {XESI.TaggedESIRequestMap<ESIRequestOptions>}
  */

package/lib/tagged-request-api.mjs

@@ -10,11 +10,14 @@
  * @file eve-esi-types/lib/tagged-request-api.mts
  */
 import { request } from "./request-api.mjs";
+/**
+ * @import { TESIRequestFunctionMethods } from "../v2"
+ */
 /**
  * @typedef {`${string}${"" | `,${string}`}`} TMethodList
  */
 /** @satisfies {`${XESI.ESITags}:${TMethodList}`[]} */
-const ESITagsWithMethodList = [
+const ESITagMethodMapping = [
     "Alliance:get", "Assets:get,post",
     "Calendar:get,put", "Character:get,post",
     "Clones:get", "Contacts:get,post,put,delete",
@@ -43,31 +46,39 @@ const ESITagsWithMethodList = [
  *    const esiRequest = taggedApi.injectESIRequestBody(...);
  *    const ret = await esiRequest.universe.get("/universe/structures/", { query: { filter: "market" }});
  *
- * @template {Record<string, unknown>} Opt
- * @param {TESIRequestFunctionSignature<{}>} requestBody
- * @returns {XESI.TaggedESIRequestMap}
+ * @template {Record<string, unknown>} Opt - The options type for the request.
+ * @param {TESIRequestFunctionSignature<Opt>} requestBody - The function signature for the ESI request.
+ * @returns {XESI.TaggedESIRequestMap} - The tagged ESI request map.
  * @since 2.3
  */
 export function injectESIRequestBody(requestBody) {
     const rq = /** @type {XESI.TaggedESIRequestMap<Opt>} */ ({});
-    for (const tagEntry of ESITagsWithMethodList) {
+    // DEVNOTE: 2025/03/08 - In reality, you only need one function instance for each of "get", "post", "put", and "delete",
+    // so you can just refer to the cached functions as a map.
+    const methodMap = /** @type {TESIRequestFunctionMethods<Opt>} */ ({});
+    /** @type {TESIEntryMethod[]} */ (["get", "post", "put", "delete"]).forEach((method) => {
+        methodMap[method] = /** @type {TESIRequestFunctionEachMethod<typeof method, Opt>} */ ((e, params, opt) => requestBody(method, e, params, opt));
+    });
+    for (const tagEntry of ESITagMethodMapping) {
         const [tag, methodList] = /** @type {[tag: XESI.ESITags, methods: TMethodList]} */ (tagEntry.split(":"));
         const methods = /** @type {TESIEntryMethod[]} */ (methodList.split(","));
         const entry = /** @type {XESI.ESITaggedEndpointRequest<typeof tag, Opt>} */ ({});
         for (const method of methods) {
+            // However, from the point of view of type annotation, the parameters are different, so you need to cast it as `as type` instead of `satisfies`.
             // @ts-expect-error
-            entry[method] = /** @satisfies {XESI.TaggedEndpointRequestFunction<typeof method, typeof tag>} */ ((e, params, opt) => requestBody(method, e, params, opt));
+            entry[method] = /** @type {XESI.TaggedEndpointRequestFunction<typeof method, typeof tag, Opt>} */ (methodMap[method]);
         }
         const camelCased = /** @type {XESI.LCamelCase<XESI.ESITags>} */ (tag[0].toLowerCase() + tag.slice(1).replace(/\s(.)/g, "$1"));
         rq[camelCased] = entry;
     }
-    return rq;
+    return Object.freeze(rq);
 }
 /**
  * @import { ESIRequestOptions } from "./rq-util.mjs";
  */
 /**
  * Injects the minimal implementation of ESI requests into `XESI.TaggedESIRequestMap`.
+ *
  * @since 2.3
  * @type {XESI.TaggedESIRequestMap<ESIRequestOptions>}
  */

package/minimal-rq.mjs

@@ -15,7 +15,7 @@ import { request } from "./lib/request-api.mjs";
 //           constants, types
 // - - - - - - - - - - - - - - - - - - - -
 // shorthands
-const log = console.log;
+const log = util.getUniversalLogger("[request-mini]: ");
 /**
  * @typedef {import("./v2").IESIRequestFunction<util.ESIRequestOptions>} IESIRequestFunction
  * @typedef {import("./v2").TESIRequestFunctionMethods<util.ESIRequestOptions>} TESIRequestFunctionMethods
@@ -44,17 +44,18 @@ async function getEVEStatus(fn) {
     }
     const { clog, rlog } = util.getLogger();
     CaseIESIRequestFunction: {
+        const ID_CCP_Zoetrope = 2112625428;
         // - - - - - - - - - - - -
         //       Character
         // - - - - - - - - - - - -
         // Here, I borrow data from "CCP Zoetrope".
         rlog("- - - - - - - > run as IESIRequestFunction<ESIRequestOptions>".red);
         clog();
-        await fn.get("/characters/{character_id}/", 2112625428).then(log);
+        await fn.get("/characters/{character_id}/", ID_CCP_Zoetrope).then(log);
         clog('(portrait)');
-        await fn.get("/characters/{character_id}/portrait/", 2112625428).then(log);
+        await fn.get("/characters/{character_id}/portrait/", ID_CCP_Zoetrope).then(log);
         clog('(affiliation)');
-        const affiliation = await fn.post("/characters/affiliation/", { body: [2112625428] });
+        const affiliation = await fn.post("/characters/affiliation/", { body: [ID_CCP_Zoetrope] });
         log(affiliation);
         clog('(corporation)');
         await fn.get("/corporations/{corporation_id}/", affiliation[0].corporation_id).then(log);
@@ -78,10 +79,23 @@ async function getEVEStatus(fn) {
     }
     return fn.get("/status/");
 }
+const runTest = () => {
+    getEVEStatus(request).then(eveStatus => log(eveStatus));
+};
 // type following and run
 // node minimal-rq.mjs -debug
 if (!util.is("x")) {
-    getEVEStatus(request).then(eveStatus => log(eveStatus));
+    runTest();
+}
+else {
+    // @ts-ignore
+    globalThis.runTest = runTest;
+    if (!util.isNode) {
+        const button = document.getElementById("run-test");
+        if (button) {
+            button.addEventListener("click", () => runTest());
+        }
+    }
 }
 // {
 //     "players": 16503,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-esi-types",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "description": "Extracted the main type of ESI. use for ESI request response types (version 2 only)",
   "main": "v2/index.d.ts",
   "scripts": {
@@ -14,6 +14,7 @@
   "files": [
     "v2",
     "lib",
+    "web",
     "*.d.mts",
     "*.mjs",
     "LICENSE",

package/v2.mjs

@@ -51,7 +51,6 @@ export async function fire(mthd, endp, pathParams, opt) {
         pathParams = [pathParams]; // as unknown as P2;
     }
     if (isArray(pathParams)) {
-        // @ts-expect-error actualy endp is string
         endp = replaceCbt(endp, pathParams);
     }
     // When only options are provided
@@ -59,7 +58,6 @@ export async function fire(mthd, endp, pathParams, opt) {
     // @ts-ignore
     const actualOpt = opt || pathParams || {};
     const { rqopt, qss } = initOptions(mthd, actualOpt);
-    // @ts-expect-error actualy endp is string
     const endpointUrl = curl(endp);
     const up = new URLSearchParams(qss);
     const url = `${endpointUrl}${up.size ? `?${up}` : ""}`;
@@ -67,9 +65,8 @@ export async function fire(mthd, endp, pathParams, opt) {
     ax++;
     try {
         const res = await fetch(url, rqopt).finally(() => ax--);
-        const { status } = res;
         // The parameters are different for successful and error responses.
-        if (isSuccess(status)) {
+        if (isSuccess(res.status)) {
             return handleSuccessResponse(res, endpointUrl, rqopt, up, incrementAx);
         }
         // else if (isError(status)) {}

package/web/index.css

@@ -0,0 +1,101 @@
+@charset "utf8";
+/*!
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+  Released under the MIT license
+  https://opensource.org/licenses/mit-license.php
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+
+.command {
+    font-family: consolas;
+    color: rgb(37 143 231);
+    background-color: rgba(192, 192, 192, 0.23);
+    padding: 4px 6px;
+    border: solid 1px silver;
+    border-radius: 4px;
+}
+
+/* button {
+    width: 100px;
+    transition: filter 300ms ease;
+} */
+button:disabled {
+    filter: opacity(0.3) blur(0.4px);
+}
+button.copy {
+    width: 20px;
+    height: 20px;
+    background: url('data:image/svg+xml;charset=UTF-8,<svg height="16px" viewBox="-21 0 512 512" width="16px" xmlns="http://www.w3.org/2000/svg"><path d="m186.667969 416c-49.984375 0-90.667969-40.683594-90.667969-90.667969v-218.664062h-37.332031c-32.363281 0-58.667969 26.300781-58.667969 58.664062v288c0 32.363281 26.304688 58.667969 58.667969 58.667969h266.664062c32.363281 0 58.667969-26.304688 58.667969-58.667969v-37.332031zm0 0"/><path d="m469.332031 58.667969c0-32.40625-26.261719-58.667969-58.664062-58.667969h-224c-32.40625 0-58.667969 26.261719-58.667969 58.667969v266.664062c0 32.40625 26.261719 58.667969 58.667969 58.667969h224c32.402343 0 58.664062-26.261719 58.664062-58.667969zm0 0"/></svg>') no-repeat center/14px;
+    border: solid 1px rgba(192, 192, 192, 0.73);
+    border-radius: 3px;
+    display: inline-block;
+    vertical-align: middle;
+    margin-left: 3px;
+    cursor: pointer;
+    padding: 2px;
+    box-sizing: content-box;
+}
+
+.footer {
+    position: fixed;
+
+    box-sizing: border-box;
+    margin: 0;
+    left: 0; bottom: 2px;
+    width: 100%;
+    padding: 2px 8px;
+
+    display: flex;
+    justify-content: flex-end;
+    align-items: center;
+    align-content: center;
+    justify-items: end;
+
+    font-size: 10px;
+    background-color: var(--card-bg);
+    color: snow;
+}
+.footer a {
+    text-decoration: none;
+    margin: 0 4px;
+}
+
+.log-frame {
+    position: relative;
+
+    height: calc(100vh - 100px - 30px);
+
+    border: none;
+    padding: 3px 4px;
+    border-radius: 4px;
+
+    font-family: consolas;
+    white-space: pre;
+    overflow: auto;
+
+    background-color: rgb(22 22 22);
+    color: #ececec;
+    /* &:empty {
+        padding: 0;
+        width: 0; height: 0;
+        border: none;
+        border-radius: unset;
+    } */
+}
+
+span.key {
+    color: rgb(255 150 150);
+}
+span.number {
+    color: rgb(89 174 255);
+}
+span.string {
+    color: rgb(95 249 95);
+}
+span.bool {
+    color: rgb(205, 108, 255);
+}
+span.nul {
+    color: rgb(255, 44, 44);
+}

package/web/index.html

@@ -0,0 +1,57 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>eve-esi-types ESI request test</title>
+  <script type="module" src="../minimal-rq.mjs"></script>
+  <link rel="stylesheet" href="./index.css">
+</head>
+
+<body>
+  <div class="container">
+    <button id="run-test">Run test</button>
+  </div>
+  <div class="info">
+    <div>example command: <input type="text" class="command" value="browser-sync start -s --port 8080 --no-open --ss &lt;this site directory>" size="72" readonly>
+      <button class="copy" onclick="copy('.command', '.')"></button>
+    </div>
+    then access to <a href="http://localhost:8080/web/?x=1&debug=1">eve-esi-types ESI request test</a>
+  </div>
+  <div class="log-frame" contenteditable></div>
+  <footer class="footer"></footer>
+  <script>
+    /** @type {(s: string, rep: string, regex?: RegExp) => void} */
+    function copy(selector, replacement, regex = /<[^>]+>/) {
+      /** @type {HTMLInputElement} */
+      const text = document.querySelector(selector);
+      const shellscript = text.value.replace(regex, replacement);
+      navigator.clipboard.writeText(shellscript).then(() => alert("Copied the text: " + shellscript));
+    }
+    /** @type {HTMLDivElement} */
+    const logElement = document.querySelector(".log-frame");
+    if (logElement) {
+      let inputBuffer = "";
+      logElement.addEventListener("keydown", function (e) {
+        if (e.ctrlKey) {
+          if (e.code === "KeyL") {
+            e.preventDefault();
+            logElement.innerHTML = "";
+          }
+        } else {
+          const key = e.key;
+          if (key === "Enter") {
+            const cmd = inputBuffer;
+            inputBuffer = "";
+            eval(`(${cmd})`);
+          } else if (key.length === 1) {
+            inputBuffer += key;
+          }
+        }
+      });
+    }
+  </script>
+</body>
+
+</html>