@lgriffin/esi.ts 10.0.0 → 10.2.1

package/dist/auth/EveSsoClient.d.mts

@@ -0,0 +1,88 @@
+import type { FetchLike } from '../core/ApiClient.mjs';
+export declare const DEFAULT_SSO_BASE_URL = "https://login.eveonline.com";
+export interface EveSsoClientConfig {
+    /** The application's client id from developers.eveonline.com. */
+    clientId: string;
+    /**
+     * The application's client secret. Omit for a public (PKCE) client; token
+     * requests then identify the application by `client_id` in the form body.
+     */
+    clientSecret?: string;
+    /** Redirect URI registered for the application. Used by {@link EveSsoClient.getAuthorizationUrl}. */
+    callbackUrl?: string;
+    /** Override the SSO host, for tests or a proxy. Defaults to https://login.eveonline.com. */
+    ssoBaseUrl?: string;
+    /** Custom fetch implementation. Defaults to `globalThis.fetch` resolved at call time. */
+    fetch?: FetchLike;
+}
+/** A successful response from the SSO token endpoint. */
+export interface SsoTokenResponse {
+    accessToken: string;
+    refreshToken: string;
+    /** Lifetime of `accessToken` in seconds, as reported by SSO. */
+    expiresIn: number;
+    tokenType: string;
+}
+export interface AuthorizationUrlOptions {
+    /** Scopes to request. */
+    scopes: readonly string[];
+    /** Opaque value echoed back on the callback; use {@link generateState}. */
+    state: string;
+    /** PKCE challenge for public clients; see {@link generatePkcePair}. */
+    codeChallenge?: string;
+    /** Overrides `callbackUrl` from the config. */
+    redirectUri?: string;
+}
+export interface ExchangeCodeOptions {
+    /** PKCE verifier that produced the challenge sent in the authorization URL. */
+    codeVerifier?: string;
+    /**
+     * The redirect URI that was sent in the authorization request. Defaults to
+     * the configured `callbackUrl`; when neither is set the field is omitted.
+     */
+    redirectUri?: string;
+}
+export interface RefreshOptions {
+    /** Request a subset of the originally granted scopes. */
+    scopes?: readonly string[];
+}
+/**
+ * Minimal client for the EVE SSO OAuth2 endpoints: building the login URL,
+ * exchanging an authorization code, refreshing, and revoking.
+ *
+ * Supports confidential clients (HTTP Basic with the client secret) and
+ * public clients (PKCE with `client_id` in the body). No JWT signature
+ * verification is performed; tokens are trusted because they arrive directly
+ * from SSO over TLS.
+ */
+export declare class EveSsoClient {
+    private readonly clientId;
+    private readonly clientSecret?;
+    private readonly callbackUrl?;
+    private readonly baseUrl;
+    private readonly fetchFn?;
+    constructor(config: EveSsoClientConfig);
+    /** True when a client secret is configured (confidential client). */
+    isConfidential(): boolean;
+    get tokenUrl(): string;
+    get authorizeUrl(): string;
+    get revokeUrl(): string;
+    /** Build the URL to send a player to for login. */
+    getAuthorizationUrl(options: AuthorizationUrlOptions): string;
+    /** Exchange the authorization code from the callback for tokens. */
+    exchangeCode(code: string, options?: ExchangeCodeOptions): Promise<SsoTokenResponse>;
+    /** Obtain a new access token (and rotated refresh token) from a refresh token. */
+    refresh(refreshToken: string, options?: RefreshOptions): Promise<SsoTokenResponse>;
+    /** Revoke a refresh token so it can no longer be used. */
+    revoke(token: string, tokenTypeHint?: 'refresh_token' | 'access_token'): Promise<void>;
+    private tokenRequest;
+    private post;
+    /**
+     * Map a non-2xx SSO response to an error. `invalid_grant` means "the
+     * refresh token is dead" only for a refresh grant; on a code exchange (or
+     * a revoke) it describes the login code or request, so it stays an
+     * `SsoError` and does not trigger the re-authentication path.
+     */
+    private errorFromResponse;
+}
+//# sourceMappingURL=EveSsoClient.d.ts.map

package/dist/auth/errors.d.mts

@@ -0,0 +1,42 @@
+/** Base class for every error raised by the auth subsystem. */
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+/**
+ * EVE SSO answered a token or revoke request with a non-2xx status.
+ *
+ * `errorCode` is the OAuth2 `error` field from the response body
+ * (`invalid_client`, `invalid_request`, ...) or `unknown` when the body could
+ * not be parsed. `statusCode` is the HTTP status.
+ */
+export declare class SsoError extends AuthError {
+    readonly statusCode: number;
+    readonly errorCode: string;
+    readonly errorDescription?: string;
+    constructor(statusCode: number, errorCode: string, errorDescription?: string);
+    /** True for statuses where the same request can be retried later. */
+    isRetryable(): boolean;
+}
+/**
+ * The refresh token is no longer accepted by SSO (`invalid_grant`), or the
+ * manager has already recorded that outcome for the character. The character
+ * must log in again; retrying cannot help.
+ */
+export declare class TokenRevokedError extends AuthError {
+    readonly characterId?: number;
+    constructor(message: string, characterId?: number);
+}
+/** A JWT access token could not be decoded into the claims the manager needs. */
+export declare class TokenDecodeError extends AuthError {
+    constructor(message: string);
+}
+/** No token is stored for the requested character. */
+export declare class CharacterNotFoundError extends AuthError {
+    readonly characterId: number;
+    constructor(characterId: number);
+}
+export declare function isAuthError(error: unknown): error is AuthError;
+export declare function isSsoError(error: unknown): error is SsoError;
+export declare function isTokenRevoked(error: unknown): error is TokenRevokedError;
+export declare function isCharacterNotFound(error: unknown): error is CharacterNotFoundError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/auth/index.d.mts

@@ -0,0 +1,14 @@
+export type { ITokenStorage, StoredToken } from './types.mjs';
+export { EveSsoClient, DEFAULT_SSO_BASE_URL } from './EveSsoClient.mjs';
+export type { EveSsoClientConfig, SsoTokenResponse, AuthorizationUrlOptions, ExchangeCodeOptions, RefreshOptions, } from './EveSsoClient.mjs';
+export { EsiTokenManager } from './EsiTokenManager.mjs';
+export type { EsiTokenManagerConfig, AddCharacterOptions, RemoveCharacterOptions, RefreshAllOptions, RefreshResult, RefreshStatus, CharacterSummary, ManagedClientConfig, } from './EsiTokenManager.mjs';
+export { MemoryTokenStorage } from './storage/MemoryTokenStorage.mjs';
+export { FileTokenStorage } from './storage/FileTokenStorage.mjs';
+export type { FileTokenStorageOptions } from './storage/FileTokenStorage.mjs';
+export { AuthError, SsoError, TokenRevokedError, TokenDecodeError, CharacterNotFoundError, isAuthError, isSsoError, isTokenRevoked, isCharacterNotFound, } from './errors.mjs';
+export { decodeAccessToken, decodeJwtPayload, parseCharacterId, parseScopes, } from './jwt.mjs';
+export type { DecodedAccessToken, EveJwtClaims } from './jwt.mjs';
+export { generatePkcePair, generateCodeVerifier, codeChallengeFromVerifier, generateState, } from './pkce.mjs';
+export type { PkcePair } from './pkce.mjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/jwt.d.mts

