eve-esi-types 2.2.6 → 2.3.2

package/README.md

@@ -32,6 +32,31 @@ export declare function fire<
 >(mthd: M, endp: EP, pathParams?: P2, opt?: Opt): Promise<R>;
 ```
 
+## New Features in v2.3.0
+
+### ESI Tagged Types
+
+> Introduced intuitive ESI requests handling using "tags" from the EVE Swagger JSON.
+
+### injectESIRequestBody
+
+> Utilized `injectESIRequestBody` to generate ESI request API objects with narrowed endpoints by accessing camel-cased "tags".
+
+```ts
+import * as taggedApi from "eve-esi-types/lib/tagged-request-api.mjs";
+
+const esiRequest = taggedApi.injectESIRequestBody(...);
+const ret = await esiRequest.universe.get("/universe/structures/", { query: { filter: "market" }});
+```
+
++ or
+
+```ts
+// Minimal default ESI request body implementation
+import { esi } from "eve-esi-types/lib/tagged-request-api.mjs";
+
+const ret = await esi.universe.get("/universe/structures/", { query: { filter: "market" }});
+```
 
 ## References
 

package/esi-types-util.md

@@ -28,7 +28,11 @@ type TESIRequestFunctionSignature<ActualOpt> = <
 `IfParameterizedPath<EP, Opt>` if parameterized path then specify number type, otherwise will be `Opt` type.
 
 ```ts
