@ariestools/sdk 7.0.6 → 7.0.8

package/dist/neutral/modules/fetch/FetchClient.d.ts

@@ -0,0 +1,46 @@
+import { FetchError } from './FetchError.js';
+import type { FetchJsonOptions, FetchJsonResponse } from './types.js';
+/** Configuration for a FetchClient instance. */
+export interface FetchClientConfig extends Omit<FetchJsonOptions, 'method' | 'body'> {
+    baseURL?: string;
+    params?: Record<string, string>;
+    timeout?: number;
+    /**
+     * Determines whether a given HTTP status code should resolve or throw.
+     * Returns true to resolve, false to throw a FetchClientError (a FetchError of type 'http-status').
+     * Default: status >= 200 && status < 300 (like Axios).
+     */
+    validateStatus?: ((status: number) => boolean) | null;
+}
+/** Per-request config, extending the instance defaults. */
+export interface FetchClientRequestConfig extends FetchClientConfig {
+    data?: unknown;
+    method?: string;
+    url?: string;
+}
+/**
+ * HTTP-status error thrown when validateStatus rejects the response status code.
+ * Specialization of {@link FetchError} (type 'http-status') that also exposes the request `config`.
+ * `isFetchError` and `instanceof FetchError` both return true for it.
+ */
+export declare class FetchClientError<T = unknown> extends FetchError {
+    readonly config: FetchClientRequestConfig;
+    readonly response: FetchJsonResponse<T>;
+    constructor(message: string, response: FetchJsonResponse<T>, config: FetchClientRequestConfig);
+}
+/**
+ * Stateful, instance-based HTTP client backed by native fetch with
+ * JSON serialization and optional gzip compression via #fetch.
+ */
+export declare class FetchClient {
+    defaults: FetchClientConfig;
+    constructor(defaults?: FetchClientConfig);
+    static create(config?: FetchClientConfig): FetchClient;
+    delete<T = unknown>(url: string, config?: FetchClientConfig): Promise<FetchJsonResponse<T>>;
+    get<T = unknown>(url: string, config?: FetchClientConfig): Promise<FetchJsonResponse<T>>;
+    patch<T = unknown>(url: string, data?: unknown, config?: FetchClientConfig): Promise<FetchJsonResponse<T>>;
+    post<T = unknown>(url: string, data?: unknown, config?: FetchClientConfig): Promise<FetchJsonResponse<T>>;
+    put<T = unknown>(url: string, data?: unknown, config?: FetchClientConfig): Promise<FetchJsonResponse<T>>;
+    request<T = unknown>(config: FetchClientRequestConfig): Promise<FetchJsonResponse<T>>;
+}
+//# sourceMappingURL=FetchClient.d.ts.map

package/dist/neutral/modules/fetch/FetchClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchClient.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/FetchClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAErE,gDAAgD;AAChD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAAA;CACtD;AAED,2DAA2D;AAC3D,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,qBAAa,gBAAgB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,UAAU;IAC3D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,SAAiB,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAA;gBAEnC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,wBAAwB;CAY9F;AA2BD;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,EAAE,iBAAiB,CAAA;gBAEf,QAAQ,GAAE,iBAAsB;IAI5C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,WAAW;IAItD,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAM3F,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMxF,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAM1G,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMzG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMlG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CA2C5F"}

package/dist/neutral/modules/fetch/FetchError.d.ts

