@cobre-npm/library-response-catalog-node 0.2.0 → 0.3.0

package/README.md

@@ -4,14 +4,14 @@ Node.js SDK that will resolve a supplier-reported error against Cobre's Response
 Read API (`GET /v1/resolve`). Callers send a supplier, domain, and error code; the catalog
 returns a localized frontend message plus internal metadata.
 
-This release adds the **domain contract** (`0.2.0`): the `Response` shape, the
-`SupplierErrorContext` builder, the `CatalogPort` outbound port, and
-`CatalogClientException`. There is no HTTP implementation yet — that lands in a later
-stacked PR on `Feature/BLCK-28319-*`.
-
-The finished client will own HTTP, retries, the circuit breaker, and — unlike
-[`library-response-catalog-java`](https://github.com/Cobre-Colombia/library-response-catalog-java)
-— a **local technical fallback** when the catalog is unavailable.
+As of `0.3.0` this package has the **domain contract** — the `Response` shape, the
+`SupplierErrorContext` builder, the `CatalogPort` outbound port, `CatalogClientError` —
+plus the **local fallback token map** that resolves a technical error to a locally
+known token instead of failing outright, unlike
+[`library-response-catalog-java`](https://github.com/Cobre-Colombia/library-response-catalog-java).
+There is still no HTTP implementation — that lands in a later stacked PR on
+`Feature/BLCK-28319-*`, which will wire the fallback map to `CatalogPort` and add
+retries and a circuit breaker.
 
 ## Install
 
@@ -23,23 +23,23 @@ Requires [pnpm](https://pnpm.io) `10.27.0` (see `packageManager` in `package.jso
 Same-cluster calls will need nothing else. Cross-cluster (`INTERNAL_GATEWAY`) will also
 need `@cobre-npm/library-nodejs-common`.
 
-## Public API (0.2.0)
+## Public API (0.3.0)
 
 | Export | Role |
 |---|---|
-| `LIBRARY_VERSION` | Package version string (`0.2.0`). Matches `package.json`. |
+| `LIBRARY_VERSION` | Package version string (`0.3.0`). Matches `package.json`. |
 | `buildSupplierErrorContext` | Validates and builds a `SupplierErrorContext` (`supplier`/`domain`/`code` required, `locale` optional). |
 | `SupplierErrorContext`, `SupplierErrorContextInput` | Validated context type and its raw input. |
 | `CatalogPort` | Outbound port: `fetchResponse(context): Promise<Response>`. |
 | `Response`, `SupplierInfo`, `InternalInfo`, `ApiInfo` | Resolved catalog entry: supplier/internal/api views plus the localized message. |
-| `CatalogClientException` | Thrown by a `CatalogPort` implementation. `isTransient()` / `isCredentialError()` classify the failure. |
+| `CatalogClientError` | Thrown by a `CatalogPort` implementation. `isTransient()` / `isCredentialError()` classify the failure. |
 
 ## Usage
 
 ```typescript
 import {
   buildSupplierErrorContext,
-  CatalogClientException,
+  CatalogClientError,
   CatalogPort,
 } from '@cobre-npm/library-response-catalog-node'
 
@@ -54,8 +54,8 @@ try {
   const response = await catalogPort.fetchResponse(context)
   console.log(response.resolvedMessage)
 } catch (error) {
-  if (error instanceof CatalogClientException && error.isTransient()) {
-    // safe to retry, or fall back locally once that layer ships
+  if (error instanceof CatalogClientError && error.isTransient()) {
+    // safe to retry, or fall back to a local token once the HTTP layer ships
   }
   throw error
 }

package/dist/adapter/http/axios-client.d.ts

@@ -0,0 +1,20 @@
+import { type AxiosInstance } from 'axios';
+export declare const DEFAULT_CONNECT_TIMEOUT_MS = 2000;
+export declare const DEFAULT_READ_TIMEOUT_MS = 5000;
+/**
+ * Builds the axios instance used for every resolve call.
+ *
+ * `validateStatus` accepts every status so the adapter, not axios, decides what
+ * an error status means. Keep-alive agents let retries and repeated calls reuse
+ * connections instead of paying a fresh handshake each time.
+ *
+ * @param options.connectTimeoutMs - Socket inactivity timeout applied to the agents
+ * @param options.readTimeoutMs - Overall request timeout
+ * @returns A configured axios instance
+ */
+export interface AxiosClientOptions {
+    readonly connectTimeoutMs: number;
+    readonly readTimeoutMs: number;
+}
+export declare const createAxiosClient: ({ connectTimeoutMs, readTimeoutMs }: AxiosClientOptions) => AxiosInstance;
+//# sourceMappingURL=axios-client.d.ts.map

package/dist/adapter/http/axios-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios-client.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/axios-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAA;AAIjD,eAAO,MAAM,0BAA0B,OAAQ,CAAA;AAC/C,eAAO,MAAM,uBAAuB,OAAQ,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,eAAO,MAAM,iBAAiB,GAC5B,qCAAqC,kBAAkB,KACtD,aASC,CAAA"}

package/dist/adapter/http/base-url.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Rejects a `baseUrl` that is not an absolute HTTP(S) URL, so a typo or a
+ * missing scheme fails when the client is created rather than surfacing later
+ * disguised as a network failure.
+ *
+ * Stricter than the Java library, which accepts any absolute URI: only `http:`
+ * and `https:` can reach the catalog over this adapter.
+ *
+ * @param baseUrl - The configured base URL
+ * @throws Error when the value is unparseable or uses another scheme
+ */
+export declare const requireAbsoluteBaseUrl: (baseUrl: string) => void;
+//# sourceMappingURL=base-url.d.ts.map

package/dist/adapter/http/base-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-url.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/base-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,IAexD,CAAA"}

package/dist/adapter/http/catalog-auth-headers-source.d.ts

@@ -0,0 +1,5 @@
+export interface CatalogAuthHeadersSource {
+    headers(): Promise<Record<string, string>>;
+    confirm(httpStatusCode: number): void;
+}
+//# sourceMappingURL=catalog-auth-headers-source.d.ts.map

package/dist/adapter/http/catalog-auth-headers-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-auth-headers-source.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/catalog-auth-headers-source.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1C,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CACtC"}

package/dist/adapter/http/catalog-unavailable-error.d.ts

@@ -0,0 +1,7 @@
+import { CatalogClientError } from '../../domain/core/models/catalog-client-error';
+import type { CatalogUnavailableReason } from './catalog-unavailable-reason';
+export declare class CatalogUnavailableError extends CatalogClientError {
+    readonly reason: CatalogUnavailableReason;
+    constructor(message: string, reason: CatalogUnavailableReason, httpStatusCodeOrCause?: number | Error);
+}
+//# sourceMappingURL=catalog-unavailable-error.d.ts.map

package/dist/adapter/http/catalog-unavailable-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-unavailable-error.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/catalog-unavailable-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAA;AAClF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAE5E,qBAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;gBAGvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,wBAAwB,EAChC,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK;CAMzC"}

package/dist/adapter/http/catalog-unavailable-reason.d.ts

@@ -0,0 +1,8 @@
+export declare const CATALOG_UNAVAILABLE_REASONS: {
+    readonly NETWORK: "network";
+    readonly SERVER_ERROR: "server_error";
+    readonly CIRCUIT_OPEN: "circuit_open";
+    readonly INVALID_RESPONSE: "invalid_response";
+};
+export type CatalogUnavailableReason = typeof CATALOG_UNAVAILABLE_REASONS[keyof typeof CATALOG_UNAVAILABLE_REASONS];
+//# sourceMappingURL=catalog-unavailable-reason.d.ts.map

package/dist/adapter/http/catalog-unavailable-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-unavailable-reason.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/catalog-unavailable-reason.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B;;;;;CAK9B,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAClC,OAAO,2BAA2B,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/adapter/http/connection-mode.d.ts

@@ -0,0 +1,6 @@
+export declare const CONNECTION_MODES: {
+    readonly INTERNAL_GATEWAY: "INTERNAL_GATEWAY";
+    readonly CLUSTER_DNS: "CLUSTER_DNS";
+};
+export type ConnectionMode = typeof CONNECTION_MODES[keyof typeof CONNECTION_MODES];
+//# sourceMappingURL=connection-mode.d.ts.map

package/dist/adapter/http/connection-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-mode.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/connection-mode.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;CAGnB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA"}

package/dist/adapter/http/error-chain.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Walks an error and its `cause` chain looking for the first value the
+ * predicate accepts. Resilience policies wrap the original failure, so the
+ * catalog exception is usually nested rather than thrown directly.
+ *
+ * @param error - The error to inspect, along with its causes
+ * @param predicate - Type guard identifying the error being looked for
+ * @returns The first matching error, or `undefined` when none matches
+ *
+ * @example
+ * ```typescript
+ * const catalogError = findErrorInChain(
+ *   wrapped,
+ *   (candidate): candidate is CatalogClientError => candidate instanceof CatalogClientError,
+ * )
+ * ```
+ */
+export declare const findErrorInChain: <T>(error: unknown, predicate: (candidate: unknown) => candidate is T) => T | undefined;
+//# sourceMappingURL=error-chain.d.ts.map

package/dist/adapter/http/error-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-chain.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/error-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,OAAO,OAAO,EACd,WAAW,CAAC,SAAS,EAAE,OAAO,KAAK,SAAS,IAAI,CAAC,KAChD,CAAC,GAAG,SAoBN,CAAA"}

package/dist/adapter/http/fallback-key.d.ts

@@ -0,0 +1,2 @@
+export declare const toFallbackKey: (code: string, locale: string) => string;
+//# sourceMappingURL=fallback-key.d.ts.map

package/dist/adapter/http/fallback-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-key.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/fallback-key.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAA8B,CAAA"}

package/dist/adapter/http/fallback-match.d.ts

@@ -0,0 +1,6 @@
+export declare const FALLBACK_MATCHES: {
+    readonly EXACT: "exact";
+    readonly DEFAULT: "default";
+};
+export type FallbackMatch = typeof FALLBACK_MATCHES[keyof typeof FALLBACK_MATCHES];
+//# sourceMappingURL=fallback-match.d.ts.map

package/dist/adapter/http/fallback-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-match.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/fallback-match.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;CAGnB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA"}

package/dist/adapter/http/fallback-token-map-loader.d.ts

@@ -0,0 +1,5 @@
+import type { FallbackTokenMap } from './fallback-token-map';
+export declare const DEFAULT_FALLBACK_TOKENS_LOCATION = "bundle:response-catalog-fallbacks.json";
+export declare const loadFallbackTokenMap: (location: string) => FallbackTokenMap;
+export declare const loadFallbackTokenMapFromFilePath: (filePath: string) => FallbackTokenMap;
+//# sourceMappingURL=fallback-token-map-loader.d.ts.map

package/dist/adapter/http/fallback-token-map-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-token-map-loader.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/fallback-token-map-loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAU5D,eAAO,MAAM,gCAAgC,2CAA6C,CAAA;AAqI1F,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,KAAG,gBAUvD,CAAA;AAED,eAAO,MAAM,gCAAgC,GAAI,UAAU,MAAM,KAAG,gBAInE,CAAA"}

package/dist/adapter/http/fallback-token-map.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validated fallback token map, built once when the client is created. Keys are
+ * `code::locale` pairs produced by {@link toFallbackKey}; the on-disk JSON
+ * schema it is parsed from is documented in `docs/fallback.md` and enforced by
+ * `fallback-token-map-loader.ts`.
+ */
+export type FallbackTokenMap = {
+    readonly defaultLocale: string;
+    readonly defaultToken: string;
+    readonly tokens: ReadonlyMap<string, string>;
+};
+//# sourceMappingURL=fallback-token-map.d.ts.map

package/dist/adapter/http/fallback-token-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-token-map.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/fallback-token-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C,CAAA"}

package/dist/adapter/http/fallback-token-resolver.d.ts

@@ -0,0 +1,16 @@
+import type { SupplierErrorContext } from '../../domain/core/models/supplier-error-context';
+import type { FallbackTokenMap } from './fallback-token-map';
+import type { ResolvedFallback } from './resolved-fallback';
+/** Resolves a supplier error to a local token. See `docs/fallback.md`. */
+export interface FallbackTokenResolver {
+    resolve(context: SupplierErrorContext): ResolvedFallback;
+}
+/**
+ * Binds a validated token map to a resolver. The map is loaded once when the
+ * client is created, so resolution is a pure in-memory lookup.
+ *
+ * @param tokenMap - The validated map to look up in
+ * @returns A resolver over that map
+ */
+export declare const createFallbackTokenResolver: (tokenMap: FallbackTokenMap) => FallbackTokenResolver;
+//# sourceMappingURL=fallback-token-resolver.d.ts.map

package/dist/adapter/http/fallback-token-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-token-resolver.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/fallback-token-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAA;AAG3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAG3D,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,CAAA;CACzD;AAkBD;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAU,gBAAgB,KACzB,qBASD,CAAA"}

package/dist/adapter/http/internal-gateway-auth-headers-source.d.ts

@@ -0,0 +1,31 @@
+import type { CatalogAuthHeadersSource } from './catalog-auth-headers-source';
+export interface InternalGatewayHeadersFetcher {
+    (params: {
+        secretAdapterRegion: string;
+        apigwSecretName: string;
+        authManagerBaseURL: string;
+    }): Promise<Record<string, string>>;
+}
+export interface InternalGatewayAuthHeadersSourceOptions {
+    readonly secretName: string;
+    readonly authManagerBaseURL: string;
+    readonly secretAdapterRegion: string;
+    readonly fetchHeaders: InternalGatewayHeadersFetcher;
+}
+/**
+ * Auth source for INTERNAL_GATEWAY. Caches headers from library-nodejs-common and
+ * invalidates the cache when `confirm` reports a credential rejection so the next
+ * retry (after confirm) fetches fresh credentials — same semantic as Java's
+ * APIGWKeysUseCase.confirmStatusCode.
+ */
+export declare class InternalGatewayAuthHeadersSource implements CatalogAuthHeadersSource {
+    private readonly options;
+    private cachedHeaders;
+    private inFlight;
+    private invalidateOnNextHeaders;
+    constructor(options: InternalGatewayAuthHeadersSourceOptions);
+    headers(): Promise<Record<string, string>>;
+    private fetchAndCache;
+    confirm(httpStatusCode: number): void;
+}
+//# sourceMappingURL=internal-gateway-auth-headers-source.d.ts.map

package/dist/adapter/http/internal-gateway-auth-headers-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-gateway-auth-headers-source.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/internal-gateway-auth-headers-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAI7E,MAAM,WAAW,6BAA6B;IAC5C,CAAC,MAAM,EAAE;QACP,mBAAmB,EAAE,MAAM,CAAA;QAC3B,eAAe,EAAE,MAAM,CAAA;QACvB,kBAAkB,EAAE,MAAM,CAAA;KAC3B,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAA;CACrD;AAED;;;;;GAKG;AACH,qBAAa,gCAAiC,YAAW,wBAAwB;IAKnE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,uBAAuB,CAAQ;gBAEV,OAAO,EAAE,uCAAuC;IAEvE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAkBlC,aAAa;IAmB3B,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;CAKtC"}

package/dist/adapter/http/locale-utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Canonicalizes a locale tag, accepting both underscore and hyphen separators.
+ *
+ * @param locale - Locale tag such as `es_CO` or `es-co`
+ * @returns The canonical BCP 47 tag (`es-CO`)
+ * @throws Error when the tag is not a structurally valid locale
+ *
+ * @example
+ * ```typescript
+ * normalizeLocale('es_CO') // 'es-CO'
+ * ```
+ */
+export declare const normalizeLocale: (locale: string) => string;
+//# sourceMappingURL=locale-utils.d.ts.map

package/dist/adapter/http/locale-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-utils.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/locale-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAUhD,CAAA"}

package/dist/adapter/http/no-auth-headers-source.d.ts

@@ -0,0 +1,3 @@
+import type { CatalogAuthHeadersSource } from './catalog-auth-headers-source';
+export declare const noAuthHeadersSource: () => CatalogAuthHeadersSource;
+//# sourceMappingURL=no-auth-headers-source.d.ts.map

package/dist/adapter/http/no-auth-headers-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-auth-headers-source.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/no-auth-headers-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAW7E,eAAO,MAAM,mBAAmB,QAAO,wBAAkD,CAAA"}

package/dist/adapter/http/resilience.d.ts

@@ -0,0 +1,21 @@
+import { BrokenCircuitError, type IPolicy } from 'cockatiel';
+export declare const DEFAULT_MAX_ATTEMPTS = 3;
+export declare const DEFAULT_CIRCUIT_BREAKER_WAIT_DURATION_MS = 30000;
+export type ResiliencePolicies = {
+    readonly policy: IPolicy;
+};
+/**
+ * Builds the retry and circuit breaker guarding calls to the catalog. Retry
+ * wraps the breaker, so retries stop once the breaker opens.
+ *
+ * @param options.maxAttempts - Total attempts including the first
+ * @param options.circuitBreakerOpenDurationMs - How long the breaker stays open before a trial call
+ * @returns The composed policy the adapter executes calls through
+ */
+export interface ResilienceOptions {
+    readonly maxAttempts?: number;
+    readonly circuitBreakerOpenDurationMs?: number;
+}
+export declare const createResiliencePolicies: ({ maxAttempts, circuitBreakerOpenDurationMs, }?: ResilienceOptions) => ResiliencePolicies;
+export declare const isBrokenCircuitError: (error: unknown) => error is BrokenCircuitError;
+//# sourceMappingURL=resilience.d.ts.map

package/dist/adapter/http/resilience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/resilience.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAOlB,KAAK,OAAO,EACb,MAAM,WAAW,CAAA;AAKlB,eAAO,MAAM,oBAAoB,IAAI,CAAA;AACrC,eAAO,MAAM,wCAAwC,QAAS,CAAA;AAgD9D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAA;CAC/C;AAED,eAAO,MAAM,wBAAwB,GAAI,iDAGtC,iBAAsB,KAAG,kBA4B3B,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,kBAC1B,CAAA"}

package/dist/adapter/http/resolved-fallback.d.ts

@@ -0,0 +1,11 @@
+import type { FallbackMatch } from './fallback-match';
+/** Outcome of resolving a supplier error against the local token map. */
+export type ResolvedFallback = {
+    /** The frontend token exposed as `resolvedMessage`. */
+    readonly token: string;
+    /** The locale the lookup ran under, which may be the map's default. */
+    readonly resolvedLocale: string;
+    /** Whether the token came from an exact entry or the file default. */
+    readonly match: FallbackMatch;
+};
+//# sourceMappingURL=resolved-fallback.d.ts.map

package/dist/adapter/http/resolved-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-fallback.d.ts","sourceRoot":"","sources":["../../../src/adapter/http/resolved-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,yEAAyE;AACzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAC9B,CAAA"}

package/dist/domain/core/models/{catalog-client-exception.d.ts → catalog-client-error.d.ts}

@@ -8,13 +8,13 @@
  * try {
  *   await catalogPort.fetchResponse(context)
  * } catch (error) {
- *   if (error instanceof CatalogClientException && error.isTransient()) {
+ *   if (error instanceof CatalogClientError && error.isTransient()) {
  *     // safe to retry or fall back locally
  *   }
  * }
  * ```
  */
-export declare class CatalogClientException extends Error {
+export declare class CatalogClientError extends Error {
     /**
      * HTTP status code returned by the catalog, or `null` when the failure
      * was a network-level error (no HTTP response was received).
@@ -39,4 +39,4 @@ export declare class CatalogClientException extends Error {
      */
     isCredentialError(): boolean;
 }
-//# sourceMappingURL=catalog-client-exception.d.ts.map
+//# sourceMappingURL=catalog-client-error.d.ts.map

package/dist/domain/core/models/catalog-client-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-client-error.d.ts","sourceRoot":"","sources":["../../../../src/domain/core/models/catalog-client-error.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK;IAYnE;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,iBAAiB,IAAI,OAAO;CAG7B"}

package/dist/domain/core/models/response.d.ts

@@ -5,11 +5,17 @@
  * @see {@link Response}
  */
 export interface SupplierInfo {
+    /** The supplier identifier, e.g. `"nequi"`. */
     readonly supplierId: string;
+    /** The business domain the supplier belongs to, e.g. `"wallets"`. */
     readonly domain: string;
+    /** The supplier's raw response status code. */
     readonly supplierResponseStatusCode: string;
+    /** The supplier's raw response status description. */
     readonly supplierResponseStatusDescription?: string;
+    /** The catalog entry lifecycle status, e.g. `"ACTIVE"`. */
     readonly status?: string;
+    /** The Cobre internal status code this supplier code maps to. */
     readonly internalStatusCode?: string;
 }
 /**
@@ -19,10 +25,13 @@ export interface SupplierInfo {
  * @see {@link Response}
  */
 export interface InternalInfo {
+    /** The Cobre internal status code, e.g. `"cobre.rail.nequi.not_registered"`. */
     readonly internalStatusCode: string;
+    /** The human-readable description of the internal status. */
     readonly internalStatusDescription?: string;
     /** Whether Cobre-internal tooling should retry the originating operation. */
     readonly retryable: boolean;
+    /** The catalog entry lifecycle status, e.g. `"ACTIVE"`. */
     readonly status?: string;
 }
 /**
@@ -32,8 +41,11 @@ export interface InternalInfo {
  * @see {@link Response}
  */
 export interface ApiInfo {
+    /** The public Cobre API error code, e.g. `"RE0042"`. */
     readonly code: string;
+    /** The public, locale-resolved error message. */
     readonly message: string;
+    /** The HTTP status code Cobre APIs should return for this response. */
     readonly httpResponseCode: number;
     /** Error category (for example `validation`, `technical`). */
     readonly type?: string;
@@ -43,7 +55,9 @@ export interface ApiInfo {
     readonly retryable: boolean;
     /** Link to public documentation describing this error code. */
     readonly docUrl?: string;
+    /** The catalog entry lifecycle status, e.g. `"ACTIVE"`. */
     readonly status?: string;
+    /** The Cobre internal status code this API entry maps to. */
     readonly internalStatusCode?: string;
 }
 /**
@@ -56,10 +70,18 @@ export interface ApiInfo {
  * public API mapping yet).
  */
 export interface Response {
+    /** The raw supplier-side view of the response. */
     readonly supplier: SupplierInfo | null;
+    /** The Cobre-internal, rail-agnostic view of the response. */
     readonly internal: InternalInfo | null;
+    /** The public API-facing view of the response. */
     readonly api: ApiInfo | null;
+    /**
+     * The locale the message was actually resolved in, which may differ from
+     * the requested locale when `fallbackApplied` is `true`.
+     */
     readonly resolvedLocale: string;
+    /** The human-readable message resolved for `resolvedLocale`. */
     readonly resolvedMessage: string;
     /** `true` when this response was produced by the local fallback resolver instead of the remote catalog. */
     readonly fallbackApplied: boolean;

package/dist/domain/core/models/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../../src/domain/core/models/response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAA;IAC3C,QAAQ,CAAC,iCAAiC,CAAC,EAAE,MAAM,CAAA;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CACrC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../../src/domain/core/models/response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAA;IAC3C,sDAAsD;IACtD,QAAQ,CAAC,iCAAiC,CAAC,EAAE,MAAM,CAAA;IACnD,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,iEAAiE;IACjE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CACrC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACtC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC"}

package/dist/domain/core/models/supplier-error-context.d.ts

@@ -4,9 +4,17 @@
  * when omitted.
  */
 export interface SupplierErrorContextInput {
+    /** The supplier identifier, e.g. `"nequi"`. Must not be blank. */
     readonly supplier: string;
+    /** The business domain the supplier belongs to, e.g. `"wallets"`. Must not be blank. */
     readonly domain: string;
+    /** The supplier's raw response status code, e.g. `"58"`. Must not be blank. */
     readonly code: string;
+    /**
+     * The locale to resolve the message in, e.g. `"es-CO"`. Optional; a blank
+     * or omitted value normalizes to `null` and the catalog resolves against
+     * its own default locale.
+     */
     readonly locale?: string | null;
 }
 /**
@@ -14,9 +22,13 @@ export interface SupplierErrorContextInput {
  * to {@link CatalogPort.fetchResponse}.
  */
 export interface SupplierErrorContext {
+    /** The supplier identifier, trimmed and non-blank. */
     readonly supplier: string;
+    /** The business domain the supplier belongs to, trimmed and non-blank. */
     readonly domain: string;
+    /** The supplier's raw response status code, trimmed and non-blank. */
     readonly code: string;
+    /** The locale to resolve the message in, or `null` when not provided. */
     readonly locale: string | null;
 }
 /**

package/dist/domain/core/models/supplier-error-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supplier-error-context.d.ts","sourceRoot":"","sources":["../../../../src/domain/core/models/supplier-error-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AASD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,yBAAyB,KAC/B,oBAKD,CAAA"}
+{"version":3,"file":"supplier-error-context.d.ts","sourceRoot":"","sources":["../../../../src/domain/core/models/supplier-error-context.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,yBAAyB,KAC/B,oBAKD,CAAA"}

package/dist/domain/ports/out/catalog-port.d.ts

@@ -0,0 +1,36 @@
+import type { Response } from '../../core/models/response';
+import type { SupplierErrorContext } from '../../core/models/supplier-error-context';
+/**
+ * Outbound port: resolve a supplier error against the response catalog.
+ * Consumers depend on this abstract class, never on a concrete adapter — the
+ * HTTP implementation ships in `createCatalogClient` / `createCatalogClientSync`.
+ *
+ * @example
+ * ```typescript
+ * class FakeCatalogPort extends CatalogPort {
+ *   async fetchResponse(context: SupplierErrorContext): Promise<Response> {
+ *     return {
+ *       supplier: null,
+ *       internal: null,
+ *       api: null,
+ *       resolvedLocale: 'en-US',
+ *       resolvedMessage: 'stubbed for a test',
+ *       fallbackApplied: false,
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class CatalogPort {
+    /**
+     * Resolves a supplier-reported error against the Response Catalog.
+     *
+     * @param context - Validated supplier, domain, error code, and optional locale
+     * @returns The resolved {@link Response}
+     * @throws {CatalogClientError} When the catalog request fails (network
+     *   failure or non-2xx response). Use `isTransient()` to decide whether to
+     *   retry or fall back locally.
+     */
+    abstract fetchResponse(context: SupplierErrorContext): Promise<Response>;
+}
+//# sourceMappingURL=catalog-port.d.ts.map

package/dist/domain/ports/out/catalog-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-port.d.ts","sourceRoot":"","sources":["../../../../src/domain/ports/out/catalog-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,WAAW;IAC/B;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;CACzE"}

package/dist/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * @module @cobre-npm/library-response-catalog-node
+ *
+ * Node.js client for resolving supplier-reported errors against Cobre's
+ * Response Catalog Read API. Build a `CatalogPort` with `createCatalogClient`
+ * or `createCatalogClientSync`, then call `fetchResponse` with a
+ * `SupplierErrorContext` from `buildSupplierErrorContext`.
+ */
 /**
  * Published package version. Matches `package.json`.
  *
@@ -5,16 +13,19 @@
  * ```typescript
  * import { LIBRARY_VERSION } from '@cobre-npm/library-response-catalog-node'
  *
- * console.log(LIBRARY_VERSION) // '0.2.0'
+ * console.log(LIBRARY_VERSION) // '0.3.0'
  * ```
  *
  * @see {@link https://github.com/Cobre-Colombia/library-response-catalog-node/blob/trunk/CHANGELOG.md | CHANGELOG}
- * @see {@link https://github.com/Cobre-Colombia/library-response-catalog-node/blob/trunk/docs/releases/01-scaffold.md | Scaffold notes}
  */
-export declare const LIBRARY_VERSION = "0.2.0";
-export { CatalogPort } from './domain/ports/out/catalog.port';
+export declare const LIBRARY_VERSION = "0.3.0";
+export { CatalogPort } from './domain/ports/out/catalog-port';
 export type { Response, SupplierInfo, InternalInfo, ApiInfo, } from './domain/core/models/response';
 export { buildSupplierErrorContext } from './domain/core/models/supplier-error-context';
 export type { SupplierErrorContext, SupplierErrorContextInput, } from './domain/core/models/supplier-error-context';
-export { CatalogClientException } from './domain/core/models/catalog-client-exception';
+export { CatalogClientError } from './domain/core/models/catalog-client-error';
+export { CONNECTION_MODES } from './adapter/http/connection-mode';
+export type { ConnectionMode } from './adapter/http/connection-mode';
+export type { CatalogAuthHeadersSource } from './adapter/http/catalog-auth-headers-source';
+export { noAuthHeadersSource } from './adapter/http/no-auth-headers-source';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,UAAU,CAAA;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAE7D,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAA;AAEvF,YAAY,EACV,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,6CAA6C,CAAA;AAEpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,UAAU,CAAA;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAE7D,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAA;AAEvF,YAAY,EACV,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,6CAA6C,CAAA;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAA;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEjE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAEpE,YAAY,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAA;AAE1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAA"}

package/dist/index.js

@@ -1,7 +1,15 @@
 'use strict';
 
+/**
+ * @module @cobre-npm/library-response-catalog-node
+ *
+ * Node.js client for resolving supplier-reported errors against Cobre's
+ * Response Catalog Read API. Build a `CatalogPort` with `createCatalogClient`
+ * or `createCatalogClientSync`, then call `fetchResponse` with a
+ * `SupplierErrorContext` from `buildSupplierErrorContext`.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CatalogClientException = exports.buildSupplierErrorContext = exports.CatalogPort = exports.LIBRARY_VERSION = void 0;
+exports.noAuthHeadersSource = exports.CONNECTION_MODES = exports.CatalogClientError = exports.buildSupplierErrorContext = exports.CatalogPort = exports.LIBRARY_VERSION = void 0;
 /**
  * Published package version. Matches `package.json`.
  *
@@ -9,17 +17,20 @@ exports.CatalogClientException = exports.buildSupplierErrorContext = exports.Cat
  * ```typescript
  * import { LIBRARY_VERSION } from '@cobre-npm/library-response-catalog-node'
  *
- * console.log(LIBRARY_VERSION) // '0.2.0'
+ * console.log(LIBRARY_VERSION) // '0.3.0'
  * ```
  *
  * @see {@link https://github.com/Cobre-Colombia/library-response-catalog-node/blob/trunk/CHANGELOG.md | CHANGELOG}
- * @see {@link https://github.com/Cobre-Colombia/library-response-catalog-node/blob/trunk/docs/releases/01-scaffold.md | Scaffold notes}
  */
-exports.LIBRARY_VERSION = '0.2.0';
-var catalog_port_1 = require("./domain/ports/out/catalog.port");
+exports.LIBRARY_VERSION = '0.3.0';
+var catalog_port_1 = require("./domain/ports/out/catalog-port");
 Object.defineProperty(exports, "CatalogPort", { enumerable: true, get: function () { return catalog_port_1.CatalogPort; } });
 var supplier_error_context_1 = require("./domain/core/models/supplier-error-context");
 Object.defineProperty(exports, "buildSupplierErrorContext", { enumerable: true, get: function () { return supplier_error_context_1.buildSupplierErrorContext; } });
-var catalog_client_exception_1 = require("./domain/core/models/catalog-client-exception");
-Object.defineProperty(exports, "CatalogClientException", { enumerable: true, get: function () { return catalog_client_exception_1.CatalogClientException; } });
+var catalog_client_error_1 = require("./domain/core/models/catalog-client-error");
+Object.defineProperty(exports, "CatalogClientError", { enumerable: true, get: function () { return catalog_client_error_1.CatalogClientError; } });
+var connection_mode_1 = require("./adapter/http/connection-mode");
+Object.defineProperty(exports, "CONNECTION_MODES", { enumerable: true, get: function () { return connection_mode_1.CONNECTION_MODES; } });
+var no_auth_headers_source_1 = require("./adapter/http/no-auth-headers-source");
+Object.defineProperty(exports, "noAuthHeadersSource", { enumerable: true, get: function () { return no_auth_headers_source_1.noAuthHeadersSource; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;AAYG;AACU,OAAA,CAAA,eAAe,GAAG,OAAO;AAEtC,IAAA,cAAA,GAAA,OAAA,CAAA,iCAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,aAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,cAAA,CAAA,WAAW,CAAA,CAAA,CAAA,EAAA,CAAA;AASpB,IAAA,wBAAA,GAAA,OAAA,CAAA,6CAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,2BAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,wBAAA,CAAA,yBAAyB,CAAA,CAAA,CAAA,EAAA,CAAA;AAOlC,IAAA,0BAAA,GAAA,OAAA,CAAA,+CAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,wBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,0BAAA,CAAA,sBAAsB,CAAA,CAAA,CAAA,EAAA,CAAA"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;AAOG;;;AAEH;;;;;;;;;;;AAWG;AACU,OAAA,CAAA,eAAe,GAAG,OAAO;AAEtC,IAAA,cAAA,GAAA,OAAA,CAAA,iCAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,aAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,cAAA,CAAA,WAAW,CAAA,CAAA,CAAA,EAAA,CAAA;AASpB,IAAA,wBAAA,GAAA,OAAA,CAAA,6CAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,2BAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,wBAAA,CAAA,yBAAyB,CAAA,CAAA,CAAA,EAAA,CAAA;AAOlC,IAAA,sBAAA,GAAA,OAAA,CAAA,2CAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,oBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,sBAAA,CAAA,kBAAkB,CAAA,CAAA,CAAA,EAAA,CAAA;AAE3B,IAAA,iBAAA,GAAA,OAAA,CAAA,gCAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,kBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,iBAAA,CAAA,gBAAgB,CAAA,CAAA,CAAA,EAAA,CAAA;AAMzB,IAAA,wBAAA,GAAA,OAAA,CAAA,uCAAA,CAAA;AAAS,MAAA,CAAA,cAAA,CAAA,OAAA,EAAA,qBAAA,EAAA,EAAA,UAAA,EAAA,IAAA,EAAA,GAAA,EAAA,YAAA,EAAA,OAAA,wBAAA,CAAA,mBAAmB,CAAA,CAAA,CAAA,EAAA,CAAA"}

package/dist/shared/text.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Blank-string predicates shared by the domain and the adapters. A value counts
+ * as text only when it is present and holds at least one non-whitespace
+ * character, so `''`, `'   '`, `null` and `undefined` are all treated alike.
+ */
+/**
+ * Narrows a possibly-absent string to one that holds non-whitespace text.
+ *
+ * @param value - The value to check
+ * @returns `true` when the value is a string with non-whitespace content
+ *
+ * @example
+ * ```typescript
+ * hasText('  es-CO ') // true
+ * hasText('   ')      // false
+ * ```
+ */
+export declare const hasText: (value: string | null | undefined) => value is string;
+/**
+ * Returns the trimmed value, or throws when it holds no text.
+ *
+ * @param value - The value to validate
+ * @param fieldName - Name used in the error message
+ * @returns The value with surrounding whitespace removed
+ * @throws Error when the value holds no non-whitespace character
+ *
+ * @example
+ * ```typescript
+ * requireText(' #UNKNOWN# ', 'token') // '#UNKNOWN#'
+ * requireText('  ', 'token')          // throws: token must not be blank
+ * ```
+ */
+export declare const requireText: (value: string | null | undefined, fieldName: string) => string;
+//# sourceMappingURL=text.d.ts.map

package/dist/shared/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/shared/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,KAAK,IAAI,MACF,CAAA;AAElE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,MAAM,KAAG,MAMjF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobre-npm/library-response-catalog-node",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "packageManager": "pnpm@10.27.0",
   "description": "Node.js Cobre library for resolving supplier errors against the Response Catalog Read API",
   "main": "dist/index.js",
@@ -17,9 +17,10 @@
     "build:qa-arm": "npm run build",
     "build:prod-arm": "npm run build",
     "lint": "eslint src --ext .ts",
-    "test": "jest",
+    "test": "jest --coverage",
     "test:coverage": "jest --coverage",
-    "docs": "typedoc"
+    "docs": "typedoc",
+    "test:watch": "jest --watch"
   },
   "license": "ISC",
   "dependencies": {
@@ -47,9 +48,7 @@
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
     "nock": "^13.5.4",
-    "rimraf": "^5.0.7",
     "rollup": "^4.18.0",
-    "rollup-plugin-typescript2": "^0.36.0",
     "ts-jest": "^29.2.3",
     "tslib": "^2.8.1",
     "typedoc": "^0.28.20",

package/dist/domain/core/models/catalog-client-exception.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog-client-exception.d.ts","sourceRoot":"","sources":["../../../../src/domain/core/models/catalog-client-exception.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK;IAYnE;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,iBAAiB,IAAI,OAAO;CAG7B"}

package/dist/domain/ports/out/catalog.port.d.ts

@@ -1,16 +0,0 @@
-import type { Response } from '../../core/models/response';
-import type { SupplierErrorContext } from '../../core/models/supplier-error-context';
-/** Outbound port: resolve a supplier error against the response catalog. */
-export declare abstract class CatalogPort {
-    /**
-     * Resolves a supplier-reported error against the Response Catalog.
-     *
-     * @param context - Validated supplier, domain, error code, and optional locale
-     * @returns The resolved {@link Response}
-     * @throws {CatalogClientException} When the catalog request fails (network
-     *   failure or non-2xx response). Use `isTransient()` to decide whether to
-     *   retry or fall back locally.
-     */
-    abstract fetchResponse(context: SupplierErrorContext): Promise<Response>;
-}
-//# sourceMappingURL=catalog.port.d.ts.map

package/dist/domain/ports/out/catalog.port.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog.port.d.ts","sourceRoot":"","sources":["../../../../src/domain/ports/out/catalog.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAEpF,4EAA4E;AAC5E,8BAAsB,WAAW;IAC/B;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;CACzE"}