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

package/dist/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/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/client/fetch-client.js

@@ -0,0 +1,335 @@
+/**
+ * @fileoverview Enhanced fetch client with intercept middleware architecture.
+ */
+/**
+ * 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 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' });
+    }
+}
+//# sourceMappingURL=fetch-client.js.map

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

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

package/dist/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/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/client/index.js

@@ -0,0 +1,10 @@
+/**
+ * @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)
+ */
+// 🎯 LEVEL 1: Main client class - the "pit of success" entry point
+export { FetchClient } from './fetch-client';
+//# sourceMappingURL=index.js.map

package/dist/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,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Type definitions for the HTTP client.
+ *
+ * This file contains core TypeScript interfaces and types for FetchClient.
+ * Designed for discoverability and type safety.
+ */
+/**
+ * Typed response wrapper with consistent shape.
+ *
+ * ✅ Always returns this shape (never throws)
+ * ✅ Use `.ok` to check success
+ * ✅ Use `.data` for parsed response
+ * ✅ Use `.error` for failure details
+ *
+ * @template T - The expected type of the response data
+ *
+ * @example
+ * ```typescript
+ * const result = await client.get<User[]>('/api/users');
+ * if (result.ok) {
+ *   console.log(result.data); // Type is User[]
+ * } else {
+ *   console.error(result.error?.message); // Handle error
+ * }
+ * ```
+ */
+export interface FetchResponse<T> {
+    /** The parsed response data (null if request failed) */
+    data: T | null;
+    /** HTTP status code (0 for network errors) */
+    status: number;
+    /** HTTP status text ('Network Error' for network failures) */
+    statusText: string;
+    /** Response headers */
+    headers: Headers;
+    /** The request URL */
+    url: string;
+    /** True if status 200-299, false otherwise */
+    ok: boolean;
+    /** Error details when ok is false */
+    error?: {
+        /** Human-readable error message */
+        message: string;
+        /** Raw error response body */
+        body?: unknown;
+    };
+}
+/**
+ * Configuration options for FetchClient.
+ *
+ * Optimized for "pit of success" - good defaults, minimal required config.
+ */
+export interface FetchClientOptions {
+    /**
+     * Controls credential handling for requests.
+     *
+     * - 'same-origin' (default): Send cookies for same-origin requests
+     * - 'include': Always send cookies
+     * - 'omit': Never send cookies
+     */
+    credentials?: RequestCredentials;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,wDAAwD;IACxD,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,qCAAqC;IACrC,KAAK,CAAC,EAAE;QACN,mCAAmC;QACnC,OAAO,EAAE,MAAM,CAAC;QAChB,8BAA8B;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC"}

package/dist/client/types.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Type definitions for the HTTP client.
+ *
+ * This file contains core TypeScript interfaces and types for FetchClient.
+ * Designed for discoverability and type safety.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}