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

package/README.md

@@ -24,7 +24,12 @@ npm install @fgrzl/fetch
 ```ts
 import api from "@fgrzl/fetch";
 
-const data = await api.get("/api/user");
+const response = await api.get("/api/user");
+if (response.ok) {
+  console.log(response.data); // Your typed data
+} else {
+  console.error(`Error ${response.status}:`, response.error?.message);
+}
 ```
 
 Or create a custom instance:
@@ -44,1095 +49,28 @@ useCSRF(client, {
 useUnauthorized(client, {
   loginPath: "/login",
 });
-```
-
-## 🧩 Middleware
-
-### Request Middleware
-
-Request middleware functions run before the HTTP request is sent, allowing you to modify request options and URLs.
-
-```ts
-import { FetchClient, RequestMiddleware } from "@fgrzl/fetch";
-
-const client = new FetchClient();
-
-// Add authentication header
-client.useRequestMiddleware(async (req, url) => {
-  const token = localStorage.getItem("auth-token");
-  const headers = {
-    ...req.headers,
-    ...(token && { Authorization: `Bearer ${token}` }),
-  };
-  return [{ ...req, headers }, url];
-});
-
-// Add debug information
-client.useRequestMiddleware(async (req, url) => {
-  const headers = {
-    ...req.headers,
-    "X-Debug": "true",
-    "X-Timestamp": new Date().toISOString(),
-  };
-  return [{ ...req, headers }, url];
-});
-```
-
-### Response Middleware
-
-Response middleware functions run after the HTTP response is received, allowing you to process or modify responses.
-
-```ts
-import { ResponseMiddleware } from "@fgrzl/fetch";
-
-// Log response times
-client.useResponseMiddleware(async (response) => {
-  console.log(`Request to ${response.url} took ${performance.now()}ms`);
-  return response;
-});
-
-// Extract and store updated auth tokens
-client.useResponseMiddleware(async (response) => {
-  const newToken = response.headers.get("X-New-Auth-Token");
-  if (newToken) {
-    localStorage.setItem("auth-token", newToken);
-  }
-  return response;
-});
-```
-
-### Middleware Execution Order
-
-Middlewares execute in the order they are registered:
-
-1. **Request middlewares**: Execute in registration order before the request
-2. **Response middlewares**: Execute in registration order after the response
-
-```ts
-const client = new FetchClient();
-
-// These will execute in this exact order:
-client.useRequestMiddleware(first); // 1st: runs first
-client.useRequestMiddleware(second); // 2nd: runs second
-client.useRequestMiddleware(third); // 3rd: runs third
-
-client.useResponseMiddleware(alpha); // 1st: processes response first
-client.useResponseMiddleware(beta); // 2nd: processes response second
-client.useResponseMiddleware(gamma); // 3rd: processes response third
-```
-
-## 🔄 Common Patterns
-
-### Authentication with Token Retry
-
-Automatically retry requests with fresh tokens when authentication fails:
-
-```ts
-import { FetchClient, HttpError } from "@fgrzl/fetch";
-
-const client = new FetchClient();
-
-// Request middleware: Add auth token
-client.useRequestMiddleware(async (req, url) => {
-  const token = localStorage.getItem("auth-token");
-  const headers = {
-    ...req.headers,
-    ...(token && { Authorization: `Bearer ${token}` }),
-  };
-  return [{ ...req, headers }, url];
-});
-
-// Response middleware: Handle token refresh
-client.useResponseMiddleware(async (response) => {
-  if (response.status === 401) {
-    // Try to refresh the token
-    const refreshToken = localStorage.getItem("refresh-token");
-    if (refreshToken) {
-      try {
-        const refreshResponse = await fetch("/auth/refresh", {
-          method: "POST",
-          headers: { Authorization: `Bearer ${refreshToken}` },
-        });
-
-        if (refreshResponse.ok) {
-          const { access_token } = await refreshResponse.json();
-          localStorage.setItem("auth-token", access_token);
-
-          // Clone and retry the original request
-          const retryResponse = await fetch(response.url, {
-            ...response,
-            headers: {
-              ...response.headers,
-              Authorization: `Bearer ${access_token}`,
-            },
-          });
-          return retryResponse;
-        }
-      } catch (error) {
-        console.error("Token refresh failed:", error);
-      }
-    }
-
-    // Redirect to login if refresh fails
-    window.location.href = "/login";
-  }
-  return response;
-});
-```
-
-### Request Correlation IDs
-
-Track requests across services with correlation IDs:
-
-```ts
-import { v4 as uuidv4 } from "uuid";
-
-client.useRequestMiddleware(async (req, url) => {
-  const correlationId = uuidv4();
-
-  // Store correlation ID for debugging
-  console.log(`Starting request ${correlationId} to ${url}`);
-
-  const headers = {
-    ...req.headers,
-    "X-Correlation-ID": correlationId,
-    "X-Request-ID": correlationId,
-  };
-
-  return [{ ...req, headers }, url];
-});
-
-client.useResponseMiddleware(async (response) => {
-  const correlationId = response.headers.get("X-Correlation-ID");
-  console.log(
-    `Completed request ${correlationId} with status ${response.status}`,
-  );
-  return response;
-});
-```
-
-### Eventual Consistency Polling
-
-Handle read-after-write scenarios by polling until data is available:
-
-```ts
-// Create a specialized client for polling operations
-const pollingClient = new FetchClient();
-
-pollingClient.useResponseMiddleware(async (response) => {
-  // If we get 404 on a read after write, poll until available
-  if (response.status === 404 && response.headers.get("X-Operation-ID")) {
-    const operationId = response.headers.get("X-Operation-ID");
-    const maxRetries = 10;
-    const retryDelay = 1000; // 1 second
-
-    for (let attempt = 0; attempt < maxRetries; attempt++) {
-      await new Promise((resolve) => setTimeout(resolve, retryDelay));
-
-      try {
-        const retryResponse = await fetch(response.url, {
-          method: "GET",
-          headers: { "X-Operation-ID": operationId },
-        });
-
-        if (retryResponse.ok) {
-          return retryResponse;
-        }
-
-        if (retryResponse.status !== 404) {
-          return retryResponse; // Return other errors immediately
-        }
-      } catch (error) {
-        console.warn(`Polling attempt ${attempt + 1} failed:`, error);
-      }
-    }
-  }
-
-  return response;
-});
-
-// Usage for read-after-write operations
-const createUser = async (userData: any) => {
-  // Write operation
-  const createResponse = await client.post("/api/users", userData);
-  const operationId = createResponse.headers.get("X-Operation-ID");
-
-  // Read operation with polling fallback
-  const userResponse = await pollingClient.get(
-    `/api/users/${createResponse.id}`,
-    {
-      headers: { "X-Operation-ID": operationId },
-    },
-  );
-
-  return userResponse;
-};
-```
-
-### Centralized Error Mapping
-
-Transform backend errors into user-friendly messages:
-
-```ts
-// Define error mappings
-const errorMappings = {
-  400: "Invalid request. Please check your input.",
-  401: "Please log in to continue.",
-  403: "You don't have permission to perform this action.",
-  404: "The requested resource was not found.",
-  422: "Validation failed. Please check your input.",
-  429: "Too many requests. Please try again later.",
-  500: "An internal error occurred. Please try again.",
-  502: "Service temporarily unavailable.",
-  503: "Service temporarily unavailable.",
-  504: "Request timed out. Please try again.",
-};
 
-client.useResponseMiddleware(async (response) => {
-  if (!response.ok) {
-    const body = await response.json().catch(() => ({}));
-
-    // Create user-friendly error with mapped message
-    const userMessage =
-      errorMappings[response.status] || "An unexpected error occurred.";
-
-    // Add user-friendly message to error body
-    const enhancedBody = {
-      ...body,
-      userMessage,
-      originalStatus: response.status,
-      timestamp: new Date().toISOString(),
-    };
-
-    // Create a new response with enhanced error information
-    return new Response(JSON.stringify(enhancedBody), {
-      status: response.status,
-      statusText: response.statusText,
-      headers: response.headers,
-    });
-  }
-
-  return response;
-});
-```
-
-## 🔧 TypeScript Best Practices
-
-### Typing Request and Response Shapes
-
-Define clear interfaces for your API contracts:
-
-```ts
-import { FetchClient } from "@fgrzl/fetch";
-
-// Define API response types
-interface User {
-  id: number;
-  name: string;
-  email: string;
-  createdAt: string;
-}
-
-interface CreateUserRequest {
-  name: string;
-  email: string;
-}
-
-interface ApiResponse<T> {
-  data: T;
-  message: string;
-  timestamp: string;
-}
-
-const client = new FetchClient();
-
-// Type-safe API calls
-const getUser = (id: number): Promise<ApiResponse<User>> => {
-  return client.get<ApiResponse<User>>(`/api/users/${id}`);
-};
-
-const createUser = (
-  userData: CreateUserRequest,
-): Promise<ApiResponse<User>> => {
-  return client.post<ApiResponse<User>>("/api/users", userData);
-};
-
-// Usage with full type safety
-const user = await getUser(123);
-console.log(user.data.name); // TypeScript knows this is a string
-```
-
-### Generic Middleware Patterns
-
-Create reusable, type-safe middleware:
-
-```ts
-import { RequestMiddleware, ResponseMiddleware } from "@fgrzl/fetch";
-
-// Type-safe request middleware factory
-function createAuthMiddleware<T extends string>(
-  tokenProvider: () => T | null,
-): RequestMiddleware {
-  return async (req, url) => {
-    const token = tokenProvider();
-    const headers = {
-      ...req.headers,
-      ...(token && { Authorization: `Bearer ${token}` }),
-    };
-    return [{ ...req, headers }, url];
-  };
-}
-
-// Type-safe response middleware for data transformation
-function createDataTransformMiddleware<TInput, TOutput>(
-  transformer: (input: TInput) => TOutput,
-): ResponseMiddleware {
-  return async (response) => {
-    if (response.ok && response.headers.get("content-type")?.includes("json")) {
-      const data = (await response.json()) as TInput;
-      const transformedData = transformer(data);
-
-      return new Response(JSON.stringify(transformedData), {
-        status: response.status,
-        statusText: response.statusText,
-        headers: response.headers,
-      });
-    }
-    return response;
-  };
-}
-
-// Usage
-const authMiddleware = createAuthMiddleware(() =>
-  localStorage.getItem("token"),
-);
-const transformMiddleware = createDataTransformMiddleware<
-  RawApiData,
-  CleanData
->((raw) => ({ ...raw, processedAt: new Date() }));
-
-client.useRequestMiddleware(authMiddleware);
-client.useResponseMiddleware(transformMiddleware);
-```
-
-### Type-Safe Error Handling
-
-Create typed error handlers for different scenarios:
-
-```ts
-import { HttpError, NetworkError, FetchError } from "@fgrzl/fetch";
-
-// Define error types for your API
-interface ApiError {
-  code: string;
-  message: string;
-  details?: Record<string, any>;
-}
-
-interface ValidationError extends ApiError {
-  code: "VALIDATION_ERROR";
-  details: {
-    field: string;
-    message: string;
-  }[];
-}
-
-// Type-safe error handling utility
-async function handleApiCall<T>(
-  apiCall: () => Promise<T>,
-): Promise<{ data?: T; error?: string }> {
-  try {
-    const data = await apiCall();
-    return { data };
-  } catch (error) {
-    if (error instanceof HttpError) {
-      const apiError = error.body as ApiError;
-
-      switch (apiError.code) {
-        case "VALIDATION_ERROR":
-          const validationError = apiError as ValidationError;
-          return {
-            error: `Validation failed: ${validationError.details.map((d) => d.message).join(", ")}`,
-          };
-
-        case "UNAUTHORIZED":
-          return { error: "Please log in to continue" };
-
-        default:
-          return { error: apiError.message || "An error occurred" };
-      }
-    }
-
-    if (error instanceof NetworkError) {
-      return { error: "Network error. Please check your connection." };
-    }
-
-    return { error: "An unexpected error occurred" };
-  }
-}
-
-// Usage
-const result = await handleApiCall(() => client.get<User>("/api/users/123"));
-if (result.error) {
-  console.error(result.error);
+// All requests now return FetchResponse<T>
+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
 } else {
-  console.log(result.data.name); // TypeScript knows data is User
-}
-```
-
-## 🚀 Advanced Usage
-
-### Conditional Middleware Application
-
-Apply middleware only for specific routes or conditions:
-
-```ts
-import { RequestMiddleware, ResponseMiddleware } from "@fgrzl/fetch";
-
-// Conditional request middleware
-const conditionalAuthMiddleware: RequestMiddleware = async (req, url) => {
-  // Only add auth to protected routes
-  if (url.includes("/api/protected/") || url.includes("/api/admin/")) {
-    const token = localStorage.getItem("admin-token");
-    const headers = {
-      ...req.headers,
-      ...(token && { Authorization: `Bearer ${token}` }),
-    };
-    return [{ ...req, headers }, url];
-  }
-  return [req, url];
-};
-
-// Conditional response middleware
-const conditionalCachingMiddleware: ResponseMiddleware = async (response) => {
-  // Only cache GET requests to specific endpoints
-  if (response.url.includes("/api/cache/") && response.status === 200) {
-    const cacheKey = `cache_${response.url}`;
-    const data = await response.clone().text();
-    localStorage.setItem(cacheKey, data);
-    localStorage.setItem(`${cacheKey}_timestamp`, Date.now().toString());
-  }
-  return response;
-};
-
-client.useRequestMiddleware(conditionalAuthMiddleware);
-client.useResponseMiddleware(conditionalCachingMiddleware);
-```
-
-### Middleware Composition and Factories
-
-Create composable middleware for complex scenarios:
-
-```ts
-// Middleware factory for different environments
-function createEnvironmentMiddleware(environment: "dev" | "staging" | "prod") {
-  const configs = {
-    dev: { baseUrl: "http://localhost:3000", debug: true },
-    staging: { baseUrl: "https://staging-api.example.com", debug: true },
-    prod: { baseUrl: "https://api.example.com", debug: false },
-  };
-
-  const config = configs[environment];
-
-  const requestMiddleware: RequestMiddleware = async (req, url) => {
-    // Convert relative URLs to absolute
-    const fullUrl = url.startsWith("/") ? `${config.baseUrl}${url}` : url;
-
-    const headers = {
-      ...req.headers,
-      "X-Environment": environment,
-      ...(config.debug && { "X-Debug": "true" }),
-    };
-
-    return [{ ...req, headers }, fullUrl];
-  };
-
-  const responseMiddleware: ResponseMiddleware = async (response) => {
-    if (config.debug) {
-      console.log(
-        `[${environment.upper()}] ${response.status} ${response.url}`,
-      );
-    }
-    return response;
-  };
-
-  return { requestMiddleware, responseMiddleware };
-}
-
-// Middleware composition utility
-function composeMiddleware(
-  ...middlewares: RequestMiddleware[]
-): RequestMiddleware {
-  return async (req, url) => {
-    let currentReq = req;
-    let currentUrl = url;
-
-    for (const middleware of middlewares) {
-      [currentReq, currentUrl] = await middleware(currentReq, currentUrl);
-    }
-
-    return [currentReq, currentUrl];
-  };
+  console.error(`Failed with status ${userResponse.status}`);
 }
-
-// Usage
-const { requestMiddleware, responseMiddleware } =
-  createEnvironmentMiddleware("dev");
-
-const composedMiddleware = composeMiddleware(
-  requestMiddleware,
-  createAuthMiddleware(() => localStorage.getItem("token")),
-  createLoggingMiddleware(),
-);
-
-client.useRequestMiddleware(composedMiddleware);
-client.useResponseMiddleware(responseMiddleware);
-```
-
-### Performance Optimizations
-
-Optimize middleware for high-throughput applications:
-
-```ts
-// Cached middleware to avoid repeated computations
-const createCachedAuthMiddleware = (): RequestMiddleware => {
-  let cachedToken: string | null = null;
-  let tokenExpiry: number = 0;
-
-  return async (req, url) => {
-    const now = Date.now();
-
-    // Refresh token only if expired
-    if (!cachedToken || now > tokenExpiry) {
-      cachedToken = localStorage.getItem("auth-token");
-      // Cache for 5 minutes
-      tokenExpiry = now + 5 * 60 * 1000;
-    }
-
-    const headers = {
-      ...req.headers,
-      ...(cachedToken && { Authorization: `Bearer ${cachedToken}` }),
-    };
-
-    return [{ ...req, headers }, url];
-  };
-};
-
-// Debounced middleware for rate limiting
-const createDebouncedMiddleware = (delay: number = 100): RequestMiddleware => {
-  const pending = new Map<string, Promise<[RequestInit, string]>>();
-
-  return async (req, url) => {
-    const key = `${req.method || "GET"}:${url}`;
-
-    if (pending.has(key)) {
-      return pending.get(key)!;
-    }
-
-    const promise = new Promise<[RequestInit, string]>((resolve) => {
-      setTimeout(() => {
-        pending.delete(key);
-        resolve([req, url]);
-      }, delay);
-    });
-
-    pending.set(key, promise);
-    return promise;
-  };
-};
-
-// Circuit breaker pattern
-const createCircuitBreakerMiddleware = (
-  failureThreshold: number = 5,
-  resetTimeout: number = 60000,
-): ResponseMiddleware => {
-  let failures = 0;
-  let lastFailureTime = 0;
-  let isOpen = false;
-
-  return async (response) => {
-    const now = Date.now();
-
-    // Reset circuit if timeout has passed
-    if (isOpen && now - lastFailureTime > resetTimeout) {
-      isOpen = false;
-      failures = 0;
-    }
-
-    if (isOpen) {
-      throw new Error("Circuit breaker is open");
-    }
-
-    if (!response.ok && response.status >= 500) {
-      failures++;
-      lastFailureTime = now;
-
-      if (failures >= failureThreshold) {
-        isOpen = true;
-        console.warn("Circuit breaker opened due to repeated failures");
-      }
-    } else if (response.ok) {
-      // Reset on success
-      failures = 0;
-    }
-
-    return response;
-  };
-};
-```
-
-### Complete Integration Example
-
-Here's a complete example showing multiple patterns working together:
-
-```ts
-import { FetchClient, HttpError } from "@fgrzl/fetch";
-
-// Types
-interface ApiConfig {
-  baseUrl: string;
-  environment: "dev" | "staging" | "prod";
-  enableRetry: boolean;
-  enableCircuitBreaker: boolean;
-}
-
-interface User {
-  id: number;
-  name: string;
-  email: string;
-}
-
-// Create configured client
-function createApiClient(config: ApiConfig): FetchClient {
-  const client = new FetchClient({
-    credentials: "same-origin",
-  });
-
-  // Environment-specific middleware
-  client.useRequestMiddleware(async (req, url) => {
-    const fullUrl = url.startsWith("/") ? `${config.baseUrl}${url}` : url;
-    const headers = {
-      ...req.headers,
-      "Content-Type": "application/json",
-      "X-Environment": config.environment,
-      "X-Client-Version": "1.0.0",
-    };
-    return [{ ...req, headers }, fullUrl];
-  });
-
-  // Auth middleware
-  client.useRequestMiddleware(createCachedAuthMiddleware());
-
-  // Correlation ID middleware
-  client.useRequestMiddleware(async (req, url) => {
-    const correlationId = crypto.randomUUID();
-    const headers = {
-      ...req.headers,
-      "X-Correlation-ID": correlationId,
-    };
-    return [{ ...req, headers }, url];
-  });
-
-  // Circuit breaker (production only)
-  if (config.enableCircuitBreaker && config.environment === "prod") {
-    client.useResponseMiddleware(createCircuitBreakerMiddleware());
-  }
-
-  // Retry middleware
-  if (config.enableRetry) {
-    client.useResponseMiddleware(async (response) => {
-      if (response.status >= 500 && response.status < 600) {
-        // Retry logic here
-        console.log("Retrying request due to server error...");
-      }
-      return response;
-    });
-  }
-
-  // Error mapping
-  client.useResponseMiddleware(async (response) => {
-    if (!response.ok) {
-      const correlationId = response.headers.get("X-Correlation-ID");
-      console.error(`Request failed [${correlationId}]:`, response.status);
-    }
-    return response;
-  });
-
-  return client;
-}
-
-// Usage
-const apiClient = createApiClient({
-  baseUrl: "https://api.example.com",
-  environment: "prod",
-  enableRetry: true,
-  enableCircuitBreaker: true,
-});
-
-// Type-safe API methods
-const userApi = {
-  getUser: (id: number): Promise<User> => apiClient.get<User>(`/users/${id}`),
-
-  createUser: (userData: Omit<User, "id">): Promise<User> =>
-    apiClient.post<User>("/users", userData),
-
-  updateUser: (id: number, userData: Partial<User>): Promise<User> =>
-    apiClient.put<User>(`/users/${id}`, userData),
-
-  deleteUser: (id: number): Promise<void> =>
-    apiClient.del<void>(`/users/${id}`),
-};
-
-// Usage with error handling
-try {
-  const user = await userApi.getUser(123);
-  console.log("User loaded:", user.name);
-} catch (error) {
-  if (error instanceof HttpError) {
-    console.error("API Error:", error.status, error.body);
-  } else {
-    console.error("Unexpected error:", error);
-  }
-}
-```
-
-## ⚡ Performance Considerations
-
-### Middleware Order Optimization
-
-Order middleware strategically for best performance:
-
-```ts
-const client = new FetchClient();
-
-// ✅ Fast middleware first (simple header additions)
-client.useRequestMiddleware(addCorrelationId);
-client.useRequestMiddleware(addTimestamp);
-
-// ✅ Medium complexity middleware
-client.useRequestMiddleware(addAuthToken);
-client.useRequestMiddleware(transformUrl);
-
-// ✅ Heavy middleware last (async operations, storage access)
-client.useRequestMiddleware(checkCacheAndModifyRequest);
-client.useRequestMiddleware(validateAndEnrichRequest);
-
-// Same principle for response middleware
-client.useResponseMiddleware(logResponse); // Fast
-client.useResponseMiddleware(extractHeaders); // Fast
-client.useResponseMiddleware(updateCache); // Heavy
-client.useResponseMiddleware(processComplexData); // Heavy
 ```
 
-### Memory Management
-
-Avoid memory leaks in long-running applications:
-
-```ts
-// ❌ Bad: Creates closures that hold references
-function badMiddlewareFactory() {
-  const largeData = new Array(1000000).fill("data");
-
-  return async (req, url) => {
-    // This holds reference to largeData forever
-    return [{ ...req, someData: largeData[0] }, url];
-  };
-}
-
-// ✅ Good: Clean references and use weak references where appropriate
-function goodMiddlewareFactory() {
-  return async (req, url) => {
-    // Create data only when needed
-    const necessaryData = computeNecessaryData();
-    return [{ ...req, data: necessaryData }, url];
-  };
-}
+---
 
-// ✅ Good: Use WeakMap for temporary caching
-const responseCache = new WeakMap<Response, any>();
+## Documentation
 
-const cachingMiddleware: ResponseMiddleware = async (response) => {
-  if (!responseCache.has(response)) {
-    const data = await response.clone().json();
-    responseCache.set(response, data);
-  }
-  return response;
-};
-```
-
-### Request Batching and Caching
-
-Implement intelligent caching to reduce network requests:
-
-```ts
-// Simple request deduplication
-class RequestDeduplicator {
-  private pending = new Map<string, Promise<Response>>();
-
-  createMiddleware(): RequestMiddleware {
-    return async (req, url) => {
-      const key = `${req.method || "GET"}:${url}:${JSON.stringify(req.body)}`;
-
-      // For GET requests, deduplicate concurrent identical requests
-      if (req.method === "GET" && this.pending.has(key)) {
-        console.log("Deduplicating request:", key);
-        // Return same promise for identical concurrent requests
-        await this.pending.get(key);
-      }
-
-      return [req, url];
-    };
-  }
-}
+- [Project Overview](docs/overview.md)
+- [Middleware](docs/middleware.md)
+- [Error Handling](docs/errors.md)
+- [Testing](docs/testing.md)
 
-const deduplicator = new RequestDeduplicator();
-client.useRequestMiddleware(deduplicator.createMiddleware());
+---
 
-// Response caching with TTL
-class ResponseCache {
-  private cache = new Map<string, { data: any; expiry: number }>();
+## License
 
-  createMiddleware(ttlMs: number = 300000): ResponseMiddleware {
-    return async (response) => {
-      if (response.ok && response.url.includes("/api/cache/")) {
-        const key = response.url;
-        const now = Date.now();
-
-        // Clean expired entries
-        for (const [k, v] of this.cache.entries()) {
-          if (v.expiry < now) {
-            this.cache.delete(k);
-          }
-        }
-
-        // Cache successful responses
-        const data = await response.clone().json();
-        this.cache.set(key, { data, expiry: now + ttlMs });
-      }
-
-      return response;
-    };
-  }
-}
-
-const cache = new ResponseCache();
-client.useResponseMiddleware(cache.createMiddleware(5 * 60 * 1000)); // 5 minute TTL
-```
-
-### Monitoring and Metrics
-
-Track performance metrics for optimization:
-
-```ts
-class PerformanceMonitor {
-  private metrics = {
-    requestCount: 0,
-    responseCount: 0,
-    averageResponseTime: 0,
-    errorRate: 0,
-    slowRequests: 0,
-  };
-
-  createRequestMiddleware(): RequestMiddleware {
-    return async (req, url) => {
-      this.metrics.requestCount++;
-
-      // Add performance marker
-      const startTime = performance.now();
-      const headers = {
-        ...req.headers,
-        "X-Start-Time": startTime.toString(),
-      };
-
-      return [{ ...req, headers }, url];
-    };
-  }
-
-  createResponseMiddleware(): ResponseMiddleware {
-    return async (response) => {
-      this.metrics.responseCount++;
-
-      const startTime = parseFloat(response.headers.get("X-Start-Time") || "0");
-      if (startTime > 0) {
-        const responseTime = performance.now() - startTime;
-
-        // Update average response time
-        this.metrics.averageResponseTime =
-          (this.metrics.averageResponseTime + responseTime) / 2;
-
-        // Track slow requests (>2s)
-        if (responseTime > 2000) {
-          this.metrics.slowRequests++;
-          console.warn(
-            `Slow request detected: ${response.url} took ${responseTime}ms`,
-          );
-        }
-      }
-
-      // Track error rate
-      if (!response.ok) {
-        this.metrics.errorRate =
-          (this.metrics.errorRate * (this.metrics.responseCount - 1) + 1) /
-          this.metrics.responseCount;
-      }
-
-      return response;
-    };
-  }
-
-  getMetrics() {
-    return { ...this.metrics };
-  }
-
-  reset() {
-    this.metrics = {
-      requestCount: 0,
-      responseCount: 0,
-      averageResponseTime: 0,
-      errorRate: 0,
-      slowRequests: 0,
-    };
-  }
-}
-
-// Usage
-const monitor = new PerformanceMonitor();
-client.useRequestMiddleware(monitor.createRequestMiddleware());
-client.useResponseMiddleware(monitor.createResponseMiddleware());
-
-// Check metrics periodically
-setInterval(() => {
-  const metrics = monitor.getMetrics();
-  console.log("API Performance:", metrics);
-
-  if (metrics.errorRate > 0.1) {
-    // >10% error rate
-    console.warn("High error rate detected!", metrics);
-  }
-}, 30000); // Every 30 seconds
-```
-
-## 🔐 CSRF + 401 Handling
-
-The default export is pre-configured with:
-
-- `credentials: 'same-origin'`
-- CSRF token from `csrf_token` cookie
-- 401 redirect to `/login?returnTo=...`
-
-## 📋 Quick Copy-Paste Examples
-
-### Basic Auth Token
-
-```ts
-import { FetchClient } from "@fgrzl/fetch";
-
-const client = new FetchClient();
-client.useRequestMiddleware(async (req, url) => {
-  const token = localStorage.getItem("token");
-  return [
-    {
-      ...req,
-      headers: { ...req.headers, Authorization: `Bearer ${token}` },
-    },
-    url,
-  ];
-});
-
-// Usage
-const data = await client.get("/api/protected-resource");
-```
-
-### Request Logging
-
-```ts
-client.useRequestMiddleware(async (req, url) => {
-  console.log(`🚀 ${req.method || "GET"} ${url}`);
-  return [req, url];
-});
-
-client.useResponseMiddleware(async (res) => {
-  console.log(`✅ ${res.status} ${res.url}`);
-  return res;
-});
-```
-
-### Automatic Retry
-
-```ts
-client.useResponseMiddleware(async (response) => {
-  if (response.status >= 500 && response.status < 600) {
-    console.log("Retrying request...");
-    await new Promise((resolve) => setTimeout(resolve, 1000));
-    return fetch(response.url, response);
-  }
-  return response;
-});
-```
-
-### Error Notifications
-
-```ts
-client.useResponseMiddleware(async (response) => {
-  if (!response.ok) {
-    const message = `Request failed: ${response.status} ${response.statusText}`;
-    // Show toast notification, update UI, etc.
-    console.error(message);
-  }
-  return response;
-});
-```
-
-### Development Debug Headers
-
-```ts
-if (process.env.NODE_ENV === "development") {
-  client.useRequestMiddleware(async (req, url) => {
-    return [
-      {
-        ...req,
-        headers: {
-          ...req.headers,
-          "X-Debug": "true",
-          "X-Timestamp": new Date().toISOString(),
-          "X-User-Agent": navigator.userAgent,
-        },
-      },
-      url,
-    ];
-  });
-}
-```
-
-### Simple Rate Limiting
-
-```ts
-let lastRequest = 0;
-const RATE_LIMIT_MS = 1000; // 1 request per second
-
-client.useRequestMiddleware(async (req, url) => {
-  const now = Date.now();
-  const timeSinceLastRequest = now - lastRequest;
-
-  if (timeSinceLastRequest < RATE_LIMIT_MS) {
-    await new Promise((resolve) =>
-      setTimeout(resolve, RATE_LIMIT_MS - timeSinceLastRequest),
-    );
-  }
-
-  lastRequest = Date.now();
-  return [req, url];
-});
-```
-
-## 🧪 Testing
-
-```bash
-npm run test
-```
-
-## 🛠 Build
-
-```bash
-npm run build
-```
+MIT

package/dist/client.d.ts

@@ -13,6 +13,29 @@ export type RequestMiddleware = (req: RequestInit, url: string) => Promise<[Requ
  * @returns A promise that resolves to the modified response
  */
 export type ResponseMiddleware = (res: Response) => Promise<Response>;
+/**
+ * Typed response wrapper that includes response metadata.
+ * @template T - The type of the response data
+ */
+export interface FetchResponse<T> {
+    /** The parsed response data */
+    data: T;
+    /** HTTP status code */
+    status: number;
+    /** HTTP status text */
+    statusText: string;
+    /** Response headers */
+    headers: Headers;
+    /** The original URL */
+    url: string;
+    /** Whether the response was successful (status 200-299) */
+    ok: boolean;
+    /** Error information if the request failed */
+    error?: {
+        message: string;
+        body?: any;
+    };
+}
 /**
  * Configuration options for FetchClient.
  */
@@ -65,24 +88,23 @@ export declare class FetchClient {
      * @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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
-    request<T = any>(url: string, init?: RequestInit): Promise<T>;
+    request<T = any>(url: string, init?: RequestInit): Promise<FetchResponse<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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
-    get<T>(url: string): Promise<T>;
+    get<T>(url: string): Promise<FetchResponse<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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
     private requestWithJsonBody;
     /**
@@ -90,22 +112,22 @@ export declare class FetchClient {
      * @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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
-    post<T>(url: string, body?: any): Promise<T>;
+    post<T>(url: string, body?: any): Promise<FetchResponse<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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
-    put<T>(url: string, body?: any): Promise<T>;
+    put<T>(url: string, body?: any): Promise<FetchResponse<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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
-    del<T>(url: string): Promise<T>;
+    del<T>(url: string): Promise<FetchResponse<T>>;
 }

package/dist/client.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FetchClient = void 0;
-const errors_1 = require("./errors");
 /**
  * A configurable HTTP client with middleware support.
  *
@@ -52,8 +51,7 @@ class FetchClient {
      * @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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
     async request(url, init = {}) {
         try {
@@ -67,19 +65,47 @@ class FetchClient {
             for (const mw of this.responseMiddlewares) {
                 res = await mw(res);
             }
+            const responseMetadata = {
+                status: res.status,
+                statusText: res.statusText,
+                headers: res.headers,
+                url: res.url,
+                ok: res.ok,
+            };
             if (!res.ok) {
                 const body = await res.json().catch(() => ({}));
-                throw new errors_1.HttpError(res.status, res.statusText, body, url);
+                return {
+                    ...responseMetadata,
+                    data: null,
+                    error: {
+                        message: res.statusText,
+                        body,
+                    },
+                };
             }
-            return res.json();
+            const data = await res.json();
+            return {
+                ...responseMetadata,
+                data,
+            };
         }
         catch (error) {
-            if (error instanceof errors_1.HttpError) {
-                throw error;
-            }
+            // Handle network errors and other exceptions
             if (error instanceof TypeError && error.message.includes('fetch')) {
-                throw new errors_1.NetworkError('Failed to fetch', url, error);
+                return {
+                    status: 0,
+                    statusText: 'Network Error',
+                    headers: new Headers(),
+                    url,
+                    ok: false,
+                    data: null,
+                    error: {
+                        message: 'Failed to fetch',
+                        body: error,
+                    },
+                };
             }
+            // Re-throw unexpected errors
             throw error;
         }
     }
@@ -87,7 +113,7 @@ class FetchClient {
      * 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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
     get(url) {
         return this.request(url, { method: 'GET' });
@@ -98,7 +124,7 @@ class FetchClient {
      * @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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
     requestWithJsonBody(url, method, body) {
         return this.request(url, {
@@ -111,7 +137,7 @@ class FetchClient {
      * @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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
     post(url, body) {
         return this.requestWithJsonBody(url, 'POST', body ?? {});
@@ -121,7 +147,7 @@ class FetchClient {
      * @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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
     put(url, body) {
         return this.requestWithJsonBody(url, 'PUT', body ?? {});
@@ -130,7 +156,7 @@ class FetchClient {
      * 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
+     * @returns Promise that resolves to a FetchResponse containing the data and metadata
      */
     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":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -30,7 +30,7 @@ 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 type { RequestMiddleware, ResponseMiddleware, FetchClientConfig, FetchResponse, } from './client';
 export { useCSRF } from './csrf';
 export { useUnauthorized } from './unauthorized';
 export type { UnauthorizedConfig } from './unauthorized';

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;AAMpB,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAChB,+CAAiD;AAAxC,+GAAA,eAAe,OAAA"}
+{"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fgrzl/fetch",
-  "version": "1.1.0-alpha.2",
-  "description": "A simple fetch client",
+  "version": "1.1.0-alpha.3",
+  "description": "A simple fetch client with some extra goodies",
   "keywords": [
     "fetch",
     "typescript",
@@ -28,7 +28,7 @@
     "prepublishOnly": "npm run build",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "test": "vitest",
+    "test": "vitest run",
     "test:watch": "vitest --watch",
     "test:coverage": "vitest run --coverage",
     "lint": "npm run format:check"