es-toolkit 1.31.0-dev.994 → 1.31.0-dev.995

package/dist/compat/index.d.mts

@@ -36,6 +36,7 @@ export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
+export { retry } from '../function/retry.mjs';
 export { ThrottledFunction } from '../function/throttle.mjs';
 export { unary } from '../function/unary.mjs';
 export { mean } from '../math/mean.mjs';

package/dist/compat/index.d.ts

@@ -36,6 +36,7 @@ export { noop } from '../function/noop.js';
 export { once } from '../function/once.js';
 export { partial } from '../function/partial.js';
 export { partialRight } from '../function/partialRight.js';
+export { retry } from '../function/retry.js';
 export { ThrottledFunction } from '../function/throttle.js';
 export { unary } from '../function/unary.js';
 export { mean } from '../math/mean.js';

package/dist/compat/index.js

@@ -3,8 +3,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const zipWith = require('../_chunk/zipWith-Bdyzuy.js');
+const AbortError = require('../_chunk/AbortError-Cg4ZQ1.js');
 const error_index = require('../error/index.js');
-const unary = require('../_chunk/unary-B6qG7C.js');
+const unary = require('../_chunk/unary-c1NFA5.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 const range$1 = require('../_chunk/range-HnEIT7.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
@@ -3103,7 +3104,7 @@ exports.xorBy = zipWith.xorBy;
 exports.xorWith = zipWith.xorWith;
 exports.zipObject = zipWith.zipObject;
 exports.zipWith = zipWith.zipWith;
-exports.AbortError = error_index.AbortError;
+exports.AbortError = AbortError.AbortError;
 exports.TimeoutError = error_index.TimeoutError;
 exports.asyncNoop = unary.asyncNoop;
 exports.identity = unary.identity;
@@ -3111,6 +3112,7 @@ exports.memoize = unary.memoize;
 exports.once = unary.once;
 exports.partial = unary.partial;
 exports.partialRight = unary.partialRight;
+exports.retry = unary.retry;
 exports.unary = unary.unary;
 exports.noop = noop.noop;
 exports.mean = range$1.mean;

package/dist/compat/index.mjs

@@ -36,6 +36,7 @@ export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
+export { retry } from '../function/retry.mjs';
 export { unary } from '../function/unary.mjs';
 export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';

package/dist/error/index.js

@@ -2,12 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-class AbortError extends Error {
-    constructor(message = 'The operation was aborted') {
-        super(message);
-        this.name = 'AbortError';
-    }
-}
+const AbortError = require('../_chunk/AbortError-Cg4ZQ1.js');
 
 class TimeoutError extends Error {
     constructor(message = 'The operation was timed out') {
@@ -16,5 +11,5 @@ class TimeoutError extends Error {
     }
 }
 
-exports.AbortError = AbortError;
+exports.AbortError = AbortError.AbortError;
 exports.TimeoutError = TimeoutError;

package/dist/function/index.d.mts

@@ -15,6 +15,7 @@ export { once } from './once.mjs';
 export { partial } from './partial.mjs';
 export { partialRight } from './partialRight.mjs';
 export { rest } from './rest.mjs';
+export { retry } from './retry.mjs';
 export { spread } from './spread.mjs';
 export { ThrottledFunction, throttle } from './throttle.mjs';
 export { unary } from './unary.mjs';

package/dist/function/index.d.ts

@@ -15,6 +15,7 @@ export { once } from './once.js';
 export { partial } from './partial.js';
 export { partialRight } from './partialRight.js';
 export { rest } from './rest.js';
+export { retry } from './retry.js';
 export { spread } from './spread.js';
 export { ThrottledFunction, throttle } from './throttle.js';
 export { unary } from './unary.js';

package/dist/function/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const unary = require('../_chunk/unary-B6qG7C.js');
+const unary = require('../_chunk/unary-c1NFA5.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 
 function before(n, func) {
@@ -98,6 +98,7 @@ exports.once = unary.once;
 exports.partial = unary.partial;
 exports.partialRight = unary.partialRight;
 exports.rest = unary.rest;
+exports.retry = unary.retry;
 exports.unary = unary.unary;
 exports.noop = noop.noop;
 exports.before = before;

package/dist/function/index.mjs

@@ -15,6 +15,7 @@ export { once } from './once.mjs';
 export { partial } from './partial.mjs';
 export { partialRight } from './partialRight.mjs';
 export { rest } from './rest.mjs';
+export { retry } from './retry.mjs';
 export { spread } from './spread.mjs';
 export { throttle } from './throttle.mjs';
 export { unary } from './unary.mjs';

package/dist/function/retry.d.mts

@@ -0,0 +1,59 @@
+interface RetryOptions {
+    /**
+     * The number of milliseconds to interval delay.
+     * @default 0
+     */
+    delay?: number;
+    /**
+     * The number of retries to attempt.
+     * @default Number.POSITIVE_INFINITY
+     */
+    retries?: number;
+    /**
+     * An AbortSignal to cancel the retry operation.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Retries a function that returns a promise until it resolves successfully.
+ *
+ * @template T
+ * @param {() => Promise<T>} func - The function to retry.
+ * @returns {Promise<T>} A promise that resolves with the value of the successful function call.
+ *
+ * @example
+ * // Basic usage with default retry options
+ * retry(() => fetchData()).then(data => console.log(data));
+ */
+declare function retry<T>(func: () => Promise<T>): Promise<T>;
+/**
+ * Retries a function that returns a promise a specified number of times.
+ *
+ * @template T
+ * @param {() => Promise<T>} func - The function to retry. It should return a promise.
+ * @param {number} retries - The number of retries to attempt. Default is Infinity.
+ * @returns {Promise<T>} A promise that resolves with the value of the successful function call.
+ *
+ * @example
+ * // Retry a function up to 3 times
+ * retry(() => fetchData(), 3).then(data => console.log(data));
+ */
+declare function retry<T>(func: () => Promise<T>, retries: number): Promise<T>;
+/**
+ * Retries a function that returns a promise with specified options.
+ *
+ * @template T
+ * @param {() => Promise<T>} func - The function to retry. It should return a promise.
+ * @param {RetryOptions} options - Options to configure the retry behavior.
+ * @param {number} [options.delay=0] - The number of milliseconds to wait between retries.
+ * @param {number} [options.retries=Infinity] - The number of retries to attempt.
+ * @param {AbortSignal} [options.signal] - An AbortSignal to cancel the retry operation.
+ * @returns {Promise<T>} A promise that resolves with the value of the successful function call.
+ *
+ * @example
+ * // Retry a function with a delay of 1000ms between attempts
+ * retry(() => fetchData(), { delay: 1000, times: 5 }).then(data => console.log(data));
+ */
+declare function retry<T>(func: () => Promise<T>, options: RetryOptions): Promise<T>;
+
+export { retry };

package/dist/function/retry.d.ts

@@ -0,0 +1,59 @@
+interface RetryOptions {
+    /**
+     * The number of milliseconds to interval delay.
+     * @default 0
+     */
+    delay?: number;
+    /**
+     * The number of retries to attempt.
+     * @default Number.POSITIVE_INFINITY
+     */
+    retries?: number;
+    /**
+     * An AbortSignal to cancel the retry operation.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Retries a function that returns a promise until it resolves successfully.
+ *
+ * @template T
+ * @param {() => Promise<T>} func - The function to retry.
+ * @returns {Promise<T>} A promise that resolves with the value of the successful function call.
+ *
+ * @example
+ * // Basic usage with default retry options
+ * retry(() => fetchData()).then(data => console.log(data));
+ */
+declare function retry<T>(func: () => Promise<T>): Promise<T>;
+/**
+ * Retries a function that returns a promise a specified number of times.
+ *
+ * @template T
+ * @param {() => Promise<T>} func - The function to retry. It should return a promise.
+ * @param {number} retries - The number of retries to attempt. Default is Infinity.
+ * @returns {Promise<T>} A promise that resolves with the value of the successful function call.
+ *
+ * @example
+ * // Retry a function up to 3 times
+ * retry(() => fetchData(), 3).then(data => console.log(data));
+ */
+declare function retry<T>(func: () => Promise<T>, retries: number): Promise<T>;
+/**
+ * Retries a function that returns a promise with specified options.
+ *
+ * @template T
+ * @param {() => Promise<T>} func - The function to retry. It should return a promise.
+ * @param {RetryOptions} options - Options to configure the retry behavior.
+ * @param {number} [options.delay=0] - The number of milliseconds to wait between retries.
+ * @param {number} [options.retries=Infinity] - The number of retries to attempt.
+ * @param {AbortSignal} [options.signal] - An AbortSignal to cancel the retry operation.
+ * @returns {Promise<T>} A promise that resolves with the value of the successful function call.
+ *
+ * @example
+ * // Retry a function with a delay of 1000ms between attempts
+ * retry(() => fetchData(), { delay: 1000, times: 5 }).then(data => console.log(data));
+ */
+declare function retry<T>(func: () => Promise<T>, options: RetryOptions): Promise<T>;
+
+export { retry };

package/dist/function/retry.mjs

@@ -0,0 +1,35 @@
+import { delay } from '../promise/delay.mjs';
+
+const DEFAULT_DELAY = 0;
+const DEFAULT_RETRIES = Number.POSITIVE_INFINITY;
+async function retry(func, _options) {
+    let delay$1;
+    let retries;
+    let signal;
+    if (typeof _options === 'number') {
+        delay$1 = DEFAULT_DELAY;
+        retries = _options;
+        signal = undefined;
+    }
+    else {
+        delay$1 = _options?.delay ?? DEFAULT_DELAY;
+        retries = _options?.retries ?? DEFAULT_RETRIES;
+        signal = _options?.signal;
+    }
+    let error;
+    for (let i = 0; i < retries; i++) {
+        if (signal?.aborted) {
+            throw error ?? new Error(`The retry operation was aborted due to an abort signal.`);
+        }
+        try {
+            return await func();
+        }
+        catch (err) {
+            error = err;
+            await delay(delay$1);
+        }
+    }
+    throw error;
+}
+
+export { retry };

package/dist/index.d.mts

@@ -77,6 +77,7 @@ export { once } from './function/once.mjs';
 export { partial } from './function/partial.mjs';
 export { partialRight } from './function/partialRight.mjs';
 export { rest } from './function/rest.mjs';
+export { retry } from './function/retry.mjs';
 export { spread } from './function/spread.mjs';
 export { ThrottledFunction, throttle } from './function/throttle.mjs';
 export { unary } from './function/unary.mjs';

package/dist/index.d.ts

@@ -77,6 +77,7 @@ export { once } from './function/once.js';
 export { partial } from './function/partial.js';
 export { partialRight } from './function/partialRight.js';
 export { rest } from './function/rest.js';
+export { retry } from './function/retry.js';
 export { spread } from './function/spread.js';
 export { ThrottledFunction, throttle } from './function/throttle.js';
 export { unary } from './function/unary.js';

package/dist/index.js

@@ -4,8 +4,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const zipWith = require('./_chunk/zipWith-Bdyzuy.js');
 const array_index = require('./array/index.js');
+const AbortError = require('./_chunk/AbortError-Cg4ZQ1.js');
 const error_index = require('./error/index.js');
-const unary = require('./_chunk/unary-B6qG7C.js');
+const unary = require('./_chunk/unary-c1NFA5.js');
 const function_index = require('./function/index.js');
 const noop = require('./_chunk/noop-2IwLUk.js');
 const range = require('./_chunk/range-HnEIT7.js');
@@ -16,6 +17,7 @@ const object_index = require('./object/index.js');
 const isWeakSet = require('./_chunk/isWeakSet-CvIdTA.js');
 const predicate_index = require('./predicate/index.js');
 const isPlainObject = require('./_chunk/isPlainObject-octpoD.js');
+const delay = require('./_chunk/delay-_VMfFa.js');
 const promise_index = require('./promise/index.js');
 const upperFirst = require('./_chunk/upperFirst-CorAVn.js');
 const string_index = require('./string/index.js');
@@ -83,7 +85,7 @@ exports.zipWith = zipWith.zipWith;
 exports.orderBy = array_index.orderBy;
 exports.sortBy = array_index.sortBy;
 exports.takeRightWhile = array_index.takeRightWhile;
-exports.AbortError = error_index.AbortError;
+exports.AbortError = AbortError.AbortError;
 exports.TimeoutError = error_index.TimeoutError;
 exports.after = unary.after;
 exports.ary = unary.ary;
@@ -98,6 +100,7 @@ exports.once = unary.once;
 exports.partial = unary.partial;
 exports.partialRight = unary.partialRight;
 exports.rest = unary.rest;
+exports.retry = unary.retry;
 exports.unary = unary.unary;
 exports.before = function_index.before;
 exports.curry = function_index.curry;
@@ -161,7 +164,7 @@ exports.isSymbol = predicate_index.isSymbol;
 exports.isPlainObject = isPlainObject.isPlainObject;
 exports.isPrimitive = isPlainObject.isPrimitive;
 exports.isTypedArray = isPlainObject.isTypedArray;
-exports.delay = promise_index.delay;
+exports.delay = delay.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
 exports.camelCase = upperFirst.camelCase;

package/dist/index.mjs

@@ -77,6 +77,7 @@ export { once } from './function/once.mjs';
 export { partial } from './function/partial.mjs';
 export { partialRight } from './function/partialRight.mjs';
 export { rest } from './function/rest.mjs';
+export { retry } from './function/retry.mjs';
 export { spread } from './function/spread.mjs';
 export { throttle } from './function/throttle.mjs';
 export { unary } from './function/unary.mjs';

package/dist/promise/index.js

@@ -2,30 +2,11 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
+const delay = require('../_chunk/delay-_VMfFa.js');
 const error_index = require('../error/index.js');
 
-function delay(ms, { signal } = {}) {
-    return new Promise((resolve, reject) => {
-        const abortError = () => {
-            reject(new error_index.AbortError());
-        };
-        const abortHandler = () => {
-            clearTimeout(timeoutId);
-            abortError();
-        };
-        if (signal?.aborted) {
-            return abortError();
-        }
-        const timeoutId = setTimeout(() => {
-            signal?.removeEventListener('abort', abortHandler);
-            resolve();
-        }, ms);
-        signal?.addEventListener('abort', abortHandler, { once: true });
-    });
-}
-
 async function timeout(ms) {
-    await delay(ms);
+    await delay.delay(ms);
     throw new error_index.TimeoutError();
 }
 
@@ -33,6 +14,6 @@ async function withTimeout(run, ms) {
     return Promise.race([run(), timeout(ms)]);
 }
 
-exports.delay = delay;
+exports.delay = delay.delay;
 exports.timeout = timeout;
 exports.withTimeout = withTimeout;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.31.0-dev.994+14843eed",
+  "version": "1.31.0-dev.995+06bdc0fc",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {