jeffy-g
eve-esi-types
Extracted main types of ESI (EVE Swagger Interface). This package is designed to handle ESI request and response types effectively.
Table of Contents
Overview
eve-esi-types helps developers interact with the EVE Online ESI API while leveraging strong TypeScript typings.
This package ensures type safety for ESI request parameters, response handling, and authentication requirements.
Installation
npm install eve-esi-typesUsage
This package is configured to use ESI version 2 by default.
If you need to work with version 1, refer to the v1 branch.
Example Usage
A sample script, request-v3.mjs, is provided.
node request-v3.mjsAPI Overview
The core export of this package is the TESIRequestFunctionSignature2 type. It specifies the required endpoint,
HTTP method, query parameters, OAuth requirement, and response type for ESI requests.
Main Function Signature
type TESIRequestFunctionSignature2<ActualOpt extends Record<string, unknown>> = <
Mtd extends TESIEntryMethod,
REP extends ReplacePathParams<ESIEndpointOf<Mtd>> | ESIEndpointOf<Mtd>,
EPO extends ResolvedEndpoint<Mtd, REP>,
Params extends ResolveEndpointParameters<Mtd, REP, EPO, ActualOpt>,
Opt extends Params["finalOptions"]
>(
method: Mtd,
endpoint: REP,
...options: Params["optionIsRequire"] extends 1 ? [Opt] : [Opt?]
) => Promise<Params["result"]>;Authentication via Environment Variable (v3.2.7+)
You can enable authenticated requests by setting the environment variable OAUTH_TOKEN (for testing):
export OAUTH_TOKEN=<Your Access Token>Version Highlights
v3.2.7
- Added support for specifying the
OAUTH_TOKENenvironment variable. - Allows authenticated tests to run successfully by providing an OAuth access token.
v3.0.0
- Renamed
TESIRequestFunctionSignaturetoTESIRequestFunctionSignature2. - Improved endpoint inference (
RealEPandEP) for better TypeScript type safety.
New API Example
Reusable, narrowing-focused API request using decoreateESIRequestBody:
import * as taggedApi from "eve-esi-types/lib/tagged-request-api.mjs";
const esiRequest = taggedApi.decoreateESIRequestBody(...);
const response = await esiRequest.universe.get("/universe/structures/", { query: { filter: "market" } });Other Renamed Signatures
IESIRequestFunction -> IESIRequestFunction2TESIRequestFunctionMethods -> TESIRequestFunctionMethods2
v2.3.0
- Introduced intuitive ESI request handling via ESI Tagged Types.
- Deprecated
injectESIRequestBodyin favor ofdecoreateESIRequestBodyin later versions.
Minimal default implementation:
import { esi } from "eve-esi-types/lib/tagged-request-api.mjs";
const response = await esi.universe.get("/universe/structures/", { query: { filter: "market" } });References
Have questions or issues? Feel free to explore the GitHub repository or open an issue!