@@ -0,0 +1,43 @@
+/** Claims EVE SSO places in an access token. Only the ones the manager reads are typed. */
+export interface EveJwtClaims {
+    /** `CHARACTER:EVE:<characterId>` */
+    sub: string;
+    /** Character name. */
+    name?: string;
+    /** Granted scopes: a single string, or an array when more than one. */
+    scp?: string | string[];
+    /** Expiry as epoch seconds. */
+    exp?: number;
+    /** Issued-at as epoch seconds. */
+    iat?: number;
+    /** Owner hash; changes on character transfer. */
+    owner?: string;
+    iss?: string;
+    aud?: string | string[];
+    [claim: string]: unknown;
+}
+/** Identity and lifetime information extracted from an EVE SSO access token. */
+export interface DecodedAccessToken {
+    characterId: number;
+    characterName: string;
+    scopes: string[];
+    /** Epoch milliseconds, or undefined when the token carries no `exp`. */
+    expiresAt?: number;
+    ownerHash?: string;
+    claims: EveJwtClaims;
+}
+/**
+ * Decode the payload of a JWT without verifying its signature.
+ *
+ * Tokens reach the manager directly from SSO over TLS, so the payload is
+ * trusted for the purpose of learning which character it belongs to. Do not
+ * use this to authenticate tokens presented by third parties.
+ */
+export declare function decodeJwtPayload(token: string): EveJwtClaims;
+/** Parse the character id out of an SSO `sub` claim (`CHARACTER:EVE:123`). */
+export declare function parseCharacterId(sub: unknown): number;
+/** Normalise the `scp` claim, which SSO emits as a string for one scope and an array otherwise. */
+export declare function parseScopes(scp: unknown): string[];
+/** Decode an EVE SSO access token into the fields the token manager stores. */
+export declare function decodeAccessToken(token: string): DecodedAccessToken;
+//# sourceMappingURL=jwt.d.ts.map

package/dist/auth/pkce.d.mts

@@ -0,0 +1,21 @@
+/**
+ * A PKCE verifier/challenge pair for the authorization-code flow of a public
+ * client (one that cannot hold a client secret).
+ */
+export interface PkcePair {
+    /** Random secret sent with the token request as `code_verifier`. */
+    codeVerifier: string;
+    /** `BASE64URL(SHA256(codeVerifier))`, sent in the authorization URL. */
+    codeChallenge: string;
+    /** Always `S256`; EVE SSO does not accept the plain method. */
+    codeChallengeMethod: 'S256';
+}
+/** Generate a 32-byte base64url code verifier (43 characters). */
+export declare function generateCodeVerifier(): string;
+/** Derive the S256 code challenge for a verifier. */
+export declare function codeChallengeFromVerifier(codeVerifier: string): string;
+/** Generate a verifier and its challenge in one call. */
+export declare function generatePkcePair(): PkcePair;
+/** Generate an unguessable OAuth2 `state` value. */
+export declare function generateState(): string;
+//# sourceMappingURL=pkce.d.ts.map

package/dist/auth/storage/FileTokenStorage.d.mts

@@ -0,0 +1,44 @@
+import type { ITokenStorage, StoredToken } from '../types.mjs';
+export interface FileTokenStorageOptions {
+    /**
+     * POSIX permission bits for the token file. Defaults to `0o600` (owner
+     * read/write only). Ignored on platforms without POSIX modes.
+     */
+    mode?: number;
+}
+/**
+ * JSON-file {@link ITokenStorage} for single-process applications.
+ *
+ * Writes go to a sibling temporary file that is renamed over the target, so a
+ * crash mid-write leaves the previous file intact. Writes are serialised
+ * within the process. Two processes sharing one file are not supported: each
+ * would rotate refresh tokens the other cannot see.
+ */
+export declare class FileTokenStorage implements ITokenStorage {
+    private readonly filePath;
+    private readonly mode;
+    private cache;
+    private loading;
+    /** Bumped by invalidate() so a read that began earlier cannot repopulate the cache. */
+    private loadGeneration;
+    private writeChain;
+    constructor(filePath: string, options?: FileTokenStorageOptions);
+    /** Absolute path of the backing file. */
+    get path(): string;
+    get(characterId: number): Promise<StoredToken | null>;
+    set(characterId: number, token: StoredToken): Promise<void>;
+    delete(characterId: number): Promise<void>;
+    list(): Promise<StoredToken[]>;
+    /** Drop the in-memory copy so the next call re-reads the file. */
+    invalidate(): void;
+    /**
+     * Load once; overlapping first calls share the same read so none of them
+     * clobbers another's map. A read that started before invalidate() still
+     * resolves for its own callers but neither becomes the cache nor clears a
+     * newer in-flight read.
+     */
+    private load;
+    private readFile;
+    private persist;
+}
+//# sourceMappingURL=FileTokenStorage.d.ts.map

package/dist/auth/storage/MemoryTokenStorage.d.mts