@@ -0,0 +1,80 @@
+import type { FetchJsonResponse } from './types.js';
+/**
+ * Classification of why a fetch request failed.
+ * - `dns` — host could not be resolved (ENOTFOUND, EAI_AGAIN)
+ * - `connection-refused` — the host actively refused the connection (ECONNREFUSED)
+ * - `connection-reset` — the connection was reset/broken mid-flight (ECONNRESET, EPIPE)
+ * - `connection-timeout` — the connection could not be established in time (ETIMEDOUT)
+ * - `timeout` — the request exceeded its time budget (AbortSignal.timeout, undici header/body timeouts)
+ * - `aborted` — the request was aborted by an AbortController
+ * - `tls` — a TLS/certificate problem (expired, self-signed, hostname mismatch, ...)
+ * - `unreachable` — the host or network is unreachable (EHOSTUNREACH, ENETUNREACH)
+ * - `http-status` — the response arrived but its status was rejected by validateStatus
+ * - `parse` — a successful response had a non-empty body that could not be parsed as JSON
+ * - `network` — a generic network failure with no recognizable cause (e.g. browser "Failed to fetch")
+ * - `unknown` — the failure could not be classified
+ */
+export type FetchErrorType = 'dns' | 'connection-refused' | 'connection-reset' | 'connection-timeout' | 'timeout' | 'aborted' | 'tls' | 'unreachable' | 'http-status' | 'parse' | 'network' | 'unknown';
+/**
+ * Classifies a raw error thrown by native `fetch` (or its `cause` chain) into a FetchErrorType.
+ * Recognizes DNS, connection, TLS, timeout and abort failures from Node/undici system codes
+ * and DOMException names, falling back to `network` for generic failures and `unknown` otherwise.
+ */
+export declare function classifyFetchError(error: unknown): {
+    code?: string;
+    type: FetchErrorType;
+};
+/** Context attached to a FetchError describing the request and (when available) the response. */
+export interface FetchErrorContext {
+    /** Raw response body text — set for `parse` errors so the unparseable payload can be inspected. */
+    body?: string;
+    cause?: unknown;
+    code?: string;
+    method?: string;
+    response?: FetchJsonResponse<unknown>;
+    status?: number;
+    statusText?: string;
+    type?: FetchErrorType;
+    url?: string;
+}
+/** Plain serializable shape of a FetchError, safe for logging/telemetry (no circular refs). */
+export interface FetchErrorJson {
+    code?: string;
+    message: string;
+    method?: string;
+    name: string;
+    status?: number;
+    statusText?: string;
+    type: FetchErrorType;
+    url?: string;
+}
+/**
+ * Structured error for every failure mode of the #fetch stack.
+ * Carries a classified `type`, the underlying system `code` (when known), request context
+ * (`url`, `method`) and, for HTTP-status failures, the parsed `response`. The original error
+ * is preserved on `cause`. Detect with {@link isFetchError}.
+ */
+export declare class FetchError extends Error {
+    readonly __fetchErrorMarker = "$$xylabs-fetch-error";
+    readonly body?: string;
+    readonly code?: string;
+    readonly method?: string;
+    readonly response?: FetchJsonResponse<unknown>;
+    readonly status?: number;
+    readonly statusText?: string;
+    readonly type: FetchErrorType;
+    readonly url?: string;
+    constructor(message: string, context?: FetchErrorContext);
+    toJSON(): FetchErrorJson;
+}
+/** Type guard: true for any FetchError we built, robust across bundle/realm copies via a brand marker. */
+export declare function isFetchError(value: unknown): value is FetchError;
+/**
+ * Wraps a raw thrown error into a structured FetchError, classifying network failures.
+ * Idempotent: an existing FetchError is returned unchanged so wrapping at multiple layers is safe.
+ */
+export declare function toFetchError(error: unknown, context?: {
+    method?: string;
+    url?: string;
+}): FetchError;
+//# sourceMappingURL=FetchError.d.ts.map

package/dist/neutral/modules/fetch/FetchError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchError.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/FetchError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GACpB,KAAK,GACL,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,SAAS,GACT,SAAS,GACT,KAAK,GACL,aAAa,GACb,aAAa,GACb,OAAO,GACP,SAAS,GACT,SAAS,CAAA;AA0Cf;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAkB1F;AAED,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,cAAc,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,kBAAkB,0BAAmB;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;gBAET,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAa5D,MAAM,IAAI,cAAc;CAYzB;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAOhE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,CAOxG"}

package/dist/neutral/modules/fetch/FetchJsonClient.d.ts