-type IfParameterizedPath<EP, Opt> = EP extends `${string}/{${string}}/${string | ""}` ? number | number[]: Opt;
+type IfParameterizedPath<EP, Opt> = EP extends `${string}/{${string}}${string}`
+  ? PickPathParameters<EP> extends never
+    ? Opt : InferKeysLen<PickPathParameters<EP>> extends 1
+        ? number : [number, number]
+    : Opt;
 ```
 
 ### IdentifyParameters

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

@@ -0,0 +1,104 @@
+
+type TEVEErrorBase = {
+  /**
+   * error message
+   */
+  error: string;
+};
+/**
+ * There are endpoints with status 200 only that contain the "X-Pages" header.
+ */
+export type TSuccessStats = 200 | 201 | 204;
+export type TRedirectStats = 304;
+export type TClientErrorStats = 400 | 401 | 403 | 404 | 420 | 422;
+export type TServerErrorStats = 500 | 503 | 504 | 520;
+export type TESIErrorStats = TClientErrorStats | TServerErrorStats;
+export type TStatsAll = TSuccessStats | TRedirectStats | TClientErrorStats | TServerErrorStats;
+export type TESIErrorStatMap = {
+  // status 400
+  400: BadRequest;
+  401: Unauthorized;
+  403: Forbidden;
+  404: NotFound;
+  420: ErrorLimited;
+  422: Unprocessable;
+
+  // status 500
+  500: InternalServerError;
+  503: ServiceUnavailable;
+  504: GatewayTimeout;
+  520: EVEServerError;
+};
+/**
+ * ```ts
+ * const res = await fetch("<URL with ESI endpoint>");
+ * const status = res.status;
+ * if (status >= 400) {
+ *   const errorType: TESIErrorWithStat<typeof status> = {
+ *     status, ...res.json() 
+ *   };
+ *   console.log(errorType);
+ *   throw new Error(`message="${res.statusText}", status=${status}`);
+ * }
+ * ```
+ * 
+ * @date 2025/3/3
+ * @since 2.4.0
+ */
+export type TESIErrorWithStat<Stat extends TClientErrorStats | TServerErrorStats> = {
+  status: Stat;
+} & TESIErrorStatMap[Stat];
+// declare const bad: TESIErrorWithStat<400>;
+
+/**
+ * Bad request model 400
+ */
+export interface BadRequest extends TEVEErrorBase {}
+/**
+ * Not Found model 404
+ */
+export interface NotFound extends TEVEErrorBase {}
+/**
+ * Unprocessable model 422[Unprocessable entity]
+ */
+export interface Unprocessable extends TEVEErrorBase {}
+/**
+ * Unauthorized model 401
+ */
+export interface Unauthorized extends TEVEErrorBase {}
+/**
+ * Forbidden model 403
+ */
+export interface Forbidden extends TEVEErrorBase {
+  /**
+   * status code received from SSO
+   */
+  sso_status?: number;
+}
+
+/**
+ * Error limited model 420
+ */
+export interface ErrorLimited extends TEVEErrorBase {}
+
+/**
+ * Internal server error model 500
+ */
+export interface InternalServerError extends TEVEErrorBase {}
+/**
+ * Service unavailable model 503
+ */
+export interface ServiceUnavailable extends TEVEErrorBase {}
+/**
+ * Gateway timeout model 504
+ */
+export interface GatewayTimeout extends TEVEErrorBase {
+  /**
+   * number of seconds the request was given
+   */
+  timeout?: number;
+}
+/**
+ * EVE server error model 520
+ */
+export interface EVEServerError extends InternalServerError {}

package/lib/request-api.d.mts

@@ -0,0 +1,27 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+import * as util from "./rq-util.mjs";
+import type { IESIRequestFunction } from "../v2";
+/**
+ * @typedef {import("../v2").IESIRequestFunction<util.ESIRequestOptions>} IESIRequestFunction
+ * @typedef {import("../v2").TESIRequestFunctionMethods<util.ESIRequestOptions>} TESIRequestFunctionMethods
+ */
+/** #### Sample of `TESIRequestFunctionSignature`
+ *
+ * + This is a minimal implementation using `TESIRequestFunctionSignature`.
+ *   If the response contains "page", only the first page can be retrieved.
+ *
+ * @type {IESIRequestFunction}
+ * @param method - The HTTP method to use for the request
+ * @param endpoint - The Path of the ESI endpoint to send the request to
+ * @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}
+ */
+export declare const request: IESIRequestFunction<util.ESIRequestOptions>;

package/lib/request-api.mjs

@@ -0,0 +1,79 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/// <reference types="../v2"/>
+// - - - - - - - - - - - - - - - - - - - -
+//               imports
+// - - - - - - - - - - - - - - - - - - - -
+import * as util from "./rq-util.mjs";
+// - - - - - - - - - - - - - - - - - - - -
+//           constants, types
+// - - - - - - - - - - - - - - - - - - - -
+// shorthands
+const log = console.log;
+const DEBUG = util.isDebug();
+/**
+ * @typedef {import("../v2").IESIRequestFunction<util.ESIRequestOptions>} IESIRequestFunction
+ * @typedef {import("../v2").TESIRequestFunctionMethods<util.ESIRequestOptions>} TESIRequestFunctionMethods
+ */
+// - - - - - - - - - - - - - - - - - - - -
+//            main functions
+// - - - - - - - - - - - - - - - - - - - -
+/** #### Sample of `TESIRequestFunctionSignature`
+ *
+ * + This is a minimal implementation using `TESIRequestFunctionSignature`.
+ *   If the response contains "page", only the first page can be retrieved.
+ *
+ * @type {IESIRequestFunction}
+ * @param method - The HTTP method to use for the request
+ * @param endpoint - The Path of the ESI endpoint to send the request to
+ * @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}
+ */
+// @ts-expect-error
+export const request = async (method, endpoint, pathParams, opt) => {
+    if (typeof pathParams === "number") {
+        // @ts-expect-error
+        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)) {
+            return util.handleSuccessResponse(res, endpointUrl, rqopt, up);
+        }
+        // else if (isError(status)) {}
+        // Actually, throw Error
+        throw await util.handleESIError(res, endpointUrl, actualOpt.cancelable);
+    }
+    catch (e) {
+        log(e);
+    }
+};
+//
+// implements rest methods of `request` (IESIRequestFunction)
+//
+/** @type {TESIEntryMethod[]} */ (["get", "post", "put", "delete"]).forEach((method) => {
+    request[method] = /** @type {TESIRequestFunctionEachMethod<typeof method>} */ (function (endpoint, params, opt) {
+        return this(method, endpoint, params, opt);
+    });
+});

package/{rq-util.d.mts → lib/rq-util.d.mts}

@@ -6,7 +6,8 @@
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 import "colors.ts";
-import type { TESIRequestFunctionMethods } from "./v2";
+import type { TESIRequestFunctionMethods } from "../v2";
+import type { TESIErrorStats } from "./esi-error-types";
 /**
  * this always `https://esi.evetech.net`
  */
