es-toolkit 1.10.1-dev.251 → 1.10.1-dev.252

package/dist/promise/timeout.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns a promise that rejects with a `TimeoutError` after a specified delay.
+ *
+ * @param {number} ms - The delay duration in milliseconds.
+ * @returns {Promise<void>} A promise that rejects with a `TimeoutError` after the specified delay.
+ * @throws {TimeoutError} Throws a `TimeoutError` after the specified delay.
+ */
+declare function timeout(ms: number): Promise<never>;
+
+export { timeout };

package/dist/promise/timeout.js

@@ -0,0 +1,92 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/promise/timeout.ts
+var timeout_exports = {};
+__export(timeout_exports, {
+  timeout: () => timeout
+});
+module.exports = __toCommonJS(timeout_exports);
+
+// src/error/AbortError.ts
+var AbortError = class extends Error {
+  constructor(message = "The operation was aborted") {
+    super(message);
+    this.name = "AbortError";
+  }
+};
+
+// src/promise/delay.ts
+function delay(ms, { signal } = {}) {
+  return new Promise((resolve, reject) => {
+    const abortError = () => {
+      reject(new AbortError());
+    };
+    const abortHandler = () => {
+      clearTimeout(timeoutId);
+      abortError();
+    };
+    if (signal == null ? void 0 : signal.aborted) {
+      return abortError();
+    }
+    const timeoutId = setTimeout(resolve, ms);
+    signal == null ? void 0 : signal.addEventListener("abort", abortHandler, { once: true });
+  });
+}
+
+// src/error/TimeoutError.ts
+var TimeoutError = class extends Error {
+  constructor(message = "The operation was timed out") {
+    super(message);
+    this.name = "TimeoutError";
+  }
+};
+
+// src/promise/timeout.ts
+function timeout(ms) {
+  return __async(this, null, function* () {
+    yield delay(ms);
+    throw new TimeoutError();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  timeout
+});
+//# sourceMappingURL=timeout.js.map

package/dist/promise/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/promise/timeout.ts","../../src/error/AbortError.ts","../../src/promise/delay.ts","../../src/error/TimeoutError.ts"],"sourcesContent":["import { delay } from './delay.ts';\nimport { TimeoutError } from '../error/TimeoutError.ts';\n\n/**\n * Returns a promise that rejects with a `TimeoutError` after a specified delay.\n *\n * @param {number} ms - The delay duration in milliseconds.\n * @returns {Promise<void>} A promise that rejects with a `TimeoutError` after the specified delay.\n * @throws {TimeoutError} Throws a `TimeoutError` after the specified delay.\n */\nexport async function timeout(ms: number): Promise<never> {\n  await delay(ms);\n  throw new TimeoutError();\n}\n","/**\n * An error class representing an aborted operation.\n * @augments Error\n */\nexport class AbortError extends Error {\n  constructor(message = 'The operation was aborted') {\n    super(message);\n    this.name = 'AbortError';\n  }\n}\n","import { AbortError } from '../error/AbortError.ts';\n\ninterface DelayOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Delays the execution of code for a specified number of milliseconds.\n *\n * This function returns a Promise that resolves after the specified delay, allowing you to use it\n * with async/await to pause execution.\n *\n * @param {number} ms - The number of milliseconds to delay.\n * @param {DelayOptions} options - The options object.\n * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the delay.\n * @returns {Promise<void>} A Promise that resolves after the specified delay.\n *\n * @example\n * async function foo() {\n *   console.log('Start');\n *   await delay(1000); // Delays execution for 1 second\n *   console.log('End');\n * }\n *\n * foo();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const { signal } = controller;\n *\n * setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms\n * try {\n *   await delay(100, { signal });\n *  } catch (error) {\n *   console.error(error); // Will log 'AbortError'\n *  }\n * }\n */\nexport function delay(ms: number, { signal }: DelayOptions = {}): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const abortError = () => {\n      reject(new AbortError());\n    };\n\n    const abortHandler = () => {\n      clearTimeout(timeoutId);\n      abortError();\n    };\n\n    if (signal?.aborted) {\n      return abortError();\n    }\n\n    const timeoutId = setTimeout(resolve, ms);\n\n    signal?.addEventListener('abort', abortHandler, { once: true });\n  });\n}\n","/**\n * An error class representing an timeout operation.\n * @augments Error\n */\nexport class TimeoutError extends Error {\n  constructor(message = 'The operation was timed out') {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YAAY,UAAU,6BAA6B;AACjD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;;AC6BO,SAAS,MAAM,IAAY,EAAE,OAAO,IAAkB,CAAC,GAAkB;AAC9E,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,aAAa,MAAM;AACvB,aAAO,IAAI,WAAW,CAAC;AAAA,IACzB;AAEA,UAAM,eAAe,MAAM;AACzB,mBAAa,SAAS;AACtB,iBAAW;AAAA,IACb;AAEA,QAAI,iCAAQ,SAAS;AACnB,aAAO,WAAW;AAAA,IACpB;AAEA,UAAM,YAAY,WAAW,SAAS,EAAE;AAExC,qCAAQ,iBAAiB,SAAS,cAAc,EAAE,MAAM,KAAK;AAAA,EAC/D,CAAC;AACH;;;ACrDO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YAAY,UAAU,+BAA+B;AACnD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;;AHCA,SAAsB,QAAQ,IAA4B;AAAA;AACxD,UAAM,MAAM,EAAE;AACd,UAAM,IAAI,aAAa;AAAA,EACzB;AAAA;","names":[]}

package/dist/promise/timeout.mjs

@@ -0,0 +1,11 @@
+import {
+  timeout
+} from "../chunk-J3GE7DEU.mjs";
+import "../chunk-O64NE2P4.mjs";
+import "../chunk-DXB7EZUQ.mjs";
+import "../chunk-KIOYQRMQ.mjs";
+import "../chunk-424M7IR7.mjs";
+export {
+  timeout
+};
+//# sourceMappingURL=timeout.mjs.map

package/dist/promise/timeout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/promise/withTimeout.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Executes an async function and enforces a timeout.
+ *
+ * If the promise does not resolve within the specified time,
+ * the timeout will trigger and the returned promise will be rejected.
+ *
+ *
+ * @template T
+ * @param {() => Promise<T>} run - A function that returns a promise to be executed.
+ * @param {number} ms - The timeout duration in milliseconds.
+ * @returns {Promise<T>} A promise that resolves with the result of the `run` function or rejects if the timeout is reached.
+ *
+ * @example
+ * try {
+ *   await withTimeout(() => {}, 1000); // Timeout exception after 1 second
+ * } catch (error) {
+ *   console.error(error); // Will log 'TimeoutError'
+ * }
+ */
+declare function withTimeout<T>(run: () => Promise<T>, ms: number): Promise<T>;
+
+export { withTimeout };

package/dist/promise/withTimeout.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Executes an async function and enforces a timeout.
+ *
+ * If the promise does not resolve within the specified time,
+ * the timeout will trigger and the returned promise will be rejected.
+ *
+ *
+ * @template T
+ * @param {() => Promise<T>} run - A function that returns a promise to be executed.
+ * @param {number} ms - The timeout duration in milliseconds.
+ * @returns {Promise<T>} A promise that resolves with the result of the `run` function or rejects if the timeout is reached.
+ *
+ * @example
+ * try {
+ *   await withTimeout(() => {}, 1000); // Timeout exception after 1 second
+ * } catch (error) {
+ *   console.error(error); // Will log 'TimeoutError'
+ * }
+ */
+declare function withTimeout<T>(run: () => Promise<T>, ms: number): Promise<T>;
+
+export { withTimeout };

package/dist/promise/withTimeout.js

@@ -0,0 +1,99 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/promise/withTimeout.ts
+var withTimeout_exports = {};
+__export(withTimeout_exports, {
+  withTimeout: () => withTimeout
+});
+module.exports = __toCommonJS(withTimeout_exports);
+
+// src/error/AbortError.ts
+var AbortError = class extends Error {
+  constructor(message = "The operation was aborted") {
+    super(message);
+    this.name = "AbortError";
+  }
+};
+
+// src/promise/delay.ts
+function delay(ms, { signal } = {}) {
+  return new Promise((resolve, reject) => {
+    const abortError = () => {
+      reject(new AbortError());
+    };
+    const abortHandler = () => {
+      clearTimeout(timeoutId);
+      abortError();
+    };
+    if (signal == null ? void 0 : signal.aborted) {
+      return abortError();
+    }
+    const timeoutId = setTimeout(resolve, ms);
+    signal == null ? void 0 : signal.addEventListener("abort", abortHandler, { once: true });
+  });
+}
+
+// src/error/TimeoutError.ts
+var TimeoutError = class extends Error {
+  constructor(message = "The operation was timed out") {
+    super(message);
+    this.name = "TimeoutError";
+  }
+};
+
+// src/promise/timeout.ts
+function timeout(ms) {
+  return __async(this, null, function* () {
+    yield delay(ms);
+    throw new TimeoutError();
+  });
+}
+
+// src/promise/withTimeout.ts
+function withTimeout(run, ms) {
+  return __async(this, null, function* () {
+    return Promise.race([run(), timeout(ms)]);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  withTimeout
+});
+//# sourceMappingURL=withTimeout.js.map

package/dist/promise/withTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/promise/withTimeout.ts","../../src/error/AbortError.ts","../../src/promise/delay.ts","../../src/error/TimeoutError.ts","../../src/promise/timeout.ts"],"sourcesContent":["import { timeout } from './timeout.ts';\n\n/**\n * Executes an async function and enforces a timeout. \n * \n * If the promise does not resolve within the specified time,\n * the timeout will trigger and the returned promise will be rejected.\n *\n *\n * @template T \n * @param {() => Promise<T>} run - A function that returns a promise to be executed.\n * @param {number} ms - The timeout duration in milliseconds.\n * @returns {Promise<T>} A promise that resolves with the result of the `run` function or rejects if the timeout is reached.\n *\n * @example\n * try {\n *   await withTimeout(() => {}, 1000); // Timeout exception after 1 second\n * } catch (error) {\n *   console.error(error); // Will log 'TimeoutError'\n * }\n */\nexport async function withTimeout<T>(run: () => Promise<T>, ms: number): Promise<T> {\n  return Promise.race([run(), timeout(ms) as T]);\n}\n","/**\n * An error class representing an aborted operation.\n * @augments Error\n */\nexport class AbortError extends Error {\n  constructor(message = 'The operation was aborted') {\n    super(message);\n    this.name = 'AbortError';\n  }\n}\n","import { AbortError } from '../error/AbortError.ts';\n\ninterface DelayOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Delays the execution of code for a specified number of milliseconds.\n *\n * This function returns a Promise that resolves after the specified delay, allowing you to use it\n * with async/await to pause execution.\n *\n * @param {number} ms - The number of milliseconds to delay.\n * @param {DelayOptions} options - The options object.\n * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the delay.\n * @returns {Promise<void>} A Promise that resolves after the specified delay.\n *\n * @example\n * async function foo() {\n *   console.log('Start');\n *   await delay(1000); // Delays execution for 1 second\n *   console.log('End');\n * }\n *\n * foo();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const { signal } = controller;\n *\n * setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms\n * try {\n *   await delay(100, { signal });\n *  } catch (error) {\n *   console.error(error); // Will log 'AbortError'\n *  }\n * }\n */\nexport function delay(ms: number, { signal }: DelayOptions = {}): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const abortError = () => {\n      reject(new AbortError());\n    };\n\n    const abortHandler = () => {\n      clearTimeout(timeoutId);\n      abortError();\n    };\n\n    if (signal?.aborted) {\n      return abortError();\n    }\n\n    const timeoutId = setTimeout(resolve, ms);\n\n    signal?.addEventListener('abort', abortHandler, { once: true });\n  });\n}\n","/**\n * An error class representing an timeout operation.\n * @augments Error\n */\nexport class TimeoutError extends Error {\n  constructor(message = 'The operation was timed out') {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n","import { delay } from './delay.ts';\nimport { TimeoutError } from '../error/TimeoutError.ts';\n\n/**\n * Returns a promise that rejects with a `TimeoutError` after a specified delay.\n *\n * @param {number} ms - The delay duration in milliseconds.\n * @returns {Promise<void>} A promise that rejects with a `TimeoutError` after the specified delay.\n * @throws {TimeoutError} Throws a `TimeoutError` after the specified delay.\n */\nexport async function timeout(ms: number): Promise<never> {\n  await delay(ms);\n  throw new TimeoutError();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YAAY,UAAU,6BAA6B;AACjD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;;AC6BO,SAAS,MAAM,IAAY,EAAE,OAAO,IAAkB,CAAC,GAAkB;AAC9E,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,aAAa,MAAM;AACvB,aAAO,IAAI,WAAW,CAAC;AAAA,IACzB;AAEA,UAAM,eAAe,MAAM;AACzB,mBAAa,SAAS;AACtB,iBAAW;AAAA,IACb;AAEA,QAAI,iCAAQ,SAAS;AACnB,aAAO,WAAW;AAAA,IACpB;AAEA,UAAM,YAAY,WAAW,SAAS,EAAE;AAExC,qCAAQ,iBAAiB,SAAS,cAAc,EAAE,MAAM,KAAK;AAAA,EAC/D,CAAC;AACH;;;ACrDO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YAAY,UAAU,+BAA+B;AACnD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;;ACCA,SAAsB,QAAQ,IAA4B;AAAA;AACxD,UAAM,MAAM,EAAE;AACd,UAAM,IAAI,aAAa;AAAA,EACzB;AAAA;;;AJQA,SAAsB,YAAe,KAAuB,IAAwB;AAAA;AAClF,WAAO,QAAQ,KAAK,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAM,CAAC;AAAA,EAC/C;AAAA;","names":[]}

package/dist/promise/withTimeout.mjs

@@ -0,0 +1,12 @@
+import {
+  withTimeout
+} from "../chunk-XWPCDIFC.mjs";
+import "../chunk-J3GE7DEU.mjs";
+import "../chunk-O64NE2P4.mjs";
+import "../chunk-DXB7EZUQ.mjs";
+import "../chunk-KIOYQRMQ.mjs";
+import "../chunk-424M7IR7.mjs";
+export {
+  withTimeout
+};
+//# sourceMappingURL=withTimeout.mjs.map

package/dist/promise/withTimeout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/string/camelCase.mjs

@@ -3,7 +3,7 @@ import {
 } from "../chunk-Y5V7UAZZ.mjs";
 import "../chunk-U56ZOM7L.mjs";
 import "../chunk-WVQ7YVRK.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   camelCase
 };

package/dist/string/capitalize.mjs

@@ -1,7 +1,7 @@
 import {
   capitalize
 } from "../chunk-U56ZOM7L.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   capitalize
 };

package/dist/string/index.mjs

@@ -1,13 +1,4 @@
 import "../chunk-XT74R35S.mjs";
-import {
-  camelCase
-} from "../chunk-Y5V7UAZZ.mjs";
-import {
-  capitalize
-} from "../chunk-U56ZOM7L.mjs";
-import {
-  kebabCase
-} from "../chunk-EYYZQFOP.mjs";
 import {
   lowerCase
 } from "../chunk-5IKVJGHO.mjs";
@@ -17,8 +8,17 @@ import {
 import {
   startCase
 } from "../chunk-QXTNZR7B.mjs";
+import {
+  camelCase
+} from "../chunk-Y5V7UAZZ.mjs";
+import {
+  capitalize
+} from "../chunk-U56ZOM7L.mjs";
+import {
+  kebabCase
+} from "../chunk-EYYZQFOP.mjs";
 import "../chunk-WVQ7YVRK.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   camelCase,
   capitalize,

package/dist/string/kebabCase.mjs

@@ -2,7 +2,7 @@ import {
   kebabCase
 } from "../chunk-EYYZQFOP.mjs";
 import "../chunk-WVQ7YVRK.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   kebabCase
 };

package/dist/string/lowerCase.mjs

@@ -2,7 +2,7 @@ import {
   lowerCase
 } from "../chunk-5IKVJGHO.mjs";
 import "../chunk-WVQ7YVRK.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   lowerCase
 };

package/dist/string/snakeCase.mjs

@@ -2,7 +2,7 @@ import {
   snakeCase
 } from "../chunk-F3WCQQET.mjs";
 import "../chunk-WVQ7YVRK.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   snakeCase
 };

package/dist/string/startCase.mjs

@@ -2,7 +2,7 @@ import {
   startCase
 } from "../chunk-QXTNZR7B.mjs";
 import "../chunk-WVQ7YVRK.mjs";
-import "../chunk-2MM5EJJX.mjs";
+import "../chunk-424M7IR7.mjs";
 export {
   startCase
 };

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.10.1-dev.251+2db0b495",
+  "version": "1.10.1-dev.252+b31b3a69",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

package/dist/chunk-ARZ5BDR6.mjs

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-ARZ5BDR6.mjs.map

package/dist/chunk-FZEZH22H.mjs

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-FZEZH22H.mjs.map