@develia/commons 0.4.22 → 0.4.23

package/dist/cjs/collections/cache-dictionary.js

@@ -41,9 +41,7 @@ class CacheDictionary {
             delete this.expiration[key];
         }
         else {
-            const expiration = new Date();
-            expiration.setSeconds(expiration.getSeconds() + duration);
-            this.expiration[key] = expiration;
+            this.expiration[key] = this.calculateExpiration(duration);
         }
     }
     /**
@@ -97,9 +95,7 @@ class CacheDictionary {
         if (duration === null) {
             return undefined;
         }
-        const expiration = new Date();
-        expiration.setSeconds(expiration.getSeconds() + duration);
-        return expiration;
+        return new Date(Date.now() + duration * 1000);
     }
 }
 exports.default = CacheDictionary;

package/dist/cjs/collections/cache-dictionary.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            const expiration = new Date();\n            expiration.setSeconds(expiration.getSeconds() + duration);\n            this.expiration[key] = expiration;\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        const expiration = new Date();\n        expiration.setSeconds(expiration.getSeconds() + duration);\n        return expiration;\n    }\n}"]}
+{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            this.expiration[key] = this.calculateExpiration(duration);\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        return new Date(Date.now() + duration * 1000);\n    }\n}"]}

package/dist/cjs/index.js

@@ -18,7 +18,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formToObject = exports.submitForm = exports.ajaxSubmission = exports.ajaxSubmit = exports.CleanURLSearchParams = exports.draft = exports.Range = exports.Event = exports.EventBus = exports.from = exports.Lazy = exports.AsyncPoolExecutor = exports.Stopwatch = exports.TimeSpan = exports.Timer = exports.Order = exports.KeyValuePair = exports.CancellablePromise = exports.TypeCode = exports.Type = void 0;
+exports.formToObject = exports.submitForm = exports.ajaxSubmission = exports.ajaxSubmit = exports.CleanURLSearchParams = exports.draft = exports.Range = exports.Event = exports.EventBus = exports.from = exports.Lazy = exports.AsyncPoolExecutor = exports.CountTrigger = exports.TimeTrigger = exports.Stopwatch = exports.TimeSpan = exports.Timer = exports.Order = exports.KeyValuePair = exports.CancellablePromise = exports.TypeCode = exports.Type = void 0;
 // ─── Types ───────────────────────────────────────────
 __exportStar(require("./types.js"), exports);
 var type_js_1 = require("./type.js");
@@ -45,6 +45,9 @@ var timespan_js_1 = require("./timespan.js");
 Object.defineProperty(exports, "TimeSpan", { enumerable: true, get: function () { return __importDefault(timespan_js_1).default; } });
 var stopwatch_js_1 = require("./stopwatch.js");
 Object.defineProperty(exports, "Stopwatch", { enumerable: true, get: function () { return __importDefault(stopwatch_js_1).default; } });
+var triggers_js_1 = require("./triggers.js");
+Object.defineProperty(exports, "TimeTrigger", { enumerable: true, get: function () { return triggers_js_1.TimeTrigger; } });
+Object.defineProperty(exports, "CountTrigger", { enumerable: true, get: function () { return triggers_js_1.CountTrigger; } });
 var async_pool_executor_js_1 = require("./async-pool-executor.js");
 Object.defineProperty(exports, "AsyncPoolExecutor", { enumerable: true, get: function () { return __importDefault(async_pool_executor_js_1).default; } });
 // ─── Patterns ────────────────────────────────────────

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,eAAe;;;;;;;;;;;;;;;;;;;;AAEf,wDAAwD;AACxD,6CAA2B;AAC3B,qCAA0C;AAAlC,gHAAA,OAAO,OAAQ;AACvB,+CAAmD;AAA3C,yHAAA,OAAO,OAAY;AAE3B,wDAAwD;AACxD,iDAA+B;AAC/B,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,6CAA2B;AAC3B,mEAAuE;AAA/D,6IAAA,OAAO,OAAsB;AAErC,uDAAuD;AACvD,yDAA4D;AAApD,kIAAA,OAAO,OAAgB;AAC/B,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,uDAAuD;AACvD,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AACxB,6CAAkD;AAA1C,wHAAA,OAAO,OAAY;AAC3B,+CAAoD;AAA5C,0HAAA,OAAO,OAAa;AAC5B,mEAAsE;AAA9D,4IAAA,OAAO,OAAqB;AAEpC,wDAAwD;AACxD,qCAA0C;AAAlC,gHAAA,OAAO,OAAQ;AACvB,iDAAsD;AAA9C,gHAAA,OAAO,OAAQ;AACvB,+CAA+C;AAAvC,wGAAA,QAAQ,OAAA;AAAE,qGAAA,KAAK,OAAA;AACvB,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,qDAAqD;AACrD,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,wDAAwD;AACxD,2EAA6E;AAArE,mJAAA,OAAO,OAAwB;AACvC,mBAAmB;AACnB,+CAAwF;AAAhF,sGAAA,UAAU,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,sGAAA,UAAU,OAAA;AAAE,wGAAA,YAAY,OAAA;AAI5D,wDAAwD;AACxD,mBAAmB;AACnB,6CAA2B;AAC3B,mBAAmB;AACnB,yDAAuC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated  */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated  */\nexport * from './array.js';\n/** @deprecated  */\nexport * from './collections/index.js';"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,eAAe;;;;;;;;;;;;;;;;;;;;AAEf,wDAAwD;AACxD,6CAA2B;AAC3B,qCAA0C;AAAlC,gHAAA,OAAO,OAAQ;AACvB,+CAAmD;AAA3C,yHAAA,OAAO,OAAY;AAE3B,wDAAwD;AACxD,iDAA+B;AAC/B,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,6CAA2B;AAC3B,mEAAuE;AAA/D,6IAAA,OAAO,OAAsB;AAErC,uDAAuD;AACvD,yDAA4D;AAApD,kIAAA,OAAO,OAAgB;AAC/B,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,uDAAuD;AACvD,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AACxB,6CAAkD;AAA1C,wHAAA,OAAO,OAAY;AAC3B,+CAAoD;AAA5C,0HAAA,OAAO,OAAa;AAE5B,6CAAwD;AAAhD,0GAAA,WAAW,OAAA;AAAE,2GAAA,YAAY,OAAA;AACjC,mEAAsE;AAA9D,4IAAA,OAAO,OAAqB;AAEpC,wDAAwD;AACxD,qCAA0C;AAAlC,gHAAA,OAAO,OAAQ;AACvB,iDAAsD;AAA9C,gHAAA,OAAO,OAAQ;AACvB,+CAA+C;AAAvC,wGAAA,QAAQ,OAAA;AAAE,qGAAA,KAAK,OAAA;AACvB,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,qDAAqD;AACrD,uCAA4C;AAApC,kHAAA,OAAO,OAAS;AAExB,wDAAwD;AACxD,2EAA6E;AAArE,mJAAA,OAAO,OAAwB;AACvC,mBAAmB;AACnB,+CAAwF;AAAhF,sGAAA,UAAU,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,sGAAA,UAAU,OAAA;AAAE,wGAAA,YAAY,OAAA;AAI5D,wDAAwD;AACxD,mBAAmB;AACnB,6CAA2B;AAC3B,mBAAmB;AACnB,yDAAuC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport type {Result} from './result.js';\nexport {TimeTrigger, CountTrigger} from './triggers.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated  */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated  */\nexport * from './array.js';\n/** @deprecated  */\nexport * from './collections/index.js';"]}

