@cedvict/http-guardian 0.0.1-next.0 → 0.0.1-next.10

package/dist/internal/context.d.ts

@@ -0,0 +1,57 @@
+import type { HttpMethod } from "../client/types.js";
+import type { AuthConfig } from "../auth/authConfig.js";
+import type { Notifier } from "../notify/types.js";
+import type { HeadersPolyfill } from "./headersPolyfill.js";
+/**
+ * Meta side-channel attached to a RequestContext. Populated by guards (e.g.
+ * correlationIdGuard, idempotencyGuard) and parsers (envelope) so downstream
+ * plugins (logger, sentry, otel) can pick the values up without having to
+ * re-read headers.
+ *
+ * All fields are optional — a context without a `meta` object is valid and
+ * keeps backwards compatibility.
+ */
+export type RequestContextMeta = {
+    /** ID corrélation propagé en header (cf. correlationIdGuard). */
+    correlationId?: string;
+    /** Clé d'idempotence (cf. idempotencyGuard / RequestOptions.idempotencyKey). */
+    idempotencyKey?: string;
+    /** Trace ID lu depuis l'enveloppe de réponse (parser-dependent). */
+    traceId?: string;
+    /** Span ID lu depuis l'enveloppe de réponse (parser-dependent). */
+    spanId?: string;
+    /** Enveloppe brute exposée par le parser (cf. createApiParserStructured). */
+    envelope?: unknown;
+};
+export type RequestContext = {
+    /**
+     * Base URL configured on the client (always set by createHttpClient).
+     * Useful for guards that need to resolve relative URLs reliably.
+     */
+    baseUrl: string;
+    /**
+     * Origin derived from baseUrl (scheme + host + port).
+     * Used for security checks like "don't attach auth headers cross-origin".
+     */
+    baseOrigin: string;
+    method: HttpMethod;
+    url: string;
+    headers: Headers | HeadersPolyfill;
+    credentials?: RequestCredentials;
+    redirect?: RequestRedirect;
+    body?: BodyInit;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    attempt: number;
+    auth: AuthConfig;
+    noAuth?: boolean;
+    notifier?: Notifier;
+    idempotencyKey?: string;
+    /**
+     * Meta side-channel for guards/parsers/plugins. Always undefined unless a
+     * guard or parser populates it; consumers must check `ctx.meta != null`.
+     */
+    meta?: RequestContextMeta;
+    _fetch: typeof fetch;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/internal/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/internal/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;IACnC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,OAAO,KAAK,CAAC;CACtB,CAAC"}

package/dist/internal/headersPolyfill.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Minimal Headers polyfill (enough for http-guardian guards + client internals).
+ *
+ * Why: Node < 18 doesn't expose global Headers/Request/Response by default.
+ * We only need a mutable header bag during guard pipeline; when calling fetch we
+ * convert to a plain object so any fetch implementation (browser, edge, node)
+ * can consume it.
+ */
+export type HeadersInitLike = Headers | Record<string, string> | Array<[string, string]> | Iterable<[string, string]>;
+export declare class HeadersPolyfill {
+    private map;
+    constructor(init?: HeadersInitLike);
+    get(name: string): string | null;
+    has(name: string): boolean;
+    set(name: string, value: string): void;
+    append(name: string, value: string): void;
+    delete(name: string): void;
+    forEach(cb: (value: string, key: string) => void): void;
+    entries(): IterableIterator<[string, string]>;
+    /** Convert to HeadersInit that any fetch can consume. */
+    toObject(): Record<string, string>;
+}
+export declare function createHeaders(init?: HeadersInitLike): Headers | HeadersPolyfill;
+export declare function toFetchHeaders(headers: Headers | HeadersPolyfill): HeadersInit;
+//# sourceMappingURL=headersPolyfill.d.ts.map

package/dist/internal/headersPolyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headersPolyfill.d.ts","sourceRoot":"","sources":["../../src/internal/headersPolyfill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAM/B,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAsD;gBAErD,IAAI,CAAC,EAAE,eAAe;IAqBlC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKhC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUzC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIvD,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAc7C,yDAAyD;IACzD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAKnC;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,eAAe,CAK/E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,WAAW,CAK9E"}

package/dist/internal/stableStringify.d.ts

@@ -0,0 +1,2 @@
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=stableStringify.d.ts.map

package/dist/internal/stableStringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableStringify.d.ts","sourceRoot":"","sources":["../../src/internal/stableStringify.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/internal/url.d.ts

@@ -0,0 +1,3 @@
+export declare function joinUrl(baseUrl: string, path: string): string;
+export declare function withQuery(url: string, query?: Record<string, string | number | boolean | null | undefined>): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/internal/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/internal/url.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAQnH"}

package/dist/notify/defaults.d.ts

@@ -0,0 +1,9 @@
+import type { Notifier, NotifyEvent } from "./types.js";
+export declare const consoleNotifier: Notifier;
+export declare const alertNotifier: Notifier;
+/**
+ * Returns an HTML string you can inject in your own UI layer (Tailwind classes).
+ * Note: this package does not manipulate the DOM by itself.
+ */
+export declare function tailwindAlertRenderer(event: NotifyEvent): string;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/notify/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/notify/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,eAAe,EAAE,QAI7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAI3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAWhE"}

package/dist/notify/types.d.ts

@@ -0,0 +1,33 @@
+import type { AppError } from "../client/errors.js";
+export type NotifyEvent = {
+    type: "http-error";
+    level: "error" | "warning";
+    title: string;
+    message: string;
+    status: number;
+    errors?: AppError[];
+    url: string;
+} | {
+    type: "network-error";
+    level: "error";
+    title: string;
+    message: string;
+    url: string;
+} | {
+    type: "parse-error";
+    level: "error";
+    title: string;
+    message: string;
+    url: string;
+};
+/**
+ * Optional redaction hook.
+ *
+ * Use this if your notifier logs events and you want to strip secrets from `url`
+ * (e.g. query params), or to remove error details before sending to telemetry.
+ */
+export type Notifier = {
+    notify: (event: NotifyEvent) => void;
+    redact?: (event: NotifyEvent) => NotifyEvent;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/notify/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/notify/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpI;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,CAAC;CAC9C,CAAC"}

package/dist/parsing/apiParserStructured.d.ts

@@ -0,0 +1,94 @@
+import type { ShapeParser } from "./shapeParser.js";
+/**
+ * Parser pour une enveloppe HTTP "structurée" : succès / erreurs typées avec
+ * `issues[]`, `i18n`, et `meta { traceId, spanId, timestamp }`.
+ *
+ * Cette forme est typique des backends qui exposent un protocole d'erreur
+ * uniforme (FastAPI, NestJS custom, etc.) avec :
+ * - une distinction `success: boolean`
+ * - une liste d'issues structurées (code, message, category, severity,
+ *   retryable, i18n)
+ * - un bloc meta de tracing (traceId, spanId)
+ *
+ * @example
+ * // Succès
+ * { "success": true, "data": { ... }, "meta": { "traceId": "...", "timestamp": "..." } }
+ *
+ * @example
+ * // Erreur
+ * {
+ *   "success": false,
+ *   "code": "AUTH_OTP_INVALID",
+ *   "message": "Auth otp invalid",
+ *   "issues": [
+ *     {
+ *       "code": "AUTH_OTP_INVALID",
+ *       "message": "...",
+ *       "category": "auth",
+ *       "severity": "error",
+ *       "retryable": false,
+ *       "i18n": { "key": "auth.otp_invalid", "params": {}, "locale": null }
+ *     }
+ *   ],
+ *   "i18n": { "key": "...", "params": {}, "locale": null },
+ *   "meta": { "traceId": "...", "spanId": "...", "timestamp": "..." }
+ * }
+ */
+export type StructuredI18n = {
+    key?: string;
+    params?: Record<string, unknown>;
+    locale?: string | null;
+};
+export type StructuredIssue = {
+    code?: string;
+    message?: string;
+    category?: string;
+    severity?: string;
+    retryable?: boolean;
+    i18n?: StructuredI18n;
+    field?: string;
+};
+export type StructuredEnvelopeMeta = {
+    traceId?: string;
+    spanId?: string;
+    timestamp?: string;
+    [k: string]: unknown;
+};
+export type StructuredSuccessEnvelope<T = unknown> = {
+    success: true;
+    data: T;
+    meta?: StructuredEnvelopeMeta;
+};
+export type StructuredErrorEnvelope = {
+    success: false;
+    code?: string;
+    message?: string;
+    issues?: StructuredIssue[];
+    i18n?: StructuredI18n;
+    meta?: StructuredEnvelopeMeta;
+};
+export type StructuredEnvelope<T = unknown> = StructuredSuccessEnvelope<T> | StructuredErrorEnvelope;
+export type ApiParserStructuredOptions = {
+    /** Garde l'enveloppe `meta` accessible via `AppError.details.envelope`. */
+    exposeMeta?: boolean;
+    /**
+     * Pour les erreurs avec `retryable: false`, marquer la requête comme
+     * non-retryable (via `details.retryable`). Le retry plugin peut consulter
+     * ce flag via un `isRetryableRequest` custom — voir docs.
+     */
+    honorRetryableHint?: boolean;
+};
+/**
+ * Parser pour une enveloppe structurée à `issues[]` + `i18n` + `meta` de tracing.
+ *
+ * - Succès : `data = envelope.data`
+ * - Erreur : chaque `issue` est mappée en `AppError`, avec en `details` les
+ *   informations riches (code, category, severity, retryable, i18n, traceId,
+ *   spanId, timestamp, enveloppe brute si `exposeMeta=true`).
+ *
+ * Le `traceId` / `spanId` de l'enveloppe se retrouvent dans :
+ * - `errors[0].details.traceId` / `.spanId` (côté erreur)
+ * - `errors[0].details.envelope.meta` (enveloppe brute, si `exposeMeta`)
+ */
+export declare function createApiParserStructured(opts?: ApiParserStructuredOptions): ShapeParser;
+//# sourceMappingURL=apiParserStructured.d.ts.map

package/dist/parsing/apiParserStructured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiParserStructured.d.ts","sourceRoot":"","sources":["../../src/parsing/apiParserStructured.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,yBAAyB,CAAC,CAAC,GAAG,OAAO,IAAI;IACnD,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,sBAAsB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,IAAI,CAAC,EAAE,sBAAsB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IACtC,yBAAyB,CAAC,CAAC,CAAC,GAC5B,uBAAuB,CAAC;AAE5B,MAAM,MAAM,0BAA0B,GAAG;IACvC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAWF;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,0BAA+B,GAAG,WAAW,CAqE5F"}

package/dist/parsing/presets.d.ts

@@ -0,0 +1,15 @@
+import { type ShapeParser } from "./shapeParser.js";
+export declare function createApiParserRestClassic(opts?: {
+    successField?: string;
+    dataField?: string;
+    errorField?: string;
+    messageField?: string;
+}): ShapeParser;
+export declare function createApiParserLaravel(opts?: {
+    dataField?: string;
+}): ShapeParser;
+export declare function createApiParserNest(): ShapeParser;
+export declare function createApiParserGraphQL(opts?: {
+    allowPartialData?: boolean;
+}): ShapeParser;
+//# sourceMappingURL=presets.d.ts.map

package/dist/parsing/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/parsing/presets.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEvE,wBAAgB,0BAA0B,CAAC,IAAI,CAAC,EAAE;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,WAAW,CA4Bd;AAED,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAOjF;AAmBD,wBAAgB,mBAAmB,IAAI,WAAW,CAMjD;AAaD,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CAyBzF"}

package/dist/parsing/schemaAdapter.d.ts

@@ -0,0 +1,18 @@
+export type Schema<T> = {
+    parse: (input: unknown) => T;
+};
+export declare function schema<T>(impl: Schema<T>): Schema<T>;
+/**
+ * Optional helper to wrap a zod-like schema without adding a dependency.
+ */
+export declare function fromZod<T>(zodSchema: {
+    parse?: (i: unknown) => T;
+    safeParse?: (i: unknown) => {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}): Schema<T>;
+//# sourceMappingURL=schemaAdapter.d.ts.map

package/dist/parsing/schemaAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaAdapter.d.ts","sourceRoot":"","sources":["../../src/parsing/schemaAdapter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAA;CAAE,CAAC;AAEzD,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE;IACpC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC;IAC1B,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7F,GAAG,MAAM,CAAC,CAAC,CAAC,CAYZ"}

package/dist/parsing/shapeParser.d.ts

@@ -0,0 +1,8 @@
+import type { AppError } from "../client/errors.js";
+export type ShapeParser = {
+    isSuccess: (raw: unknown, status: number) => boolean;
+    getData: (raw: unknown) => unknown;
+    getErrors: (raw: unknown, status: number) => AppError[];
+};
+export declare function createShapeParser(p: ShapeParser): ShapeParser;
+//# sourceMappingURL=shapeParser.d.ts.map

package/dist/parsing/shapeParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapeParser.d.ts","sourceRoot":"","sources":["../../src/parsing/shapeParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IACnC,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;CACzD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,22 @@
+import type { HttpClientOptions } from "../client/types.js";
+/**
+ * Minimal, stable plugin interface.
+ *
+ * Goals:
+ * - keep createHttpClient fully configurable (raw options still work)
+ * - allow wrappers/presets to be composed without deep coupling
+ * - avoid hidden side-effects: plugins only mutate a draft options object
+ */
+export type HttpPlugin = {
+    /**
+     * Stable identifier (useful for debugging / de-dupe).
+     */
+    name: string;
+    /**
+     * Apply changes to the draft options.
+     *
+     * Important: keep it synchronous to preserve deterministic config.
+     */
+    apply: (options: HttpClientOptions) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC7C,CAAC"}

package/dist/presets/presetBuilder.d.ts

@@ -0,0 +1,181 @@
+import type { HttpClientOptions } from "../client/types.js";
+import type { ShapeParser } from "../parsing/shapeParser.js";
+import type { AuthConfig } from "../auth/authConfig.js";
+import { bearerAuth, cookieAuth, basicAuth, apiKeyAuth } from "../auth/authConfig.js";
+import type { Guard } from "../guards/types.js";
+import { type CookieSafeRefreshGuardOptions } from "../guards/cookieSafeRefreshGuard.js";
+import { type UnauthorizedGuardOptions } from "../guards/unauthorizedGuard.js";
+import { type MemoryCacheOptions } from "../cache/memoryCache.js";
+import type { Notifier } from "../notify/types.js";
+/**
+ * Option B: preset builder
+ * - defaults to a "classic REST envelope" parser
+ * - defaults to noAuth()
+ * - provides convenience methods for common auth modes & cookie refresh
+ *
+ * If you need full control, call createHttpClient directly.
+ */
+export type PresetBuilder = ReturnType<typeof createPresetBuilder>;
+export declare function createPresetBuilder(init?: {
+    baseUrl?: string;
+    parser?: ShapeParser;
+    auth?: AuthConfig;
+    fetch?: typeof globalThis.fetch;
+    notifier?: Notifier;
+}): {
+    /** Set / override baseUrl */
+    baseUrl(baseUrl: string): /*elided*/ any;
+    /** Set / override parser */
+    parser(parser: ShapeParser): /*elided*/ any;
+    /** Set / override fetch */
+    fetch(fetchImpl: typeof globalThis.fetch): /*elided*/ any;
+    /** Set / override notifier */
+    notifier(notifier: Notifier): /*elided*/ any;
+    /** Add guard(s) (preserves order) */
+    guards(...guards: Guard[]): /*elided*/ any;
+    /** Enable in-memory cache */
+    memoryCache(opts?: MemoryCacheOptions): /*elided*/ any;
+    /** Low-level cache assignment */
+    cache(cache: HttpClientOptions["cache"]): /*elided*/ any;
+    /** Default headers / timeouts / notify policy */
+    defaults(defaults: HttpClientOptions["defaults"]): /*elided*/ any;
+    /** Redirect policy */
+    redirects(redirects: HttpClientOptions["redirects"]): /*elided*/ any;
+    /** Auth presets */
+    auth(auth: AuthConfig): /*elided*/ any;
+    bearer(getToken: Parameters<typeof bearerAuth>[0], opts?: Parameters<typeof bearerAuth>[1]): /*elided*/ any;
+    cookie(opts?: Parameters<typeof cookieAuth>[0]): /*elided*/ any;
+    basic(getCred: Parameters<typeof basicAuth>[0], opts?: Parameters<typeof basicAuth>[1]): /*elided*/ any;
+    apiKey(getKey: Parameters<typeof apiKeyAuth>[0], opts?: Parameters<typeof apiKeyAuth>[1]): /*elided*/ any;
+    none(): /*elided*/ any;
+    /**
+     * Cookie refresh guard preset (only meaningful for cookie auth).
+     * You can still add it manually via `.guards(...)`.
+     */
+    cookieRefresh(opts: CookieSafeRefreshGuardOptions): /*elided*/ any;
+    /** Unauthorized handler preset (redirect/logout). */
+    unauthorized(opts: UnauthorizedGuardOptions): /*elided*/ any;
+    /** Returns the final HttpClientOptions */
+    options(): HttpClientOptions;
+    /** Creates the http client */
+    create(): {
+        get: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+        post: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+        put: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+        patch: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+        delete: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+        cache: {
+            invalidateByTag: (tag: string) => number;
+            clear: () => void | undefined;
+        };
+    };
+};
+/**
+ * Option A (aliases): minimal-instantiation helpers.
+ * They are thin wrappers around the preset builder.
+ */
+export declare function createSimpleClient(opts: {
+    baseUrl: string;
+    /** Defaults to classic REST envelope parser */
+    parser?: ShapeParser;
+    /** Defaults to noAuth */
+    auth?: AuthConfig;
+    fetch?: typeof globalThis.fetch;
+    notifier?: Notifier;
+}): {
+    get: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    post: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    put: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    patch: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    delete: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    cache: {
+        invalidateByTag: (tag: string) => number;
+        clear: () => void | undefined;
+    };
+};
+export declare function createBearerClient(opts: {
+    baseUrl: string;
+    getToken: () => string | null | Promise<string | null>;
+    parser?: ShapeParser;
+    fetch?: typeof globalThis.fetch;
+    notifier?: Notifier;
+    headerName?: string;
+    prefix?: string;
+}): {
+    get: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    post: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    put: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    patch: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    delete: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    cache: {
+        invalidateByTag: (tag: string) => number;
+        clear: () => void | undefined;
+    };
+};
+export declare function createCookieClient(opts: {
+    baseUrl: string;
+    parser?: ShapeParser;
+    fetch?: typeof globalThis.fetch;
+    notifier?: Notifier;
+    credentials?: RequestCredentials;
+    csrf?: {
+        headerName: string;
+        getToken: () => string | null | Promise<string | null>;
+    };
+    refresh?: CookieSafeRefreshGuardOptions | null;
+}): {
+    get: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    post: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    put: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    patch: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    delete: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    cache: {
+        invalidateByTag: (tag: string) => number;
+        clear: () => void | undefined;
+    };
+};
+export declare function createBasicClient(opts: {
+    baseUrl: string;
+    getCredentials: () => {
+        username: string;
+        password: string;
+    } | string | null | Promise<{
+        username: string;
+        password: string;
+    } | string | null>;
+    parser?: ShapeParser;
+    fetch?: typeof globalThis.fetch;
+    notifier?: Notifier;
+    headerName?: string;
+    prefix?: string;
+}): {
+    get: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    post: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    put: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    patch: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    delete: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    cache: {
+        invalidateByTag: (tag: string) => number;
+        clear: () => void | undefined;
+    };
+};
+export declare function createApiKeyClient(opts: {
+    baseUrl: string;
+    getKey: () => string | null | Promise<string | null>;
+    parser?: ShapeParser;
+    fetch?: typeof globalThis.fetch;
+    notifier?: Notifier;
+    headerName?: string;
+    prefix?: string;
+}): {
+    get: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    post: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    put: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    patch: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    delete: <T>(path: string, ro?: import("../publicTypes.js").RequestOptions<T>) => Promise<import("../publicTypes.js").ClientResult<T>>;
+    cache: {
+        invalidateByTag: (tag: string) => number;
+        clear: () => void | undefined;
+    };
+};
+//# sourceMappingURL=presetBuilder.d.ts.map

package/dist/presets/presetBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetBuilder.d.ts","sourceRoot":"","sources":["../../src/presets/presetBuilder.ts"],"names":[],"mappings":"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"}

package/dist/publicTypes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public types surface for consumers.
+ * Keep this stable to avoid breaking changes.
+ */
+export type { HttpMethod, RequestOptions, ClientResult, HttpClientOptions } from "./client/types.js";
+export type { AppError } from "./client/errors.js";
+export type { AuthConfig, BearerAuthConfig, CookieAuthConfig, BasicAuthConfig, ApiKeyAuthConfig, NoneAuthConfig, } from "./auth/authConfig.js";
+export type { Notifier, NotifyEvent } from "./notify/types.js";
+export type { RequestContext } from "./internal/context.js";
+export type { Guard } from "./guards/types.js";
+export type { PresetBuilder } from "./presets/presetBuilder.js";
+//# sourceMappingURL=publicTypes.d.ts.map

package/dist/publicTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicTypes.d.ts","sourceRoot":"","sources":["../src/publicTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrG,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,25 +1,30 @@
 {
   "name": "@cedvict/http-guardian",
-  "version": "0.0.1-next.0",
+  "version": "0.0.1-next.10",
   "description": "Configurable HTTP client for TypeScript: auth (bearer/cookie), guards, cache+dedupe, dynamic envelope parsing presets, notifications, redirect handling.",
   "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
       "default": "./dist/index.js"
     }
   },
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
     "README.md",
     "LICENSE",
-    "TESTING.md"
+    "TESTING.md",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "keywords": [
     "http",
@@ -41,7 +46,7 @@
     "url": "git+https://github.com/cedvict/http-guardian.git"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.dts.json",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:unit": "vitest run test/unit",