@hyperfrontend/time-utils 0.0.3 → 0.0.5

package/bundle/index.umd.js

@@ -7,22 +7,36 @@
     /**
      * Safe copies of Date built-in via factory function and static methods.
      *
-     * Since constructors cannot be safely captured via Object.assign, this module
-     * provides a factory function that uses Reflect.construct internally.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
-     *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/date
      */
-    // Capture references at module initialization time
+    /* eslint-disable jsdoc/require-param */
     const _Date = globalThis.Date;
     const _Reflect$2 = globalThis.Reflect;
+    /**
+     * (Safe copy) Creates a new Date using the captured Date constructor.
+     * Use this instead of `new Date()`. Accepts all standard Date constructor signatures.
+     *
+     * @returns A new Date instance.
+     *
+     * @example Creating Date instances
+     * ```typescript
+     * const now = createDate()
+     * const fromTimestamp = createDate(1704067200000)
+     * const fromString = createDate('2024-01-01T00:00:00Z')
+     * const fromParts = createDate(2024, 0, 1, 12, 30, 0) // Jan 1, 2024 12:30:00
+     * ```
+     */
     function createDate(...args) {
         return _Reflect$2.construct(_Date, args);
     }
     /**
      * (Safe copy) Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+     *
+     * @example
+     * ```typescript
+     * const timestamp = dateNow()
+     * // => 1704067200000 (example timestamp)
+     * ```
      */
     const dateNow = _Date.now;
 
@@ -34,7 +48,6 @@
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
      */
-    // Capture references at module initialization time
     const _Object = globalThis.Object;
     /**
      * (Safe copy) Prevents modification of existing property attributes and values,
@@ -50,7 +63,6 @@
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/timers
      */
-    // Capture references at module initialization time
     const _setTimeout = globalThis.setTimeout;
     const _setInterval = globalThis.setInterval;
     const _clearTimeout = globalThis.clearTimeout;
@@ -62,6 +74,13 @@
      * @param delay - Time in milliseconds before executing.
      * @param args - Additional arguments to pass to the callback.
      * @returns A numeric ID for the timer.