package/dist/cjs/result.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=result.js.map

package/dist/cjs/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/result.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Represents success and failure outputs narrowed by `success`.\n */\nexport type Result<TSuccessOutput, TFailureOutput = undefined> =\n    | {readonly success: true; readonly output: TSuccessOutput}\n    | {readonly success: false; readonly output?: TFailureOutput};\n"]}

package/dist/cjs/triggers.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountTrigger = exports.TimeTrigger = void 0;
+/**
+ * Runs a callback at most once during a configured time interval.
+ */
+class TimeTrigger {
+    constructor(callback, interval) {
+        this.callback = callback;
+        this.interval = interval;
+        this.lastRunTime = null;
+    }
+    /**
+     * Executes the callback when the configured interval has elapsed.
+     */
+    async check() {
+        const currentTime = performance.now();
+        if (this.lastRunTime === null
+            || currentTime - this.lastRunTime >= this.interval.milliseconds) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured interval.
+     */
+    async trigger() {
+        this.lastRunTime = performance.now();
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured time interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured time interval.
+     */
+    setInterval(interval) {
+        this.interval = interval;
+    }
+}
+exports.TimeTrigger = TimeTrigger;
+/**
+ * Runs a callback after a configured number of checks.
+ */
+class CountTrigger {
+    constructor(callback, interval) {
+        this.interval = 1;
+        this.checkCount = 0;
+        this.callback = callback;
+        this.setInterval(interval);
+    }
+    /**
+     * Executes the callback when the configured number of checks is reached.
+     */
+    async check() {
+        this.checkCount++;
+        if (this.checkCount >= this.interval) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured check count.
+     */
+    async trigger() {
+        this.checkCount = 0;
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured check interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured check interval.
+     *
+     * @throws {RangeError} When the interval is less than one.
+     */
+    setInterval(interval) {
+        if (interval < 1) {
+            throw new RangeError('Interval must be greater than zero.');
+        }
+        this.interval = interval;
+    }
+}
+exports.CountTrigger = CountTrigger;
+//# sourceMappingURL=triggers.js.map

package/dist/cjs/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/triggers.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,MAAa,WAAW;IAKpB,YAAmB,QAAkC,EAAE,QAAkB;QACrE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;eACtB,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EACjE,CAAC;YACC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CAGJ;AAxDD,kCAwDC;AAED;;GAEG;AACH,MAAa,YAAY;IAKrB,YAAmB,QAAkC,EAAE,QAAgB;QAH/D,aAAQ,GAAW,CAAC,CAAC;QACrB,eAAU,GAAW,CAAC,CAAC;QAG3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAgB;QAC/B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ;AAzDD,oCAyDC","sourcesContent":["import type {Result} from './result.js';\nimport TimeSpan from './timespan.js';\nimport type {Nullable, Supplier} from './types.js';\n\n/**\n * Runs a callback at most once during a configured time interval.\n */\nexport class TimeTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: TimeSpan;\n    private lastRunTime: Nullable<number>;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan) {\n        this.callback = callback;\n        this.interval = interval;\n        this.lastRunTime = null;\n    }\n\n    /**\n     * Executes the callback when the configured interval has elapsed.\n     */\n    public async check(): Promise<Result<T>> {\n        const currentTime = performance.now();\n\n        if (this.lastRunTime === null\n            || currentTime - this.lastRunTime >= this.interval.milliseconds\n        ) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured interval.\n     */\n    public async trigger(): Promise<T> {\n        this.lastRunTime = performance.now();\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured time interval.\n     */\n    public getInterval(): TimeSpan {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured time interval.\n     */\n    public setInterval(interval: TimeSpan): void {\n        this.interval = interval;\n    }\n\n\n}\n\n/**\n * Runs a callback after a configured number of checks.\n */\nexport class CountTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: number = 1;\n    private checkCount: number = 0;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: number) {\n        this.callback = callback;\n        this.setInterval(interval);\n    }\n\n    /**\n     * Executes the callback when the configured number of checks is reached.\n     */\n    public async check(): Promise<Result<T>> {\n        this.checkCount++;\n\n        if (this.checkCount >= this.interval) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured check count.\n     */\n    public async trigger(): Promise<T> {\n        this.checkCount = 0;\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured check interval.\n     */\n    public getInterval(): number {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured check interval.\n     *\n     * @throws {RangeError} When the interval is less than one.\n     */\n    public setInterval(interval: number): void {\n        if (interval < 1) {\n            throw new RangeError('Interval must be greater than zero.');\n        }\n\n        this.interval = interval;\n    }\n}\n"]}

package/dist/esm/collections/cache-dictionary.js

@@ -39,9 +39,7 @@ export default class CacheDictionary {
             delete this.expiration[key];
         }
         else {
-            const expiration = new Date();
-            expiration.setSeconds(expiration.getSeconds() + duration);
-            this.expiration[key] = expiration;
+            this.expiration[key] = this.calculateExpiration(duration);
         }
     }
     /**
@@ -95,9 +93,7 @@ export default class CacheDictionary {
         if (duration === null) {
             return undefined;
         }
-        const expiration = new Date();
-        expiration.setSeconds(expiration.getSeconds() + duration);
-        return expiration;
+        return new Date(Date.now() + duration * 1000);
     }
 }
 //# sourceMappingURL=cache-dictionary.js.map

package/dist/esm/collections/cache-dictionary.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            const expiration = new Date();\n            expiration.setSeconds(expiration.getSeconds() + duration);\n            this.expiration[key] = expiration;\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        const expiration = new Date();\n        expiration.setSeconds(expiration.getSeconds() + duration);\n        return expiration;\n    }\n}"]}
+{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            this.expiration[key] = this.calculateExpiration(duration);\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        return new Date(Date.now() + duration * 1000);\n    }\n}"]}

package/dist/esm/index.js

@@ -17,6 +17,7 @@ export { default as Order } from './order.js';
 export { default as Timer } from './timer.js';
 export { default as TimeSpan } from './timespan.js';
 export { default as Stopwatch } from './stopwatch.js';
+export { TimeTrigger, CountTrigger } from './triggers.js';
 export { default as AsyncPoolExecutor } from './async-pool-executor.js';
 // ─── Patterns ────────────────────────────────────────
 export { default as Lazy } from './lazy.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,wDAAwD;AACxD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAEnD,wDAAwD;AACxD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAEvE,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAEtE,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,qDAAqD;AACrD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AAC7E,mBAAmB;AACnB,OAAO,EAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAIxF,wDAAwD;AACxD,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,wBAAwB,CAAC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated  */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated  */\nexport * from './array.js';\n/** @deprecated  */\nexport * from './collections/index.js';"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,wDAAwD;AACxD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAEnD,wDAAwD;AACxD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAEvE,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AACxD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAEtE,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,qDAAqD;AACrD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AAC7E,mBAAmB;AACnB,OAAO,EAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAIxF,wDAAwD;AACxD,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,wBAAwB,CAAC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport type {Result} from './result.js';\nexport {TimeTrigger, CountTrigger} from './triggers.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated  */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated  */\nexport * from './array.js';\n/** @deprecated  */\nexport * from './collections/index.js';"]}

package/dist/esm/result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.js.map

package/dist/esm/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/result.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Represents success and failure outputs narrowed by `success`.\n */\nexport type Result<TSuccessOutput, TFailureOutput = undefined> =\n    | {readonly success: true; readonly output: TSuccessOutput}\n    | {readonly success: false; readonly output?: TFailureOutput};\n"]}

package/dist/esm/triggers.js

@@ -0,0 +1,98 @@
+/**
+ * Runs a callback at most once during a configured time interval.
+ */
+export class TimeTrigger {
+    constructor(callback, interval) {
+        this.callback = callback;
+        this.interval = interval;
+        this.lastRunTime = null;
+    }
+    /**
+     * Executes the callback when the configured interval has elapsed.
+     */
+    async check() {
+        const currentTime = performance.now();
+        if (this.lastRunTime === null
+            || currentTime - this.lastRunTime >= this.interval.milliseconds) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured interval.
+     */
+    async trigger() {
+        this.lastRunTime = performance.now();
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured time interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured time interval.
+     */
+    setInterval(interval) {
+        this.interval = interval;
+    }
+}
+/**
+ * Runs a callback after a configured number of checks.
+ */
+export class CountTrigger {
+    constructor(callback, interval) {
+        this.interval = 1;
+        this.checkCount = 0;
+        this.callback = callback;
+        this.setInterval(interval);
+    }
+    /**
+     * Executes the callback when the configured number of checks is reached.
+     */
+    async check() {
+        this.checkCount++;
+        if (this.checkCount >= this.interval) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured check count.
+     */
+    async trigger() {
+        this.checkCount = 0;
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured check interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured check interval.
+     *
+     * @throws {RangeError} When the interval is less than one.
+     */
+    setInterval(interval) {
+        if (interval < 1) {
+            throw new RangeError('Interval must be greater than zero.');
+        }
+        this.interval = interval;
+    }
+}
+//# sourceMappingURL=triggers.js.map

package/dist/esm/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/triggers.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,WAAW;IAKpB,YAAmB,QAAkC,EAAE,QAAkB;QACrE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;eACtB,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EACjE,CAAC;YACC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CAGJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAKrB,YAAmB,QAAkC,EAAE,QAAgB;QAH/D,aAAQ,GAAW,CAAC,CAAC;QACrB,eAAU,GAAW,CAAC,CAAC;QAG3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAgB;QAC/B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ","sourcesContent":["import type {Result} from './result.js';\nimport TimeSpan from './timespan.js';\nimport type {Nullable, Supplier} from './types.js';\n\n/**\n * Runs a callback at most once during a configured time interval.\n */\nexport class TimeTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: TimeSpan;\n    private lastRunTime: Nullable<number>;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan) {\n        this.callback = callback;\n        this.interval = interval;\n        this.lastRunTime = null;\n    }\n\n    /**\n     * Executes the callback when the configured interval has elapsed.\n     */\n    public async check(): Promise<Result<T>> {\n        const currentTime = performance.now();\n\n        if (this.lastRunTime === null\n            || currentTime - this.lastRunTime >= this.interval.milliseconds\n        ) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured interval.\n     */\n    public async trigger(): Promise<T> {\n        this.lastRunTime = performance.now();\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured time interval.\n     */\n    public getInterval(): TimeSpan {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured time interval.\n     */\n    public setInterval(interval: TimeSpan): void {\n        this.interval = interval;\n    }\n\n\n}\n\n/**\n * Runs a callback after a configured number of checks.\n */\nexport class CountTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: number = 1;\n    private checkCount: number = 0;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: number) {\n        this.callback = callback;\n        this.setInterval(interval);\n    }\n\n    /**\n     * Executes the callback when the configured number of checks is reached.\n     */\n    public async check(): Promise<Result<T>> {\n        this.checkCount++;\n\n        if (this.checkCount >= this.interval) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured check count.\n     */\n    public async trigger(): Promise<T> {\n        this.checkCount = 0;\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured check interval.\n     */\n    public getInterval(): number {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured check interval.\n     *\n     * @throws {RangeError} When the interval is less than one.\n     */\n    public setInterval(interval: number): void {\n        if (interval < 1) {\n            throw new RangeError('Interval must be greater than zero.');\n        }\n\n        this.interval = interval;\n    }\n}\n"]}

package/dist/types/collections/cache-dictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-dictionary.d.ts","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe,CAAC,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IAEjE;;;OAGG;gBACS,QAAQ,GAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC,GAAG,IAAW,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW;IAO/F;;;;OAIG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInD;;;;OAIG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI;IAIrE;;;;OAIG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAU9D;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAkBjC;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,IAAI;IAKvE;;;OAGG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,mBAAmB;CAS9B"}
+{"version":3,"file":"cache-dictionary.d.ts","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe,CAAC,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IAEjE;;;OAGG;gBACS,QAAQ,GAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC,GAAG,IAAW,EAAE,eAAe,GAAE,MAAM,GAAG,IAAW;IAO/F;;;;OAIG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInD;;;;OAIG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI;IAIrE;;;;OAIG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQ9D;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAkBjC;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,IAAI;IAKvE;;;OAGG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,mBAAmB;CAO9B"}

package/dist/types/index.d.ts

@@ -12,6 +12,8 @@ export { default as Order } from './order.js';
 export { default as Timer } from './timer.js';
 export { default as TimeSpan } from './timespan.js';
 export { default as Stopwatch } from './stopwatch.js';
+export type { Result } from './result.js';
+export { TimeTrigger, CountTrigger } from './triggers.js';
 export { default as AsyncPoolExecutor } from './async-pool-executor.js';
 export { default as Lazy } from './lazy.js';
 export { default as from } from './collections/from.js';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAGnD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAGvE,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAGtE,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AAC7E,mBAAmB;AACnB,OAAO,EAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAKxF,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAGnD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAGvE,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AACxD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAGtE,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AAC7E,mBAAmB;AACnB,OAAO,EAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAKxF,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,wBAAwB,CAAC"}

package/dist/types/result.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Represents success and failure outputs narrowed by `success`.
+ */
+export type Result<TSuccessOutput, TFailureOutput = undefined> = {
+    readonly success: true;
+    readonly output: TSuccessOutput;
+} | {
+    readonly success: false;
+    readonly output?: TFailureOutput;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,IACvD;IAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAC,GACzD;IAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAC,CAAC"}

package/dist/types/triggers.d.ts

@@ -0,0 +1,64 @@
+import type { Result } from './result.js';
+import TimeSpan from './timespan.js';
+import type { Supplier } from './types.js';
+/**
+ * Runs a callback at most once during a configured time interval.
+ */
+export declare class TimeTrigger<T> {
+    private callback;
+    private interval;
+    private lastRunTime;
+    constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan);
+    /**
+     * Executes the callback when the configured interval has elapsed.
+     */
+    check(): Promise<Result<T>>;
+    /**
+     * Executes the callback regardless of the configured interval.
+     */
+    trigger(): Promise<T>;
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback: Supplier<T | Promise<T>>): void;
+    /**
+     * Gets the configured time interval.
+     */
+    getInterval(): TimeSpan;
+    /**
+     * Replaces the configured time interval.
+     */
+    setInterval(interval: TimeSpan): void;
+}
+/**
+ * Runs a callback after a configured number of checks.
+ */
+export declare class CountTrigger<T> {
+    private callback;
+    private interval;
+    private checkCount;
+    constructor(callback: Supplier<T | Promise<T>>, interval: number);
+    /**
+     * Executes the callback when the configured number of checks is reached.
+     */
+    check(): Promise<Result<T>>;
+    /**
+     * Executes the callback regardless of the configured check count.
+     */
+    trigger(): Promise<T>;
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback: Supplier<T | Promise<T>>): void;
+    /**
+     * Gets the configured check interval.
+     */
+    getInterval(): number;
+    /**
+     * Replaces the configured check interval.
+     *
+     * @throws {RangeError} When the interval is less than one.
+     */
+    setInterval(interval: number): void;
+}
+//# sourceMappingURL=triggers.d.ts.map

package/dist/types/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAW,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC;IACtB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAmB;gBAEnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ;IAMzE;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAYxC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAKlC;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACI,WAAW,IAAI,QAAQ;IAI9B;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAK/C;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,UAAU,CAAa;gBAEZ,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM;IAKvE;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAUxC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAKlC;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAO7C"}

package/dist/web/collections/cache-dictionary.js

@@ -39,9 +39,7 @@ export default class CacheDictionary {
             delete this.expiration[key];
         }
         else {
-            const expiration = new Date();
-            expiration.setSeconds(expiration.getSeconds() + duration);
-            this.expiration[key] = expiration;
+            this.expiration[key] = this.calculateExpiration(duration);
         }
     }
     /**
@@ -95,9 +93,7 @@ export default class CacheDictionary {
         if (duration === null) {
             return undefined;
         }
-        const expiration = new Date();
-        expiration.setSeconds(expiration.getSeconds() + duration);
-        return expiration;
+        return new Date(Date.now() + duration * 1000);
     }
 }
 //# sourceMappingURL=cache-dictionary.js.map

package/dist/web/collections/cache-dictionary.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            const expiration = new Date();\n            expiration.setSeconds(expiration.getSeconds() + duration);\n            this.expiration[key] = expiration;\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        const expiration = new Date();\n        expiration.setSeconds(expiration.getSeconds() + duration);\n        return expiration;\n    }\n}"]}
+{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A dictionary-like structure with caching and expiration capabilities.\n * @template T - The type of the values stored in the cache.\n */\nexport default class CacheDictionary<T> {\n    private readonly fallback: ((key: string) => T) | null;\n    private readonly cache: { [key: string]: T };\n    private readonly defaultDuration: number | null;\n    private readonly expiration: { [key: string]: Date | undefined };\n\n    /**\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\n     */\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\n        this.fallback = fallback;\n        this.cache = Object.create(null);\n        this.defaultDuration = defaultDuration;\n        this.expiration = Object.create(null);\n    }\n\n    /**\n     * Gets the expiration date for a specific key.\n     * @param {string} key - The key.\n     * @returns {Date | undefined} The expiration date or undefined.\n     */\n    public getExpiration(key: string): Date | undefined {\n        return this.expiration[key];\n    }\n\n    /**\n     * Sets a specific expiration date for a key.\n     * @param {string} key - The key.\n     * @param {Date | undefined} expiration - The expiration date.\n     */\n    public setExpiration(key: string, expiration: Date | undefined): void {\n        this.expiration[key] = expiration;\n    }\n\n    /**\n     * Sets a duration in seconds for a key's expiration.\n     * @param {string} key - The key.\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\n     */\n    public setDuration(key: string, duration: number | null): void {\n        if (duration === null) {\n            delete this.expiration[key];\n        } else {\n            this.expiration[key] = this.calculateExpiration(duration);\n        }\n    }\n\n    /**\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\n     * If the item is expired, it's removed and null is returned.\n     * @param {string} key - The key to retrieve.\n     * @returns {T | null} The value or null if not found/expired.\n     */\n    public get(key: string): T | null {\n        if (!Object.prototype.hasOwnProperty.call(this.cache, key)) {\n            if (this.fallback) {\n                this.cache[key] = this.fallback(key);\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\n            } else {\n                return null;\n            }\n        }\n\n        if (this.isExpired(key)) {\n            this.remove(key);\n            return null;\n        }\n\n        return this.cache[key];\n    }\n\n    /**\n     * Sets a value in the cache with an optional duration.\n     * @param {string} key - The key.\n     * @param {T} value - The value to store.\n     * @param {number | null} duration - Duration in seconds.\n     */\n    public set(key: string, value: T, duration: number | null = null): void {\n        this.cache[key] = value;\n        this.expiration[key] = this.calculateExpiration(duration);\n    }\n\n    /**\n     * Removes an item from the cache.\n     * @param {string} key - The key to remove.\n     */\n    public remove(key: string): void {\n        delete this.cache[key];\n        delete this.expiration[key];\n    }\n\n    private isExpired(key: string): boolean {\n        const expiration = this.expiration[key];\n        if (expiration instanceof Date) {\n            return expiration < new Date();\n        }\n        return false;\n    }\n\n    private calculateExpiration(duration: number | null): Date | undefined {\n        if (duration === null) {\n            return undefined;\n        }\n\n        return new Date(Date.now() + duration * 1000);\n    }\n}"]}

package/dist/web/index.js

@@ -17,6 +17,7 @@ export { default as Order } from './order.js';
 export { default as Timer } from './timer.js';
 export { default as TimeSpan } from './timespan.js';
 export { default as Stopwatch } from './stopwatch.js';
+export { TimeTrigger, CountTrigger } from './triggers.js';
 export { default as AsyncPoolExecutor } from './async-pool-executor.js';
 // ─── Patterns ────────────────────────────────────────
 export { default as Lazy } from './lazy.js';

package/dist/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,wDAAwD;AACxD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAEnD,wDAAwD;AACxD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAEvE,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAEtE,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,qDAAqD;AACrD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AAC7E,mBAAmB;AACnB,OAAO,EAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAIxF,wDAAwD;AACxD,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,wBAAwB,CAAC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated  */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated  */\nexport * from './array.js';\n/** @deprecated  */\nexport * from './collections/index.js';"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,wDAAwD;AACxD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAEnD,wDAAwD;AACxD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAEvE,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,uDAAuD;AACvD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AACxD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAEtE,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,qDAAqD;AACrD,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,YAAY,CAAC;AAE5C,wDAAwD;AACxD,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AAC7E,mBAAmB;AACnB,OAAO,EAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAIxF,wDAAwD;AACxD,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,wBAAwB,CAAC","sourcesContent":["// src/index.ts\n\n// ─── Types ───────────────────────────────────────────\nexport * from './types.js';\nexport {default as Type} from './type.js';\nexport {default as TypeCode} from './type-code.js';\n\n// ─── Utilities ───────────────────────────────────────\nexport * from './utilities.js';\nexport * from './functions.js';\nexport * from './string.js';\nexport * from './math.js';\nexport * from './parse.js';\nexport {default as CancellablePromise} from \"./cancellable-promise.js\";\n\n// ─── Data Structures ────────────────────────────────\nexport {default as KeyValuePair} from './key-value-pair.js';\nexport {default as Order} from './order.js';\n\n// ─── Async & Timing ─────────────────────────────────\nexport {default as Timer} from './timer.js';\nexport {default as TimeSpan} from './timespan.js';\nexport {default as Stopwatch} from './stopwatch.js';\nexport type {Result} from './result.js';\nexport {TimeTrigger, CountTrigger} from './triggers.js';\nexport {default as AsyncPoolExecutor} from './async-pool-executor.js';\n\n// ─── Patterns ────────────────────────────────────────\nexport {default as Lazy} from './lazy.js';\nexport {default as from} from './collections/from.js';\nexport {EventBus, Event} from './event-bus.js';\nexport {default as Range} from './range.js';\n\n// ─── Draft ────────────────────────────────────────\nexport {default as draft} from './draft.js';\n\n// ─── Web ─────────────────────────────────────────────\nexport {default as CleanURLSearchParams} from './clean-url-search-params.js';\n/** @deprecated  */\nexport {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';\n\n\n\n// ─── Deprecated ──────────────────────────────────────\n/** @deprecated  */\nexport * from './array.js';\n/** @deprecated  */\nexport * from './collections/index.js';"]}

package/dist/web/result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.js.map

package/dist/web/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/result.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Represents success and failure outputs narrowed by `success`.\n */\nexport type Result<TSuccessOutput, TFailureOutput = undefined> =\n    | {readonly success: true; readonly output: TSuccessOutput}\n    | {readonly success: false; readonly output?: TFailureOutput};\n"]}

package/dist/web/triggers.js

@@ -0,0 +1,99 @@
+import TimeSpan from './timespan.js';
+/**
+ * Runs a callback at most once during a configured time interval.
+ */
+export class TimeTrigger {
+    constructor(callback, interval) {
+        this.callback = callback;
+        this.interval = interval;
+        this.lastRunTime = null;
+    }
+    /**
+     * Executes the callback when the configured interval has elapsed.
+     */
+    async check() {
+        const currentTime = performance.now();
+        if (this.lastRunTime === null
+            || currentTime - this.lastRunTime >= this.interval.milliseconds) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured interval.
+     */
+    async trigger() {
+        this.lastRunTime = performance.now();
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured time interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured time interval.
+     */
+    setInterval(interval) {
+        this.interval = interval;
+    }
+}
+/**
+ * Runs a callback after a configured number of checks.
+ */
+export class CountTrigger {
+    constructor(callback, interval) {
+        this.interval = 1;
+        this.checkCount = 0;
+        this.callback = callback;
+        this.setInterval(interval);
+    }
+    /**
+     * Executes the callback when the configured number of checks is reached.
+     */
+    async check() {
+        this.checkCount++;
+        if (this.checkCount >= this.interval) {
+            return { success: true, output: await this.trigger() };
+        }
+        return { success: false };
+    }
+    /**
+     * Executes the callback regardless of the configured check count.
+     */
+    async trigger() {
+        this.checkCount = 0;
+        return this.callback();
+    }
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    setCallback(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Gets the configured check interval.
+     */
+    getInterval() {
+        return this.interval;
+    }
+    /**
+     * Replaces the configured check interval.
+     *
+     * @throws {RangeError} When the interval is less than one.
+     */
+    setInterval(interval) {
+        if (interval < 1) {
+            throw new RangeError('Interval must be greater than zero.');
+        }
+        this.interval = interval;
+    }
+}
+//# sourceMappingURL=triggers.js.map

package/dist/web/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/triggers.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAGrC;;GAEG;AACH,MAAM,OAAO,WAAW;IAKpB,YAAmB,QAAkC,EAAE,QAAkB;QACrE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;eACtB,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EACjE,CAAC;YACC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CAGJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAKrB,YAAmB,QAAkC,EAAE,QAAgB;QAH/D,aAAQ,GAAW,CAAC,CAAC;QACrB,eAAU,GAAW,CAAC,CAAC;QAG3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAgB;QAC/B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ","sourcesContent":["import type {Result} from './result.js';\nimport TimeSpan from './timespan.js';\nimport type {Nullable, Supplier} from './types.js';\n\n/**\n * Runs a callback at most once during a configured time interval.\n */\nexport class TimeTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: TimeSpan;\n    private lastRunTime: Nullable<number>;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan) {\n        this.callback = callback;\n        this.interval = interval;\n        this.lastRunTime = null;\n    }\n\n    /**\n     * Executes the callback when the configured interval has elapsed.\n     */\n    public async check(): Promise<Result<T>> {\n        const currentTime = performance.now();\n\n        if (this.lastRunTime === null\n            || currentTime - this.lastRunTime >= this.interval.milliseconds\n        ) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured interval.\n     */\n    public async trigger(): Promise<T> {\n        this.lastRunTime = performance.now();\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured time interval.\n     */\n    public getInterval(): TimeSpan {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured time interval.\n     */\n    public setInterval(interval: TimeSpan): void {\n        this.interval = interval;\n    }\n\n\n}\n\n/**\n * Runs a callback after a configured number of checks.\n */\nexport class CountTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: number = 1;\n    private checkCount: number = 0;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: number) {\n        this.callback = callback;\n        this.setInterval(interval);\n    }\n\n    /**\n     * Executes the callback when the configured number of checks is reached.\n     */\n    public async check(): Promise<Result<T>> {\n        this.checkCount++;\n\n        if (this.checkCount >= this.interval) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured check count.\n     */\n    public async trigger(): Promise<T> {\n        this.checkCount = 0;\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured check interval.\n     */\n    public getInterval(): number {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured check interval.\n     *\n     * @throws {RangeError} When the interval is less than one.\n     */\n    public setInterval(interval: number): void {\n        if (interval < 1) {\n            throw new RangeError('Interval must be greater than zero.');\n        }\n\n        this.interval = interval;\n    }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develia/commons",
-  "version": "0.4.22",
+  "version": "0.4.23",
   "author": {
     "name": "Antonio Gil Espinosa",
     "email": "antonio.gil.espinosa@gmail.com",
@@ -78,12 +78,11 @@
   "scripts": {
     "clean": "rimraf dist || rm -rf dist",
     "build:esm": "tsc -p tsconfig.esm.json",
-    "build:cjs": "tsc -p tsconfig.cjs.json && node scripts/write-cjs-package.mjs",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:web": "tsc -p tsconfig.web.json",
     "build": "npm run clean && npm run build:esm && npm run build:cjs && npm run build:web",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test:package": "node scripts/verify-package.mjs",
-    "validate": "npm test && npm run build && npm run test:package",
+    "validate": "npm test && npm run build",
     "prepack": "npm run validate"
   },
   "files": [

package/src/collections/cache-dictionary.ts

@@ -46,9 +46,7 @@ export default class CacheDictionary<T> {
         if (duration === null) {
             delete this.expiration[key];
         } else {
-            const expiration = new Date();
-            expiration.setSeconds(expiration.getSeconds() + duration);
-            this.expiration[key] = expiration;
+            this.expiration[key] = this.calculateExpiration(duration);
         }
     }
 
@@ -109,8 +107,6 @@ export default class CacheDictionary<T> {
             return undefined;
         }
 
-        const expiration = new Date();
-        expiration.setSeconds(expiration.getSeconds() + duration);
-        return expiration;
+        return new Date(Date.now() + duration * 1000);
     }
 }

package/src/index.ts

@@ -21,6 +21,8 @@ export {default as Order} from './order.js';
 export {default as Timer} from './timer.js';
 export {default as TimeSpan} from './timespan.js';
 export {default as Stopwatch} from './stopwatch.js';
+export type {Result} from './result.js';
+export {TimeTrigger, CountTrigger} from './triggers.js';
 export {default as AsyncPoolExecutor} from './async-pool-executor.js';
 
 // ─── Patterns ────────────────────────────────────────

package/src/result.ts

@@ -0,0 +1,6 @@
+/**
+ * Represents success and failure outputs narrowed by `success`.
+ */
+export type Result<TSuccessOutput, TFailureOutput = undefined> =
+    | {readonly success: true; readonly output: TSuccessOutput}
+    | {readonly success: false; readonly output?: TFailureOutput};

package/src/triggers.ts

@@ -0,0 +1,126 @@
+import type {Result} from './result.js';
+import TimeSpan from './timespan.js';
+import type {Nullable, Supplier} from './types.js';
+
+/**
+ * Runs a callback at most once during a configured time interval.
+ */
+export class TimeTrigger<T> {
+    private callback: Supplier<T | Promise<T>>;
+    private interval: TimeSpan;
+    private lastRunTime: Nullable<number>;
+
+    public constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan) {
+        this.callback = callback;
+        this.interval = interval;
+        this.lastRunTime = null;
+    }
+
+    /**
+     * Executes the callback when the configured interval has elapsed.
+     */
+    public async check(): Promise<Result<T>> {
+        const currentTime = performance.now();
+
+        if (this.lastRunTime === null
+            || currentTime - this.lastRunTime >= this.interval.milliseconds
+        ) {
+            return {success: true, output: await this.trigger()};
+        }
+
+        return {success: false};
+    }
+
+    /**
+     * Executes the callback regardless of the configured interval.
+     */
+    public async trigger(): Promise<T> {
+        this.lastRunTime = performance.now();
+        return this.callback();
+    }
+
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    public setCallback(callback: Supplier<T | Promise<T>>): void {
+        this.callback = callback;
+    }
+
+    /**
+     * Gets the configured time interval.
+     */
+    public getInterval(): TimeSpan {
+        return this.interval;
+    }
+
+    /**
+     * Replaces the configured time interval.
+     */
+    public setInterval(interval: TimeSpan): void {
+        this.interval = interval;
+    }
+
+
+}
+
+/**
+ * Runs a callback after a configured number of checks.
+ */
+export class CountTrigger<T> {
+    private callback: Supplier<T | Promise<T>>;
+    private interval: number = 1;
+    private checkCount: number = 0;
+
+    public constructor(callback: Supplier<T | Promise<T>>, interval: number) {
+        this.callback = callback;
+        this.setInterval(interval);
+    }
+
+    /**
+     * Executes the callback when the configured number of checks is reached.
+     */
+    public async check(): Promise<Result<T>> {
+        this.checkCount++;
+
+        if (this.checkCount >= this.interval) {
+            return {success: true, output: await this.trigger()};
+        }
+
+        return {success: false};
+    }
+
+    /**
+     * Executes the callback regardless of the configured check count.
+     */
+    public async trigger(): Promise<T> {
+        this.checkCount = 0;
+        return this.callback();
+    }
+
+    /**
+     * Replaces the callback executed by this trigger.
+     */
+    public setCallback(callback: Supplier<T | Promise<T>>): void {
+        this.callback = callback;
+    }
+
+    /**
+     * Gets the configured check interval.
+     */
+    public getInterval(): number {
+        return this.interval;
+    }
+
+    /**
+     * Replaces the configured check interval.
+     *
+     * @throws {RangeError} When the interval is less than one.
+     */
+    public setInterval(interval: number): void {
+        if (interval < 1) {
+            throw new RangeError('Interval must be greater than zero.');
+        }
+
+        this.interval = interval;
+    }
+}

package/dist/cjs/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "commonjs"
-}