eve-esi-types 3.0.1 → 3.0.3

package/lib/rq-util.d.mts

@@ -181,6 +181,9 @@ export declare function getLogger(): {
     clog: (...args: any[]) => void;
     rlog: (...args: any[]) => void;
 };
+export type TFireWithoutAuth = {
+    fireWithoutAuth<M extends TESIEntryMethod, RealEP extends ReplacePathParams<keyof TESIResponseOKMap[M] & string> | keyof TESIResponseOKMap[M], EP extends InferEndpointOrigin<RealEP, keyof TESIResponseOKMap[M]> extends never ? RealEP : InferEndpointOrigin<RealEP, keyof TESIResponseOKMap[M]>, PathParams extends RealEP extends EP ? IfNeedPathParams<EP> : TPathParamsNever, Opt extends IdentifyParameters<TESIResponseOKMap[M][Extract<EP, keyof TESIResponseOKMap[M]>], ESIRequestOptions & PathParams>, R extends InferESIResponseResult<M, Extract<EP, keyof TESIResponseOKMap[M]>>, HasOpt = HasRequireParams<TESIResponseOKMap[M][Extract<EP, keyof TESIResponseOKMap[M]>]> extends never ? 0 : 1>(fn: TESIRequestFunctionSignature2<ESIRequestOptions> | TESIRequestFunctionMethods2<ESIRequestOptions>, method: M, endpoint: RealEP, ...opt: HasOpt extends 1 ? [Opt] : [Opt?]): Promise<R>;
+}["fireWithoutAuth"];
 /**
  * Need typescript v5.5 later
  * @import * as ESI from "../v2";
@@ -189,12 +192,6 @@ export declare function getLogger(): {
  * @typedef {ESI.IESIRequestFunction2<ESIRequestOptions>} IESIRequestFunction2
  * @typedef {ESI.TESIRequestFunctionMethods2<ESIRequestOptions>} TESIRequestFunctionMethods2
  */
-/**
- * #### Fire a request that does not require authentication.
- *
- * @type {import("./rq-util.d.mts").fireWithoutAuth}
- */
-export declare function fireWithoutAuth<M extends TESIEntryMethod, RealEP extends ReplacePathParams<keyof TESIResponseOKMap[M] & string> | keyof TESIResponseOKMap[M], EP extends InferEndpointOrigin<RealEP, keyof TESIResponseOKMap[M]> extends never ? RealEP : InferEndpointOrigin<RealEP, keyof TESIResponseOKMap[M]>, PathParams extends RealEP extends EP ? IfNeedPathParams<EP> : TPathParamsNever, Opt extends IdentifyParameters<TESIResponseOKMap[M][Extract<EP, keyof TESIResponseOKMap[M]>], ESIRequestOptions & PathParams>, R extends InferESIResponseResult<M, Extract<EP, keyof TESIResponseOKMap[M]>>>(fn: TESIRequestFunctionSignature2<ESIRequestOptions> | TESIRequestFunctionMethods2<ESIRequestOptions>, method: M, endpoint: RealEP, opt?: Opt): Promise<R>;
 /**
  * #### Fire a request that does not require authentication.
  *

package/lib/rq-util.mjs

@@ -320,29 +320,27 @@ export function getLogger() {
     const rlog = consoleUtil.getLogger("- - -> Run ESI request".cyan);
     return { clog, rlog };
 }
-/**
- * Need typescript v5.5 later
- * @import * as ESI from "../v2";
- * @typedef {ESI.TESIResponseOKMap} TESIResponseOKMap
- * @typedef {ESI.TPathParamsNever} TPathParamsNever
- * @typedef {ESI.IESIRequestFunction2<ESIRequestOptions>} IESIRequestFunction2
- * @typedef {ESI.TESIRequestFunctionMethods2<ESIRequestOptions>} TESIRequestFunctionMethods2
- */
-// type ESIEndpointBrand<EP> = EP & { __esi: "x"; };
-// type EPPost = ESIEndpointBrand<keyof TESIResponseOKMap["post"]>;
 /**
  * #### Fire a request that does not require authentication.
  *
- * @type {import("./rq-util.d.mts").fireWithoutAuth}
+ * @type {import("./rq-util.d.mts").TFireWithoutAuth}
  */