@@ -0,0 +1,19 @@
+import type { FetchClientConfig } from './FetchClient.js';
+import { FetchClient } from './FetchClient.js';
+/**
+ * Pre-configured FetchClient for JSON APIs with optional gzip compression.
+ * Drop-in replacement for `@xylabs/axios`'s `axiosJson` / `AxiosJson`.
+ *
+ * Default behavior matches axiosJsonConfig():
+ * - JSON Accept/Content-Type headers
+ * - Request bodies > compressMinLength (default 1024) are gzip-compressed
+ * - Responses are parsed as JSON
+ * - Non-2xx status codes throw (like Axios default)
+ */
+export declare class FetchJsonClient extends FetchClient {
+    constructor(config?: FetchClientConfig);
+    static create(config?: FetchClientConfig): FetchJsonClient;
+}
+/** Ready-to-use JSON fetch client, equivalent to `axiosJson` from `@xylabs/axios`. */
+export declare const fetchJsonClient: FetchJsonClient;
+//# sourceMappingURL=FetchJsonClient.d.ts.map

package/dist/neutral/modules/fetch/FetchJsonClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchJsonClient.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/FetchJsonClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,MAAM,CAAC,EAAE,iBAAiB;WAItB,MAAM,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,eAAe;CAGpE;AAED,sFAAsF;AACtF,eAAO,MAAM,eAAe,iBAAwB,CAAA"}

package/dist/neutral/modules/fetch/fetchCompress.d.ts

@@ -0,0 +1,12 @@
+export interface FetchCompressOptions extends RequestInit {
+    /** Gzip payloads larger than this byte count. */
+    compressMinLength?: number;
+}
+/**
+ * Drop-in replacement for native `fetch` that optionally gzip-compresses the request body.
+ * When `compressMinLength` is set and the body string exceeds that threshold, the body is
+ * gzip-compressed using native compression and `Content-Encoding: gzip` is added to the headers.
+ * Returns a standard `Response` — identical to what native `fetch` returns.
+ */
+export declare function fetchCompress(url: string | URL, options?: FetchCompressOptions): Promise<Response>;
+//# sourceMappingURL=fetchCompress.d.ts.map

package/dist/neutral/modules/fetch/fetchCompress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchCompress.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/fetchCompress.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AASD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqB5G"}

package/dist/neutral/modules/fetch/fetchJson.d.ts

