@opendatalabs/vana-sdk 2.3.0 → 3.0.1-canary.b068ac6

package/dist/core/apiClient.d.ts

@@ -1,286 +0,0 @@
-/**
- * Provides a generic HTTP client with enterprise-grade resilience features.
- *
- * @remarks
- * This module implements a robust API client with automatic retry, rate limiting,
- * circuit breaker pattern, and middleware support. It's used internally by the SDK
- * for all HTTP operations and can be extended for custom API integrations.
- *
- * **Architecture:**
- * - Middleware pipeline for request/response transformation
- * - Exponential backoff retry with configurable policies
- * - Token bucket rate limiting to prevent API throttling
- * - Circuit breaker to fail fast when services are down
- *
- * @category Networking
- * @module apiClient
- */
-import type { GenericResponse, RetryConfig, RateLimiterConfig, Middleware } from "../types/generics";
-/**
- * Configures the API client's behavior and resilience features.
- *
- * @remarks
- * Provides fine-grained control over HTTP client behavior including
- * retry strategies, rate limiting, and circuit breaker thresholds.
- *
- * @category Networking
- */
-export interface ApiClientConfig {
-    /** Base URL for all requests */
-    baseUrl?: string;
-    /** Default headers */
-    headers?: Record<string, string>;
-    /** Request timeout in milliseconds */
-    timeout?: number;
-    /** Retry configuration */
-    retry?: RetryConfig;
-    /** Rate limiting configuration */
-    rateLimit?: RateLimiterConfig;
-    /** Circuit breaker configuration */
-    circuitBreaker?: {
-        failureThreshold: number;
-        recoveryTimeout: number;
-        halfOpenMaxAttempts?: number;
-    };
-}
-/**
- * Represents supported HTTP methods for API operations.
- *
- * @category Networking
- */
-export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-/**
- * Configures individual HTTP request behavior.
- *
- * @remarks
- * Allows per-request overrides of client defaults including headers,
- * timeout, and resilience features. Use to customize specific requests
- * without affecting global configuration.
- *
- * @category Networking
- */
-export interface RequestOptions {
-    /** HTTP method */
-    method?: HttpMethod;
-    /** Request headers */
-    headers?: Record<string, string>;
-    /** Query parameters */
-    params?: Record<string, unknown>;
-    /** Request timeout */
-    timeout?: number;
-    /** Skip retry for this request */
-    skipRetry?: boolean;
-    /** Skip rate limiting for this request */
-    skipRateLimit?: boolean;
-}
-/**
- * Provides resilient HTTP client functionality with enterprise features.
- *
- * @remarks
- * This client implements multiple resilience patterns to ensure reliable
- * API communication even under adverse conditions. It automatically handles
- * transient failures, rate limits, and service outages while providing
- * hooks for custom behavior through middleware.
- *
- * **Features:**
- * - Automatic retry with exponential backoff
- * - Rate limiting to prevent API throttling
- * - Circuit breaker for fast failure detection
- * - Middleware pipeline for request/response transformation
- * - Configurable timeouts and headers
- *
- * @example
- * ```typescript
- * // Create client with custom configuration
- * const client = new ApiClient({
- *   baseUrl: 'https://api.example.com',
- *   headers: { 'API-Key': 'secret' },
- *   retry: {
- *     maxAttempts: 5,
- *     baseDelay: 2000
- *   },
- *   rateLimit: {
- *     requestsPerWindow: 50,
- *     windowMs: 60000
- *   }
- * });
- *
- * // Add logging middleware
- * client.use(async (req, next) => {
- *   console.log(`Request: ${req.params.url}`);
- *   const res = await next(req);
- *   console.log(`Response: ${res.status}`);
- *   return res;
- * });
- *
- * // Make resilient API calls
- * const data = await client.get('/users');
- * ```
- *
- * @category Networking
- */
-export declare class ApiClient {
-    private readonly config;
-    private readonly middleware;
-    private readonly rateLimiter?;
-    private readonly circuitBreaker?;
-    constructor(config?: ApiClientConfig);
-    /**
-     * Adds middleware to the request processing pipeline.
-     *
-     * @remarks
-     * Middleware functions execute in order of registration and can transform
-     * requests, responses, or implement cross-cutting concerns like logging,
-     * authentication, or caching.
-     *
-     * @param middleware - The middleware function to add to the pipeline
-     *
-     * @example
-     * ```typescript
-     * // Add authentication middleware
-     * client.use(async (req, next) => {
-     *   req.options.headers = {
-     *     ...req.options.headers,
-     *     'Authorization': `Bearer ${getToken()}`
-     *   };
-     *   return next(req);
-     * });
-     *
-     * // Add response caching
-     * client.use(async (req, next) => {
-     *   const cached = cache.get(req.params.url);
-     *   if (cached) return cached;
-     *
-     *   const res = await next(req);
-     *   if (res.status === 'success') {
-     *     cache.set(req.params.url, res);
-     *   }
-     *   return res;
-     * });
-     * ```
-     */
-    use(middleware: Middleware): void;
-    /**
-     * Executes an HTTP request with full resilience features.
-     *
-     * @remarks
-     * This is the core request method that applies all configured resilience
-     * patterns including retry, rate limiting, and circuit breaking. It processes
-     * the request through the middleware pipeline before execution.
-     *
-     * @param url - The URL to make the request to.
-     *   Can be relative (uses baseUrl) or absolute.
-     * @param options - Request options including method, headers, body, etc.
-     * @returns Promise resolving to the response data
-     *
-     * @throws {Error} When request fails after all retry attempts.
-     *   Check error message for details.
-     * @throws {Error} When circuit breaker is open.
-     *   Wait for recovery timeout before retrying.
-     *
-     * @example
-     * ```typescript
-     * const response = await client.request('/api/data', {
-     *   method: 'POST',
-     *   headers: { 'Content-Type': 'application/json' },
-     *   params: { name: 'John', age: 30 },
-     *   timeout: 5000
-     * });
-     * ```
-     */
-    request<TData = unknown>(url: string, options?: RequestOptions): Promise<GenericResponse<TData>>;
-    /**
-     * Make a GET request
-     *
-     * @param url - The URL to make the GET request to
-     * @param options - Request options (excluding method)
-     * @returns Promise resolving to the response data
-     */
-    get<TData = unknown>(url: string, options?: Omit<RequestOptions, "method">): Promise<GenericResponse<TData>>;
-    /**
-     * Make a POST request
-     *
-     * @param url - The URL to make the POST request to
-     * @param data - The data to send in the request body
-     * @param options - Request options (excluding method)
-     * @returns Promise resolving to the response data
-     */
-    post<TData = unknown>(url: string, data?: unknown, options?: Omit<RequestOptions, "method">): Promise<GenericResponse<TData>>;
-    /**
-     * Make a PUT request
-     *
-     * @param url - The URL to make the PUT request to
-     * @param data - The data to send in the request body
-     * @param options - Request options (excluding method)
-     * @returns Promise resolving to the response data
-     */
-    put<TData = unknown>(url: string, data?: unknown, options?: Omit<RequestOptions, "method">): Promise<GenericResponse<TData>>;
-    /**
-     * Make a DELETE request
-     *
-     * @param url - The URL to make the DELETE request to
-     * @param options - Request options (excluding method)
-     * @returns Promise resolving to the response data
-     */
-    delete<TData = unknown>(url: string, options?: Omit<RequestOptions, "method">): Promise<GenericResponse<TData>>;
-    /**
-     * Make a PATCH request
-     *
-     * @param url - The URL to make the PATCH request to
-     * @param data - The data to send in the request body
-     * @param options - Request options (excluding method)
-     * @returns Promise resolving to the response data
-     */
-    patch<TData = unknown>(url: string, data?: unknown, options?: Omit<RequestOptions, "method">): Promise<GenericResponse<TData>>;
-    /**
-     * Execute the actual HTTP request with middleware and retry
-     *
-     * @param request - The generic request object containing URL and options
-     * @returns Promise resolving to the generic response with data
-     */
-    private executeRequest;
-    /**
-     * Make the actual HTTP request using fetch API
-     *
-     * @param url - The URL to make the request to
-     * @param options - The request options including method, headers, body, etc.
-     * @returns Promise resolving to the generic response with data
-     */
-    private makeHttpRequest;
-    /**
-     * Build the full URL
-     *
-     * @param url - The URL or path to build the full URL from
-     * @returns The complete URL string
-     */
-    private buildUrl;
-    /**
-     * Build request options with defaults
-     *
-     * @param options - The request options to merge with defaults
-     * @returns The merged request options with defaults applied
-     */
-    private buildRequestOptions;
-    /**
-     * Get client statistics
-     *
-     * @returns Object containing client statistics and performance metrics
-     */
-    getStats(): {
-        rateLimiter: {
-            remaining: number;
-            resetTime: number;
-        } | null;
-        circuitBreaker: {
-            state: string;
-            failures: number;
-        } | null;
-        middleware: {
-            count: number;
-        };
-    };
-    /**
-     * Reset client state
-     */
-    reset(): void;
-}

