@jam-nodes/nodes 0.2.4 → 0.2.5

package/dist/utils/http.d.ts

@@ -0,0 +1,60 @@
+/**
+ * HTTP utilities for making API calls with retry logic, timeouts, and rate limiting.
+ */
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Configuration for fetch with retry
+ */
+export interface FetchWithRetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Base delay in milliseconds for exponential backoff (default: 1000) */
+    backoffMs?: number;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeoutMs?: number;
+}
+/**
+ * Error thrown when all retry attempts are exhausted
+ */
+export declare class FetchRetryError extends Error {
+    readonly status?: number | undefined;
+    readonly body?: string | undefined;
+    constructor(message: string, status?: number | undefined, body?: string | undefined);
+}
+/**
+ * Fetch with automatic retry, timeout, and rate limit handling.
+ *
+ * Features:
+ * - Exponential backoff on rate limits (429) and server errors (5xx)
+ * - Configurable timeout
+ * - Respects Retry-After header
+ * - Does not retry on auth errors (401, 403) or client errors (4xx)
+ *
+ * @param url - URL to fetch
+ * @param options - Fetch options (same as native fetch)
+ * @param config - Retry and timeout configuration
+ * @returns Promise resolving to Response
+ * @throws FetchRetryError if all retries exhausted or non-retryable error
+ *
+ * @example
+ * ```typescript
+ * const response = await fetchWithRetry(
+ *   'https://api.example.com/data',
+ *   {
+ *     method: 'POST',
+ *     headers: { 'Authorization': 'Bearer token' },
+ *     body: JSON.stringify({ key: 'value' })
+ *   },
+ *   { maxRetries: 3, timeoutMs: 30000 }
+ * );
+ * ```
+ */
+export declare function fetchWithRetry(url: string, options?: RequestInit, config?: FetchWithRetryOptions): Promise<Response>;
+/**
+ * Parse JSON response with error handling
+ */
+export declare function parseJsonResponse<T>(response: Response): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAAC,QAAQ,CAAC,CAoFnB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAWzE"}

package/dist/utils/http.js

@@ -0,0 +1,126 @@
+/**
+ * HTTP utilities for making API calls with retry logic, timeouts, and rate limiting.
+ */
+/**
+ * Sleep for a specified duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Error thrown when all retry attempts are exhausted
+ */
+export class FetchRetryError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'FetchRetryError';
+    }
+}
+/**
+ * Fetch with automatic retry, timeout, and rate limit handling.
+ *
+ * Features:
+ * - Exponential backoff on rate limits (429) and server errors (5xx)
+ * - Configurable timeout
+ * - Respects Retry-After header
+ * - Does not retry on auth errors (401, 403) or client errors (4xx)
+ *
+ * @param url - URL to fetch
+ * @param options - Fetch options (same as native fetch)
+ * @param config - Retry and timeout configuration
+ * @returns Promise resolving to Response
+ * @throws FetchRetryError if all retries exhausted or non-retryable error
+ *
+ * @example
+ * ```typescript
+ * const response = await fetchWithRetry(
+ *   'https://api.example.com/data',
+ *   {
+ *     method: 'POST',
+ *     headers: { 'Authorization': 'Bearer token' },
+ *     body: JSON.stringify({ key: 'value' })
+ *   },
+ *   { maxRetries: 3, timeoutMs: 30000 }
+ * );
+ * ```
+ */
+export async function fetchWithRetry(url, options = {}, config = {}) {
+    const { maxRetries = 3, backoffMs = 1000, timeoutMs = 30000 } = config;
+    let lastError = null;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            // Don't retry on auth errors
+            if (response.status === 401 || response.status === 403) {
+                const errorText = await response.text();
+                throw new FetchRetryError(`Authentication error: ${response.status} ${response.statusText}`, response.status, errorText);
+            }
+            // Handle rate limiting
+            if (response.status === 429) {
+                const retryAfter = response.headers.get('retry-after');
+                const delayMs = retryAfter
+                    ? parseInt(retryAfter, 10) * 1000
+                    : backoffMs * Math.pow(2, attempt);
+                if (attempt < maxRetries - 1) {
+                    await sleep(delayMs);
+                    continue;
+                }
+            }
+            // Retry on server errors
+            if (response.status >= 500 && response.status < 600) {
+                if (attempt < maxRetries - 1) {
+                    await sleep(backoffMs * Math.pow(2, attempt));
+                    continue;
+                }
+                const errorText = await response.text();
+                throw new FetchRetryError(`Server error: ${response.status} ${response.statusText}`, response.status, errorText);
+            }
+            // Return response for success or client errors (let caller handle)
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeout);
+            // Don't retry abort errors (timeout) on last attempt
+            if (error instanceof Error && error.name === 'AbortError') {
+                lastError = new FetchRetryError('Request timed out');
+                if (attempt < maxRetries - 1) {
+                    await sleep(backoffMs * Math.pow(2, attempt));
+                    continue;
+                }
+                throw lastError;
+            }
+            // Re-throw FetchRetryError (auth errors, etc.)
+            if (error instanceof FetchRetryError) {
+                throw error;
+            }
+            // Network errors - retry
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < maxRetries - 1) {
+                await sleep(backoffMs * Math.pow(2, attempt));
+                continue;
+            }
+        }
+    }
+    throw lastError || new FetchRetryError('Max retries exceeded');
+}
+/**
+ * Parse JSON response with error handling
+ */
+export async function parseJsonResponse(response) {
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new FetchRetryError(`HTTP error: ${response.status} ${response.statusText}`, response.status, errorText);
+    }
+    return response.json();
+}
+//# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchWithRetry, parseJsonResponse, sleep, FetchRetryError, type FetchWithRetryOptions, } from './http.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,EACL,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export { fetchWithRetry, parseJsonResponse, sleep, FetchRetryError, } from './http.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,EACL,eAAe,GAEhB,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jam-nodes/nodes",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Built-in workflow nodes for jam-nodes framework",
   "type": "module",
   "main": "./dist/index.js",