@lgriffin/esi.ts 5.1.0 → 6.0.0

package/dist/core/endpoints/walletEndpoints.d.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 export declare const walletEndpoints: {
     readonly getCharacterWallet: {
         readonly path: "characters/{characterId}/wallet";
@@ -10,12 +11,37 @@ export declare const walletEndpoints: {
         readonly method: "GET";
         readonly requiresAuth: true;
         readonly pathParams: readonly ["characterId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            date: z.ZodString;
+            ref_type: z.ZodString;
+            first_party_id: z.ZodOptional<z.ZodNumber>;
+            second_party_id: z.ZodOptional<z.ZodNumber>;
+            amount: z.ZodOptional<z.ZodNumber>;
+            balance: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+            description: z.ZodString;
+            context_id: z.ZodOptional<z.ZodNumber>;
+            context_id_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
     };
     readonly getCharacterWalletTransactions: {
         readonly path: "characters/{characterId}/wallet/transactions";
         readonly method: "GET";
         readonly requiresAuth: true;
         readonly pathParams: readonly ["characterId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            transaction_id: z.ZodNumber;
+            date: z.ZodString;
+            type_id: z.ZodNumber;
+            location_id: z.ZodNumber;
+            unit_price: z.ZodNumber;
+            quantity: z.ZodNumber;
+            client_id: z.ZodNumber;
+            is_buy: z.ZodBoolean;
+            is_personal: z.ZodBoolean;
+            journal_ref_id: z.ZodNumber;
+        }, z.core.$loose>>;
     };
     readonly getCorporationWallets: {
         readonly path: "corporations/{corporationId}/wallets";
@@ -28,12 +54,37 @@ export declare const walletEndpoints: {
         readonly method: "GET";
         readonly requiresAuth: true;
         readonly pathParams: readonly ["corporationId", "division"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            date: z.ZodString;
+            ref_type: z.ZodString;
+            first_party_id: z.ZodOptional<z.ZodNumber>;
+            second_party_id: z.ZodOptional<z.ZodNumber>;
+            amount: z.ZodOptional<z.ZodNumber>;
+            balance: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+            description: z.ZodString;
+            context_id: z.ZodOptional<z.ZodNumber>;
+            context_id_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
     };
     readonly getCorporationWalletTransactions: {
         readonly path: "corporations/{corporationId}/wallets/{division}/transactions";
         readonly method: "GET";
         readonly requiresAuth: true;
         readonly pathParams: readonly ["corporationId", "division"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            transaction_id: z.ZodNumber;
+            date: z.ZodString;
+            type_id: z.ZodNumber;
+            location_id: z.ZodNumber;
+            unit_price: z.ZodNumber;
+            quantity: z.ZodNumber;
+            client_id: z.ZodNumber;
+            is_buy: z.ZodBoolean;
+            is_personal: z.ZodBoolean;
+            journal_ref_id: z.ZodNumber;
+        }, z.core.$loose>>;
     };
 };
 //# sourceMappingURL=walletEndpoints.d.ts.map

package/dist/core/endpoints/walletEndpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walletEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/walletEndpoints.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCI,CAAC"}
+{"version":3,"file":"walletEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/walletEndpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCI,CAAC"}

package/dist/core/endpoints/walletEndpoints.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.walletEndpoints = void 0;
+const zod_1 = require("zod");
+const wallet_1 = require("../../schemas/wallet");
 exports.walletEndpoints = {
     getCharacterWallet: {
         path: 'characters/{characterId}/wallet',
@@ -13,12 +15,14 @@ exports.walletEndpoints = {
         method: 'GET',
         requiresAuth: true,
         pathParams: ['characterId'],
+        responseSchema: zod_1.z.array(wallet_1.WalletJournalSchema),
     },
     getCharacterWalletTransactions: {
         path: 'characters/{characterId}/wallet/transactions',
         method: 'GET',
         requiresAuth: true,
         pathParams: ['characterId'],
+        responseSchema: zod_1.z.array(wallet_1.WalletTransactionSchema),
     },
     getCorporationWallets: {
         path: 'corporations/{corporationId}/wallets',
@@ -31,11 +35,13 @@ exports.walletEndpoints = {
         method: 'GET',
         requiresAuth: true,
         pathParams: ['corporationId', 'division'],
+        responseSchema: zod_1.z.array(wallet_1.WalletJournalSchema),
     },
     getCorporationWalletTransactions: {
         path: 'corporations/{corporationId}/wallets/{division}/transactions',
         method: 'GET',
         requiresAuth: true,
         pathParams: ['corporationId', 'division'],
+        responseSchema: zod_1.z.array(wallet_1.WalletTransactionSchema),
     },
 };

package/dist/core/endpoints/warEndpoints.d.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 export declare const warEndpoints: {
     readonly getWars: {
         readonly path: "wars";
@@ -9,12 +10,41 @@ export declare const warEndpoints: {
         readonly method: "GET";
         readonly requiresAuth: false;
         readonly pathParams: readonly ["warId"];
+        readonly responseSchema: z.ZodObject<{
+            id: z.ZodNumber;
+            declared: z.ZodString;
+            started: z.ZodOptional<z.ZodString>;
+            finished: z.ZodOptional<z.ZodString>;
+            retracted: z.ZodOptional<z.ZodString>;
+            mutual: z.ZodBoolean;
+            open_for_allies: z.ZodBoolean;
+            aggressor: z.ZodObject<{
+                corporation_id: z.ZodOptional<z.ZodNumber>;
+                alliance_id: z.ZodOptional<z.ZodNumber>;
+                isk_destroyed: z.ZodNumber;
+                ships_killed: z.ZodNumber;
+            }, z.core.$loose>;
+            defender: z.ZodObject<{
+                corporation_id: z.ZodOptional<z.ZodNumber>;
+                alliance_id: z.ZodOptional<z.ZodNumber>;
+                isk_destroyed: z.ZodNumber;
+                ships_killed: z.ZodNumber;
+            }, z.core.$loose>;
+            allies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                corporation_id: z.ZodOptional<z.ZodNumber>;
+                alliance_id: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>;
     };
     readonly getWarKillmails: {
         readonly path: "wars/{warId}/killmails";
         readonly method: "GET";
         readonly requiresAuth: false;
         readonly pathParams: readonly ["warId"];
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            killmail_id: z.ZodNumber;
+            killmail_hash: z.ZodString;
+        }, z.core.$loose>>;
     };
 };
 //# sourceMappingURL=warEndpoints.d.ts.map

package/dist/core/endpoints/warEndpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"warEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/warEndpoints.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CAkBO,CAAC"}
+{"version":3,"file":"warEndpoints.d.ts","sourceRoot":"","sources":["../../../src/core/endpoints/warEndpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBO,CAAC"}

package/dist/core/endpoints/warEndpoints.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.warEndpoints = void 0;
+const zod_1 = require("zod");
+const wars_1 = require("../../schemas/wars");
+const killmails_1 = require("../../schemas/killmails");
 exports.warEndpoints = {
     getWars: {
         path: 'wars',
@@ -12,11 +15,13 @@ exports.warEndpoints = {
         method: 'GET',
         requiresAuth: false,
         pathParams: ['warId'],
+        responseSchema: wars_1.WarSchema,
     },
     getWarKillmails: {
         path: 'wars/{warId}/killmails',
         method: 'GET',
         requiresAuth: false,
         pathParams: ['warId'],
+        responseSchema: zod_1.z.array(killmails_1.KillmailSummarySchema),
     },
 };

package/dist/core/pagination/AsyncPaginationIterator.js

@@ -11,14 +11,14 @@ function extractArray(body) {
     return [];
 }
 async function* fetchPages(client, endpoint, method, requiresAuth = false, body) {
-    const firstResponse = await (0, ApiRequestHandler_1.handleRequest)(client, endpoint, method, body, requiresAuth);
+    const firstResponse = await (0, ApiRequestHandler_1.handleSinglePageRequest)(client, endpoint, method, body, requiresAuth);
     const totalPages = parseInt(firstResponse.headers['x-pages'] || '1', 10);
     yield { data: extractArray(firstResponse.body), page: 1, totalPages };
     for (let page = 2; page <= totalPages; page++) {
         const sep = endpoint.includes('?') ? '&' : '?';
         const pagedEndpoint = `${endpoint}${sep}page=${page}`;
         (0, loggerUtil_1.logInfo)(`Fetching page ${page}/${totalPages}: ${pagedEndpoint}`);
-        const response = await (0, ApiRequestHandler_1.handleRequest)(client, pagedEndpoint, method, body, requiresAuth);
+        const response = await (0, ApiRequestHandler_1.handleSinglePageRequest)(client, pagedEndpoint, method, body, requiresAuth);
         const pageData = extractArray(response.body);
         if (pageData.length === 0)
             break;

package/dist/core/pagination/PaginationHandler.d.ts

@@ -16,7 +16,7 @@ export declare class PaginationHandler {
      * Fetch remaining pages (2..totalPages) and combine with first page data.
      * The caller has already fetched page 1 and knows the total page count.
      */
-    static fetchRemainingPages(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], totalPages: number, body?: unknown, options?: PaginationOptions, pageFetch?: PageFetcher): Promise<unknown[]>;
+    static fetchRemainingPages(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], totalPages: number, body?: unknown, options?: PaginationOptions, pageFetch?: PageFetcher, templatePath?: string): Promise<unknown[]>;
     /**
      * Fetch a single page with retry logic
      */

package/dist/core/pagination/PaginationHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/PaginationHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAE5E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKrC;IAEF;;;OAGG;WACU,mBAAmB,CAC9B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,EAC/B,SAAS,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,OAAO,EAAE,CAAC;IA8DrB;;OAEG;mBACkB,kBAAkB;IA2CvC;;;OAGG;mBACkB,eAAe;CAiDrC"}
+{"version":3,"file":"PaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/PaginationHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAE5E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKrC;IAEF;;;OAGG;WACU,mBAAmB,CAC9B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,EAC/B,SAAS,CAAC,EAAE,WAAW,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC;IA8DrB;;OAEG;mBACkB,kBAAkB;IA2CvC;;;OAGG;mBACkB,eAAe;CAiDrC"}

package/dist/core/pagination/PaginationHandler.js

@@ -19,7 +19,7 @@ class PaginationHandler {
      * Fetch remaining pages (2..totalPages) and combine with first page data.
      * The caller has already fetched page 1 and knows the total page count.
      */
-    static async fetchRemainingPages(client, endpoint, method, requiresAuth, firstPageData, totalPages, body, options = {}, pageFetch) {
+    static async fetchRemainingPages(client, endpoint, method, requiresAuth, firstPageData, totalPages, body, options = {}, pageFetch, templatePath) {
         const opts = { ...this.DEFAULT_OPTIONS, ...options };
         const rateLimiter = client.getRateLimiter();
         const allData = [...firstPageData];
@@ -32,7 +32,7 @@ class PaginationHandler {
         for (let page = 2; page <= effectiveMaxPage; page++) {
             try {
                 if (rateLimiter)
-                    await rateLimiter.checkRateLimit();
+                    await rateLimiter.checkRateLimit(templatePath, method);
                 const pageData = await this.fetchPageWithRetry(client, endpoint, method, page, requiresAuth, body, opts, pageFetch);
                 consecutiveFailures = 0;
                 if (opts.stopOnEmptyPage && (!pageData || pageData.length === 0)) {

package/dist/core/rateLimiter/IRateLimiter.d.ts

@@ -1,6 +1,14 @@
+export interface RateLimitGroupStatus {
+    group: string;
+    remaining: number;
+    limit: number;
+    used: number;
+    windowSizeMs: number;
+    blockedUntil: number;
+}
 export interface IRateLimiter {
-    checkRateLimit(): Promise<void>;
-    updateFromResponse(headers: Record<string, string>, statusCode: number): void;
+    checkRateLimit(templatePath?: string, method?: string, requestHeaders?: Record<string, string>): Promise<void>;
+    updateFromResponse(headers: Record<string, string>, statusCode: number, templatePath?: string, method?: string, requestHeaders?: Record<string, string>): void;
     getStatus(): {
         remaining: number;
         limit: number;
@@ -11,7 +19,9 @@ export interface IRateLimiter {
         retryAfter: number | null;
         blockedUntil: number;
     };
-    isBlocked(): boolean;
+    getGroupStatus(group: string): RateLimitGroupStatus | undefined;
+    getAllGroupStatuses(): Map<string, RateLimitGroupStatus>;
+    isBlocked(group?: string): boolean;
     reset(): void;
 }
 //# sourceMappingURL=IRateLimiter.d.ts.map

package/dist/core/rateLimiter/IRateLimiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IRateLimiter.d.ts","sourceRoot":"","sources":["../../../src/core/rateLimiter/IRateLimiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9E,SAAS,IAAI;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,IAAI,OAAO,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"IRateLimiter.d.ts","sourceRoot":"","sources":["../../../src/core/rateLimiter/IRateLimiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,CACZ,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,kBAAkB,CAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,IAAI,CAAC;IACR,SAAS,IAAI;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAAC;IAChE,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACzD,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/core/rateLimiter/RateLimiter.d.ts

@@ -1,77 +1,50 @@
-/**
- * Rate Limiter for ESI API calls
- *
- * Implements both the new floating-window rate limiting system and the legacy
- * error-limit system per the official ESI documentation:
- *
- * New system (X-Ratelimit-* headers):
- *   - Floating window with token bucket per IP+route group
- *   - Token costs: 2xx = 2 tokens, 3xx = 1 token, 4xx = 5 tokens, 5xx = 0 tokens
- *   - Returns 429 when bucket is empty, with Retry-After header
- *
- * Legacy system (x-esi-error-limit-* headers):
- *   - 100 non-2xx/3xx errors per minute
- *   - Returns 420 when limit exceeded, with Retry-After header
- */
-import { IRateLimiter } from './IRateLimiter';
+import { IRateLimiter, RateLimitGroupStatus } from './IRateLimiter';
 export interface RateLimitInfo {
-    /** Tokens remaining in current window (new system) */
     remaining: number;
-    /** Total token budget (new system) */
     limit: number;
-    /** Tokens used in current window (new system) */
     used: number;
-    /** Route group for this endpoint (new system) */
     group: string | null;
-    /** Legacy error-limit remaining count */
     errorLimitRemain: number;
-    /** Legacy error-limit seconds until reset */
     errorLimitReset: number;
-    /** Retry-After value in seconds (set on 420/429) */
     retryAfter: number | null;
-    /** Timestamp (ms) when we must stop sending requests */
     blockedUntil: number;
 }
 export interface RateLimiterConfig {
     minDelayMs?: number;
     decelerationThreshold?: number;
+    userKeyExtractor?: (headers: Record<string, string>) => string;
 }
 export declare class RateLimiter implements IRateLimiter {
-    private rateLimitInfo;
-    private lastRequestTime;
     private readonly minDelayMs;
-    private isTestMode;
     private readonly decelerationThreshold;
+    private readonly userKeyExtractor?;
+    private lastRequestTime;
+    private isTestMode;
+    private errorLimitRemain;
+    private errorLimitReset;
+    private defaultBuckets;
+    private userBuckets;
+    private fallbackBucket;
+    private lastCleanup;
+    private static readonly CLEANUP_INTERVAL_MS;
     constructor(config?: RateLimiterConfig);
-    private defaultInfo;
-    /**
-     * Update rate limit information from response headers and status code.
-     * Must be called on EVERY response, not just 2xx.
-     */
-    updateFromResponse(headers: Record<string, string>, statusCode: number): void;
-    /**
-     * Legacy method — kept for backwards compatibility.
-     * Prefer updateFromResponse() which also accepts status code.
-     */
+    private createFallbackBucket;
+    private createBucketFromSpec;
+    private createBucketForGroup;
+    private lookupGroupSpec;
+    private resolveBucketMap;
+    private getBucket;
+    private cleanupStaleUsers;
+    updateFromResponse(headers: Record<string, string>, statusCode: number, templatePath?: string, method?: string, requestHeaders?: Record<string, string>): void;
     updateRateLimitInfo(headers: Record<string, string>): void;
-    /**
-     * Check if we should wait before making the next request.
-     * Enforces hard blocks (420/429), proactive deceleration, and minimum delay.
-     */
-    checkRateLimit(): Promise<void>;
-    /**
-     * Enforce minimum delay between requests
-     */
+    checkRateLimit(templatePath?: string, method?: string, requestHeaders?: Record<string, string>): Promise<void>;
     private enforceMinDelay;
-    /** Get current rate limit status */
     getStatus(): RateLimitInfo;
-    /** Get token cost for a given status code */
+    getGroupStatus(group: string): RateLimitGroupStatus | undefined;
+    getAllGroupStatuses(): Map<string, RateLimitGroupStatus>;
     static getTokenCost(statusCode: number): number;
-    /** Check if currently blocked (420/429 backoff active) */
-    isBlocked(): boolean;
-    /** Set test mode (disables all delays) */
+    isBlocked(group?: string): boolean;
     setTestMode(enabled: boolean): void;
-    /** Reset rate limiter state */
     reset(): void;
 }
 //# sourceMappingURL=RateLimiter.d.ts.map

package/dist/core/rateLimiter/RateLimiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../../src/core/rateLimiter/RateLimiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;CACtB;AAWD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAAkB;IAEpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAEnC,MAAM,CAAC,EAAE,iBAAiB;IAMtC,OAAO,CAAC,WAAW;IAanB;;;OAGG;IACH,kBAAkB,CAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,EAAE,MAAM,GACjB,IAAI;IAkDP;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI1D;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAyErC;;OAEG;YACW,eAAe;IAgB7B,oCAAoC;IACpC,SAAS,IAAI,aAAa;IAI1B,6CAA6C;IAC7C,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI/C,0DAA0D;IAC1D,SAAS,IAAI,OAAO;IAIpB,0CAA0C;IAC1C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,+BAA+B;IAC/B,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../../src/core/rateLimiter/RateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AASpE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;CAChE;AAmBD,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAEtB;IAEZ,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,UAAU,CAAkB;IAEpC,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,eAAe,CAAa;IAEpC,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,cAAc,CAAc;IAEpC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAU;gBAEzC,MAAM,CAAC,EAAE,iBAAiB;IAUtC,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,iBAAiB;IAazB,kBAAkB,CAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,IAAI;IAyCP,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIpD,cAAc,CAClB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;YA8DF,eAAe;IAgB7B,SAAS,IAAI,aAAa;IAyC1B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAa/D,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAexD,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI/C,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAelC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,KAAK,IAAI,IAAI;CASd"}