package/dist/core/apiClient.js

@@ -1,359 +0,0 @@
-import {
-  RetryUtility,
-  RateLimiter,
-  MiddlewarePipeline,
-  CircuitBreaker
-} from "./generics";
-class ApiClient {
-  config;
-  middleware;
-  rateLimiter;
-  circuitBreaker;
-  constructor(config = {}) {
-    this.config = {
-      baseUrl: config.baseUrl ?? "",
-      headers: config.headers ?? {},
-      timeout: config.timeout ?? 3e4,
-      retry: config.retry ?? {
-        maxAttempts: 3,
-        baseDelay: 1e3,
-        backoffMultiplier: 2,
-        shouldRetry: (error) => error.message.includes("network")
-      },
-      rateLimit: config.rateLimit ?? {
-        requestsPerWindow: 100,
-        windowMs: 6e4
-      },
-      circuitBreaker: config.circuitBreaker ?? {
-        failureThreshold: 5,
-        recoveryTimeout: 6e4,
-        halfOpenMaxAttempts: 3
-      }
-    };
-    this.middleware = new MiddlewarePipeline();
-    this.rateLimiter = new RateLimiter(this.config.rateLimit);
-    this.circuitBreaker = new CircuitBreaker(this.config.circuitBreaker);
-  }
-  /**
-   * Adds middleware to the request processing pipeline.
-   *
-   * @remarks
-   * Middleware functions execute in order of registration and can transform
-   * requests, responses, or implement cross-cutting concerns like logging,
-   * authentication, or caching.
-   *
-   * @param middleware - The middleware function to add to the pipeline
-   *
-   * @example
-   * ```typescript
-   * // Add authentication middleware
-   * client.use(async (req, next) => {
-   *   req.options.headers = {
-   *     ...req.options.headers,
-   *     'Authorization': `Bearer ${getToken()}`
-   *   };
-   *   return next(req);
-   * });
-   *
-   * // Add response caching
-   * client.use(async (req, next) => {
-   *   const cached = cache.get(req.params.url);
-   *   if (cached) return cached;
-   *
-   *   const res = await next(req);
-   *   if (res.status === 'success') {
-   *     cache.set(req.params.url, res);
-   *   }
-   *   return res;
-   * });
-   * ```
-   */
-  use(middleware) {
-    this.middleware.use(middleware);
-  }
-  /**
-   * Executes an HTTP request with full resilience features.
-   *
-   * @remarks
-   * This is the core request method that applies all configured resilience
-   * patterns including retry, rate limiting, and circuit breaking. It processes
-   * the request through the middleware pipeline before execution.
-   *
-   * @param url - The URL to make the request to.
-   *   Can be relative (uses baseUrl) or absolute.
-   * @param options - Request options including method, headers, body, etc.
-   * @returns Promise resolving to the response data
-   *
-   * @throws {Error} When request fails after all retry attempts.
-   *   Check error message for details.
-   * @throws {Error} When circuit breaker is open.
-   *   Wait for recovery timeout before retrying.
-   *
-   * @example
-   * ```typescript
-   * const response = await client.request('/api/data', {
-   *   method: 'POST',
-   *   headers: { 'Content-Type': 'application/json' },
-   *   params: { name: 'John', age: 30 },
-   *   timeout: 5000
-   * });
-   * ```
-   */
-  async request(url, options = {}) {
-    const fullUrl = this.buildUrl(url);
-    const requestOptions = this.buildRequestOptions(options);
-    const request = {
-      params: {
-        url: fullUrl,
-        options: requestOptions
-      },
-      options: requestOptions
-    };
-    if (!options.skipRateLimit && this.rateLimiter) {
-      await this.rateLimiter.waitForSlot();
-    }
-    if (this.circuitBreaker) {
-      return this.circuitBreaker.execute(
-        () => this.executeRequest(request)
-      );
-    }
-    return this.executeRequest(request);
-  }
-  /**
-   * Make a GET request
-   *
-   * @param url - The URL to make the GET request to
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async get(url, options = {}) {
-    return this.request(url, { ...options, method: "GET" });
-  }
-  /**
-   * Make a POST request
-   *
-   * @param url - The URL to make the POST request to
-   * @param data - The data to send in the request body
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async post(url, data, options = {}) {
-    return this.request(url, {
-      ...options,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...options.headers
-      },
-      params: data
-    });
-  }
-  /**
-   * Make a PUT request
-   *
-   * @param url - The URL to make the PUT request to
-   * @param data - The data to send in the request body
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async put(url, data, options = {}) {
-    return this.request(url, {
-      ...options,
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        ...options.headers
-      },
-      params: data
-    });
-  }
-  /**
-   * Make a DELETE request
-   *
-   * @param url - The URL to make the DELETE request to
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async delete(url, options = {}) {
-    return this.request(url, { ...options, method: "DELETE" });
-  }
-  /**
-   * Make a PATCH request
-   *
-   * @param url - The URL to make the PATCH request to
-   * @param data - The data to send in the request body
-   * @param options - Request options (excluding method)
-   * @returns Promise resolving to the response data
-   */
-  async patch(url, data, options = {}) {
-    return this.request(url, {
-      ...options,
-      method: "PATCH",
-      headers: {
-        "Content-Type": "application/json",
-        ...options.headers
-      },
-      params: data
-    });
-  }
-  /**
-   * Execute the actual HTTP request with middleware and retry
-   *
-   * @param request - The generic request object containing URL and options
-   * @returns Promise resolving to the generic response with data
-   */
-  async executeRequest(request) {
-    const executeWithRetry = async () => {
-      try {
-        const processedRequest = await this.middleware.processRequest(request);
-        const response = await this.makeHttpRequest(
-          processedRequest.params.url,
-          processedRequest.params.options
-        );
-        const processedResponse = await this.middleware.processResponse(response);
-        return processedResponse;
-      } catch (error) {
-        const handledResponse = await this.middleware.handleError(error, request);
-        if (handledResponse) {
-          return handledResponse;
-        }
-        throw error;
-      }
-    };
-    if (!request.params.options.skipRetry) {
-      return RetryUtility.withRetry(executeWithRetry, this.config.retry);
-    }
-    return executeWithRetry();
-  }
-  /**
-   * Make the actual HTTP request using fetch API
-   *
-   * @param url - The URL to make the request to
-   * @param options - The request options including method, headers, body, etc.
-   * @returns Promise resolving to the generic response with data
-   */
-  async makeHttpRequest(url, options) {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => {
-      controller.abort();
-    }, options.timeout ?? this.config.timeout);
-    try {
-      const response = await fetch(url, {
-        method: options.method ?? "GET",
-        headers: {
-          ...this.config.headers,
-          ...options.headers
-        },
-        signal: controller.signal,
-        // Add body for POST/PUT/PATCH requests
-        ...options.method && ["POST", "PUT", "PATCH"].includes(options.method) && {
-          body: JSON.stringify(options.params)
-        }
-      });
-      clearTimeout(timeoutId);
-      const responseData = await response.json();
-      const data = responseData;
-      if (!response.ok) {
-        return {
-          data: null,
-          success: false,
-          error: {
-            code: response.status.toString(),
-            message: data.message ?? response.statusText,
-            details: data
-          }
-        };
-      }
-      return {
-        data: responseData,
-        success: true,
-        meta: {
-          status: response.status,
-          statusText: response.statusText,
-          headers: Object.fromEntries(response.headers.entries())
-        }
-      };
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (error instanceof Error && error.name === "AbortError") {
-        return {
-          data: null,
-          success: false,
-          error: {
-            code: "TIMEOUT",
-            message: "Request timeout",
-            details: error
-          }
-        };
-      }
-      return {
-        data: null,
-        success: false,
-        error: {
-          code: "NETWORK_ERROR",
-          message: error instanceof Error ? error.message : "Unknown error",
-          details: error
-        }
-      };
-    }
-  }
-  /**
-   * Build the full URL
-   *
-   * @param url - The URL or path to build the full URL from
-   * @returns The complete URL string
-   */
-  buildUrl(url) {
-    if (url.startsWith("http")) {
-      return url;
-    }
-    const baseUrl = this.config.baseUrl.endsWith("/") ? this.config.baseUrl.slice(0, -1) : this.config.baseUrl;
-    const path = url.startsWith("/") ? url : `/${url}`;
-    return `${baseUrl}${path}`;
-  }
-  /**
-   * Build request options with defaults
-   *
-   * @param options - The request options to merge with defaults
-   * @returns The merged request options with defaults applied
-   */
-  buildRequestOptions(options) {
-    return {
-      method: "GET",
-      headers: {},
-      timeout: this.config.timeout,
-      ...options
-    };
-  }
-  /**
-   * Get client statistics
-   *
-   * @returns Object containing client statistics and performance metrics
-   */
-  getStats() {
-    return {
-      rateLimiter: this.rateLimiter ? {
-        remaining: this.rateLimiter.getRemainingRequests(),
-        resetTime: this.rateLimiter.getResetTime()
-      } : null,
-      circuitBreaker: this.circuitBreaker ? {
-        state: this.circuitBreaker.getState(),
-        failures: this.circuitBreaker.getFailures()
-      } : null,
-      middleware: {
-        count: this.middleware.getMiddleware().length
-      }
-    };
-  }
-  /**
-   * Reset client state
-   */
-  reset() {
-    this.circuitBreaker?.reset();
-    this.middleware.clear();
-  }
-}
-export {
-  ApiClient
-};
-//# sourceMappingURL=apiClient.js.map

