@develia/commons 0.4.22 → 0.4.24

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/debouncer.js

@@ -0,0 +1,121 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Debouncer_instances, _Debouncer_controller, _Debouncer_delayMs, _Debouncer_onSchedule, _Debouncer_onStart, _Debouncer_onSuccess, _Debouncer_onCancel, _Debouncer_onError, _Debouncer_onIdle, _Debouncer_run, _Debouncer_becomeIdle;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertValidDelay = assertValidDelay;
+const utilities_js_1 = require("./utilities.js");
+const functions_js_1 = require("./functions.js");
+/**
+ * Keeps at most one live task.
+ * Scheduling a new task cancels the previous one, whether it was still
+ * waiting or already running.
+ *
+ * @example
+ * ```ts
+ * const debouncer = new Debouncer({delayMs: 1500});
+ *
+ * debouncer.schedule(async (signal) => {
+ *     const reply = await callAI(messages, {signal});
+ *     if (signal.aborted) return;
+ *     await sendReply(reply);
+ * });
+ * ```
+ */
+class Debouncer {
+    constructor(options) {
+        _Debouncer_instances.add(this);
+        _Debouncer_controller.set(this, void 0);
+        _Debouncer_delayMs.set(this, void 0);
+        _Debouncer_onSchedule.set(this, void 0);
+        _Debouncer_onStart.set(this, void 0);
+        _Debouncer_onSuccess.set(this, void 0);
+        _Debouncer_onCancel.set(this, void 0);
+        _Debouncer_onError.set(this, void 0);
+        _Debouncer_onIdle.set(this, void 0);
+        assertValidDelay(options.delayMs);
+        __classPrivateFieldSet(this, _Debouncer_delayMs, options.delayMs, "f");
+        __classPrivateFieldSet(this, _Debouncer_onSchedule, options.onSchedule ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onStart, options.onStart ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onSuccess, options.onSuccess ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onCancel, options.onCancel ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _Debouncer_onError, options.onError ?? console.error, "f");
+        __classPrivateFieldSet(this, _Debouncer_onIdle, options.onIdle ?? functions_js_1.noop, "f");
+    }
+    /** Whether a task is waiting or running. */
+    get isPending() {
+        return __classPrivateFieldGet(this, _Debouncer_controller, "f") !== undefined;
+    }
+    /**
+     * Schedule `task`, cancelling any previous task.
+     *
+     * @param task - The task to run once the delay elapses.
+     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.
+     */
+    schedule(task, delayMs = __classPrivateFieldGet(this, _Debouncer_delayMs, "f")) {
+        assertValidDelay(delayMs);
+        if (__classPrivateFieldGet(this, _Debouncer_controller, "f") !== undefined) {
+            __classPrivateFieldGet(this, _Debouncer_controller, "f").abort();
+            __classPrivateFieldGet(this, _Debouncer_onCancel, "f").call(this);
+        }
+        const controller = new AbortController();
+        __classPrivateFieldSet(this, _Debouncer_controller, controller, "f");
+        __classPrivateFieldGet(this, _Debouncer_onSchedule, "f").call(this);
+        void __classPrivateFieldGet(this, _Debouncer_instances, "m", _Debouncer_run).call(this, task, delayMs, controller);
+    }
+    /** Cancel the current task, if any. */
+    cancel() {
+        if (__classPrivateFieldGet(this, _Debouncer_controller, "f") === undefined) {
+            return;
+        }
+        __classPrivateFieldGet(this, _Debouncer_controller, "f").abort();
+        __classPrivateFieldGet(this, _Debouncer_onCancel, "f").call(this);
+        __classPrivateFieldGet(this, _Debouncer_instances, "m", _Debouncer_becomeIdle).call(this);
+    }
+}
+_Debouncer_controller = new WeakMap(), _Debouncer_delayMs = new WeakMap(), _Debouncer_onSchedule = new WeakMap(), _Debouncer_onStart = new WeakMap(), _Debouncer_onSuccess = new WeakMap(), _Debouncer_onCancel = new WeakMap(), _Debouncer_onError = new WeakMap(), _Debouncer_onIdle = new WeakMap(), _Debouncer_instances = new WeakSet(), _Debouncer_run = async function _Debouncer_run(task, delayMs, controller) {
+    const signal = controller.signal;
+    try {
+        await (0, utilities_js_1.delay)(delayMs, signal);
+        __classPrivateFieldGet(this, _Debouncer_onStart, "f").call(this);
+        await task(signal);
+        if (!signal.aborted) {
+            __classPrivateFieldGet(this, _Debouncer_onSuccess, "f").call(this);
+        }
+    }
+    catch (error) {
+        if (!signal.aborted) {
+            __classPrivateFieldGet(this, _Debouncer_onError, "f").call(this, error);
+        }
+    }
+    finally {
+        // A replaced or cancelled task must not touch the current state.
+        if (__classPrivateFieldGet(this, _Debouncer_controller, "f") === controller) {
+            __classPrivateFieldGet(this, _Debouncer_instances, "m", _Debouncer_becomeIdle).call(this);
+        }
+    }
+}, _Debouncer_becomeIdle = function _Debouncer_becomeIdle() {
+    __classPrivateFieldSet(this, _Debouncer_controller, undefined, "f");
+    __classPrivateFieldGet(this, _Debouncer_onIdle, "f").call(this);
+};
+exports.default = Debouncer;
+/**
+ * Throw a `RangeError` unless `delayMs` is a finite number >= 0.
+ *
+ * @internal Shared with `KeyedDebouncer`; not part of the public API.
+ */
+function assertValidDelay(delayMs) {
+    if (!Number.isFinite(delayMs) || delayMs < 0) {
+        throw new RangeError(`delayMs must be a number >= 0 (received: ${delayMs})`);
+    }
+}
+//# sourceMappingURL=debouncer.js.map

