nim-sync 1.0.0

package/dist/lib/retry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Exponential backoff retry utility for API calls.
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial delay in milliseconds (default: 1000) */
+    initialDelay?: number;
+    /** Maximum delay in milliseconds (default: 10000) */
+    maxDelay?: number;
+    /** Whether to retry on network errors (default: true) */
+    retryOnNetworkError?: boolean;
+    /** Status codes to retry (default: [429, 500, 502, 503, 504]) */
+    retryStatusCodes?: number[];
+}
+/**
+ * Executes a function with exponential backoff retry logic.
+ *
+ * @param fn - Function to execute with retry logic
+ * @param options - Retry configuration options
+ * @returns Result of the function if successful
+ * @throws Last error if all retries are exhausted
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Creates a retryable fetch wrapper with exponential backoff.
+ *
+ * @param apiKey - API key for authentication
+ * @param baseURL - Base URL for the API
+ * @param endpoint - API endpoint to call
+ * @param options - Retry configuration options
+ * @returns Fetch response with retry logic
+ */
+export declare function retryableFetch(apiKey: string, baseURL: string, endpoint: string, options?: RetryOptions): Promise<Response>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/lib/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/lib/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B;AAUD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA8BZ;AAwED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAenB"}

package/dist/lib/retry.js

@@ -0,0 +1,122 @@
+/**
+ * Exponential backoff retry utility for API calls.
+ */
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    maxDelay: 10000,
+    retryOnNetworkError: true,
+    retryStatusCodes: [429, 500, 502, 503, 504]
+};
+/**
+ * Executes a function with exponential backoff retry logic.
+ *
+ * @param fn - Function to execute with retry logic
+ * @param options - Retry configuration options
+ * @returns Result of the function if successful
+ * @throws Last error if all retries are exhausted
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError = null;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Determine if we should retry
+            const shouldRetry = shouldRetryError(error, opts);
+            if (!shouldRetry || attempt === opts.maxRetries) {
+                throw lastError;
+            }
+            // Calculate delay with exponential backoff
+            const delay = Math.min(opts.initialDelay * Math.pow(2, attempt), opts.maxDelay);
+            // Wait before retrying
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    // This should never be reached due to throw in loop, but TypeScript needs it
+    throw lastError || new Error('Retry logic failed unexpectedly');
+}
+/**
+ * Determines if an error should trigger a retry.
+ *
+ * @param error - The caught error
+ * @param options - Retry configuration
+ * @returns True if the error should trigger a retry
+ */
+function shouldRetryError(error, options) {
+    // Network errors (timeouts, connection refused, etc.)
+    if (options.retryOnNetworkError && isNetworkError(error)) {
+        return true;
+    }
+    // Check if it's an HTTP error with retryable status code
+    if (isHttpError(error)) {
+        const statusCode = getStatusCode(error);
+        return options.retryStatusCodes.includes(statusCode);
+    }
+    return false;
+}
+/**
+ * Checks if an error is a network error (timeout, connection refused, etc.).
+ */
+function isNetworkError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const networkErrorPatterns = [
+        'network',
+        'timeout',
+        'connection',
+        'fetch',
+        'abort',
+        'ECONNREFUSED',
+        'ETIMEDOUT'
+    ];
+    const message = error.message.toLowerCase();
+    const name = error.name.toLowerCase();
+    return networkErrorPatterns.some(pattern => message.includes(pattern) || name.includes(pattern));
+}
+/**
+ * Checks if an error is an HTTP error with a status code.
+ */
+function isHttpError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'statusCode' in error &&
+        typeof error.statusCode === 'number');
+}
+/**
+ * Extracts the status code from an HTTP error.
+ */
+function getStatusCode(error) {
+    if (isHttpError(error)) {
+        return error.statusCode;
+    }
+    return 0;
+}
+/**
+ * Creates a retryable fetch wrapper with exponential backoff.
+ *
+ * @param apiKey - API key for authentication
+ * @param baseURL - Base URL for the API
+ * @param endpoint - API endpoint to call
+ * @param options - Retry configuration options
+ * @returns Fetch response with retry logic
+ */
+export async function retryableFetch(apiKey, baseURL, endpoint, options = {}) {
+    return withRetry(async () => {
+        const response = await fetch(`${baseURL}${endpoint}`, {
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            throw { statusCode: response.status, statusText: response.statusText };
+        }
+        return response;
+    }, options);
+}
+//# sourceMappingURL=retry.js.map

package/dist/lib/retry.js.map

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