eve-esi-types 2.2.1 → 2.2.4

package/esi-types-util.md

@@ -8,19 +8,34 @@
 
 ## ESI Types Utility Definitions
 
-### IsParameterizedPath
+### TESIRequestFunctionSignature
 
-`IsParameterizedPath<EP, A, B>` is a type to determine if a path is parameterized. If it is, it returns `A`, otherwise it returns `B`.
+`TESIRequestFunctionSignature<ActualOpt>` is a type that defines the signature of an ESI request function,  
+which sends a request to a specified endpoint and returns a response.
 
-```typescript
-type IsParameterizedPath<EP, A, B> = EP extends `${string}/{${string}}/${string | ""}` ? A : B;
+```ts
+type TESIRequestFunctionSignature<ActualOpt> = <
+  M extends TESIEntryMethod,
+  EP extends keyof TESIResponseOKMap[M],
+  P2 extends IfParameterizedPath<EP, Opt>,
+  Opt extends IdentifyParameters<TESIResponseOKMap[M][EP], ActualOpt>,
+  R extends InferESIResponseResult<M, EP>
+>(method: M, endpoint: EP, pathParams?: P2, options?: Opt) => Promise<R>;
+```
+
+### IfParameterizedPath
+
+`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;
 ```
 
 ### IdentifyParameters
 
 `IdentifyParameters<Entry, Opt>` is a type to identify the required parameters for a given entry type.
 
-```typescript
+```ts
 type IdentifyParameters<Entry, Opt> = Opt & Pick<Entry, Exclude<keyof Entry, "result">>;
 ```
 
@@ -28,7 +43,7 @@ type IdentifyParameters<Entry, Opt> = Opt & Pick<Entry, Exclude<keyof Entry, "re
 
 `InferESIResponseResult<M extends TESIEntryMethod, EP extends keyof TESIResponseOKMap[M]>` is a type to infer the result type of an ESI response based on the method and endpoint.
 
-```typescript
+```ts
 type InferESIResponseResult<
   M extends TESIEntryMethod,
   EP extends keyof TESIResponseOKMap[M]
@@ -39,7 +54,7 @@ type InferESIResponseResult<
 
 `TESIEntryMethod` represents the HTTP methods supported by ESI.
 
-```typescript
+```ts
 type TESIEntryMethod = keyof TESIResponseOKMap;
 ```
 
@@ -47,7 +62,7 @@ type TESIEntryMethod = keyof TESIResponseOKMap;
 
 `TEndPointGet` represents the endpoints for the "get" method.
 
-```typescript
+```ts
 type TEndPointGet = keyof TESIResponseOKMap["get"];
 ```
 
@@ -55,7 +70,7 @@ type TEndPointGet = keyof TESIResponseOKMap["get"];
 
 `TEndPointPost` represents the endpoints for the "post" method.
 
-```typescript
+```ts
 type TEndPointPost = keyof TESIResponseOKMap["post"];
 ```
 
@@ -63,7 +78,7 @@ type TEndPointPost = keyof TESIResponseOKMap["post"];
 
 `TEndPointPut` represents the endpoints for the "put" method.
 
-```typescript
+```ts
 type TEndPointPut = keyof TESIResponseOKMap["put"];
 ```
 
@@ -71,7 +86,7 @@ type TEndPointPut = keyof TESIResponseOKMap["put"];
 
 `TEndPointDelete` represents the endpoints for the "delete" method.
 
-```typescript
+```ts
 type TEndPointDelete = keyof TESIResponseOKMap["delete"];
 ```
 
@@ -79,7 +94,7 @@ type TEndPointDelete = keyof TESIResponseOKMap["delete"];
 
 `TESIResponseGetEntry<K extends TEndPointGet>` represents the entry details for the "get" method.
 
-```typescript
+```ts
 type TESIResponseGetEntry<K extends TEndPointGet> = TESIResponseOKMap["get"][K];
 ```
 