+     *
+     * @example Setting a timeout
+     * ```typescript
+     * const timerId = setTimeout(() => console.log('Executed'), 1000)
+     * // Pass arguments to callback
+     * setTimeout((name, count) => console.log(name, count), 500, 'items', 5)
+     * ```
      */
     const setTimeout = (callback, delay, ...args) => _setTimeout(callback, delay, ...args);
     /**
@@ -71,12 +90,27 @@
      * @param delay - Time in milliseconds between calls.
      * @param args - Additional arguments to pass to the callback.
      * @returns A numeric ID for the interval.
+     *
+     * @example Setting an interval
+     * ```typescript
+     * let count = 0
+     * const intervalId = setInterval(() => {
+     *   count++
+     *   if (count >= 5) clearInterval(intervalId)
+     * }, 1000)
+     * ```
      */
     const setInterval = (callback, delay, ...args) => _setInterval(callback, delay, ...args);
     /**
      * (Safe copy) Cancels a timeout previously established by setTimeout.
      *
      * @param id - The identifier of the timeout to cancel.
+     *
+     * @example Canceling a timeout
+     * ```typescript
+     * const timerId = setTimeout(() => console.log('Never runs'), 5000)
+     * clearTimeout(timerId)
+     * ```
      */
     const clearTimeout = (id) => {
         _clearTimeout(id);
@@ -85,6 +119,13 @@
      * (Safe copy) Cancels a timed, repeating action previously established by setInterval.
      *
      * @param id - The identifier of the interval to cancel.
+     *
+     * @example Canceling an interval
+     * ```typescript
+     * const intervalId = setInterval(() => console.log('tick'), 1000)
+     * // Stop after some condition
+     * clearInterval(intervalId)
+     * ```
      */
     const clearInterval = (id) => {
         _clearInterval(id);
@@ -99,6 +140,21 @@
      *
      * @param interval - Time in milliseconds between each callback invocation (default: 1000ms)
      * @returns A Clock instance with start, stop, subscribe, and unsubscribe methods
+     *
+     * @example Creating interval clock
+     * ```typescript
+     * const clock = createClock(1000)
+     *
+     * const updateDisplay = (currentTime: Date) => {
+     *   console.log(currentTime.toISOString())
+     * }
+     *
+     * clock.subscribe(updateDisplay)
+     * clock.start()
+     *
+     * // Later: stop receiving updates
+     * clock.stop()
+     * ```
      */
     function createClock(interval = 1000) {
         let clockId = null;
@@ -133,6 +189,24 @@
      * @param callback - The function to invoke after the delay
      * @param delay - Time in milliseconds to wait until callback is invoked
      * @returns A Timer instance with pause, resume, and reset methods
+     *
+     * @example Creating pausable timer
+     * ```typescript
+     * const timer = createTimer(() => {
+     *   console.log('Session expired')
+     * }, 30_000)
+     *
+     * timer.resume() // Start the 30-second countdown
+     *
+     * // User activity detected - pause the timer
+     * timer.pause()
+     *
+     * // User idle again - resume from where we left off
+     * timer.resume()
+     *
+     * // Reset to full 30 seconds on explicit action
+     * timer.reset()
+     * ```
      */
     function createTimer(callback, delay) {
         let timerId = null;
@@ -177,7 +251,6 @@
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
      */
-    // Capture references at module initialization time
     const _Error = globalThis.Error;
     const _Reflect$1 = globalThis.Reflect;
     /**
@@ -187,6 +260,13 @@
      * @param message - Optional error message.
      * @param options - Optional error options.
      * @returns A new Error instance.
+     *
+     * @example Creating Error instances
+     * ```typescript
+     * const error = createError('Operation failed')
+     * // With cause for error chaining
+     * const wrapped = createError('Request failed', { cause: originalError })
+     * ```
      */
     const createError = (message, options) => _Reflect$1.construct(_Error, [message, options]);
 
@@ -198,7 +278,6 @@
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/math
      */
-    // Capture references at module initialization time
     const _Math = globalThis.Math;
     /**
      * (Safe copy) Returns the largest integer less than or equal to a number.
@@ -213,11 +292,7 @@
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/number
      */
-    // Capture references at module initialization time
     const _isNaN = globalThis.isNaN;
-    // ============================================================================
-    // Global Type Checking (legacy, less strict)
-    // ============================================================================
     /**
      * (Safe copy) Global isNaN function (coerces to number first, less strict than Number.isNaN).
      */
@@ -229,6 +304,14 @@
      * @param time - The Date object to normalize to the nearest time window
      * @param baseTimeWindow - The size of the time window in minutes for normalization
      * @returns A new Date object normalized to the start of the time window
+     *
+     * @example Normalizing to 15-minute buckets
+     * ```typescript
+     * // Round timestamps to 15-minute intervals for analytics bucketing
+     * const eventTime = new Date('2024-03-15T14:23:45Z')
+     * const bucketTime = normalizeToBaseTimeWindow(eventTime, 15)
+     * // => 2024-03-15T14:15:00.000Z
+     * ```
      */
     function normalizeToBaseTimeWindow(time, baseTimeWindow) {
         if (!time || !(time instanceof Date) || globalIsNaN(time.getTime())) {
@@ -249,6 +332,16 @@
      * @param callback - The function to invoke at each interval
      * @param interval - Time in milliseconds between each callback invocation
      * @returns A cleanup function that stops the interval when called
+     *
+     * @example Setting interval with cleanup
+     * ```typescript
+     * const stopPolling = setIntervalCallback(() => {
+     *   fetchLatestData()
+     * }, 5000)
+     *
+     * // Later: clean up when component unmounts
+     * stopPolling()
+     * ```
      */
     function setIntervalCallback(callback, interval) {
         const timerId = setInterval(callback, interval);
@@ -256,17 +349,11 @@
     }
 
     /**
-     * Safe copies of Promise built-in methods via factory functions.
-     *
-     * Since constructors cannot be safely captured via Object.assign, this module
-     * provides factory functions that use Reflect.construct internally.
-     *
-     * These references are captured at module initialization time to protect against
-     * prototype pollution attacks. Import only what you need for tree-shaking.
+     * Safe Promise factory and bound static methods.
      *
      * @module @hyperfrontend/immutable-api-utils/built-in-copy/promise
      */
-    // Capture references at module initialization time
+    /* eslint-disable workspace/lib-require-jsdoc-example */
     const _Promise = globalThis.Promise;
     const _Reflect = globalThis.Reflect;
     /**
@@ -313,6 +400,15 @@
      *
      * @param milliseconds - The duration to sleep in milliseconds
      * @returns A promise that resolves after the specified duration
+     *
+     * @example Implementing retry backoff
+     * ```typescript
+     * async function retryWithBackoff(attempt: number) {
+     *   const backoffMs = Math.min(1000 * 2 ** attempt, 30_000)
+     *   await sleep(backoffMs)
+     *   return fetchResource()
+     * }
+     * ```
      */
     function sleep(milliseconds) {
         return createPromise((resolve) => setTimeout(resolve, milliseconds));
@@ -325,4 +421,3 @@
     exports.sleep = sleep;
 
 }));
-//# sourceMappingURL=index.umd.js.map

package/bundle/index.umd.min.js

@@ -1,2 +1 @@
 !function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).HyperfrontendTimeUtils={})}(this,function(e){"use strict";const t=globalThis.Date,l=globalThis.Reflect;function n(...e){return l.construct(t,e)}const i=t.now,o=globalThis.Object.freeze,s=globalThis.setTimeout,r=globalThis.setInterval,a=globalThis.clearTimeout,u=globalThis.clearInterval,c=(e,t,...l)=>s(e,t,...l),f=(e,t,...l)=>r(e,t,...l),b=e=>{u(e)};const T=globalThis.Error,h=globalThis.Reflect,d=(e,t)=>h.construct(T,[e,t]),g=globalThis.Math.floor,m=globalThis.isNaN;const p=globalThis.Promise,v=globalThis.Reflect;p.resolve.bind(p),p.reject.bind(p),p.all.bind(p),p.race.bind(p),p.allSettled.bind(p),p.any.bind(p),p.withResolvers?.bind(p),e.createClock=function(e=1e3){let t=null,l=[];return o({start:()=>{null===t&&(t=f(()=>{const e=n();l.forEach(t=>t(e))},e))},stop:()=>{null!==t&&(b(t),t=null)},subscribe:e=>{l.push(e)},unsubscribe:e=>{l=l.filter(t=>t!==e)},interval:e})},e.createTimer=function(e,t){let l=null,n=null,s=t;const r=()=>{if(null!==l){a(l);const e=i();null!==n&&(s-=e-n),l=null}},u=()=>{null===l&&(n=i(),l=c(()=>{e(),l=null},s))};return o({pause:r,resume:u,reset:(e=t)=>{r(),s=e,u()}})},e.normalizeToBaseTimeWindow=function(e,t){if(!e||!(e instanceof Date)||m(e.getTime()))throw d("Invalid time input");if(t<=0)throw d("Base time window must be positive");const l=e.getTime(),i=60*t*1e3;return n(g(l/i)*i)},e.setIntervalCallback=function(e,t){const l=f(e,t);return()=>b(l)},e.sleep=function(e){return t=t=>c(t,e),v.construct(p,[t]);var t}});
-//# sourceMappingURL=index.umd.min.js.map

package/index.cjs.js

@@ -1,90 +1,12 @@
 'use strict';
 
-/**
- * Safe copies of Date built-in via factory function and static methods.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides a factory function that uses Reflect.construct internally.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/date
- */
-// Capture references at module initialization time
-const _Date = globalThis.Date;
-const _Reflect$2 = globalThis.Reflect;
-function createDate(...args) {
-    return _Reflect$2.construct(_Date, args);
-}
-/**
- * (Safe copy) Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
- */
-const dateNow = _Date.now;
-
-/**
- * Safe copies of Object built-in methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
- */
-// Capture references at module initialization time
-const _Object = globalThis.Object;
-/**
- * (Safe copy) Prevents modification of existing property attributes and values,
- * and prevents the addition of new properties.
- */
-const freeze = _Object.freeze;
-
-/**
- * Safe copies of Timer/Scheduling built-in functions.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/timers
- */
-// Capture references at module initialization time
-const _setTimeout = globalThis.setTimeout;
-const _setInterval = globalThis.setInterval;
-const _clearTimeout = globalThis.clearTimeout;
-const _clearInterval = globalThis.clearInterval;
-/**
- * (Safe copy) Sets a timer which executes a function once the timer expires.
- *
- * @param callback - Function to call when the timer elapses.
- * @param delay - Time in milliseconds before executing.
- * @param args - Additional arguments to pass to the callback.
- * @returns A numeric ID for the timer.
- */
-const setTimeout = (callback, delay, ...args) => _setTimeout(callback, delay, ...args);
-/**
- * (Safe copy) Repeatedly calls a function with a fixed time delay between each call.
- *
- * @param callback - Function to call at each interval.
- * @param delay - Time in milliseconds between calls.
- * @param args - Additional arguments to pass to the callback.
- * @returns A numeric ID for the interval.
- */
-const setInterval = (callback, delay, ...args) => _setInterval(callback, delay, ...args);
-/**
- * (Safe copy) Cancels a timeout previously established by setTimeout.
- *
- * @param id - The identifier of the timeout to cancel.
- */
-const clearTimeout = (id) => {
-    _clearTimeout(id);
-};
-/**
- * (Safe copy) Cancels a timed, repeating action previously established by setInterval.
- *
- * @param id - The identifier of the interval to cancel.
- */
-const clearInterval = (id) => {
-    _clearInterval(id);
-};
+const index_cjs_js$2 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/date/index.cjs.js');
+const index_cjs_js = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.cjs.js');
+const index_cjs_js$1 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/timers/index.cjs.js');
+const index_cjs_js$4 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js');
+const index_cjs_js$5 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/math/index.cjs.js');
+const index_cjs_js$3 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/number/index.cjs.js');
+const index_cjs_js$6 = require('./_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.cjs.js');
 
 /**
  * Creates an interval loop that invokes one or more subscribed callback functions
@@ -95,21 +17,36 @@ const clearInterval = (id) => {
  *
  * @param interval - Time in milliseconds between each callback invocation (default: 1000ms)
  * @returns A Clock instance with start, stop, subscribe, and unsubscribe methods
+ *
+ * @example Creating interval clock
+ * ```typescript
+ * const clock = createClock(1000)
+ *
+ * const updateDisplay = (currentTime: Date) => {
+ *   console.log(currentTime.toISOString())
+ * }
+ *
+ * clock.subscribe(updateDisplay)
+ * clock.start()
+ *
+ * // Later: stop receiving updates
+ * clock.stop()
+ * ```
  */
 function createClock(interval = 1000) {
     let clockId = null;
     let subscribers = [];
     const start = () => {
         if (clockId === null) {
-            clockId = setInterval(() => {
-                const currentTime = createDate();
+            clockId = index_cjs_js$1.setInterval(() => {
+                const currentTime = index_cjs_js$2.createDate();
                 subscribers.forEach((subscriber) => subscriber(currentTime));
             }, interval);
         }
     };
     const stop = () => {
         if (clockId !== null) {
-            clearInterval(clockId);
+            index_cjs_js$1.clearInterval(clockId);
             clockId = null;
         }
     };
@@ -119,7 +56,7 @@ function createClock(interval = 1000) {
     const unsubscribe = (callback) => {
         subscribers = subscribers.filter((subscriber) => subscriber !== callback);
     };
-    return freeze({ start, stop, subscribe, unsubscribe, interval });
+    return index_cjs_js.freeze({ start, stop, subscribe, unsubscribe, interval });
 }
 
 /**
@@ -129,6 +66,24 @@ function createClock(interval = 1000) {
  * @param callback - The function to invoke after the delay
  * @param delay - Time in milliseconds to wait until callback is invoked
  * @returns A Timer instance with pause, resume, and reset methods
+ *
+ * @example Creating pausable timer
+ * ```typescript
+ * const timer = createTimer(() => {
+ *   console.log('Session expired')
+ * }, 30_000)
+ *
+ * timer.resume() // Start the 30-second countdown
+ *
+ * // User activity detected - pause the timer
+ * timer.pause()
+ *
+ * // User idle again - resume from where we left off
+ * timer.resume()
+ *
+ * // Reset to full 30 seconds on explicit action
+ * timer.reset()
+ * ```
  */
 function createTimer(callback, delay) {
     let timerId = null;
@@ -136,8 +91,8 @@ function createTimer(callback, delay) {
     let remaining = delay;
     const pause = () => {
         if (timerId !== null) {
-            clearTimeout(timerId);
-            const now = dateNow();
+            index_cjs_js$1.clearTimeout(timerId);
+            const now = index_cjs_js$2.dateNow();
             /* istanbul ignore else - start is always set when timerId is not null */
             if (start !== null) {
                 remaining -= now - start;
@@ -147,8 +102,8 @@ function createTimer(callback, delay) {
     };
     const resume = () => {
         if (timerId === null) {
-            start = dateNow();
-            timerId = setTimeout(() => {
+            start = index_cjs_js$2.dateNow();
+            timerId = index_cjs_js$1.setTimeout(() => {
                 callback();
                 timerId = null;
             }, remaining);
@@ -159,84 +114,35 @@ function createTimer(callback, delay) {
         remaining = newDelay;
         resume();
     };
-    return freeze({ pause, resume, reset });
+    return index_cjs_js.freeze({ pause, resume, reset });
 }
 
-/**
- * Safe copies of Error built-ins via factory functions.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides factory functions that use Reflect.construct internally.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
- */
-// Capture references at module initialization time
-const _Error = globalThis.Error;
-const _Reflect$1 = globalThis.Reflect;
-/**
- * (Safe copy) Creates a new Error using the captured Error constructor.
- * Use this instead of `new Error()`.
- *
- * @param message - Optional error message.
- * @param options - Optional error options.
- * @returns A new Error instance.
- */
-const createError = (message, options) => _Reflect$1.construct(_Error, [message, options]);
-
-/**
- * Safe copies of Math built-in methods.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/math
- */
-// Capture references at module initialization time
-const _Math = globalThis.Math;
-/**
- * (Safe copy) Returns the largest integer less than or equal to a number.
- */
-const floor = _Math.floor;
-
-/**
- * Safe copies of Number built-in methods and constants.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
- *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/number
- */
-// Capture references at module initialization time
-const _isNaN = globalThis.isNaN;
-// ============================================================================
-// Global Type Checking (legacy, less strict)
-// ============================================================================
-/**
- * (Safe copy) Global isNaN function (coerces to number first, less strict than Number.isNaN).
- */
-const globalIsNaN = _isNaN;
-
 /**
  * Normalizes a given time to the nearest base time window.
  *
  * @param time - The Date object to normalize to the nearest time window
  * @param baseTimeWindow - The size of the time window in minutes for normalization
  * @returns A new Date object normalized to the start of the time window
+ *
+ * @example Normalizing to 15-minute buckets
+ * ```typescript
+ * // Round timestamps to 15-minute intervals for analytics bucketing
+ * const eventTime = new Date('2024-03-15T14:23:45Z')
+ * const bucketTime = normalizeToBaseTimeWindow(eventTime, 15)
+ * // => 2024-03-15T14:15:00.000Z
+ * ```
  */
 function normalizeToBaseTimeWindow(time, baseTimeWindow) {
-    if (!time || !(time instanceof Date) || globalIsNaN(time.getTime())) {
-        throw createError('Invalid time input');
+    if (!time || !(time instanceof Date) || index_cjs_js$3.globalIsNaN(time.getTime())) {
+        throw index_cjs_js$4.createError('Invalid time input');
     }
     if (baseTimeWindow <= 0) {
-        throw createError('Base time window must be positive');
+        throw index_cjs_js$4.createError('Base time window must be positive');
     }
     const timeInMs = time.getTime();
     const windowInMs = baseTimeWindow * 60 * 1000;
-    const normalizedTimeInMs = floor(timeInMs / windowInMs) * windowInMs;
-    return createDate(normalizedTimeInMs);
+    const normalizedTimeInMs = index_cjs_js$5.floor(timeInMs / windowInMs) * windowInMs;
+    return index_cjs_js$2.createDate(normalizedTimeInMs);
 }
 
 /**
@@ -245,73 +151,39 @@ function normalizeToBaseTimeWindow(time, baseTimeWindow) {
  * @param callback - The function to invoke at each interval
  * @param interval - Time in milliseconds between each callback invocation
  * @returns A cleanup function that stops the interval when called
- */
-function setIntervalCallback(callback, interval) {
-    const timerId = setInterval(callback, interval);
-    return () => clearInterval(timerId);
-}
-
-/**
- * Safe copies of Promise built-in methods via factory functions.
- *
- * Since constructors cannot be safely captured via Object.assign, this module
- * provides factory functions that use Reflect.construct internally.
- *
- * These references are captured at module initialization time to protect against
- * prototype pollution attacks. Import only what you need for tree-shaking.
  *
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/promise
- */
-// Capture references at module initialization time
-const _Promise = globalThis.Promise;
-const _Reflect = globalThis.Reflect;
-/**
- * (Safe copy) Creates a new Promise using the captured Promise constructor.
- * Use this instead of `new Promise()`.
+ * @example Setting interval with cleanup
+ * ```typescript
+ * const stopPolling = setIntervalCallback(() => {
+ *   fetchLatestData()
+ * }, 5000)
  *
- * @param executor - The executor function.
- * @returns A new Promise instance.
- */
-const createPromise = (executor) => _Reflect.construct(_Promise, [executor]);
-/**
- * (Safe copy) Returns a Promise that resolves with the given value.
- */
-_Promise.resolve.bind(_Promise);
-/**
- * (Safe copy) Returns a Promise that rejects with the given reason.
- */
-_Promise.reject.bind(_Promise);
-/**
- * (Safe copy) Returns a Promise that resolves when all promises resolve.
+ * // Later: clean up when component unmounts
+ * stopPolling()
+ * ```
  */
-_Promise.all.bind(_Promise);
-/**
- * (Safe copy) Returns a Promise that resolves/rejects with the first settled promise.
- */
-_Promise.race.bind(_Promise);
-/**
- * (Safe copy) Returns a Promise that resolves when all promises settle.
- */
-_Promise.allSettled.bind(_Promise);
-/**
- * (Safe copy) Returns a Promise that resolves with the first fulfilled promise.
- */
-_Promise.any.bind(_Promise);
-/**
- * (Safe copy) Creates a Promise along with its resolve and reject functions.
- * Note: Available only in ES2024+ environments.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-_Promise.withResolvers?.bind(_Promise);
+function setIntervalCallback(callback, interval) {
+    const timerId = index_cjs_js$1.setInterval(callback, interval);
+    return () => index_cjs_js$1.clearInterval(timerId);
+}
 
 /**
  * Pauses execution for a specified duration.
  *
  * @param milliseconds - The duration to sleep in milliseconds
  * @returns A promise that resolves after the specified duration
+ *
+ * @example Implementing retry backoff
+ * ```typescript
+ * async function retryWithBackoff(attempt: number) {
+ *   const backoffMs = Math.min(1000 * 2 ** attempt, 30_000)
+ *   await sleep(backoffMs)
+ *   return fetchResource()
+ * }
+ * ```
  */
 function sleep(milliseconds) {
-    return createPromise((resolve) => setTimeout(resolve, milliseconds));
+    return index_cjs_js$6.createPromise((resolve) => index_cjs_js$1.setTimeout(resolve, milliseconds));
 }
 
 exports.createClock = createClock;
@@ -319,4 +191,3 @@ exports.createTimer = createTimer;
 exports.normalizeToBaseTimeWindow = normalizeToBaseTimeWindow;
 exports.setIntervalCallback = setIntervalCallback;
 exports.sleep = sleep;
-//# sourceMappingURL=index.cjs.js.map