@fgrzl/fetch 1.1.0-alpha.3 → 1.1.0-alpha.7

package/dist/errors/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Custom error classes - "Pit of Success" pattern.
+ *
+ * 🎯 LEVEL 1: HttpError, NetworkError - Most common error types you'll catch
+ * 🎯 LEVEL 2: FetchError - Base error class for advanced error handling
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.get('/api/data');
+ * } catch (error) {
+ *   if (error instanceof HttpError) {
+ *     console.log(`HTTP ${error.status}: ${error.statusText}`);
+ *   } else if (error instanceof NetworkError) {
+ *     console.log('Network connection failed');
+ *   }
+ * }
+ * ```
+ */
+/**
+ * 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: unknown;
+    /**
+     * 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: unknown, 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);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,gCAAgC;IAChC,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;IAE9B;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO3C;AAID;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACvC,2BAA2B;IAC3B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,uCAAuC;IACvC,SAAgB,IAAI,EAAE,OAAO,CAAC;IAE9B;;;;;;OAMG;gBACS,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM;CAO3E;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAIxD"}

package/dist/errors/index.js

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Custom error classes - "Pit of Success" pattern.
+ *
+ * 🎯 LEVEL 1: HttpError, NetworkError - Most common error types you'll catch
+ * 🎯 LEVEL 2: FetchError - Base error class for advanced error handling
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.get('/api/data');
+ * } catch (error) {
+ *   if (error instanceof HttpError) {
+ *     console.log(`HTTP ${error.status}: ${error.statusText}`);
+ *   } else if (error instanceof NetworkError) {
+ *     console.log('Network connection failed');
+ *   }
+ * }
+ * ```
+ */
+// 🎯 LEVEL 2: Base error class (for advanced use cases)
+/**
+ * Base error class for all fetch client errors.
+ */
+export 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';
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+    }
+}
+// 🎯 LEVEL 1: Most commonly used error types
+/**
+ * Error thrown when an HTTP request fails with a non-2xx status code.
+ */
+export 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;
+    }
+}
+/**
+ * Error thrown when a network request fails completely.
+ */
+export 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';
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wDAAwD;AAExD;;GAEG;AACH,MAAM,OAAO,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,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAED,6CAA6C;AAE7C;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,UAAU;IAQvC;;;;;;OAMG;IACH,YAAY,MAAc,EAAE,UAAkB,EAAE,IAAa,EAAE,GAAW;QACxE,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;AAED;;GAEG;AACH,MAAM,OAAO,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"}

package/dist/index.d.ts

@@ -1,36 +1,65 @@
 /**
- * @fileoverview Default configured fetch client with CSRF protection and unauthorized handling.
+ * @fileoverview Main library entry point with "pit of success" architecture.
  *
- * 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
+ * This module exports everything users need in order of discoverability:
+ * 1. Pre-configured client with smart defaults (80% of users start here)
+ * 2. FetchClient for custom configurations
+ * 3. Individual middleware functions for specific needs
+ * 4. Pre-built middleware stacks for common scenarios
+ * 5. Types for TypeScript users
  */
