eve-esi-types 3.1.6 → 3.2.0

package/v2/types-index.d.ts

@@ -9,187 +9,36 @@
  * THIS DTS IS AUTO GENERATED, DO NOT EDIT
  * 
  * @file eve-esi-types/v2/types-index.d.ts
- * @summary This file is auto-generated and defines version 3.1.6 of the EVE Online ESI response types.
+ * @summary This file is auto-generated and defines version 3.2.0 of the EVE Online ESI response types.
  */
-import "./get_wars_ok.d.ts";
-import "./get_status_ok.d.ts";
-import "./get_fw_wars_ok.d.ts";
-import "./get_fw_stats_ok.d.ts";
-import "./get_alliances_ok.d.ts";
-import "./get_fw_systems_ok.d.ts";
-import "./get_incursions_ok.d.ts";
-import "./get_wars_war_id_ok.d.ts";
-import "./get_dogma_effects_ok.d.ts";
-import "./post_universe_ids_ok.d.ts";
-import "./get_markets_groups_ok.d.ts";
-import "./get_markets_prices_ok.d.ts";
-import "./get_universe_races_ok.d.ts";
-import "./get_universe_types_ok.d.ts";
-import "./get_fleets_fleet_id_ok.d.ts";
-import "./get_fw_leaderboards_ok.d.ts";
-import "./get_sovereignty_map_ok.d.ts";
-import "./get_universe_groups_ok.d.ts";
-import "./post_universe_names_ok.d.ts";
-import "./get_dogma_attributes_ok.d.ts";
-import "./get_industry_systems_ok.d.ts";
-import "./get_insurance_prices_ok.d.ts";
-import "./get_universe_regions_ok.d.ts";
-import "./get_universe_systems_ok.d.ts";
-import "./get_universe_factions_ok.d.ts";
-import "./get_universe_graphics_ok.d.ts";
-import "./get_industry_facilities_ok.d.ts";
-import "./get_opportunities_tasks_ok.d.ts";
-import "./get_universe_ancestries_ok.d.ts";
-import "./get_universe_bloodlines_ok.d.ts";
-import "./get_universe_categories_ok.d.ts";
-import "./get_universe_structures_ok.d.ts";
-import "./get_opportunities_groups_ok.d.ts";
-import "./get_alliances_alliance_id_ok.d.ts";
-import "./get_corporations_npccorps_ok.d.ts";
-import "./get_fleets_fleet_id_wings_ok.d.ts";
-import "./get_sovereignty_campaigns_ok.d.ts";
-import "./get_universe_system_jumps_ok.d.ts";
-import "./get_universe_system_kills_ok.d.ts";
-import "./get_wars_war_id_killmails_ok.d.ts";
-import "./get_sovereignty_structures_ok.d.ts";
-import "./get_universe_moons_moon_id_ok.d.ts";
-import "./get_universe_stars_star_id_ok.d.ts";
-import "./get_universe_types_type_id_ok.d.ts";
-import "./post_characters_affiliation_ok.d.ts";
-import "./get_characters_character_id_ok.d.ts";
-import "./get_dogma_effects_effect_id_ok.d.ts";
-import "./get_fleets_fleet_id_members_ok.d.ts";
-import "./get_markets_region_id_types_ok.d.ts";
-import "./get_universe_constellations_ok.d.ts";
-import "./get_markets_region_id_orders_ok.d.ts";
-import "./get_route_origin_destination_ok.d.ts";
-import "./get_universe_groups_group_id_ok.d.ts";
-import "./get_markets_region_id_history_ok.d.ts";
-import "./get_contracts_public_region_id_ok.d.ts";
-import "./get_fw_leaderboards_characters_ok.d.ts";
-import "./get_universe_planets_planet_id_ok.d.ts";
-import "./get_universe_regions_region_id_ok.d.ts";
-import "./get_universe_systems_system_id_ok.d.ts";
-import "./get_alliances_alliance_id_icons_ok.d.ts";
-import "./get_corporations_corporation_id_ok.d.ts";
-import "./post_fleets_fleet_id_wings_created.d.ts";
-import "./get_opportunities_tasks_task_id_ok.d.ts";
-import "./get_characters_character_id_mail_ok.d.ts";
-import "./get_characters_character_id_ship_ok.d.ts";
-import "./get_fw_leaderboards_corporations_ok.d.ts";
-import "./get_universe_graphics_graphic_id_ok.d.ts";
-import "./get_universe_stations_station_id_ok.d.ts";
-import "./get_characters_character_id_fleet_ok.d.ts";
-import "./get_characters_character_id_roles_ok.d.ts";
-import "./get_dogma_attributes_attribute_id_ok.d.ts";
-import "./get_opportunities_groups_group_id_ok.d.ts";
-import "./get_alliances_alliance_id_contacts_ok.d.ts";
-import "./get_characters_character_id_assets_ok.d.ts";
-import "./get_characters_character_id_clones_ok.d.ts";
-import "./get_characters_character_id_medals_ok.d.ts";
-import "./get_characters_character_id_mining_ok.d.ts";
-import "./get_characters_character_id_online_ok.d.ts";
-import "./get_characters_character_id_orders_ok.d.ts";
-import "./get_characters_character_id_search_ok.d.ts";
-import "./get_characters_character_id_skills_ok.d.ts";
-import "./get_characters_character_id_titles_ok.d.ts";
-import "./get_characters_character_id_wallet_ok.d.ts";
-import "./get_markets_groups_market_group_id_ok.d.ts";
-import "./get_universe_stargates_stargate_id_ok.d.ts";
-import "./get_characters_character_id_fatigue_ok.d.ts";
-import "./get_characters_character_id_planets_ok.d.ts";
-import "./get_markets_structures_structure_id_ok.d.ts";
-import "./get_universe_categories_category_id_ok.d.ts";
-import "./get_characters_character_id_calendar_ok.d.ts";
-import "./get_characters_character_id_contacts_ok.d.ts";
-import "./get_characters_character_id_fittings_ok.d.ts";
-import "./get_characters_character_id_fw_stats_ok.d.ts";
-import "./get_characters_character_id_implants_ok.d.ts";
-import "./get_characters_character_id_location_ok.d.ts";
-import "./get_characters_character_id_portrait_ok.d.ts";
-import "./get_universe_schematics_schematic_id_ok.d.ts";
-import "./get_universe_structures_structure_id_ok.d.ts";
-import "./get_characters_character_id_contracts_ok.d.ts";
-import "./get_characters_character_id_standings_ok.d.ts";
-import "./get_contracts_public_bids_contract_id_ok.d.ts";
-import "./get_corporations_corporation_id_icons_ok.d.ts";
-import "./get_corporations_corporation_id_roles_ok.d.ts";
-import "./get_alliances_alliance_id_corporations_ok.d.ts";
-import "./get_characters_character_id_attributes_ok.d.ts";
-import "./get_characters_character_id_blueprints_ok.d.ts";
-import "./post_characters_character_id_cspa_created.d.ts";
-import "./post_characters_character_id_mail_created.d.ts";
-import "./get_characters_character_id_mail_lists_ok.d.ts";
-import "./get_characters_character_id_skillqueue_ok.d.ts";
-import "./get_contracts_public_items_contract_id_ok.d.ts";
-import "./get_corporations_corporation_id_assets_ok.d.ts";
-import "./get_corporations_corporation_id_medals_ok.d.ts";
-import "./get_corporations_corporation_id_orders_ok.d.ts";
-import "./get_corporations_corporation_id_titles_ok.d.ts";
-import "./get_characters_character_id_mail_labels_ok.d.ts";
-import "./get_corporations_corporation_id_members_ok.d.ts";
-import "./get_corporations_corporation_id_wallets_ok.d.ts";
-import "./get_dogma_dynamic_items_type_id_item_id_ok.d.ts";
-import "./get_killmails_killmail_id_killmail_hash_ok.d.ts";
-import "./get_characters_character_id_mail_mail_id_ok.d.ts";
-import "./get_corporations_corporation_id_contacts_ok.d.ts";
-import "./get_corporations_corporation_id_fw_stats_ok.d.ts";
-import "./get_loyalty_stores_corporation_id_offers_ok.d.ts";
-import "./get_alliances_alliance_id_contacts_labels_ok.d.ts";
-import "./post_characters_character_id_assets_names_ok.d.ts";
-import "./get_characters_character_id_industry_jobs_ok.d.ts";
-import "./get_characters_character_id_notifications_ok.d.ts";
-import "./get_characters_character_id_opportunities_ok.d.ts";
-import "./get_corporations_corporation_id_contracts_ok.d.ts";
-import "./get_corporations_corporation_id_divisions_ok.d.ts";
-import "./get_corporations_corporation_id_standings_ok.d.ts";
-import "./get_corporations_corporation_id_starbases_ok.d.ts";
-import "./post_characters_character_id_contacts_created.d.ts";
-import "./post_characters_character_id_fittings_created.d.ts";
-import "./get_characters_character_id_loyalty_points_ok.d.ts";
-import "./get_characters_character_id_orders_history_ok.d.ts";
-import "./get_characters_character_id_wallet_journal_ok.d.ts";
-import "./get_corporations_corporation_id_blueprints_ok.d.ts";
-import "./get_corporations_corporation_id_facilities_ok.d.ts";
-import "./get_corporations_corporation_id_structures_ok.d.ts";
-import "./get_characters_character_id_agents_research_ok.d.ts";
-import "./get_characters_character_id_contacts_labels_ok.d.ts";
-import "./get_characters_character_id_killmails_recent_ok.d.ts";
-import "./get_corporations_corporation_id_shareholders_ok.d.ts";
-import "./get_universe_asteroid_belts_asteroid_belt_id_ok.d.ts";
-import "./get_universe_constellations_constellation_id_ok.d.ts";
-import "./post_characters_character_id_assets_locations_ok.d.ts";
-import "./get_characters_character_id_calendar_event_id_ok.d.ts";
-import "./post_characters_character_id_mail_labels_created.d.ts";
-import "./get_characters_character_id_planets_planet_id_ok.d.ts";
-import "./post_corporations_corporation_id_assets_names_ok.d.ts";
-import "./get_corporations_corporation_id_industry_jobs_ok.d.ts";
-import "./get_corporations_corporation_id_medals_issued_ok.d.ts";
-import "./get_corporations_corporation_id_members_limit_ok.d.ts";
-import "./get_corporations_corporation_id_roles_history_ok.d.ts";
-import "./get_characters_character_id_corporationhistory_ok.d.ts";
-import "./get_corporations_corporation_id_members_titles_ok.d.ts";
-import "./get_corporations_corporation_id_membertracking_ok.d.ts";
-import "./get_corporations_corporation_id_orders_history_ok.d.ts";
-import "./post_fleets_fleet_id_wings_wing_id_squads_created.d.ts";
-import "./get_characters_character_id_wallet_transactions_ok.d.ts";
-import "./get_corporation_corporation_id_mining_observers_ok.d.ts";
-import "./get_corporations_corporation_id_alliancehistory_ok.d.ts";
-import "./get_corporations_corporation_id_contacts_labels_ok.d.ts";
-import "./get_corporations_corporation_id_containers_logs_ok.d.ts";
-import "./get_corporations_corporation_id_customs_offices_ok.d.ts";
-import "./get_corporations_corporation_id_killmails_recent_ok.d.ts";
-import "./get_corporation_corporation_id_mining_extractions_ok.d.ts";
-import "./post_corporations_corporation_id_assets_locations_ok.d.ts";
-import "./get_characters_character_id_notifications_contacts_ok.d.ts";
-import "./get_corporations_corporation_id_starbases_starbase_id_ok.d.ts";
-import "./get_characters_character_id_contracts_contract_id_bids_ok.d.ts";
-import "./get_characters_character_id_calendar_event_id_attendees_ok.d.ts";
-import "./get_characters_character_id_contracts_contract_id_items_ok.d.ts";
-import "./get_corporations_corporation_id_wallets_division_journal_ok.d.ts";
-import "./get_corporations_corporation_id_contracts_contract_id_bids_ok.d.ts";
-import "./get_corporation_corporation_id_mining_observers_observer_id_ok.d.ts";
-import "./get_corporations_corporation_id_contracts_contract_id_items_ok.d.ts";
-import "./get_corporations_corporation_id_wallets_division_transactions_ok.d.ts";
-import "./extra-types.d.ts";
+import "./globals/alliance.d.ts";
+import "./globals/assets.d.ts";
+import "./globals/calendar.d.ts";
+import "./globals/character.d.ts";
+import "./globals/clones.d.ts";
+import "./globals/contacts.d.ts";
+import "./globals/contracts.d.ts";
+import "./globals/corporation.d.ts";
+import "./globals/dogma.d.ts";
+import "./globals/factionwarfare.d.ts";
+import "./globals/fittings.d.ts";
+import "./globals/fleets.d.ts";
+import "./globals/incursions.d.ts";
+import "./globals/industry.d.ts";
+import "./globals/insurance.d.ts";
+import "./globals/killmails.d.ts";
+import "./globals/location.d.ts";
+import "./globals/loyalty.d.ts";
+import "./globals/mail.d.ts";
+import "./globals/market.d.ts";
+import "./globals/planetaryinteraction.d.ts";
+import "./globals/routes.d.ts";
+import "./globals/search.d.ts";
+import "./globals/skills.d.ts";
+import "./globals/sovereignty.d.ts";
+import "./globals/status.d.ts";
+import "./globals/universe.d.ts";
+import "./globals/wallet.d.ts";
+import "./globals/wars.d.ts";
+import "./globals/extra-types.d.ts";
 

