eve-esi-types 2.3.3 → 2.3.5

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.d.mts

@@ -22,6 +22,6 @@ import type { IESIRequestFunction } from "../v2";
  * @param pathParams - An object of parameters to include in the request
  * @param options - An object of options to include in the request
  * @returns A Promise object containing the response data
- * @throws {ESIRequesError}
+ * @throws {util.ESIRequestError}
  */
 export declare const request: IESIRequestFunction<util.ESIRequestOptions>;

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
@@ -34,13 +34,11 @@ const DEBUG = util.isDebug();
  * @param pathParams - An object of parameters to include in the request
  * @param options - An object of options to include in the request
  * @returns A Promise object containing the response data
- * @throws {ESIRequesError}
+ * @throws {util.ESIRequestError}
  */
-// @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)) {
         endpoint = util.replaceCbt(endpoint, pathParams);
@@ -65,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

@@ -9,18 +9,16 @@
 // - - - - - - - - - - - - - - - - - - - -
 //               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";
-/**
- * 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;
+export { isNode } from "./constants.mjs";
 /**
  * this always `https://esi.evetech.net`
  */
@@ -62,12 +60,12 @@ export type ESIRequestOptions = {
 /**
  * simple named error class.
  */
-export declare class ESIRequesError extends Error {
+export declare class ESIRequestError extends Error {
 }
 /**
  * throws when x-esi-error-limit-remain header value is "0". (http status: 420)
  */
-export declare class ESIErrorLimitReachedError extends ESIRequesError {
+export declare class ESIErrorLimitReachedError extends ESIRequestError {
     constructor();
     valueOf(): number;
 }
@@ -99,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>;
@@ -123,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
@@ -138,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
@@ -158,7 +158,6 @@ export declare const fetchP: <T extends unknown>(endpointUrl: string, rqopt: Req
  */
 export declare const replaceCbt: <T extends unknown>(endpoint: T, ids: number[]) => T;
 /**
- *
  * @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`
@@ -171,6 +170,7 @@ export declare const curl: <T extends unknown>(endp: T) => string;
  * @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,34 +9,14 @@
 // - - - - - - - - - - - - - - - - - - - -
 //               imports
 // - - - - - - - - - - - - - - - - - - - -
-/**
- * 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 modId, returnValue;
-    if (typeof process === "object") {
-        modId = "colors.ts";
-        // @ts-ignore 
-        returnValue = typeof process.versions === "object" && /\d+\.\d+\.\d+/.test(process.versions.node);
-    }
-    else {
-        modId = "https://cdn.jsdelivr.net/npm/colors.ts@1.0.20/+esm";
-        returnValue = false;
-    }
-    await import(modId);
-    return returnValue;
-})();
+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
@@ -52,12 +32,12 @@ export const BASE = "https://esi.evetech.net";
 /**
  * simple named error class.
  */
-export class ESIRequesError extends Error {
+export class ESIRequestError extends Error {
 }
 /**
  * throws when x-esi-error-limit-remain header value is "0". (http status: 420)
  */
-export class ESIErrorLimitReachedError extends ESIRequesError {
+export class ESIErrorLimitReachedError extends ESIRequestError {
     constructor() {
         super("Cannot continue ESI request because 'x-esi-error-limit-remain' is zero!");
     }
@@ -120,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) => {
@@ -132,14 +112,13 @@ 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})`);
+        throw new ESIRequestError(`${res.statusText} (status=${status}, url=${endpointUrl})`);
     }
 };
 /** @satisfies {TESIErrorStats[]} */
@@ -182,7 +161,7 @@ export const isDebug = () => {
  * @returns {boolean}
  */
 export const is = (opt) => {
-    if (typeof process === "object") {
+    if (isNode) {
         return process.argv.includes(`-${opt}`);
     }
     else {
@@ -206,9 +185,11 @@ export const is = (opt) => {
     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} */
@@ -219,7 +200,7 @@ export const initOptions = (method, opt) => {
         signal: opt.cancelable?.signal,
         headers: {}
     };
-    /** @type {Record<string, string>} */
+    /** @type {Record<string, any>} */
     const qss = {
         // 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.
@@ -228,7 +209,8 @@ export const initOptions = (method, opt) => {
     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
@@ -248,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(() => {
@@ -296,7 +278,6 @@ export const replaceCbt = (endpoint, ids) => {
     return endpoint.replace(/{([\w]+)}/g, $0 => ids[idx++] + "");
 };
 /**
- *
  * @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`
@@ -330,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 };
 }
 /**
@@ -364,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.
  *
@@ -373,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);
@@ -396,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,
@@ -416,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>}
  */