@@ -25,10 +26,6 @@ export type ESIRequestOptions = {
      * 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
      */
@@ -46,6 +43,9 @@ export type ESIRequestOptions = {
      */
     auth?: true;
 };
+/**
+ * @typedef {string | number | boolean} Truthy
+ */
 /**
  * simple named error class.
  */
@@ -61,11 +61,58 @@ export declare class ESIErrorLimitReachedError extends ESIRequesError {
 /**
  * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
  */
+/**
+ * #### status: 200 | 201 | 204
+ *
+ *  + Returns a json object only if the status is `200` or `201`.
+ *
+ * @param {Response} response
+ * @param {string} endpointUrl
+ * @param {RequestInit} requestOpt
+ * @param {URLSearchParams} urlParams
+ * @param {(minus?: Truthy) => void=} increment
+ * @returns {Promise<any>}
+ */
+export declare const handleSuccessResponse: (response: Response, endpointUrl: string, requestOpt: RequestInit, urlParams: URLSearchParams, increment?: (minus?: Truthy) => void) => Promise<any>;
+/**
+ * @import {
+ *     TESIErrorStats,
+ *     TESIErrorStatMap,
+ *     TESIErrorWithStat
+ * } from "./esi-error-types";
+ */
+/**
+ * #### status: (400 | 401 | 403 | 404 | 420 | 422) or (500 | 503 | 504 | 520)
+ *
+ * @param {Response} res
+ * @param {string} endpointUrl
+ * @param {AbortController} abortable
+ * @returns {Promise<void>}
+ */
+export declare const handleESIError: (res: Response, endpointUrl: string, abortable?: AbortController) => Promise<void>;
+/**
+ * @param {number} stat
+ * @returns {stat is 200 | 201 | 204}
+ */
+export declare const isSuccess: (stat: number) => stat is 200 | 201 | 204;
+/**
+ * @param {number} stat
+ * @returns {stat is TESIErrorStats}
+ */
+export declare const isError: (stat: number) => stat is TESIErrorStats;
+/**
+ * @returns {boolean}
+ */
 export declare const isDebug: () => boolean;
+/**
+ * @param {string} opt
+ * @returns {boolean}
+ */
+export declare const is: (opt: string) => boolean;
 /**
  * @param {string} method
  * @param {ESIRequestOptions} opt
- * @returns
+ * @returns {{ rqopt: RequestInit, qss: Record<string, string> }}
  */
 export declare const initOptions: (method: string, opt: ESIRequestOptions) => {
     rqopt: RequestInit;
@@ -75,12 +122,13 @@ export declare const initOptions: (method: string, opt: ESIRequestOptions) => {
  * fetch the extra pages
  *
  *   + if the `x-pages` header property ware more than 1
- *
+ * @template {any} T
  * @param {string} endpointUrl
  * @param {RequestInit} rqopt request options
  * @param {URLSearchParams} rqp 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>;
 /** ### replace (C)urly (B)races (T)oken
@@ -92,13 +140,14 @@ export declare const fetchP: <T extends unknown>(endpointUrl: string, rqopt: Req
  *
  * @param {string} endpoint e.g - "/characters/{character_id}/"
  * @param {number[]} ids
- * @returns fragment of qualified endpoint uri or null.
+ * @returns {string | null} fragment of qualified endpoint uri or null.
  */
 export declare const replaceCbt: (endpoint: string, ids: number[]) => string;
 /**
  *
  * @param {string} 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;
 /**
@@ -115,5 +164,6 @@ export declare function getLogger(): {
  * #### Fire a request that does not require authentication.
  *
  * @param {TESIRequestFunctionSignature<ESIRequestOptions> | TESIRequestFunctionMethods} fn
+ * @returns {Promise<void>}
  */
 export declare function fireRequestsDoesNotRequireAuth(fn: TESIRequestFunctionSignature<ESIRequestOptions> | TESIRequestFunctionMethods<ESIRequestOptions>): Promise<void>;

package/{rq-util.mjs → lib/rq-util.mjs}

@@ -5,7 +5,7 @@
 //  https://opensource.org/licenses/mit-license.php
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
-/// <reference types="./v2"/>
+/// <reference types="../v2"/>
 // - - - - - - - - - - - - - - - - - - - -
 //               imports
 // - - - - - - - - - - - - - - - - - - - -
@@ -24,6 +24,9 @@ let LOG = false;
  * this always `https://esi.evetech.net`
  */
 export const BASE = "https://esi.evetech.net";
+/**
+ * @typedef {string | number | boolean} Truthy
+ */
 /**
  * simple named error class.
  */
@@ -46,13 +49,121 @@ export class ESIErrorLimitReachedError extends ESIRequesError {
 // - - - - - - - - - - - - - - - - - - - -
 //            utility functions
 // - - - - - - - - - - - - - - - - - - - -
+/**
+ * #### status: 200 | 201 | 204
+ *
+ *  + Returns a json object only if the status is `200` or `201`.
+ *
+ * @param {Response} response
+ * @param {string} endpointUrl
+ * @param {RequestInit} requestOpt
+ * @param {URLSearchParams} urlParams
+ * @param {(minus?: Truthy) => void=} increment
+ * @returns {Promise<any>}
+ */
+export const handleSuccessResponse = async (response, endpointUrl, requestOpt, urlParams, increment = () => { }) => {
+    // NoContentResponse
+    if (response.status === 204)
+        return {};
+    /** @type {any} */
+    const data = await response.json();
+    // - - - - x-pages response.
+    // +undefined is NaN
+    // @ts-expect-error becouse +null is 0
+    const pc = +response.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(endpointUrl, requestOpt, urlParams, pc, increment);
+        // finally, decide product data.
+        if (isArray(data) && isArray(remData)) {
+            // DEVNOTE: 2019/7/23 15:01:48 - types
+            return data.concat(remData);
+        }
+        else {
+            remData && Object.assign(data, remData);
+        }
+    }
+    return data;
+};
+/**
+ * @import {
+ *     TESIErrorStats,
+ *     TESIErrorStatMap,
+ *     TESIErrorWithStat
+ * } from "./esi-error-types";
+ */
+/**
+ * #### status: (400 | 401 | 403 | 404 | 420 | 422) or (500 | 503 | 504 | 520)
+ *
+ * @param {Response} res
+ * @param {string} endpointUrl
+ * @param {AbortController} abortable
+ * @returns {Promise<void>}
+ */
+export const handleESIError = async (res, endpointUrl, abortable) => {
+    const status = /** @type {TESIErrorStats} */ (res.status);
+    /** @type {TESIErrorStatMap[typeof status]} */
+    const esiError = await res.json();
+    /** @type {TESIErrorWithStat<typeof status>} */
+    const errorType = {
+        status, ...esiError
+    };
+    // log ESI Error details
+    console.warn(errorType);
+    if (status === 420) {
+        abortable && abortable.abort();
+        throw new ESIErrorLimitReachedError();
+    }
+    else {
+        // console.log(res);
+        throw new ESIRequesError(`${res.statusText} (status=${status}, url=${endpointUrl})`);
+    }
+};
+/** @satisfies {TESIErrorStats[]} */
+const ESIErrorStats = [
+    // status 400
+    400, // BadRequest;
+    401, // Unauthorized;
+    403, // Forbidden;
+    404, // NotFound;
+    420, // ErrorLimited;
+    422, // Unprocessable;
+    // status 500
+    500, // InternalServerError;
+    503, // ServiceUnavailable;
+    504, // GatewayTimeout;
+    520, // EVEServerError;
+];
+/**
+ * @param {number} stat
+ * @returns {stat is 200 | 201 | 204}
+ */
+export const isSuccess = (stat) => {
+    return stat === 200 || stat === 201 || stat === 204;
+};
+/**
+ * @param {number} stat
+ * @returns {stat is TESIErrorStats}
+ */
+export const isError = (stat) => {
+    return ESIErrorStats.includes(/** @type {TESIErrorStats} */ (stat));
+};
+/**
+ * @returns {boolean}
+ */
 export const isDebug = () => {
     return process.argv.includes("-debug");
 };
+/**
+ * @param {string} opt
+ * @returns {boolean}
+ */
+export const is = (opt) => process.argv.includes(`-${opt}`);
 /**
  * @param {string} method
  * @param {ESIRequestOptions} opt
- * @returns
+ * @returns {{ rqopt: RequestInit, qss: Record<string, string> }}
  */
 export const initOptions = (method, opt) => {
     /** @type {RequestInit} */
@@ -63,6 +174,7 @@ export const initOptions = (method, opt) => {
         signal: opt.cancelable?.signal,
         headers: {}
     };
+    /** @type {Record<string, string>} */
     const qss = {
     // language: "en",
     };
@@ -86,12 +198,13 @@ export const initOptions = (method, opt) => {
  * fetch the extra pages
  *
  *   + if the `x-pages` header property ware more than 1
- *
+ * @template {any} T
  * @param {string} endpointUrl
  * @param {RequestInit} rqopt request options
  * @param {URLSearchParams} rqp queries
  * @param {number} pc pageCount
  * @param {(minus?: number) => void=} increment
+ * @returns {Promise<T | null>}
  */
 export const fetchP = async (endpointUrl, rqopt, rqp, pc, increment = () => { }) => {
     const rqs = [];
@@ -112,7 +225,7 @@ export const fetchP = async (endpointUrl, rqopt, rqp, pc, increment = () => { })
             for (let i = 0, end = jsons.length; i < end;) {
                 combined = combined.concat(jsons[i++]);
             }
-            return combined;
+            return /** @type {T} */ (combined);
         }
         LOG && log("> > > pages result are object < < < --", jsons);
         return null;
@@ -127,22 +240,17 @@ export const fetchP = async (endpointUrl, rqopt, rqp, pc, increment = () => { })
  *
  * @param {string} endpoint e.g - "/characters/{character_id}/"
  * @param {number[]} ids
- * @returns fragment of qualified endpoint uri or null.
+ * @returns {string | null} fragment of qualified endpoint uri or null.
  */
 export const replaceCbt = (endpoint, ids) => {
-    const re = /{([\w]+)}/g;
-    /** @type {RegExpExecArray?} */
-    let m;
     let idx = 0;
-    while (m = re.exec(endpoint)) {
-        endpoint = endpoint.replace(m[0], ids[idx++] + "");
-    }
-    return endpoint;
+    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/`
  *   + The version parameter is forced to apply `latest`
+ * @returns {string}
  */
 export const curl = (endp) => {
     endp = endp.replace(/^\/+|\/+$/g, "");
@@ -159,7 +267,7 @@ export async function getSDEVersion() {
         const res = await fetch(sdeZipUrl, { method: "head", mode: "cors" });
         const date = res.headers.get("last-modified");
         if (date) {
-            const YMD = new Date(date).toLocaleDateString('en-CA').replace(/-/g, '');
+            const YMD = new Date(date).toLocaleDateString("en-CA").replace(/-/g, "");
             return `sde-${YMD}-TRANQUILITY`;
         }
         else {
@@ -174,12 +282,12 @@ export async function getSDEVersion() {
 }
 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 rlog = console.log.bind(console, "- - -> Run ESI request".cyan);
     return { clog, rlog };
 }
 /**
  * Need typescript v5.5 later
- * @import * as ESI from "./v2";
+ * @import * as ESI from "../v2";
  * @typedef {ESI.TESIResponseOKMap} TESIResponseOKMap
  * @typedef {ESI.IESIRequestFunction<ESIRequestOptions>} IESIRequestFunction
  * @typedef {ESI.TESIRequestFunctionMethods<ESIRequestOptions>} TESIRequestFunctionMethods
@@ -211,6 +319,7 @@ function fireWithoutAuth(fn, method, endpoint, pathParams, opt) {
  * #### Fire a request that does not require authentication.
  *
  * @param {TESIRequestFunctionSignature<ESIRequestOptions> | TESIRequestFunctionMethods} fn
+ * @returns {Promise<void>}
  */
 export async function fireRequestsDoesNotRequireAuth(fn) {
     const { clog, rlog } = getLogger();
@@ -277,6 +386,7 @@ export async function fireRequestsDoesNotRequireAuth(fn) {
             },
         });
         // 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);
     }

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

@@ -0,0 +1,35 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/// <reference types="../v2/esi-tagged-types"/>
+import type { ESIRequestOptions } from "./rq-util.mjs";
+/**
+ * `esi-tagged-types` and `injectESIRequestBody` allow for more intuitive use of ESI requests based on the "tags" defined in the EVE Swagger JSON.
+ *
+ * + The `ESI request API object` constructed by `injectESIRequestBody` lists narrowed endpoints by accessing the camel-cased "tags" members.
+ *
+ * @example
+ *    import * as taggedApi from "eve-esi-types/lib/tagged-request-api.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}
+ * @since 2.3
+ */
+export declare function injectESIRequestBody<Opt extends Record<string, unknown>>(requestBody: TESIRequestFunctionSignature<Opt>): XESI.TaggedESIRequestMap<Opt>;
+/**
+ * @import { ESIRequestOptions } from "./rq-util.mjs";
+ */
+/**
+ * Injects the minimal implementation of ESI requests into `XESI.TaggedESIRequestMap`.
+ * @since 2.3
+ * @type {XESI.TaggedESIRequestMap<ESIRequestOptions>}
+ */
+export declare const esi: import("../v2/esi-tagged-types").TaggedESIRequestMap<ESIRequestOptions>;