@@ -0,0 +1,18 @@
+import type { ITokenStorage, StoredToken } from '../types.mjs';
+/**
+ * In-memory {@link ITokenStorage}. Tokens live only as long as the process.
+ * Useful for tests, CLIs that log in on every run, and as a cache in front of
+ * a durable store.
+ */
+export declare class MemoryTokenStorage implements ITokenStorage {
+    private readonly tokens;
+    constructor(initial?: readonly StoredToken[]);
+    get(characterId: number): Promise<StoredToken | null>;
+    set(characterId: number, token: StoredToken): Promise<void>;
+    delete(characterId: number): Promise<void>;
+    list(): Promise<StoredToken[]>;
+    /** Remove every token. */
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=MemoryTokenStorage.d.ts.map

package/dist/auth/types.d.mts

@@ -0,0 +1,42 @@
+/**
+ * A character's SSO credentials as held by an {@link ITokenStorage}.
+ *
+ * Timestamps are epoch milliseconds so the record is JSON-safe and can be
+ * compared against `Date.now()` without parsing.
+ */
+export interface StoredToken {
+    /** EVE character id, decoded from the access token's `sub` claim. */
+    characterId: number;
+    /** Character name, decoded from the access token's `name` claim. */
+    characterName: string;
+    /** Current bearer token for ESI requests. */
+    accessToken: string;
+    /** Refresh token as of the last SSO exchange; SSO rotates it on every use. */
+    refreshToken: string;
+    /** When `accessToken` expires, in epoch milliseconds. */
+    expiresAt: number;
+    /** Scopes granted to this token, decoded from the `scp` claim. */
+    scopes: string[];
+    /** The `owner` claim: changes if the character is transferred between accounts. */
+    ownerHash?: string;
+    /** When this record was last written, in epoch milliseconds. */
+    updatedAt: number;
+    /**
+     * Set when SSO rejected the refresh token as invalid. The manager stops
+     * contacting SSO for this character until it is added again.
+     */
+    revokedAt?: number;
+}
+/**
+ * Persistence contract for {@link StoredToken} records, keyed by character id.
+ *
+ * Implementations must return copies rather than shared references and must
+ * tolerate `get`/`delete` for ids they have never seen.
+ */
+export interface ITokenStorage {
+    get(characterId: number): Promise<StoredToken | null>;
+    set(characterId: number, token: StoredToken): Promise<void>;
+    delete(characterId: number): Promise<void>;
+    list(): Promise<StoredToken[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/{chunk-7A72QFDF.mjs → chunk-4W66ONJI.mjs}

@@ -46,11 +46,7 @@ var logTrace = (message, context) => {
 
 // src/core/logger/resolveLogger.ts
 function resolveLogger(client) {
-  const perClient = client?.getLogger?.();
-  if (perClient) return perClient;
-  const global = getLogger();
-  if (global !== defaultLogger) return global;
-  return defaultLogger;
+  return client?.getLogger?.() ?? getLogger();
 }
 
 // src/core/logger/clientLog.ts
@@ -115,7 +111,7 @@ var CircuitBreaker = class {
       const elapsed = Date.now() - record.lastFailureTime;
       if (elapsed >= this.resetTimeoutMs) {
         record.state = "half-open";
-        record.halfOpenAttempts = 0;
+        record.halfOpenAttempts = 1;
         logInfo2(
           this.client,
           `Circuit half-open for ${key}, allowing probe request`,
@@ -137,6 +133,7 @@ var CircuitBreaker = class {
     const key = this.getKey(endpoint);
     const record = this.circuits.get(key);
     if (!record) return;
+    if (record.state === "open") return;
     if (record.state === "half-open") {
       logInfo2(this.client, `Circuit closed for ${key} after successful probe`, {
         key
@@ -413,4 +410,4 @@ export {
   EsiValidationError,
   isValidationError
 };
-//# sourceMappingURL=chunk-7A72QFDF.mjs.map
+//# sourceMappingURL=chunk-4W66ONJI.mjs.map

package/dist/chunk-4W66ONJI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/logger/DefaultLogger.ts","../src/core/logger/loggerUtil.ts","../src/core/logger/resolveLogger.ts","../src/core/logger/clientLog.ts","../src/core/circuitBreaker/CircuitBreaker.ts","../src/core/util/error.ts"],"sourcesContent":["import pino from 'pino';\nimport type { ILogger, LogContext } from './ILogger';\n\n/**\n * The default `ILogger` implementation — a thin wrapper around pino.\n *\n * Level resolution (highest precedence first):\n * 1. `level` passed to `createDefaultLogger` (e.g. from\n *    `EsiClientConfig.logLevel`).\n * 2. The `ESI_LOG_LEVEL` environment variable.\n * 3. `'warn'` (library default — quiet unless the app opts in).\n *\n * The logger writes to `process.stdout` and can be swapped entirely via\n * `EsiClientConfig.logger` or the global `setLogger()` fallback.\n */\nexport type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';\n\nexport function createDefaultLogger(level?: string): ILogger {\n  const resolved = level || process.env.ESI_LOG_LEVEL || 'warn';\n  const pinoLogger = pino({ level: resolved });\n  return toPinoLogger(pinoLogger);\n}\n\n/**\n * Adapt any pino-compatible logger (pino, pino-http child, custom sink) to the\n * `ILogger` contract. Context objects are spread onto the log event so they\n * appear as structured fields rather than being stringified into the message.\n */\nexport function toPinoLogger(p: {\n  fatal: (...a: unknown[]) => void;\n  error: (...a: unknown[]) => void;\n  warn: (...a: unknown[]) => void;\n  info: (...a: unknown[]) => void;\n  debug: (...a: unknown[]) => void;\n  trace: (...a: unknown[]) => void;\n}): ILogger {\n  // Call through the sink object so pino methods keep their `this` binding.\n  const emit =\n    (level: LogLevel) =>\n    (message: string, context?: LogContext): void =>\n      context ? p[level](context, message) : p[level](message);\n  return {\n    fatal: emit('fatal'),\n    error: emit('error'),\n    warn: emit('warn'),\n    info: emit('info'),\n    debug: emit('debug'),\n    trace: emit('trace'),\n  };\n}\n\n/** Backwards-compatible default instance (level from `ESI_LOG_LEVEL`). */\nexport const defaultLogger: ILogger = createDefaultLogger();\n","import type { ILogger, LogContext } from './ILogger';\nimport { defaultLogger } from './DefaultLogger';\n\nexport type { ILogger, LogContext } from './ILogger';\n\n/**\n * Global logger fallback.\n *\n * The request pipeline reads the *per-client* logger first and only falls\n * back to this global when a client has none (e.g. the raw factory\n * `EsiApiFactory` clients, or unit tests that call pipeline modules\n * directly). Production apps can rely on the per-client logger from\n * `EsiClientConfig.logger`; this global exists for backwards compatibility\n * and for apps that want one shared logger across all clients.\n */\nlet activeLogger: ILogger = defaultLogger;\n\nexport const setLogger = (customLogger: ILogger): void => {\n  activeLogger = customLogger;\n};\n\nexport const getLogger = (): ILogger => activeLogger;\n\nconst ctx = (context?: LogContext): LogContext | undefined =>\n  context && Object.keys(context).length > 0 ? context : undefined;\n\nexport const logFatal = (message: string, context?: LogContext): void => {\n  activeLogger.fatal(message, ctx(context));\n};\n\nexport const logError = (message: string, context?: LogContext): void => {\n  activeLogger.error(message, ctx(context));\n};\n\nexport const logWarn = (message: string, context?: LogContext): void => {\n  activeLogger.warn(message, ctx(context));\n};\n\nexport const logInfo = (message: string, context?: LogContext): void => {\n  activeLogger.info(message, ctx(context));\n};\n\nexport const logDebug = (message: string, context?: LogContext): void => {\n  activeLogger.debug(message, ctx(context));\n};\n\nexport const logTrace = (message: string, context?: LogContext): void => {\n  activeLogger.trace(message, ctx(context));\n};\n","import type { ILogger } from './ILogger';\nimport { getLogger } from './loggerUtil';\n\n/**\n * Resolve the logger for a given API client: per-client logger first, then\n * the global one — a logger installed with `setLogger`, or the built-in pino\n * default when none was.\n */\nexport function resolveLogger(\n  client: { getLogger?: () => ILogger | null } | null | undefined,\n): ILogger {\n  return client?.getLogger?.() ?? getLogger();\n}\n","import type { ApiClient } from '../ApiClient';\nimport type { LogContext } from './ILogger';\nimport { resolveLogger } from './resolveLogger';\n\ntype Level = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';\n\ntype Emit = (\n  client: ApiClient | null | undefined,\n  message: string,\n  context?: LogContext,\n) => void;\n\nconst emit =\n  (level: Level): Emit =>\n  (client, message, context) => {\n    resolveLogger(client)[level](\n      message,\n      context && Object.keys(context).length > 0 ? context : undefined,\n    );\n  };\n\nexport const logFatal: Emit = emit('fatal');\nexport const logError: Emit = emit('error');\nexport const logWarn: Emit = emit('warn');\nexport const logInfo: Emit = emit('info');\nexport const logDebug: Emit = emit('debug');\nexport const logTrace: Emit = emit('trace');\n","import { ApiClient } from '../ApiClient';\nimport { logWarn, logInfo } from '../logger/clientLog';\nimport { ICircuitBreaker } from './ICircuitBreaker';\n\nexport type CircuitState = 'closed' | 'open' | 'half-open';\n\nexport interface CircuitBreakerConfig {\n  failureThreshold?: number;\n  resetTimeoutMs?: number;\n  halfOpenMaxAttempts?: number;\n  staleThresholdMs?: number;\n  /** 'resolved' (default, current behavior) | 'template' (group by endpoint template path) */\n  keyStrategy?: 'resolved' | 'template';\n  /** Interval in ms for automatic cleanup of stale circuits. 0 or undefined disables. Recommended value: staleThresholdMs. */\n  cleanupIntervalMs?: number;\n}\n\ninterface CircuitRecord {\n  state: CircuitState;\n  failures: number;\n  lastFailureTime: number;\n  halfOpenAttempts: number;\n}\n\nexport class CircuitBreaker implements ICircuitBreaker {\n  private circuits: Map<string, CircuitRecord> = new Map();\n  private readonly failureThreshold: number;\n  private readonly resetTimeoutMs: number;\n  private readonly halfOpenMaxAttempts: number;\n  private readonly staleThresholdMs: number;\n  private readonly keyStrategy: 'resolved' | 'template';\n  private cleanupTimer: ReturnType<typeof setInterval> | null = null;\n  private client: ApiClient | null = null;\n\n  setClient(client: ApiClient | null): void {\n    this.client = client;\n  }\n\n  constructor(config: CircuitBreakerConfig = {}) {\n    this.failureThreshold = config.failureThreshold ?? 5;\n    this.resetTimeoutMs = config.resetTimeoutMs ?? 30_000;\n    this.halfOpenMaxAttempts = config.halfOpenMaxAttempts ?? 1;\n    this.staleThresholdMs = config.staleThresholdMs ?? 3_600_000;\n    this.keyStrategy = config.keyStrategy ?? 'resolved';\n\n    const cleanupIntervalMs = config.cleanupIntervalMs;\n    if (cleanupIntervalMs !== undefined && cleanupIntervalMs > 0) {\n      this.startCleanupTimer(cleanupIntervalMs);\n    }\n  }\n\n  private getKey(endpoint: string): string {\n    return endpoint.split('?')[0]!;\n  }\n\n  private getOrCreate(key: string): CircuitRecord {\n    let record = this.circuits.get(key);\n    if (!record) {\n      record = {\n        state: 'closed',\n        failures: 0,\n        lastFailureTime: 0,\n        halfOpenAttempts: 0,\n      };\n      this.circuits.set(key, record);\n    }\n    return record;\n  }\n\n  checkCircuit(endpoint: string): void {\n    const key = this.getKey(endpoint);\n    const record = this.getOrCreate(key);\n\n    if (record.state === 'closed') return;\n\n    if (record.state === 'open') {\n      const elapsed = Date.now() - record.lastFailureTime;\n      if (elapsed >= this.resetTimeoutMs) {\n        record.state = 'half-open';\n        // This call is the first probe, so it counts towards halfOpenMaxAttempts.\n        record.halfOpenAttempts = 1;\n        logInfo(\n          this.client,\n          `Circuit half-open for ${key}, allowing probe request`,\n          { key },\n        );\n        return;\n      }\n      const remainingMs = this.resetTimeoutMs - elapsed;\n      throw new CircuitOpenError(key, record.failures, remainingMs);\n    }\n\n    if (record.state === 'half-open') {\n      if (record.halfOpenAttempts >= this.halfOpenMaxAttempts) {\n        throw new CircuitOpenError(key, record.failures, this.resetTimeoutMs);\n      }\n      record.halfOpenAttempts++;\n    }\n  }\n\n  recordSuccess(endpoint: string): void {\n    const key = this.getKey(endpoint);\n    const record = this.circuits.get(key);\n    if (!record) return;\n\n    // A success while open comes from a call admitted before the circuit\n    // opened. Only a half-open probe may close the circuit.\n    if (record.state === 'open') return;\n\n    if (record.state === 'half-open') {\n      logInfo(this.client, `Circuit closed for ${key} after successful probe`, {\n        key,\n      });\n    }\n\n    record.state = 'closed';\n    record.failures = 0;\n    record.halfOpenAttempts = 0;\n  }\n\n  recordFailure(endpoint: string, statusCode: number): void {\n    // statusCode 0 = network/timeout; 420/429 = rate limited; >=500 = server errors\n    if (\n      statusCode !== 0 &&\n      statusCode < 500 &&\n      statusCode !== 420 &&\n      statusCode !== 429\n    ) {\n      return;\n    }\n\n    const key = this.getKey(endpoint);\n    const record = this.getOrCreate(key);\n\n    record.failures++;\n    record.lastFailureTime = Date.now();\n\n    if (record.state === 'half-open') {\n      record.state = 'open';\n      logWarn(\n        this.client,\n        `Circuit re-opened for ${key} after failed probe (${record.failures} failures)`,\n        { key, failures: record.failures },\n      );\n      return;\n    }\n\n    if (record.failures >= this.failureThreshold) {\n      record.state = 'open';\n      logWarn(\n        this.client,\n        `Circuit opened for ${key} after ${record.failures} consecutive failures`,\n        { key, failures: record.failures },\n      );\n    }\n  }\n\n  getState(endpoint: string): CircuitState {\n    const key = this.getKey(endpoint);\n    const record = this.circuits.get(key);\n    if (!record) return 'closed';\n\n    if (record.state === 'open') {\n      const elapsed = Date.now() - record.lastFailureTime;\n      if (elapsed >= this.resetTimeoutMs) {\n        return 'half-open';\n      }\n    }\n\n    return record.state;\n  }\n\n  getStats(): {\n    totalCircuits: number;\n    openCircuits: number;\n    circuits: Record<string, { state: CircuitState; failures: number }>;\n  } {\n    const circuits: Record<string, { state: CircuitState; failures: number }> =\n      {};\n    let openCircuits = 0;\n\n    for (const [key, record] of this.circuits.entries()) {\n      const state = this.getState(key);\n      // eslint-disable-next-line security/detect-object-injection\n      circuits[key] = { state, failures: record.failures };\n      if (state === 'open') openCircuits++;\n    }\n\n    return {\n      totalCircuits: this.circuits.size,\n      openCircuits,\n      circuits,\n    };\n  }\n\n  reset(endpoint?: string): void {\n    if (endpoint) {\n      this.circuits.delete(this.getKey(endpoint));\n    } else {\n      this.circuits.clear();\n    }\n  }\n\n  cleanup(): number {\n    const now = Date.now();\n    let cleaned = 0;\n    for (const [key, record] of this.circuits.entries()) {\n      if (\n        record.state === 'closed' &&\n        record.failures === 0 &&\n        record.lastFailureTime > 0 &&\n        now - record.lastFailureTime > this.staleThresholdMs\n      ) {\n        this.circuits.delete(key);\n        cleaned++;\n      }\n    }\n    if (cleaned > 0) {\n      logInfo(\n        this.client,\n        `Circuit breaker cleanup: removed ${cleaned} stale circuits`,\n        {\n          cleaned,\n        },\n      );\n    }\n    return cleaned;\n  }\n\n  getKeyStrategy(): 'resolved' | 'template' {\n    return this.keyStrategy;\n  }\n\n  destroy(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = null;\n    }\n    this.circuits.clear();\n  }\n\n  shutdown(): void {\n    this.destroy();\n  }\n\n  private startCleanupTimer(intervalMs: number): void {\n    this.cleanupTimer = setInterval(() => {\n      this.cleanup();\n    }, intervalMs);\n    // Don't prevent process exit (important for test runners and CLI tools)\n    this.cleanupTimer.unref();\n  }\n}\n\nexport class CircuitOpenError extends Error {\n  readonly endpoint: string;\n  readonly failures: number;\n  readonly retryAfterMs: number;\n\n  constructor(endpoint: string, failures: number, retryAfterMs: number) {\n    super(\n      `Circuit breaker open for ${endpoint} after ${failures} failures (retry after ${Math.ceil(retryAfterMs / 1000)}s)`,\n    );\n    this.name = 'CircuitOpenError';\n    this.endpoint = endpoint;\n    this.failures = failures;\n    this.retryAfterMs = retryAfterMs;\n  }\n}\n","const SENSITIVE_PARAMS = [\n  'token',\n  'access_token',\n  'api_key',\n  'refresh_token',\n  'client_secret',\n  'code',\n  'key',\n  'secret',\n  'auth',\n  'password',\n  'bearer',\n];\n\nexport function sanitizeUrl(url?: string): string | undefined {\n  if (!url) return url;\n  try {\n    const parsed = new URL(url);\n    for (const param of SENSITIVE_PARAMS) {\n      if (parsed.searchParams.has(param)) {\n        parsed.searchParams.set(param, '[REDACTED]');\n      }\n    }\n    return parsed.toString();\n  } catch {\n    const qIndex = url.indexOf('?');\n    return qIndex >= 0 ? url.substring(0, qIndex) + '?[params-redacted]' : url;\n  }\n}\n\nexport class EsiError extends Error {\n  public readonly url?: string;\n\n  constructor(\n    public readonly statusCode: number,\n    message: string,\n    url?: string,\n    public readonly requestId?: string,\n  ) {\n    super(message);\n    this.name = 'EsiError';\n    this.url = sanitizeUrl(url);\n  }\n\n  isRateLimited(): boolean {\n    return this.statusCode === 420 || this.statusCode === 429;\n  }\n\n  isNotFound(): boolean {\n    return this.statusCode === 404;\n  }\n\n  isUnauthorized(): boolean {\n    return this.statusCode === 401;\n  }\n\n  isForbidden(): boolean {\n    return this.statusCode === 403;\n  }\n\n  isServerError(): boolean {\n    return this.statusCode >= 500;\n  }\n\n  isTimeout(): boolean {\n    return this.statusCode === 0;\n  }\n\n  get retryable(): boolean {\n    return (\n      this.statusCode === 0 ||\n      this.statusCode === 420 ||\n      this.statusCode === 429 ||\n      this.statusCode === 502 ||\n      this.statusCode === 503 ||\n      this.statusCode === 504\n    );\n  }\n}\n\nexport function isEsiError(error: unknown): error is EsiError {\n  return error instanceof EsiError;\n}\n\nexport function isRateLimited(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isRateLimited();\n}\n\nexport function isNotFound(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isNotFound();\n}\n\nexport function isUnauthorized(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isUnauthorized();\n}\n\nexport function isForbidden(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isForbidden();\n}\n\nexport function isServerError(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isServerError();\n}\n\nexport class TimeoutError extends EsiError {\n  constructor(\n    public readonly timeoutMs: number,\n    url?: string,\n    requestId?: string,\n  ) {\n    super(0, `Request timed out after ${timeoutMs}ms`, url, requestId);\n    this.name = 'TimeoutError';\n  }\n}\n\nexport function isTimeout(error: unknown): error is TimeoutError {\n  return error instanceof TimeoutError;\n}\n\nexport function isRetryable(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.retryable;\n}\n\n// Re-export CircuitOpenError for the type guard — avoid forcing consumers\n// to import from the circuitBreaker subpath just for error checking.\nimport { CircuitOpenError } from '../circuitBreaker/CircuitBreaker';\n\nexport function isCircuitOpen(error: unknown): error is CircuitOpenError {\n  return error instanceof CircuitOpenError;\n}\n\nexport const buildError = (\n  message: string,\n  type: string = 'ERROR',\n  url?: string,\n): Error => {\n  const error = new Error(`[${type}] ${message}`);\n  if (url) {\n    (error as Error & { url: string }).url = url;\n  }\n  return error;\n};\n\nexport type ValidationDirection = 'request' | 'response';\n\nexport class EsiValidationError extends EsiError {\n  public readonly validationError: unknown;\n  public readonly direction: ValidationDirection;\n\n  constructor(\n    url: string,\n    zodError: unknown,\n    requestId?: string,\n    direction: ValidationDirection = 'response',\n  ) {\n    const safeUrl = sanitizeUrl(url) ?? url;\n    const label = direction === 'request' ? 'Request body' : 'Response';\n    super(0, `${label} validation failed for ${safeUrl}`, url, requestId);\n    this.name = 'EsiValidationError';\n    this.validationError = zodError;\n    this.direction = direction;\n  }\n}\n\nexport function isValidationError(error: unknown): error is EsiValidationError {\n  return error instanceof EsiValidationError;\n}\n"],"mappings":"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","names":["emit","logFatal","logError","logWarn","logInfo","logDebug","logTrace","logInfo","logWarn"]}

package/dist/{chunk-HPSACXX3.js → chunk-N3B65VLB.js}

@@ -46,11 +46,7 @@ var logTrace = (message, context) => {
 
 // src/core/logger/resolveLogger.ts
 function resolveLogger(client) {
-  const perClient = _optionalChain([client, 'optionalAccess', _ => _.getLogger, 'optionalCall', _2 => _2()]);
-  if (perClient) return perClient;
-  const global = getLogger();
-  if (global !== defaultLogger) return global;
-  return defaultLogger;
+  return _nullishCoalesce(_optionalChain([client, 'optionalAccess', _ => _.getLogger, 'optionalCall', _2 => _2()]), () => ( getLogger()));
 }
 
 // src/core/logger/clientLog.ts
@@ -115,7 +111,7 @@ var CircuitBreaker = (_class = class {
       const elapsed = Date.now() - record.lastFailureTime;
       if (elapsed >= this.resetTimeoutMs) {
         record.state = "half-open";
-        record.halfOpenAttempts = 0;
+        record.halfOpenAttempts = 1;
         logInfo2(
           this.client,
           `Circuit half-open for ${key}, allowing probe request`,
@@ -137,6 +133,7 @@ var CircuitBreaker = (_class = class {
     const key = this.getKey(endpoint);
     const record = this.circuits.get(key);
     if (!record) return;
+    if (record.state === "open") return;
     if (record.state === "half-open") {
       logInfo2(this.client, `Circuit closed for ${key} after successful probe`, {
         key
@@ -413,4 +410,4 @@ function isValidationError(error) {
 
 
 exports.createDefaultLogger = createDefaultLogger; exports.toPinoLogger = toPinoLogger; exports.setLogger = setLogger; exports.getLogger = getLogger; exports.logFatal = logFatal; exports.logError = logError; exports.logWarn = logWarn; exports.logInfo = logInfo; exports.logDebug = logDebug; exports.logTrace = logTrace; exports.logError2 = logError2; exports.logWarn2 = logWarn2; exports.logInfo2 = logInfo2; exports.logDebug2 = logDebug2; exports.CircuitBreaker = CircuitBreaker; exports.CircuitOpenError = CircuitOpenError; exports.sanitizeUrl = sanitizeUrl; exports.EsiError = EsiError; exports.isEsiError = isEsiError; exports.isRateLimited = isRateLimited; exports.isNotFound = isNotFound; exports.isUnauthorized = isUnauthorized; exports.isForbidden = isForbidden; exports.isServerError = isServerError; exports.TimeoutError = TimeoutError; exports.isTimeout = isTimeout; exports.isRetryable = isRetryable; exports.isCircuitOpen = isCircuitOpen; exports.buildError = buildError; exports.EsiValidationError = EsiValidationError; exports.isValidationError = isValidationError;
-//# sourceMappingURL=chunk-HPSACXX3.js.map
+//# sourceMappingURL=chunk-N3B65VLB.js.map

package/dist/chunk-N3B65VLB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ESI.ts/ESI.ts/dist/chunk-N3B65VLB.js","../src/core/logger/DefaultLogger.ts","../src/core/logger/loggerUtil.ts","../src/core/logger/resolveLogger.ts","../src/core/logger/clientLog.ts","../src/core/circuitBreaker/CircuitBreaker.ts","../src/core/util/error.ts"],"names":["emit","logFatal","logError","logWarn","logInfo","logDebug","logTrace"],"mappings":"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","file":"/home/runner/work/ESI.ts/ESI.ts/dist/chunk-N3B65VLB.js","sourcesContent":[null,"import pino from 'pino';\nimport type { ILogger, LogContext } from './ILogger';\n\n/**\n * The default `ILogger` implementation — a thin wrapper around pino.\n *\n * Level resolution (highest precedence first):\n * 1. `level` passed to `createDefaultLogger` (e.g. from\n *    `EsiClientConfig.logLevel`).\n * 2. The `ESI_LOG_LEVEL` environment variable.\n * 3. `'warn'` (library default — quiet unless the app opts in).\n *\n * The logger writes to `process.stdout` and can be swapped entirely via\n * `EsiClientConfig.logger` or the global `setLogger()` fallback.\n */\nexport type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';\n\nexport function createDefaultLogger(level?: string): ILogger {\n  const resolved = level || process.env.ESI_LOG_LEVEL || 'warn';\n  const pinoLogger = pino({ level: resolved });\n  return toPinoLogger(pinoLogger);\n}\n\n/**\n * Adapt any pino-compatible logger (pino, pino-http child, custom sink) to the\n * `ILogger` contract. Context objects are spread onto the log event so they\n * appear as structured fields rather than being stringified into the message.\n */\nexport function toPinoLogger(p: {\n  fatal: (...a: unknown[]) => void;\n  error: (...a: unknown[]) => void;\n  warn: (...a: unknown[]) => void;\n  info: (...a: unknown[]) => void;\n  debug: (...a: unknown[]) => void;\n  trace: (...a: unknown[]) => void;\n}): ILogger {\n  // Call through the sink object so pino methods keep their `this` binding.\n  const emit =\n    (level: LogLevel) =>\n    (message: string, context?: LogContext): void =>\n      context ? p[level](context, message) : p[level](message);\n  return {\n    fatal: emit('fatal'),\n    error: emit('error'),\n    warn: emit('warn'),\n    info: emit('info'),\n    debug: emit('debug'),\n    trace: emit('trace'),\n  };\n}\n\n/** Backwards-compatible default instance (level from `ESI_LOG_LEVEL`). */\nexport const defaultLogger: ILogger = createDefaultLogger();\n","import type { ILogger, LogContext } from './ILogger';\nimport { defaultLogger } from './DefaultLogger';\n\nexport type { ILogger, LogContext } from './ILogger';\n\n/**\n * Global logger fallback.\n *\n * The request pipeline reads the *per-client* logger first and only falls\n * back to this global when a client has none (e.g. the raw factory\n * `EsiApiFactory` clients, or unit tests that call pipeline modules\n * directly). Production apps can rely on the per-client logger from\n * `EsiClientConfig.logger`; this global exists for backwards compatibility\n * and for apps that want one shared logger across all clients.\n */\nlet activeLogger: ILogger = defaultLogger;\n\nexport const setLogger = (customLogger: ILogger): void => {\n  activeLogger = customLogger;\n};\n\nexport const getLogger = (): ILogger => activeLogger;\n\nconst ctx = (context?: LogContext): LogContext | undefined =>\n  context && Object.keys(context).length > 0 ? context : undefined;\n\nexport const logFatal = (message: string, context?: LogContext): void => {\n  activeLogger.fatal(message, ctx(context));\n};\n\nexport const logError = (message: string, context?: LogContext): void => {\n  activeLogger.error(message, ctx(context));\n};\n\nexport const logWarn = (message: string, context?: LogContext): void => {\n  activeLogger.warn(message, ctx(context));\n};\n\nexport const logInfo = (message: string, context?: LogContext): void => {\n  activeLogger.info(message, ctx(context));\n};\n\nexport const logDebug = (message: string, context?: LogContext): void => {\n  activeLogger.debug(message, ctx(context));\n};\n\nexport const logTrace = (message: string, context?: LogContext): void => {\n  activeLogger.trace(message, ctx(context));\n};\n","import type { ILogger } from './ILogger';\nimport { getLogger } from './loggerUtil';\n\n/**\n * Resolve the logger for a given API client: per-client logger first, then\n * the global one — a logger installed with `setLogger`, or the built-in pino\n * default when none was.\n */\nexport function resolveLogger(\n  client: { getLogger?: () => ILogger | null } | null | undefined,\n): ILogger {\n  return client?.getLogger?.() ?? getLogger();\n}\n","import type { ApiClient } from '../ApiClient';\nimport type { LogContext } from './ILogger';\nimport { resolveLogger } from './resolveLogger';\n\ntype Level = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';\n\ntype Emit = (\n  client: ApiClient | null | undefined,\n  message: string,\n  context?: LogContext,\n) => void;\n\nconst emit =\n  (level: Level): Emit =>\n  (client, message, context) => {\n    resolveLogger(client)[level](\n      message,\n      context && Object.keys(context).length > 0 ? context : undefined,\n    );\n  };\n\nexport const logFatal: Emit = emit('fatal');\nexport const logError: Emit = emit('error');\nexport const logWarn: Emit = emit('warn');\nexport const logInfo: Emit = emit('info');\nexport const logDebug: Emit = emit('debug');\nexport const logTrace: Emit = emit('trace');\n","import { ApiClient } from '../ApiClient';\nimport { logWarn, logInfo } from '../logger/clientLog';\nimport { ICircuitBreaker } from './ICircuitBreaker';\n\nexport type CircuitState = 'closed' | 'open' | 'half-open';\n\nexport interface CircuitBreakerConfig {\n  failureThreshold?: number;\n  resetTimeoutMs?: number;\n  halfOpenMaxAttempts?: number;\n  staleThresholdMs?: number;\n  /** 'resolved' (default, current behavior) | 'template' (group by endpoint template path) */\n  keyStrategy?: 'resolved' | 'template';\n  /** Interval in ms for automatic cleanup of stale circuits. 0 or undefined disables. Recommended value: staleThresholdMs. */\n  cleanupIntervalMs?: number;\n}\n\ninterface CircuitRecord {\n  state: CircuitState;\n  failures: number;\n  lastFailureTime: number;\n  halfOpenAttempts: number;\n}\n\nexport class CircuitBreaker implements ICircuitBreaker {\n  private circuits: Map<string, CircuitRecord> = new Map();\n  private readonly failureThreshold: number;\n  private readonly resetTimeoutMs: number;\n  private readonly halfOpenMaxAttempts: number;\n  private readonly staleThresholdMs: number;\n  private readonly keyStrategy: 'resolved' | 'template';\n  private cleanupTimer: ReturnType<typeof setInterval> | null = null;\n  private client: ApiClient | null = null;\n\n  setClient(client: ApiClient | null): void {\n    this.client = client;\n  }\n\n  constructor(config: CircuitBreakerConfig = {}) {\n    this.failureThreshold = config.failureThreshold ?? 5;\n    this.resetTimeoutMs = config.resetTimeoutMs ?? 30_000;\n    this.halfOpenMaxAttempts = config.halfOpenMaxAttempts ?? 1;\n    this.staleThresholdMs = config.staleThresholdMs ?? 3_600_000;\n    this.keyStrategy = config.keyStrategy ?? 'resolved';\n\n    const cleanupIntervalMs = config.cleanupIntervalMs;\n    if (cleanupIntervalMs !== undefined && cleanupIntervalMs > 0) {\n      this.startCleanupTimer(cleanupIntervalMs);\n    }\n  }\n\n  private getKey(endpoint: string): string {\n    return endpoint.split('?')[0]!;\n  }\n\n  private getOrCreate(key: string): CircuitRecord {\n    let record = this.circuits.get(key);\n    if (!record) {\n      record = {\n        state: 'closed',\n        failures: 0,\n        lastFailureTime: 0,\n        halfOpenAttempts: 0,\n      };\n      this.circuits.set(key, record);\n    }\n    return record;\n  }\n\n  checkCircuit(endpoint: string): void {\n    const key = this.getKey(endpoint);\n    const record = this.getOrCreate(key);\n\n    if (record.state === 'closed') return;\n\n    if (record.state === 'open') {\n      const elapsed = Date.now() - record.lastFailureTime;\n      if (elapsed >= this.resetTimeoutMs) {\n        record.state = 'half-open';\n        // This call is the first probe, so it counts towards halfOpenMaxAttempts.\n        record.halfOpenAttempts = 1;\n        logInfo(\n          this.client,\n          `Circuit half-open for ${key}, allowing probe request`,\n          { key },\n        );\n        return;\n      }\n      const remainingMs = this.resetTimeoutMs - elapsed;\n      throw new CircuitOpenError(key, record.failures, remainingMs);\n    }\n\n    if (record.state === 'half-open') {\n      if (record.halfOpenAttempts >= this.halfOpenMaxAttempts) {\n        throw new CircuitOpenError(key, record.failures, this.resetTimeoutMs);\n      }\n      record.halfOpenAttempts++;\n    }\n  }\n\n  recordSuccess(endpoint: string): void {\n    const key = this.getKey(endpoint);\n    const record = this.circuits.get(key);\n    if (!record) return;\n\n    // A success while open comes from a call admitted before the circuit\n    // opened. Only a half-open probe may close the circuit.\n    if (record.state === 'open') return;\n\n    if (record.state === 'half-open') {\n      logInfo(this.client, `Circuit closed for ${key} after successful probe`, {\n        key,\n      });\n    }\n\n    record.state = 'closed';\n    record.failures = 0;\n    record.halfOpenAttempts = 0;\n  }\n\n  recordFailure(endpoint: string, statusCode: number): void {\n    // statusCode 0 = network/timeout; 420/429 = rate limited; >=500 = server errors\n    if (\n      statusCode !== 0 &&\n      statusCode < 500 &&\n      statusCode !== 420 &&\n      statusCode !== 429\n    ) {\n      return;\n    }\n\n    const key = this.getKey(endpoint);\n    const record = this.getOrCreate(key);\n\n    record.failures++;\n    record.lastFailureTime = Date.now();\n\n    if (record.state === 'half-open') {\n      record.state = 'open';\n      logWarn(\n        this.client,\n        `Circuit re-opened for ${key} after failed probe (${record.failures} failures)`,\n        { key, failures: record.failures },\n      );\n      return;\n    }\n\n    if (record.failures >= this.failureThreshold) {\n      record.state = 'open';\n      logWarn(\n        this.client,\n        `Circuit opened for ${key} after ${record.failures} consecutive failures`,\n        { key, failures: record.failures },\n      );\n    }\n  }\n\n  getState(endpoint: string): CircuitState {\n    const key = this.getKey(endpoint);\n    const record = this.circuits.get(key);\n    if (!record) return 'closed';\n\n    if (record.state === 'open') {\n      const elapsed = Date.now() - record.lastFailureTime;\n      if (elapsed >= this.resetTimeoutMs) {\n        return 'half-open';\n      }\n    }\n\n    return record.state;\n  }\n\n  getStats(): {\n    totalCircuits: number;\n    openCircuits: number;\n    circuits: Record<string, { state: CircuitState; failures: number }>;\n  } {\n    const circuits: Record<string, { state: CircuitState; failures: number }> =\n      {};\n    let openCircuits = 0;\n\n    for (const [key, record] of this.circuits.entries()) {\n      const state = this.getState(key);\n      // eslint-disable-next-line security/detect-object-injection\n      circuits[key] = { state, failures: record.failures };\n      if (state === 'open') openCircuits++;\n    }\n\n    return {\n      totalCircuits: this.circuits.size,\n      openCircuits,\n      circuits,\n    };\n  }\n\n  reset(endpoint?: string): void {\n    if (endpoint) {\n      this.circuits.delete(this.getKey(endpoint));\n    } else {\n      this.circuits.clear();\n    }\n  }\n\n  cleanup(): number {\n    const now = Date.now();\n    let cleaned = 0;\n    for (const [key, record] of this.circuits.entries()) {\n      if (\n        record.state === 'closed' &&\n        record.failures === 0 &&\n        record.lastFailureTime > 0 &&\n        now - record.lastFailureTime > this.staleThresholdMs\n      ) {\n        this.circuits.delete(key);\n        cleaned++;\n      }\n    }\n    if (cleaned > 0) {\n      logInfo(\n        this.client,\n        `Circuit breaker cleanup: removed ${cleaned} stale circuits`,\n        {\n          cleaned,\n        },\n      );\n    }\n    return cleaned;\n  }\n\n  getKeyStrategy(): 'resolved' | 'template' {\n    return this.keyStrategy;\n  }\n\n  destroy(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = null;\n    }\n    this.circuits.clear();\n  }\n\n  shutdown(): void {\n    this.destroy();\n  }\n\n  private startCleanupTimer(intervalMs: number): void {\n    this.cleanupTimer = setInterval(() => {\n      this.cleanup();\n    }, intervalMs);\n    // Don't prevent process exit (important for test runners and CLI tools)\n    this.cleanupTimer.unref();\n  }\n}\n\nexport class CircuitOpenError extends Error {\n  readonly endpoint: string;\n  readonly failures: number;\n  readonly retryAfterMs: number;\n\n  constructor(endpoint: string, failures: number, retryAfterMs: number) {\n    super(\n      `Circuit breaker open for ${endpoint} after ${failures} failures (retry after ${Math.ceil(retryAfterMs / 1000)}s)`,\n    );\n    this.name = 'CircuitOpenError';\n    this.endpoint = endpoint;\n    this.failures = failures;\n    this.retryAfterMs = retryAfterMs;\n  }\n}\n","const SENSITIVE_PARAMS = [\n  'token',\n  'access_token',\n  'api_key',\n  'refresh_token',\n  'client_secret',\n  'code',\n  'key',\n  'secret',\n  'auth',\n  'password',\n  'bearer',\n];\n\nexport function sanitizeUrl(url?: string): string | undefined {\n  if (!url) return url;\n  try {\n    const parsed = new URL(url);\n    for (const param of SENSITIVE_PARAMS) {\n      if (parsed.searchParams.has(param)) {\n        parsed.searchParams.set(param, '[REDACTED]');\n      }\n    }\n    return parsed.toString();\n  } catch {\n    const qIndex = url.indexOf('?');\n    return qIndex >= 0 ? url.substring(0, qIndex) + '?[params-redacted]' : url;\n  }\n}\n\nexport class EsiError extends Error {\n  public readonly url?: string;\n\n  constructor(\n    public readonly statusCode: number,\n    message: string,\n    url?: string,\n    public readonly requestId?: string,\n  ) {\n    super(message);\n    this.name = 'EsiError';\n    this.url = sanitizeUrl(url);\n  }\n\n  isRateLimited(): boolean {\n    return this.statusCode === 420 || this.statusCode === 429;\n  }\n\n  isNotFound(): boolean {\n    return this.statusCode === 404;\n  }\n\n  isUnauthorized(): boolean {\n    return this.statusCode === 401;\n  }\n\n  isForbidden(): boolean {\n    return this.statusCode === 403;\n  }\n\n  isServerError(): boolean {\n    return this.statusCode >= 500;\n  }\n\n  isTimeout(): boolean {\n    return this.statusCode === 0;\n  }\n\n  get retryable(): boolean {\n    return (\n      this.statusCode === 0 ||\n      this.statusCode === 420 ||\n      this.statusCode === 429 ||\n      this.statusCode === 502 ||\n      this.statusCode === 503 ||\n      this.statusCode === 504\n    );\n  }\n}\n\nexport function isEsiError(error: unknown): error is EsiError {\n  return error instanceof EsiError;\n}\n\nexport function isRateLimited(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isRateLimited();\n}\n\nexport function isNotFound(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isNotFound();\n}\n\nexport function isUnauthorized(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isUnauthorized();\n}\n\nexport function isForbidden(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isForbidden();\n}\n\nexport function isServerError(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.isServerError();\n}\n\nexport class TimeoutError extends EsiError {\n  constructor(\n    public readonly timeoutMs: number,\n    url?: string,\n    requestId?: string,\n  ) {\n    super(0, `Request timed out after ${timeoutMs}ms`, url, requestId);\n    this.name = 'TimeoutError';\n  }\n}\n\nexport function isTimeout(error: unknown): error is TimeoutError {\n  return error instanceof TimeoutError;\n}\n\nexport function isRetryable(error: unknown): error is EsiError {\n  return error instanceof EsiError && error.retryable;\n}\n\n// Re-export CircuitOpenError for the type guard — avoid forcing consumers\n// to import from the circuitBreaker subpath just for error checking.\nimport { CircuitOpenError } from '../circuitBreaker/CircuitBreaker';\n\nexport function isCircuitOpen(error: unknown): error is CircuitOpenError {\n  return error instanceof CircuitOpenError;\n}\n\nexport const buildError = (\n  message: string,\n  type: string = 'ERROR',\n  url?: string,\n): Error => {\n  const error = new Error(`[${type}] ${message}`);\n  if (url) {\n    (error as Error & { url: string }).url = url;\n  }\n  return error;\n};\n\nexport type ValidationDirection = 'request' | 'response';\n\nexport class EsiValidationError extends EsiError {\n  public readonly validationError: unknown;\n  public readonly direction: ValidationDirection;\n\n  constructor(\n    url: string,\n    zodError: unknown,\n    requestId?: string,\n    direction: ValidationDirection = 'response',\n  ) {\n    const safeUrl = sanitizeUrl(url) ?? url;\n    const label = direction === 'request' ? 'Request body' : 'Response';\n    super(0, `${label} validation failed for ${safeUrl}`, url, requestId);\n    this.name = 'EsiValidationError';\n    this.validationError = zodError;\n    this.direction = direction;\n  }\n}\n\nexport function isValidationError(error: unknown): error is EsiValidationError {\n  return error instanceof EsiValidationError;\n}\n"]}

package/dist/clients/AccessListsClient.d.mts

@@ -0,0 +1,25 @@
+import { ApiClient } from '../core/ApiClient.mjs';
+import { BaseEsiClient } from './BaseEsiClient.mjs';
+import { accessListEndpoints } from '../core/endpoints/accessListEndpoints.mjs';
+import { AccessList } from '../types/api-responses.mjs';
+export declare class AccessListsClient extends BaseEsiClient<typeof accessListEndpoints> {
+    constructor(client: ApiClient);
+    /**
+     * Retrieves the contents of an access list (ACL) including all character, corporation, and alliance entries.
+     *
+     * @param characterId - The ID of the character who owns the access list
+     * @param accessListId - The ID of the access list to retrieve
+     * @returns The access list with its entries
+     * @requires Authentication
+     */
+    getAccessList(characterId: number, accessListId: number): Promise<AccessList>;
+    /**
+     * Retrieves all access lists for a character.
+     *
+     * @param characterId - The ID of the character
+     * @returns An array of the character's access lists
+     * @requires Authentication
+     */
+    getCharacterAccessLists(characterId: number): Promise<AccessList[]>;
+}
+//# sourceMappingURL=AccessListsClient.d.ts.map

package/dist/clients/AllianceClient.d.mts

@@ -0,0 +1,59 @@
+import { ApiClient } from '../core/ApiClient.mjs';
+import { BaseEsiClient } from './BaseEsiClient.mjs';
+import { allianceEndpoints } from '../core/endpoints/allianceEndpoints.mjs';
+import { AllianceInfo, AllianceContact, AllianceContactLabel, AllianceIcon } from '../types/api-responses.mjs';
+import { PageResult } from '../core/pagination/AsyncPaginationIterator.mjs';
+export declare class AllianceClient extends BaseEsiClient<typeof allianceEndpoints> {
+    private contactApi;
+    constructor(client: ApiClient);
+    /**
+     * Retrieve public information about an alliance.
+     *
+     * @param allianceId - The ID of the alliance to look up
+     * @returns Public alliance information including name, ticker, and founding date
+     */
+    getAllianceById(allianceId: number): Promise<AllianceInfo>;
+    /**
+     * Retrieve contacts for an alliance.
+     *
+     * @deprecated Use ContactsClient.getAllianceContacts() instead
+     * @param allianceId - The ID of the alliance whose contacts to retrieve
+     * @returns A list of alliance contacts with standings and contact types
+     * @requires Authentication
+     */
+    getContacts(allianceId: number): Promise<AllianceContact[]>;
+    /**
+     * Retrieve custom contact labels for an alliance.
+     *
+     * @deprecated Use ContactsClient.getAllianceContactLabels() instead
+     * @param allianceId - The ID of the alliance whose contact labels to retrieve
+     * @returns A list of custom labels used to categorize alliance contacts
+     * @requires Authentication
+     */
+    getContactLabels(allianceId: number): Promise<AllianceContactLabel[]>;
+    /**
+     * Retrieve the list of corporation IDs that are members of an alliance.
+     *
+     * @param allianceId - The ID of the alliance whose member corporations to retrieve
+     * @returns An array of corporation IDs belonging to the alliance
+     */
+    getCorporations(allianceId: number): Promise<number[]>;
+    /**
+     * Retrieve icon URLs for an alliance.
+     *
+     * @param allianceId - The ID of the alliance whose icons to retrieve
+     * @returns Icon URLs at various resolutions for the alliance
+     */
+    getIcons(allianceId: number): Promise<AllianceIcon>;
+    /**
+     * Retrieve a list of all active alliance IDs in EVE Online.
+     *
+     * @returns An array of all active alliance IDs
+     */
+    getAlliances(): Promise<number[]>;
+    fetchAllAlliances(concurrency?: number): Promise<number[]>;
+    fetchAllCorporations(allianceId: number, concurrency?: number): Promise<number[]>;
+    streamAlliances(): AsyncGenerator<PageResult<number>, void, undefined>;
+    streamCorporations(allianceId: number): AsyncGenerator<PageResult<number>, void, undefined>;
+}
+//# sourceMappingURL=AllianceClient.d.ts.map