@nmakarov/cli-toolkit 0.2.0 → 0.3.0

package/dist/http-client.js

@@ -0,0 +1,318 @@
+// src/http-client/index.ts
+import axios from "axios";
+
+// src/http-client/errors.ts
+function classifyError(error) {
+  if (error.response) {
+    const { status } = error.response;
+    switch (status) {
+      case 400:
+        return { type: "badRequest", retryable: false, isAuth: false, status: "clientError" };
+      case 401:
+        return { type: "unauthorized", retryable: false, isAuth: true, status: "authRequired" };
+      case 403:
+        return { type: "forbidden", retryable: false, isAuth: true, status: "authFailed" };
+      case 404:
+        return { type: "notFound", retryable: false, isAuth: false, status: "clientError" };
+      case 405:
+        return { type: "methodNotAllowed", retryable: false, isAuth: false, status: "clientError" };
+      case 409:
+        return { type: "conflict", retryable: false, isAuth: false, status: "clientError" };
+      case 422:
+        return { type: "unprocessableEntity", retryable: false, isAuth: false, status: "clientError" };
+      case 429:
+        return { type: "tooManyRequests", retryable: true, isAuth: false, status: "clientError" };
+      case 500:
+        return { type: "internalServerError", retryable: true, isAuth: false, status: "serverError" };
+      case 502:
+        return { type: "badGateway", retryable: true, isAuth: false, status: "serverError" };
+      case 503:
+        return { type: "serviceUnavailable", retryable: true, isAuth: false, status: "serverError" };
+      case 504:
+        return { type: "gatewayTimeout", retryable: true, isAuth: false, status: "serverError" };
+      default:
+        if (status >= 400 && status < 500) {
+          return { type: "clientError", retryable: false, isAuth: false, status: "clientError" };
+        } else if (status >= 500) {
+          return { type: "serverError", retryable: true, isAuth: false, status: "serverError" };
+        }
+        break;
+    }
+  }
+  if (error.code) {
+    switch (error.code) {
+      case "ECONNREFUSED":
+      case "ECONNRESET":
+      case "EPIPE":
+      case "ENOTFOUND":
+      case "EHOSTUNREACH":
+      case "ENETUNREACH":
+        return { type: "connectionFailed", retryable: true, isAuth: false, status: "networkError" };
+      case "ETIMEDOUT":
+      case "ECONNABORTED":
+      case "ESOCKETTIMEDOUT":
+        return { type: "timeout", retryable: true, isAuth: false, status: "timeout" };
+      case "EAUTH":
+      case "EACCES":
+        return { type: "unauthorized", retryable: false, isAuth: true, status: "authRequired" };
+      default:
+        return { type: "networkError", retryable: true, isAuth: false, status: "networkError" };
+    }
+  }
+  if (error.message && (error.message.includes("timeout") || error.message.includes("TIMEOUT") || error.message.includes("aborted"))) {
+    return { type: "timeout", retryable: true, isAuth: false, status: "timeout" };
+  }
+  if (error.name === "AbortError" || error.message?.includes("cancelled")) {
+    return { type: "requestCancelled", retryable: false, isAuth: false, status: "unknown" };
+  }
+  return { type: "unknown", retryable: false, isAuth: false, status: "unknown" };
+}
+function getErrorDescription(errorType) {
+  const descriptions = {
+    connectionFailed: "Failed to establish a connection to the server",
+    timeout: "Request timed out before completing",
+    networkError: "Network connection issue occurred",
+    badRequest: "Request was malformed or invalid",
+    unauthorized: "Authentication credentials are required",
+    forbidden: "Access to the requested resource is forbidden",
+    notFound: "The requested resource was not found",
+    methodNotAllowed: "HTTP method not allowed for this resource",
+    conflict: "Request conflicts with current server state",
+    unprocessableEntity: "Request data could not be processed",
+    tooManyRequests: "Too many requests sent in a short time",
+    internalServerError: "Server encountered an internal error",
+    badGateway: "Invalid response from upstream server",
+    serviceUnavailable: "Server is temporarily unavailable",
+    gatewayTimeout: "Upstream server timed out",
+    unknown: "An unknown error occurred",
+    requestCancelled: "Request was cancelled before completion"
+  };
+  return descriptions[errorType] || "An unknown error occurred";
+}
+
+// src/http-client/retry.ts
+function calculateRetryDelay(attempt, baseDelay, maxDelay, jitterFactor = 0.1) {
+  const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);
+  const cappedDelay = Math.min(exponentialDelay, maxDelay);
+  const jitter = cappedDelay * jitterFactor * Math.random();
+  return Math.floor(cappedDelay + jitter);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function shouldRetryError(classification) {
+  if (classification.isAuth) {
+    return false;
+  }
+  return classification.retryable;
+}
+
+// src/http-client/index.ts
+var HttpClientError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "HttpClientError";
+  }
+};
+var HttpClient = class {
+  axiosInstance;
+  config;
+  logger;
+  constructor(config = {}) {
+    this.config = {
+      timeout: 3e4,
+      // 30 seconds
+      retryCount: 3,
+      // 3 retry attempts
+      retryDelay: 1e3,
+      // 1 second base delay
+      maxRetryDelay: 3e4,
+      // 30 second max delay
+      retryJitter: 0.1,
+      // 10% jitter
+      userAgent: "HttpClient/v1.0",
+      validateSSL: true,
+      maxRedirects: 5,
+      logger: console,
+      ...config
+    };
+    this.logger = this.config.logger;
+    this.axiosInstance = axios.create({
+      timeout: this.config.timeout,
+      validateStatus: () => true,
+      // Never throw on HTTP status codes
+      maxRedirects: this.config.maxRedirects,
+      headers: {
+        "User-Agent": this.config.userAgent
+      },
+      // SSL validation
+      httpsAgent: this.config.validateSSL ? void 0 : {
+        rejectUnauthorized: false
+      }
+    });
+    this.axiosInstance.interceptors.response.use(
+      (response) => response,
+      (error) => {
+        return Promise.reject(error);
+      }
+    );
+  }
+  /**
+   * Make an HTTP request with automatic retry logic
+   * Never throws - always returns HttpClientResponse
+   */
+  async request(method, url, options = {}) {
+    const startTime = Date.now();
+    const requestConfig = {
+      method,
+      url,
+      timeout: options.timeout || this.config.timeout,
+      headers: {
+        "User-Agent": options.userAgent || this.config.userAgent,
+        ...options.headers
+      },
+      params: options.params,
+      data: options.data
+    };
+    const retryCount = options.retryCount ?? this.config.retryCount;
+    const retryDelay = options.retryDelay ?? this.config.retryDelay;
+    let retryContext = null;
+    let lastError = null;
+    for (let attempt = 1; attempt <= retryCount + 1; attempt++) {
+      try {
+        if (options.debug) {
+          this.logger.debug?.(`[HttpClient] ${method} ${url} (attempt ${attempt}/${retryCount + 1})`);
+        }
+        const response = await this.axiosInstance.request(requestConfig);
+        const duration = Date.now() - startTime;
+        const customStatus = this.mapHttpStatusToCustomStatus(response.status);
+        if (options.debug) {
+          this.logger.debug?.(`[HttpClient] ${method} ${url} \u2192 ${response.status} ${customStatus} (${duration}ms)`);
+        }
+        return {
+          status: customStatus,
+          code: response.status,
+          headers: response.headers,
+          data: response.data,
+          duration,
+          retryCount: attempt - 1,
+          finalUrl: response.request?.res?.responseUrl || url
+        };
+      } catch (error) {
+        lastError = error;
+        const duration = Date.now() - startTime;
+        const classification = classifyError(error);
+        const errorDescription = getErrorDescription(classification.type);
+        if (classification.retryable && attempt <= retryCount) {
+          this.logger.warn?.(`[HttpClient] ${method} ${url} failed (${classification.type}): ${errorDescription}. Retrying in ${retryDelay}ms...`);
+        } else if (!classification.retryable || attempt > retryCount) {
+          this.logger.error?.(`[HttpClient] ${method} ${url} failed (${classification.type}): ${errorDescription}`);
+        }
+        if (attempt <= retryCount && shouldRetryError(classification)) {
+          const delay = calculateRetryDelay(
+            attempt,
+            retryDelay,
+            this.config.maxRetryDelay,
+            this.config.retryJitter
+          );
+          if (options.debug) {
+            this.logger.debug?.(`[HttpClient] Waiting ${delay}ms before retry ${attempt + 1}`);
+          }
+          await sleep(delay);
+          continue;
+        }
+        return {
+          status: classification.status,
+          code: error.response?.status || null,
+          error: classification.type,
+          headers: error.response?.headers || null,
+          data: error.response?.data || null,
+          duration,
+          retryCount: attempt - 1,
+          finalUrl: url
+        };
+      }
+    }
+    return {
+      status: "unknown",
+      code: null,
+      error: "unknown",
+      headers: null,
+      data: null,
+      duration: Date.now() - startTime,
+      retryCount,
+      finalUrl: url
+    };
+  }
+  /**
+   * GET request
+   */
+  async get(url, options = {}) {
+    return this.request("GET", url, options);
+  }
+  /**
+   * POST request
+   */
+  async post(url, options = {}) {
+    return this.request("POST", url, options);
+  }
+  /**
+   * PUT request
+   */
+  async put(url, options = {}) {
+    return this.request("PUT", url, options);
+  }
+  /**
+   * DELETE request
+   */
+  async delete(url, options = {}) {
+    return this.request("DELETE", url, options);
+  }
+  /**
+   * PATCH request
+   */
+  async patch(url, options = {}) {
+    return this.request("PATCH", url, options);
+  }
+  /**
+   * HEAD request
+   */
+  async head(url, options = {}) {
+    return this.request("HEAD", url, options);
+  }
+  /**
+   * OPTIONS request
+   */
+  async options(url, options = {}) {
+    return this.request("OPTIONS", url, options);
+  }
+  /**
+   * Map HTTP status code to custom status
+   */
+  mapHttpStatusToCustomStatus(httpStatus) {
+    if (httpStatus >= 200 && httpStatus < 300) {
+      return "success";
+    } else if (httpStatus === 401) {
+      return "authRequired";
+    } else if (httpStatus === 403) {
+      return "authFailed";
+    } else if (httpStatus >= 400 && httpStatus < 500) {
+      return "clientError";
+    } else if (httpStatus >= 500) {
+      return "serverError";
+    }
+    return "unknown";
+  }
+  /**
+   * Get current configuration (for debugging)
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+};
+export {
+  HttpClient,
+  HttpClientError
+};
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http-client/index.ts","../src/http-client/errors.ts","../src/http-client/retry.ts"],"sourcesContent":["/**\n * HttpClient - Resilient HTTP Client with Retry Logic\n *\n * A production-ready HTTP client that:\n * - Wraps axios with enhanced error handling and retry logic\n * - Never throws exceptions - always returns unified response format\n * - Uses exponential backoff with jitter for retries\n * - Provides human-readable error classifications\n * - Supports comprehensive logging\n * - Handles all HTTP methods consistently\n */\n\nimport axios, { AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';\nimport type {\n    HttpClientConfig,\n    RequestOptions,\n    HttpClientResponse,\n    HttpMethod,\n    HttpClientStatus,\n    RetryContext\n} from './types.js';\nimport { classifyError, getErrorDescription } from './errors.js';\nimport { calculateRetryDelay, sleep, shouldRetryError, createRetryContext, updateRetryContext } from './retry.js';\n\n/**\n * HttpClient Error class\n */\nexport class HttpClientError extends Error {\n    constructor(message: string, public readonly cause?: Error) {\n        super(message);\n        this.name = 'HttpClientError';\n    }\n}\n\n/**\n * Resilient HTTP Client with automatic retry logic\n */\nexport class HttpClient {\n    private axiosInstance: AxiosInstance;\n    private config: Required<HttpClientConfig>;\n    private logger: any;\n\n    constructor(config: HttpClientConfig = {}) {\n        this.config = {\n            timeout: 30000,           // 30 seconds\n            retryCount: 3,            // 3 retry attempts\n            retryDelay: 1000,         // 1 second base delay\n            maxRetryDelay: 30000,     // 30 second max delay\n            retryJitter: 0.1,         // 10% jitter\n            userAgent: 'HttpClient/v1.0',\n            validateSSL: true,\n            maxRedirects: 5,\n            logger: console,\n            ...config\n        };\n\n        this.logger = this.config.logger;\n\n        // Create axios instance with base configuration\n        this.axiosInstance = axios.create({\n            timeout: this.config.timeout,\n            validateStatus: () => true, // Never throw on HTTP status codes\n            maxRedirects: this.config.maxRedirects,\n            headers: {\n                'User-Agent': this.config.userAgent\n            },\n            // SSL validation\n            httpsAgent: this.config.validateSSL ? undefined : {\n                rejectUnauthorized: false\n            } as any\n        });\n\n        // Add response interceptor for logging (optional - only if debug enabled)\n        this.axiosInstance.interceptors.response.use(\n            (response) => response,\n            (error) => {\n                // Log network-level errors here if needed\n                // (HTTP errors are handled in the request method)\n                return Promise.reject(error);\n            }\n        );\n    }\n\n    /**\n     * Make an HTTP request with automatic retry logic\n     * Never throws - always returns HttpClientResponse\n     */\n    async request(\n        method: HttpMethod,\n        url: string,\n        options: RequestOptions = {}\n    ): Promise<HttpClientResponse> {\n        const startTime = Date.now();\n\n        // Merge request options with defaults\n        const requestConfig: AxiosRequestConfig = {\n            method,\n            url,\n            timeout: options.timeout || this.config.timeout,\n            headers: {\n                'User-Agent': options.userAgent || this.config.userAgent,\n                ...options.headers\n            },\n            params: options.params,\n            data: options.data\n        };\n\n        const retryCount = options.retryCount ?? this.config.retryCount;\n        const retryDelay = options.retryDelay ?? this.config.retryDelay;\n\n        // Initialize retry context\n        let retryContext: RetryContext | null = null;\n        let lastError: any = null;\n\n        // Attempt the request with retries\n        for (let attempt = 1; attempt <= retryCount + 1; attempt++) {\n            try {\n                if (options.debug) {\n                    this.logger.debug?.(`[HttpClient] ${method} ${url} (attempt ${attempt}/${retryCount + 1})`);\n                }\n\n                const response: AxiosResponse = await this.axiosInstance.request(requestConfig);\n                const duration = Date.now() - startTime;\n\n                // Success! Return unified response format\n                const customStatus = this.mapHttpStatusToCustomStatus(response.status);\n\n                if (options.debug) {\n                    this.logger.debug?.(`[HttpClient] ${method} ${url} → ${response.status} ${customStatus} (${duration}ms)`);\n                }\n\n                return {\n                    status: customStatus,\n                    code: response.status,\n                    headers: response.headers as Record<string, string>,\n                    data: response.data,\n                    duration,\n                    retryCount: attempt - 1,\n                    finalUrl: response.request?.res?.responseUrl || url\n                };\n\n            } catch (error: any) {\n                lastError = error;\n                const duration = Date.now() - startTime;\n\n                // Classify the error\n                const classification = classifyError(error);\n                const errorDescription = getErrorDescription(classification.type);\n\n                // Log the error\n                if (classification.retryable && attempt <= retryCount) {\n                    this.logger.warn?.(`[HttpClient] ${method} ${url} failed (${classification.type}): ${errorDescription}. Retrying in ${retryDelay}ms...`);\n                } else if (!classification.retryable || attempt > retryCount) {\n                    this.logger.error?.(`[HttpClient] ${method} ${url} failed (${classification.type}): ${errorDescription}`);\n                }\n\n                // Check if we should retry\n                if (attempt <= retryCount && shouldRetryError(classification)) {\n                    // Calculate delay and wait\n                    const delay = calculateRetryDelay(\n                        attempt,\n                        retryDelay,\n                        this.config.maxRetryDelay,\n                        this.config.retryJitter\n                    );\n\n                    if (options.debug) {\n                        this.logger.debug?.(`[HttpClient] Waiting ${delay}ms before retry ${attempt + 1}`);\n                    }\n\n                    await sleep(delay);\n                    continue;\n                }\n\n                // No more retries or not retryable - return error response\n                return {\n                    status: classification.status,\n                    code: error.response?.status || null,\n                    error: classification.type,\n                    headers: error.response?.headers || null,\n                    data: error.response?.data || null,\n                    duration,\n                    retryCount: attempt - 1,\n                    finalUrl: url\n                };\n            }\n        }\n\n        // This should never be reached, but just in case\n        return {\n            status: 'unknown',\n            code: null,\n            error: 'unknown',\n            headers: null,\n            data: null,\n            duration: Date.now() - startTime,\n            retryCount: retryCount,\n            finalUrl: url\n        };\n    }\n\n    /**\n     * GET request\n     */\n    async get(url: string, options: RequestOptions = {}): Promise<HttpClientResponse> {\n        return this.request('GET', url, options);\n    }\n\n    /**\n     * POST request\n     */\n    async post(url: string, options: RequestOptions = {}): Promise<HttpClientResponse> {\n        return this.request('POST', url, options);\n    }\n\n    /**\n     * PUT request\n     */\n    async put(url: string, options: RequestOptions = {}): Promise<HttpClientResponse> {\n        return this.request('PUT', url, options);\n    }\n\n    /**\n     * DELETE request\n     */\n    async delete(url: string, options: RequestOptions = {}): Promise<HttpClientResponse> {\n        return this.request('DELETE', url, options);\n    }\n\n    /**\n     * PATCH request\n     */\n    async patch(url: string, options: RequestOptions = {}): Promise<HttpClientResponse> {\n        return this.request('PATCH', url, options);\n    }\n\n    /**\n     * HEAD request\n     */\n    async head(url: string, options: RequestOptions = {}): Promise<HttpClientResponse> {\n        return this.request('HEAD', url, options);\n    }\n\n    /**\n     * OPTIONS request\n     */\n    async options(url: string, options: RequestOptions = {}): Promise<HttpClientResponse> {\n        return this.request('OPTIONS', url, options);\n    }\n\n    /**\n     * Map HTTP status code to custom status\n     */\n    private mapHttpStatusToCustomStatus(httpStatus: number): HttpClientStatus {\n        if (httpStatus >= 200 && httpStatus < 300) {\n            return 'success';\n        } else if (httpStatus === 401) {\n            return 'authRequired';\n        } else if (httpStatus === 403) {\n            return 'authFailed';\n        } else if (httpStatus >= 400 && httpStatus < 500) {\n            return 'clientError';\n        } else if (httpStatus >= 500) {\n            return 'serverError';\n        }\n        return 'unknown';\n    }\n\n    /**\n     * Get current configuration (for debugging)\n     */\n    getConfig(): Readonly<HttpClientConfig> {\n        return { ...this.config };\n    }\n}\n","/**\n * HttpClient Error Classification\n *\n * Maps technical errors to human-readable, use-case oriented error types\n */\n\nimport type { HttpClientErrorType, HttpClientStatus, ErrorClassification } from './types.js';\n\n/**\n * Classify an error and determine retry behavior\n */\nexport function classifyError(error: any): ErrorClassification {\n    // Handle axios response errors (HTTP errors)\n    if (error.response) {\n        const { status } = error.response;\n\n        switch (status) {\n            case 400:\n                return { type: 'badRequest', retryable: false, isAuth: false, status: 'clientError' };\n            case 401:\n                return { type: 'unauthorized', retryable: false, isAuth: true, status: 'authRequired' };\n            case 403:\n                return { type: 'forbidden', retryable: false, isAuth: true, status: 'authFailed' };\n            case 404:\n                return { type: 'notFound', retryable: false, isAuth: false, status: 'clientError' };\n            case 405:\n                return { type: 'methodNotAllowed', retryable: false, isAuth: false, status: 'clientError' };\n            case 409:\n                return { type: 'conflict', retryable: false, isAuth: false, status: 'clientError' };\n            case 422:\n                return { type: 'unprocessableEntity', retryable: false, isAuth: false, status: 'clientError' };\n            case 429:\n                return { type: 'tooManyRequests', retryable: true, isAuth: false, status: 'clientError' };\n            case 500:\n                return { type: 'internalServerError', retryable: true, isAuth: false, status: 'serverError' };\n            case 502:\n                return { type: 'badGateway', retryable: true, isAuth: false, status: 'serverError' };\n            case 503:\n                return { type: 'serviceUnavailable', retryable: true, isAuth: false, status: 'serverError' };\n            case 504:\n                return { type: 'gatewayTimeout', retryable: true, isAuth: false, status: 'serverError' };\n            default:\n                if (status >= 400 && status < 500) {\n                    return { type: 'clientError' as HttpClientErrorType, retryable: false, isAuth: false, status: 'clientError' };\n                } else if (status >= 500) {\n                    return { type: 'serverError' as HttpClientErrorType, retryable: true, isAuth: false, status: 'serverError' };\n                }\n                break;\n        }\n    }\n\n    // Handle network/connection errors (no response)\n    if (error.code) {\n        switch (error.code) {\n            case 'ECONNREFUSED':\n            case 'ECONNRESET':\n            case 'EPIPE':\n            case 'ENOTFOUND':\n            case 'EHOSTUNREACH':\n            case 'ENETUNREACH':\n                return { type: 'connectionFailed', retryable: true, isAuth: false, status: 'networkError' };\n\n            case 'ETIMEDOUT':\n            case 'ECONNABORTED':\n            case 'ESOCKETTIMEDOUT':\n                return { type: 'timeout', retryable: true, isAuth: false, status: 'timeout' };\n\n            case 'EAUTH':\n            case 'EACCES':\n                return { type: 'unauthorized', retryable: false, isAuth: true, status: 'authRequired' };\n\n            default:\n                return { type: 'networkError', retryable: true, isAuth: false, status: 'networkError' };\n        }\n    }\n\n    // Handle timeout errors\n    if (error.message && (\n        error.message.includes('timeout') ||\n        error.message.includes('TIMEOUT') ||\n        error.message.includes('aborted')\n    )) {\n        return { type: 'timeout', retryable: true, isAuth: false, status: 'timeout' };\n    }\n\n    // Handle cancellation\n    if (error.name === 'AbortError' || error.message?.includes('cancelled')) {\n        return { type: 'requestCancelled', retryable: false, isAuth: false, status: 'unknown' };\n    }\n\n    // Default fallback\n    return { type: 'unknown', retryable: false, isAuth: false, status: 'unknown' };\n}\n\n/**\n * Get a human-readable description for an error type\n */\nexport function getErrorDescription(errorType: HttpClientErrorType): string {\n    const descriptions: Record<HttpClientErrorType, string> = {\n        connectionFailed: 'Failed to establish a connection to the server',\n        timeout: 'Request timed out before completing',\n        networkError: 'Network connection issue occurred',\n        badRequest: 'Request was malformed or invalid',\n        unauthorized: 'Authentication credentials are required',\n        forbidden: 'Access to the requested resource is forbidden',\n        notFound: 'The requested resource was not found',\n        methodNotAllowed: 'HTTP method not allowed for this resource',\n        conflict: 'Request conflicts with current server state',\n        unprocessableEntity: 'Request data could not be processed',\n        tooManyRequests: 'Too many requests sent in a short time',\n        internalServerError: 'Server encountered an internal error',\n        badGateway: 'Invalid response from upstream server',\n        serviceUnavailable: 'Server is temporarily unavailable',\n        gatewayTimeout: 'Upstream server timed out',\n        unknown: 'An unknown error occurred',\n        requestCancelled: 'Request was cancelled before completion'\n    };\n\n    return descriptions[errorType] || 'An unknown error occurred';\n}\n","/**\n * HttpClient Retry Logic\n *\n * Implements exponential backoff with jitter to prevent thundering herd problems\n */\n\nimport type { RetryContext } from './types.js';\n\n/**\n * Calculate the next retry delay using exponential backoff with jitter\n *\n * Formula: delay = baseDelay * (2 ^ (attempt - 1)) + randomJitter\n *\n * Jitter prevents the \"thundering herd\" problem where multiple failed requests\n * all retry at the exact same time, overwhelming the server.\n */\nexport function calculateRetryDelay(\n    attempt: number,\n    baseDelay: number,\n    maxDelay: number,\n    jitterFactor: number = 0.1\n): number {\n    // Exponential backoff: baseDelay * (2 ^ (attempt - 1))\n    const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);\n\n    // Cap at maximum delay\n    const cappedDelay = Math.min(exponentialDelay, maxDelay);\n\n    // Add jitter: random variation up to jitterFactor of the delay\n    const jitter = cappedDelay * jitterFactor * Math.random();\n\n    return Math.floor(cappedDelay + jitter);\n}\n\n/**\n * Sleep for the specified number of milliseconds\n */\nexport function sleep(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Determine if an error should be retried based on classification\n */\nexport function shouldRetryError(classification: { retryable: boolean; isAuth: boolean }): boolean {\n    // Never retry auth errors (they won't succeed with the same credentials)\n    if (classification.isAuth) {\n        return false;\n    }\n\n    // Retry if the error is classified as retryable\n    return classification.retryable;\n}\n\n/**\n * Create a retry context for tracking retry attempts\n */\nexport function createRetryContext(\n    maxAttempts: number,\n    baseDelay: number,\n    maxDelay: number,\n    jitterFactor: number\n): RetryContext {\n    return {\n        attempt: 1,\n        maxAttempts,\n        lastError: new Error('Initial attempt'),\n        totalDelay: 0,\n        nextDelay: calculateRetryDelay(1, baseDelay, maxDelay, jitterFactor)\n    };\n}\n\n/**\n * Update retry context for the next attempt\n */\nexport function updateRetryContext(\n    context: RetryContext,\n    lastError: Error,\n    baseDelay: number,\n    maxDelay: number,\n    jitterFactor: number\n): RetryContext {\n    const nextAttempt = context.attempt + 1;\n    const nextDelay = calculateRetryDelay(nextAttempt, baseDelay, maxDelay, jitterFactor);\n\n    return {\n        attempt: nextAttempt,\n        maxAttempts: context.maxAttempts,\n        lastError,\n        totalDelay: context.totalDelay + context.nextDelay,\n        nextDelay\n    };\n}\n"],"mappings":"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","names":[]}