eve-esi-types 2.1.2 → 2.2.0

package/v2/post_characters_affiliation_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/affiliation/
+ * ESI endpoint: post:/characters/affiliation/
  */
 /**
  * 200 ok array

package/v2/post_characters_character_id_assets_locations_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/assets/locations/
+ * ESI endpoint: post:/characters/{character_id}/assets/locations/
  */
 /**
  * 200 ok array

package/v2/post_characters_character_id_assets_names_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/assets/names/
+ * ESI endpoint: post:/characters/{character_id}/assets/names/
  */
 /**
  * 200 ok array

package/v2/post_characters_character_id_contacts_created.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/contacts/
+ * ESI endpoint: post:/characters/{character_id}/contacts/
  */
 /**
  * 201 created array

package/v2/post_characters_character_id_cspa_created.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/cspa/
+ * ESI endpoint: post:/characters/{character_id}/cspa/
  */
 /**
  * 201 created number

package/v2/post_characters_character_id_fittings_created.d.ts

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

package/v2/post_characters_character_id_mail_created.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/mail/
+ * ESI endpoint: post:/characters/{character_id}/mail/
  */
 /**
  * Mail ID

package/v2/post_characters_character_id_mail_labels_created.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /characters/{character_id}/mail/labels/
+ * ESI endpoint: post:/characters/{character_id}/mail/labels/
  */
 /**
  * Label ID

package/v2/post_corporations_corporation_id_assets_locations_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /corporations/{corporation_id}/assets/locations/
+ * ESI endpoint: post:/corporations/{corporation_id}/assets/locations/
  */
 /**
  * 200 ok array

package/v2/post_corporations_corporation_id_assets_names_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /corporations/{corporation_id}/assets/names/
+ * ESI endpoint: post:/corporations/{corporation_id}/assets/names/
  */
 /**
  * 200 ok array

package/v2/post_fleets_fleet_id_wings_created.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /fleets/{fleet_id}/wings/
+ * ESI endpoint: post:/fleets/{fleet_id}/wings/
  */
 
 /**

package/v2/post_fleets_fleet_id_wings_wing_id_squads_created.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /fleets/{fleet_id}/wings/{wing_id}/squads/
+ * ESI endpoint: post:/fleets/{fleet_id}/wings/{wing_id}/squads/
  */
 
 /**

package/v2/post_universe_ids_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /universe/ids/
+ * ESI endpoint: post:/universe/ids/
  */
 
 /**

package/v2/post_universe_names_ok.d.ts

@@ -1,5 +1,5 @@
 /*!
- * ESI endpoint: /universe/names/
+ * ESI endpoint: post:/universe/names/
  */
 /**
  * category string

package/v2.d.mts

@@ -6,33 +6,7 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 import type { TESIResponseOKMap } from "./v2";
-/**
- * __{Header}.{Payload}.{Signature}__
- */
-type TAcccessToken = `${string}.${string}.${string}`;
-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;
-    auth?: true;
-};
+import { type ESIRequestOptions } from "./rq-util.mjs";
 /**
  * fire ESI request
  * @template {TESIEntryMethod} M

package/v2.mjs

@@ -1,4 +1,5 @@
 // import type { TESIResponseOKMap } from "eve-esi-types";
+import { curl, replaceCbt, fetchP, ESIRequesError, ESIErrorLimitReachedError } from "./rq-util.mjs";
 // - - - - - - - - - - - - - - - - - - - -
 //           constants, types
 // - - - - - - - - - - - - - - - - - - - -
@@ -9,10 +10,6 @@ const isArray = Array.isArray;
  * enable/disable console.log
  */
 let LOG = false;
-/**
- * this always `https://esi.evetech.net`
- */
-const BASE = "https://esi.evetech.net";
 /**
  * @typedef {import("./v2").TESIResponseOKMap} TESIResponseOKMap
  */
@@ -22,7 +19,7 @@ const BASE = "https://esi.evetech.net";
  * @prop {Record<string, any>} [query] query params for ESI request.
  * @prop {any} [body] will need it for `POST` request etc.
  * @prop {true=} [auth] Can be an empty object if no authentication is required.description
- * @prop {string} [token] Can be an empty object if no authentication is required.description
+ * @prop {TAcccessToken} [token] Can be an empty object if no authentication is required.description
  * @prop {boolean} [ignoreError]  if want response data with ignore error then can be set to `true`.
  * @prop {AbortController} [cancelable] cancel request immediately
  */