package/dist/core/apiClient.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/apiClient.ts"],"sourcesContent":["/**\n * Provides a generic HTTP client with enterprise-grade resilience features.\n *\n * @remarks\n * This module implements a robust API client with automatic retry, rate limiting,\n * circuit breaker pattern, and middleware support. It's used internally by the SDK\n * for all HTTP operations and can be extended for custom API integrations.\n *\n * **Architecture:**\n * - Middleware pipeline for request/response transformation\n * - Exponential backoff retry with configurable policies\n * - Token bucket rate limiting to prevent API throttling\n * - Circuit breaker to fail fast when services are down\n *\n * @category Networking\n * @module apiClient\n */\n\nimport type {\n  GenericRequest,\n  GenericResponse,\n  RetryConfig,\n  RateLimiterConfig,\n  Middleware,\n} from \"../types/generics\";\nimport {\n  RetryUtility,\n  RateLimiter,\n  MiddlewarePipeline,\n  CircuitBreaker,\n} from \"./generics\";\n\n/**\n * Configures the API client's behavior and resilience features.\n *\n * @remarks\n * Provides fine-grained control over HTTP client behavior including\n * retry strategies, rate limiting, and circuit breaker thresholds.\n *\n * @category Networking\n */\nexport interface ApiClientConfig {\n  /** Base URL for all requests */\n  baseUrl?: string;\n  /** Default headers */\n  headers?: Record<string, string>;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n  /** Retry configuration */\n  retry?: RetryConfig;\n  /** Rate limiting configuration */\n  rateLimit?: RateLimiterConfig;\n  /** Circuit breaker configuration */\n  circuitBreaker?: {\n    failureThreshold: number;\n    recoveryTimeout: number;\n    halfOpenMaxAttempts?: number;\n  };\n}\n\n/**\n * Represents supported HTTP methods for API operations.\n *\n * @category Networking\n */\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n\n/**\n * Configures individual HTTP request behavior.\n *\n * @remarks\n * Allows per-request overrides of client defaults including headers,\n * timeout, and resilience features. Use to customize specific requests\n * without affecting global configuration.\n *\n * @category Networking\n */\nexport interface RequestOptions {\n  /** HTTP method */\n  method?: HttpMethod;\n  /** Request headers */\n  headers?: Record<string, string>;\n  /** Query parameters */\n  params?: Record<string, unknown>;\n  /** Request timeout */\n  timeout?: number;\n  /** Skip retry for this request */\n  skipRetry?: boolean;\n  /** Skip rate limiting for this request */\n  skipRateLimit?: boolean;\n}\n\n/**\n * Provides resilient HTTP client functionality with enterprise features.\n *\n * @remarks\n * This client implements multiple resilience patterns to ensure reliable\n * API communication even under adverse conditions. It automatically handles\n * transient failures, rate limits, and service outages while providing\n * hooks for custom behavior through middleware.\n *\n * **Features:**\n * - Automatic retry with exponential backoff\n * - Rate limiting to prevent API throttling\n * - Circuit breaker for fast failure detection\n * - Middleware pipeline for request/response transformation\n * - Configurable timeouts and headers\n *\n * @example\n * ```typescript\n * // Create client with custom configuration\n * const client = new ApiClient({\n *   baseUrl: 'https://api.example.com',\n *   headers: { 'API-Key': 'secret' },\n *   retry: {\n *     maxAttempts: 5,\n *     baseDelay: 2000\n *   },\n *   rateLimit: {\n *     requestsPerWindow: 50,\n *     windowMs: 60000\n *   }\n * });\n *\n * // Add logging middleware\n * client.use(async (req, next) => {\n *   console.log(`Request: ${req.params.url}`);\n *   const res = await next(req);\n *   console.log(`Response: ${res.status}`);\n *   return res;\n * });\n *\n * // Make resilient API calls\n * const data = await client.get('/users');\n * ```\n *\n * @category Networking\n */\nexport class ApiClient {\n  private readonly config: Required<ApiClientConfig>;\n  private readonly middleware: MiddlewarePipeline;\n  private readonly rateLimiter?: RateLimiter;\n  private readonly circuitBreaker?: CircuitBreaker;\n\n  constructor(config: ApiClientConfig = {}) {\n    this.config = {\n      baseUrl: config.baseUrl ?? \"\",\n      headers: config.headers ?? {},\n      timeout: config.timeout ?? 30000,\n      retry: config.retry ?? {\n        maxAttempts: 3,\n        baseDelay: 1000,\n        backoffMultiplier: 2,\n        shouldRetry: (error) => error.message.includes(\"network\"),\n      },\n      rateLimit: config.rateLimit ?? {\n        requestsPerWindow: 100,\n        windowMs: 60000,\n      },\n      circuitBreaker: config.circuitBreaker ?? {\n        failureThreshold: 5,\n        recoveryTimeout: 60000,\n        halfOpenMaxAttempts: 3,\n      },\n    };\n\n    this.middleware = new MiddlewarePipeline();\n    this.rateLimiter = new RateLimiter(this.config.rateLimit);\n    this.circuitBreaker = new CircuitBreaker(this.config.circuitBreaker);\n  }\n\n  /**\n   * Adds middleware to the request processing pipeline.\n   *\n   * @remarks\n   * Middleware functions execute in order of registration and can transform\n   * requests, responses, or implement cross-cutting concerns like logging,\n   * authentication, or caching.\n   *\n   * @param middleware - The middleware function to add to the pipeline\n   *\n   * @example\n   * ```typescript\n   * // Add authentication middleware\n   * client.use(async (req, next) => {\n   *   req.options.headers = {\n   *     ...req.options.headers,\n   *     'Authorization': `Bearer ${getToken()}`\n   *   };\n   *   return next(req);\n   * });\n   *\n   * // Add response caching\n   * client.use(async (req, next) => {\n   *   const cached = cache.get(req.params.url);\n   *   if (cached) return cached;\n   *\n   *   const res = await next(req);\n   *   if (res.status === 'success') {\n   *     cache.set(req.params.url, res);\n   *   }\n   *   return res;\n   * });\n   * ```\n   */\n  use(middleware: Middleware): void {\n    this.middleware.use(middleware);\n  }\n\n  /**\n   * Executes an HTTP request with full resilience features.\n   *\n   * @remarks\n   * This is the core request method that applies all configured resilience\n   * patterns including retry, rate limiting, and circuit breaking. It processes\n   * the request through the middleware pipeline before execution.\n   *\n   * @param url - The URL to make the request to.\n   *   Can be relative (uses baseUrl) or absolute.\n   * @param options - Request options including method, headers, body, etc.\n   * @returns Promise resolving to the response data\n   *\n   * @throws {Error} When request fails after all retry attempts.\n   *   Check error message for details.\n   * @throws {Error} When circuit breaker is open.\n   *   Wait for recovery timeout before retrying.\n   *\n   * @example\n   * ```typescript\n   * const response = await client.request('/api/data', {\n   *   method: 'POST',\n   *   headers: { 'Content-Type': 'application/json' },\n   *   params: { name: 'John', age: 30 },\n   *   timeout: 5000\n   * });\n   * ```\n   */\n  async request<TData = unknown>(\n    url: string,\n    options: RequestOptions = {},\n  ): Promise<GenericResponse<TData>> {\n    const fullUrl = this.buildUrl(url);\n    const requestOptions = this.buildRequestOptions(options);\n\n    const request: GenericRequest<{\n      url: string;\n      options: RequestOptions;\n    }> = {\n      params: {\n        url: fullUrl,\n        options: requestOptions,\n      },\n      options: requestOptions,\n    };\n\n    // Apply rate limiting\n    if (!options.skipRateLimit && this.rateLimiter) {\n      await this.rateLimiter.waitForSlot();\n    }\n\n    // Execute with circuit breaker\n    if (this.circuitBreaker) {\n      return this.circuitBreaker.execute(() =>\n        this.executeRequest<TData>(request),\n      );\n    }\n\n    return this.executeRequest<TData>(request);\n  }\n\n  /**\n   * Make a GET request\n   *\n   * @param url - The URL to make the GET request to\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async get<TData = unknown>(\n    url: string,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, { ...options, method: \"GET\" });\n  }\n\n  /**\n   * Make a POST request\n   *\n   * @param url - The URL to make the POST request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async post<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n      params: data as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Make a PUT request\n   *\n   * @param url - The URL to make the PUT request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async put<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"PUT\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n      params: data as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Make a DELETE request\n   *\n   * @param url - The URL to make the DELETE request to\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async delete<TData = unknown>(\n    url: string,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, { ...options, method: \"DELETE\" });\n  }\n\n  /**\n   * Make a PATCH request\n   *\n   * @param url - The URL to make the PATCH request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async patch<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"PATCH\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n      params: data as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Execute the actual HTTP request with middleware and retry\n   *\n   * @param request - The generic request object containing URL and options\n   * @returns Promise resolving to the generic response with data\n   */\n  private async executeRequest<TData>(\n    request: GenericRequest<{ url: string; options: RequestOptions }>,\n  ): Promise<GenericResponse<TData>> {\n    const executeWithRetry = async (): Promise<GenericResponse<TData>> => {\n      try {\n        // Process request through middleware\n        const processedRequest = await this.middleware.processRequest(request);\n\n        // Make the actual HTTP request\n        const response = await this.makeHttpRequest<TData>(\n          (\n            processedRequest as GenericRequest<{\n              url: string;\n              options: RequestOptions;\n            }>\n          ).params.url,\n          (\n            processedRequest as GenericRequest<{\n              url: string;\n              options: RequestOptions;\n            }>\n          ).params.options,\n        );\n\n        // Process response through middleware\n        const processedResponse =\n          await this.middleware.processResponse(response);\n\n        return processedResponse;\n      } catch (error) {\n        // Try to handle error with middleware\n        const handledResponse = await this.middleware.handleError<\n          typeof request,\n          GenericResponse<TData>\n        >(error as Error, request);\n\n        if (handledResponse) {\n          return handledResponse;\n        }\n\n        throw error;\n      }\n    };\n\n    // Apply retry logic if not skipped\n    if (!request.params.options.skipRetry) {\n      return RetryUtility.withRetry(executeWithRetry, this.config.retry);\n    }\n\n    return executeWithRetry();\n  }\n\n  /**\n   * Make the actual HTTP request using fetch API\n   *\n   * @param url - The URL to make the request to\n   * @param options - The request options including method, headers, body, etc.\n   * @returns Promise resolving to the generic response with data\n   */\n  private async makeHttpRequest<TData>(\n    url: string,\n    options: RequestOptions,\n  ): Promise<GenericResponse<TData>> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => {\n      controller.abort();\n    }, options.timeout ?? this.config.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: options.method ?? \"GET\",\n        headers: {\n          ...this.config.headers,\n          ...options.headers,\n        },\n        signal: controller.signal,\n        // Add body for POST/PUT/PATCH requests\n        ...(options.method &&\n          [\"POST\", \"PUT\", \"PATCH\"].includes(options.method) && {\n            body: JSON.stringify(options.params),\n          }),\n      });\n\n      clearTimeout(timeoutId);\n\n      const responseData: unknown = await response.json();\n      const data = responseData as { message?: string; [key: string]: unknown };\n\n      if (!response.ok) {\n        return {\n          data: null as unknown as TData,\n          success: false,\n          error: {\n            code: response.status.toString(),\n            message: data.message ?? response.statusText,\n            details: data,\n          },\n        };\n      }\n\n      return {\n        data: responseData as TData,\n        success: true,\n        meta: {\n          status: response.status,\n          statusText: response.statusText,\n          headers: Object.fromEntries(response.headers.entries()),\n        },\n      };\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof Error && error.name === \"AbortError\") {\n        return {\n          data: null as unknown as TData,\n          success: false,\n          error: {\n            code: \"TIMEOUT\",\n            message: \"Request timeout\",\n            details: error,\n          },\n        };\n      }\n\n      return {\n        data: null as unknown as TData,\n        success: false,\n        error: {\n          code: \"NETWORK_ERROR\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n          details: error,\n        },\n      };\n    }\n  }\n\n  /**\n   * Build the full URL\n   *\n   * @param url - The URL or path to build the full URL from\n   * @returns The complete URL string\n   */\n  private buildUrl(url: string): string {\n    if (url.startsWith(\"http\")) {\n      return url;\n    }\n\n    const baseUrl = this.config.baseUrl.endsWith(\"/\")\n      ? this.config.baseUrl.slice(0, -1)\n      : this.config.baseUrl;\n    const path = url.startsWith(\"/\") ? url : `/${url}`;\n\n    return `${baseUrl}${path}`;\n  }\n\n  /**\n   * Build request options with defaults\n   *\n   * @param options - The request options to merge with defaults\n   * @returns The merged request options with defaults applied\n   */\n  private buildRequestOptions(options: RequestOptions): RequestOptions {\n    return {\n      method: \"GET\",\n      headers: {},\n      timeout: this.config.timeout,\n      ...options,\n    };\n  }\n\n  /**\n   * Get client statistics\n   *\n   * @returns Object containing client statistics and performance metrics\n   */\n  getStats() {\n    return {\n      rateLimiter: this.rateLimiter\n        ? {\n            remaining: this.rateLimiter.getRemainingRequests(),\n            resetTime: this.rateLimiter.getResetTime(),\n          }\n        : null,\n      circuitBreaker: this.circuitBreaker\n        ? {\n            state: this.circuitBreaker.getState(),\n            failures: this.circuitBreaker.getFailures(),\n          }\n        : null,\n      middleware: {\n        count: this.middleware.getMiddleware().length,\n      },\n    };\n  }\n\n  /**\n   * Reset client state\n   */\n  reset(): void {\n    this.circuitBreaker?.reset();\n    this.middleware.clear();\n  }\n}\n"],"mappings":"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","names":[]}