@fgrzl/fetch 1.0.0-ci.11 → 1.1.0-alpha.2

package/dist/client.d.ts

@@ -1,18 +1,111 @@
+/**
+ * Middleware function that processes requests before they are sent.
+ * Can modify request options and URL.
+ * @param req - The request configuration object
+ * @param url - The request URL
+ * @returns A promise that resolves to a tuple of [modified request, modified URL]
+ */
 export type RequestMiddleware = (req: RequestInit, url: string) => Promise<[RequestInit, string]>;
+/**
+ * Middleware function that processes responses after they are received.
+ * Can modify or replace the response.
+ * @param res - The response object
+ * @returns A promise that resolves to the modified response
+ */
 export type ResponseMiddleware = (res: Response) => Promise<Response>;
+/**
+ * Configuration options for FetchClient.
+ */
 export interface FetchClientConfig {
+    /** Controls whether credentials are sent with requests. Defaults to 'same-origin'. */
     credentials?: RequestCredentials;
 }
+/**
+ * A configurable HTTP client with middleware support.
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient({
+ *   credentials: 'same-origin'
+ * });
+ *
+ * // Add middleware
+ * client.useRequestMiddleware(async (req, url) => {
+ *   return [{ ...req, headers: { ...req.headers, 'Auth': 'token' } }, url];
+ * });
+ *
+ * // Make requests
+ * const data = await client.get('/api/users');
+ * ```
+ */
 export declare class FetchClient {
     private requestMiddlewares;
     private responseMiddlewares;
     private credentials;
+    /**
+     * Creates a new FetchClient instance.
+     * @param config - Configuration options for the client
+     */
     constructor(config?: FetchClientConfig);
+    /**
+     * Adds a request middleware to the client.
+     * Request middlewares are executed in the order they are added.
+     * @param middleware - The middleware function to add
+     */
     useRequestMiddleware(middleware: RequestMiddleware): void;
+    /**
+     * Adds a response middleware to the client.
+     * Response middlewares are executed in the order they are added.
+     * @param middleware - The middleware function to add
+     */
     useResponseMiddleware(middleware: ResponseMiddleware): void;
+    /**
+     * Makes an HTTP request with middleware processing.
+     *
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param init - Request configuration options
+     * @returns Promise that resolves to the parsed JSON response
+     * @throws The error object from the response if the request fails
+     */
     request<T = any>(url: string, init?: RequestInit): Promise<T>;
+    /**
+     * Makes a GET request.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @returns Promise that resolves to the parsed JSON response
+     */
     get<T>(url: string): Promise<T>;
-    post<T>(url: string, body: any): Promise<T>;
-    put<T>(url: string, body: any): Promise<T>;
+    /**
+     * Helper method for requests with JSON body.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param method - The HTTP method
+     * @param body - The request body data (will be JSON stringified)
+     * @returns Promise that resolves to the parsed JSON response
+     */
+    private requestWithJsonBody;
+    /**
+     * Makes a POST request with JSON body.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param body - The request body data (will be JSON stringified)
+     * @returns Promise that resolves to the parsed JSON response
+     */
+    post<T>(url: string, body?: any): Promise<T>;
+    /**
+     * Makes a PUT request with JSON body.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param body - The request body data (will be JSON stringified)
+     * @returns Promise that resolves to the parsed JSON response
+     */
+    put<T>(url: string, body?: any): Promise<T>;
+    /**
+     * Makes a DELETE request.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @returns Promise that resolves to the parsed JSON response
+     */
     del<T>(url: string): Promise<T>;
 }

package/dist/client.js

