eve-esi-types 2.2.6 → 2.3.0

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/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,76 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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 {
+        return await fetch(url, rqopt).then(res => {
+            if (res.status >= 400) {
+                throw new util.ESIRequesError(`${res.statusText} (status=${res.status})`);
+            }
+            return res.json();
+        });
+    }
+    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,7 @@
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 import "colors.ts";
-import type { TESIRequestFunctionMethods } from "./v2";
+import type { TESIRequestFunctionMethods } from "../v2";
 /**
  * this always `https://esi.evetech.net`
  */
@@ -62,6 +62,7 @@ export declare class ESIErrorLimitReachedError extends ESIRequesError {
  * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
  */
 export declare const isDebug: () => boolean;
+export declare const is: (opt: string) => boolean;
 /**
  * @param {string} method
  * @param {ESIRequestOptions} opt

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
 // - - - - - - - - - - - - - - - - - - - -
@@ -49,6 +49,7 @@ export class ESIErrorLimitReachedError extends ESIRequesError {
 export const isDebug = () => {
     return process.argv.includes("-debug");
 };
+export const is = (opt) => process.argv.includes(`-${opt}`);
 /**
  * @param {string} method
  * @param {ESIRequestOptions} opt
@@ -179,7 +180,7 @@ export function getLogger() {
 }
 /**
  * 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

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

@@ -0,0 +1,29 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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"/>
+/**
+ * `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" }});
+ *
+ * @param {TESIRequestFunctionSignature<{}>} requestBody
+ * @returns {XESI.TaggedESIRequestMap}
+ * @since 2.3
+ */
+export declare function injectESIRequestBody(requestBody: TESIRequestFunctionSignature<{}>): XESI.TaggedESIRequestMap;
+/**
+ * Injects the minimal implementation of ESI requests into `XESI.TaggedESIRequestMap`.
+ * @since 2.3
+ */
+export declare const esi: XESI.TaggedESIRequestMap;

package/lib/tagged-request-api.mjs

@@ -0,0 +1,69 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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"/>
+/**
+ * @file eve-esi-types/lib/tagged-request-api.mts
+ */
+import { request } from "./request-api.mjs";
+/** @satisfies {XESI.ESITags[]} */
+const ESI_TAGs = [
+    "Alliance", "Assets",
+    "Calendar", "Character",
+    "Clones", "Contacts",
+    "Contracts", "Corporation",
+    "Dogma", "Faction Warfare",
+    "Fittings", "Fleets",
+    "Incursions", "Industry",
+    "Insurance", "Killmails",
+    "Location", "Loyalty",
+    "Mail", "Market",
+    "Opportunities", "Planetary Interaction",
+    "Routes", "Search",
+    "Skills", "Sovereignty",
+    "Status", "Universe",
+    "User Interface", "Wallet",
+    "Wars"
+];
+/** @satisfies {TESIEntryMethod[]} */
+const METHODs = ["get", "post", "put", "delete"];
+/**
+ * `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" }});
+ *
+ * @param {TESIRequestFunctionSignature<{}>} requestBody
+ * @returns {XESI.TaggedESIRequestMap}
+ * @since 2.3
+ */
+// Here, functions are implemented for "get", "post", "put", and "delete" for convenience.
+// However, in the completion listed by `injectESIRequestBody(<requestBody>).`, only the inferred methods will be listed.
+export function injectESIRequestBody(requestBody) {
+    const rq = /** @type {XESI.TaggedESIRequestMap} */ ({});
+    for (const tag of ESI_TAGs) {
+        const camel = 
+        /** @type {XESI.LCamelCase<XESI.ESITags>} */ (tag[0].toLowerCase() + tag.slice(1).replace(/\s(\w)/g, "$1"));
+        const entry = /** @type {XESI.ESITaggedEndpointRequest<typeof tag>} */ ({});
+        for (const method of METHODs) {
+            // @ts-ignore ignore ts(2590)
+            entry[method] = /** @satisfies {XESI.TaggedEndpointRequestFunction<typeof method, typeof tag>} */ ((e, params, opt) => requestBody(method, e, params, opt));
+        }
+        rq[camel] = entry;
+    }
+    return rq;
+}
+/**
+ * Injects the minimal implementation of ESI requests into `XESI.TaggedESIRequestMap`.
+ * @since 2.3
+ */
+export const esi = injectESIRequestBody(request);

package/minimal-rq.d.mts

@@ -1,29 +1 @@
-/*!
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-//  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").TESIResponseOKMap} TESIResponseOKMap
- * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
- * @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>;
+export {};

package/minimal-rq.mjs

@@ -9,65 +9,20 @@
 // - - - - - - - - - - - - - - - - - - - -
 //               imports
 // - - - - - - - - - - - - - - - - - - - -
-import * as util from "./rq-util.mjs";
+import * as util from "./lib/rq-util.mjs";
+import { request } from "./lib/request-api.mjs";
 // - - - - - - - - - - - - - - - - - - - -
 //           constants, types
 // - - - - - - - - - - - - - - - - - - - -
 // shorthands
 const log = console.log;
-const DEBUG = util.isDebug();
 /**
- * @typedef {import("./v2").TESIResponseOKMap} TESIResponseOKMap
- * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
  * @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 = (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);
-    return fetch(url, rqopt).then(res => res.json()).catch(reason => {
-        throw new util.ESIRequesError(reason.message ? reason.message : reason);
-    });
-};
-//
-// 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);
-    });
-});
 //
 // Delegates implementation to `request` (TESIRequestFunctionMethods)
 //
@@ -126,7 +81,9 @@ async function getEVEStatus(fn) {
 }
 // type following and run
 // node minimal-rq.mjs -debug
-getEVEStatus(request).then(eveStatus => log(eveStatus));
+if (!util.is("x")) {
+    getEVEStatus(request).then(eveStatus => log(eveStatus));
+}
 // {
 //     "players": 16503,
 //     "server_version": "2794925",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-esi-types",
-  "version": "2.2.6",
+  "version": "2.3.0",
   "description": "Extracted the main type of ESI. use for ESI request response types (version 2 only)",
   "main": "v2/index.d.ts",
   "scripts": {
@@ -13,6 +13,7 @@
   },
   "files": [
     "v2",
+    "lib",
     "*.d.mts",
     "*.mjs",
     "LICENSE",
@@ -36,6 +37,7 @@
   },
   "homepage": "https://github.com/jeffy-g/eve-esi-types#readme",
   "devDependencies": {
-    "colors.ts": "^1.0.20"
+    "colors.ts": "^1.0.20",
+    "typescript": "latest"
   }
 }

package/tagged-rq.d.mts

@@ -0,0 +1 @@
+export {};

package/tagged-rq.mjs

@@ -0,0 +1,22 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file tagged-rq.mts
+ * @command node tagged-rq.mjs -x
+ */
+import { esi as esiRq } from "./lib/tagged-request-api.mjs";
+// console.log(esiRq);
+// Furthermore, the endpoint selected is narrowed down by "tags" and "method".
+esiRq.character.get("/characters/{character_id}/", 2112625428).then(console.log);
+esiRq.universe.get("/universe/structures/", { query: { filter: "market" } }).then(console.log);
+esiRq.universe.post("/universe/ids/", {
+    body: ["the forge", "plex"]
+}).then(console.log);
+esiRq.assets.get("/characters/{character_id}/assets/", 1234, {
+    auth: true
+}).then(console.log).catch(console.log);

package/tsconfig.json

@@ -8,7 +8,6 @@
     "outDir": ".", 
     "target": "esnext",
     "module": "esnext",
-    // "declaration": true,
     "diagnostics": true,
     "newLine": "LF",
     "strict": true,
@@ -18,7 +17,8 @@
     ]
   },
   "include": [
-    "./scripts/*.mts"
+    "./scripts/**/*.mts",
+    "./v2/*.d.ts"
   ],
   "exclude": [
     "./scripts/auth-*",

package/v2/esi-tagged-types.d.ts

@@ -0,0 +1,148 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * THIS DTS IS AUTO GENERATED, DO NOT EDIT
+ * 
+ * @file eve-esi-types/v2/esi-tagged-types.d.ts
+ * @summary This file is auto-generated and defines version 2.3.0 of the EVE Online ESI response types.
+ */
+import { TESIResponseOKMap } from "./index.d.ts";
+export * from "./index.d.ts";
+
+/**
+ * Converts a string to lower camel case.
+ * 
+ * @template S - The string to convert.
+ * @example
+ * // returns "assets"
+ * LCamelCase<"Assets">
+ * @example
+ * // returns "factionWarfare"
+ * LCamelCase<"Faction Warfare">
+ * @date 2025/2/27
+ */
+export declare type LCamelCase<S extends string> = S extends `${infer P1} ${infer P2}`
+  ? `${Lowercase<P1>}${Capitalize<P2>}` : Lowercase<S>;
+
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+//               Utility Type `ESITags`
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+/**
+ * Maps HTTP methods to their corresponding tags.
+ * @template M - The HTTP method.
+ * @date 2025/2/28
+ */
+export declare type ESITags = {
+  [M in TESIEntryMethod]: TESIResponseOKMap[M] extends Record<`/${string}/`, { tag: infer Tag }>
+    ? Tag : never
+}[TESIEntryMethod];
+
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+//            Utility Type `InferMethod`
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+/**
+ * Infers the HTTP method based on the provided tag.
+ * 
+ * @template Tag - The tag to infer the method for.
+ * @date 2025/2/28
+ */
+export declare type InferMethod<Tag> = {
+  [M in TESIEntryMethod]: TESIResponseOKMap[M] extends Record<`/${string}/`, { tag: infer ActualTag }>
+    ? ActualTag extends Tag
+      ? M : never
+    : never;
+}[TESIEntryMethod];
+// type XAssets = InferMethod<"Assets">;
+// type XContacts = InferMethod<"Contacts">;
+// type XPlanetary = InferMethod<"Planetary Interaction">;
+
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+//    Utility Type `TaggedEndpointRequestFunction`
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+/**
+ * Creates a function type for making requests to tagged endpoints.
+ * 
+ * @template M - The HTTP method.
+ * @template Tag - The tag associated with the endpoint.
+ * @template ActualOpt - The actual options for the request.
+ * @template EP - The endpoint path.
+ * @template P2 - The path parameters.
+ * @template Opt - The request options.
+ * @template R - The response type.
+ * 
+ * @param endpoint - The endpoint path.
+ * @param pathParams - The path parameters.
+ * @param options - The request options.
+ * @returns A promise that resolves to the response.
+ * @date 2025/2/28
+ */
+export declare type TaggedEndpointRequestFunction<M extends TESIEntryMethod, Tag extends ESITags, ActualOpt = {}> = <
+  EP extends SelectEndpointByTag<Tag, M>,
+  P2 extends IfParameterizedPath<EP, Opt>,
+  Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], ActualOpt>,
+  R extends InferESIResponseResult<M, EP>
+>(endpoint: EP, pathParams?: P2, options?: Opt) => Promise<R>;
+
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+//    Utility Type `ESITaggedEndpointRequest`
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+/**
+ * Maps tags to their corresponding endpoint request functions.
+ * 
+ * @template Tag - The tag to map.
+ * @date 2025/2/28
+ */
+export declare type ESITaggedEndpointRequest<Tag extends ESITags> = {
+  [tag in Tag]: {
+    [method in InferMethod<Tag>]: TaggedEndpointRequestFunction<method, tag>;
+  };
+}[Tag];
+
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+//        Utility Type `SelectEndpointByTag`
+// - - - - - - - - - - - - - - - - - - - - - - - - - -
+/**
+ * Selects an endpoint by tag and method.
+ * 
+ * @template Tag - The tag associated with the endpoint.
+ * @template M - The HTTP method.
+ * @template EP - The endpoint path.
+ * @date 2025/2/28
+ */
+export declare type SelectEndpointByTag<
+  Tag extends ESITags, M extends TESIEntryMethod
+> = {
+  [EP in keyof TESIResponseOKMap[M]]: TESIResponseOKMap[M][EP] extends { tag: infer ActualTag }
+    ? ActualTag extends Tag
+      ? EP : never
+    : never;
+}[keyof TESIResponseOKMap[M]];
+// type XAssetsEndpointGet = SelectEndpointByTag<"Assets", "get">;
+// type XAssetsEndpointPost = SelectEndpointByTag<"Assets", "post">;
+
+/**
+ * Maps lower camel case tags to their corresponding endpoint request functions.
+ * @date 2025/2/28
+ */
+export declare type TaggedESIRequestMap = {
+  [tag in ESITags as LCamelCase<tag>]: ESITaggedEndpointRequest<tag>;
+};
+
+/**
+ * Creates a partial map of lower camel case tags to their corresponding endpoint request functions.
+ * ```ts
+ * // implements "factionWarfare", "wallet"
+ * const esiRq: XTaggedESIRequestMapPartial<"factionWarfare" | "wallet">;
+ * ```
+ * 
+ * @template Props - The properties to require in the partial map.
+ * @date 2025/2/28
+ */
+export declare type TaggedESIRequestMapPartial<Props extends LCamelCase<ESITags>> = RequireThese<Partial<TaggedESIRequestMap>, Props>;
+
+export as namespace XESI;