-export function fireWithoutAuth(fn, method, endpoint, opt) {
+const fireWithoutAuth = (fn, method, endpoint, ...opt) => {
     if (typeof fn === "function") {
         // @ts-expect-error TODO: ts(2345) The argument type does not match the type of the specified parameter
         return fn(method, endpoint, opt);
     }
     // @ts-expect-error TODO: ts(2345) The argument type does not match the type of the specified parameter
     return fn[method](endpoint, opt);
-}
+};
+/**
+ * Need typescript v5.5 later
+ * @import * as ESI from "../v2";
+ * @typedef {ESI.TESIResponseOKMap} TESIResponseOKMap
+ * @typedef {ESI.TPathParamsNever} TPathParamsNever
+ * @typedef {ESI.IESIRequestFunction2<ESIRequestOptions>} IESIRequestFunction2
+ * @typedef {ESI.TESIRequestFunctionMethods2<ESIRequestOptions>} TESIRequestFunctionMethods2
+ */
 /**
  * #### Fire a request that does not require authentication.
  *
@@ -418,7 +416,13 @@ 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/");
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/search/", {
+            auth: true,
+            pathParams: 1234,
+            query: {
+                categories: ["alliance"], search: "test!!"
+            }
+        });
         log(willFailed);
     }
     catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-esi-types",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "Extracted the main type of ESI. use for ESI request response types (version 2 only)",
   "main": "v2/index.d.ts",
   "scripts": {

package/tagged-rq.mjs

@@ -8,32 +8,46 @@
 /// <reference types="./v2"/>
 /**
  * @file tagged-rq.mts
- * @command node tagged-rq.mjs -x
+ * @command node tagged-rq.mjs -x -debug
  */
 import { esi } from "./lib/tagged-request-api.mjs";
-// import * as util from "./lib/rq-util.mjs";
+import * as util from "./lib/rq-util.mjs";
 // Furthermore, the endpoint selected is narrowed down by "tags" and "method".
-esi.assets.get("/characters/2112625428/assets/", {
-    auth: true
-}).then(console.log).catch(console.log);
+esi.alliance.get("/alliances/").then(aIds => {
+    console.log(`get:alliances, id size=${aIds.length}`);
+    // for (const aid of aIds.slice(0, 20)) {
+    //     esi.alliance.get(`/alliances/${aid}/`).then(console.log);
+    // }
+});
 esi.character.get("/characters/{character_id}/", { pathParams: 2112625428 }).then(console.log);
-esi.mail.post("/characters/2112625428/mail/", /** @satisfies {Pick<TESIResponsePostEntry<"/characters/{character_id}/mail/">, "auth" | "body">} */ ({
-    auth: true,
-    body: {
-        subject: "test!!",
-        body: "",
-        recipients: [{
-                recipient_id: 2112625428, recipient_type: "character"
-            }]
-    },
-    // token: "s.s.s"
-})).then(console.log).catch(console.log);
-esi.universe.get("/universe/structures/", { query: { filter: "market" } }).then(console.log);
 esi.universe.post("/universe/ids/", {
     body: ["the forge", "plex"]
 }).then(console.log);
-esi.fittings.delete("/characters/{character_id}/fittings/{fitting_id}/", {
-    pathParams: [1234, 56789],
-    auth: true
-});
-esi.character.post("/characters/affiliation/").catch(console.log);
+esi.universe.post("/universe/names/", {
+    body: [44992, 434243723, 109299958, 10000002]
+}).then(console.log);
+esi.universe.get("/universe/structures/", { query: { filter: "market" } }).then(console.log);
+// node tagged-rq.mjs -x -debug -withError
+if (util.is("withError")) {
+    esi.assets.get("/characters/2112625428/assets/", {
+        auth: true
+    }).then(console.log).catch(console.log);
+    esi.mail.post("/characters/2112625428/mail/", /** @satisfies {Pick<TESIResponsePostEntry<"/characters/{character_id}/mail/">, "auth" | "body">} */ ({
+        auth: true,
+        body: {
+            subject: "test!!",
+            body: "",
+            recipients: [{
+                    recipient_id: 2112625428, recipient_type: "character"
+                }]
+        },
+        // token: "s.s.s"
+    })).then(console.log).catch(console.log);
+    esi.fittings.delete("/characters/{character_id}/fittings/{fitting_id}/", {
+        pathParams: [1234, 56789],
+        auth: true
+    });
+    esi.character.post("/characters/affiliation/", {
+        body: [12345]
+    }).catch(console.log);
+}

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