@@ -1,50 +1,137 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FetchClient = void 0;
+const errors_1 = require("./errors");
+/**
+ * A configurable HTTP client with middleware support.
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient({
+ *   credentials: 'same-origin'
+ * });
+ *
+ * // Add middleware
+ * client.useRequestMiddleware(async (req, url) => {
+ *   return [{ ...req, headers: { ...req.headers, 'Auth': 'token' } }, url];
+ * });
+ *
+ * // Make requests
+ * const data = await client.get('/api/users');
+ * ```
+ */
 class FetchClient {
+    /**
+     * Creates a new FetchClient instance.
+     * @param config - Configuration options for the client
+     */
     constructor(config = {}) {
         this.requestMiddlewares = [];
         this.responseMiddlewares = [];
         this.credentials = config.credentials ?? 'same-origin';
     }
+    /**
+     * Adds a request middleware to the client.
+     * Request middlewares are executed in the order they are added.
+     * @param middleware - The middleware function to add
+     */
     useRequestMiddleware(middleware) {
         this.requestMiddlewares.push(middleware);
     }
+    /**
+     * Adds a response middleware to the client.
+     * Response middlewares are executed in the order they are added.
+     * @param middleware - The middleware function to add
+     */
     useResponseMiddleware(middleware) {
         this.responseMiddlewares.push(middleware);
     }
+    /**
+     * Makes an HTTP request with middleware processing.
+     *
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param init - Request configuration options
+     * @returns Promise that resolves to the parsed JSON response
+     * @throws The error object from the response if the request fails
+     */
     async request(url, init = {}) {
-        for (const mw of this.requestMiddlewares) {
-            [init, url] = await mw(init, url);
+        try {
+            for (const mw of this.requestMiddlewares) {
+                [init, url] = await mw(init, url);
+            }
+            let res = await fetch(url, {
+                credentials: this.credentials,
+                ...init,
+            });
+            for (const mw of this.responseMiddlewares) {
+                res = await mw(res);
+            }
+            if (!res.ok) {
+                const body = await res.json().catch(() => ({}));
+                throw new errors_1.HttpError(res.status, res.statusText, body, url);
+            }
+            return res.json();
         }
-        let res = await fetch(url, {
-            credentials: this.credentials,
-            ...init,
-        });
-        for (const mw of this.responseMiddlewares) {
-            res = await mw(res);
-        }
-        if (!res.ok) {
-            const error = await res.json().catch(() => ({}));
+        catch (error) {
+            if (error instanceof errors_1.HttpError) {
+                throw error;
+            }
+            if (error instanceof TypeError && error.message.includes('fetch')) {
+                throw new errors_1.NetworkError('Failed to fetch', url, error);
+            }
             throw error;
         }
-        return res.json();
     }
+    /**
+     * Makes a GET request.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @returns Promise that resolves to the parsed JSON response
+     */
     get(url) {
         return this.request(url, { method: 'GET' });
     }
-    post(url, body) {
+    /**
+     * Helper method for requests with JSON body.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param method - The HTTP method
+     * @param body - The request body data (will be JSON stringified)
+     * @returns Promise that resolves to the parsed JSON response
+     */
+    requestWithJsonBody(url, method, body) {
         return this.request(url, {
-            method: 'POST',
+            method,
             body: JSON.stringify(body),
         });
     }
+    /**
+     * Makes a POST request with JSON body.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param body - The request body data (will be JSON stringified)
+     * @returns Promise that resolves to the parsed JSON response
+     */
+    post(url, body) {
+        return this.requestWithJsonBody(url, 'POST', body ?? {});
+    }
+    /**
+     * Makes a PUT request with JSON body.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @param body - The request body data (will be JSON stringified)
+     * @returns Promise that resolves to the parsed JSON response
+     */
     put(url, body) {
-        return this.request(url, {
-            method: 'PUT',
-            body: JSON.stringify(body),
-        });
+        return this.requestWithJsonBody(url, 'PUT', body ?? {});
     }
+    /**
+     * Makes a DELETE request.
+     * @template T - The expected response type
+     * @param url - The URL to request
+     * @returns Promise that resolves to the parsed JSON response
+     */
     del(url) {
         return this.request(url, { method: 'DELETE' });
     }

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAUA,MAAa,WAAW;IAKtB,YAAY,SAA4B,EAAE;QAJlC,uBAAkB,GAAwB,EAAE,CAAC;QAC7C,wBAAmB,GAAyB,EAAE,CAAC;QAIrD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,aAAa,CAAC;IACzD,CAAC;IAEM,oBAAoB,CAAC,UAA6B;QACvD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAEM,qBAAqB,CAAC,UAA8B;QACzD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,GAAW,EACX,OAAoB,EAAE;QAEtB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACzC,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,IAAI;SACR,CAAC,CAAC;QAEH,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1C,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAEM,GAAG,CAAI,GAAW;QACvB,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAEM,IAAI,CAAI,GAAW,EAAE,IAAS;QACnC,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE;YAC1B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAEM,GAAG,CAAI,GAAW,EAAE,IAAS;QAClC,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE;YAC1B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAEM,GAAG,CAAI,GAAW;QACvB,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AA/DD,kCA+DC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/csrf.d.ts

@@ -1,7 +1,32 @@
 import { FetchClient } from './client';
+/**
+ * Configuration options for CSRF protection middleware.
+ */
 interface CsrfConfig {
+    /** Name of the cookie that contains the CSRF token */
     cookieName: string;
+    /** Name of the HTTP header to send the CSRF token in */
     headerName: string;
 }
+/**
+ * Configures CSRF protection for a FetchClient.
+ *
+ * This function adds middleware that:
+ * - Reads CSRF tokens from cookies and includes them in request headers
+ * - Updates CSRF tokens from response headers back to cookies
+ * - Automatically sets Content-Type to application/json for requests
+ *
+ * @param client - The FetchClient instance to configure
+ * @param config - CSRF configuration options
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient();
+ * useCSRF(client, {
+ *   cookieName: 'csrf_token',
+ *   headerName: 'X-CSRF-Token'
+ * });
+ * ```
+ */
 export declare function useCSRF(client: FetchClient, config: CsrfConfig): void;
 export {};

package/dist/csrf.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useCSRF = useCSRF;
+/**
+ * Creates a request middleware that adds CSRF token to requests.
+ * Reads the token from a cookie and adds it as a header.
+ *
+ * @param config - CSRF configuration options
+ * @returns Request middleware function
+ */
 function csrfMiddleware(config) {
     return async (req, url) => {
         const cookie = document.cookie.match(new RegExp(`${config.cookieName}=([^;]+)`));
@@ -13,6 +20,26 @@ function csrfMiddleware(config) {
         return [{ ...req, headers }, url];
     };
 }
+/**
+ * Configures CSRF protection for a FetchClient.
+ *
+ * This function adds middleware that:
+ * - Reads CSRF tokens from cookies and includes them in request headers
+ * - Updates CSRF tokens from response headers back to cookies
+ * - Automatically sets Content-Type to application/json for requests
+ *
+ * @param client - The FetchClient instance to configure
+ * @param config - CSRF configuration options
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchClient();
+ * useCSRF(client, {
+ *   cookieName: 'csrf_token',
+ *   headerName: 'X-CSRF-Token'
+ * });
+ * ```
+ */
 function useCSRF(client, config) {
     client.useRequestMiddleware(csrfMiddleware(config));
     client.useResponseMiddleware(async (res) => {

package/dist/csrf.js.map

@@ -1 +1 @@
-{"version":3,"file":"csrf.js","sourceRoot":"","sources":["../src/csrf.ts"],"names":[],"mappings":";;AAsBA,0BASC;AAxBD,SAAS,cAAc,CAAC,MAAkB;IACxC,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAClC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,UAAU,CAAC,CAC3C,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAG;YACd,GAAG,GAAG,CAAC,OAAO;YACd,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC;SAC7C,CAAC;QACF,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,OAAO,CAAC,MAAmB,EAAE,MAAkB;IAC7D,MAAM,CAAC,oBAAoB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACzC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,SAAS,WAAW,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"csrf.js","sourceRoot":"","sources":["../src/csrf.ts"],"names":[],"mappings":";;AAsDA,0BASC;AAnDD;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,MAAkB;IACxC,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAClC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,UAAU,CAAC,CAC3C,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAG;YACd,GAAG,GAAG,CAAC,OAAO;YACd,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC;SAC7C,CAAC;QACF,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,OAAO,CAAC,MAAmB,EAAE,MAAkB;IAC7D,MAAM,CAAC,oBAAoB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACzC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,SAAS,WAAW,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Custom error classes for the fetch client.
+ */
+/**
+ * Base error class for all fetch client errors.
+ */
+export declare class FetchError extends Error {
+    /** Optional underlying cause */
+    readonly cause?: Error;
+    /**
+     * Creates a new FetchError.
+     * @param message - Error message
+     * @param cause - Optional underlying cause
+     */
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when an HTTP request fails with a non-2xx status code.
+ */
+export declare class HttpError extends FetchError {
+    /** The HTTP status code */
+    readonly status: number;
+    /** The HTTP status text */
+    readonly statusText: string;
+    /** The response body (if available) */
+    readonly body: any;
+    /**
+     * Creates a new HttpError.
+     * @param status - HTTP status code
+     * @param statusText - HTTP status text
+     * @param body - Response body
+     * @param url - The request URL
+     */
+    constructor(status: number, statusText: string, body: any, url: string);
+}
+/**
+ * Error thrown when a network request fails completely.
+ */
+export declare class NetworkError extends FetchError {
+    /**
+     * Creates a new NetworkError.
+     * @param message - Error message
+     * @param url - The request URL
+     * @param cause - The underlying network error
+     */
+    constructor(message: string, url: string, cause?: Error);
+}

package/dist/errors.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * @fileoverview Custom error classes for the fetch client.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.HttpError = exports.FetchError = void 0;
+/**
+ * Base error class for all fetch client errors.
+ */
+class FetchError extends Error {
+    /**
+     * Creates a new FetchError.
+     * @param message - Error message
+     * @param cause - Optional underlying cause
+     */
+    constructor(message, cause) {
+        super(message);
+        this.name = 'FetchError';
+        this.cause = cause;
+    }
+}
+exports.FetchError = FetchError;
+/**
+ * Error thrown when an HTTP request fails with a non-2xx status code.
+ */
+class HttpError extends FetchError {
+    /**
+     * Creates a new HttpError.
+     * @param status - HTTP status code
+     * @param statusText - HTTP status text
+     * @param body - Response body
+     * @param url - The request URL
+     */
+    constructor(status, statusText, body, url) {
+        super(`HTTP ${status} ${statusText} at ${url}`);
+        this.name = 'HttpError';
+        this.status = status;
+        this.statusText = statusText;
+        this.body = body;
+    }
+}
+exports.HttpError = HttpError;
+/**
+ * Error thrown when a network request fails completely.
+ */
+class NetworkError extends FetchError {
+    /**
+     * Creates a new NetworkError.
+     * @param message - Error message
+     * @param url - The request URL
+     * @param cause - The underlying network error
+     */
+    constructor(message, url, cause) {
+        super(`Network error for ${url}: ${message}`, cause);
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,MAAa,UAAW,SAAQ,KAAK;IAInC;;;;OAIG;IACH,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAdD,gCAcC;AAED;;GAEG;AACH,MAAa,SAAU,SAAQ,UAAU;IAQvC;;;;;;OAMG;IACH,YAAY,MAAc,EAAE,UAAkB,EAAE,IAAS,EAAE,GAAW;QACpE,KAAK,CAAC,QAAQ,MAAM,IAAI,UAAU,OAAO,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAtBD,8BAsBC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,UAAU;IAC1C;;;;;OAKG;IACH,YAAY,OAAe,EAAE,GAAW,EAAE,KAAa;QACrD,KAAK,CAAC,qBAAqB,GAAG,KAAK,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAXD,oCAWC"}

package/dist/index.d.ts

@@ -1,3 +1,36 @@
+/**
+ * @fileoverview Default configured fetch client with CSRF protection and unauthorized handling.
+ *
+ * This module exports a pre-configured FetchClient instance with:
+ * - Same-origin credentials policy
+ * - CSRF protection using 'csrf_token' cookie and 'X-CSRF-Token' header
+ * - Automatic redirect to '/login' on 401 Unauthorized responses
+ */
 import { FetchClient } from './client';
+/**
+ * Pre-configured fetch client with CSRF protection and unauthorized handling.
+ *
+ * This client is ready to use for applications that need:
+ * - CSRF protection
+ * - Automatic login redirects on authentication failures
+ * - Same-origin cookie handling
+ *
+ * @example
+ * ```typescript
+ * import api from '@fgrzl/fetch';
+ *
+ * // GET request
+ * const users = await api.get('/api/users');
+ *
+ * // POST request (automatically includes CSRF token)
+ * const newUser = await api.post('/api/users', { name: 'John' });
+ * ```
+ */
 declare const api: FetchClient;
 export default api;
+export { FetchError, HttpError, NetworkError } from './errors';
+export { FetchClient } from './client';
+export type { RequestMiddleware, ResponseMiddleware, FetchClientConfig, } from './client';
+export { useCSRF } from './csrf';
+export { useUnauthorized } from './unauthorized';
+export type { UnauthorizedConfig } from './unauthorized';

package/dist/index.js

@@ -1,17 +1,58 @@
 "use strict";
+/**
+ * @fileoverview Default configured fetch client with CSRF protection and unauthorized handling.
+ *
+ * This module exports a pre-configured FetchClient instance with:
+ * - Same-origin credentials policy
+ * - CSRF protection using 'csrf_token' cookie and 'X-CSRF-Token' header
+ * - Automatic redirect to '/login' on 401 Unauthorized responses
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.useUnauthorized = exports.useCSRF = exports.FetchClient = exports.NetworkError = exports.HttpError = exports.FetchError = void 0;
 const client_1 = require("./client");
 const csrf_1 = require("./csrf");
 const unauthorized_1 = require("./unauthorized");
+/**
+ * Pre-configured fetch client with CSRF protection and unauthorized handling.
+ *
+ * This client is ready to use for applications that need:
+ * - CSRF protection
+ * - Automatic login redirects on authentication failures
+ * - Same-origin cookie handling
+ *
+ * @example
+ * ```typescript
+ * import api from '@fgrzl/fetch';
+ *
+ * // GET request
+ * const users = await api.get('/api/users');
+ *
+ * // POST request (automatically includes CSRF token)
+ * const newUser = await api.post('/api/users', { name: 'John' });
+ * ```
+ */
 const api = new client_1.FetchClient({
     credentials: 'same-origin',
 });
+// Configure CSRF protection
 (0, csrf_1.useCSRF)(api, {
     cookieName: 'csrf_token',
     headerName: 'X-CSRF-Token',
 });
+// Configure unauthorized redirect
 (0, unauthorized_1.useUnauthorized)(api, {
     loginPath: '/login',
 });
 exports.default = api;
+// Export error classes and types for consumers
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "FetchError", { enumerable: true, get: function () { return errors_1.FetchError; } });
+Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return errors_1.HttpError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+var client_2 = require("./client");
+Object.defineProperty(exports, "FetchClient", { enumerable: true, get: function () { return client_2.FetchClient; } });
+var csrf_2 = require("./csrf");
+Object.defineProperty(exports, "useCSRF", { enumerable: true, get: function () { return csrf_2.useCSRF; } });
+var unauthorized_2 = require("./unauthorized");
+Object.defineProperty(exports, "useUnauthorized", { enumerable: true, get: function () { return unauthorized_2.useUnauthorized; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA,qCAAuC;AACvC,iCAAiC;AACjC,iDAAiD;AAEjD,MAAM,GAAG,GAAG,IAAI,oBAAW,CAAC;IAC1B,WAAW,EAAE,aAAa;CAC3B,CAAC,CAAC;AAEH,IAAA,cAAO,EAAC,GAAG,EAAE;IACX,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEH,IAAA,8BAAe,EAAC,GAAG,EAAE;IACnB,SAAS,EAAE,QAAQ;CACpB,CAAC,CAAC;AAEH,kBAAe,GAAG,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,qCAAuC;AACvC,iCAAiC;AACjC,iDAAiD;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,GAAG,GAAG,IAAI,oBAAW,CAAC;IAC1B,WAAW,EAAE,aAAa;CAC3B,CAAC,CAAC;AAEH,4BAA4B;AAC5B,IAAA,cAAO,EAAC,GAAG,EAAE;IACX,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEH,kCAAkC;AAClC,IAAA,8BAAe,EAAC,GAAG,EAAE;IACnB,SAAS,EAAE,QAAQ;CACpB,CAAC,CAAC;AAEH,kBAAe,GAAG,CAAC;AAEnB,+CAA+C;AAC/C,mCAA+D;AAAtD,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,sGAAA,YAAY,OAAA;AAC5C,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAMpB,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAChB,+CAAiD;AAAxC,+GAAA,eAAe,OAAA"}

package/dist/test-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Shared test utilities to reduce duplication across test files.
+ */
+/**
+ * Sets up mock fetch for testing with automatic cleanup.
+ * @returns Object with mockFetch function and cleanup utilities
+ */
+export declare function setupMockFetch(): {
+    mockFetch: import("vitest").Mock<(...args: any[]) => any>;
+    setup: () => void;
+    cleanup: () => void;
+};
+/**
+ * Creates a mock Response object for testing.
+ * @param data - The response data to be JSON stringified
+ * @param status - HTTP status code (default: 200)
+ * @param headers - Additional headers (default: {})
+ * @returns Mock Response object
+ */
+export declare function createMockResponse(data: any, status?: number, headers?: Record<string, string>): Response;
+/**
+ * Clears all cookies in the document for testing.
+ */
+export declare function clearAllCookies(): void;

package/dist/test-utils.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @fileoverview Shared test utilities to reduce duplication across test files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupMockFetch = setupMockFetch;
+exports.createMockResponse = createMockResponse;
+exports.clearAllCookies = clearAllCookies;
+const vitest_1 = require("vitest");
+/**
+ * Sets up mock fetch for testing with automatic cleanup.
+ * @returns Object with mockFetch function and cleanup utilities
+ */
+function setupMockFetch() {
+    const mockFetch = vitest_1.vi.fn();
+    const originalFetch = globalThis.fetch;
+    const setup = () => {
+        vitest_1.vi.resetAllMocks();
+        globalThis.fetch = mockFetch;
+    };
+    const cleanup = () => {
+        globalThis.fetch = originalFetch;
+    };
+    return { mockFetch, setup, cleanup };
+}
+/**
+ * Creates a mock Response object for testing.
+ * @param data - The response data to be JSON stringified
+ * @param status - HTTP status code (default: 200)
+ * @param headers - Additional headers (default: {})
+ * @returns Mock Response object
+ */
+function createMockResponse(data, status = 200, headers = {}) {
+    return new Response(JSON.stringify(data), {
+        status,
+        headers: {
+            'Content-Type': 'application/json',
+            ...headers,
+        },
+    });
+}
+/**
+ * Clears all cookies in the document for testing.
+ */
+function clearAllCookies() {
+    document.cookie.split(';').forEach((c) => {
+        const eqPos = c.indexOf('=');
+        const name = eqPos > -1 ? c.substring(0, eqPos) : c;
+        document.cookie = `${name.trim()}=;expires=Thu, 01 Jan 1970 00:00:00 GMT;path=/`;
+    });
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAQH,wCAcC;AASD,gDAYC;AAKD,0CAMC;AApDD,mCAA4B;AAE5B;;;GAGG;AACH,SAAgB,cAAc;IAC5B,MAAM,SAAS,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IAC1B,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC;IAEvC,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,WAAE,CAAC,aAAa,EAAE,CAAC;QACnB,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAC/B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,UAAU,CAAC,KAAK,GAAG,aAAa,CAAC;IACnC,CAAC,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,IAAS,EACT,SAAiB,GAAG,EACpB,UAAkC,EAAE;IAEpC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM;QACN,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,GAAG,OAAO;SACX;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,gDAAgD,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC"}