-import { FetchClient } from './client';
+import { FetchClient } from './client/fetch-client';
 /**
- * Pre-configured fetch client with CSRF protection and unauthorized handling.
+ * 🎯 PIT OF SUCCESS: Pre-configured fetch client (Level 1 - 80% of users)
  *
- * This client is ready to use for applications that need:
- * - CSRF protection
- * - Automatic login redirects on authentication failures
- * - Same-origin cookie handling
+ * This client is ready to use out of the box with production-ready middleware:
+ * - Authentication support (configure your token provider)
+ * - Automatic retries with exponential backoff
+ * - Response caching for GET requests
+ * - Request/response logging
+ * - Rate limiting protection
+ * - Same-origin credentials for session-based auth (cookies)
  *
- * @example
+ * @example Just import and use:
  * ```typescript
  * import api from '@fgrzl/fetch';
  *
- * // GET request
+ * // Works immediately - no setup required!
  * const users = await api.get('/api/users');
- *
- * // POST request (automatically includes CSRF token)
  * const newUser = await api.post('/api/users', { name: 'John' });
+ *
+ * // With query parameters
+ * const activeUsers = await api.get('/api/users', { status: 'active', limit: 10 });
+ * ```
+ *
+ * @example Configure authentication:
+ * ```typescript
+ * import api from '@fgrzl/fetch';
+ * import { useAuthentication } from '@fgrzl/fetch/middleware';
+ *
+ * const authClient = useAuthentication(api, {
+ *   tokenProvider: () => localStorage.getItem('auth-token') || ''
+ * });
+ * ```
+ *
+ * @example For token-only auth (no cookies):
+ * ```typescript
+ * import { FetchClient, useAuthentication } from '@fgrzl/fetch';
+ *
+ * const tokenClient = useAuthentication(new FetchClient({
+ *   credentials: 'omit' // Don't send cookies
+ * }), {
+ *   tokenProvider: () => getJWTToken()
+ * });
  * ```
  */
 declare const api: FetchClient;
 export default api;
+export { FetchClient } from './client/fetch-client';
 export { FetchError, HttpError, NetworkError } from './errors';
-export { FetchClient } from './client';
-export type { RequestMiddleware, ResponseMiddleware, FetchClientConfig, FetchResponse, } from './client';
-export { useCSRF } from './csrf';
-export { useUnauthorized } from './unauthorized';
-export type { UnauthorizedConfig } from './unauthorized';
+export { useAuthentication, createAuthenticationMiddleware, useAuthorization, createAuthorizationMiddleware, useCache, createCacheMiddleware, useCSRF, useLogging, createLoggingMiddleware, useRateLimit, createRateLimitMiddleware, useRetry, createRetryMiddleware, } from './middleware';
+export { useProductionStack, useDevelopmentStack, useBasicStack, } from './middleware';
+export type { FetchMiddleware as InterceptMiddleware } from './client/fetch-client';
+export type { FetchResponse, FetchClientOptions } from './client/types';
+export type { AuthenticationOptions, AuthTokenProvider, AuthorizationOptions, UnauthorizedHandler, CacheOptions, CacheStorage, CacheEntry, CacheKeyGenerator, LoggingOptions, Logger, LogLevel, RateLimitOptions, RateLimitAlgorithm, RetryOptions, } from './middleware';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,QAAA,MAAM,GAAG,aAwBR,CAAC;AAGF,eAAe,GAAG,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG/D,OAAO,EAEL,iBAAiB,EACjB,8BAA8B,EAE9B,gBAAgB,EAChB,6BAA6B,EAE7B,QAAQ,EACR,qBAAqB,EAErB,OAAO,EAEP,UAAU,EACV,uBAAuB,EAEvB,YAAY,EACZ,yBAAyB,EAEzB,QAAQ,EACR,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGxE,YAAY,EAEV,qBAAqB,EACrB,iBAAiB,EAEjB,oBAAoB,EACpB,mBAAmB,EAEnB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EAEjB,cAAc,EACd,MAAM,EACN,QAAQ,EAER,gBAAgB,EAChB,kBAAkB,EAElB,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,58 +1,102 @@
-"use strict";
 /**
- * @fileoverview Default configured fetch client with CSRF protection and unauthorized handling.
+ * @fileoverview Main library entry point with "pit of success" architecture.
  *
- * 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
+ * This module exports everything users need in order of discoverability:
+ * 1. Pre-configured client with smart defaults (80% of users start here)
+ * 2. FetchClient for custom configurations
+ * 3. Individual middleware functions for specific needs
+ * 4. Pre-built middleware stacks for common scenarios
+ * 5. Types for TypeScript users
  */
