@hyperfrontend/time-utils 0.0.4 → 1.0.0

package/bundle/index.umd.js

@@ -4,102 +4,29 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.HyperfrontendTimeUtils = {}));
 })(this, (function (exports) { '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);
     };
 
-    /**
-     * Creates an interval loop that invokes one or more subscribed callback functions
-     * at the specified internal (in milliseconds).
-     *
-     * Allows you to start or stop the interval loop, much like a stop watch.
-     * Allows you to unsubscribe callback functions.
-     *
-     * @param interval - Time in milliseconds between each callback invocation (default: 1000ms)
-     * @returns A Clock instance with start, stop, subscribe, and unsubscribe methods
-     */
     function createClock(interval = 1000) {
         let clockId = null;
         let subscribers = [];
@@ -126,14 +53,6 @@
         return freeze({ start, stop, subscribe, unsubscribe, interval });
     }
 
-    /**
-     * Invokes callback function after the designated time has passed, much like a timer.
-     * Allows you to pause, resume, or reset the progress of time tracked.
-     *
-     * @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
-     */
     function createTimer(callback, delay) {
         let timerId = null;
         let start = null;
@@ -142,7 +61,6 @@
             if (timerId !== null) {
                 clearTimeout(timerId);
                 const now = dateNow();
-                /* istanbul ignore else - start is always set when timerId is not null */
                 if (start !== null) {
                     remaining -= now - start;
                 }
@@ -166,70 +84,16 @@
         return 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
-     */
     function normalizeToBaseTimeWindow(time, baseTimeWindow) {
         if (!time || !(time instanceof Date) || globalIsNaN(time.getTime())) {
             throw createError('Invalid time input');
@@ -243,77 +107,22 @@
         return createDate(normalizedTimeInMs);
     }
 
-    /**
-     * Creates a repeating interval that invokes a callback function at regular intervals.
-     *
-     * @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()`.
-     *
-     * @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.
-     */
     _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);
 
-    /**
-     * Pauses execution for a specified duration.
-     *
-     * @param milliseconds - The duration to sleep in milliseconds
-     * @returns A promise that resolves after the specified duration
-     */
     function sleep(milliseconds) {
         return createPromise((resolve) => setTimeout(resolve, milliseconds));
     }
@@ -325,4 +134,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