@lgriffin/esi.ts 10.2.0 → 11.0.0

package/dist/core/logger/ILogger.d.mts

@@ -6,6 +6,8 @@
 export interface LogContext {
     [key: string]: unknown;
 }
+/** The six levels an `ILogger` accepts. */
+export type LoggerLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
 export interface ILogger {
     fatal(message: string, context?: LogContext): void;
     error(message: string, context?: LogContext): void;
@@ -13,5 +15,12 @@ export interface ILogger {
     info(message: string, context?: LogContext): void;
     debug(message: string, context?: LogContext): void;
     trace(message: string, context?: LogContext): void;
+    /**
+     * Optional. When it returns `false` for a level, the library skips that
+     * line before building it, so a disabled level costs nothing, including
+     * the URL redaction every line otherwise goes through. Loggers without it
+     * receive every line and filter it themselves.
+     */
+    isLevelEnabled?(level: LoggerLevel): boolean;
 }
 //# sourceMappingURL=ILogger.d.ts.map

package/dist/core/logger/ILogger.d.ts

@@ -6,6 +6,8 @@
 export interface LogContext {
     [key: string]: unknown;
 }
+/** The six levels an `ILogger` accepts. */
+export type LoggerLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
 export interface ILogger {
     fatal(message: string, context?: LogContext): void;
     error(message: string, context?: LogContext): void;
@@ -13,5 +15,12 @@ export interface ILogger {
     info(message: string, context?: LogContext): void;
     debug(message: string, context?: LogContext): void;
     trace(message: string, context?: LogContext): void;
+    /**
+     * Optional. When it returns `false` for a level, the library skips that
+     * line before building it, so a disabled level costs nothing, including
+     * the URL redaction every line otherwise goes through. Loggers without it
+     * receive every line and filter it themselves.
+     */
+    isLevelEnabled?(level: LoggerLevel): boolean;
 }
 //# sourceMappingURL=ILogger.d.ts.map

package/dist/core/logger/ILogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../../src/core/logger/ILogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAClD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACpD"}
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../../src/core/logger/ILogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GACrB,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAClD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD;;;;;OAKG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;CAC9C"}

package/dist/core/logger/NoopLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NoopLogger.d.ts","sourceRoot":"","sources":["../../../src/core/logger/NoopLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}
+{"version":3,"file":"NoopLogger.d.ts","sourceRoot":"","sources":["../../../src/core/logger/NoopLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/dist/core/logger/clientLog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clientLog.d.ts","sourceRoot":"","sources":["../../../src/core/logger/clientLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAK5C,KAAK,IAAI,GAAG,CACV,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,KACjB,IAAI,CAAC;AAWV,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC;AAC5C,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC;AAC5C,eAAO,MAAM,OAAO,EAAE,IAAmB,CAAC;AAC1C,eAAO,MAAM,OAAO,EAAE,IAAmB,CAAC;AAC1C,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC;AAC5C,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC"}
+{"version":3,"file":"clientLog.d.ts","sourceRoot":"","sources":["../../../src/core/logger/clientLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,WAAW,CAAC;AAIlE,KAAK,IAAI,GAAG,CACV,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,KACjB,IAAI,CAAC;AAgBV,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC;AAC5C,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC;AAC5C,eAAO,MAAM,OAAO,EAAE,IAAmB,CAAC;AAC1C,eAAO,MAAM,OAAO,EAAE,IAAmB,CAAC;AAC1C,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC;AAC5C,eAAO,MAAM,QAAQ,EAAE,IAAoB,CAAC"}

package/dist/core/logger/loggerUtil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loggerUtil.d.ts","sourceRoot":"","sources":["../../../src/core/logger/loggerUtil.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGrD,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAcrD,eAAO,MAAM,SAAS,GAAI,cAAc,OAAO,KAAG,IAEjD,CAAC;AAEF,eAAO,MAAM,SAAS,QAAO,OAAuB,CAAC;AAKrD,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,UAAU,KAAG,IAEhE,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,UAAU,KAAG,IAEhE,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,UAAU,UAAU,KAAG,IAE/D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,UAAU,UAAU,KAAG,IAE/D,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,UAAU,KAAG,IAEhE,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,UAAU,KAAG,IAEhE,CAAC"}
+{"version":3,"file":"loggerUtil.d.ts","sourceRoot":"","sources":["../../../src/core/logger/loggerUtil.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,WAAW,CAAC;AAIlE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAcrD,eAAO,MAAM,SAAS,GAAI,cAAc,OAAO,KAAG,IAEjD,CAAC;AAEF,eAAO,MAAM,SAAS,QAAO,OAAuB,CAAC;AASrD,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,IACnD,CAAC;AAEhB,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,IACnD,CAAC;AAEhB,eAAO,MAAM,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,IACnD,CAAC;AAEf,eAAO,MAAM,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,IACnD,CAAC;AAEf,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,IACnD,CAAC;AAEhB,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,IACnD,CAAC"}

package/dist/core/logger/redactLog.d.ts

@@ -0,0 +1,23 @@
+import type { ILogger, LogContext } from './ILogger';
+/**
+ * Redact the sensitive query parameters of every URL in a piece of log text,
+ * matching the names `sanitizeUrl` redacts. It works on the text itself
+ * rather than parsing each URL, so URLs next to punctuation, relative and
+ * protocol-relative paths, and URLs `new URL` rejects are all covered, and
+ * everything else in the line keeps its exact wording.
+ */
+export declare function redactLogText(text: string): string;
+/**
+ * Redact the log context: every top-level string value (a `url`, an
+ * `endpoint`, a path) passes through the same URL redaction as the message.
+ * Returns `undefined` for a missing or empty context so a logger never
+ * receives `{}`.
+ */
+export declare function redactLogContext(context: LogContext | undefined): LogContext | undefined;
+/**
+ * A view of a logger that skips disabled levels and redacts each line the
+ * way the pipeline's log helpers do, for code that holds a logger directly
+ * rather than logging through a client.
+ */
+export declare function redactingLogger(logger: ILogger): ILogger;
+//# sourceMappingURL=redactLog.d.ts.map

package/dist/core/logger/redactLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactLog.d.ts","sourceRoot":"","sources":["../../../src/core/logger/redactLog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,WAAW,CAAC;AAYlE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,GAAG,SAAS,GAC9B,UAAU,GAAG,SAAS,CAQxB;AAuBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAiBxD"}

package/dist/core/logger/resolveLogger.d.ts

@@ -1,8 +1,8 @@
 import type { ILogger } from './ILogger';
 /**
- * Resolve the logger for a given API client: per-client logger first,
- * global (via `setLogger`) if a non-default one was installed, then the
- * built-in pino default.
+ * Resolve the logger for a given API client: per-client logger first, then
+ * the global one — a logger installed with `setLogger`, or the built-in pino
+ * default when none was.
  */
 export declare function resolveLogger(client: {
     getLogger?: () => ILogger | null;

package/dist/core/logger/resolveLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveLogger.d.ts","sourceRoot":"","sources":["../../../src/core/logger/resolveLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAC9D,OAAO,CAMT"}
+{"version":3,"file":"resolveLogger.d.ts","sourceRoot":"","sources":["../../../src/core/logger/resolveLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAC9D,OAAO,CAET"}

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

@@ -1 +1 @@
-{"version":3,"file":"AsyncPaginationIterator.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/AsyncPaginationIterator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,cAAc,GAAG,WAAW,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAsBxE,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,OAAe,EAC7B,IAAI,CAAC,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,cAAc,EAC/B,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC,CA8Dd;AAED,wBAAuB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,OAAe,EAC7B,IAAI,CAAC,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAmDhD"}
+{"version":3,"file":"AsyncPaginationIterator.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/AsyncPaginationIterator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,cAAc,GAAG,WAAW,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAsBxE,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,OAAe,EAC7B,IAAI,CAAC,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,cAAc,EAC/B,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC,CA+Dd;AAED,wBAAuB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,OAAe,EAC7B,IAAI,CAAC,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAmDhD"}

package/dist/core/pagination/CursorPaginationHandler.d.mts

@@ -46,7 +46,8 @@ export declare class CursorPaginationHandler {
     /**
      * Auto-fetch all pages by following `after` tokens until an empty
      * response is received.  Combines the caller-supplied first page
-     * data with all subsequent pages.
+     * data with all subsequent pages. After three consecutive failed
+     * pages it throws rather than return a partial dataset (DES-08).
      */
     static fetchAll(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], firstCursors: CursorTokens, body?: unknown, options?: CursorPaginationOptions, pageFetch?: CursorPageFetcher): Promise<unknown[]>;
     /**

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

@@ -46,7 +46,8 @@ export declare class CursorPaginationHandler {
     /**
      * Auto-fetch all pages by following `after` tokens until an empty
      * response is received.  Combines the caller-supplied first page
-     * data with all subsequent pages.
+     * data with all subsequent pages. After three consecutive failed
+     * pages it throws rather than return a partial dataset (DES-08).
      */
     static fetchAll(client: ApiClient, endpoint: string, method: string, requiresAuth: boolean, firstPageData: unknown[], firstCursors: CursorTokens, body?: unknown, options?: CursorPaginationOptions, pageFetch?: CursorPageFetcher): Promise<unknown[]>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"CursorPaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/CursorPaginationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAUzC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACzC,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAErC;IAEF;;;;;;OAMG;WACU,SAAS,CACpB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAyCtB;;;;OAIG;WACU,QAAQ,CACnB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,YAAY,EAAE,YAAY,EAC1B,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,OAAO,EAAE,CAAC;IAyErB;;;;;OAKG;mBACkB,kBAAkB;IAkCvC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAQrD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAiBvC"}
+{"version":3,"file":"CursorPaginationHandler.d.ts","sourceRoot":"","sources":["../../../src/core/pagination/CursorPaginationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAWzC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACzC,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAErC;IAEF;;;;;;OAMG;WACU,SAAS,CACpB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,UAAU,CAAC;IA2CtB;;;;;OAKG;WACU,QAAQ,CACnB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EAAE,EACxB,YAAY,EAAE,YAAY,EAC1B,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,OAAO,EAAE,CAAC;IAyErB;;;;;OAKG;mBACkB,kBAAkB;IAkCvC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAQrD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAiBvC"}

package/dist/core/ports/CacheStore.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Where conditional-request caching keeps response bodies and their ETags,
+ * keyed by request URL. `ETagCacheManager` is the in-memory implementation; a
+ * shared store (Redis, a file) implements the same five calls.
+ */
+export interface CachedResponse {
+    readonly etag: string;
+    readonly data: unknown;
+    readonly headers: Readonly<Record<string, string>>;
+    /** When the entry was written, in milliseconds since the epoch. */
+    readonly timestamp: number;
+    /**
+     * How long the store keeps the entry, in milliseconds, when not the store's
+     * default. This is retention, not freshness: the pipeline passes the
+     * response's freshness plus a stale-retention window, so the body stays
+     * available for `If-None-Match` revalidation and stale-on-error after it
+     * stops being fresh. A store drops the entry only once this has passed.
+     */
+    readonly ttl?: number;
+}
+export interface CacheStore {
+    /** The entry for `key`, or null when there is none or it has expired. */
+    get(key: string): CachedResponse | null;
+    set(key: string, etag: string, data: unknown, headers: Record<string, string>, 
+    /** Retention in milliseconds, as for `CachedResponse.ttl`. */
+    ttlMs?: number): void;
+    delete(key: string): boolean;
+    clear(): void;
+    /** Releases timers and connections; the store is not used afterwards. */
+    shutdown(): void;
+}
+//# sourceMappingURL=CacheStore.d.ts.map

package/dist/core/ports/CacheStore.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Where conditional-request caching keeps response bodies and their ETags,
+ * keyed by request URL. `ETagCacheManager` is the in-memory implementation; a
+ * shared store (Redis, a file) implements the same five calls.
+ */
+export interface CachedResponse {
+    readonly etag: string;
+    readonly data: unknown;
+    readonly headers: Readonly<Record<string, string>>;
+    /** When the entry was written, in milliseconds since the epoch. */
+    readonly timestamp: number;
+    /**
+     * How long the store keeps the entry, in milliseconds, when not the store's
+     * default. This is retention, not freshness: the pipeline passes the
+     * response's freshness plus a stale-retention window, so the body stays
+     * available for `If-None-Match` revalidation and stale-on-error after it
+     * stops being fresh. A store drops the entry only once this has passed.
+     */
+    readonly ttl?: number;
+}
+export interface CacheStore {
+    /** The entry for `key`, or null when there is none or it has expired. */
+    get(key: string): CachedResponse | null;
+    set(key: string, etag: string, data: unknown, headers: Record<string, string>, 
+    /** Retention in milliseconds, as for `CachedResponse.ttl`. */
+    ttlMs?: number): void;
+    delete(key: string): boolean;
+    clear(): void;
+    /** Releases timers and connections; the store is not used afterwards. */
+    shutdown(): void;
+}
+//# sourceMappingURL=CacheStore.d.ts.map

package/dist/core/ports/CacheStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheStore.d.ts","sourceRoot":"","sources":["../../../src/core/ports/CacheStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACxC,GAAG,CACD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAAC;IACR,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,yEAAyE;IACzE,QAAQ,IAAI,IAAI,CAAC;CAClB"}

package/dist/core/ports/Clock.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Time, as the pipeline sees it: rate-limit windows, cache expiry and retry
+ * back-off read and wait through this port, so a test can drive them with a
+ * fake clock instead of real timers. `systemClock` in src/core/clock.ts is the
+ * real one.
+ */
+export interface Clock {
+    /** Milliseconds since the epoch. */
+    now(): number;
+    /** Resolves after `ms` milliseconds. */
+    sleep(ms: number): Promise<void>;
+}
+//# sourceMappingURL=Clock.d.ts.map

package/dist/core/ports/Clock.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Time, as the pipeline sees it: rate-limit windows, cache expiry and retry
+ * back-off read and wait through this port, so a test can drive them with a
+ * fake clock instead of real timers. `systemClock` in src/core/clock.ts is the
+ * real one.
+ */
+export interface Clock {
+    /** Milliseconds since the epoch. */
+    now(): number;
+    /** Resolves after `ms` milliseconds. */
+    sleep(ms: number): Promise<void>;
+}
+//# sourceMappingURL=Clock.d.ts.map

package/dist/core/ports/Clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../../src/core/ports/Clock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,oCAAoC;IACpC,GAAG,IAAI,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC"}

package/dist/core/ports/HttpTransport.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Sends one HTTP request. `fetch` is the default; a proxy agent, a recording
+ * transport or a test double implements the same signature. The same shape as
+ * the `FetchLike` accepted by `ApiClient.setFetch`.
+ */
+export type HttpTransport = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=HttpTransport.d.ts.map

package/dist/core/ports/HttpTransport.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sends one HTTP request. `fetch` is the default; a proxy agent, a recording
+ * transport or a test double implements the same signature. The same shape as
+ * the `FetchLike` accepted by `ApiClient.setFetch`.
+ */
+export type HttpTransport = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=HttpTransport.d.ts.map

package/dist/core/ports/HttpTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpTransport.d.ts","sourceRoot":"","sources":["../../../src/core/ports/HttpTransport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/dist/core/ports/Identity.d.mts

@@ -0,0 +1,31 @@
+/**
+ * Who a request is made as: the source of the bearer token a view of the
+ * shared runtime sends, and of the replacement after ESI rejects one.
+ *
+ * `esi.as(identity)` takes one of these. `EsiTokenManager.identity(id)`
+ * builds one over a stored character; `identityFromToken` wraps a raw
+ * access token; `identityFromProvider` wraps a `TokenProvider`. Anything
+ * with these members works, so a session store or a secrets manager can
+ * implement it directly.
+ */
+export interface Identity {
+    /**
+     * The EVE character the tokens belong to, when the holder knows it. For
+     * diagnostics only: the pipeline keys its cache by the character the token
+     * itself names, so a wrong value here misleads nobody but a log reader.
+     */
+    readonly characterId?: number;
+    /**
+     * The access token to send now. Asked before every request, so a holder
+     * that knows its token is about to expire refreshes first and hands out the
+     * new one; a holder that cannot know returns what it has.
+     */
+    accessToken(): Promise<string>;
+    /**
+     * A new access token after ESI answered 401 to the current one. Left out
+     * when the identity cannot refresh (a raw token): the 401 is then the
+     * caller's answer, after a single request.
+     */
+    refreshAccessToken?(): Promise<string>;
+}
+//# sourceMappingURL=Identity.d.ts.map

package/dist/core/ports/Identity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Who a request is made as: the source of the bearer token a view of the
+ * shared runtime sends, and of the replacement after ESI rejects one.
+ *
+ * `esi.as(identity)` takes one of these. `EsiTokenManager.identity(id)`
+ * builds one over a stored character; `identityFromToken` wraps a raw
+ * access token; `identityFromProvider` wraps a `TokenProvider`. Anything
+ * with these members works, so a session store or a secrets manager can
+ * implement it directly.
+ */
+export interface Identity {
+    /**
+     * The EVE character the tokens belong to, when the holder knows it. For
+     * diagnostics only: the pipeline keys its cache by the character the token
+     * itself names, so a wrong value here misleads nobody but a log reader.
+     */
+    readonly characterId?: number;
+    /**
+     * The access token to send now. Asked before every request, so a holder
+     * that knows its token is about to expire refreshes first and hands out the
+     * new one; a holder that cannot know returns what it has.
+     */
+    accessToken(): Promise<string>;
+    /**
+     * A new access token after ESI answered 401 to the current one. Left out
+     * when the identity cannot refresh (a raw token): the 401 is then the
+     * caller's answer, after a single request.
+     */
+    refreshAccessToken?(): Promise<string>;
+}
+//# sourceMappingURL=Identity.d.ts.map

package/dist/core/ports/Identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Identity.d.ts","sourceRoot":"","sources":["../../../src/core/ports/Identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC"}

package/dist/core/ports/Logger.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Where the pipeline writes its log events. The package's pino-backed logger
+ * implements it, and so does any object with these six methods.
+ */
+/** Structured fields attached to one log event (endpoint, status, and so on). */
+export interface LogFields {
+    [key: string]: unknown;
+}
+export interface Logger {
+    fatal(message: string, fields?: LogFields): void;
+    error(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    debug(message: string, fields?: LogFields): void;
+    trace(message: string, fields?: LogFields): void;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/core/ports/Logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Where the pipeline writes its log events. The package's pino-backed logger
+ * implements it, and so does any object with these six methods.
+ */
+/** Structured fields attached to one log event (endpoint, status, and so on). */
+export interface LogFields {
+    [key: string]: unknown;
+}
+export interface Logger {
+    fatal(message: string, fields?: LogFields): void;
+    error(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    debug(message: string, fields?: LogFields): void;
+    trace(message: string, fields?: LogFields): void;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/core/ports/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/core/ports/Logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAClD"}

package/dist/core/ports/OperationTransport.d.mts

@@ -0,0 +1,42 @@
+/**
+ * The one seam generated operations (`src/generated/`) call.
+ * `src/adapters/PipelineTransport` backs it with the existing request pipeline
+ * (cache, auth, retry, rate limiter). Neither is exported yet: the new client
+ * tree (Phase 2 PR 11) is their first public caller.
+ */
+/** How an operation splits its results across calls. */
+export type OperationPagination = 'none' | 'page' | 'cursor';
+export interface OperationMeta {
+    readonly operationId: string;
+    readonly method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** Path template with `{name}` placeholders, as in the spec. */
+    readonly path: string;
+    /** SSO scopes the spec's security block requires; empty for public routes. */
+    readonly scopes: readonly string[];
+    /**
+     * `page`: numbered pages counted by `X-Pages`. `cursor`: `before`/`after`
+     * tokens in the response body.
+     */
+    readonly pagination: OperationPagination;
+    /** The spec marks the operation `deprecated: true`. */
+    readonly deprecated: boolean;
+    /**
+     * Header parameters the spec accepts (`X-Compatibility-Date`, `X-Tenant`,
+     * `If-None-Match` and so on). They are client configuration, not call
+     * arguments: the transport supplies them.
+     */
+    readonly headers: readonly string[];
+}
+/** Every shape a spec query parameter takes: scalars and arrays of them. */
+export type QueryValue = string | number | boolean | readonly (string | number | boolean)[];
+export interface OperationRequest {
+    readonly path: Readonly<Record<string, string | number>>;
+    readonly query: Readonly<Record<string, QueryValue | undefined>>;
+    readonly body?: unknown;
+}
+export interface OperationTransport {
+    request<T>(meta: OperationMeta, req: OperationRequest): Promise<T>;
+    /** Follows `X-Pages`; yields one item at a time across every page. */
+    paginate<T>(meta: OperationMeta, req: OperationRequest): AsyncIterable<T>;
+}
+//# sourceMappingURL=OperationTransport.d.ts.map

package/dist/core/ports/OperationTransport.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The one seam generated operations (`src/generated/`) call.
+ * `src/adapters/PipelineTransport` backs it with the existing request pipeline
+ * (cache, auth, retry, rate limiter). Neither is exported yet: the new client
+ * tree (Phase 2 PR 11) is their first public caller.
+ */
+/** How an operation splits its results across calls. */
+export type OperationPagination = 'none' | 'page' | 'cursor';
+export interface OperationMeta {
+    readonly operationId: string;
+    readonly method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** Path template with `{name}` placeholders, as in the spec. */
+    readonly path: string;
+    /** SSO scopes the spec's security block requires; empty for public routes. */
+    readonly scopes: readonly string[];
+    /**
+     * `page`: numbered pages counted by `X-Pages`. `cursor`: `before`/`after`
+     * tokens in the response body.
+     */
+    readonly pagination: OperationPagination;
+    /** The spec marks the operation `deprecated: true`. */
+    readonly deprecated: boolean;
+    /**
+     * Header parameters the spec accepts (`X-Compatibility-Date`, `X-Tenant`,
+     * `If-None-Match` and so on). They are client configuration, not call
+     * arguments: the transport supplies them.
+     */
+    readonly headers: readonly string[];
+}
+/** Every shape a spec query parameter takes: scalars and arrays of them. */
+export type QueryValue = string | number | boolean | readonly (string | number | boolean)[];
+export interface OperationRequest {
+    readonly path: Readonly<Record<string, string | number>>;
+    readonly query: Readonly<Record<string, QueryValue | undefined>>;
+    readonly body?: unknown;
+}
+export interface OperationTransport {
+    request<T>(meta: OperationMeta, req: OperationRequest): Promise<T>;
+    /** Follows `X-Pages`; yields one item at a time across every page. */
+    paginate<T>(meta: OperationMeta, req: OperationRequest): AsyncIterable<T>;
+}
+//# sourceMappingURL=OperationTransport.d.ts.map

package/dist/core/ports/OperationTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationTransport.d.ts","sourceRoot":"","sources":["../../../src/core/ports/OperationTransport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IACnD,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GACpB,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,sEAAsE;IACtE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;CAC3E"}

package/dist/core/ports/TokenProvider.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Supplies an access token for authenticated requests. Called when a request
+ * needs a token and after a 401, so it returns the current token, refreshing
+ * it first when it has expired. The same shape as the `onTokenRefresh` option.
+ */
+export type TokenProvider = () => Promise<string>;
+//# sourceMappingURL=TokenProvider.d.ts.map

package/dist/core/ports/TokenProvider.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Supplies an access token for authenticated requests. Called when a request
+ * needs a token and after a 401, so it returns the current token, refreshing
+ * it first when it has expired. The same shape as the `onTokenRefresh` option.
+ */
+export type TokenProvider = () => Promise<string>;
+//# sourceMappingURL=TokenProvider.d.ts.map

package/dist/core/ports/TokenProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenProvider.d.ts","sourceRoot":"","sources":["../../../src/core/ports/TokenProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC"}

package/dist/core/ports/index.d.mts

@@ -0,0 +1,14 @@
+/**
+ * The ports: the seams the pipeline talks to, and the only things a new
+ * adapter or the builder in a later Phase 2 PR needs to implement. They
+ * import nothing (the layer rule enforces it). The `./client` entry exports
+ * them.
+ */
+export type { CacheStore, CachedResponse } from './CacheStore.mjs';
+export type { Clock } from './Clock.mjs';
+export type { HttpTransport } from './HttpTransport.mjs';
+export type { Identity } from './Identity.mjs';
+export type { LogFields, Logger } from './Logger.mjs';
+export type { OperationMeta, OperationPagination, OperationRequest, OperationTransport, QueryValue, } from './OperationTransport.mjs';
+export type { TokenProvider } from './TokenProvider.mjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ports/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The ports: the seams the pipeline talks to, and the only things a new
+ * adapter or the builder in a later Phase 2 PR needs to implement. They
+ * import nothing (the layer rule enforces it). The `./client` entry exports
+ * them.
+ */
+export type { CacheStore, CachedResponse } from './CacheStore';
+export type { Clock } from './Clock';
+export type { HttpTransport } from './HttpTransport';
+export type { Identity } from './Identity';
+export type { LogFields, Logger } from './Logger';
+export type { OperationMeta, OperationPagination, OperationRequest, OperationTransport, QueryValue, } from './OperationTransport';
+export type { TokenProvider } from './TokenProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ports/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -1,4 +1,5 @@
 import { IRateLimiter, RateLimitGroupStatus } from './IRateLimiter.mjs';
+import type { ApiClient } from '../ApiClient.mjs';
 export interface RateLimitInfo {
     remaining: number;
     limit: number;
@@ -14,10 +15,10 @@ export interface RateLimitEndpointOverride {
     windowSizeMs: number;
 }
 export interface RateLimiterConfig {
-    minDelayMs?: number;
-    decelerationThreshold?: number;
-    userKeyExtractor?: (headers: Record<string, string>) => string;
-    endpointOverrides?: Record<string, RateLimitEndpointOverride>;
+    minDelayMs?: number | undefined;
+    decelerationThreshold?: number | undefined;
+    userKeyExtractor?: ((headers: Record<string, string>) => string) | undefined;
+    endpointOverrides?: Record<string, RateLimitEndpointOverride> | undefined;
 }
 export declare class RateLimiter implements IRateLimiter {
     private readonly minDelayMs;
@@ -33,6 +34,12 @@ export declare class RateLimiter implements IRateLimiter {
     private fallbackBucket;
     private lastCleanup;
     private static readonly CLEANUP_INTERVAL_MS;
+    private client;
+    /**
+     * Attach the client whose logger this limiter's warnings go to. Without
+     * one they go to the global logger (`setLogger`), then the pino default.
+     */
+    setClient(client: ApiClient | null): void;
     constructor(config?: RateLimiterConfig);
     private createFallbackBucket;
     private createBucketFromSpec;

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

@@ -1,4 +1,5 @@
 import { IRateLimiter, RateLimitGroupStatus } from './IRateLimiter';
+import type { ApiClient } from '../ApiClient';
 export interface RateLimitInfo {
     remaining: number;
     limit: number;
@@ -14,10 +15,10 @@ export interface RateLimitEndpointOverride {
     windowSizeMs: number;
 }
 export interface RateLimiterConfig {
-    minDelayMs?: number;
-    decelerationThreshold?: number;
-    userKeyExtractor?: (headers: Record<string, string>) => string;
-    endpointOverrides?: Record<string, RateLimitEndpointOverride>;
+    minDelayMs?: number | undefined;
+    decelerationThreshold?: number | undefined;
+    userKeyExtractor?: ((headers: Record<string, string>) => string) | undefined;
+    endpointOverrides?: Record<string, RateLimitEndpointOverride> | undefined;
 }
 export declare class RateLimiter implements IRateLimiter {
     private readonly minDelayMs;
@@ -33,6 +34,12 @@ export declare class RateLimiter implements IRateLimiter {
     private fallbackBucket;
     private lastCleanup;
     private static readonly CLEANUP_INTERVAL_MS;
+    private client;
+    /**
+     * Attach the client whose logger this limiter's warnings go to. Without
+     * one they go to the global logger (`setLogger`), then the pino default.
+     */
+    setClient(client: ApiClient | null): void;
     constructor(config?: RateLimiterConfig);
     private createFallbackBucket;
     private createBucketFromSpec;