es-toolkit 1.50.0-dev.2058 → 1.50.0-dev.2060

package/dist/function/rest.js

@@ -24,7 +24,7 @@
 *
 * // Using start index 1
 * const transformedFnWithStart = rest(fn, 1);
-* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
 *
 * // With fewer arguments than the start index
 * console.log(transformedFn(1)); // [1, undefined, []]

package/dist/function/rest.mjs

@@ -24,7 +24,7 @@
 *
 * // Using start index 1
 * const transformedFnWithStart = rest(fn, 1);
-* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
 *
 * // With fewer arguments than the start index
 * console.log(transformedFn(1)); // [1, undefined, []]

package/dist/function/retry.d.mts

@@ -6,9 +6,9 @@ interface RetryOptions {
    *
    * @default 0
    * @example
-   * delay: (attempts) => attempt * 50
+   * delay: (attempts, error) => error.status === 429 ? 10000 : attempts * 50
    */
-  delay?: number | ((attempts: number) => number);
+  delay?: number | ((attempts: number, error: unknown) => number);
   /**
    * The number of retries to attempt.
    * @default Number.POSITIVE_INFINITY
@@ -62,7 +62,7 @@ declare function retry<T>(func: () => Promise<T>, retries: number): Promise<T>;
  * @template T
  * @param func - The function to retry. It should return a promise.
  * @param options - Options to configure the retry behavior.
- * @param [options.delay=0] - Delay(milliseconds) between retries.
+ * @param [options.delay=0] - Delay(milliseconds) between retries. A number or a function that receives the attempt number and the error object.
  * @param [options.retries=Infinity] - The number of retries to attempt.
  * @param [options.signal] - An AbortSignal to cancel the retry operation.
  * @param [options.shouldRetry] - A function that determines whether to retry.
@@ -77,7 +77,10 @@ declare function retry<T>(func: () => Promise<T>, retries: number): Promise<T>;
  * retry(() => fetchData(), { delay: 1000, retries: 5 });
  *
  * // Retry a function with a delay increasing linearly by 50ms per attempt
- * retry(() => fetchData(), { delay: (attempts) => attempt * 50, retries: 5 });
+ * retry(() => fetchData(), { delay: (attempts) => attempts * 50, retries: 5 });
+ *
+ * // Retry a function with an error-aware delay (e.g., respect Retry-After headers)
+ * retry(() => fetchData(), { delay: (_attempts, error) => error.status === 429 ? 10000 : 1000, retries: 3 });
  *
  * @example
  * // Retry a function with exponential backoff + jitter (max delay 10 seconds)

package/dist/function/retry.d.ts

@@ -6,9 +6,9 @@ interface RetryOptions {
    *
    * @default 0
    * @example
-   * delay: (attempts) => attempt * 50
+   * delay: (attempts, error) => error.status === 429 ? 10000 : attempts * 50
    */
-  delay?: number | ((attempts: number) => number);
+  delay?: number | ((attempts: number, error: unknown) => number);
   /**
    * The number of retries to attempt.
    * @default Number.POSITIVE_INFINITY
@@ -62,7 +62,7 @@ declare function retry<T>(func: () => Promise<T>, retries: number): Promise<T>;
  * @template T
  * @param func - The function to retry. It should return a promise.
  * @param options - Options to configure the retry behavior.
- * @param [options.delay=0] - Delay(milliseconds) between retries.
+ * @param [options.delay=0] - Delay(milliseconds) between retries. A number or a function that receives the attempt number and the error object.
  * @param [options.retries=Infinity] - The number of retries to attempt.
  * @param [options.signal] - An AbortSignal to cancel the retry operation.
  * @param [options.shouldRetry] - A function that determines whether to retry.
@@ -77,7 +77,10 @@ declare function retry<T>(func: () => Promise<T>, retries: number): Promise<T>;
  * retry(() => fetchData(), { delay: 1000, retries: 5 });
  *
  * // Retry a function with a delay increasing linearly by 50ms per attempt
- * retry(() => fetchData(), { delay: (attempts) => attempt * 50, retries: 5 });
+ * retry(() => fetchData(), { delay: (attempts) => attempts * 50, retries: 5 });
+ *
+ * // Retry a function with an error-aware delay (e.g., respect Retry-After headers)
+ * retry(() => fetchData(), { delay: (_attempts, error) => error.status === 429 ? 10000 : 1000, retries: 3 });
  *
  * @example
  * // Retry a function with exponential backoff + jitter (max delay 10 seconds)

package/dist/function/retry.js

@@ -36,7 +36,7 @@ async function retry(func, _options) {
 			error = err;
 			if (!shouldRetry(err, attempts)) throw err;
 			if (attempts < retries) {
-				const currentDelay = typeof delay$1 === "function" ? delay$1(attempts) : delay$1;
+				const currentDelay = typeof delay$1 === "function" ? delay$1(attempts, error) : delay$1;
 				await require_delay.delay(currentDelay);
 			}
 		}

package/dist/function/retry.mjs

@@ -35,7 +35,7 @@ async function retry(func, _options) {
 		} catch (err) {
 			error = err;
 			if (!shouldRetry(err, attempts)) throw err;
-			if (attempts < retries) await delay(typeof delay$1 === "function" ? delay$1(attempts) : delay$1);
+			if (attempts < retries) await delay(typeof delay$1 === "function" ? delay$1(attempts, error) : delay$1);
 		}
 	}
 	throw error;

package/dist/object/cloneDeepWith.d.mts

@@ -34,7 +34,9 @@
  * // Clone an array with a customizer
  * const arr = [1, 2, 3];
  * const clonedArr = cloneDeepWith(arr, (value) => {
- *   return value + 1; // Increment each value
+ *   if (typeof value === 'number') {
+ *     return value + 1; // Increment each number
+ *   }
  * });
  * console.log(clonedArr); // [2, 3, 4]
  * console.log(clonedArr === arr); // false

package/dist/object/cloneDeepWith.d.ts

@@ -34,7 +34,9 @@
  * // Clone an array with a customizer
  * const arr = [1, 2, 3];
  * const clonedArr = cloneDeepWith(arr, (value) => {
- *   return value + 1; // Increment each value
+ *   if (typeof value === 'number') {
+ *     return value + 1; // Increment each number
+ *   }
  * });
  * console.log(clonedArr); // [2, 3, 4]
  * console.log(clonedArr === arr); // false

package/dist/object/cloneDeepWith.js

@@ -40,7 +40,9 @@ const require_isBuffer = require("../predicate/isBuffer.js");
 * // Clone an array with a customizer
 * const arr = [1, 2, 3];
 * const clonedArr = cloneDeepWith(arr, (value) => {
-*   return value + 1; // Increment each value
+*   if (typeof value === 'number') {
+*     return value + 1; // Increment each number
+*   }
 * });
 * console.log(clonedArr); // [2, 3, 4]
 * console.log(clonedArr === arr); // false

package/dist/object/cloneDeepWith.mjs

@@ -40,7 +40,9 @@ import { isBuffer } from "../predicate/isBuffer.mjs";
 * // Clone an array with a customizer
 * const arr = [1, 2, 3];
 * const clonedArr = cloneDeepWith(arr, (value) => {
-*   return value + 1; // Increment each value
+*   if (typeof value === 'number') {
+*     return value + 1; // Increment each number
+*   }
 * });
 * console.log(clonedArr); // [2, 3, 4]
 * console.log(clonedArr === arr); // false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.50.0-dev.2058+3fdea04c",
+  "version": "1.50.0-dev.2060+2a37b36c",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",
@@ -218,7 +218,8 @@
   "workspaces": [
     "docs",
     "benchmarks",
-    "tests/types"
+    "tests/types",
+    "tests/browser-compat"
   ],
   "scripts": {
     "bench": "yarn workspace benchmarks bench",
@@ -250,6 +251,8 @@
     "broken-link-checker": "0.7.8",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-compat": "^7.0.2",
+    "eslint-plugin-es-x": "^10.0.0",
     "eslint-plugin-no-for-of-array": "^0.0.1",
     "eslint-plugin-prettier": "^5.2.1",
     "eslint-plugin-vue": "^9.28.0",