package/dist/cjs/debouncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debouncer.js","sourceRoot":"","sources":["../../src/debouncer.ts"],"names":[],"mappings":"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","sourcesContent":["import {delay} from \"./utilities.js\";\nimport {noop} from \"./functions.js\";\n\n/**\n * Cancellable task. It must honour `signal`: pass it to fetch/SDKs and check\n * `signal.aborted` before producing irreversible side effects.\n */\nexport type DebouncedTask = (signal: AbortSignal) => Promise<void>;\n\n/** Options accepted by {@link Debouncer}. */\nexport interface DebouncerOptions {\n    /** Default wait, in milliseconds, before a task is executed. */\n    delayMs: number;\n    /** Called every time a task is scheduled, after any previous task has been cancelled. */\n    onSchedule?: () => void;\n    /** Called when the wait elapses and the task is about to run. */\n    onStart?: () => void;\n    /** Called when a task completes without throwing and without being cancelled. */\n    onSuccess?: () => void;\n    /** Called when a live task is cancelled, either by {@link Debouncer.cancel} or by being replaced. */\n    onCancel?: () => void;\n    /** Receives task errors. Cancellations never reach this callback. Defaults to `console.error`. */\n    onError?: (error: unknown) => void;\n    /** Called every time the debouncer goes from busy to idle. */\n    onIdle?: () => void;\n}\n\n/**\n * Keeps at most one live task.\n * Scheduling a new task cancels the previous one, whether it was still\n * waiting or already running.\n *\n * @example\n * ```ts\n * const debouncer = new Debouncer({delayMs: 1500});\n *\n * debouncer.schedule(async (signal) => {\n *     const reply = await callAI(messages, {signal});\n *     if (signal.aborted) return;\n *     await sendReply(reply);\n * });\n * ```\n */\nexport default class Debouncer {\n    #controller: AbortController | undefined;\n    readonly #delayMs: number;\n    readonly #onSchedule: () => void;\n    readonly #onStart: () => void;\n    readonly #onSuccess: () => void;\n    readonly #onCancel: () => void;\n    readonly #onError: (error: unknown) => void;\n    readonly #onIdle: () => void;\n\n    constructor(options: DebouncerOptions) {\n        assertValidDelay(options.delayMs);\n        this.#delayMs = options.delayMs;\n        this.#onSchedule = options.onSchedule ?? noop;\n        this.#onStart = options.onStart ?? noop;\n        this.#onSuccess = options.onSuccess ?? noop;\n        this.#onCancel = options.onCancel ?? noop;\n        this.#onError = options.onError ?? console.error;\n        this.#onIdle = options.onIdle ?? noop;\n    }\n\n    /** Whether a task is waiting or running. */\n    get isPending(): boolean {\n        return this.#controller !== undefined;\n    }\n\n    /**\n     * Schedule `task`, cancelling any previous task.\n     *\n     * @param task - The task to run once the delay elapses.\n     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.\n     */\n    schedule(task: DebouncedTask, delayMs: number = this.#delayMs): void {\n        assertValidDelay(delayMs);\n        if (this.#controller !== undefined) {\n            this.#controller.abort();\n            this.#onCancel();\n        }\n\n        const controller = new AbortController();\n        this.#controller = controller;\n        this.#onSchedule();\n        void this.#run(task, delayMs, controller);\n    }\n\n    /** Cancel the current task, if any. */\n    cancel(): void {\n        if (this.#controller === undefined) {\n            return;\n        }\n        this.#controller.abort();\n        this.#onCancel();\n        this.#becomeIdle();\n    }\n\n    async #run(task: DebouncedTask, delayMs: number, controller: AbortController): Promise<void> {\n        const signal = controller.signal;\n        try {\n            await delay(delayMs, signal);\n            this.#onStart();\n            await task(signal);\n            if (!signal.aborted) {\n                this.#onSuccess();\n            }\n        } catch (error) {\n            if (!signal.aborted) {\n                this.#onError(error);\n            }\n        } finally {\n            // A replaced or cancelled task must not touch the current state.\n            if (this.#controller === controller) {\n                this.#becomeIdle();\n            }\n        }\n    }\n\n    #becomeIdle(): void {\n        this.#controller = undefined;\n        this.#onIdle();\n    }\n}\n\n/**\n * Throw a `RangeError` unless `delayMs` is a finite number >= 0.\n *\n * @internal Shared with `KeyedDebouncer`; not part of the public API.\n */\nexport function assertValidDelay(delayMs: number): void {\n    if (!Number.isFinite(delayMs) || delayMs < 0) {\n        throw new RangeError(`delayMs must be a number >= 0 (received: ${delayMs})`);\n    }\n}\n"]}

package/dist/cjs/functions.js

@@ -5,7 +5,6 @@ exports.constant = constant;
 exports.noop = noop;
 exports.once = once;
 exports.memoize = memoize;
-exports.debounce = debounce;
 exports.throttle = throttle;
 exports.partial = partial;
 exports.pipe = pipe;
@@ -125,91 +124,6 @@ function memoize(fn, resolver, cache = new Map()) {
     memoized.has = (...args) => cache.has(resolveKey(...args));
     return memoized;
 }
-/**
- * Delay a function until no calls have been made for the configured wait time.
- * The latest arguments and this-context are used for the trailing execution.
- *
- * @example
- * ```ts
- * const search = debounce((query: string) => {
- *     console.log(query);
- * }, 300);
- *
- * search("com");
- * search("commons"); // only this value is printed after 300 ms
- * ```
- *
- * @example
- * ```ts
- * const track = debounce(sendAnalytics, 1000, {leading: true, trailing: false});
- *
- * track("open"); // executed immediately
- * track.cancel(); // cancel the pending debounce window
- * ```
- */
-function debounce(fn, wait, options = {}) {
-    const delay = normalizeDelay(wait);
-    const leading = options.leading ?? false;
-    const trailing = options.trailing ?? true;
-    let timer;
-    let lastArgs;
-    let lastThis;
-    let result;
-    const invoke = () => {
-        const args = lastArgs;
-        const context = lastThis;
-        lastArgs = undefined;
-        lastThis = undefined;
-        result = fn.apply(context, args);
-        return result;
-    };
-    const expire = () => {
-        timer = undefined;
-        if (trailing && lastArgs) {
-            invoke();
-        }
-        else {
-            lastArgs = undefined;
-            lastThis = undefined;
-        }
-    };
-    const start = () => {
-        timer = setTimeout(expire, delay);
-    };
-    const debounced = function (...args) {
-        const invokeLeading = leading && timer === undefined;
-        lastArgs = args;
-        lastThis = this;
-        if (timer !== undefined) {
-            clearTimeout(timer);
-        }
-        start();
-        if (invokeLeading) {
-            return invoke();
-        }
-        return result;
-    };
-    debounced.cancel = () => {
-        if (timer !== undefined) {
-            clearTimeout(timer);
-        }
-        timer = undefined;
-        lastArgs = undefined;
-        lastThis = undefined;
-    };
-    debounced.flush = () => {
-        if (timer !== undefined) {
-            clearTimeout(timer);
-            timer = undefined;
-            if (lastArgs && trailing) {
-                return invoke();
-            }
-        }
-        return result;
-    };
-    debounced.pending = () => timer !== undefined;
-    return debounced;
-}
 /**
  * Limit how often a function can run during a time window.
  * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.

package/dist/cjs/functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/functions.ts"],"names":[],"mappings":"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","sourcesContent":["type AnyFunction = (this: any, ...args: any[]) => any;\ntype TimerHandle = ReturnType<typeof setTimeout>;\n\n/** Options that control when a debounced function is executed. */\nexport interface DebounceOptions {\n    /** Execute on the first call in a debounce window. Defaults to false. */\n    leading?: boolean;\n    /** Execute after the debounce window using the latest arguments. Defaults to true. */\n    trailing?: boolean;\n}\n\n/** Options that control when a throttled function is executed. */\nexport interface ThrottleOptions {\n    /** Execute immediately on the first call in a throttle window. Defaults to true. */\n    leading?: boolean;\n    /** Execute once more at the end of the throttle window using the latest arguments. Defaults to true. */\n    trailing?: boolean;\n}\n\n/**\n * A delayed function returned by {@link debounce} or {@link throttle}.\n *\n * @example\n * ```ts\n * const saveLater = debounce(save, 250);\n * saveLater();\n *\n * if (saveLater.pending()) {\n *     saveLater.flush();\n * }\n * ```\n */\nexport type DeferredFunction<F extends AnyFunction> = ((\n    this: ThisParameterType<F>,\n    ...args: Parameters<F>\n) => ReturnType<F> | undefined) & {\n    /** Cancel the scheduled call and forget the latest arguments. */\n    cancel(): void;\n    /** Execute the scheduled trailing call immediately, when one exists. */\n    flush(): ReturnType<F> | undefined;\n    /** Return true while a trailing call is scheduled. */\n    pending(): boolean;\n};\n\n/**\n * A memoized function with helpers for inspecting and invalidating its cache.\n *\n * @example\n * ```ts\n * const getUser = memoize((id: string) => fetchUser(id));\n *\n * getUser(\"42\");\n * getUser.has(\"42\"); // true\n * getUser.delete(\"42\");\n * ```\n */\nexport type MemoizedFunction<F extends AnyFunction, K> = ((\n    this: ThisParameterType<F>,\n    ...args: Parameters<F>\n) => ReturnType<F>) & {\n    /** The backing cache used by the memoized function. */\n    readonly cache: Map<K, ReturnType<F>>;\n    /** Remove every cached value. */\n    clear(): void;\n    /** Remove the cached value for the key resolved from the provided arguments. */\n    delete(...args: Parameters<F>): boolean;\n    /** Return true when a cached value exists for the key resolved from the provided arguments. */\n    has(...args: Parameters<F>): boolean;\n};\n\ntype Unary<T, R> = (arg: T) => R;\n\n/**\n * Return the received value unchanged.\n * Useful as a default mapper, placeholder callback, or neutral transform in a pipeline.\n *\n * @example\n * ```ts\n * identity(5); // 5\n *\n * const value = {name: \"commons\"};\n * identity(value) === value; // true\n * ```\n */\nexport function identity<T>(value: T): T {\n    return value;\n}\n\n/**\n * Create a function that always returns the same value.\n *\n * @example\n * ```ts\n * const getAnswer = constant(42);\n *\n * getAnswer(); // 42\n * getAnswer(); // 42\n * ```\n */\nexport function constant<T>(value: T): () => T {\n    return () => value;\n}\n\n/**\n * Do nothing and return undefined.\n * Useful as a safe default callback.\n *\n * @example\n * ```ts\n * const onComplete = options.onComplete ?? noop;\n * onComplete();\n * ```\n */\nexport function noop(): void {\n    // Intentionally empty.\n}\n\n/**\n * Create a function that can be executed only once.\n * Later calls return the result from the first execution without calling the original function again.\n *\n * @example\n * ```ts\n * const initialize = once(() => ({connected: true}));\n *\n * const first = initialize();\n * const second = initialize();\n * first === second; // true\n * ```\n */\nexport function once<F extends AnyFunction>(fn: F): F {\n    let called = false;\n    let result: ReturnType<F>;\n\n    return function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n        if (!called) {\n            called = true;\n            result = fn.apply(this, args);\n        }\n        return result;\n    } as F;\n}\n\n/**\n * Cache the result of a function and reuse it for calls with the same resolved key.\n * By default, the first argument is used as the cache key.\n *\n * @example\n * ```ts\n * const double = memoize((value: number) => value * 2);\n *\n * double(4); // 8, computed\n * double(4); // 8, read from cache\n * double.has(4); // true\n * ```\n *\n * @example\n * ```ts\n * const sum = memoize(\n *     (left: number, right: number) => left + right,\n *     (left, right) => `${left}:${right}`,\n * );\n *\n * sum(2, 3); // 5\n * sum.delete(2, 3); // true\n * sum.clear();\n * ```\n */\nexport function memoize<F extends AnyFunction, K = Parameters<F>[0]>(\n    fn: F,\n    resolver?: (...args: Parameters<F>) => K,\n    cache: Map<K, ReturnType<F>> = new Map<K, ReturnType<F>>()\n): MemoizedFunction<F, K> {\n    const resolveKey = (...args: Parameters<F>): K => {\n        if (resolver) return resolver(...args);\n        return args[0] as K;\n    };\n\n    const memoized = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n        const key = resolveKey(...args);\n        if (cache.has(key)) {\n            return cache.get(key)!;\n        }\n\n        const value = fn.apply(this, args);\n        cache.set(key, value);\n        return value;\n    } as MemoizedFunction<F, K>;\n\n    Object.defineProperty(memoized, \"cache\", {\n        value: cache,\n        enumerable: false,\n    });\n\n    memoized.clear = () => cache.clear();\n    memoized.delete = (...args: Parameters<F>) => cache.delete(resolveKey(...args));\n    memoized.has = (...args: Parameters<F>) => cache.has(resolveKey(...args));\n\n    return memoized;\n}\n\n/**\n * Delay a function until no calls have been made for the configured wait time.\n * The latest arguments and this-context are used for the trailing execution.\n *\n * @example\n * ```ts\n * const search = debounce((query: string) => {\n *     console.log(query);\n * }, 300);\n *\n * search(\"com\");\n * search(\"commons\"); // only this value is printed after 300 ms\n * ```\n *\n * @example\n * ```ts\n * const track = debounce(sendAnalytics, 1000, {leading: true, trailing: false});\n *\n * track(\"open\"); // executed immediately\n * track.cancel(); // cancel the pending debounce window\n * ```\n */\nexport function debounce<F extends AnyFunction>(\n    fn: F,\n    wait: number,\n    options: DebounceOptions = {}\n): DeferredFunction<F> {\n    const delay = normalizeDelay(wait);\n    const leading = options.leading ?? false;\n    const trailing = options.trailing ?? true;\n\n    let timer: TimerHandle | undefined;\n    let lastArgs: Parameters<F> | undefined;\n    let lastThis: ThisParameterType<F> | undefined;\n    let result: ReturnType<F> | undefined;\n\n    const invoke = (): ReturnType<F> => {\n        const args = lastArgs!;\n        const context = lastThis!;\n        lastArgs = undefined;\n        lastThis = undefined;\n        result = fn.apply(context, args);\n        return result as ReturnType<F>;\n    };\n\n    const expire = (): void => {\n        timer = undefined;\n        if (trailing && lastArgs) {\n            invoke();\n        } else {\n            lastArgs = undefined;\n            lastThis = undefined;\n        }\n    };\n\n    const start = (): void => {\n        timer = setTimeout(expire, delay);\n    };\n\n    const debounced = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> | undefined {\n        const invokeLeading = leading && timer === undefined;\n        lastArgs = args;\n        lastThis = this;\n\n        if (timer !== undefined) {\n            clearTimeout(timer);\n        }\n        start();\n\n        if (invokeLeading) {\n            return invoke();\n        }\n\n        return result;\n    } as DeferredFunction<F>;\n\n    debounced.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n        }\n        timer = undefined;\n        lastArgs = undefined;\n        lastThis = undefined;\n    };\n\n    debounced.flush = (): ReturnType<F> | undefined => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n            if (lastArgs && trailing) {\n                return invoke();\n            }\n        }\n        return result;\n    };\n\n    debounced.pending = (): boolean => timer !== undefined;\n\n    return debounced;\n}\n\n/**\n * Limit how often a function can run during a time window.\n * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.\n *\n * @example\n * ```ts\n * const onScroll = throttle(() => {\n *     console.log(window.scrollY);\n * }, 100);\n *\n * window.addEventListener(\"scroll\", onScroll);\n * ```\n *\n * @example\n * ```ts\n * const refresh = throttle(loadData, 500, {leading: false});\n *\n * refresh(); // scheduled instead of executed immediately\n * refresh.flush(); // execute the scheduled call now\n * ```\n */\nexport function throttle<F extends AnyFunction>(\n    fn: F,\n    wait: number,\n    options: ThrottleOptions = {}\n): DeferredFunction<F> {\n    const delay = normalizeDelay(wait);\n    const leading = options.leading ?? true;\n    const trailing = options.trailing ?? true;\n\n    let timer: TimerHandle | undefined;\n    let lastArgs: Parameters<F> | undefined;\n    let lastThis: ThisParameterType<F> | undefined;\n    let lastInvokeTime = 0;\n    let hasInvoked = false;\n    let result: ReturnType<F> | undefined;\n\n    const invoke = (time: number): ReturnType<F> => {\n        const args = lastArgs!;\n        const context = lastThis!;\n        lastArgs = undefined;\n        lastThis = undefined;\n        hasInvoked = true;\n        lastInvokeTime = time;\n        result = fn.apply(context, args);\n        return result as ReturnType<F>;\n    };\n\n    const expire = (): void => {\n        timer = undefined;\n        if (trailing && lastArgs) {\n            invoke(Date.now());\n        } else {\n            lastArgs = undefined;\n            lastThis = undefined;\n        }\n    };\n\n    const throttled = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> | undefined {\n        const now = Date.now();\n        lastArgs = args;\n        lastThis = this;\n\n        if (!hasInvoked) {\n            if (leading) {\n                return invoke(now);\n            }\n            hasInvoked = true;\n            lastInvokeTime = now;\n        }\n\n        const remaining = delay - (now - lastInvokeTime);\n        if (remaining <= 0 || remaining > delay) {\n            if (timer !== undefined) {\n                clearTimeout(timer);\n                timer = undefined;\n            }\n            return invoke(now);\n        }\n\n        if (timer === undefined && trailing) {\n            timer = setTimeout(expire, remaining);\n        }\n\n        return result;\n    } as DeferredFunction<F>;\n\n    throttled.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n        }\n        timer = undefined;\n        lastArgs = undefined;\n        lastThis = undefined;\n        lastInvokeTime = 0;\n        hasInvoked = false;\n    };\n\n    throttled.flush = (): ReturnType<F> | undefined => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n            if (lastArgs && trailing) {\n                return invoke(Date.now());\n            }\n        }\n        return result;\n    };\n\n    throttled.pending = (): boolean => timer !== undefined;\n\n    return throttled;\n}\n\n/**\n * Create a function with one or more arguments already provided.\n * Later arguments are appended after the preset arguments.\n *\n * @example\n * ```ts\n * const sum = (a: number, b: number, c: number) => a + b + c;\n * const addFive = partial(sum, 2, 3);\n *\n * addFive(4); // 9\n * ```\n */\nexport function partial<F extends AnyFunction>(\n    fn: F,\n    ...presetArgs: unknown[]\n): (...laterArgs: unknown[]) => ReturnType<F> {\n    return function (this: ThisParameterType<F>, ...laterArgs: unknown[]): ReturnType<F> {\n        return fn.apply(this, [...presetArgs, ...laterArgs] as Parameters<F>);\n    };\n}\n\n/**\n * Compose unary functions from left to right.\n * The first function receives the original arguments, and each next function receives the previous result.\n *\n * @example\n * ```ts\n * const transform = pipe(\n *     (value: number) => value + 1,\n *     (value: number) => value * 2,\n * );\n *\n * transform(2); // 6\n * ```\n */\nexport function pipe<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function pipe<A, B, C>(ab: Unary<A, B>, bc: Unary<B, C>): Unary<A, C>;\nexport function pipe<A, B, C, D>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): Unary<A, D>;\nexport function pipe<A, B, C, D, E>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>): Unary<A, E>;\nexport function pipe(...fns: AnyFunction[]): AnyFunction {\n    return createFlow(fns);\n}\n\n/**\n * Compose unary functions from right to left.\n * The rightmost function receives the original arguments, and each function to its left receives the previous result.\n *\n * @example\n * ```ts\n * const transform = compose(\n *     (value: number) => value + 1,\n *     (value: number) => value * 2,\n * );\n *\n * transform(2); // 5\n * ```\n */\nexport function compose<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function compose<A, B, C>(bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, C>;\nexport function compose<A, B, C, D>(cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, D>;\nexport function compose<A, B, C, D, E>(de: Unary<D, E>, cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, E>;\nexport function compose(...fns: AnyFunction[]): AnyFunction {\n    return createFlow(fns.slice().reverse());\n}\n\nfunction createFlow(fns: AnyFunction[]): AnyFunction {\n    if (fns.length === 0) return identity;\n\n    return function (this: any, ...args: any[]): unknown {\n        let result = fns[0].apply(this, args);\n        for (let i = 1; i < fns.length; i++) {\n            result = fns[i].call(this, result);\n        }\n        return result;\n    };\n}\n\nfunction normalizeDelay(wait: number): number {\n    return Number.isFinite(wait) ? Math.max(0, wait) : 0;\n}"]}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/functions.ts"],"names":[],"mappings":"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","sourcesContent":["type AnyFunction = (this: any, ...args: any[]) => any;\ntype TimerHandle = ReturnType<typeof setTimeout>;\n\n/** Options that control when a throttled function is executed. */\nexport interface ThrottleOptions {\n    /** Execute immediately on the first call in a throttle window. Defaults to true. */\n    leading?: boolean;\n    /** Execute once more at the end of the throttle window using the latest arguments. Defaults to true. */\n    trailing?: boolean;\n}\n\n/**\n * A delayed function returned by {@link throttle}.\n *\n * @example\n * ```ts\n * const refresh = throttle(loadData, 250);\n * refresh();\n *\n * if (refresh.pending()) {\n *     refresh.flush();\n * }\n * ```\n */\nexport type DeferredFunction<F extends AnyFunction> = ((\n    this: ThisParameterType<F>,\n    ...args: Parameters<F>\n) => ReturnType<F> | undefined) & {\n    /** Cancel the scheduled call and forget the latest arguments. */\n    cancel(): void;\n    /** Execute the scheduled trailing call immediately, when one exists. */\n    flush(): ReturnType<F> | undefined;\n    /** Return true while a trailing call is scheduled. */\n    pending(): boolean;\n};\n\n/**\n * A memoized function with helpers for inspecting and invalidating its cache.\n *\n * @example\n * ```ts\n * const getUser = memoize((id: string) => fetchUser(id));\n *\n * getUser(\"42\");\n * getUser.has(\"42\"); // true\n * getUser.delete(\"42\");\n * ```\n */\nexport type MemoizedFunction<F extends AnyFunction, K> = ((\n    this: ThisParameterType<F>,\n    ...args: Parameters<F>\n) => ReturnType<F>) & {\n    /** The backing cache used by the memoized function. */\n    readonly cache: Map<K, ReturnType<F>>;\n    /** Remove every cached value. */\n    clear(): void;\n    /** Remove the cached value for the key resolved from the provided arguments. */\n    delete(...args: Parameters<F>): boolean;\n    /** Return true when a cached value exists for the key resolved from the provided arguments. */\n    has(...args: Parameters<F>): boolean;\n};\n\ntype Unary<T, R> = (arg: T) => R;\n\n/**\n * Return the received value unchanged.\n * Useful as a default mapper, placeholder callback, or neutral transform in a pipeline.\n *\n * @example\n * ```ts\n * identity(5); // 5\n *\n * const value = {name: \"commons\"};\n * identity(value) === value; // true\n * ```\n */\nexport function identity<T>(value: T): T {\n    return value;\n}\n\n/**\n * Create a function that always returns the same value.\n *\n * @example\n * ```ts\n * const getAnswer = constant(42);\n *\n * getAnswer(); // 42\n * getAnswer(); // 42\n * ```\n */\nexport function constant<T>(value: T): () => T {\n    return () => value;\n}\n\n/**\n * Do nothing and return undefined.\n * Useful as a safe default callback.\n *\n * @example\n * ```ts\n * const onComplete = options.onComplete ?? noop;\n * onComplete();\n * ```\n */\nexport function noop(): void {\n    // Intentionally empty.\n}\n\n/**\n * Create a function that can be executed only once.\n * Later calls return the result from the first execution without calling the original function again.\n *\n * @example\n * ```ts\n * const initialize = once(() => ({connected: true}));\n *\n * const first = initialize();\n * const second = initialize();\n * first === second; // true\n * ```\n */\nexport function once<F extends AnyFunction>(fn: F): F {\n    let called = false;\n    let result: ReturnType<F>;\n\n    return function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n        if (!called) {\n            called = true;\n            result = fn.apply(this, args);\n        }\n        return result;\n    } as F;\n}\n\n/**\n * Cache the result of a function and reuse it for calls with the same resolved key.\n * By default, the first argument is used as the cache key.\n *\n * @example\n * ```ts\n * const double = memoize((value: number) => value * 2);\n *\n * double(4); // 8, computed\n * double(4); // 8, read from cache\n * double.has(4); // true\n * ```\n *\n * @example\n * ```ts\n * const sum = memoize(\n *     (left: number, right: number) => left + right,\n *     (left, right) => `${left}:${right}`,\n * );\n *\n * sum(2, 3); // 5\n * sum.delete(2, 3); // true\n * sum.clear();\n * ```\n */\nexport function memoize<F extends AnyFunction, K = Parameters<F>[0]>(\n    fn: F,\n    resolver?: (...args: Parameters<F>) => K,\n    cache: Map<K, ReturnType<F>> = new Map<K, ReturnType<F>>()\n): MemoizedFunction<F, K> {\n    const resolveKey = (...args: Parameters<F>): K => {\n        if (resolver) return resolver(...args);\n        return args[0] as K;\n    };\n\n    const memoized = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> {\n        const key = resolveKey(...args);\n        if (cache.has(key)) {\n            return cache.get(key)!;\n        }\n\n        const value = fn.apply(this, args);\n        cache.set(key, value);\n        return value;\n    } as MemoizedFunction<F, K>;\n\n    Object.defineProperty(memoized, \"cache\", {\n        value: cache,\n        enumerable: false,\n    });\n\n    memoized.clear = () => cache.clear();\n    memoized.delete = (...args: Parameters<F>) => cache.delete(resolveKey(...args));\n    memoized.has = (...args: Parameters<F>) => cache.has(resolveKey(...args));\n\n    return memoized;\n}\n\n/**\n * Limit how often a function can run during a time window.\n * Calls made while the function is throttled can optionally be replayed once at the end with the latest arguments.\n *\n * @example\n * ```ts\n * const onScroll = throttle(() => {\n *     console.log(window.scrollY);\n * }, 100);\n *\n * window.addEventListener(\"scroll\", onScroll);\n * ```\n *\n * @example\n * ```ts\n * const refresh = throttle(loadData, 500, {leading: false});\n *\n * refresh(); // scheduled instead of executed immediately\n * refresh.flush(); // execute the scheduled call now\n * ```\n */\nexport function throttle<F extends AnyFunction>(\n    fn: F,\n    wait: number,\n    options: ThrottleOptions = {}\n): DeferredFunction<F> {\n    const delay = normalizeDelay(wait);\n    const leading = options.leading ?? true;\n    const trailing = options.trailing ?? true;\n\n    let timer: TimerHandle | undefined;\n    let lastArgs: Parameters<F> | undefined;\n    let lastThis: ThisParameterType<F> | undefined;\n    let lastInvokeTime = 0;\n    let hasInvoked = false;\n    let result: ReturnType<F> | undefined;\n\n    const invoke = (time: number): ReturnType<F> => {\n        const args = lastArgs!;\n        const context = lastThis!;\n        lastArgs = undefined;\n        lastThis = undefined;\n        hasInvoked = true;\n        lastInvokeTime = time;\n        result = fn.apply(context, args);\n        return result as ReturnType<F>;\n    };\n\n    const expire = (): void => {\n        timer = undefined;\n        if (trailing && lastArgs) {\n            invoke(Date.now());\n        } else {\n            lastArgs = undefined;\n            lastThis = undefined;\n        }\n    };\n\n    const throttled = function (this: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F> | undefined {\n        const now = Date.now();\n        lastArgs = args;\n        lastThis = this;\n\n        if (!hasInvoked) {\n            if (leading) {\n                return invoke(now);\n            }\n            hasInvoked = true;\n            lastInvokeTime = now;\n        }\n\n        const remaining = delay - (now - lastInvokeTime);\n        if (remaining <= 0 || remaining > delay) {\n            if (timer !== undefined) {\n                clearTimeout(timer);\n                timer = undefined;\n            }\n            return invoke(now);\n        }\n\n        if (timer === undefined && trailing) {\n            timer = setTimeout(expire, remaining);\n        }\n\n        return result;\n    } as DeferredFunction<F>;\n\n    throttled.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n        }\n        timer = undefined;\n        lastArgs = undefined;\n        lastThis = undefined;\n        lastInvokeTime = 0;\n        hasInvoked = false;\n    };\n\n    throttled.flush = (): ReturnType<F> | undefined => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n            if (lastArgs && trailing) {\n                return invoke(Date.now());\n            }\n        }\n        return result;\n    };\n\n    throttled.pending = (): boolean => timer !== undefined;\n\n    return throttled;\n}\n\n/**\n * Create a function with one or more arguments already provided.\n * Later arguments are appended after the preset arguments.\n *\n * @example\n * ```ts\n * const sum = (a: number, b: number, c: number) => a + b + c;\n * const addFive = partial(sum, 2, 3);\n *\n * addFive(4); // 9\n * ```\n */\nexport function partial<F extends AnyFunction>(\n    fn: F,\n    ...presetArgs: unknown[]\n): (...laterArgs: unknown[]) => ReturnType<F> {\n    return function (this: ThisParameterType<F>, ...laterArgs: unknown[]): ReturnType<F> {\n        return fn.apply(this, [...presetArgs, ...laterArgs] as Parameters<F>);\n    };\n}\n\n/**\n * Compose unary functions from left to right.\n * The first function receives the original arguments, and each next function receives the previous result.\n *\n * @example\n * ```ts\n * const transform = pipe(\n *     (value: number) => value + 1,\n *     (value: number) => value * 2,\n * );\n *\n * transform(2); // 6\n * ```\n */\nexport function pipe<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function pipe<A, B, C>(ab: Unary<A, B>, bc: Unary<B, C>): Unary<A, C>;\nexport function pipe<A, B, C, D>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): Unary<A, D>;\nexport function pipe<A, B, C, D, E>(ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>): Unary<A, E>;\nexport function pipe(...fns: AnyFunction[]): AnyFunction {\n    return createFlow(fns);\n}\n\n/**\n * Compose unary functions from right to left.\n * The rightmost function receives the original arguments, and each function to its left receives the previous result.\n *\n * @example\n * ```ts\n * const transform = compose(\n *     (value: number) => value + 1,\n *     (value: number) => value * 2,\n * );\n *\n * transform(2); // 5\n * ```\n */\nexport function compose<A, B>(ab: Unary<A, B>): Unary<A, B>;\nexport function compose<A, B, C>(bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, C>;\nexport function compose<A, B, C, D>(cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, D>;\nexport function compose<A, B, C, D, E>(de: Unary<D, E>, cd: Unary<C, D>, bc: Unary<B, C>, ab: Unary<A, B>): Unary<A, E>;\nexport function compose(...fns: AnyFunction[]): AnyFunction {\n    return createFlow(fns.slice().reverse());\n}\n\nfunction createFlow(fns: AnyFunction[]): AnyFunction {\n    if (fns.length === 0) return identity;\n\n    return function (this: any, ...args: any[]): unknown {\n        let result = fns[0].apply(this, args);\n        for (let i = 1; i < fns.length; i++) {\n            result = fns[i].call(this, result);\n        }\n        return result;\n    };\n}\n\nfunction normalizeDelay(wait: number): number {\n    return Number.isFinite(wait) ? Math.max(0, wait) : 0;\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.KeyedDebouncer = exports.Debouncer = 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,8 +45,15 @@ 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; } });
+var debouncer_js_1 = require("./debouncer.js");
+Object.defineProperty(exports, "Debouncer", { enumerable: true, get: function () { return __importDefault(debouncer_js_1).default; } });
+var keyed_debouncer_js_1 = require("./keyed-debouncer.js");
+Object.defineProperty(exports, "KeyedDebouncer", { enumerable: true, get: function () { return __importDefault(keyed_debouncer_js_1).default; } });
 // ─── Patterns ────────────────────────────────────────
 var lazy_js_1 = require("./lazy.js");
 Object.defineProperty(exports, "Lazy", { enumerable: true, get: function () { return __importDefault(lazy_js_1).default; } });

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;AACpC,+CAAoD;AAA5C,0HAAA,OAAO,OAAa;AAE5B,2DAA+D;AAAvD,qIAAA,OAAO,OAAkB;AAGjC,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';\nexport {default as Debouncer} from './debouncer.js';\nexport type {DebouncedTask, DebouncerOptions} from './debouncer.js';\nexport {default as KeyedDebouncer} from './keyed-debouncer.js';\nexport type {KeyedDebouncerOptions} from './keyed-debouncer.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/keyed-debouncer.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _KeyedDebouncer_instances, _KeyedDebouncer_debouncers, _KeyedDebouncer_delayMs, _KeyedDebouncer_onSchedule, _KeyedDebouncer_onStart, _KeyedDebouncer_onSuccess, _KeyedDebouncer_onCancel, _KeyedDebouncer_onError, _KeyedDebouncer_onIdle, _KeyedDebouncer_create;
+Object.defineProperty(exports, "__esModule", { value: true });
+const debouncer_js_1 = __importStar(require("./debouncer.js"));
+const functions_js_1 = require("./functions.js");
+/**
+ * An independent {@link Debouncer} per key.
+ * Debouncers only exist for keys with pending work: each one is created when
+ * its first task is scheduled and removed as soon as it becomes idle.
+ *
+ * @example
+ * ```ts
+ * const debouncer = new KeyedDebouncer<string>({delayMs: 1500});
+ *
+ * debouncer.schedule(chatId, async (signal) => {
+ *     const pending = await store.getPending(chatId);
+ *     const reply = await callAI(pending, {signal});
+ *     if (signal.aborted) return;
+ *     await sendReply(chatId, reply);
+ * });
+ * ```
+ */
+class KeyedDebouncer {
+    constructor(options) {
+        _KeyedDebouncer_instances.add(this);
+        _KeyedDebouncer_debouncers.set(this, new Map());
+        _KeyedDebouncer_delayMs.set(this, void 0);
+        _KeyedDebouncer_onSchedule.set(this, void 0);
+        _KeyedDebouncer_onStart.set(this, void 0);
+        _KeyedDebouncer_onSuccess.set(this, void 0);
+        _KeyedDebouncer_onCancel.set(this, void 0);
+        _KeyedDebouncer_onError.set(this, void 0);
+        _KeyedDebouncer_onIdle.set(this, void 0);
+        (0, debouncer_js_1.assertValidDelay)(options.delayMs);
+        __classPrivateFieldSet(this, _KeyedDebouncer_delayMs, options.delayMs, "f");
+        __classPrivateFieldSet(this, _KeyedDebouncer_onSchedule, options.onSchedule ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _KeyedDebouncer_onStart, options.onStart ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _KeyedDebouncer_onSuccess, options.onSuccess ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _KeyedDebouncer_onCancel, options.onCancel ?? functions_js_1.noop, "f");
+        __classPrivateFieldSet(this, _KeyedDebouncer_onError, options.onError ?? console.error, "f");
+        __classPrivateFieldSet(this, _KeyedDebouncer_onIdle, options.onIdle ?? functions_js_1.noop, "f");
+    }
+    /** Number of keys with a task waiting or running. */
+    get size() {
+        return __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").size;
+    }
+    /**
+     * Schedule `task` for `key`, cancelling any previous task of that key.
+     *
+     * @param key - The key whose task is replaced.
+     * @param task - The task to run once the delay elapses.
+     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.
+     */
+    schedule(key, task, delayMs) {
+        const existing = __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").get(key);
+        if (existing !== undefined) {
+            existing.schedule(task, delayMs);
+            return;
+        }
+        // Validate first so an invalid delay never registers the key.
+        (0, debouncer_js_1.assertValidDelay)(delayMs ?? __classPrivateFieldGet(this, _KeyedDebouncer_delayMs, "f"));
+        const debouncer = __classPrivateFieldGet(this, _KeyedDebouncer_instances, "m", _KeyedDebouncer_create).call(this, key);
+        __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").set(key, debouncer);
+        debouncer.schedule(task, delayMs);
+    }
+    /** Cancel the task of `key`, if any. */
+    cancel(key) {
+        __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").get(key)?.cancel();
+    }
+    /** Cancel every task. Useful when shutting the process down. */
+    cancelAll() {
+        // Copy first: cancelling removes the debouncer from the map.
+        for (const debouncer of [...__classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").values()]) {
+            debouncer.cancel();
+        }
+    }
+    /** Whether a task is waiting or running for `key`. */
+    isPending(key) {
+        return __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").has(key);
+    }
+}
+_KeyedDebouncer_debouncers = new WeakMap(), _KeyedDebouncer_delayMs = new WeakMap(), _KeyedDebouncer_onSchedule = new WeakMap(), _KeyedDebouncer_onStart = new WeakMap(), _KeyedDebouncer_onSuccess = new WeakMap(), _KeyedDebouncer_onCancel = new WeakMap(), _KeyedDebouncer_onError = new WeakMap(), _KeyedDebouncer_onIdle = new WeakMap(), _KeyedDebouncer_instances = new WeakSet(), _KeyedDebouncer_create = function _KeyedDebouncer_create(key) {
+    const debouncer = new debouncer_js_1.default({
+        delayMs: __classPrivateFieldGet(this, _KeyedDebouncer_delayMs, "f"),
+        onSchedule: () => __classPrivateFieldGet(this, _KeyedDebouncer_onSchedule, "f").call(this, key),
+        onStart: () => __classPrivateFieldGet(this, _KeyedDebouncer_onStart, "f").call(this, key),
+        onSuccess: () => __classPrivateFieldGet(this, _KeyedDebouncer_onSuccess, "f").call(this, key),
+        onCancel: () => __classPrivateFieldGet(this, _KeyedDebouncer_onCancel, "f").call(this, key),
+        onError: (error) => __classPrivateFieldGet(this, _KeyedDebouncer_onError, "f").call(this, error, key),
+        onIdle: () => {
+            if (__classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").get(key) === debouncer) {
+                __classPrivateFieldGet(this, _KeyedDebouncer_debouncers, "f").delete(key);
+                __classPrivateFieldGet(this, _KeyedDebouncer_onIdle, "f").call(this, key);
+            }
+        },
+    });
+    return debouncer;
+};
+exports.default = KeyedDebouncer;
+//# sourceMappingURL=keyed-debouncer.js.map

package/dist/cjs/keyed-debouncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-debouncer.js","sourceRoot":"","sources":["../../src/keyed-debouncer.ts"],"names":[],"mappings":"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","sourcesContent":["import Debouncer, {assertValidDelay, type DebouncedTask} from \"./debouncer.js\";\nimport {noop} from \"./functions.js\";\n\n/** Options accepted by {@link KeyedDebouncer}. Every callback receives the affected key. */\nexport interface KeyedDebouncerOptions<K> {\n    /** Default wait, in milliseconds, before a task is executed. */\n    delayMs: number;\n    /** Called every time a task is scheduled for `key`, after any previous task of that key has been cancelled. */\n    onSchedule?: (key: K) => void;\n    /** Called when the wait elapses and the task of `key` is about to run. */\n    onStart?: (key: K) => void;\n    /** Called when the task of `key` completes without throwing and without being cancelled. */\n    onSuccess?: (key: K) => void;\n    /** Called when a live task of `key` is cancelled, either explicitly or by being replaced. */\n    onCancel?: (key: K) => void;\n    /** Receives task errors. Cancellations never reach this callback. Defaults to `console.error`. */\n    onError?: (error: unknown, key: K) => void;\n    /** Called when `key` has no more pending work, after it has been removed from the debouncer. */\n    onIdle?: (key: K) => void;\n}\n\n/**\n * An independent {@link Debouncer} per key.\n * Debouncers only exist for keys with pending work: each one is created when\n * its first task is scheduled and removed as soon as it becomes idle.\n *\n * @example\n * ```ts\n * const debouncer = new KeyedDebouncer<string>({delayMs: 1500});\n *\n * debouncer.schedule(chatId, async (signal) => {\n *     const pending = await store.getPending(chatId);\n *     const reply = await callAI(pending, {signal});\n *     if (signal.aborted) return;\n *     await sendReply(chatId, reply);\n * });\n * ```\n */\nexport default class KeyedDebouncer<K = string> {\n    readonly #debouncers = new Map<K, Debouncer>();\n    readonly #delayMs: number;\n    readonly #onSchedule: (key: K) => void;\n    readonly #onStart: (key: K) => void;\n    readonly #onSuccess: (key: K) => void;\n    readonly #onCancel: (key: K) => void;\n    readonly #onError: (error: unknown, key: K) => void;\n    readonly #onIdle: (key: K) => void;\n\n    constructor(options: KeyedDebouncerOptions<K>) {\n        assertValidDelay(options.delayMs);\n        this.#delayMs = options.delayMs;\n        this.#onSchedule = options.onSchedule ?? noop;\n        this.#onStart = options.onStart ?? noop;\n        this.#onSuccess = options.onSuccess ?? noop;\n        this.#onCancel = options.onCancel ?? noop;\n        this.#onError = options.onError ?? console.error;\n        this.#onIdle = options.onIdle ?? noop;\n    }\n\n    /** Number of keys with a task waiting or running. */\n    get size(): number {\n        return this.#debouncers.size;\n    }\n\n    /**\n     * Schedule `task` for `key`, cancelling any previous task of that key.\n     *\n     * @param key - The key whose task is replaced.\n     * @param task - The task to run once the delay elapses.\n     * @param delayMs - Wait for this task only. Defaults to the configured `delayMs`.\n     */\n    schedule(key: K, task: DebouncedTask, delayMs?: number): void {\n        const existing = this.#debouncers.get(key);\n        if (existing !== undefined) {\n            existing.schedule(task, delayMs);\n            return;\n        }\n\n        // Validate first so an invalid delay never registers the key.\n        assertValidDelay(delayMs ?? this.#delayMs);\n        const debouncer = this.#create(key);\n        this.#debouncers.set(key, debouncer);\n        debouncer.schedule(task, delayMs);\n    }\n\n    /** Cancel the task of `key`, if any. */\n    cancel(key: K): void {\n        this.#debouncers.get(key)?.cancel();\n    }\n\n    /** Cancel every task. Useful when shutting the process down. */\n    cancelAll(): void {\n        // Copy first: cancelling removes the debouncer from the map.\n        for (const debouncer of [...this.#debouncers.values()]) {\n            debouncer.cancel();\n        }\n    }\n\n    /** Whether a task is waiting or running for `key`. */\n    isPending(key: K): boolean {\n        return this.#debouncers.has(key);\n    }\n\n    #create(key: K): Debouncer {\n        const debouncer: Debouncer = new Debouncer({\n            delayMs: this.#delayMs,\n            onSchedule: () => this.#onSchedule(key),\n            onStart: () => this.#onStart(key),\n            onSuccess: () => this.#onSuccess(key),\n            onCancel: () => this.#onCancel(key),\n            onError: (error) => this.#onError(error, key),\n            onIdle: () => {\n                if (this.#debouncers.get(key) === debouncer) {\n                    this.#debouncers.delete(key);\n                    this.#onIdle(key);\n                }\n            },\n        });\n        return debouncer;\n    }\n}\n"]}

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"]}