@localisprimary/esi 1.2.0 → 1.3.0

package/README.md

@@ -23,6 +23,17 @@ const alliance = await esi.getAlliance({ alliance_id: 123 })
 console.log(alliance.data)
 ```
 
+## Options
+
+The `EsiClient` constructor accepts an options object with the following properties:
+| Parameter | Description | Type | Default | Required |
+|-----------|-------------|------|---------|----------|
+| `token` | Optional auth token for authenticated requests | `string` | `undefined` | No |
+| `userAgent` | User agent string for requests. Resolves to `"localisprimary/esi <userAgent>"` | `string` | `undefined` | No* |
+| `useRequestHeaders` | When false, fall back to query parameters for user agent and token | `boolean` | `true` | No |
+
+<small>* Will be required in a future version.</small>
+
 ## Methods
 
 This client provides methods for all EVE ESI endpoints. Methods return a `Promise` that resolves to an `EsiResponse<T>` or throws an `EsiError`.

package/dist/client.d.ts

@@ -3,9 +3,11 @@ export declare class EsiClient {
     private readonly baseUrl;
     private readonly userAgent;
     private readonly token?;
+    private readonly useRequestHeaders;
     constructor(options?: {
         token?: string;
         userAgent?: string;
+        useRequestHeaders?: boolean;
     });
     private request;
     /**

package/dist/client.js

@@ -2,8 +2,10 @@ const COMPATIBILITY_DATE = '2025-07-29';
 export class EsiClient {
     constructor(options = {}) {
         this.baseUrl = 'https://esi.evetech.net';
-        this.userAgent = '@localisprimary/esi';
+        this.userAgent = 'localisprimary/esi';
+        this.useRequestHeaders = true;
         this.token = options.token;
+        this.useRequestHeaders = options.useRequestHeaders ?? true;
         if (options.userAgent?.length) {
             this.userAgent += ` ${options.userAgent}`;
         }
@@ -20,6 +22,13 @@ export class EsiClient {
                 }
             });
         }
+        if (!this.useRequestHeaders) {
+            url.searchParams.append('user_agent', this.userAgent);
+            url.searchParams.append('compatibility_date', COMPATIBILITY_DATE);
+            if (this.token) {
+                url.searchParams.append('token', this.token);
+            }
+        }
         const headers = {
             'Content-Type': 'application/json',
             'X-Compatibility-Date': COMPATIBILITY_DATE,
@@ -30,7 +39,7 @@ export class EsiClient {
         }
         const response = await fetch(url.toString(), {
             method,
-            headers,
+            headers: this.useRequestHeaders ? headers : undefined,
             body: body ? JSON.stringify(body) : undefined,
         });
         const data = await response.json();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localisprimary/esi",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "description": "Auto-generated TypeScript client for the EVE Online API",
   "main": "dist/index.js",