@@ -33,88 +30,7 @@ const BASE = "https://esi.evetech.net";
  * Get the number of currently executing ESI requests
  */
 let ax = 0;
-/**
- * simple named error class.
- */
-class ESIRequesError extends Error {
-}
-/**
- * throws when x-esi-error-limit-remain header value is "0". (http status: 420)
- */
-class ESIErrorLimitReachedError extends Error {
-    constructor() {
-        super("Cannot continue ESI request because 'x-esi-error-limit-remain' is zero!");
-    }
-    valueOf() {
-        return 420;
-    }
-}
-/**
- * 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
- */
-const fetchP = async (endpointUrl, rqopt, qs, pc) => {
-    const rqs = [];
-    const rqp = new URLSearchParams(qs);
-    for (let i = 2; i <= pc;) {
-        rqp.set("page", (i++) + "");
-        ax++;
-        rqs.push(fetch(`${endpointUrl}?${rqp + ""}`, rqopt).then(res => res.json()).catch(reason => {
-            console.warn(reason);
-            return [];
-        }).finally(() => {
-            ax--;
-        }));
-    }
-    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.
- */
-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>`
- */
-const curl = (endp) => {
-    endp = endp.replace(/^\/+|\/+$/g, "");
-    return `${BASE}/latest/${endp}/`;
-};
+const incrementAx = (minus) => minus ? ax-- : ax++;
 // - - - - - - - - - - - - - - - - - - - -
 //            main functions
 // - - - - - - - - - - - - - - - - - - - -
@@ -250,7 +166,7 @@ export async function fire(mthd, endp, pathParams, opt) {
             // has remaining pages? NaN > 1 === false !isNaN(pageCount)
             if (pc > 1) {
                 LOG && log('found "x-pages" header, pages: %d', pc);
-                const remData = await fetchP(endpointUrl, rqopt, qss, pc);
+                const remData = await fetchP(endpointUrl, rqopt, qss, pc, incrementAx);
                 // finally, decide product data.
                 if (isArray(data) && isArray(remData)) {
                     // DEVNOTE: 2019/7/23 15:01:48 - types

package/v2/post_fleets_fleet_id_members_invitation.d.ts

@@ -1,27 +0,0 @@
-/*!
- * ESI endpoint: /fleets/{fleet_id}/members/
- */
-/**
- * If a character is invited with the `fleet_commander` role, neither `wing_id` or `squad_id` should be specified. If a character is invited with the `wing_commander` role, only `wing_id` should be specified. If a character is invited with the `squad_commander` role, both `wing_id` and `squad_id` should be specified. If a character is invited with the `squad_member` role, `wing_id` and `squad_id` should either both be specified or not specified at all. If they aren’t specified, the invited character will join any squad with available positions.
- */
-type PostFleetsFleetIdMembersRole = "fleet_commander" | "wing_commander" | "squad_commander" | "squad_member";
-
-/**
- * invitation object
- */
-interface PostFleetsFleetIdMembersInvitation {
-  /**
-   * The character you want to invite
-   */
-  character_id: number;
-  role: PostFleetsFleetIdMembersRole;
-  /**
-   * squad_id integer
-   */
-  squad_id?: number;
-  /**
-   * wing_id integer
-   */
-  wing_id?: number;
-  [k: string]: unknown | undefined;
-}

package/v2/post_ui_openwindow_newmail_new_mail.d.ts

@@ -1,40 +0,0 @@
-/*!
- * ESI endpoint: /ui/openwindow/newmail/
- */
-/**
- * recipients array
- *
- * @minItems 1
- * @maxItems 50
- */
-type PostUiOpenwindowNewmailRecipients = [
-  /**
-   * recipient integer
-   */
-  number,
-  ...number[]
-];
-
-/**
- * new_mail object
- */
-interface PostUiOpenwindowNewmailNewMail {
-  /**
-   * body string
-   */
-  body: string;
-  recipients: PostUiOpenwindowNewmailRecipients;
-  /**
-   * subject string
-   */
-  subject: string;
-  /**
-   * to_corp_or_alliance_id integer
-   */
-  to_corp_or_alliance_id?: number;
-  /**
-   * Corporations, alliances and mailing lists are all types of mailing groups. You may only send to one mailing group, at a time, so you may fill out either this field or the to_corp_or_alliance_ids field
-   */
-  to_mailing_list_id?: number;
-  [k: string]: unknown | undefined;
-}

package/v2/put_characters_character_id_calendar_event_id_response.d.ts

@@ -1,15 +0,0 @@
-/*!
- * ESI endpoint: /characters/{character_id}/calendar/{event_id}/
- */
-/**
- * response string
- */
-type PutCharactersCharacterIdCalendarEventIdResponseResponse = "accepted" | "declined" | "tentative";
-
-/**
- * response object
- */
-interface PutCharactersCharacterIdCalendarEventIdResponse {
-  response: PutCharactersCharacterIdCalendarEventIdResponseResponse;
-  [k: string]: unknown | undefined;
-}

package/v2/put_characters_character_id_contacts_contact_ids.d.ts

@@ -1,16 +0,0 @@
-/*!
- * ESI endpoint: /characters/{character_id}/contacts/
- */
-/**
- * contact_ids array
- *
- * @minItems 1
- * @maxItems 100
- */
-type PutCharactersCharacterIdContactsContactIds = [
-  /**
-   * ID of the contact to edit
-   */
-  number,
-  ...number[]
-];

package/v2/put_characters_character_id_mail_mail_id_contents.d.ts

@@ -1,20 +0,0 @@
-/*!
- * ESI endpoint: /characters/{character_id}/mail/{mail_id}/
- */
-
-/**
- * contents object
- */
-interface PutCharactersCharacterIdMailMailIdContents {
-  /**
-   * Labels to assign to the mail. Pre-existing labels are unassigned.
-   *
-   * @maxItems 25
-   */
-  labels?: number[];
-  /**
-   * Whether the mail is flagged as read
-   */
-  read?: boolean;
-  [k: string]: unknown | undefined;
-}

package/v2/put_fleets_fleet_id_members_member_id_movement.d.ts

@@ -1,27 +0,0 @@
-/*!
- * ESI endpoint: /fleets/{fleet_id}/members/{member_id}/
- */
-/**
- * If a character is moved to the `fleet_commander` role, neither `wing_id` or `squad_id` should be specified. If a character is moved to the `wing_commander` role, only `wing_id` should be specified. If a character is moved to the `squad_commander` role, both `wing_id` and `squad_id` should be specified. If a character is moved to the `squad_member` role, both `wing_id` and `squad_id` should be specified.
- */
-type PutFleetsFleetIdMembersMemberIdRole =
-  | "fleet_commander"
-  | "wing_commander"
-  | "squad_commander"
-  | "squad_member";
-
-/**
- * movement object
- */
-interface PutFleetsFleetIdMembersMemberIdMovement {
-  role: PutFleetsFleetIdMembersMemberIdRole;
-  /**
-   * squad_id integer
-   */
-  squad_id?: number;
-  /**
-   * wing_id integer
-   */
-  wing_id?: number;
-  [k: string]: unknown | undefined;
-}

package/v2/put_fleets_fleet_id_new_settings.d.ts

@@ -1,18 +0,0 @@
-/*!
- * ESI endpoint: /fleets/{fleet_id}/
- */
-
-/**
- * new_settings object
- */
-interface PutFleetsFleetIdNewSettings {
-  /**
-   * Should free-move be enabled in the fleet
-   */
-  is_free_move?: boolean;
-  /**
-   * New fleet MOTD in CCP flavoured HTML
-   */
-  motd?: string;
-  [k: string]: unknown | undefined;
-}

package/v2/put_fleets_fleet_id_squads_squad_id_naming.d.ts

@@ -1,14 +0,0 @@
-/*!
- * ESI endpoint: /fleets/{fleet_id}/squads/{squad_id}/
- */
-
-/**
- * naming object
- */
-interface PutFleetsFleetIdSquadsSquadIdNaming {
-  /**
-   * name string
-   */
-  name: string;
-  [k: string]: unknown | undefined;
-}

package/v2/put_fleets_fleet_id_wings_wing_id_naming.d.ts

@@ -1,14 +0,0 @@
-/*!
- * ESI endpoint: /fleets/{fleet_id}/wings/{wing_id}/
- */
-
-/**
- * naming object
- */
-interface PutFleetsFleetIdWingsWingIdNaming {
-  /**
-   * name string
-   */
-  name: string;
-  [k: string]: unknown | undefined;
-}