package/v2/types-util.d.ts

@@ -0,0 +1,335 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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/types-util.d.ts
+ * @summary This file is auto-generated and defines version 3.2.0 of the EVE Online ESI response types.
+ */
+import type { TESIResponseOKMap } from "./response-map.d.ts";
+import "./index.d.ts"
+
+// export type TMappingToNumber = { [key in string | number | symbol]: number };
+/**
+ * @experimental
+ *
+ * InferNextEndpoint is an experimental utility type designed to verify and infer the "next" applicable
+ * ESI endpoint based on an initial endpoint's result type. In essence, it inspects the URL pattern and
+ * the inferred response type (Resut) associated with a given endpoint (EP) and then determines whether that
+ * endpoint can be further chained to another ESI endpoint.
+ *
+ * **The type parameters are as follows**:
+ * 
+ * @param M - The HTTP method type (e.g. "get", "post", etc.), which must extend TESIEntryMethod.
+ * @param EP - The current ESI endpoint under inspection; it extends ESIEndpointOf<M>.
+ * @param Resut - Defaults to InferESIResponseResult<M, EP>; it is the inferred response result of the endpoint.
+ *                This type is tested against acceptable response formats (either a number array or an object
+ *                mapping keys to numbers).
+ * @param Endpoints - Defaults to ESIEndpointOf<M>; represents the union of all endpoints for method M to be
+ *                considered as potential next endpoints.
+ *
+ * The type works by iterating over each endpoint (EPOrigin) in the union Endpoints. For each EPOrigin:
+ *  - It checks whether the original endpoint EP is assignable to Endpoints.
+ *  - It then tests if EPOrigin extends the template literal type `${EP}{${string}}/${string}`—that is, if EPOrigin
+ *    is a URL based on EP that includes a parameterized section (denoted by `{...}`) followed by some additional
+ *    path segments.
+ *  - Next, it ensures that the inferred response result type (Resut) conforms to one of the acceptable formats:
+ *    either a number array or an object whose values are numbers. The object form uses `{ [x: infer T]: number }`
+ *    for type inference (this version works as intended).
+ *  - If all conditions are met, EPOrigin is retained in the union; otherwise, it is replaced with never.
+ *
+ * Finally, the mapped type is indexed over Endpoints to yield a union of all endpoint URLs that satisfy the above
+ * conditions. This allows chaining or conditional logic in ESI client implementations based on response shape.
+ *
+ * @example
+ * // Given:
+ * // - M = "get"
+ * // - EP = "/characters/{character_id}/"
+ * // - And InferESIResponseResult<"get", "/characters/{character_id}/"> is inferred as number[] or a
+ * //     valid mapping (e.g., { [x: string]: number })
+ * // Then, InferNextEndpoint<"get", "/characters/{character_id}/"> computes to the union of endpoints like:
+ * //   "/characters/{character_id}/assets"   // if it matches the template and response type constraint.
+ *
+ * @remarks
+ * This type is highly experimental and leverages advanced TypeScript features—including conditional types,
+ * template literal types, and type inference—to perform non-trivial endpoint validation.
+ */
+//* ctt ignore path parameter
+export type InferNextEndpoint<
+  M extends TESIEntryMethod,
+  EP extends Exclude<ESIEndpointOf<M>, symbol> = Exclude<ESIEndpointOf<M>, symbol>,
+  BaseResut extends InferESIResponseResult<M, EP> = InferESIResponseResult<M, EP>,
+  Endpoints extends ESIEndpointOf<M> = ESIEndpointOf<M>,
+> = {
+  [NextEP in Endpoints]: NextEP extends `${EP}${string}{${string}}/${string}`
+    // ? BaseResut extends number[] | TMappingToNumber // does not works...("skipLibCheck=false")
+    // DEVNOTE: As it turns out, the behavior of this utility type is broken unless you use the "skipLibCheck=true".
+    ? BaseResut extends number[] | { [x: infer T]: number }
+    //* ctt
+    ? NextEP : never
+    /*/
+    ? __ShiftType extends 0
+      ? [EP, NextEP, BaseResut] : NextEP
+    : never
+    //*/
+  : never;
+}[Endpoints];
+
+/**
+ * `InferNextEndpoint2` is a utility type that infers the next endpoint based on the current endpoint and method.
+ * 
+ * DONE: 2025/4/11 15:45:01 
+ * ``` jsonc
+ * // From the EP, infer the next parameterized endpoint to request.
+ * // If the result of the EP is `number[] | { [x: infer T]: number }`, infer the next parameterized endpoint to request.
+ * ```
+ * 
+ * @template M - The HTTP method to use for the request.
+ * @template EP - The endpoint from which the next parameterized endpoint to request is inferred.
+ * @template BaseResut - The base response result type.
+ * @template Endpoints - The possible endpoints for the given method.
+ * 
+ * @example
+ * ```ts
+ * type NextEndpoint = InferNextEndpoint2<"post", "/fleets/{fleet_id}/wings/">;
+ * // Result: "/fleets/{fleet_id}/wings/{wing_id}/squads/"
+ * ```
+ * @remarks
+ * This type is useful for chaining requests or determining the next endpoint to call based on the current endpoint.
+ */
+export type InferNextEndpoint2<
+  M extends TESIEntryMethod,
+  EP extends ESIEndpointOf<M> = ESIEndpointOf<M>,
+  BaseResut extends InferESIResponseResultEX<`${M}:${EP}`> = InferESIResponseResultEX<`${M}:${EP}`>,
+  Endpoints extends ESIEndpointOf<M> = ESIEndpointOf<M>,
+> = {
+  [NextEP in Endpoints]: NextEP extends `${EP}{${string}}/${string}`
+    // ? BaseResut extends number[] | TMappingToNumber // does not works...("skipLibCheck=false")
+    // DEVNOTE: As it turns out, the behavior of this utility type is broken unless you use the "skipLibCheck=true".
+    ? BaseResut extends number[] | { [x: infer T]: number }
+      ? NextEP : never
+  : never;
+}[Endpoints];
+
+/**
+ * `InferNextEndpointLoos` is a utility type that infers the next endpoint based on the current endpoint and method.
+ * 
+ * DONE: 2025/4/11 15:45:01 
+ * ``` jsonc
+ * // Infer the next parameterized endpoint to request from the EP
+ * // Does not validate the EP result, just infers the next endpoint to request
+ * ```
+ * 
+ * @template M - The HTTP method to use for the request.
+ * @template EP - The endpoint from which the next parameterized endpoint to request is inferred.
+ * @template Endpoints - The possible endpoints for the given method.
+ * 
+ * @example
+ * ```ts
+ * type NextEndpoint = InferNextEndpointLoos<"get", "/markets/groups/">;
+ * // Result: "/markets/groups/{market_group_id}/"
+ * ```
+ * @remarks
+ * This type is useful for chaining requests or determining the next endpoint to call based on the current endpoint.
+ * It does not validate the response type of the endpoint, only the URL pattern.
+ */
+export type InferNextEndpointLoos<
+  M extends TESIEntryMethod,
+//* ctt
+  // DEVNOTE: As it turns out, the behavior of this utility type is broken unless you use the "skipLibCheck=true".
+  EP extends ESIEndpointOf<M> = ESIEndpointOf<M>,
+  Endpoints extends ESIEndpointOf<M> = ESIEndpointOf<M>,
+/*/
+  // This fix is required for skipLibCheck=false
+  EP extends Exclude<ESIEndpointOf<M>, symbol> = Exclude<ESIEndpointOf<M>, symbol>,
+  Endpoints extends Exclude<ESIEndpointOf<M>, symbol> = Exclude<ESIEndpointOf<M>, symbol>,
+//*/
+> = {
+  [NextEP in Endpoints]: NextEP extends `${EP}{${string}}${string}` ? NextEP : never
+}[Endpoints];
+
+/**
+ * @see For the meaning of this type of comment trick, see {@link InferNextEndpointLoos} line comment.
+ */
+type ESIEndpointUnions = {
+  [M in TESIEntryMethod]: `${M}:${
+    //* ctt
+    ESIEndpointOf<M>
+    /*/
+    Exclude<ESIEndpointOf<M>, symbol>
+    //*/
+  }`;
+}[TESIEntryMethod];
+export type InferESIResponseResultEX<
+  EP extends unknown
+  // EP extends ESIEndpointUnions
+> = EP extends `${infer M}:${infer EPRest}`
+  ? M extends TESIEntryMethod
+    ? EPRest extends ESIEndpointOf<M>
+      ? _ESIResponseType<M, EPRest> extends { result: infer U }
+        ? U : never
+      : never
+    : never
+  : never;
+
+/**
+ * Represents a function that can make ESI requests with various HTTP methods.
+ *
+ * @template ActualOpt - The actual type of the options.
+ *
+ * @example
+ * ```ts
+ * // @ ts-expect-error
+ * export const request: IESIRequestFunction2<ESIRequestOptions> = (method, endpoint, opt) => {
+ * // Implementation for "get" | "post" | "put" | "delete" request
+ * };
+ * // You can easily implement "get" | "post" | "put" | "delete" requests
+ * // with code like the following:
+ * (["get", "post", "put", "delete"] as (keyof typeof request)[]).forEach((method) => {
+ *     request[method] = function (this: typeof request, endpoint, opt) {
+ *         return this(method, endpoint, opt);
+ *     } as TESIRequestFunctionEachMethod2<typeof method>;
+ * });
+ * ```
+ */
+export interface IESIRequestFunction2<ActualOpt extends Record<string, unknown>>
+  extends TESIRequestFunctionSignature2<ActualOpt>, TESIRequestFunctionMethods2<ActualOpt> {
+}
+
+/**
+ * Represents the methods available for making ESI requests.
+ * 
+ *  + This interface is used when you already have implementation code such as  
+ *    TESIRequestFunctionSignature2 and you want to implement additional shorthand methods.
+ *
+ * @template ActualOpt - The actual type of the options.
+ *
+ * @example
+ * ```ts
+ * export const request: TESIRequestFunctionSignature2<ESIRequestOptions> = (method, endpoint, opt) => {
+ * // Implementation for "get" | "post" | "put" | "delete" request
+ * };
+ * // You can easily implement "get" | "post" | "put" | "delete" requests
+ * // with code like the following:
+ * const esiMethods = {} as TESIRequestFunctionMethods2<ESIRequestOptions>;
+ * (["get", "post", "put", "delete"] as (keyof TESIRequestFunctionMethods2)[]).forEach((method) => {
+ *     esiMethods[method] = function (endpoint, opt) {
+ *         return request(method, endpoint, opt);
+ *     } as TESIRequestFunctionEachMethod2<typeof method>;
+ * });
+ * ```
+ */
+export type TESIRequestFunctionMethods2<ActualOpt extends Record<string, unknown>> = {
+  [method in TESIEntryMethod]: TESIRequestFunctionEachMethod2<method, ActualOpt>;
+}
+
+/**
+ * List of "x-cached-seconds"
+ * 
+ * ```ts
+ * // const cacheSecGet: 3600 | 300 | 604800 | 120 | 5 | 600 | 86400 | 60 | 30 | 1200 | 1800 | 30758400
+ * const cacheSecGet: TESICachedSeconds<"get">;
+ * // const cache5sec: 5
+ * const cache5s: TESICachedSeconds<"put">;
+ * // const cache3600s: 3600
+ * const cache3600s: TESICachedSeconds<"post">;
+ * // "/characters/affiliation/"
+ * const cache3600sEndpoint: TESICachedSeconds<"post", 1>;
+ * ```
+ */
+export declare type TESICachedSeconds<
+  Method extends TESIEntryMethod, AsEndpoint = 0
+> = {
+  [M in TESIEntryMethod]: {
+    [EP in ESIEndpointOf<M>]: TESIResponseOKMap[M][EP] extends { cachedSeconds: number }
+      ? AsEndpoint extends 0
+        ? TESIResponseOKMap[M][EP]["cachedSeconds"]: EP
+      : never
+  }[ESIEndpointOf<M>];
+}[Method];
+
+/**
+ * Indicates that no path parameters are allowed.
+ *
+ * This type serves as a compile-time signal for endpoints that do not support dynamic URL segments.  
+ * By using this type, it is clear that no path parameters should be provided.
+ */
+export declare type TPathParamsNever = { /* pathParams?: never */ };
+
+// local types
+/**
+ * Infers the response type of an ESI request based on the HTTP method and endpoint.
+ * 
+ * This type extracts the response type from the `TESIResponseOKMap` based on the provided
+ * HTTP method and endpoint.
+ * 
+ * @template M - The HTTP method to use for the request.
+ * @template EPx - The endpoint path.
+ * 
+ * @example
+ * ```ts
+ * type ResponseType = _ESIResponseType<"get", "/characters/{character_id}/">;
+ * // Result: The inferred response type for the given method and endpoint.
+ * ```
+ * @internal
+ * @see {@link ESIEndpointOf}
+ */
+export type _ESIResponseType<
+  M extends TESIEntryMethod,
+  EPx extends ESIEndpointOf<M> | string,
+> = TESIResponseOKMap[M][Extract<EPx, ESIEndpointOf<M>>];
+// type XOK = _ESIResponseType<"get", "/status/"> extends global._ESIResponseType<"get", "/status/"> ? 1 : 0;
+/**
+ * Determines if the endpoint requires path parameters.
+ * 
+ * @template EP - The string representing the endpoint path.
+ * @returns {TPathParamsNever | { pathParams: IfParameterizedPath<EP> }}
+ * Returns an object with `pathParams` if the endpoint requires parameters, otherwise returns `TPathParamsNever`.
+ * @example
+ * ```ts
+ * type Example = IfNeedPathParams<"/characters/{character_id}/fittings/{fitting_id}/">;
+ * // Result: { pathParams: [number, number] }
+ * ```
+ * @internal
+ * @see {@link IfParameterizedPath}
+ * @see {@link ReplacePathParams}
+ */
+export type _IfNeedPathParams<
+  EP extends unknown,
+  // will be `never` when cached
+  // Parameterized extends IfParameterizedPath<EP> = IfParameterizedPath<EP>
+> = IfParameterizedPath<EP> extends never
+  ? TPathParamsNever :
+    EP extends ReplacePathParams<EP>
+      ? TPathParamsNever : { pathParams: IfParameterizedPath<EP> };
+
+/**
+ * Infer the result type of an ESI response based on the method and endpoint.
+ * 
+ * @template M - The HTTP method (e.g., "get", "post").
+ * @template EP - The endpoint path.
+ * @deprecated 2025/3/17
+ */
+export type __InferESIResponseResult<
+  M extends TESIEntryMethod,
+  EP extends ESIEndpointOf<M>
+> = TESIResponseOKMap[M][EP] extends { result: infer U } ? U : never;
+/**
+ * Identifies the required parameters for a given entry type.
+ *
+ * @template Entry - The entry type to identify parameters for.
+ * @template Opt - The type of the parameters.
+ * @type {Opt & Pick<Entry, Exclude<keyof Entry, "result">>}
+ * @deprecated 2025/3/17
+ */
+export type __IdentifyParameters<
+  Entry, Opt,
+  Keys = Exclude<keyof Entry, "result" | "tag" | "cachedSeconds">
+  // @ts-expect-error 
+> = RequireThese<Opt, Keys> & Pick<Entry, Keys>;
+

package/v2/util.d.ts

@@ -27,7 +27,7 @@ export type PickPathParameters<Path extends string> =
  * @template U The union type to convert.
  * @returns {I} The intersection type.
  */
-type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 
 /**
  * Convert a union type to a tuple.
@@ -35,13 +35,15 @@ type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (
  * @template T The union type to convert.
  * @returns {Array} The tuple representation of the union type.
  */
-type UnionToTuple<T> = UnionToIntersection<
+export type UnionToTuple<T> = UnionToIntersection<
   T extends any ? () => T : never
 > extends () => infer R ? [...UnionToTuple<Exclude<T, R>>, R] : [];
 
 /**
  * #### Build an array of elements from a flattened tuple of type "1" | "2" | "3" ...
  * 
+ * NOTE: This utility cannot calculate lengths greater than 48 (?).
+ * 
  *  + Returns the final length of the array.
  * 
  * @template T The union type to be converted to a tuple and measured.

package/web/index.html

@@ -44,7 +44,7 @@
           if (key === "Enter") {
             const cmd = inputBuffer;
             inputBuffer = "";
-            eval(`(${cmd})`);
+            eval(`${cmd}`);
           } else if (key.length === 1) {
             inputBuffer += key;
           }