@hyperfrontend/time-utils 0.0.2 → 0.0.3

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [0.0.3](https://github.com/AndrewRedican/hyperfrontend/compare/lib-time-utils@0.0.2...lib-time-utils@0.0.3) (2026-03-02)
+
+
+### Bug Fixes
+
+* **lib-time-utils:** correct package exports and dependencies ([3b9096b](https://github.com/AndrewRedican/hyperfrontend/commit/3b9096b54337c2c2f3e06d6b97865a772e79aad9))
+
 ## [0.0.2](https://github.com/AndrewRedican/hyperfrontend/compare/lib-time-utils@0.0.1...lib-time-utils@0.0.2) (2026-02-26)
 
 ## 0.0.1 (2026-02-15)

package/bundle/index.iife.js

@@ -1,6 +1,92 @@
 var HyperfrontendTimeUtils = (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).
@@ -17,7 +103,7 @@ var HyperfrontendTimeUtils = (function (exports) {
         const start = () => {
             if (clockId === null) {
                 clockId = setInterval(() => {
-                    const currentTime = new Date();
+                    const currentTime = createDate();
                     subscribers.forEach((subscriber) => subscriber(currentTime));
                 }, interval);
             }
@@ -34,7 +120,7 @@ var HyperfrontendTimeUtils = (function (exports) {
         const unsubscribe = (callback) => {
             subscribers = subscribers.filter((subscriber) => subscriber !== callback);
         };
-        return Object.freeze({ start, stop, subscribe, unsubscribe, interval });
+        return freeze({ start, stop, subscribe, unsubscribe, interval });
     }
 
     /**
@@ -52,7 +138,7 @@ var HyperfrontendTimeUtils = (function (exports) {
         const pause = () => {
             if (timerId !== null) {
                 clearTimeout(timerId);
-                const now = Date.now();
+                const now = dateNow();
                 /* istanbul ignore else - start is always set when timerId is not null */
                 if (start !== null) {
                     remaining -= now - start;
@@ -62,7 +148,7 @@ var HyperfrontendTimeUtils = (function (exports) {
         };
         const resume = () => {
             if (timerId === null) {
-                start = Date.now();
+                start = dateNow();
                 timerId = setTimeout(() => {
                     callback();
                     timerId = null;
@@ -74,9 +160,66 @@ var HyperfrontendTimeUtils = (function (exports) {
             remaining = newDelay;
             resume();
         };
-        return Object.freeze({ pause, resume, reset });
+        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.
      *
@@ -85,16 +228,16 @@ var HyperfrontendTimeUtils = (function (exports) {
      * @returns A new Date object normalized to the start of the time window
      */
     function normalizeToBaseTimeWindow(time, baseTimeWindow) {
-        if (!time || !(time instanceof Date) || isNaN(time.getTime())) {
-            throw new Error('Invalid time input');
+        if (!time || !(time instanceof Date) || globalIsNaN(time.getTime())) {
+            throw createError('Invalid time input');
         }
         if (baseTimeWindow <= 0) {
-            throw new Error('Base time window must be positive');
+            throw createError('Base time window must be positive');
         }
         const timeInMs = time.getTime();
         const windowInMs = baseTimeWindow * 60 * 1000;
-        const normalizedTimeInMs = Math.floor(timeInMs / windowInMs) * windowInMs;
-        return new Date(normalizedTimeInMs);
+        const normalizedTimeInMs = floor(timeInMs / windowInMs) * windowInMs;
+        return createDate(normalizedTimeInMs);
     }
 
     /**
@@ -109,6 +252,59 @@ var HyperfrontendTimeUtils = (function (exports) {
         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.
      *
@@ -116,7 +312,7 @@ var HyperfrontendTimeUtils = (function (exports) {
      * @returns A promise that resolves after the specified duration
      */
     function sleep(milliseconds) {
-        return new Promise((resolve) => setTimeout(resolve, milliseconds));
+        return createPromise((resolve) => setTimeout(resolve, milliseconds));
     }
 
     exports.createClock = createClock;

package/bundle/index.iife.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.iife.js","sources":["../../../../../../../../../../libs/utils/time/src/create-clock.ts","../../../../../../../../../../libs/utils/time/src/create-timer.ts","../../../../../../../../../../libs/utils/time/src/normalize-to-base-time-window.ts","../../../../../../../../../../libs/utils/time/src/set-interval-callback.ts","../../../../../../../../../../libs/utils/time/src/sleep.ts"],"sourcesContent":[null,null,null,null,null],"names":[],"mappings":"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"}
+{"version":3,"file":"index.iife.js","sources":["../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/date/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/object/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/timers/index.ts","../../../../../../../../../../libs/utils/time/src/create-clock.ts","../../../../../../../../../../libs/utils/time/src/create-timer.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/error/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/math/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/number/index.ts","../../../../../../../../../../libs/utils/time/src/normalize-to-base-time-window.ts","../../../../../../../../../../libs/utils/time/src/set-interval-callback.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/promise/index.ts","../../../../../../../../../../libs/utils/time/src/sleep.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,null,null],"names":["_Reflect"],"mappings":"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"}

package/bundle/index.iife.min.js

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

package/bundle/index.iife.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.iife.min.js","sources":["../../../../../../../../../../libs/utils/time/src/create-clock.ts","../../../../../../../../../../libs/utils/time/src/create-timer.ts","../../../../../../../../../../libs/utils/time/src/normalize-to-base-time-window.ts","../../../../../../../../../../libs/utils/time/src/set-interval-callback.ts","../../../../../../../../../../libs/utils/time/src/sleep.ts"],"sourcesContent":[null,null,null,null,null],"names":["interval","clockId","subscribers","Object","freeze","start","setInterval","currentTime","Date","forEach","subscriber","stop","clearInterval","subscribe","callback","push","unsubscribe","filter","delay","timerId","remaining","pause","clearTimeout","now","resume","setTimeout","reset","newDelay","time","baseTimeWindow","isNaN","getTime","Error","timeInMs","windowInMs","normalizedTimeInMs","Math","floor","milliseconds","Promise","resolve"],"mappings":"yEAmBM,SAAsBA,EAAW,KACrC,IAAIC,EAAiC,KACjCC,EAA+C,GA0BnD,OAAOC,OAAOC,OAAO,CAAEC,MAxBT,KACI,OAAZJ,IACFA,EAAUK,YAAY,KACpB,MAAMC,EAAc,IAAIC,KACxBN,EAAYO,QAASC,GAAeA,EAAWH,KAC9CP,KAmBuBW,KAfjB,KACK,OAAZV,IACFW,cAAcX,GACdA,EAAU,OAYsBY,UARjBC,IACjBZ,EAAYa,KAAKD,IAO4BE,YAJ1BF,IACnBZ,EAAcA,EAAYe,OAAQP,GAAeA,IAAeI,IAGNd,YAC9D,gBC/BM,SAAsBc,EAAsBI,GAChD,IAAIC,EAAiC,KACjCd,EAAuB,KACvBe,EAAoBF,EAExB,MAAMG,EAAQ,KACZ,GAAgB,OAAZF,EAAkB,CACpBG,aAAaH,GACb,MAAMI,EAAMf,KAAKe,MAEH,OAAVlB,IACFe,GAAaG,EAAMlB,GAErBc,EAAU,IACZ,GAGIK,EAAS,KACG,OAAZL,IACFd,EAAQG,KAAKe,MACbJ,EAAUM,WAAW,KACnBX,IACAK,EAAU,MACTC,KAUP,OAAOjB,OAAOC,OAAO,CAAEiB,QAAOG,SAAQE,MANxB,CAACC,EAAmBT,KAChCG,IACAD,EAAYO,EACZH,MAIJ,8BC5CM,SAAoCI,EAAYC,GACpD,IAAKD,KAAUA,aAAgBpB,OAASsB,MAAMF,EAAKG,WACjD,MAAM,IAAIC,MAAM,sBAGlB,GAAIH,GAAkB,EACpB,MAAM,IAAIG,MAAM,qCAGlB,MAAMC,EAAWL,EAAKG,UAChBG,EAA8B,GAAjBL,EAAsB,IACnCM,EAAqBC,KAAKC,MAAMJ,EAAWC,GAAcA,EAC/D,OAAO,IAAI1B,KAAK2B,EAClB,wBCbM,SAA8BrB,EAAsBd,GACxD,MAAMmB,EAA0Bb,YAAYQ,EAAUd,GACtD,MAAO,IAAYY,cAAcO,EACnC,UCJM,SAAgBmB,GACpB,OAAO,IAAIC,QAASC,GAAYf,WAAWe,EAASF,GACtD"}
+{"version":3,"file":"index.iife.min.js","sources":["../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/date/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/object/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/timers/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/error/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/math/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/number/index.ts","../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/promise/index.ts","../../../../../../../../../../libs/utils/time/src/create-clock.ts","../../../../../../../../../../libs/utils/time/src/create-timer.ts","../../../../../../../../../../libs/utils/time/src/normalize-to-base-time-window.ts","../../../../../../../../../../libs/utils/time/src/set-interval-callback.ts","../../../../../../../../../../libs/utils/time/src/sleep.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,null,null],"names":["_Date","globalThis","Date","_Reflect","Reflect","createDate","args","construct","dateNow","now","freeze","Object","_setTimeout","setTimeout","_setInterval","setInterval","_clearTimeout","clearTimeout","_clearInterval","clearInterval","callback","delay","id","_Error","Error","createError","message","options","floor","Math","globalIsNaN","isNaN","_Promise","Promise","resolve","bind","reject","all","race","allSettled","any","withResolvers","interval","clockId","subscribers","start","currentTime","forEach","subscriber","stop","subscribe","push","unsubscribe","filter","timerId","remaining","pause","resume","reset","newDelay","time","baseTimeWindow","getTime","timeInMs","windowInMs","milliseconds","executor"],"mappings":"oDAaA,MAAMA,EAAQC,WAAWC,KACnBC,EAAWF,WAAWG,QAoBtB,SAAUC,KAAcC,GAC5B,OAAaH,EAASI,UAAUP,EAAOM,EACzC,CAKO,MAAME,EAAUR,EAAMS,ICrBhBC,EAVGT,WAAWU,OAUGD,OCVxBE,EAAcX,WAAWY,WACzBC,EAAeb,WAAWc,YAC1BC,EAAgBf,WAAWgB,aAC3BC,EAAiBjB,WAAWkB,cAcrBN,EAAa,CACxBO,EACAC,KACGf,IAC0CM,EAAYQ,EAAUC,KAAUf,GAUlES,EAAc,CACzBK,EACAC,KACGf,IAC2CQ,EAAaM,EAAUC,KAAUf,GAgBpEa,EAAiBG,IAC5BJ,EAAeI,ICjDjB,MAAMC,EAAStB,WAAWuB,MAQpBrB,EAAWF,WAAWG,QAWfqB,EAAc,CAACC,EAAkBC,IAAyCxB,EAASI,UAAUgB,EAAQ,CAACG,EAASC,IC+C/GC,EArEC3B,WAAW4B,KAqEED,MC2BdE,EA7FE7B,WAAW8B,MCA1B,MAAMC,EAAW/B,WAAWgC,QACtB9B,EAAWF,WAAWG,eAiBE4B,EAASE,QAAQC,KAAKH,GAKvBA,EAASI,OAAOD,KAAKH,GAKxBA,EAASK,IAAIF,KAAKH,GAKjBA,EAASM,KAAKH,KAAKH,GAKbA,EAASO,WAAWJ,KAAKH,GAKhCA,EAASQ,IAAIL,KAAKH,GAOFA,EAAUS,eAAeN,KAAKH,iBCxClE,SAAsBU,EAAW,KACrC,IAAIC,EAAiC,KACjCC,EAA+C,GA0BnD,OAAOlC,EAAO,CAAEmC,MAxBF,KACI,OAAZF,IACFA,EAAU5B,EAAY,KACpB,MAAM+B,EAAczC,IACpBuC,EAAYG,QAASC,GAAeA,EAAWF,KAC9CJ,KAmBgBO,KAfV,KACK,OAAZN,IACFxB,EAAcwB,GACdA,EAAU,OAYeO,UARV9B,IACjBwB,EAAYO,KAAK/B,IAOqBgC,YAJnBhC,IACnBwB,EAAcA,EAAYS,OAAQL,GAAeA,IAAe5B,IAGbsB,YACvD,gBC/BM,SAAsBtB,EAAsBC,GAChD,IAAIiC,EAAiC,KACjCT,EAAuB,KACvBU,EAAoBlC,EAExB,MAAMmC,EAAQ,KACZ,GAAgB,OAAZF,EAAkB,CN0BxBtC,EMzBiBsC,GACb,MAAM7C,EAAMD,IAEE,OAAVqC,IACFU,GAAa9C,EAAMoC,GAErBS,EAAU,IACZ,GAGIG,EAAS,KACG,OAAZH,IACFT,EAAQrC,IACR8C,EAAUzC,EAAW,KACnBO,IACAkC,EAAU,MACTC,KAUP,OAAO7C,EAAO,CAAE8C,QAAOC,SAAQC,MANjB,CAACC,EAAmBtC,KAChCmC,IACAD,EAAYI,EACZF,MAIJ,8BC3CM,SAAoCG,EAAYC,GACpD,IAAKD,KAAUA,aAAgB1D,OAAS4B,EAAY8B,EAAKE,WACvD,MAAMrC,EAAY,sBAGpB,GAAIoC,GAAkB,EACpB,MAAMpC,EAAY,qCAGpB,MAAMsC,EAAWH,EAAKE,UAChBE,EAA8B,GAAjBH,EAAsB,IAEzC,OAAOxD,EADoBuB,EAAMmC,EAAWC,GAAcA,EAE5D,wBChBM,SAA8B5C,EAAsBsB,GACxD,MAAMY,EAAUvC,EAAYK,EAAUsB,GACtC,MAAO,IAAYvB,EAAcmC,EACnC,UCHM,SAAgBW,GACpB,OLeAC,EKfsBhC,GAAYrB,EAAWqB,EAAS+B,GLgB3B9D,EAASI,UAAUyB,EAAU,CAACkC,IAF9B,IAC3BA,CKdF"}

package/bundle/index.umd.js

@@ -4,6 +4,92 @@
     (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).
@@ -20,7 +106,7 @@
         const start = () => {
             if (clockId === null) {
                 clockId = setInterval(() => {
-                    const currentTime = new Date();
+                    const currentTime = createDate();
                     subscribers.forEach((subscriber) => subscriber(currentTime));
                 }, interval);
             }
@@ -37,7 +123,7 @@
         const unsubscribe = (callback) => {
             subscribers = subscribers.filter((subscriber) => subscriber !== callback);
         };
-        return Object.freeze({ start, stop, subscribe, unsubscribe, interval });
+        return freeze({ start, stop, subscribe, unsubscribe, interval });
     }
 
     /**
@@ -55,7 +141,7 @@
         const pause = () => {
             if (timerId !== null) {
                 clearTimeout(timerId);
-                const now = Date.now();
+                const now = dateNow();
                 /* istanbul ignore else - start is always set when timerId is not null */
                 if (start !== null) {
                     remaining -= now - start;
@@ -65,7 +151,7 @@
         };
         const resume = () => {
             if (timerId === null) {
-                start = Date.now();
+                start = dateNow();
                 timerId = setTimeout(() => {
                     callback();
                     timerId = null;
@@ -77,9 +163,66 @@
             remaining = newDelay;
             resume();
         };
-        return Object.freeze({ pause, resume, reset });
+        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.
      *
@@ -88,16 +231,16 @@
      * @returns A new Date object normalized to the start of the time window
      */
     function normalizeToBaseTimeWindow(time, baseTimeWindow) {
-        if (!time || !(time instanceof Date) || isNaN(time.getTime())) {
-            throw new Error('Invalid time input');
+        if (!time || !(time instanceof Date) || globalIsNaN(time.getTime())) {
+            throw createError('Invalid time input');
         }
         if (baseTimeWindow <= 0) {
-            throw new Error('Base time window must be positive');
+            throw createError('Base time window must be positive');
         }
         const timeInMs = time.getTime();
         const windowInMs = baseTimeWindow * 60 * 1000;
-        const normalizedTimeInMs = Math.floor(timeInMs / windowInMs) * windowInMs;
-        return new Date(normalizedTimeInMs);
+        const normalizedTimeInMs = floor(timeInMs / windowInMs) * windowInMs;
+        return createDate(normalizedTimeInMs);
     }
 
     /**
@@ -112,6 +255,59 @@
         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.
      *
@@ -119,7 +315,7 @@
      * @returns A promise that resolves after the specified duration
      */
     function sleep(milliseconds) {
-        return new Promise((resolve) => setTimeout(resolve, milliseconds));
+        return createPromise((resolve) => setTimeout(resolve, milliseconds));
     }
 
     exports.createClock = createClock;