package/v2/get_characters_character_id_skillqueue_ok.d.ts

@@ -4,7 +4,7 @@
 /**
  * 200 ok array
  *
- * @maxItems 150
+ * @maxItems 200
  */
 type GetCharactersCharacterIdSkillqueueOk = GetCharactersCharacterIdSkillqueue_200Ok[];
 

package/v2/index.d.ts

@@ -6,20 +6,15 @@
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 /**
- * THIS TSD IS AUTO GENERATED, DO NOT EDIT
+ * THIS DTS IS AUTO GENERATED, DO NOT EDIT
  * 
  * @file eve-esi-types/v2/index.d.ts
- * @summary This file is auto-generated and defines version 2.2.6 of the EVE Online ESI response types.
+ * @summary This file is auto-generated and defines version 2.3.0 of the EVE Online ESI response types.
  */
 
 import type { TESIResponseOKMap } from "./response-map.d.ts";
 export type { TESIResponseOKMap } from "./response-map.d.ts";
 
-/**
- * mark a specific property as `required`
- */
-type RequireThese<T, K extends keyof T> = T & Required<Pick<T, K>>;
-
 /**
  * Represents a function that can make ESI requests with various HTTP methods.
  *
@@ -73,6 +68,11 @@ export type TESIRequestFunctionMethods<ActualOpt = {}> = {
 
 declare global {
 
+  /**
+   * mark a specific property as `required`
+   */
+  type RequireThese<T, K extends keyof T> = T & Required<Pick<T, K>>;
+
   /**
    * ### ESI request function all in one signature
    * 
@@ -136,7 +136,7 @@ declare global {
   //* ctt
   type IdentifyParameters<
     Entry, Opt,
-    Keys = Exclude<keyof Entry, "result">
+    Keys = Exclude<keyof Entry, "result" | "tag">
   > = RequireThese<Opt, Keys> & Pick<Entry, Keys>;
   /*/
   type IdentifyParameters<