@wix/builder-utils 1.21.4 → 1.21.5

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/withRetry.d.ts

@@ -0,0 +1,10 @@
+export interface RetryOptions {
+    maxRetries: number;
+    getDelay: (attempt: number) => number;
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+}
+export declare const retryStrategies: {
+    exponentialJitter: (initialDelayMs: number) => (attempt: number) => number;
+};
+export declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;

package/dist/withRetry.js

@@ -0,0 +1,31 @@
+export const retryStrategies = {
+    exponentialJitter: (initialDelayMs) => (attempt) => {
+        const base = initialDelayMs * Math.pow(2, attempt);
+        return base * (0.5 + Math.random() * 0.5);
+    },
+};
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+export async function withRetry(fn, options) {
+    const { maxRetries, getDelay, shouldRetry = () => true, onRetry } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn(); // eslint-disable-line no-await-in-loop
+        }
+        catch (error) {
+            lastError = toError(error);
+            if (attempt < maxRetries && shouldRetry(lastError, attempt)) {
+                const delayMs = getDelay(attempt);
+                onRetry?.(lastError, attempt, delayMs);
+                await new Promise(resolve => setTimeout(resolve, delayMs)); // eslint-disable-line no-await-in-loop
+            }
+            else {
+                break;
+            }
+        }
+    }
+    throw lastError ?? new Error(`Operation failed after ${maxRetries} retries`);
+}
+//# sourceMappingURL=withRetry.js.map

package/dist/withRetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withRetry.js","sourceRoot":"","sources":["../src/withRetry.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,iBAAiB,EACb,CAAC,cAAsB,EAAE,EAAE,CAC3B,CAAC,OAAe,EAAU,EAAE;QACxB,MAAM,IAAI,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QAClD,OAAO,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAA;IAC7C,CAAC;CACR,CAAA;AAED,SAAS,OAAO,CAAC,KAAc;IAC3B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,OAAqB;IAC1E,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAE3E,IAAI,SAA4B,CAAA;IAEhC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAA,CAAC,uCAAuC;QAC7D,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;YAE1B,IAAI,OAAO,GAAG,UAAU,IAAI,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;gBACjC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;gBACtC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA,CAAC,uCAAuC;YACtG,CAAC;iBAAM,CAAC;gBACJ,MAAK;YACT,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,0BAA0B,UAAU,UAAU,CAAC,CAAA;AAChF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/builder-utils",
-  "version": "1.21.4",
+  "version": "1.21.5",
   "description": "Builder utilities for merging props with custom logic",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -58,5 +58,5 @@
     }
   },
   "module": "dist/bundles/es/builder-utils.mjs",
-  "falconPackageHash": "9ee004c6c9f801cc21b723919ecee7460708c1c43925271b924e372f"
+  "falconPackageHash": "783f0d1272c4a4c59a677cdae00429b0d5385f72797e577c19a69f9e"
 }

package/src/index.ts

@@ -1,3 +1,5 @@
 export { mergeProps, removeElementProps } from './mergeUtils'
 export { getSignalValueDeep } from './signalUtils'
+export { withRetry, retryStrategies } from './withRetry'
+export type { RetryOptions } from './withRetry'
 export { routeToDynamicPage } from './routerUtils'

package/src/withRetry.ts

@@ -0,0 +1,43 @@
+export interface RetryOptions {
+    maxRetries: number
+    getDelay: (attempt: number) => number
+    shouldRetry?: (error: Error, attempt: number) => boolean
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void
+}
+
+export const retryStrategies = {
+    exponentialJitter:
+        (initialDelayMs: number) =>
+        (attempt: number): number => {
+            const base = initialDelayMs * Math.pow(2, attempt)
+            return base * (0.5 + Math.random() * 0.5)
+        },
+}
+
+function toError(error: unknown): Error {
+    return error instanceof Error ? error : new Error(String(error))
+}
+
+export async function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T> {
+    const { maxRetries, getDelay, shouldRetry = () => true, onRetry } = options
+
+    let lastError: Error | undefined
+
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn() // eslint-disable-line no-await-in-loop
+        } catch (error: unknown) {
+            lastError = toError(error)
+
+            if (attempt < maxRetries && shouldRetry(lastError, attempt)) {
+                const delayMs = getDelay(attempt)
+                onRetry?.(lastError, attempt, delayMs)
+                await new Promise(resolve => setTimeout(resolve, delayMs)) // eslint-disable-line no-await-in-loop
+            } else {
+                break
+            }
+        }
+    }
+
+    throw lastError ?? new Error(`Operation failed after ${maxRetries} retries`)
+}