@@ -0,0 +1,7 @@
+import type { FetchJsonOptions, FetchJsonResponse } from './types.js';
+/**
+ * JSON-configured fetch with optional gzip compression on request bodies.
+ * Request bodies exceeding `compressMinLength` bytes are gzip-compressed using native compression.
+ */
+export declare function fetchJson<T>(url: string, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>>;
+//# sourceMappingURL=fetchJson.d.ts.map

package/dist/neutral/modules/fetch/fetchJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchJson.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/fetchJson.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAenB;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAmB7G"}

package/dist/neutral/modules/fetch/index.d.ts

@@ -0,0 +1,11 @@
+export type { FetchClientConfig, FetchClientRequestConfig } from './FetchClient.js';
+export { FetchClient, FetchClientError } from './FetchClient.js';
+export type { FetchCompressOptions } from './fetchCompress.js';
+export { fetchCompress } from './fetchCompress.js';
+export type { FetchErrorContext, FetchErrorJson, FetchErrorType, } from './FetchError.js';
+export { classifyFetchError, FetchError, isFetchError, toFetchError, } from './FetchError.js';
+export { fetchJson } from './fetchJson.js';
+export { FetchJsonClient, fetchJsonClient } from './FetchJsonClient.js';
+export { fetchJsonDelete, fetchJsonGet, fetchJsonPatch, fetchJsonPost, fetchJsonPut, } from './methods.js';
+export type { FetchJsonOptions, FetchJsonResponse } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAChE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA"}

package/dist/neutral/modules/fetch/methods.d.ts

@@ -0,0 +1,12 @@
+import type { FetchJsonOptions, FetchJsonResponse } from './types.js';
+/** JSON GET request. */
+export declare function fetchJsonGet<T>(url: string, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>>;
+/** JSON POST request with a body. */
+export declare function fetchJsonPost<T>(url: string, data?: unknown, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>>;
+/** JSON PUT request with a body. */
+export declare function fetchJsonPut<T>(url: string, data?: unknown, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>>;
+/** JSON PATCH request with a body. */
+export declare function fetchJsonPatch<T>(url: string, data?: unknown, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>>;
+/** JSON DELETE request. */
+export declare function fetchJsonDelete<T>(url: string, options?: FetchJsonOptions): Promise<FetchJsonResponse<T>>;
+//# sourceMappingURL=methods.d.ts.map

package/dist/neutral/modules/fetch/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/methods.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAEnB,wBAAwB;AACxB,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAEtG;AAED,qCAAqC;AACrC,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAMvH;AAED,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAMtH;AAED,sCAAsC;AACtC,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAMxH;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAEzG"}

package/dist/neutral/modules/fetch/model.d.ts

@@ -0,0 +1,5 @@
+export type { FetchClientConfig, FetchClientRequestConfig, } from './FetchClient.js';
+export type { FetchCompressOptions } from './fetchCompress.js';
+export type { FetchErrorContext, FetchErrorJson, FetchErrorType, } from './FetchError.js';
+export type * from './types.js';
+//# sourceMappingURL=model.d.ts.map

package/dist/neutral/modules/fetch/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/model.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,mBAAmB,YAAY,CAAA"}

package/dist/neutral/modules/fetch/parseJson.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Reads and JSON-parses a response body. An empty or whitespace-only body resolves to `null`
+ * (so 204/304/HEAD and other empty responses are not treated as failures). A non-empty body that
+ * cannot be parsed throws a FetchError of type `parse` carrying the raw body and status. A failure
+ * while reading the body stream (e.g. a dropped connection) is classified as a network FetchError.
+ */
+export declare function parseJsonResponse<T>(response: Response, context?: {
+    method?: string;
+    url?: string;
+}): Promise<T | null>;
+/**
+ * Best-effort JSON parse for non-success responses: returns `null` on any failure
+ * (empty body, malformed body, or read error) so the response can still be surfaced for inspection.
+ */
+export declare function tryParseJson<T>(response: Response): Promise<T | null>;
+//# sourceMappingURL=parseJson.d.ts.map

package/dist/neutral/modules/fetch/parseJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseJson.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/parseJson.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAqBjI;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAQ3E"}

package/dist/neutral/modules/fetch/types.d.ts

@@ -0,0 +1,12 @@
+import type { FetchCompressOptions } from './fetchCompress.js';
+/** Fetch request options extended with an optional gzip compression threshold. */
+export type FetchJsonOptions = FetchCompressOptions;
+/** Structured response from a fetchJson call. */
+export interface FetchJsonResponse<T> {
+    data: T | null;
+    headers: Headers;
+    response: Response;
+    status: number;
+    statusText: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/neutral/modules/fetch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/fetch/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAA;AAEnD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/dist/neutral/modules/forget/ForgetConfig.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Configuration options for fire-and-forget promises.
+ */
+export interface ForgetConfig<T = any> {
+    /** Optional name for identifying the forgotten promise in logs. */
+    name?: string;
+    /** Called when the configured timeout elapses before the promise settles. The promise keeps running. */
+    onCancel?: () => void;
+    /** Called when the promise completes, with a tuple of [result, error]. */
+    onComplete?: (result: [T | undefined, Error | undefined]) => void;
+    /** Called when an exception occurs outside the promise itself. */
+    onException?: (error: Error) => void;
+    /**
+     * Timeout in milliseconds after which `onCancel` and `timeoutHandler` run.
+     * This does not abort the promise; `activeForgets` stays elevated until it settles.
+     */
+    timeout?: number;
+}
+/** Default forget configuration with a 30-second timeout. */
+export declare const defaultForgetConfig: ForgetConfig<unknown>;
+//# sourceMappingURL=ForgetConfig.d.ts.map

package/dist/neutral/modules/forget/ForgetConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgetConfig.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/ForgetConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wGAAwG;IACxG,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,GAAG,SAAS,CAAC,KAAK,IAAI,CAAA;IACjE,kEAAkE;IAClE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,OAAO,CAAuB,CAAA"}

package/dist/neutral/modules/forget/ForgetNodeConfig.d.ts

@@ -0,0 +1,13 @@
+import { type ForgetConfig } from './ForgetConfig.js';
+/**
+ * Node.js-specific forget configuration that extends ForgetConfig with process termination options.
+ */
+export interface ForgetNodeConfig<T = any> extends ForgetConfig<T> {
+    /** Terminate the process on an exception that happens outside of the promise being forgotten. */
+    terminateOnException?: boolean;
+    /** Terminate the process if the promise times out. */
+    terminateOnTimeout?: boolean;
+}
+/** Default Node.js forget configuration with termination disabled. */
+export declare const defaultForgetNodeConfig: ForgetNodeConfig<unknown>;
+//# sourceMappingURL=ForgetNodeConfig.d.ts.map

package/dist/neutral/modules/forget/ForgetNodeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgetNodeConfig.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/ForgetNodeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE1E;;GAEG;AAEH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAChE,iGAAiG;IACjG,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,CAAC,OAAO,CAI7D,CAAA"}

package/dist/neutral/modules/forget/ForgetPromise.d.ts

@@ -0,0 +1,49 @@
+import type { Logger } from '../logger/index.js';
+import type { Promisable, PromiseEx } from '../promise/index.js';
+import { type ForgetConfig } from './ForgetConfig.js';
+/** A function that returns a promisable value. */
+type PromisableFunction<T> = () => Promisable<T>;
+/**
+ * Manages fire-and-forget promises with tracking, timeouts, and error handling.
+ *
+ * Timeouts are observability hooks only: they invoke `onCancel` and `timeoutHandler` but do not
+ * abort or await-cleanup the underlying promise. `activeForgets` therefore counts promises that
+ * are still running (unsettled), not promises still inside their configured timeout window.
+ */
+export declare class ForgetPromise {
+    /**
+     * Number of forgotten promises still running (not yet settled).
+     * Decremented only when the underlying promise fulfills or rejects — not when a timeout fires.
+     */
+    static activeForgets: number;
+    /** Number of forgotten promises that threw exceptions. */
+    static exceptedForgets: number;
+    /** Logger instance used for error and warning output. */
+    static logger: Logger;
+    /** Whether any forgotten promises are still running, including any that have exceeded their timeout. */
+    static get active(): boolean;
+    /**
+     * Waits until all forgotten promises have settled.
+     * @param interval - Polling interval in milliseconds.
+     * @param timeout - Optional maximum wait time in milliseconds.
+     * @returns `0` when every forgotten promise has settled; otherwise the number still running.
+     * A non-zero return after `timeout` elapses can include promises whose timeout callback already
+     * ran but whose work is still in flight.
+     */
+    static awaitInactive(interval?: number, timeout?: number): Promise<number>;
+    /** Handles exceptions from forgotten promises by logging error details. */
+    static exceptionHandler(error: Error, { name }: ForgetConfig, externalStackTrace?: string): void;
+    /**
+     * Used to explicitly launch an async function (or Promise) with awaiting it
+     * @param promise The promise to forget
+     * @param config Configuration of forget settings
+     */
+    static forget<T>(promise: Promise<T> | PromiseEx<T> | PromisableFunction<T> | T, config?: ForgetConfig<T>): void;
+    /**
+     * Handles timeout events for forgotten promises by logging timeout details.
+     * Does not terminate the underlying promise; it may continue running after this is called.
+     */
+    static timeoutHandler(time: number, { name }: ForgetConfig, externalStackTrace?: string): void;
+}
+export {};
+//# sourceMappingURL=ForgetPromise.d.ts.map

package/dist/neutral/modules/forget/ForgetPromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgetPromise.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/ForgetPromise.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAGrD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE1E,kDAAkD;AAClD,KAAK,kBAAkB,CAAC,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,CAAA;AAEhD;;;;;;GAMG;AAEH,qBAAa,aAAa;IACxB;;;OAGG;IACH,MAAM,CAAC,aAAa,SAAI;IACxB,0DAA0D;IAC1D,MAAM,CAAC,eAAe,SAAI;IAC1B,yDAAyD;IACzD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAU;IAE/B,wGAAwG;IACxG,MAAM,KAAK,MAAM,YAEhB;IAED;;;;;;;OAOG;WACU,aAAa,CAAC,QAAQ,SAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAc3D,2EAA2E;IAC3E,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,kBAAkB,CAAC,EAAE,MAAM;IAOzF;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IA6DzG;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAgB,EAAE,EAAE,YAAY,EAAE,kBAAkB,CAAC,EAAE,MAAM;CAMpG"}

package/dist/neutral/modules/forget/ForgetPromiseNode.d.ts

@@ -0,0 +1,15 @@
+import type { Promisable } from '../promise/index.js';
+import { type ForgetNodeConfig } from './ForgetNodeConfig.js';
+import { ForgetPromise } from './ForgetPromise.js';
+/**
+ * Node.js extension of ForgetPromise that can terminate the process on exceptions or timeouts.
+ */
+export declare class ForgetPromiseNode extends ForgetPromise {
+    /** Handles exceptions, optionally terminating the process based on config. */
+    static exceptionHandler(error: Error, config: ForgetNodeConfig, externalStackTrace?: string): void;
+    /** Forgets a promise using Node.js-specific configuration with process termination support. */
+    static forget<T>(promise: Promisable<T>, config?: ForgetNodeConfig<T>): void;
+    /** Handles timeouts, optionally terminating the process based on config. */
+    static timeoutHandler(time: number, config: ForgetNodeConfig, externalStackTrace?: string): void;
+}
+//# sourceMappingURL=ForgetPromiseNode.d.ts.map

package/dist/neutral/modules/forget/ForgetPromiseNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgetPromiseNode.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/ForgetPromiseNode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,8EAA8E;WAC9D,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,MAAM;IAUpG,+FAA+F;WAC/E,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAO9E,4EAA4E;WAC5D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,MAAM;CAQnG"}

package/dist/neutral/modules/forget/forget.d.ts

@@ -0,0 +1,10 @@
+import { type Promisable } from '../promise/index.js';
+import type { ForgetConfig } from './ForgetConfig.js';
+/**
+ * Explicitly launches an async function or promise without awaiting it (fire-and-forget).
+ * @param promise - The promise or promisable value to forget.
+ * @param config - Optional configuration for timeout notification, error handling, and completion callbacks.
+ * Timeouts notify via `onCancel` but do not stop the underlying work; see `ForgetPromise.activeForgets`.
+ */
+export declare const forget: <T>(promise: Promisable<T>, config?: ForgetConfig<T>) => void;
+//# sourceMappingURL=forget.d.ts.map

package/dist/neutral/modules/forget/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/forget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,SAEzE,CAAA"}

package/dist/neutral/modules/forget/forgetNode.d.ts

@@ -0,0 +1,9 @@
+import { type Promisable } from '../promise/index.js';
+import type { ForgetNodeConfig } from './ForgetNodeConfig.js';
+/**
+ * Node.js variant of forget that can optionally terminate the process on exceptions or timeouts.
+ * @param promise - The promise or promisable value to forget.
+ * @param config - Optional Node.js-specific configuration including process termination options.
+ */
+export declare const forgetNode: <T>(promise: Promisable<T>, config?: ForgetNodeConfig<T>) => void;
+//# sourceMappingURL=forgetNode.d.ts.map

package/dist/neutral/modules/forget/forgetNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgetNode.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/forgetNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,SAEjF,CAAA"}

package/dist/neutral/modules/forget/index.d.ts

@@ -0,0 +1,2 @@
+export * from './node/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/forget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/neutral/modules/forget/model.d.ts

@@ -0,0 +1,3 @@
+export type { ForgetConfig } from './ForgetConfig.js';
+export type { ForgetNodeConfig } from './ForgetNodeConfig.js';
+//# sourceMappingURL=model.d.ts.map

package/dist/neutral/modules/forget/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/modules/forget/model.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/neutral/modules/forget/neutral/index.d.ts

@@ -0,0 +1,4 @@
+export * from '../forget.js';
+export * from '../ForgetConfig.js';
+export * from '../ForgetPromise.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/forget/neutral/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/forget/neutral/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA"}

package/dist/neutral/modules/forget/node/index.d.ts

@@ -0,0 +1,4 @@
+export { forgetNode as forget } from '../forgetNode.js';
+export * from '../ForgetNodeConfig.js';
+export { ForgetPromiseNode as ForgetPromise } from '../ForgetPromiseNode.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/forget/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/forget/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACvD,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/neutral/modules/function-name/functionName.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns the name of the calling function by inspecting the stack trace.
+ * @param depth - The stack frame depth to read the function name from (default: 2).
+ * @returns The function name, or '<unknown>' if it cannot be determined.
+ */
+export declare const functionName: (depth?: number) => string;
+//# sourceMappingURL=functionName.d.ts.map

package/dist/neutral/modules/function-name/functionName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionName.d.ts","sourceRoot":"","sources":["../../../../src/modules/function-name/functionName.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,cAAS,WAsBrC,CAAA"}

package/dist/neutral/modules/function-name/index.d.ts

@@ -0,0 +1,2 @@
+export * from './functionName.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/function-name/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/function-name/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

package/dist/neutral/modules/hex/HexRegEx.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Creates a RegExp matching lowercase hex strings with a byte length in the given range.
+ * @param minBytes - Minimum number of bytes (default 0)
+ * @param maxBytes - Maximum number of bytes
+ * @returns A RegExp for validating hex strings within the byte range
+ */
+export declare const HexRegExMinMax: (minBytes?: number, maxBytes?: number) => RegExp;
+/**
+ * Creates a RegExp matching mixed-case hex strings with a 0x prefix and a byte length in the given range.
+ * @param minBytes - Minimum number of bytes (default 0)
+ * @param maxBytes - Maximum number of bytes
+ * @returns A RegExp for validating prefixed hex strings within the byte range
+ */
+export declare const HexRegExMinMaxMixedCaseWithPrefix: (minBytes?: number, maxBytes?: number) => RegExp;
+/** Regular expression matching a lowercase hex string without prefix. */
+export declare const HexRegEx: RegExp;
+/** Regular expression matching a lowercase hex string with a 0x prefix. */
+export declare const HexRegExWithPrefix: RegExp;
+//# sourceMappingURL=HexRegEx.d.ts.map

package/dist/neutral/modules/hex/HexRegEx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HexRegEx.d.ts","sourceRoot":"","sources":["../../../../src/modules/hex/HexRegEx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,iBAAY,EAAE,WAAU,MAAsC,WAE5F,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,GAAI,iBAAY,EAAE,WAAU,MAAsC,WAE/G,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,QAAQ,QAAgB,CAAA;AACrC,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,QAAkB,CAAA"}

package/dist/neutral/modules/hex/address/AddressTransformZod.d.ts

@@ -0,0 +1,10 @@
+import * as z from 'zod/mini';
+/** Zod schema that accepts a string, bigint, or number and transforms it into a validated Address. */
+export declare const AddressTransformZod: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniBigInt<bigint>, z.ZodMiniNumber<number>]>, z.ZodMiniTransform<string, string | number | bigint>>, z.ZodMiniTransform<Lowercase<string> & {
+    readonly __hex: true;
+} & {
+    readonly __address: true;
+}, string>>;
+/** The output type of AddressTransformZod after parsing and transformation. */
+export type AddressTransformZodType = z.infer<typeof AddressTransformZod>;
+//# sourceMappingURL=AddressTransformZod.d.ts.map

package/dist/neutral/modules/hex/address/AddressTransformZod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressTransformZod.d.ts","sourceRoot":"","sources":["../../../../../src/modules/hex/address/AddressTransformZod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAK7B,sGAAsG;AACtG,eAAO,MAAM,mBAAmB;;;;WAc/B,CAAA;AAED,+EAA+E;AAC/E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/neutral/modules/hex/address/AddressValidationZod.d.ts

@@ -0,0 +1,10 @@
+import * as z from 'zod/mini';
+/** Zod schema that validates a string is a properly formatted 40-character hex address. */
+export declare const AddressValidationZod: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<Lowercase<string> & {
+    readonly __hex: true;
+} & {
+    readonly __address: true;
+}, string>>;
+/** The output type of AddressValidationZod after parsing. */
+export type AddressValidationZodType = z.infer<typeof AddressValidationZod>;
+//# sourceMappingURL=AddressValidationZod.d.ts.map

package/dist/neutral/modules/hex/address/AddressValidationZod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressValidationZod.d.ts","sourceRoot":"","sources":["../../../../../src/modules/hex/address/AddressValidationZod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAM7B,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB;;;;WAMhC,CAAA;AAED,6DAA6D;AAC7D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/neutral/modules/hex/address/address.d.ts

@@ -0,0 +1,18 @@
+import * as z from 'zod/mini';
+import type { Brand } from '../../typeof/index.js';
+import { type Hex } from '../hex/index.js';
+/** A 160-bit zero address constant. */
+export declare const ZERO_ADDRESS: Address;
+/** The character length of an address hex string (40 hex characters / 20 bytes). */
+export declare const ADDRESS_LENGTH: 40;
+/** Regular expression matching a 20-byte (40 hex character) address string. */
+export declare const AddressRegEx: RegExp;
+type BrandedAddress = Brand<Hex, {
+    readonly __address: true;
+}>;
+/** Zod schema that validates and transforms a string into a branded Address type. */
+export declare const AddressZod: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<BrandedAddress, string>>;
+/** A validated 20-byte address string type, inferred from the AddressZod schema. */
+export type Address = z.infer<typeof AddressZod>;
+export {};
+//# sourceMappingURL=address.d.ts.map

package/dist/neutral/modules/hex/address/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../../../src/modules/hex/address/address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAG1C,uCAAuC;AACvC,eAAO,MAAM,YAAY,EAAiD,OAAO,CAAA;AACjF,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAG,EAAW,CAAA;AAEzC,+EAA+E;AAC/E,eAAO,MAAM,YAAY,QAAyD,CAAA;AAElF,KAAK,cAAc,GAAG,KAAK,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC,CAAA;AAE9D,qFAAqF;AACrF,eAAO,MAAM,UAAU,oFAGtB,CAAA;AAED,oFAAoF;AACpF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/dist/neutral/modules/hex/address/as.d.ts

@@ -0,0 +1,13 @@
+import type { AssertConfig } from '../../error/index.js';
+import type { Address } from './address.js';
+/**
+ * Attempts to coerce a value into an Address type, returning undefined or throwing based on the assert config.
+ * @param value - The value to coerce (must be a string)
+ * @param assert - If provided, throws on failure instead of returning undefined
+ * @returns The value as Address, or undefined if coercion fails and assert is not set
+ */
+export declare function asAddress(value?: unknown): Address | undefined;
+export declare function asAddress(value: unknown, assert: AssertConfig): Address;
+/** @alpha */
+export declare function asAddressV2(value?: unknown, assert?: boolean): Address | undefined;
+//# sourceMappingURL=as.d.ts.map

package/dist/neutral/modules/hex/address/as.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as.d.ts","sourceRoot":"","sources":["../../../../../src/modules/hex/address/as.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAK1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;AAC/D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAA;AAqBxE,aAAa;AACb,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,OAAO,GAAG,SAAS,CAIhF"}

package/dist/neutral/modules/hex/address/index.d.ts

@@ -0,0 +1,7 @@
+export * from './address.js';
+export * from './AddressTransformZod.js';
+export * from './AddressValidationZod.js';
+export * from './as.js';
+export * from './is.js';
+export * from './to.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/hex/address/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/hex/address/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}