@@ -9,7 +9,7 @@
  * 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 3.0.0 of the EVE Online ESI response types.
+ * @summary This file is auto-generated and defines version 3.0.3 of the EVE Online ESI response types.
  */
 import { TESIResponseOKMap, TPathParamsNever } from "./index.d.ts";
 export * from "./index.d.ts";
@@ -92,9 +92,10 @@ export declare type TaggedEndpointRequestFunction2<M extends TESIEntryMethod, Ta
   PathParams extends RealEP extends EP ? IfNeedPathParams<EP>: TPathParamsNever,
   Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], ActualOpt & PathParams>,
   R extends InferESIResponseResult<M, EP>,
+  HasOpt = HasRequireParams<TESIResponseOKMap[M][EP]> extends never ? 0 : 1
   // RealEPX = ReplacePathParamsX<RealEPX>,
   // EPX = ReplacePathParams<EP>,
->(endpoint: RealEP, options?: Opt) => Promise<R>;
+>(endpoint: RealEP, ...options: HasOpt extends 1 ? [Opt] : [Opt?]) => Promise<R>;
 
 
 // - - - - - - - - - - - - - - - - - - - - - - - - - -

package/v2/extra-types.d.ts

@@ -7,7 +7,7 @@
  * @minItems 1
  * @maxItems 1000
  */
-type PostCharactersAffiliationCharacters = number[];
+type PostCharactersAffiliationCharacters = [number, ...number[]];
 
 /* post_characters_character_id_assets_locations body type, name: item_ids */
 
@@ -17,7 +17,7 @@ type PostCharactersAffiliationCharacters = number[];
  * @minItems 1
  * @maxItems 1000
  */
-type PostCharactersCharacterIdAssetsLocationsItemIds = number[];
+type PostCharactersCharacterIdAssetsLocationsItemIds = [number, ...number[]];
 
 /* post_characters_character_id_assets_names body type, name: item_ids */
 
@@ -27,7 +27,7 @@ type PostCharactersCharacterIdAssetsLocationsItemIds = number[];
  * @minItems 1
  * @maxItems 1000
  */
-type PostCharactersCharacterIdAssetsNamesItemIds = number[];
+type PostCharactersCharacterIdAssetsNamesItemIds = [number, ...number[]];
 
 /* put_characters_character_id_calendar_event_id body type, name: response */
 