-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");
+import { FetchClient } from './client/fetch-client';
+import { useProductionStack } from './middleware';
 /**
- * Pre-configured fetch client with CSRF protection and unauthorized handling.
+ * 🎯 PIT OF SUCCESS: Pre-configured fetch client (Level 1 - 80% of users)
  *
- * This client is ready to use for applications that need:
- * - CSRF protection
- * - Automatic login redirects on authentication failures
- * - Same-origin cookie handling
+ * This client is ready to use out of the box with production-ready middleware:
+ * - Authentication support (configure your token provider)
+ * - Automatic retries with exponential backoff
+ * - Response caching for GET requests
+ * - Request/response logging
+ * - Rate limiting protection
+ * - Same-origin credentials for session-based auth (cookies)
  *
- * @example
+ * @example Just import and use:
  * ```typescript
  * import api from '@fgrzl/fetch';
  *
- * // GET request
+ * // Works immediately - no setup required!
  * const users = await api.get('/api/users');
- *
- * // POST request (automatically includes CSRF token)
  * const newUser = await api.post('/api/users', { name: 'John' });
+ *
+ * // With query parameters
+ * const activeUsers = await api.get('/api/users', { status: 'active', limit: 10 });
+ * ```
+ *
+ * @example Configure authentication:
+ * ```typescript
+ * import api from '@fgrzl/fetch';
+ * import { useAuthentication } from '@fgrzl/fetch/middleware';
+ *
+ * const authClient = useAuthentication(api, {
+ *   tokenProvider: () => localStorage.getItem('auth-token') || ''
+ * });
+ * ```
+ *
+ * @example For token-only auth (no cookies):
+ * ```typescript
+ * import { FetchClient, useAuthentication } from '@fgrzl/fetch';
+ *
+ * const tokenClient = useAuthentication(new FetchClient({
+ *   credentials: 'omit' // Don't send cookies
+ * }), {
+ *   tokenProvider: () => getJWTToken()
+ * });
  * ```
  */