@@ -87,7 +102,7 @@ type TESIResponseGetEntry<K extends TEndPointGet> = TESIResponseOKMap["get"][K];
 
 `TESIResponsePutEntry<K extends TEndPointPut>` represents the entry details for the "put" method.
 
-```typescript
+```ts
 type TESIResponsePutEntry<K extends TEndPointPut> = TESIResponseOKMap["put"][K];
 ```
 
@@ -95,7 +110,7 @@ type TESIResponsePutEntry<K extends TEndPointPut> = TESIResponseOKMap["put"][K];
 
 `TESIResponsePostEntry<K extends TEndPointPost>` represents the entry details for the "post" method.
 
-```typescript
+```ts
 type TESIResponsePostEntry<K extends TEndPointPost> = TESIResponseOKMap["post"][K];
 ```
 
@@ -103,6 +118,6 @@ type TESIResponsePostEntry<K extends TEndPointPost> = TESIResponseOKMap["post"][
 
 `TESIResponseDeleteEntry<K extends TEndPointDelete>` represents the entry details for the "delete" method.
 
-```typescript
+```ts
 type TESIResponseDeleteEntry<K extends TEndPointDelete> = TESIResponseOKMap["delete"][K];
 ```

package/minimal-rq.d.mts

@@ -6,16 +6,19 @@
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 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 {TESIRequestFunctionSignature<ESIRequestOptions>}
+ * @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
@@ -23,4 +26,4 @@ import * as util from "./rq-util.mjs";
  * @returns A Promise object containing the response data
  * @throws {ESIRequesError}
  */
-export declare const request: TESIRequestFunctionSignature<util.ESIRequestOptions>;
+export declare const request: IESIRequestFunction<util.ESIRequestOptions>;

package/minimal-rq.mjs

@@ -19,17 +19,18 @@ 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
 // - - - - - - - - - - - - - - - - - - - -
-// node scripts/minimal-rq.mjs
 /** #### Sample of `TESIRequestFunctionSignature`
  *
  * + This is a minimal implementation using `TESIRequestFunctionSignature`.
  *   If the response contains "page", only the first page can be retrieved.
  *
- * @type {TESIRequestFunctionSignature<ESIRequestOptions>}
+ * @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
@@ -37,39 +38,94 @@ const DEBUG = util.isDebug();
  * @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-ignore 
+        // @ts-expect-error
         pathParams = [pathParams];
     }
     if (Array.isArray(pathParams)) {
-        // @ts-ignore actualy endp is string
+        // @ts-expect-error actualy endp is string
         endpoint = util.replaceCbt(endpoint, pathParams);
     }
     // When only options are provided
-    // @ts-ignore
-    const actualOpt = /** @type {ESIRequestOptions} */ (opt || pathParams || {});
+    const actualOpt = /** @type {NonNullable<typeof opt>} */ (opt || pathParams || {});
     const { rqopt, qss } = util.initOptions(method, actualOpt);
-    // @ts-ignore actualy endp is string
+    // @ts-expect-error actualy endp is string
     const endpointUrl = util.curl(endpoint);
-    const url = `${endpointUrl}?${new URLSearchParams(qss) + ""}`;
+    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)
+//
+const esiMethods = /** @type {TESIRequestFunctionMethods} */ ({});
+["get", "post", "put", "delete"].forEach((method) => {
+    esiMethods[method] = function (endpoint, params, opt) {
+        // @ts-ignore
+        return request(method, endpoint, params, opt);
+    };
+});
 // It should complete correctly.
 /**
- * @param {TESIRequestFunctionSignature<ESIRequestOptions>} fn
+ * @param {IESIRequestFunction} fn
  */
 async function getEVEStatus(fn) {
-    const sdeVersion = await util.getSDEVersion();
-    log(`sdeVersion: ${sdeVersion}`.blue);
+    await util.getSDEVersion().then(sdeVersion => log(`sdeVersion: ${sdeVersion}`.blue));
     await util.fireRequestsDoesNotRequireAuth(fn);
-    return fn("get", "/status/");
+    CaseIESIRequestFunctionMethods: {
+        await util.fireRequestsDoesNotRequireAuth(esiMethods);
+    }
+    const { clog, rlog } = util.getLogger();
+    CaseIESIRequestFunction: {
+        // - - - - - - - - - - - -
+        //       Character
+        // - - - - - - - - - - - -
+        // Here, I borrow data from "CCP Zoetrope".
+        rlog("- - - - - - - > run as IESIRequestFunction<ESIRequestOptions>".red);
+        clog();
+        await fn.get("/characters/{character_id}/", 2112625428).then(log);
+        clog('(portrait)');
+        await fn.get("/characters/{character_id}/portrait/", 2112625428).then(log);
+        clog('(affiliation)');
+        const affiliation = await fn.post("/characters/affiliation/", { body: [2112625428] });
+        log(affiliation);
+        clog('(corporation)');
+        await fn.get("/corporations/{corporation_id}/", affiliation[0].corporation_id).then(log);
+        rlog("get:/incursions/".green);
+        await fn.get("/incursions/").then(log);
+        // - - - - - - - - - - - -
+        //     Miscellaneous
+        // - - - - - - - - - - - -
+        rlog("post:/universe/ids/".green);
+        const ids = await fn.post("/universe/ids/", { body: ["the forge", "plex"] });
+        log(ids.inventory_types, ids.regions);
+        rlog(`get:/markets/${ids?.regions?.[0].id}/orders/?type_id=${ids?.inventory_types?.[0].id}, item PLEX`.green);
+        const orders = await fn.get("/markets/{region_id}/orders/", ids?.regions?.[0].id, {
+            query: {
+                // page: 1,
+                order_type: "sell",
+                type_id: ids?.inventory_types?.[0].id
+            }
+        });
+        log(orders.sort((a, b) => a.price - b.price).slice(0, 2));
+    }
+    return fn.get("/status/");
 }
 // type following and run
-// node minimal-rq.mjs
+// node minimal-rq.mjs -debug
 getEVEStatus(request).then(eveStatus => log(eveStatus));
 // {
 //     "players": 16503,

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "eve-esi-types",
-  "version": "2.2.1",
+  "version": "2.2.4",
   "description": "Extracted the main type of ESI. use for ESI request response types (version 2 only)",
   "main": "v2/index.d.ts",
   "scripts": {
-    "test": "node v2.mjs"
+    "test": "node v2.mjs -debug",
+    "test:mini": "node minimal-rq.mjs -debug"
   },
   "repository": {
     "type": "git",
@@ -13,9 +14,7 @@
   "files": [
     "v2",
     "*.d.mts",
-    "v2.mjs",
-    "rq-util.mjs",
-    "minimal-rq.mjs",
+    "*.mjs",
     "LICENSE",
     "*.md",
     "package.json",
@@ -37,6 +36,6 @@
   },
   "homepage": "https://github.com/jeffy-g/eve-esi-types#readme",
   "devDependencies": {
-    "colors": "^1.4.0"
+    "colors.ts": "^1.0.20"
   }
 }

package/rq-util.d.mts

@@ -5,7 +5,8 @@
 //  https://opensource.org/licenses/mit-license.php
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
-import "colors";
+import "colors.ts";
+import type { TESIRequestFunctionMethods } from "./v2";
 /**
  * this always `https://esi.evetech.net`
  */
@@ -62,8 +63,8 @@ export declare class ESIErrorLimitReachedError extends ESIRequesError {
  */
 export declare const isDebug: () => boolean;
 /**
- * @param method
- * @param opt
+ * @param {string} method
+ * @param {ESIRequestOptions} opt
  * @returns
  */
 export declare const initOptions: (method: string, opt: ESIRequestOptions) => {
@@ -77,11 +78,11 @@ export declare const initOptions: (method: string, opt: ESIRequestOptions) => {
  *
  * @param {string} endpointUrl
  * @param {RequestInit} rqopt request options
- * @param {Record<string, any>} qs queries
+ * @param {URLSearchParams} rqp queries
  * @param {number} pc pageCount
  * @param {(minus?: number) => void=} increment
  */
-export declare const fetchP: <T extends unknown>(endpointUrl: string, rqopt: RequestInit, qs: Record<string, any>, pc: number, increment?: (minus?: Truthy) => void) => 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
  *
  * @example
@@ -97,18 +98,22 @@ 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 can be omitted by using `<version>/<endpoint>`
+ *   + The version parameter is forced to apply `latest`
  */
 export declare const curl: (endp: string) => string;
 /**
  * @date 2020/03/31
- * @version 2.0 fix version date string problem (v1.0
+ * @version 2.1
  * @type {() => Promise<string>}
  */
 export declare function getSDEVersion(): Promise<string>;
+export declare function getLogger(): {
+    clog: (...args: any[]) => void;
+    rlog: (...args: any[]) => void;
+};
 /**
  * #### Fire a request that does not require authentication.
  *
- * @param {TESIRequestFunctionSignature<ESIRequestOptions>} fn
+ * @param {TESIRequestFunctionSignature<ESIRequestOptions> | TESIRequestFunctionMethods} fn
  */
-export declare function fireRequestsDoesNotRequireAuth(fn: TESIRequestFunctionSignature<ESIRequestOptions>): Promise<void>;
+export declare function fireRequestsDoesNotRequireAuth(fn: TESIRequestFunctionSignature<ESIRequestOptions> | TESIRequestFunctionMethods<ESIRequestOptions>): Promise<void>;

package/rq-util.mjs

@@ -5,10 +5,11 @@
 //  https://opensource.org/licenses/mit-license.php
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
+/// <reference types="./v2"/>
 // - - - - - - - - - - - - - - - - - - - -
 //               imports
 // - - - - - - - - - - - - - - - - - - - -
-import "colors";
+import "colors.ts";
 // - - - - - - - - - - - - - - - - - - - -
 //           constants, types
 // - - - - - - - - - - - - - - - - - - - -
@@ -49,8 +50,8 @@ export const isDebug = () => {
     return process.argv.includes("-debug");
 };
 /**
- * @param method
- * @param opt
+ * @param {string} method
+ * @param {ESIRequestOptions} opt
  * @returns
  */
 export const initOptions = (method, opt) => {
@@ -59,12 +60,11 @@ export const initOptions = (method, opt) => {
         method,
         mode: "cors",
         cache: "no-cache",
-        // @ts-ignore 
         signal: opt.cancelable?.signal,
         headers: {}
     };
     const qss = {
-        language: "en",
+    // language: "en",
     };
     if (opt.query) {
         // Object.assign(query, options.query); Object.assign is too slow
@@ -89,13 +89,12 @@ export const initOptions = (method, opt) => {
  *
  * @param {string} endpointUrl
  * @param {RequestInit} rqopt request options
- * @param {Record<string, any>} qs queries
+ * @param {URLSearchParams} rqp queries
  * @param {number} pc pageCount
  * @param {(minus?: number) => void=} increment
  */
-export const fetchP = async (endpointUrl, rqopt, qs, pc, increment = () => { }) => {
+export const fetchP = async (endpointUrl, rqopt, rqp, pc, increment = () => { }) => {
     const rqs = [];
-    const rqp = new URLSearchParams(qs);
     for (let i = 2; i <= pc;) {
         rqp.set("page", (i++) + "");
         increment();
@@ -143,7 +142,7 @@ export const replaceCbt = (endpoint, ids) => {
 /**
  *
  * @param {string} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
- *   + The version parameter can be omitted by using `<version>/<endpoint>`
+ *   + The version parameter is forced to apply `latest`
  */
 export const curl = (endp) => {
     endp = endp.replace(/^\/+|\/+$/g, "");
@@ -151,79 +150,104 @@ export const curl = (endp) => {
 };
 /**
  * @date 2020/03/31
- * @version 2.0 fix version date string problem (v1.0
+ * @version 2.1
  * @type {() => Promise<string>}
  */
 export async function getSDEVersion() {
     const sdeZipUrl = "https://eve-static-data-export.s3-eu-west-1.amazonaws.com/tranquility/sde.zip";
-    const date = await fetch(sdeZipUrl, { method: "head", mode: "cors" }).then((/** @type {Response} */ res) => res.headers.get("last-modified")).catch(reason => {
-        console.log(reason);
-        return new Date();
-    });
-    if (date) {
-        const YMD = new Date(date).toLocaleString(void 0, {
-            year: "numeric",
-            month: "2-digit",
-            day: "2-digit",
-            // DEVNOTE: 191215 - "-" character appeared in node v13.3.0 (maybe
-        }).replace(/(-|\/|:| )/g, (match, $1) => {
-            switch ($1) {
-                case "-":
-                case "/":
-                case ":": return "";
-                case " ": return "@";
-            }
-            return match;
-        });
-        return `sde-${YMD}-TRANQUILITY`;
+    try {
+        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, '');
+            return `sde-${YMD}-TRANQUILITY`;
+        }
+        else {
+            console.error("Failed to retrieve 'last-modified' header.");
+            return "sde-202Xxxxx-TRANQUILITY";
+        }
     }
-    else {
+    catch (e) {
+        console.error("Error fetching SDE version:", e);
         return "sde-202Xxxxx-TRANQUILITY";
     }
 }
+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);
+    return { clog, rlog };
+}
+/**
+ * Need typescript v5.5 later
+ * @import * as ESI from "./v2";
+ * @typedef {ESI.TESIResponseOKMap} TESIResponseOKMap
+ * @typedef {ESI.IESIRequestFunction<ESIRequestOptions>} IESIRequestFunction
+ * @typedef {ESI.TESIRequestFunctionMethods<ESIRequestOptions>} TESIRequestFunctionMethods
+ */
+/**
+ * #### Fire a request that does not require authentication.
+ *
+ * @template {TESIEntryMethod} M
+ * @template {keyof TESIResponseOKMap[M]} EP
+ * @template {IfParameterizedPath<EP, Opt>} P2
+ * @template {IdentifyParameters<TESIResponseOKMap[M][EP], ESIRequestOptions>} Opt
+ * @template {InferESIResponseResult<M, EP>} R
+ *
+ * @param {TESIRequestFunctionSignature<ESIRequestOptions> | TESIRequestFunctionMethods} fn
+ * @param {M} method
+ * @param {EP} endpoint
+ * @param {P2} [pathParams]
+ * @param {Opt} [opt]
+ * @returns {Promise<R>}
+ */
+function fireWithoutAuth(fn, method, endpoint, pathParams, opt) {
+    if (typeof fn === "function") {
+        return fn(method, endpoint, pathParams, opt);
+    }
+    return fn[method](endpoint, pathParams, opt);
+}
 // It should complete correctly.
 /**
  * #### Fire a request that does not require authentication.
  *
- * @param {TESIRequestFunctionSignature<ESIRequestOptions>} fn
+ * @param {TESIRequestFunctionSignature<ESIRequestOptions> | TESIRequestFunctionMethods} fn
  */
 export async function fireRequestsDoesNotRequireAuth(fn) {
-    const clog = console.log.bind(console, '- - -> Get the character data of "CCP Zoetrope"'.magenta);
-    const rlog = console.log.bind(console, '- - -> Run ESI request'.cyan);
+    const { clog, rlog } = getLogger();
     try {
         // - - - - - - - - - - - -
         //       Character
         // - - - - - - - - - - - -
         // Here, I borrow data from "CCP Zoetrope".
         clog();
-        await fn("get", "/characters/{character_id}/", 2112625428).then(log);
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/", 2112625428).then(log);
         clog('(portrait)');
-        await fn("get", "/characters/{character_id}/portrait/", 2112625428).then(log);
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/portrait/", 2112625428).then(log);
         clog('(affiliation)');
-        const affiliation = await fn("post", "/characters/affiliation/", { body: [2112625428] });
+        const affiliation = await fireWithoutAuth(fn, "post", "/characters/affiliation/", { body: [2112625428] });
         log(affiliation);
         clog('(corporation)');
-        await fn("get", "/corporations/{corporation_id}/", affiliation[0].corporation_id).then(log);
+        await fireWithoutAuth(fn, "get", "/corporations/{corporation_id}/", affiliation[0].corporation_id).then(log);
         rlog("get:/incursions/".green);
-        await fn("get", "/incursions/").then(log);
+        await fireWithoutAuth(fn, "get", "/incursions/").then(log);
         // - - - - - - - - - - - -
         //     Miscellaneous
         // - - - - - - - - - - - -
         rlog("post:/universe/ids/".green);
-        const ids = await fn("post", "/universe/ids/", { body: ["the forge", "plex"] });
-        log(ids);
+        const ids = await fireWithoutAuth(fn, "post", "/universe/ids/", { body: ["the forge", "plex"] });
+        log(ids.inventory_types, ids.regions);
         rlog(`get:/markets/${ids?.regions?.[0].id}/orders/?type_id=${ids?.inventory_types?.[0].id}, item PLEX`.green);
-        const orders = await fn("get", "/markets/{region_id}/orders/", ids?.regions?.[0].id, {
+        const orders = await fireWithoutAuth(fn, "get", "/markets/{region_id}/orders/", ids?.regions?.[0].id, {
             query: {
                 // page: 1,
                 order_type: "sell",
                 type_id: ids?.inventory_types?.[0].id
             }
         });
-        log(orders.sort((a, b) => a.price - b.price).slice(0, 5));
+        log(orders.sort((a, b) => a.price - b.price).slice(0, 2));
         rlog("get:/universe/structures/?filter=market".green);
         // query patameter `filter` is optional
-        const structures = await fn("get", "/universe/structures/", {
+        const structures = await fireWithoutAuth(fn, "get", "/universe/structures/", {
             query: {
                 filter: "market"
             }
@@ -233,13 +257,13 @@ export async function fireRequestsDoesNotRequireAuth(fn) {
         //  The following is code to observe the behavior of completion by generics.
         //  Authentication is required, so an error will occur.
         // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
-        let ok = await fn("get", "/characters/{character_id}/ship/", 994562, {
+        let ok = await fireWithoutAuth(fn, "get", "/characters/{character_id}/ship/", 994562, {
             auth: true,
             ignoreError: true,
             token: "token.token.token"
         });
         // in this case, "categories" and "search" is required
-        await fn("get", "/characters/{character_id}/search/", 994562, {
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/search/", 994562, {
             query: {
                 categories: ["agent"],
                 search: "ok"
@@ -247,13 +271,13 @@ export async function fireRequestsDoesNotRequireAuth(fn) {
             auth: true
         });
         // in this case, "order_type" is required
-        await fn("get", "/markets/{region_id}/orders/", 994562, {
+        await fireWithoutAuth(fn, "get", "/markets/{region_id}/orders/", 994562, {
             query: {
                 order_type: "all"
             },
         });
         // TODO: want TypeScript semantics to throw an error because there is a required query parameter, but it's not possible
-        await fn("get", "/characters/{character_id}/search/");
+        await fireWithoutAuth(fn, "get", "/characters/{character_id}/search/");
         log(ok);
     }
     catch (e) {

package/tsconfig.json

@@ -20,5 +20,7 @@
   "include": [
     "./scripts/*.mts"
   ],
-  "exclude": []
+  "exclude": [
+    "./scripts/auth-*"
+  ]
 }