@@ -52,7 +52,7 @@ interface PutCharactersCharacterIdCalendarEventIdResponse {
  * @minItems 1
  * @maxItems 100
  */
-type PostCharactersCharacterIdContactsContactIds = number[];
+type PostCharactersCharacterIdContactsContactIds = [number, ...number[]];
 
 /* put_characters_character_id_contacts body type, name: contact_ids */
 
@@ -62,7 +62,7 @@ type PostCharactersCharacterIdContactsContactIds = number[];
  * @minItems 1
  * @maxItems 100
  */
-type PutCharactersCharacterIdContactsContactIds = number[];
+type PutCharactersCharacterIdContactsContactIds = [number, ...number[]];
 
 /* post_characters_character_id_cspa body type, name: characters */
 
@@ -72,7 +72,7 @@ type PutCharactersCharacterIdContactsContactIds = number[];
  * @minItems 1
  * @maxItems 100
  */
-type PostCharactersCharacterIdCspaCharacters = number[];
+type PostCharactersCharacterIdCspaCharacters = [number, ...number[]];
 
 /* post_characters_character_id_fittings body type, name: fitting */
 
@@ -82,7 +82,7 @@ type PostCharactersCharacterIdCspaCharacters = number[];
  * @minItems 1
  * @maxItems 512
  */
-type PostCharactersCharacterIdFittingsItems = PostCharactersCharacterIdFittingsItem[];
+type PostCharactersCharacterIdFittingsItems = [PostCharactersCharacterIdFittingsItem, ...PostCharactersCharacterIdFittingsItem[]];
 /**
  * Fitting location for the item. Entries placed in 'Invalid' will be discarded. If this leaves the fitting with nothing, it will cause an error.
  */
@@ -168,7 +168,7 @@ interface PostCharactersCharacterIdFittingsItem {
  * @minItems 1
  * @maxItems 50
  */
-type PostCharactersCharacterIdMailRecipients = PostCharactersCharacterIdMailRecipient[];
+type PostCharactersCharacterIdMailRecipients = [PostCharactersCharacterIdMailRecipient, ...PostCharactersCharacterIdMailRecipient[]];
 /**
  * recipient_type string
  */
@@ -270,7 +270,7 @@ interface PutCharactersCharacterIdMailMailIdContents {
  * @minItems 1
  * @maxItems 1000
  */
-type PostCorporationsCorporationIdAssetsLocationsItemIds = number[];
+type PostCorporationsCorporationIdAssetsLocationsItemIds = [number, ...number[]];
 
 /* post_corporations_corporation_id_assets_names body type, name: item_ids */
 
@@ -280,7 +280,7 @@ type PostCorporationsCorporationIdAssetsLocationsItemIds = number[];
  * @minItems 1
  * @maxItems 1000
  */
-type PostCorporationsCorporationIdAssetsNamesItemIds = number[];
+type PostCorporationsCorporationIdAssetsNamesItemIds = [number, ...number[]];
 
 /* put_fleets_fleet_id body type, name: new_settings */
 
@@ -390,7 +390,7 @@ interface PutFleetsFleetIdWingsWingIdNaming {
  * @minItems 1
  * @maxItems 50
  */
-type PostUiOpenwindowNewmailRecipients = number[];
+type PostUiOpenwindowNewmailRecipients = [number, ...number[]];
 
 /**
  * new_mail object
@@ -424,7 +424,7 @@ interface PostUiOpenwindowNewmailNewMail {
  * @minItems 1
  * @maxItems 500
  */
-type PostUniverseIdsNames = string[];
+type PostUniverseIdsNames = [string, ...string[]];
 
 /* post_universe_names body type, name: ids */
 
@@ -434,7 +434,7 @@ type PostUniverseIdsNames = string[];
  * @minItems 1
  * @maxItems 1000
  */
-type PostUniverseNamesIds = number[];
+type PostUniverseNamesIds = [number, ...number[]];
 
 
 /*! query types */
@@ -446,7 +446,7 @@ type PostUniverseNamesIds = number[];
  * @minItems 1
  * @maxItems 20
  */
-type DeleteCharactersCharacterIdContactsContactIds = number[];
+type DeleteCharactersCharacterIdContactsContactIds = [number, ...number[]];
 
 /* post_characters_character_id_contacts, label_ids query type */
 
@@ -497,7 +497,7 @@ type GetCharactersCharacterIdSearchCategory =
  * @minItems 1
  * @maxItems 11
  */
-type GetCharactersCharacterIdSearchCategories = GetCharactersCharacterIdSearchCategory[];
+type GetCharactersCharacterIdSearchCategories = [GetCharactersCharacterIdSearchCategory, ...GetCharactersCharacterIdSearchCategory[]];
 
 /* get_characters_character_id_search, search query type */
 

package/v2/index.d.ts

@@ -9,7 +9,7 @@
  * 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 3.0.0 of the EVE Online ESI response types.
+ * @summary This file is auto-generated and defines version 3.0.3 of the EVE Online ESI response types.
  */
 
 import type { TESIResponseOKMap } from "./response-map.d.ts";
@@ -138,8 +138,9 @@ declare global {
     // If RealEP points to an endpoint origin (not a replaced endpoint), the path parameter is required
     PathParams extends RealEP extends EP ? IfNeedPathParams<EP>: TPathParamsNever,
     Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], ActualOpt & PathParams>,
-    R extends InferESIResponseResult<M, EP>
-  >(method: M, endpoint: RealEP, options?: Opt) => Promise<R>;
+    R extends InferESIResponseResult<M, EP>,
+    HasOpt = HasRequireParams<TESIResponseOKMap[M][EP]> extends never ? 0 : 1
+  >(method: M, endpoint: RealEP, ...options: HasOpt extends 1 ? [Opt] : [Opt?]) => Promise<R>;
 
   /**
    * Represents a function that can make ESI requests for a specific HTTP method.
@@ -165,8 +166,9 @@ declare global {
     EP extends InferEndpointOrigin<RealEP, keyof TESIResponseOKMap[M]> extends never ? RealEP: InferEndpointOrigin<RealEP, keyof TESIResponseOKMap[M]>,
     PathParams extends RealEP extends EP ? IfNeedPathParams<EP>: TPathParamsNever,
     Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], ActualOpt & PathParams>,
-    R extends InferESIResponseResult<M, EP>
-  >(endpoint: RealEP, options?: Opt) => Promise<R>;
+    R extends InferESIResponseResult<M, EP>,
+    HasOpt = HasRequireParams<TESIResponseOKMap[M][EP]> extends never ? 0 : 1
+  >(endpoint: RealEP, ...options: HasOpt extends 1 ? [Opt] : [Opt?]) => Promise<R>;
 
   /**
    * Replaces path parameters in a string with numbers.
@@ -222,6 +224,22 @@ declare global {
   //   }[keyof TESIResponseOKMap[Method]]
   // }[TESIEntryMethod];
 
+  /**
+   * Determines if the given entry has required parameters.
+   * 
+   * This type checks if an entry has any required parameters by excluding the keys "result", "tag", and "cachedSeconds".
+   * If any keys remain after this exclusion, it means the entry has required parameters.
+   * 
+   * @template Entry - The entry type to check for required parameters.
+   * 
+   * @example
+   * ```ts
+   * type ExampleEntry = { result: string, tag: string, cachedSeconds: number, auth: string };
+   * type HasRequired = HasRequireParams<ExampleEntry>; // "auth"
+   * ```
+   */
+  type HasRequireParams<Entry> = Exclude<keyof Entry, "result" | "tag" | "cachedSeconds">;
+
   //  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
   //                                Version 2 types
   //  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

package/v2/response-map.d.ts

@@ -9,7 +9,7 @@
  * THIS DTS IS AUTO GENERATED, DO NOT EDIT
  * 
  * @file eve-esi-types/v2/response-map.d.ts
- * @summary This file is auto-generated and defines version 3.0.0 of the EVE Online ESI response types.
+ * @summary This file is auto-generated and defines version 3.0.3 of the EVE Online ESI response types.
  */
 import "./types-index.d.ts";
 

package/v2/types-index.d.ts

@@ -9,7 +9,7 @@
  * 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.0.0 of the EVE Online ESI response types.
+ * @summary This file is auto-generated and defines version 3.0.3 of the EVE Online ESI response types.
  */
 import "./get_wars_ok.d.ts";
 import "./get_status_ok.d.ts";

package/v2.d.mts

@@ -13,7 +13,6 @@ export declare const getRequestPending: () => number;
 /**
  * fire ESI request ESIRequestOptions
  *
- * @type {TESIRequestFunctionSignature2<ESIRequestOptions>}
  * @throws {ESIRequestError}
  * @async
  */

package/v2.mjs

@@ -35,7 +35,7 @@ let LOG = isDebug();
  * Get the number of currently executing ESI requests
  */
 let ax = 0;
-/** @type {(m?: Truthy) => number} */
+/** @type {function(Truthy=): number} */
 const incrementAx = (minus) => minus ? ax-- : ax++;
 /**
  * @returns Get The Current ESI request pending count.
@@ -47,11 +47,10 @@ export const getRequestPending = () => ax;
 /**
  * fire ESI request ESIRequestOptions
  *
- * @type {TESIRequestFunctionSignature2<ESIRequestOptions>}
  * @throws {ESIRequestError}
  * @async
  */
-export const fire = async (mthd, endp, opt) => {
+export const fire = /** @type {TESIRequestFunctionSignature2<ESIRequestOptions>} */ (async (mthd, endp, opt) => {
     /** @type {number[]=} */
     let pathParams;
     if (opt && typeof opt.pathParams !== "undefined") {
@@ -81,7 +80,7 @@ export const fire = async (mthd, endp, opt) => {
     catch (e) {
         throw e;
     }
-};
+});
 // It should complete correctly.
 /**
  * @param {TESIRequestFunctionSignature2<ESIRequestOptions>} fn