eve-esi-types 2.1.2 → 2.2.1

package/README.md

@@ -6,7 +6,7 @@ Extracted the main type of ESI. Used for ESI request response types.
 > This package is configured to use version 2 only.
 
   + If you need to use version 1, please refer to the following link:  
-    [eve-esi-types v1](https://github.com/jeffy-g/eve-esi-types/tree/v1.1.0)
+    [eve-esi-types v1](https://github.com/jeffy-g/eve-esi-types/tree/version-1.x)
 
 
 > Sample code is provided -> [`v2.mjs`](./v2.mjs)

package/minimal-rq.d.mts

@@ -0,0 +1,26 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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";
+/**
+ * @typedef {import("./v2").TESIResponseOKMap} TESIResponseOKMap
+ * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
+ */
+/** #### 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>}
+ * @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: TESIRequestFunctionSignature<util.ESIRequestOptions>;

package/minimal-rq.mjs

@@ -0,0 +1,78 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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").TESIResponseOKMap} TESIResponseOKMap
+ * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
+ */
+// - - - - - - - - - - - - - - - - - - - -
+//            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>}
+ * @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 const request = (method, endpoint, pathParams, opt) => {
+    if (typeof pathParams === "number") {
+        // @ts-ignore 
+        pathParams = [pathParams];
+    }
+    if (Array.isArray(pathParams)) {
+        // @ts-ignore actualy endp is string
+        endpoint = util.replaceCbt(endpoint, pathParams);
+    }
+    // When only options are provided
+    // @ts-ignore
+    const actualOpt = /** @type {ESIRequestOptions} */ (opt || pathParams || {});
+    const { rqopt, qss } = util.initOptions(method, actualOpt);
+    // @ts-ignore actualy endp is string
+    const endpointUrl = util.curl(endpoint);
+    const url = `${endpointUrl}?${new URLSearchParams(qss) + ""}`;
+    DEBUG && log(url);
+    return fetch(url, rqopt).then(res => res.json()).catch(reason => {
+        throw new util.ESIRequesError(reason.message ? reason.message : reason);
+    });
+};
+// It should complete correctly.
+/**
+ * @param {TESIRequestFunctionSignature<ESIRequestOptions>} fn
+ */
+async function getEVEStatus(fn) {
+    const sdeVersion = await util.getSDEVersion();
+    log(`sdeVersion: ${sdeVersion}`.blue);
+    await util.fireRequestsDoesNotRequireAuth(fn);
+    return fn("get", "/status/");
+}
+// type following and run
+// node minimal-rq.mjs
+getEVEStatus(request).then(eveStatus => log(eveStatus));
+// {
+//     "players": 16503,
+//     "server_version": "2794925",
+//     "start_time": "2025-01-21T11:02:34Z"
+// }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-esi-types",
-  "version": "2.1.2",
+  "version": "2.2.1",
   "description": "Extracted the main type of ESI. use for ESI request response types (version 2 only)",
   "main": "v2/index.d.ts",
   "scripts": {
@@ -12,8 +12,10 @@
   },
   "files": [
     "v2",
+    "*.d.mts",
     "v2.mjs",
-    "v2.d.mts",
+    "rq-util.mjs",
+    "minimal-rq.mjs",
     "LICENSE",
     "*.md",
     "package.json",
@@ -33,5 +35,8 @@
   "bugs": {
     "url": "https://github.com/jeffy-g/eve-esi-types/issues"
   },
-  "homepage": "https://github.com/jeffy-g/eve-esi-types#readme"
+  "homepage": "https://github.com/jeffy-g/eve-esi-types#readme",
+  "devDependencies": {
+    "colors": "^1.4.0"
+  }
 }

package/rq-util.d.mts

@@ -0,0 +1,114 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+import "colors";
+/**
+ * this always `https://esi.evetech.net`
+ */
+export declare const BASE = "https://esi.evetech.net";
+export type Truthy = string | number | boolean;
+/**
+ * __{Header}.{Payload}.{Signature}__
+ */
+export type TAcccessToken = `${string}.${string}.${string}`;
+export type ESIRequestOptions = {
+    /**
+     * query params for ESI request.
+     */
+    query?: Record<string, any>;
+    /**
+     * will need it for `POST` request etc.
+     */
+    body?: any;
+    /**
+     * if want response data with ignore error then can be set to `true`.
+     */
+    ignoreError?: boolean;
+    /**
+     * cancel request immediately
+     */
+    cancelable?: AbortController;
+    /**
+     * Can be an empty object if no authentication is required.description
+     */
+    token?: TAcccessToken;
+    /**
+     * whether an authorization header is required
+     *
+     *   + When using the `Web Fetch API`, avoid extra `OPTIONS` requests and reduce extra http requests
+     *
+     * @date 2020/1/23
+     */
+    auth?: true;
+};
+/**
+ * simple named error class.
+ */
+export declare class ESIRequesError extends Error {
+}
+/**
+ * throws when x-esi-error-limit-remain header value is "0". (http status: 420)
+ */
+export declare class ESIErrorLimitReachedError extends ESIRequesError {
+    constructor();
+    valueOf(): number;
+}
+/**
+ * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
+ */
+export declare const isDebug: () => boolean;
+/**
+ * @param method
+ * @param opt
+ * @returns
+ */
+export declare const initOptions: (method: string, opt: ESIRequestOptions) => {
+    rqopt: RequestInit;
+    qss: Record<string, string>;
+};
+/**
+ * fetch the extra pages
+ *
+ *   + if the `x-pages` header property ware more than 1
+ *
+ * @param {string} endpointUrl
+ * @param {RequestInit} rqopt request options
+ * @param {Record<string, any>} qs 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>;
+/** ### replace (C)urly (B)races (T)oken
+ *
+ * @example
+ * "/characters/{character_id}/skills"
+ * // ->
+ * "/characters/<char.character_id>/skills"
+ *
+ * @param {string} endpoint e.g - "/characters/{character_id}/"
+ * @param {number[]} ids
+ * @returns fragment of qualified endpoint uri or null.
+ */
+export declare const replaceCbt: (endpoint: string, ids: number[]) => string;
+/**
+ *
+ * @param {string} endp this means endpoint url fragment like `/characters/{character_id}/` or `/characters/{character_id}/agents_research/`
+ *   + The version parameter can be omitted by using `<version>/<endpoint>`
+ */
+export declare const curl: (endp: string) => string;
+/**
+ * @date 2020/03/31
+ * @version 2.0 fix version date string problem (v1.0
+ * @type {() => Promise<string>}
+ */
+export declare function getSDEVersion(): Promise<string>;
+/**
+ * #### Fire a request that does not require authentication.
+ *
+ * @param {TESIRequestFunctionSignature<ESIRequestOptions>} fn
+ */
+export declare function fireRequestsDoesNotRequireAuth(fn: TESIRequestFunctionSignature<ESIRequestOptions>): Promise<void>;

package/rq-util.mjs

@@ -0,0 +1,262 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+// - - - - - - - - - - - - - - - - - - - -
+//               imports
+// - - - - - - - - - - - - - - - - - - - -
+import "colors";
+// - - - - - - - - - - - - - - - - - - - -
+//           constants, types
+// - - - - - - - - - - - - - - - - - - - -
+// shorthands
+const log = console.log;
+const isArray = Array.isArray;
+/**
+ * enable/disable console.log
+ */
+let LOG = false;
+/**
+ * this always `https://esi.evetech.net`
+ */
+export const BASE = "https://esi.evetech.net";
+/**
+ * simple named error class.
+ */
+export class ESIRequesError extends Error {
+}
+/**
+ * throws when x-esi-error-limit-remain header value is "0". (http status: 420)
+ */
+export class ESIErrorLimitReachedError extends ESIRequesError {
+    constructor() {
+        super("Cannot continue ESI request because 'x-esi-error-limit-remain' is zero!");
+    }
+    valueOf() {
+        return 420;
+    }
+}
+/**
+ * @typedef {import("./rq-util.mjs").ESIRequestOptions} ESIRequestOptions
+ */
+// - - - - - - - - - - - - - - - - - - - -
+//            utility functions
+// - - - - - - - - - - - - - - - - - - - -
+export const isDebug = () => {
+    return process.argv.includes("-debug");
+};
+/**
+ * @param method
+ * @param opt
+ * @returns
+ */
+export const initOptions = (method, opt) => {
+    /** @type {RequestInit} */
+    const rqopt = {
+        method,
+        mode: "cors",
+        cache: "no-cache",
+        // @ts-ignore 
+        signal: opt.cancelable?.signal,
+        headers: {}
+    };
+    const qss = {
+        language: "en",
+    };
+    if (opt.query) {
+        // Object.assign(query, options.query); Object.assign is too slow
+        const oqs = opt.query;
+        Object.keys(oqs).forEach(k => qss[k] = oqs[k]);
+    }
+    if (opt.auth) {
+        // @ts-ignore The header is indeed an object
+        rqopt.headers.authorization = `Bearer ${opt.token}`;
+    }
+    if (opt.body) { // means "POST" method etc
+        // @ts-ignore The header is indeed an object
+        rqopt.headers["content-type"] = "application/json";
+        rqopt.body = JSON.stringify(opt.body);
+    }
+    return { rqopt, qss };
+};
+/**
+ * fetch the extra pages
+ *
+ *   + if the `x-pages` header property ware more than 1
+ *
+ * @param {string} endpointUrl
+ * @param {RequestInit} rqopt request options
+ * @param {Record<string, any>} qs queries
+ * @param {number} pc pageCount
+ * @param {(minus?: number) => void=} increment
+ */
+export const fetchP = async (endpointUrl, rqopt, qs, pc, increment = () => { }) => {
+    const rqs = [];
+    const rqp = new URLSearchParams(qs);
+    for (let i = 2; i <= pc;) {
+        rqp.set("page", (i++) + "");
+        increment();
+        rqs.push(fetch(`${endpointUrl}?${rqp + ""}`, rqopt).then(res => res.json()).catch(reason => {
+            console.warn(reason);
+            return [];
+        }).finally(() => {
+            increment(1);
+        }));
+    }
+    return Promise.all(rqs).then(jsons => {
+        // DEVNOTE: let check the page 2, type is array?
+        if (isArray(jsons[0])) {
+            let combined = [];
+            for (let i = 0, end = jsons.length; i < end;) {
+                combined = combined.concat(jsons[i++]);
+            }
+            return combined;
+        }
+        LOG && log("> > > pages result are object < < < --", jsons);
+        return null;
+    });
+};
+/** ### replace (C)urly (B)races (T)oken
+ *
+ * @example
+ * "/characters/{character_id}/skills"
+ * // ->
+ * "/characters/<char.character_id>/skills"
+ *
+ * @param {string} endpoint e.g - "/characters/{character_id}/"
+ * @param {number[]} ids
+ * @returns fragment of qualified endpoint uri or null.
+ */
+export const replaceCbt = (endpoint, ids) => {
+    const re = /{([\w]+)}/g;
+    /** @type {RegExpExecArray?} */
+    let m;
+    let idx = 0;
+    while (m = re.exec(endpoint)) {
+        endpoint = endpoint.replace(m[0], ids[idx++] + "");
+    }
+    return endpoint;
+};
+/**
+ *
+ * @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>`
+ */
+export const curl = (endp) => {
+    endp = endp.replace(/^\/+|\/+$/g, "");
+    return `${BASE}/latest/${endp}/`;
+};
+/**
+ * @date 2020/03/31
+ * @version 2.0 fix version date string problem (v1.0
+ * @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`;
+    }
+    else {
+        return "sde-202Xxxxx-TRANQUILITY";
+    }
+}
+// It should complete correctly.
+/**
+ * #### Fire a request that does not require authentication.
+ *
+ * @param {TESIRequestFunctionSignature<ESIRequestOptions>} 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);
+    try {
+        // - - - - - - - - - - - -
+        //       Character
+        // - - - - - - - - - - - -
+        // Here, I borrow data from "CCP Zoetrope".
+        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);
+        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, 5));
+        rlog("get:/universe/structures/?filter=market".green);
+        // query patameter `filter` is optional
+        const structures = await fn("get", "/universe/structures/", {
+            query: {
+                filter: "market"
+            }
+        });
+        log(`/universe/structures/[0]=${structures[0]}, length=${structures.length}`);
+        // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
+        //  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, {
+            auth: true,
+            ignoreError: true,
+            token: "token.token.token"
+        });
+        // in this case, "categories" and "search" is required
+        await fn("get", "/characters/{character_id}/search/", 994562, {
+            query: {
+                categories: ["agent"],
+                search: "ok"
+            },
+            auth: true
+        });
+        // in this case, "order_type" is required
+        await 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/");
+        log(ok);
+    }
+    catch (e) {
+        console.error("Failed to request -", e);
+    }
+}

package/tsconfig.json

@@ -4,6 +4,7 @@
     "skipDefaultLibCheck": true,
     "skipLibCheck": true,
     "declaration": true,
+    // "declarationDir": "./dts",
     "outDir": ".", 
     "target": "esnext",
     "module": "esnext",
@@ -13,11 +14,11 @@
     "strict": true,
     "moduleResolution": "node",
     "rootDirs": [
-      "./"
+      "./scripts"
     ]
   },
   "include": [
-    "./*.mts"
+    "./scripts/*.mts"
   ],
   "exclude": []
 }

package/v2/get_alliances_alliance_id_contacts_labels_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /alliances/{alliance_id}/contacts/labels/
+ * ESI endpoint: get:/alliances/{alliance_id}/contacts/labels/
  */
 /**
  * 200 ok array

package/v2/get_alliances_alliance_id_contacts_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /alliances/{alliance_id}/contacts/
+ * ESI endpoint: get:/alliances/{alliance_id}/contacts/
  */
 /**
  * contact_type string

package/v2/get_alliances_alliance_id_corporations_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /alliances/{alliance_id}/corporations/
+ * ESI endpoint: get:/alliances/{alliance_id}/corporations/
  */
 /**
  * 200 ok array

package/v2/get_alliances_alliance_id_icons_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /alliances/{alliance_id}/icons/
+ * ESI endpoint: get:/alliances/{alliance_id}/icons/
  */
 
 /**

package/v2/get_alliances_alliance_id_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /alliances/{alliance_id}/
+ * ESI endpoint: get:/alliances/{alliance_id}/
  */
 
 /**

package/v2/get_alliances_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /alliances/
+ * ESI endpoint: get:/alliances/
  */
 /**
  * 200 ok array

package/v2/get_characters_character_id_agents_research_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/agents_research/
+ * ESI endpoint: get:/characters/{character_id}/agents_research/
  */
 /**
  * 200 ok array

package/v2/get_characters_character_id_assets_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/assets/
+ * ESI endpoint: get:/characters/{character_id}/assets/
  */
 /**
  * location_flag string

package/v2/get_characters_character_id_attributes_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/attributes/
+ * ESI endpoint: get:/characters/{character_id}/attributes/
  */
 
 /**

package/v2/get_characters_character_id_blueprints_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/blueprints/
+ * ESI endpoint: get:/characters/{character_id}/blueprints/
  */
 /**
  * Type of the location_id

package/v2/get_characters_character_id_bookmarks_folders_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/bookmarks/folders/
+ * ESI endpoint: get:/characters/{character_id}/bookmarks/folders/
  */
 /**
  * 200 ok array

package/v2/get_characters_character_id_bookmarks_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/bookmarks/
+ * ESI endpoint: get:/characters/{character_id}/bookmarks/
  */
 /**
  * 200 ok array

package/v2/get_characters_character_id_calendar_event_id_attendees_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/calendar/{event_id}/attendees/
+ * ESI endpoint: get:/characters/{character_id}/calendar/{event_id}/attendees/
  */
 /**
  * event_response string

package/v2/get_characters_character_id_calendar_event_id_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/calendar/{event_id}/
+ * ESI endpoint: get:/characters/{character_id}/calendar/{event_id}/
  */
 /**
  * owner_type string

package/v2/get_characters_character_id_calendar_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/calendar/
+ * ESI endpoint: get:/characters/{character_id}/calendar/
  */
 /**
  * event_response string

package/v2/get_characters_character_id_clones_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/clones/
+ * ESI endpoint: get:/characters/{character_id}/clones/
  */
 /**
  * location_type string