opencode-puter-auth 1.0.1 → 1.0.3

package/dist/retry.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Retry utilities with exponential backoff and jitter
+ *
+ * Provides robust retry logic for handling transient failures
+ * in API calls to Puter.com
+ */
+/**
+ * Configuration options for retry behavior
+ */
+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: 30000) */
+    maxDelay?: number;
+    /** Backoff multiplier (default: 2) */
+    backoffFactor?: number;
+    /** Add random jitter to delays (default: true) */
+    jitter?: boolean;
+    /** HTTP status codes that should trigger a retry (default: [429, 500, 502, 503, 504]) */
+    retryableStatuses?: number[];
+    /** Callback called before each retry attempt */
+    onRetry?: (attempt: number, error: Error, delay: number) => void;
+}
+/**
+ * Error class for retry-related failures
+ */
+export declare class RetryError extends Error {
+    readonly attempts: number;
+    readonly lastError: Error;
+    constructor(message: string, attempts: number, lastError: Error);
+}
+/**
+ * Calculate delay with exponential backoff and optional jitter
+ *
+ * @param attempt - Current attempt number (0-indexed)
+ * @param options - Retry options
+ * @returns Delay in milliseconds
+ *
+ * @example
+ * ```ts
+ * // Attempt 0: ~1000ms
+ * // Attempt 1: ~2000ms
+ * // Attempt 2: ~4000ms
+ * const delay = calculateDelay(2, { initialDelay: 1000, backoffFactor: 2 });
+ * ```
+ */
+export declare function calculateDelay(attempt: number, options?: Pick<RetryOptions, 'initialDelay' | 'maxDelay' | 'backoffFactor' | 'jitter'>): number;
+/**
+ * Sleep for a specified duration
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Promise that resolves after the delay
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Check if an error is retryable based on HTTP status
+ *
+ * @param error - The error to check
+ * @param retryableStatuses - List of HTTP status codes that should trigger retry
+ * @returns true if the error should trigger a retry
+ */
+export declare function isRetryableError(error: unknown, retryableStatuses?: number[]): boolean;
+/**
+ * Execute an async operation with retry logic
+ *
+ * Uses exponential backoff with jitter to handle transient failures.
+ * Only retries on specific error conditions (rate limits, server errors, network issues).
+ *
+ * @param operation - Async function to execute
+ * @param options - Retry configuration options
+ * @returns Result of the operation
+ * @throws RetryError if all retry attempts fail
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *   () => fetch('https://api.example.com/data'),
+ *   {
+ *     maxRetries: 3,
+ *     onRetry: (attempt, error, delay) => {
+ *       console.log(`Retry ${attempt} after ${delay}ms: ${error.message}`);
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Create a fetch wrapper with built-in retry logic
+ *
+ * @param options - Retry configuration options
+ * @returns A fetch function with retry capabilities
+ *
+ * @example
+ * ```ts
+ * const fetchWithRetry = createRetryFetch({ maxRetries: 3 });
+ * const response = await fetchWithRetry('https://api.example.com/data');
+ * ```
+ */
+export declare function createRetryFetch(options?: RetryOptions): (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,KAAK,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK;CAMhE;AAcD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,UAAU,GAAG,eAAe,GAAG,QAAQ,CAAM,GACzF,MAAM,CAsBR;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,iBAAiB,GAAE,MAAM,EAA4C,GACpE,OAAO,CA0BT;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA8CZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,YAAiB,IAEvD,OAAO,WAAW,GAAG,GAAG,EACxB,OAAO,WAAW,KACjB,OAAO,CAAC,QAAQ,CAAC,CAarB"}

package/dist/retry.js

@@ -0,0 +1,175 @@
+/**
+ * Retry utilities with exponential backoff and jitter
+ *
+ * Provides robust retry logic for handling transient failures
+ * in API calls to Puter.com
+ */
+/**
+ * Error class for retry-related failures
+ */
+export class RetryError extends Error {
+    attempts;
+    lastError;
+    constructor(message, attempts, lastError) {
+        super(message);
+        this.name = 'RetryError';
+        this.attempts = attempts;
+        this.lastError = lastError;
+    }
+}
+/**
+ * Default retry options
+ */
+const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    maxDelay: 30000,
+    backoffFactor: 2,
+    jitter: true,
+    retryableStatuses: [429, 500, 502, 503, 504],
+};
+/**
+ * Calculate delay with exponential backoff and optional jitter
+ *
+ * @param attempt - Current attempt number (0-indexed)
+ * @param options - Retry options
+ * @returns Delay in milliseconds
+ *
+ * @example
+ * ```ts
+ * // Attempt 0: ~1000ms
+ * // Attempt 1: ~2000ms
+ * // Attempt 2: ~4000ms
+ * const delay = calculateDelay(2, { initialDelay: 1000, backoffFactor: 2 });
+ * ```
+ */
+export function calculateDelay(attempt, options = {}) {
+    const { initialDelay = DEFAULT_RETRY_OPTIONS.initialDelay, maxDelay = DEFAULT_RETRY_OPTIONS.maxDelay, backoffFactor = DEFAULT_RETRY_OPTIONS.backoffFactor, jitter = DEFAULT_RETRY_OPTIONS.jitter, } = options;
+    // Calculate base delay with exponential backoff
+    const baseDelay = initialDelay * Math.pow(backoffFactor, attempt);
+    // Cap at maxDelay
+    const cappedDelay = Math.min(baseDelay, maxDelay);
+    // Add jitter (±25% randomness) to prevent thundering herd
+    if (jitter) {
+        const jitterRange = cappedDelay * 0.25;
+        const randomJitter = (Math.random() - 0.5) * 2 * jitterRange;
+        return Math.max(0, Math.round(cappedDelay + randomJitter));
+    }
+    return Math.round(cappedDelay);
+}
+/**
+ * Sleep for a specified duration
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Promise that resolves after the delay
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Check if an error is retryable based on HTTP status
+ *
+ * @param error - The error to check
+ * @param retryableStatuses - List of HTTP status codes that should trigger retry
+ * @returns true if the error should trigger a retry
+ */
+export function isRetryableError(error, retryableStatuses = DEFAULT_RETRY_OPTIONS.retryableStatuses) {
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        // Check for status codes in error message
+        for (const status of retryableStatuses) {
+            if (message.includes(`(${status})`) || message.includes(`status ${status}`)) {
+                return true;
+            }
+        }
+        // Check for common transient error patterns
+        if (message.includes('timeout') ||
+            message.includes('econnreset') ||
+            message.includes('econnrefused') ||
+            message.includes('network') ||
+            message.includes('socket hang up') ||
+            message.includes('rate limit') ||
+            message.includes('too many requests')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Execute an async operation with retry logic
+ *
+ * Uses exponential backoff with jitter to handle transient failures.
+ * Only retries on specific error conditions (rate limits, server errors, network issues).
+ *
+ * @param operation - Async function to execute
+ * @param options - Retry configuration options
+ * @returns Result of the operation
+ * @throws RetryError if all retry attempts fail
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *   () => fetch('https://api.example.com/data'),
+ *   {
+ *     maxRetries: 3,
+ *     onRetry: (attempt, error, delay) => {
+ *       console.log(`Retry ${attempt} after ${delay}ms: ${error.message}`);
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export async function withRetry(operation, options = {}) {
+    const { maxRetries = DEFAULT_RETRY_OPTIONS.maxRetries, initialDelay = DEFAULT_RETRY_OPTIONS.initialDelay, maxDelay = DEFAULT_RETRY_OPTIONS.maxDelay, backoffFactor = DEFAULT_RETRY_OPTIONS.backoffFactor, jitter = DEFAULT_RETRY_OPTIONS.jitter, retryableStatuses = DEFAULT_RETRY_OPTIONS.retryableStatuses, onRetry, } = options;
+    let lastError = new Error('Unknown error');
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Check if we should retry
+            const isLastAttempt = attempt === maxRetries;
+            const shouldRetry = !isLastAttempt && isRetryableError(error, retryableStatuses);
+            if (!shouldRetry) {
+                throw lastError;
+            }
+            // Calculate delay for next attempt
+            const delay = calculateDelay(attempt, { initialDelay, maxDelay, backoffFactor, jitter });
+            // Call onRetry callback if provided
+            if (onRetry) {
+                onRetry(attempt + 1, lastError, delay);
+            }
+            // Wait before retrying
+            await sleep(delay);
+        }
+    }
+    // This should never be reached, but TypeScript needs it
+    throw new RetryError(`Operation failed after ${maxRetries + 1} attempts`, maxRetries + 1, lastError);
+}
+/**
+ * Create a fetch wrapper with built-in retry logic
+ *
+ * @param options - Retry configuration options
+ * @returns A fetch function with retry capabilities
+ *
+ * @example
+ * ```ts
+ * const fetchWithRetry = createRetryFetch({ maxRetries: 3 });
+ * const response = await fetchWithRetry('https://api.example.com/data');
+ * ```
+ */
+export function createRetryFetch(options = {}) {
+    return async function retryFetch(input, init) {
+        return withRetry(async () => {
+            const response = await fetch(input, init);
+            // Check if response status indicates a retryable error
+            const retryableStatuses = options.retryableStatuses || DEFAULT_RETRY_OPTIONS.retryableStatuses;
+            if (retryableStatuses.includes(response.status)) {
+                throw new Error(`HTTP error (${response.status}): ${response.statusText}`);
+            }
+            return response;
+        }, options);
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-puter-auth",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Puter.com OAuth auth plugin for OpenCode - FREE UNLIMITED access to Claude Opus 4.5, Sonnet 4.5, GPT-5, Gemini, and 500+ AI models",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -69,6 +69,8 @@
     "vitest": "^4.0.0"
   },
   "dependencies": {
+    "@ai-sdk/provider": "^3.0.3",
+    "@ai-sdk/provider-utils": "^4.0.7",
     "open": "^11.0.0",
     "xdg-basedir": "^5.1.0",
     "zod": "^4.3.5"