-const api = new client_1.FetchClient({
+const api = useProductionStack(new FetchClient({
+    // Smart default: include cookies for session-based auth
+    // Can be overridden by creating a custom FetchClient
     credentials: 'same-origin',
+}), {
+    // Smart defaults - users can override as needed
+    retry: {
+        maxRetries: 2,
+        delay: 1000,
+    },
+    cache: {
+        ttl: 5 * 60 * 1000, // 5 minutes
+        methods: ['GET'],
+    },
+    logging: {
+        level: 'info',
+    },
+    rateLimit: {
+        maxRequests: 100,
+        windowMs: 60 * 1000, // 100 requests per minute
+    },
 });
-// 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; } });
+// 🎯 LEVEL 1: Export the production-ready client as default
+export default api;
+// 🎯 LEVEL 2: FetchClient for custom configurations
+export { FetchClient } from './client/fetch-client';
+export { FetchError, HttpError, NetworkError } from './errors';
+// 🎯 LEVEL 3: Individual middleware functions (import from our comprehensive middleware index)
+export { 
+// Authentication
+useAuthentication, createAuthenticationMiddleware, 
+// Authorization
+useAuthorization, createAuthorizationMiddleware, 
+// Cache
+useCache, createCacheMiddleware, 
+// CSRF
+useCSRF, 
+// Logging
+useLogging, createLoggingMiddleware, 
+// Rate Limiting
+useRateLimit, createRateLimitMiddleware, 
+// Retry
+useRetry, createRetryMiddleware, } from './middleware';
+// 🎯 LEVEL 4: Pre-built middleware stacks for common scenarios
+export { useProductionStack, useDevelopmentStack, useBasicStack, } from './middleware';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"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;AAOpB,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAChB,+CAAiD;AAAxC,+GAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,GAAG,GAAG,kBAAkB,CAC5B,IAAI,WAAW,CAAC;IACd,wDAAwD;IACxD,qDAAqD;IACrD,WAAW,EAAE,aAAa;CAC3B,CAAC,EACF;IACE,gDAAgD;IAChD,KAAK,EAAE;QACL,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,IAAI;KACZ;IACD,KAAK,EAAE;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;QAChC,OAAO,EAAE,CAAC,KAAK,CAAC;KACjB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,MAAM;KACd;IACD,SAAS,EAAE;QACT,WAAW,EAAE,GAAG;QAChB,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,0BAA0B;KAChD;CACF,CACF,CAAC;AAEF,4DAA4D;AAC5D,eAAe,GAAG,CAAC;AAEnB,oDAAoD;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D,+FAA+F;AAC/F,OAAO;AACL,iBAAiB;AACjB,iBAAiB,EACjB,8BAA8B;AAC9B,gBAAgB;AAChB,gBAAgB,EAChB,6BAA6B;AAC7B,QAAQ;AACR,QAAQ,EACR,qBAAqB;AACrB,OAAO;AACP,OAAO;AACP,UAAU;AACV,UAAU,EACV,uBAAuB;AACvB,gBAAgB;AAChB,YAAY,EACZ,yBAAyB;AACzB,QAAQ;AACR,QAAQ,EACR,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,+DAA+D;AAC/D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/middleware/authentication/authentication.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Authentication middleware implementation.
+ */
+import type { FetchMiddleware } from '../../client/fetch-client';
+import type { AuthenticationOptions } from './types';
+/**
+ * Creates authentication middleware with smart defaults.
+ * Automatically adds Bearer tokens to requests.
+ *
+ * @param options - Authentication configuration options
+ * @returns Authentication middleware for use with FetchClient
+ *
+ * @example Basic usage:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: () => localStorage.getItem('token') || ''
+ * });
+ * ```
+ *
+ * @example Async token provider:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: async () => {
+ *     const token = await getAuthToken();
+ *     return token || '';
+ *   }
+ * });
+ * ```
+ */
+export declare function createAuthenticationMiddleware(options: AuthenticationOptions): FetchMiddleware;
+//# sourceMappingURL=authentication.d.ts.map

package/dist/middleware/authentication/authentication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.d.ts","sourceRoot":"","sources":["../../../src/middleware/authentication/authentication.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAoCrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qBAAqB,GAC7B,eAAe,CAkDjB"}

package/dist/middleware/authentication/authentication.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Authentication middleware implementation.
+ */
+/**
+ * Checks if a URL should skip authentication based on configured patterns.
+ */
+function shouldSkipAuth(url, skipPatterns = []) {
+    return skipPatterns.some((pattern) => {
+        if (typeof pattern === 'string') {
+            return url.includes(pattern);
+        }
+        return pattern.test(url);
+    });
+}
+/**
+ * Checks if a URL should include authentication based on configured patterns.
+ */
+function shouldIncludeAuth(url, includePatterns) {
+    if (!includePatterns || includePatterns.length === 0) {
+        return true; // Include by default if no patterns specified
+    }
+    return includePatterns.some((pattern) => {
+        if (typeof pattern === 'string') {
+            return url.includes(pattern);
+        }
+        return pattern.test(url);
+    });
+}
+/**
+ * Creates authentication middleware with smart defaults.
+ * Automatically adds Bearer tokens to requests.
+ *
+ * @param options - Authentication configuration options
+ * @returns Authentication middleware for use with FetchClient
+ *
+ * @example Basic usage:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: () => localStorage.getItem('token') || ''
+ * });
+ * ```
+ *
+ * @example Async token provider:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: async () => {
+ *     const token = await getAuthToken();
+ *     return token || '';
+ *   }
+ * });
+ * ```
+ */
+export function createAuthenticationMiddleware(options) {
+    const { tokenProvider, headerName = 'Authorization', tokenType = 'Bearer', skipPatterns = [], includePatterns, } = options;
+    return async (request, next) => {
+        const url = request.url || '';
+        const parsedUrl = new URL(url);
+        const pathname = parsedUrl.pathname;
+        // Skip authentication if:
+        // 1. URL matches a skip pattern
+        // 2. URL doesn't match include patterns (if specified)
+        if (shouldSkipAuth(pathname, skipPatterns) ||
+            !shouldIncludeAuth(pathname, includePatterns)) {
+            return next(request);
+        }
+        try {
+            // Get auth token (may be async)
+            const token = await tokenProvider();
+            // Skip if no token available
+            if (!token) {
+                return next(request);
+            }
+            // Add auth header to request
+            const headers = new Headers(request.headers);
+            headers.set(headerName, `${tokenType} ${token}`);
+            // Create modified request with auth header
+            const modifiedRequest = {
+                ...request,
+                headers,
+            };
+            return next(modifiedRequest);
+        }
+        catch {
+            // If token provider fails, proceed without auth
+            // This ensures network requests don't fail due to auth issues
+            return next(request);
+        }
+    };
+}
+//# sourceMappingURL=authentication.js.map

package/dist/middleware/authentication/authentication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../../src/middleware/authentication/authentication.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,SAAS,cAAc,CACrB,GAAW,EACX,eAAoC,EAAE;IAEtC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,GAAW,EACX,eAAqC;IAErC,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,CAAC,8CAA8C;IAC7D,CAAC;IAED,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAA8B;IAE9B,MAAM,EACJ,aAAa,EACb,UAAU,GAAG,eAAe,EAC5B,SAAS,GAAG,QAAQ,EACpB,YAAY,GAAG,EAAE,EACjB,eAAe,GAChB,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAEpC,0BAA0B;QAC1B,gCAAgC;QAChC,uDAAuD;QACvD,IACE,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC;YACtC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,eAAe,CAAC,EAC7C,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,gCAAgC;YAChC,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;YAEpC,6BAA6B;YAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YAED,6BAA6B;YAC7B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC;YAEjD,2CAA2C;YAC3C,MAAM,eAAe,GAAG;gBACtB,GAAG,OAAO;gBACV,OAAO;aACR,CAAC;YAEF,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;YAChD,8DAA8D;YAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/middleware/authentication/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Authentication middleware - "pit of success" API.
+ */
+import type { FetchClient } from '../../client/fetch-client';
+import type { AuthenticationOptions } from './types';
+export type { AuthenticationOptions, AuthTokenProvider } from './types';
+export { createAuthenticationMiddleware } from './authentication';
+/**
+ * "Pit of success" API for adding authentication to a FetchClient.
+ * Automatically adds Bearer tokens to requests.
+ *
+ * @param client - The FetchClient to add authentication to
+ * @param options - Authentication configuration
+ * @returns A new FetchClient with authentication middleware
+ *
+ * @example Basic token from localStorage:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: () => localStorage.getItem('auth-token') || ''
+ * });
+ * ```
+ *
+ * @example Async token with refresh:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: async () => {
+ *     let token = localStorage.getItem('auth-token');
+ *     if (!token || isExpired(token)) {
+ *       token = await refreshToken();
+ *     }
+ *     return token || '';
+ *   }
+ * });
+ * ```
+ */
+export declare function useAuthentication(client: FetchClient, options: AuthenticationOptions): FetchClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/authentication/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/authentication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAIrD,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,qBAAqB,GAC7B,WAAW,CAEb"}

package/dist/middleware/authentication/index.js

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Authentication middleware - "pit of success" API.
+ */
+import { createAuthenticationMiddleware } from './authentication';
+export { createAuthenticationMiddleware } from './authentication';
+/**
+ * "Pit of success" API for adding authentication to a FetchClient.
+ * Automatically adds Bearer tokens to requests.
+ *
+ * @param client - The FetchClient to add authentication to
+ * @param options - Authentication configuration
+ * @returns A new FetchClient with authentication middleware
+ *
+ * @example Basic token from localStorage:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: () => localStorage.getItem('auth-token') || ''
+ * });
+ * ```
+ *
+ * @example Async token with refresh:
+ * ```typescript
+ * const authClient = useAuthentication(client, {
+ *   tokenProvider: async () => {
+ *     let token = localStorage.getItem('auth-token');
+ *     if (!token || isExpired(token)) {
+ *       token = await refreshToken();
+ *     }
+ *     return token || '';
+ *   }
+ * });
+ * ```
+ */
+export function useAuthentication(client, options) {
+    return client.use(createAuthenticationMiddleware(options));
+}
+//# sourceMappingURL=index.js.map

package/dist/middleware/authentication/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/authentication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAIlE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmB,EACnB,OAA8B;IAE9B,OAAO,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7D,CAAC"}