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

package/README.md

@@ -7,9 +7,11 @@ A lightweight, middleware-friendly fetch client for TypeScript projects.
 
 ## ✨ Features
 
+- **Pit of Success Design**: Simple defaults that just work, customizable when needed
 - Simple API: `api.get('/api/user')`
-- Built-in CSRF token support
+- Built-in CSRF token support (XSRF-TOKEN standard)
 - Automatic 401 redirect handling
+- Retry middleware with configurable strategies
 - Custom middleware support (request/response)
 - TypeScript-first, small and dependency-free
 
@@ -21,6 +23,8 @@ npm install @fgrzl/fetch
 
 ## 🚀 Quick Start
 
+**Level 1: Just works with defaults**
+
 ```ts
 import api from "@fgrzl/fetch";
 
@@ -32,26 +36,25 @@ if (response.ok) {
 }
 ```
 
-Or create a custom instance:
+**Level 2: Custom configuration when needed**
 
 ```ts
-import { FetchClient, useCSRF, useUnauthorized } from "@fgrzl/fetch";
+import { FetchClient, useCSRF, useAuthorization, useRetry } from "@fgrzl/fetch";
 
 const client = new FetchClient({
   credentials: "same-origin",
 });
 
-useCSRF(client, {
-  cookieName: "csrf_token",
-  headerName: "X-CSRF-Token",
-});
-
-useUnauthorized(client, {
-  loginPath: "/login",
-});
+// Smart defaults - just works
+useCSRF(client);
+useAuthorization(client);
+useRetry(client);
 
 // All requests now return FetchResponse<T>
-interface User { id: number; name: string; }
+interface User {
+  id: number;
+  name: string;
+}
 const userResponse = await client.get<User>("/api/user");
 if (userResponse.ok) {
   console.log(userResponse.data.name); // Typed access to data

package/dist/cjs/client/fetch-client.d.ts

@@ -0,0 +1,189 @@
+/**
+ * @fileoverview Enhanced fetch client with intercept middleware architecture.
+ */
+import type { FetchResponse, FetchClientOptions } from './types';
+/**
+ * Intercept middleware type that allows full control over request/response cycle.
+ * Middleware can modify requests, handle responses, implement retries, etc.
+ */
+export type FetchMiddleware = (request: RequestInit & {
+    url?: string;
+}, next: (modifiedRequest?: RequestInit & {
+    url?: string;
+}) => Promise<FetchResponse<unknown>>) => Promise<FetchResponse<unknown>>;
+/**
+ * Enhanced HTTP client with intercept middleware architecture.
+ *
+ * Features:
+ * - 🎯 Smart defaults (JSON content-type, same-origin credentials)
+ * - 🔧 Powerful middleware system for cross-cutting concerns
+ * - 🛡️ Consistent error handling (never throws, always returns response)
+ * - 📦 TypeScript-first with full type inference
+ * - 🚀 Modern async/await API
+ *
+ * @example Basic usage:
+ * ```typescript
+ * const client = new FetchClient();
+ *
+ * // GET request - just works
+ * const users = await client.get<User[]>('/api/users');
+ * if (users.ok) {
+ *   console.log(users.data); // Type is User[]
+ * }
+ *
+ * // POST request - JSON by default
+ * const result = await client.post('/api/users', { name: 'John' });
+ * ```
+ *
+ * @example With middleware:
+ * ```typescript
+ * const client = new FetchClient();
+ *
+ * // Add auth middleware
+ * client.use((request, next) => {
+ *   request.headers = { ...request.headers, Authorization: 'Bearer token' };
+ *   return next(request);
+ * });
+ *
+ * // Now all requests include auth
+ * const data = await client.get('/api/protected');
+ * ```
+ */
+export declare class FetchClient {
+    private middlewares;
+    private credentials;
+    constructor(config?: FetchClientOptions);
+    use(middleware: FetchMiddleware): this;
+    request<T = unknown>(url: string, init?: RequestInit): Promise<FetchResponse<T>>;
+    private coreFetch;
+    private parseResponse;
+    private buildUrlWithParams;
+    /**
+     * HEAD request with query parameter support.
+     *
+     * HEAD requests are used to retrieve metadata about a resource without downloading
+     * the response body. Useful for checking if a resource exists, getting content length,
+     * last modified date, etc.
+     *
+     * @template T - Expected response data type (will be null for HEAD requests)
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to typed response (data will always be null)
+     *
+     * @example Check if resource exists:
+     * ```typescript
+     * const headResponse = await client.head('/api/large-file.zip');
+     * if (headResponse.ok) {
+     *   const contentLength = headResponse.headers.get('content-length');
+     *   const lastModified = headResponse.headers.get('last-modified');
+     *   console.log(`File size: ${contentLength} bytes`);
+     * }
+     * ```
+     *
+     * @example Check with query parameters:
+     * ```typescript
+     * const exists = await client.head('/api/users', { id: 123 });
+     * if (exists.status === 404) {
+     *   console.log('User not found');
+     * }
+     * ```
+     */
+    head<T = null>(url: string, params?: Record<string, string | number | boolean | undefined>): Promise<FetchResponse<T>>;
+    /**
+     * HEAD request that returns useful metadata about a resource.
+     *
+     * This is a convenience method that extracts common metadata from HEAD responses
+     * for easier consumption.
+     *
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to response with extracted metadata
+     *
+     * @example Get resource metadata:
+     * ```typescript
+     * const metadata = await client.headMetadata('/api/large-file.zip');
+     * if (metadata.ok) {
+     *   console.log('File exists:', metadata.exists);
+     *   console.log('Content type:', metadata.contentType);
+     *   console.log('Size:', metadata.contentLength, 'bytes');
+     *   console.log('Last modified:', metadata.lastModified);
+     * }
+     * ```
+     */
+    headMetadata(url: string, params?: Record<string, string | number | boolean | undefined>): Promise<FetchResponse<null> & {
+        exists: boolean;
+        contentType: string | undefined;
+        contentLength: number | undefined;
+        lastModified: Date | undefined;
+        etag: string | undefined;
+        cacheControl: string | undefined;
+    }>;
+    /**
+     * GET request with query parameter support.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to typed response
+     *
+     * @example
+     * ```typescript
+     * const users = await client.get<User[]>('/api/users');
+     * const filteredUsers = await client.get<User[]>('/api/users', { status: 'active', limit: 10 });
+     * if (users.ok) console.log(users.data);
+     * ```
+     */
+    get<T>(url: string, params?: Record<string, string | number | boolean | undefined>): Promise<FetchResponse<T>>;
+    /**
+     * POST request with automatic JSON serialization.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON)
+     * @param headers - Additional headers (Content-Type: application/json is default)
+     * @returns Promise resolving to typed response
+     *
+     * @example
+     * ```typescript
+     * const result = await client.post<User>('/api/users', { name: 'John' });
+     * ```
+     */
+    post<T>(url: string, body?: unknown, headers?: Record<string, string>): Promise<FetchResponse<T>>;
+    /**
+     * PUT request with automatic JSON serialization.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON)
+     * @param headers - Additional headers (Content-Type: application/json is default)
+     * @returns Promise resolving to typed response
+     */
+    put<T>(url: string, body?: unknown, headers?: Record<string, string>): Promise<FetchResponse<T>>;
+    /**
+     * PATCH request with automatic JSON serialization.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON)
+     * @param headers - Additional headers (Content-Type: application/json is default)
+     * @returns Promise resolving to typed response
+     */
+    patch<T>(url: string, body?: unknown, headers?: Record<string, string>): Promise<FetchResponse<T>>;
+    /**
+     * DELETE request with query parameter support.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to typed response
+     *
+     * @example
+     * ```typescript
+     * const result = await client.del('/api/users/123');
+     * const bulkResult = await client.del('/api/users', { status: 'inactive', force: true });
+     * if (result.ok) console.log('Deleted successfully');
+     * ```
+     */
+    del<T>(url: string, params?: Record<string, string | number | boolean | undefined>): Promise<FetchResponse<T>>;
+}
+//# sourceMappingURL=fetch-client.d.ts.map

package/dist/cjs/client/fetch-client.d.ts.map

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

package/dist/cjs/client/fetch-client.js

@@ -0,0 +1,339 @@
+"use strict";
+/**
+ * @fileoverview Enhanced fetch client with intercept middleware architecture.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetchClient = void 0;
+/**
+ * Enhanced HTTP client with intercept middleware architecture.
+ *
+ * Features:
+ * - 🎯 Smart defaults (JSON content-type, same-origin credentials)
+ * - 🔧 Powerful middleware system for cross-cutting concerns
+ * - 🛡️ Consistent error handling (never throws, always returns response)
+ * - 📦 TypeScript-first with full type inference
+ * - 🚀 Modern async/await API
+ *
+ * @example Basic usage:
+ * ```typescript
+ * const client = new FetchClient();
+ *
+ * // GET request - just works
+ * const users = await client.get<User[]>('/api/users');
+ * if (users.ok) {
+ *   console.log(users.data); // Type is User[]
+ * }
+ *
+ * // POST request - JSON by default
+ * const result = await client.post('/api/users', { name: 'John' });
+ * ```
+ *
+ * @example With middleware:
+ * ```typescript
+ * const client = new FetchClient();
+ *
+ * // Add auth middleware
+ * client.use((request, next) => {
+ *   request.headers = { ...request.headers, Authorization: 'Bearer token' };
+ *   return next(request);
+ * });
+ *
+ * // Now all requests include auth
+ * const data = await client.get('/api/protected');
+ * ```
+ */
+class FetchClient {
+    constructor(config = {}) {
+        this.middlewares = [];
+        this.credentials = config.credentials ?? 'same-origin';
+    }
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    async request(url, init = {}) {
+        // Create the execution chain
+        let index = 0;
+        const execute = async (request) => {
+            // Use provided request or fall back to original
+            const currentRequest = request || { ...init, url };
+            const currentUrl = currentRequest.url || url;
+            if (index >= this.middlewares.length) {
+                // Core fetch - end of middleware chain
+                const { url: _, ...requestInit } = currentRequest; // Remove url from request init
+                return this.coreFetch(requestInit, currentUrl);
+            }
+            const middleware = this.middlewares[index++];
+            if (!middleware) {
+                const { url: _, ...requestInit } = currentRequest;
+                return this.coreFetch(requestInit, currentUrl);
+            }
+            return middleware(currentRequest, execute);
+        };
+        const result = await execute();
+        return result;
+    }
+    async coreFetch(request, url) {
+        try {
+            const finalInit = {
+                credentials: this.credentials,
+                ...request,
+            };
+            // Convert Headers object to plain object for better compatibility
+            if (finalInit.headers instanceof Headers) {
+                const headersObj = {};
+                finalInit.headers.forEach((value, key) => {
+                    headersObj[key] = value;
+                });
+                finalInit.headers = headersObj;
+            }
+            const response = await fetch(url, finalInit);
+            const data = await this.parseResponse(response);
+            return {
+                data: response.ok ? data : null,
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                url: response.url,
+                ok: response.ok,
+                ...(response.ok
+                    ? {}
+                    : {
+                        error: {
+                            message: response.statusText,
+                            body: data,
+                        },
+                    }),
+            };
+        }
+        catch (error) {
+            if (error instanceof TypeError && error.message.includes('fetch')) {
+                return {
+                    data: null,
+                    status: 0,
+                    statusText: 'Network Error',
+                    headers: new Headers(),
+                    url,
+                    ok: false,
+                    error: {
+                        message: 'Failed to fetch',
+                        body: error,
+                    },
+                };
+            }
+            throw error;
+        }
+    }
+    async parseResponse(res) {
+        const contentType = res.headers.get('content-type') || '';
+        if (contentType.includes('application/json')) {
+            return res.json();
+        }
+        if (contentType.includes('text/')) {
+            return res.text();
+        }
+        if (contentType.includes('application/octet-stream') ||
+            contentType.includes('image/') ||
+            contentType.includes('video/') ||
+            contentType.includes('audio/')) {
+            return res.blob();
+        }
+        if (res.body) {
+            const text = await res.text();
+            return text || null;
+        }
+        return null;
+    }
+    // Helper method to build URL with query parameters
+    buildUrlWithParams(url, params) {
+        if (!params) {
+            return url;
+        }
+        const urlObj = new URL(url, url.startsWith('http') ? undefined : 'http://localhost');
+        Object.entries(params).forEach(([key, value]) => {
+            if (value !== undefined && value !== null) {
+                urlObj.searchParams.set(key, String(value));
+            }
+        });
+        // If the original URL was relative, return just the pathname + search
+        if (!url.startsWith('http')) {
+            return urlObj.pathname + urlObj.search;
+        }
+        return urlObj.toString();
+    }
+    // 🎯 PIT OF SUCCESS: Convenience methods with smart defaults
+    /**
+     * HEAD request with query parameter support.
+     *
+     * HEAD requests are used to retrieve metadata about a resource without downloading
+     * the response body. Useful for checking if a resource exists, getting content length,
+     * last modified date, etc.
+     *
+     * @template T - Expected response data type (will be null for HEAD requests)
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to typed response (data will always be null)
+     *
+     * @example Check if resource exists:
+     * ```typescript
+     * const headResponse = await client.head('/api/large-file.zip');
+     * if (headResponse.ok) {
+     *   const contentLength = headResponse.headers.get('content-length');
+     *   const lastModified = headResponse.headers.get('last-modified');
+     *   console.log(`File size: ${contentLength} bytes`);
+     * }
+     * ```
+     *
+     * @example Check with query parameters:
+     * ```typescript
+     * const exists = await client.head('/api/users', { id: 123 });
+     * if (exists.status === 404) {
+     *   console.log('User not found');
+     * }
+     * ```
+     */
+    head(url, params) {
+        const finalUrl = this.buildUrlWithParams(url, params);
+        return this.request(finalUrl, { method: 'HEAD' });
+    }
+    /**
+     * HEAD request that returns useful metadata about a resource.
+     *
+     * This is a convenience method that extracts common metadata from HEAD responses
+     * for easier consumption.
+     *
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to response with extracted metadata
+     *
+     * @example Get resource metadata:
+     * ```typescript
+     * const metadata = await client.headMetadata('/api/large-file.zip');
+     * if (metadata.ok) {
+     *   console.log('File exists:', metadata.exists);
+     *   console.log('Content type:', metadata.contentType);
+     *   console.log('Size:', metadata.contentLength, 'bytes');
+     *   console.log('Last modified:', metadata.lastModified);
+     * }
+     * ```
+     */
+    async headMetadata(url, params) {
+        const response = await this.head(url, params);
+        const contentLengthHeader = response.headers.get('content-length');
+        const lastModifiedHeader = response.headers.get('last-modified');
+        return {
+            ...response,
+            exists: response.ok,
+            contentType: response.headers.get('content-type') || undefined,
+            contentLength: contentLengthHeader ? parseInt(contentLengthHeader, 10) : undefined,
+            lastModified: lastModifiedHeader ? new Date(lastModifiedHeader) : undefined,
+            etag: response.headers.get('etag') || undefined,
+            cacheControl: response.headers.get('cache-control') || undefined,
+        };
+    }
+    /**
+     * GET request with query parameter support.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to typed response
+     *
+     * @example
+     * ```typescript
+     * const users = await client.get<User[]>('/api/users');
+     * const filteredUsers = await client.get<User[]>('/api/users', { status: 'active', limit: 10 });
+     * if (users.ok) console.log(users.data);
+     * ```
+     */
+    get(url, params) {
+        const finalUrl = this.buildUrlWithParams(url, params);
+        return this.request(finalUrl, { method: 'GET' });
+    }
+    /**
+     * POST request with automatic JSON serialization.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON)
+     * @param headers - Additional headers (Content-Type: application/json is default)
+     * @returns Promise resolving to typed response
+     *
+     * @example
+     * ```typescript
+     * const result = await client.post<User>('/api/users', { name: 'John' });
+     * ```
+     */
+    post(url, body, headers) {
+        const requestHeaders = {
+            'Content-Type': 'application/json',
+            ...(headers ?? {}),
+        };
+        return this.request(url, {
+            method: 'POST',
+            headers: requestHeaders,
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+    }
+    /**
+     * PUT request with automatic JSON serialization.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON)
+     * @param headers - Additional headers (Content-Type: application/json is default)
+     * @returns Promise resolving to typed response
+     */
+    put(url, body, headers) {
+        const requestHeaders = {
+            'Content-Type': 'application/json',
+            ...(headers ?? {}),
+        };
+        return this.request(url, {
+            method: 'PUT',
+            headers: requestHeaders,
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+    }
+    /**
+     * PATCH request with automatic JSON serialization.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param body - Request body (auto-serialized to JSON)
+     * @param headers - Additional headers (Content-Type: application/json is default)
+     * @returns Promise resolving to typed response
+     */
+    patch(url, body, headers) {
+        const requestHeaders = {
+            'Content-Type': 'application/json',
+            ...(headers ?? {}),
+        };
+        return this.request(url, {
+            method: 'PATCH',
+            headers: requestHeaders,
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+    }
+    /**
+     * DELETE request with query parameter support.
+     *
+     * @template T - Expected response data type
+     * @param url - Request URL
+     * @param params - Query parameters to append to URL
+     * @returns Promise resolving to typed response
+     *
+     * @example
+     * ```typescript
+     * const result = await client.del('/api/users/123');
+     * const bulkResult = await client.del('/api/users', { status: 'inactive', force: true });
+     * if (result.ok) console.log('Deleted successfully');
+     * ```
+     */
+    del(url, params) {
+        const finalUrl = this.buildUrlWithParams(url, params);
+        return this.request(finalUrl, { method: 'DELETE' });
+    }
+}
+exports.FetchClient = FetchClient;
+//# sourceMappingURL=fetch-client.js.map

package/dist/cjs/client/fetch-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-client.js","sourceRoot":"","sources":["../../../src/client/fetch-client.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAeH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAa,WAAW;IAItB,YAAY,SAA6B,EAAE;QAHnC,gBAAW,GAAsB,EAAE,CAAC;QAI1C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,aAAa,CAAC;IACzD,CAAC;IAED,GAAG,CAAC,UAA2B;QAC7B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CACX,GAAW,EACX,OAAoB,EAAE;QAEtB,6BAA6B;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,OAAO,GAAG,KAAK,EACnB,OAAwC,EACP,EAAE;YACnC,gDAAgD;YAChD,MAAM,cAAc,GAAG,OAAO,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;YACnD,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,IAAI,GAAG,CAAC;YAE7C,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACrC,uCAAuC;gBACvC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,cAAc,CAAC,CAAC,+BAA+B;gBAClF,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,cAAc,CAAC;gBAClD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,UAAU,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;QAC/B,OAAO,MAA0B,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,OAAoB,EACpB,GAAW;QAEX,IAAI,CAAC;YACH,MAAM,SAAS,GAAG;gBAChB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,GAAG,OAAO;aACX,CAAC;YAEF,kEAAkE;YAClE,IAAI,SAAS,CAAC,OAAO,YAAY,OAAO,EAAE,CAAC;gBACzC,MAAM,UAAU,GAA2B,EAAE,CAAC;gBAC9C,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACvC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC1B,CAAC,CAAC,CAAC;gBACH,SAAS,CAAC,OAAO,GAAG,UAAU,CAAC;YACjC,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAEhD,OAAO;gBACL,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,GAAG,CAAC,QAAQ,CAAC,EAAE;oBACb,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,KAAK,EAAE;4BACL,OAAO,EAAE,QAAQ,CAAC,UAAU;4BAC5B,IAAI,EAAE,IAAI;yBACX;qBACF,CAAC;aACP,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClE,OAAO;oBACL,IAAI,EAAE,IAAI;oBACV,MAAM,EAAE,CAAC;oBACT,UAAU,EAAE,eAAe;oBAC3B,OAAO,EAAE,IAAI,OAAO,EAAE;oBACtB,GAAG;oBACH,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE;wBACL,OAAO,EAAE,iBAAiB;wBAC1B,IAAI,EAAE,KAAK;qBACZ;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAa;QACvC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAE1D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAED,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAED,IACE,WAAW,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAChD,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC9B,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC9B,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC9B,CAAC;YACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,IAAI,IAAI,IAAI,CAAC;QACtB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mDAAmD;IAC3C,kBAAkB,CACxB,GAAW,EACX,MAA8D;QAE9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,GAAG,EACH,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CACxD,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,sEAAsE;QACtE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,6DAA6D;IAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,IAAI,CACF,GAAW,EACX,MAA8D;QAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,YAAY,CAChB,GAAW,EACX,MAA8D;QAW9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE9C,MAAM,mBAAmB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACnE,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAEjE,OAAO;YACL,GAAG,QAAQ;YACX,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS;YAC9D,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAClF,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS;YAC3E,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS;YAC/C,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,SAAS;SACjE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CACD,GAAW,EACX,MAA8D;QAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,GAAW,EACX,IAAc,EACd,OAAgC;QAEhC,MAAM,cAAc,GAAG;YACrB,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;SACnB,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE;YAC1B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,cAAc;YACvB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CACD,GAAW,EACX,IAAc,EACd,OAAgC;QAEhC,MAAM,cAAc,GAAG;YACrB,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;SACnB,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE;YAC1B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,cAAc;YACvB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CACH,GAAW,EACX,IAAc,EACd,OAAgC;QAEhC,MAAM,cAAc,GAAG;YACrB,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;SACnB,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE;YAC1B,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,cAAc;YACvB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CACD,GAAW,EACX,MAA8D;QAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;CACF;AAxXD,kCAwXC"}

package/dist/cjs/client/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Client module exports - "Pit of Success" design.
+ *
+ * This module provides a clean, discoverable API:
+ * 🎯 Level 1: FetchClient class (what 90% of users need)
+ * 🎯 Level 2: Types for TypeScript users (auto-discovered via IntelliSense)
+ */
+export { FetchClient } from './fetch-client';
+export type { FetchMiddleware } from './fetch-client';
+export type { FetchResponse, FetchClientOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/cjs/client/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * @fileoverview Client module exports - "Pit of Success" design.
+ *
+ * This module provides a clean, discoverable API:
+ * 🎯 Level 1: FetchClient class (what 90% of users need)
+ * 🎯 Level 2: Types for TypeScript users (auto-discovered via IntelliSense)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetchClient = void 0;
+// 🎯 LEVEL 1: Main client class - the "pit of success" entry point
+var fetch_client_1 = require("./fetch-client");
+Object.defineProperty(exports, "FetchClient", { enumerable: true, get: function () { return fetch_client_1.FetchClient; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,mEAAmE;AACnE,+CAA6C;AAApC,2GAAA,WAAW,OAAA"}