@avatijs/debounce 0.1.1 → 0.1.3

package/dist/umd/index.js

@@ -1,8 +1,384 @@
 /*!
- * @avatijs/debounce 0.1.1
+ * @avatijs/debounce 0.1.3
  * Copyright (c) 2024 Khaled Sameer <khaled.smq@hotmail.com>
  * Licensed under MIT, https://opensource.org/licenses/MIT/
  * Please visit https://avati.io/ for details.
  */
-!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define("Avati",[],n):"object"==typeof exports?exports.Avati=n():e.Avati=n()}("undefined"!=typeof self?self:this,(()=>(()=>{"use strict";var e={d:(n,o)=>{for(var t in o)e.o(o,t)&&!e.o(n,t)&&Object.defineProperty(n,t,{enumerable:!0,get:o[t]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"t",{value:!0})}},n={};e.r(n),e.d(n,{debounce:()=>i});const o=new WeakMap,t=e=>({log:(...n)=>e&&void 0,warn:(...n)=>e&&void 0,error:(...n)=>e&&void 0});function i(e,n={}){if("function"!=typeof e)throw new TypeError("Expected a function");const{wait:i=0,leading:r=!1,trailing:c=!0,maxWait:a,debug:u=!1,signal:d,onError:l}=n;if(0>i||void 0!==a&&i>a)throw new RangeError("Invalid wait/maxWait values");if(!r&&!c)throw Error("At least one of leading or trailing must be true");const f=t(u),s={lastInvokeTime:0,pendingPromises:[],aborted:!1};function v(){void 0!==s.timerId&&(clearTimeout(s.timerId),s.timerId=void 0,f.log("Cleared debounce timer")),void 0!==s.maxTimerId&&(clearTimeout(s.maxTimerId),s.maxTimerId=void 0,f.log("Cleared max wait timer"))}function b(){f.log("Cancelling pending invocations"),v(),s.lastInvokeTime=0,s.lastArgs=void 0,s.lastThis=void 0,s.lastCallTime=void 0,g(Error("Debounced function cancelled")),s.pendingPromises.forEach((({reject:e})=>e(Error("Debounced function cancelled")))),s.pendingPromises=[]}function g(e){if(f.error("Error occurred:",e),l)try{l(e)}catch(e){f.error("Error in onError callback:",e)}}function m(){return void 0!==s.timerId}function p(e){if(s.aborted)return!1;const n=void 0===s.lastCallTime?0:e-s.lastCallTime;return void 0===s.lastCallTime||n>=i||0>n||void 0!==a&&e-s.lastInvokeTime>=a}async function w(n){f.log("Invoking function at "+n),s.lastInvokeTime=n;const o=s.lastArgs,t=s.lastThis;s.lastArgs=void 0,s.lastThis=void 0;try{const n=await e.apply(t,o);return s.result=n,s.pendingPromises.forEach((({resolve:e})=>e(n))),s.pendingPromises=[],f.log("Function invoked successfully",n),n}catch(e){const n=e instanceof Error?e:Error(e+"");f.error("Error in function invocation:",n),g(n);const o=[...s.pendingPromises];s.pendingPromises=[],o.forEach((({reject:e})=>e(n)))}}function y(e){const n=function(e){return Math.max(0,i-(s.lastCallTime?e-s.lastCallTime:0))}(e);if(s.timerId=setTimeout(E,n),f.log(`Started debounce timer for ${n}ms`),void 0!==a&&!s.maxTimerId){const n=a-(e-s.lastCallTime);s.maxTimerId=setTimeout((()=>{f.log("Max wait timer expired"),v(),w(Date.now())}),Math.max(0,n)),f.log(`Started max wait timer for ${n}ms`)}}function E(){const e=Date.now();if(f.log("Debounce timer expired"),p(e))return function(e){f.log("Trailing edge triggered"),v(),c&&s.lastArgs?w(e):(s.pendingPromises.forEach((({resolve:e})=>{e(s.result)})),s.pendingPromises=[])}(e);y(e)}d&&d.addEventListener("abort",(()=>{s.aborted=!0,b()}));const h=function(...e){if(s.aborted)return Promise.reject(Error("Debounced function aborted"));const n=Date.now(),o=p(n);return s.lastArgs=e,s.lastThis=this,s.lastCallTime=n,f.log("Function called",{time:n,isInvoking:o,args:e,pending:m()}),new Promise(((e,o)=>{s.pendingPromises.push({resolve:e,reject:o}),void 0===s.timerId?function(e){f.log("Leading edge triggered"),s.lastInvokeTime=e,y(e),r&&w(e)}(n):(v(),y(n))}))};return o.set(h,s),Object.defineProperties(h,{cancel:{value:b,writable:!1,configurable:!1},flush:{value:async function(...e){f.log("Flush requested");const n=e.length>0?e:s.lastArgs,o=s.lastThis;return v(),n?(s.lastArgs=n,s.lastThis=o,w(Date.now())):Promise.resolve(s.result)},writable:!1,configurable:!1},pending:{value:m,writable:!1,configurable:!1},cleanup:{value:function(){f.log("Cleanup initiated"),b(),o.delete(h)},writable:!1,configurable:!1}}),h}return n})()));
+
+/* eslint-disable */
+
+(function webpackUniversalModuleDefinition(root, factory) {
+	if(typeof exports === 'object' && typeof module === 'object')
+		module.exports = factory();
+	else if(typeof define === 'function' && define.amd)
+		define("Avati", [], factory);
+	else if(typeof exports === 'object')
+		exports["Avati"] = factory();
+	else
+		root["Avati"] = root["Avati"] || {}, root["Avati"]["Debounce"] = factory();
+})(typeof self !== 'undefined' ? self : this, () => {
+return /******/ (() => { // webpackBootstrap
+/******/ 	"use strict";
+/******/ 	// The require scope
+/******/ 	var __webpack_require__ = {};
+/******/ 	
+/************************************************************************/
+/******/ 	/* webpack/runtime/define property getters */
+/******/ 	(() => {
+/******/ 		// define getter functions for harmony exports
+/******/ 		__webpack_require__.d = (exports, definition) => {
+/******/ 			for(var key in definition) {
+/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
+/******/ 				}
+/******/ 			}
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
+/******/ 	(() => {
+/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/make namespace object */
+/******/ 	(() => {
+/******/ 		// define __esModule on exports
+/******/ 		__webpack_require__.r = (exports) => {
+/******/ 			if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
+/******/ 				Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+/******/ 			}
+/******/ 			Object.defineProperty(exports, '__esModule', { value: true });
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/************************************************************************/
+var __webpack_exports__ = {};
+// ESM COMPAT FLAG
+__webpack_require__.r(__webpack_exports__);
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  debounce: () => (/* reexport */ debounce)
+});
+
+;// ./src/debouce.ts
+/**
+ * Advanced debounce utility with TypeScript support
+ * Provides a way to limit the rate at which a function can fire by delaying its execution
+ * until after a specified amount of time has elapsed since its last invocation.
+ * @module debounce
+ */
+/** WeakMap to store private state for each debounced function */
+const privateState = new WeakMap();
+/**
+ * Creates a logger instance based on debug flag
+ * @param debug - Whether debug logging is enabled
+ * @returns Object with logging methods
+ * @private
+ */
+const createLogger = (debug) => ({
+    log: (...args) => debug && console.log('[Debounce]', ...args),
+    warn: (...args) => debug && console.warn('[Debounce]', ...args),
+    error: (...args) => debug && console.error('[Debounce]', ...args),
+});
+/**
+ * Creates a debounced version of the provided function that delays invoking func until after
+ * wait milliseconds have elapsed since the last time the debounced function was invoked.
+ *
+ * @template T - The type of the function to debounce
+ * @param {T} func - The function to debounce
+ * @param {DebounceOptions} [options={}] - Configuration options
+ * @returns {DebouncedFunction<T>} The debounced function
+ * @throws {TypeError} If func is not a function
+ * @throws {RangeError} If wait or maxWait values are invalid
+ * @throws {Error} If neither leading nor trailing is true
+ *
+ * @example
+ * const debouncedFn = debounce(async (x: number) => x * 2, { wait: 1000 });
+ * await debouncedFn(5); // Will execute after 1000ms of inactivity
+ * const debouncedFn = debounce(
+ *    async (x: number) => x * 2,
+ *    {
+ *      wait: 1000,
+ *      onError: (error) => console.error('Error in debounced function:', error)
+ *    }
+ *  );
+ */
+function debounce(func, options = {}) {
+    // Input validation
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    const { wait = 0, leading = false, trailing = true, maxWait, debug = false, signal, onError, } = options;
+    // Validate options
+    if (wait < 0 || (maxWait !== undefined && maxWait < wait)) {
+        throw new RangeError('Invalid wait/maxWait values');
+    }
+    if (!leading && !trailing) {
+        throw new Error('At least one of leading or trailing must be true');
+    }
+    const logger = createLogger(debug);
+    const state = {
+        lastInvokeTime: 0,
+        pendingPromises: [],
+        aborted: false,
+    };
+    // Setup abort controller handling
+    if (signal) {
+        signal.addEventListener('abort', () => {
+            state.aborted = true;
+            cancel();
+        });
+    }
+    /**
+     * Cancels all active timers
+     * @private
+     */
+    function cancelTimers() {
+        if (state.timerId !== undefined) {
+            clearTimeout(state.timerId);
+            state.timerId = undefined;
+            logger.log('Cleared debounce timer');
+        }
+        if (state.maxTimerId !== undefined) {
+            clearTimeout(state.maxTimerId);
+            state.maxTimerId = undefined;
+            logger.log('Cleared max wait timer');
+        }
+    }
+    /**
+     * Cancels any pending function invocations
+     * Rejects all pending promises and resets internal state
+     */
+    function cancel() {
+        logger.log('Cancelling pending invocations');
+        cancelTimers();
+        state.lastInvokeTime = 0;
+        state.lastArgs = undefined;
+        state.lastThis = undefined;
+        state.lastCallTime = undefined;
+        const error = new Error('Debounced function cancelled');
+        handleError(error);
+        state.pendingPromises.forEach(({ reject }) => reject(new Error('Debounced function cancelled')));
+        state.pendingPromises = [];
+    }
+    /**
+     * Handles errors during function execution
+     * @param {Error} error - The error that occurred
+     * @private
+     */
+    function handleError(error) {
+        logger.error('Error occurred:', error);
+        if (onError) {
+            try {
+                onError(error);
+            }
+            catch (callbackError) {
+                logger.error('Error in onError callback:', callbackError);
+            }
+        }
+    }
+    /**
+     * Checks if there are any pending function invocations
+     * @returns {boolean} True if there are pending invocations
+     */
+    function pending() {
+        return state.timerId !== undefined;
+    }
+    /**
+     * Determines if the function should be invoked based on timing conditions
+     * @param {number} time - Current timestamp
+     * @returns {boolean} True if function should be invoked
+     * @private
+     */
+    function shouldInvoke(time) {
+        if (state.aborted)
+            return false;
+        const timeSinceLastCall = state.lastCallTime === undefined ? 0 : time - state.lastCallTime;
+        const timeSinceLastInvoke = time - state.lastInvokeTime;
+        return (state.lastCallTime === undefined ||
+            timeSinceLastCall >= wait ||
+            timeSinceLastCall < 0 ||
+            (maxWait !== undefined && timeSinceLastInvoke >= maxWait));
+    }
+    /**
+     * Executes the underlying function and manages promise resolution
+     * @param {number} time - Current timestamp
+     * @returns {Promise} Promise resolving to function result
+     * @private
+     */
+    async function invokeFunc(time) {
+        logger.log(`Invoking function at ${time}`);
+        state.lastInvokeTime = time;
+        const args = state.lastArgs;
+        const thisArg = state.lastThis;
+        state.lastArgs = undefined;
+        state.lastThis = undefined;
+        try {
+            const result = await func.apply(thisArg, args);
+            state.result = result;
+            state.pendingPromises.forEach(({ resolve }) => resolve(result));
+            state.pendingPromises = [];
+            logger.log('Function invoked successfully', result);
+            return result;
+        }
+        catch (error) {
+            const wrappedError = error instanceof Error ? error : new Error(String(error));
+            logger.error('Error in function invocation:', wrappedError);
+            handleError(wrappedError);
+            // Clear pending promises after handling error
+            const currentPromises = [...state.pendingPromises];
+            state.pendingPromises = [];
+            // Reject all pending promises
+            currentPromises.forEach(({ reject }) => reject(wrappedError));
+        }
+    }
+    /**
+     * Starts both the debounce timer and maxWait timer if configured
+     * @param {number} time - Current timestamp
+     * @private
+     */
+    function startTimer(time) {
+        const remainingTime = remainingWait(time);
+        state.timerId = setTimeout(timerExpired, remainingTime);
+        logger.log(`Started debounce timer for ${remainingTime}ms`);
+        if (maxWait !== undefined && !state.maxTimerId) {
+            const timeToMaxWait = maxWait - (time - state.lastCallTime);
+            state.maxTimerId = setTimeout(() => {
+                logger.log('Max wait timer expired');
+                cancelTimers();
+                invokeFunc(Date.now());
+            }, Math.max(0, timeToMaxWait));
+            logger.log(`Started max wait timer for ${timeToMaxWait}ms`);
+        }
+    }
+    /**
+     * Calculates remaining wait time before next execution
+     * @param {number} time - Current timestamp
+     * @returns {number} Milliseconds until next allowed execution
+     * @private
+     */
+    function remainingWait(time) {
+        const timeSinceLastCall = state.lastCallTime ? time - state.lastCallTime : 0;
+        return Math.max(0, wait - timeSinceLastCall);
+    }
+    /**
+     * Handles timer expiration
+     * @private
+     */
+    function timerExpired() {
+        const time = Date.now();
+        logger.log('Debounce timer expired');
+        if (shouldInvoke(time)) {
+            return trailingEdge(time);
+        }
+        startTimer(time);
+    }
+    /**
+     * Handles leading edge execution
+     * @param {number} time - Current timestamp
+     * @private
+     */
+    function leadingEdge(time) {
+        logger.log('Leading edge triggered');
+        state.lastInvokeTime = time;
+        startTimer(time);
+        if (leading) {
+            invokeFunc(time);
+        }
+    }
+    /**
+     * Handles trailing edge execution
+     * @param {number} time - Current timestamp
+     * @private
+     */
+    function trailingEdge(time) {
+        logger.log('Trailing edge triggered');
+        cancelTimers();
+        if (trailing && state.lastArgs) {
+            invokeFunc(time);
+        }
+        else {
+            state.pendingPromises.forEach(({ resolve }) => {
+                resolve(state.result);
+            });
+            state.pendingPromises = [];
+        }
+    }
+    /**
+     * Immediately executes the debounced function
+     * @param {...Parameters<T>} args - Function arguments
+     * @returns {Promise<ReturnType<T>>} Promise resolving to function result
+     */
+    async function flush(...args) {
+        logger.log('Flush requested');
+        const argsToUse = args.length > 0 ? args : state.lastArgs;
+        const thisArg = state.lastThis;
+        cancelTimers();
+        if (argsToUse) {
+            state.lastArgs = argsToUse;
+            state.lastThis = thisArg;
+            return invokeFunc(Date.now());
+        }
+        return Promise.resolve(state.result);
+    }
+    /**
+     * Cleans up resources used by the debounced function
+     */
+    function cleanup() {
+        logger.log('Cleanup initiated');
+        cancel();
+        privateState.delete(debounced);
+    }
+    /**
+     * The debounced function that wraps the original
+     * @param {...Parameters<T>} args - Function arguments
+     * @returns {Promise<ReturnType<T>>} Promise resolving to function result
+     */
+    const debounced = function (...args) {
+        if (state.aborted) {
+            return Promise.reject(new Error('Debounced function aborted'));
+        }
+        const time = Date.now();
+        const isInvoking = shouldInvoke(time);
+        state.lastArgs = args;
+        state.lastThis = this;
+        state.lastCallTime = time;
+        logger.log('Function called', {
+            time,
+            isInvoking,
+            args,
+            pending: pending(),
+        });
+        return new Promise((resolve, reject) => {
+            state.pendingPromises.push({ resolve, reject });
+            if (state.timerId === undefined) {
+                leadingEdge(time);
+            }
+            else {
+                cancelTimers();
+                startTimer(time);
+            }
+        });
+    };
+    // Store private state
+    privateState.set(debounced, state);
+    // Add utility methods
+    Object.defineProperties(debounced, {
+        cancel: { value: cancel, writable: false, configurable: false },
+        flush: { value: flush, writable: false, configurable: false },
+        pending: { value: pending, writable: false, configurable: false },
+        cleanup: { value: cleanup, writable: false, configurable: false },
+    });
+    return debounced;
+}
+
+
+;// ./src/index.ts
+
+
+/******/ 	return __webpack_exports__;
+/******/ })()
+;
+});
 //# sourceMappingURL=index.js.map

package/dist/umd/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","mappings":"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","sources":["webpack://Avati/webpack/universalModuleDefinition","webpack://Avati/webpack/bootstrap","webpack://Avati/webpack/runtime/define property getters","webpack://Avati/webpack/runtime/hasOwnProperty shorthand","webpack://Avati/webpack/runtime/make namespace object","webpack://Avati/./src/debouce.ts"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine(\"Avati\", [], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"Avati\"] = factory();\n\telse\n\t\troot[\"Avati\"] = factory();\n})(typeof self !== 'undefined' ? self : this, () => {\nreturn ","// The require scope\nvar __webpack_require__ = {};\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Advanced debounce utility with TypeScript support\n * Provides a way to limit the rate at which a function can fire by delaying its execution\n * until after a specified amount of time has elapsed since its last invocation.\n * @module debounce\n */\n\n/**\n * Timer ID type returned by setTimeout\n * Used for managing timers internally\n */\ntype TimerId = ReturnType<typeof setTimeout>;\n\n/**\n * Generic function type that can accept any arguments and return any value\n * Used as a constraint for functions that can be debounced\n */\ntype AnyFunction = (...args: any[]) => any;\n\n/**\n * Configuration options for the debounce function\n * @interface DebounceOptions\n */\ninterface DebounceOptions {\n    /** Number of milliseconds to delay execution (default: 0) */\n    readonly wait?: number;\n    /** Whether to execute on the leading edge of the timeout (default: false) */\n    readonly leading?: boolean;\n    /** Whether to execute on the trailing edge of the timeout (default: true) */\n    readonly trailing?: boolean;\n    /** Maximum time the function can be delayed before forced execution */\n    readonly maxWait?: number;\n    /** Enable debug logging for troubleshooting */\n    readonly debug?: boolean;\n    /** AbortController signal for cancellation */\n    readonly signal?: AbortSignal;\n\n    onError?: (error: Error) => void;\n}\n\n/**\n * Interface for the debounced function, including utility methods\n * @interface DebouncedFunction\n * @template T - The type of the original function\n */\ninterface DebouncedFunction<T extends AnyFunction> {\n    /** Cancels any pending function invocations */\n    readonly cancel: () => void;\n    /** Immediately executes any pending function call */\n    readonly flush: (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>;\n    /** Checks if there are any pending invocations */\n    readonly pending: () => boolean;\n    /** Cleans up resources used by the debounced function */\n    readonly cleanup: () => void;\n\n    /** The debounced function that wraps the original */\n    (...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;\n}\n\n/**\n * Internal state management for the debounced function\n * @interface PrivateState\n * @template T - The type of the original function\n * @private\n */\ninterface PrivateState<T extends AnyFunction> {\n    /** Current timer ID for the debounce delay */\n    timerId?: TimerId;\n    /** Timer ID for the maximum wait limit */\n    maxTimerId?: TimerId;\n    /** Timestamp of the last function call */\n    lastCallTime?: number;\n    /** Timestamp of the last successful function invocation */\n    lastInvokeTime: number;\n    /** Arguments from the most recent function call */\n    lastArgs?: Parameters<T>;\n    /** Execution context (this) from the most recent call */\n    lastThis?: any;\n    /** Result from the last function execution */\n    result?: Awaited<ReturnType<T>>;\n    /** Array of pending promises waiting for resolution */\n    pendingPromises: Array<{\n        resolve: (value: Awaited<ReturnType<T>>) => void;\n        reject: (reason?: any) => void;\n    }>;\n    /** Flag indicating if the function has been aborted */\n    aborted: boolean;\n}\n\n/** WeakMap to store private state for each debounced function */\nconst privateState = new WeakMap<DebouncedFunction<any>, PrivateState<any>>();\n\n/**\n * Creates a logger instance based on debug flag\n * @param debug - Whether debug logging is enabled\n * @returns Object with logging methods\n * @private\n */\nconst createLogger = (debug: boolean) => ({\n    log: (...args: any[]) => debug && console.log('[Debounce]', ...args),\n    warn: (...args: any[]) => debug && console.warn('[Debounce]', ...args),\n    error: (...args: any[]) => debug && console.error('[Debounce]', ...args),\n});\n\n/**\n * Creates a debounced version of the provided function that delays invoking func until after\n * wait milliseconds have elapsed since the last time the debounced function was invoked.\n *\n * @template T - The type of the function to debounce\n * @param {T} func - The function to debounce\n * @param {DebounceOptions} [options={}] - Configuration options\n * @returns {DebouncedFunction<T>} The debounced function\n * @throws {TypeError} If func is not a function\n * @throws {RangeError} If wait or maxWait values are invalid\n * @throws {Error} If neither leading nor trailing is true\n *\n * @example\n * const debouncedFn = debounce(async (x: number) => x * 2, { wait: 1000 });\n * await debouncedFn(5); // Will execute after 1000ms of inactivity\n * const debouncedFn = debounce(\n *    async (x: number) => x * 2,\n *    {\n *      wait: 1000,\n *      onError: (error) => console.error('Error in debounced function:', error)\n *    }\n *  );\n */\nfunction debounce<T extends AnyFunction>(\n    func: T,\n    options: DebounceOptions = {},\n): DebouncedFunction<T> {\n    // Input validation\n    if (typeof func !== 'function') {\n        throw new TypeError('Expected a function');\n    }\n\n    const {\n        wait = 0,\n        leading = false,\n        trailing = true,\n        maxWait,\n        debug = false,\n        signal,\n        onError,\n    } = options;\n\n    // Validate options\n    if (wait < 0 || (maxWait !== undefined && maxWait < wait)) {\n        throw new RangeError('Invalid wait/maxWait values');\n    }\n\n    if (!leading && !trailing) {\n        throw new Error('At least one of leading or trailing must be true');\n    }\n\n    const logger = createLogger(debug);\n    const state: PrivateState<T> = {\n        lastInvokeTime: 0,\n        pendingPromises: [],\n        aborted: false,\n    };\n\n    // Setup abort controller handling\n    if (signal) {\n        signal.addEventListener('abort', () => {\n            state.aborted = true;\n            cancel();\n        });\n    }\n\n    /**\n     * Cancels all active timers\n     * @private\n     */\n    function cancelTimers(): void {\n        if (state.timerId !== undefined) {\n            clearTimeout(state.timerId);\n            state.timerId = undefined;\n            logger.log('Cleared debounce timer');\n        }\n        if (state.maxTimerId !== undefined) {\n            clearTimeout(state.maxTimerId);\n            state.maxTimerId = undefined;\n            logger.log('Cleared max wait timer');\n        }\n    }\n\n    /**\n     * Cancels any pending function invocations\n     * Rejects all pending promises and resets internal state\n     */\n    function cancel(): void {\n        logger.log('Cancelling pending invocations');\n        cancelTimers();\n        state.lastInvokeTime = 0;\n        state.lastArgs = undefined;\n        state.lastThis = undefined;\n        state.lastCallTime = undefined;\n        const error = new Error('Debounced function cancelled');\n        handleError(error);\n        state.pendingPromises.forEach(({ reject }) =>\n            reject(new Error('Debounced function cancelled')),\n        );\n        state.pendingPromises = [];\n    }\n\n    /**\n     * Handles errors during function execution\n     * @param {Error} error - The error that occurred\n     * @private\n     */\n    function handleError(error: Error): void {\n        logger.error('Error occurred:', error);\n        if (onError) {\n            try {\n                onError(error);\n            } catch (callbackError) {\n                logger.error('Error in onError callback:', callbackError);\n            }\n        }\n    }\n\n    /**\n     * Checks if there are any pending function invocations\n     * @returns {boolean} True if there are pending invocations\n     */\n    function pending(): boolean {\n        return state.timerId !== undefined;\n    }\n\n    /**\n     * Determines if the function should be invoked based on timing conditions\n     * @param {number} time - Current timestamp\n     * @returns {boolean} True if function should be invoked\n     * @private\n     */\n    function shouldInvoke(time: number): boolean {\n        if (state.aborted) return false;\n\n        const timeSinceLastCall = state.lastCallTime === undefined ? 0 : time - state.lastCallTime;\n        const timeSinceLastInvoke = time - state.lastInvokeTime;\n\n        return (\n            state.lastCallTime === undefined ||\n            timeSinceLastCall >= wait ||\n            timeSinceLastCall < 0 ||\n            (maxWait !== undefined && timeSinceLastInvoke >= maxWait)\n        );\n    }\n\n    /**\n     * Executes the underlying function and manages promise resolution\n     * @param {number} time - Current timestamp\n     * @returns {Promise} Promise resolving to function result\n     * @private\n     */\n    async function invokeFunc(time: number): Promise<Awaited<ReturnType<T>> | void> {\n        logger.log(`Invoking function at ${time}`);\n        state.lastInvokeTime = time;\n        const args = state.lastArgs!;\n        const thisArg = state.lastThis;\n\n        state.lastArgs = undefined;\n        state.lastThis = undefined;\n\n        try {\n            const result = await func.apply(thisArg, args);\n            state.result = result;\n            state.pendingPromises.forEach(({ resolve }) => resolve(result));\n            state.pendingPromises = [];\n            logger.log('Function invoked successfully', result);\n            return result;\n        } catch (error) {\n            const wrappedError = error instanceof Error ? error : new Error(String(error));\n            logger.error('Error in function invocation:', wrappedError);\n            handleError(wrappedError);\n\n            // Clear pending promises after handling error\n            const currentPromises = [...state.pendingPromises];\n            state.pendingPromises = [];\n\n            // Reject all pending promises\n            currentPromises.forEach(({ reject }) => reject(wrappedError));\n        }\n    }\n\n    /**\n     * Starts both the debounce timer and maxWait timer if configured\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function startTimer(time: number): void {\n        const remainingTime = remainingWait(time);\n        state.timerId = setTimeout(timerExpired, remainingTime);\n        logger.log(`Started debounce timer for ${remainingTime}ms`);\n\n        if (maxWait !== undefined && !state.maxTimerId) {\n            const timeToMaxWait = maxWait - (time - state.lastCallTime!);\n            state.maxTimerId = setTimeout(\n                () => {\n                    logger.log('Max wait timer expired');\n                    cancelTimers();\n                    invokeFunc(Date.now());\n                },\n                Math.max(0, timeToMaxWait),\n            );\n            logger.log(`Started max wait timer for ${timeToMaxWait}ms`);\n        }\n    }\n\n    /**\n     * Calculates remaining wait time before next execution\n     * @param {number} time - Current timestamp\n     * @returns {number} Milliseconds until next allowed execution\n     * @private\n     */\n    function remainingWait(time: number): number {\n        const timeSinceLastCall = state.lastCallTime ? time - state.lastCallTime : 0;\n        return Math.max(0, wait - timeSinceLastCall);\n    }\n\n    /**\n     * Handles timer expiration\n     * @private\n     */\n    function timerExpired(): void {\n        const time = Date.now();\n        logger.log('Debounce timer expired');\n\n        if (shouldInvoke(time)) {\n            return trailingEdge(time);\n        }\n\n        startTimer(time);\n    }\n\n    /**\n     * Handles leading edge execution\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function leadingEdge(time: number): void {\n        logger.log('Leading edge triggered');\n        state.lastInvokeTime = time;\n        startTimer(time);\n\n        if (leading) {\n            invokeFunc(time);\n        }\n    }\n\n    /**\n     * Handles trailing edge execution\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function trailingEdge(time: number): void {\n        logger.log('Trailing edge triggered');\n        cancelTimers();\n\n        if (trailing && state.lastArgs) {\n            invokeFunc(time);\n        } else {\n            state.pendingPromises.forEach(({ resolve }) => {\n                resolve(state.result as Awaited<ReturnType<T>>);\n            });\n            state.pendingPromises = [];\n        }\n    }\n\n    /**\n     * Immediately executes the debounced function\n     * @param {...Parameters<T>} args - Function arguments\n     * @returns {Promise<ReturnType<T>>} Promise resolving to function result\n     */\n    async function flush(...args: Parameters<T>): Promise<Awaited<ReturnType<T>> | void> {\n        logger.log('Flush requested');\n        const argsToUse = args.length > 0 ? args : state.lastArgs;\n        const thisArg = state.lastThis;\n\n        cancelTimers();\n\n        if (argsToUse) {\n            state.lastArgs = argsToUse;\n            state.lastThis = thisArg;\n            return invokeFunc(Date.now());\n        }\n\n        return Promise.resolve(state.result!);\n    }\n\n    /**\n     * Cleans up resources used by the debounced function\n     */\n    function cleanup(): void {\n        logger.log('Cleanup initiated');\n        cancel();\n        privateState.delete(debounced);\n    }\n\n    /**\n     * The debounced function that wraps the original\n     * @param {...Parameters<T>} args - Function arguments\n     * @returns {Promise<ReturnType<T>>} Promise resolving to function result\n     */\n    const debounced = function(\n        this: any,\n        ...args: Parameters<T>\n    ): Promise<Awaited<ReturnType<T>>> {\n        if (state.aborted) {\n            return Promise.reject(new Error('Debounced function aborted'));\n        }\n\n        const time = Date.now();\n        const isInvoking = shouldInvoke(time);\n\n        state.lastArgs = args;\n        state.lastThis = this;\n        state.lastCallTime = time;\n\n        logger.log('Function called', {\n            time,\n            isInvoking,\n            args,\n            pending: pending(),\n        });\n\n        return new Promise((resolve, reject) => {\n            state.pendingPromises.push({ resolve, reject });\n\n            if (state.timerId === undefined) {\n                leadingEdge(time);\n            } else {\n                cancelTimers();\n                startTimer(time);\n            }\n        });\n    } as DebouncedFunction<T>;\n\n    // Store private state\n    privateState.set(debounced, state);\n\n    // Add utility methods\n    Object.defineProperties(debounced, {\n        cancel: { value: cancel, writable: false, configurable: false },\n        flush: { value: flush, writable: false, configurable: false },\n        pending: { value: pending, writable: false, configurable: false },\n        cleanup: { value: cleanup, writable: false, configurable: false },\n    });\n\n    return debounced;\n}\n\nexport { debounce, type DebouncedFunction, type DebounceOptions };\n"],"names":["root","factory","exports","module","define","amd","self","this","__webpack_require__","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","Symbol","toStringTag","value","privateState","WeakMap","createLogger","debug","log","args","console","warn","error","debounce","func","options","TypeError","wait","leading","trailing","maxWait","signal","onError","undefined","RangeError","Error","logger","state","lastInvokeTime","pendingPromises","aborted","cancelTimers","timerId","clearTimeout","maxTimerId","cancel","lastArgs","lastThis","lastCallTime","handleError","forEach","reject","callbackError","pending","shouldInvoke","time","timeSinceLastCall","async","invokeFunc","thisArg","result","apply","resolve","wrappedError","String","currentPromises","startTimer","remainingTime","Math","max","remainingWait","setTimeout","timerExpired","timeToMaxWait","Date","now","trailingEdge","addEventListener","debounced","Promise","isInvoking","push","leadingEdge","set","defineProperties","writable","configurable","flush","argsToUse","length","cleanup","delete"],"sourceRoot":""}
+{"version":3,"file":"index.js","mappings":"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","sources":["webpack://Avati.Debounce/webpack/universalModuleDefinition","webpack://Avati.Debounce/webpack/bootstrap","webpack://Avati.Debounce/webpack/runtime/define property getters","webpack://Avati.Debounce/webpack/runtime/hasOwnProperty shorthand","webpack://Avati.Debounce/webpack/runtime/make namespace object","webpack://Avati.Debounce/./src/debouce.ts","webpack://Avati.Debounce/./src/index.ts"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine(\"Avati\", [], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"Avati\"] = factory();\n\telse\n\t\troot[\"Avati\"] = root[\"Avati\"] || {}, root[\"Avati\"][\"Debounce\"] = factory();\n})(typeof self !== 'undefined' ? self : this, () => {\nreturn ","// The require scope\nvar __webpack_require__ = {};\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Advanced debounce utility with TypeScript support\n * Provides a way to limit the rate at which a function can fire by delaying its execution\n * until after a specified amount of time has elapsed since its last invocation.\n * @module debounce\n */\n\n/**\n * Timer ID type returned by setTimeout\n * Used for managing timers internally\n */\ntype TimerId = ReturnType<typeof setTimeout>;\n\n/**\n * Generic function type that can accept any arguments and return any value\n * Used as a constraint for functions that can be debounced\n */\ntype AnyFunction = (...args: any[]) => any;\n\n/**\n * Configuration options for the debounce function\n * @interface DebounceOptions\n */\ninterface DebounceOptions {\n    /** Number of milliseconds to delay execution (default: 0) */\n    readonly wait?: number;\n    /** Whether to execute on the leading edge of the timeout (default: false) */\n    readonly leading?: boolean;\n    /** Whether to execute on the trailing edge of the timeout (default: true) */\n    readonly trailing?: boolean;\n    /** Maximum time the function can be delayed before forced execution */\n    readonly maxWait?: number;\n    /** Enable debug logging for troubleshooting */\n    readonly debug?: boolean;\n    /** AbortController signal for cancellation */\n    readonly signal?: AbortSignal;\n\n    onError?: (error: Error) => void;\n}\n\n/**\n * Interface for the debounced function, including utility methods\n * @interface DebouncedFunction\n * @template T - The type of the original function\n */\ninterface DebouncedFunction<T extends AnyFunction> {\n    /** Cancels any pending function invocations */\n    readonly cancel: () => void;\n    /** Immediately executes any pending function call */\n    readonly flush: (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>;\n    /** Checks if there are any pending invocations */\n    readonly pending: () => boolean;\n    /** Cleans up resources used by the debounced function */\n    readonly cleanup: () => void;\n\n    /** The debounced function that wraps the original */\n    (...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;\n}\n\n/**\n * Internal state management for the debounced function\n * @interface PrivateState\n * @template T - The type of the original function\n * @private\n */\ninterface PrivateState<T extends AnyFunction> {\n    /** Current timer ID for the debounce delay */\n    timerId?: TimerId;\n    /** Timer ID for the maximum wait limit */\n    maxTimerId?: TimerId;\n    /** Timestamp of the last function call */\n    lastCallTime?: number;\n    /** Timestamp of the last successful function invocation */\n    lastInvokeTime: number;\n    /** Arguments from the most recent function call */\n    lastArgs?: Parameters<T>;\n    /** Execution context (this) from the most recent call */\n    lastThis?: any;\n    /** Result from the last function execution */\n    result?: Awaited<ReturnType<T>>;\n    /** Array of pending promises waiting for resolution */\n    pendingPromises: Array<{\n        resolve: (value: Awaited<ReturnType<T>>) => void;\n        reject: (reason?: any) => void;\n    }>;\n    /** Flag indicating if the function has been aborted */\n    aborted: boolean;\n}\n\n/** WeakMap to store private state for each debounced function */\nconst privateState = new WeakMap<DebouncedFunction<any>, PrivateState<any>>();\n\n/**\n * Creates a logger instance based on debug flag\n * @param debug - Whether debug logging is enabled\n * @returns Object with logging methods\n * @private\n */\nconst createLogger = (debug: boolean) => ({\n    log: (...args: any[]) => debug && console.log('[Debounce]', ...args),\n    warn: (...args: any[]) => debug && console.warn('[Debounce]', ...args),\n    error: (...args: any[]) => debug && console.error('[Debounce]', ...args),\n});\n\n/**\n * Creates a debounced version of the provided function that delays invoking func until after\n * wait milliseconds have elapsed since the last time the debounced function was invoked.\n *\n * @template T - The type of the function to debounce\n * @param {T} func - The function to debounce\n * @param {DebounceOptions} [options={}] - Configuration options\n * @returns {DebouncedFunction<T>} The debounced function\n * @throws {TypeError} If func is not a function\n * @throws {RangeError} If wait or maxWait values are invalid\n * @throws {Error} If neither leading nor trailing is true\n *\n * @example\n * const debouncedFn = debounce(async (x: number) => x * 2, { wait: 1000 });\n * await debouncedFn(5); // Will execute after 1000ms of inactivity\n * const debouncedFn = debounce(\n *    async (x: number) => x * 2,\n *    {\n *      wait: 1000,\n *      onError: (error) => console.error('Error in debounced function:', error)\n *    }\n *  );\n */\nfunction debounce<T extends AnyFunction>(\n    func: T,\n    options: DebounceOptions = {},\n): DebouncedFunction<T> {\n    // Input validation\n    if (typeof func !== 'function') {\n        throw new TypeError('Expected a function');\n    }\n\n    const {\n        wait = 0,\n        leading = false,\n        trailing = true,\n        maxWait,\n        debug = false,\n        signal,\n        onError,\n    } = options;\n\n    // Validate options\n    if (wait < 0 || (maxWait !== undefined && maxWait < wait)) {\n        throw new RangeError('Invalid wait/maxWait values');\n    }\n\n    if (!leading && !trailing) {\n        throw new Error('At least one of leading or trailing must be true');\n    }\n\n    const logger = createLogger(debug);\n    const state: PrivateState<T> = {\n        lastInvokeTime: 0,\n        pendingPromises: [],\n        aborted: false,\n    };\n\n    // Setup abort controller handling\n    if (signal) {\n        signal.addEventListener('abort', () => {\n            state.aborted = true;\n            cancel();\n        });\n    }\n\n    /**\n     * Cancels all active timers\n     * @private\n     */\n    function cancelTimers(): void {\n        if (state.timerId !== undefined) {\n            clearTimeout(state.timerId);\n            state.timerId = undefined;\n            logger.log('Cleared debounce timer');\n        }\n        if (state.maxTimerId !== undefined) {\n            clearTimeout(state.maxTimerId);\n            state.maxTimerId = undefined;\n            logger.log('Cleared max wait timer');\n        }\n    }\n\n    /**\n     * Cancels any pending function invocations\n     * Rejects all pending promises and resets internal state\n     */\n    function cancel(): void {\n        logger.log('Cancelling pending invocations');\n        cancelTimers();\n        state.lastInvokeTime = 0;\n        state.lastArgs = undefined;\n        state.lastThis = undefined;\n        state.lastCallTime = undefined;\n        const error = new Error('Debounced function cancelled');\n        handleError(error);\n        state.pendingPromises.forEach(({ reject }) =>\n            reject(new Error('Debounced function cancelled')),\n        );\n        state.pendingPromises = [];\n    }\n\n    /**\n     * Handles errors during function execution\n     * @param {Error} error - The error that occurred\n     * @private\n     */\n    function handleError(error: Error): void {\n        logger.error('Error occurred:', error);\n        if (onError) {\n            try {\n                onError(error);\n            } catch (callbackError) {\n                logger.error('Error in onError callback:', callbackError);\n            }\n        }\n    }\n\n    /**\n     * Checks if there are any pending function invocations\n     * @returns {boolean} True if there are pending invocations\n     */\n    function pending(): boolean {\n        return state.timerId !== undefined;\n    }\n\n    /**\n     * Determines if the function should be invoked based on timing conditions\n     * @param {number} time - Current timestamp\n     * @returns {boolean} True if function should be invoked\n     * @private\n     */\n    function shouldInvoke(time: number): boolean {\n        if (state.aborted) return false;\n\n        const timeSinceLastCall = state.lastCallTime === undefined ? 0 : time - state.lastCallTime;\n        const timeSinceLastInvoke = time - state.lastInvokeTime;\n\n        return (\n            state.lastCallTime === undefined ||\n            timeSinceLastCall >= wait ||\n            timeSinceLastCall < 0 ||\n            (maxWait !== undefined && timeSinceLastInvoke >= maxWait)\n        );\n    }\n\n    /**\n     * Executes the underlying function and manages promise resolution\n     * @param {number} time - Current timestamp\n     * @returns {Promise} Promise resolving to function result\n     * @private\n     */\n    async function invokeFunc(time: number): Promise<Awaited<ReturnType<T>> | void> {\n        logger.log(`Invoking function at ${time}`);\n        state.lastInvokeTime = time;\n        const args = state.lastArgs!;\n        const thisArg = state.lastThis;\n\n        state.lastArgs = undefined;\n        state.lastThis = undefined;\n\n        try {\n            const result = await func.apply(thisArg, args);\n            state.result = result;\n            state.pendingPromises.forEach(({ resolve }) => resolve(result));\n            state.pendingPromises = [];\n            logger.log('Function invoked successfully', result);\n            return result;\n        } catch (error) {\n            const wrappedError = error instanceof Error ? error : new Error(String(error));\n            logger.error('Error in function invocation:', wrappedError);\n            handleError(wrappedError);\n\n            // Clear pending promises after handling error\n            const currentPromises = [...state.pendingPromises];\n            state.pendingPromises = [];\n\n            // Reject all pending promises\n            currentPromises.forEach(({ reject }) => reject(wrappedError));\n        }\n    }\n\n    /**\n     * Starts both the debounce timer and maxWait timer if configured\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function startTimer(time: number): void {\n        const remainingTime = remainingWait(time);\n        state.timerId = setTimeout(timerExpired, remainingTime);\n        logger.log(`Started debounce timer for ${remainingTime}ms`);\n\n        if (maxWait !== undefined && !state.maxTimerId) {\n            const timeToMaxWait = maxWait - (time - state.lastCallTime!);\n            state.maxTimerId = setTimeout(\n                () => {\n                    logger.log('Max wait timer expired');\n                    cancelTimers();\n                    invokeFunc(Date.now());\n                },\n                Math.max(0, timeToMaxWait),\n            );\n            logger.log(`Started max wait timer for ${timeToMaxWait}ms`);\n        }\n    }\n\n    /**\n     * Calculates remaining wait time before next execution\n     * @param {number} time - Current timestamp\n     * @returns {number} Milliseconds until next allowed execution\n     * @private\n     */\n    function remainingWait(time: number): number {\n        const timeSinceLastCall = state.lastCallTime ? time - state.lastCallTime : 0;\n        return Math.max(0, wait - timeSinceLastCall);\n    }\n\n    /**\n     * Handles timer expiration\n     * @private\n     */\n    function timerExpired(): void {\n        const time = Date.now();\n        logger.log('Debounce timer expired');\n\n        if (shouldInvoke(time)) {\n            return trailingEdge(time);\n        }\n\n        startTimer(time);\n    }\n\n    /**\n     * Handles leading edge execution\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function leadingEdge(time: number): void {\n        logger.log('Leading edge triggered');\n        state.lastInvokeTime = time;\n        startTimer(time);\n\n        if (leading) {\n            invokeFunc(time);\n        }\n    }\n\n    /**\n     * Handles trailing edge execution\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function trailingEdge(time: number): void {\n        logger.log('Trailing edge triggered');\n        cancelTimers();\n\n        if (trailing && state.lastArgs) {\n            invokeFunc(time);\n        } else {\n            state.pendingPromises.forEach(({ resolve }) => {\n                resolve(state.result as Awaited<ReturnType<T>>);\n            });\n            state.pendingPromises = [];\n        }\n    }\n\n    /**\n     * Immediately executes the debounced function\n     * @param {...Parameters<T>} args - Function arguments\n     * @returns {Promise<ReturnType<T>>} Promise resolving to function result\n     */\n    async function flush(...args: Parameters<T>): Promise<Awaited<ReturnType<T>> | void> {\n        logger.log('Flush requested');\n        const argsToUse = args.length > 0 ? args : state.lastArgs;\n        const thisArg = state.lastThis;\n\n        cancelTimers();\n\n        if (argsToUse) {\n            state.lastArgs = argsToUse;\n            state.lastThis = thisArg;\n            return invokeFunc(Date.now());\n        }\n\n        return Promise.resolve(state.result!);\n    }\n\n    /**\n     * Cleans up resources used by the debounced function\n     */\n    function cleanup(): void {\n        logger.log('Cleanup initiated');\n        cancel();\n        privateState.delete(debounced);\n    }\n\n    /**\n     * The debounced function that wraps the original\n     * @param {...Parameters<T>} args - Function arguments\n     * @returns {Promise<ReturnType<T>>} Promise resolving to function result\n     */\n    const debounced = function(\n        this: any,\n        ...args: Parameters<T>\n    ): Promise<Awaited<ReturnType<T>>> {\n        if (state.aborted) {\n            return Promise.reject(new Error('Debounced function aborted'));\n        }\n\n        const time = Date.now();\n        const isInvoking = shouldInvoke(time);\n\n        state.lastArgs = args;\n        state.lastThis = this;\n        state.lastCallTime = time;\n\n        logger.log('Function called', {\n            time,\n            isInvoking,\n            args,\n            pending: pending(),\n        });\n\n        return new Promise((resolve, reject) => {\n            state.pendingPromises.push({ resolve, reject });\n\n            if (state.timerId === undefined) {\n                leadingEdge(time);\n            } else {\n                cancelTimers();\n                startTimer(time);\n            }\n        });\n    } as DebouncedFunction<T>;\n\n    // Store private state\n    privateState.set(debounced, state);\n\n    // Add utility methods\n    Object.defineProperties(debounced, {\n        cancel: { value: cancel, writable: false, configurable: false },\n        flush: { value: flush, writable: false, configurable: false },\n        pending: { value: pending, writable: false, configurable: false },\n        cleanup: { value: cleanup, writable: false, configurable: false },\n    });\n\n    return debounced;\n}\n\nexport { debounce, type DebouncedFunction, type DebounceOptions };\n","export * from './debouce';\n"],"names":[],"sourceRoot":""}

package/dist/umd/index.min.js

@@ -0,0 +1,8 @@
+/*!
+ * @avatijs/debounce 0.1.3
+ * Copyright (c) 2024 Khaled Sameer <khaled.smq@hotmail.com>
+ * Licensed under MIT, https://opensource.org/licenses/MIT/
+ * Please visit https://avati.io/ for details.
+ */
+!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define("Avati",[],n):"object"==typeof exports?exports.Avati=n():(e.Avati=e.Avati||{},e.Avati.Debounce=n())}("undefined"!=typeof self?self:this,(()=>(()=>{"use strict";var e={d:(n,o)=>{for(var t in o)e.o(o,t)&&!e.o(n,t)&&Object.defineProperty(n,t,{enumerable:!0,get:o[t]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"t",{value:!0})}},n={};e.r(n),e.d(n,{debounce:()=>i});const o=new WeakMap,t=e=>({log:(...n)=>e&&void 0,warn:(...n)=>e&&void 0,error:(...n)=>e&&void 0});function i(e,n={}){if("function"!=typeof e)throw new TypeError("Expected a function");const{wait:i=0,leading:r=!1,trailing:c=!0,maxWait:a,debug:u=!1,signal:d,onError:l}=n;if(0>i||void 0!==a&&i>a)throw new RangeError("Invalid wait/maxWait values");if(!r&&!c)throw Error("At least one of leading or trailing must be true");const f=t(u),s={lastInvokeTime:0,pendingPromises:[],aborted:!1};function v(){void 0!==s.timerId&&(clearTimeout(s.timerId),s.timerId=void 0,f.log("Cleared debounce timer")),void 0!==s.maxTimerId&&(clearTimeout(s.maxTimerId),s.maxTimerId=void 0,f.log("Cleared max wait timer"))}function b(){f.log("Cancelling pending invocations"),v(),s.lastInvokeTime=0,s.lastArgs=void 0,s.lastThis=void 0,s.lastCallTime=void 0,g(Error("Debounced function cancelled")),s.pendingPromises.forEach((({reject:e})=>e(Error("Debounced function cancelled")))),s.pendingPromises=[]}function g(e){if(f.error("Error occurred:",e),l)try{l(e)}catch(e){f.error("Error in onError callback:",e)}}function m(){return void 0!==s.timerId}function p(e){if(s.aborted)return!1;const n=void 0===s.lastCallTime?0:e-s.lastCallTime;return void 0===s.lastCallTime||n>=i||0>n||void 0!==a&&e-s.lastInvokeTime>=a}async function w(n){f.log("Invoking function at "+n),s.lastInvokeTime=n;const o=s.lastArgs,t=s.lastThis;s.lastArgs=void 0,s.lastThis=void 0;try{const n=await e.apply(t,o);return s.result=n,s.pendingPromises.forEach((({resolve:e})=>e(n))),s.pendingPromises=[],f.log("Function invoked successfully",n),n}catch(e){const n=e instanceof Error?e:Error(e+"");f.error("Error in function invocation:",n),g(n);const o=[...s.pendingPromises];s.pendingPromises=[],o.forEach((({reject:e})=>e(n)))}}function y(e){const n=function(e){return Math.max(0,i-(s.lastCallTime?e-s.lastCallTime:0))}(e);if(s.timerId=setTimeout(E,n),f.log(`Started debounce timer for ${n}ms`),void 0!==a&&!s.maxTimerId){const n=a-(e-s.lastCallTime);s.maxTimerId=setTimeout((()=>{f.log("Max wait timer expired"),v(),w(Date.now())}),Math.max(0,n)),f.log(`Started max wait timer for ${n}ms`)}}function E(){const e=Date.now();if(f.log("Debounce timer expired"),p(e))return function(e){f.log("Trailing edge triggered"),v(),c&&s.lastArgs?w(e):(s.pendingPromises.forEach((({resolve:e})=>{e(s.result)})),s.pendingPromises=[])}(e);y(e)}d&&d.addEventListener("abort",(()=>{s.aborted=!0,b()}));const h=function(...e){if(s.aborted)return Promise.reject(Error("Debounced function aborted"));const n=Date.now(),o=p(n);return s.lastArgs=e,s.lastThis=this,s.lastCallTime=n,f.log("Function called",{time:n,isInvoking:o,args:e,pending:m()}),new Promise(((e,o)=>{s.pendingPromises.push({resolve:e,reject:o}),void 0===s.timerId?function(e){f.log("Leading edge triggered"),s.lastInvokeTime=e,y(e),r&&w(e)}(n):(v(),y(n))}))};return o.set(h,s),Object.defineProperties(h,{cancel:{value:b,writable:!1,configurable:!1},flush:{value:async function(...e){f.log("Flush requested");const n=e.length>0?e:s.lastArgs,o=s.lastThis;return v(),n?(s.lastArgs=n,s.lastThis=o,w(Date.now())):Promise.resolve(s.result)},writable:!1,configurable:!1},pending:{value:m,writable:!1,configurable:!1},cleanup:{value:function(){f.log("Cleanup initiated"),b(),o.delete(h)},writable:!1,configurable:!1}}),h}return n})()));
+//# sourceMappingURL=index.min.js.map

package/dist/umd/index.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.min.js","mappings":"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","sources":["webpack://Avati.Debounce/webpack/universalModuleDefinition","webpack://Avati.Debounce/webpack/bootstrap","webpack://Avati.Debounce/webpack/runtime/define property getters","webpack://Avati.Debounce/webpack/runtime/hasOwnProperty shorthand","webpack://Avati.Debounce/webpack/runtime/make namespace object","webpack://Avati.Debounce/./src/debouce.ts"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine(\"Avati\", [], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"Avati\"] = factory();\n\telse\n\t\troot[\"Avati\"] = root[\"Avati\"] || {}, root[\"Avati\"][\"Debounce\"] = factory();\n})(typeof self !== 'undefined' ? self : this, () => {\nreturn ","// The require scope\nvar __webpack_require__ = {};\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Advanced debounce utility with TypeScript support\n * Provides a way to limit the rate at which a function can fire by delaying its execution\n * until after a specified amount of time has elapsed since its last invocation.\n * @module debounce\n */\n\n/**\n * Timer ID type returned by setTimeout\n * Used for managing timers internally\n */\ntype TimerId = ReturnType<typeof setTimeout>;\n\n/**\n * Generic function type that can accept any arguments and return any value\n * Used as a constraint for functions that can be debounced\n */\ntype AnyFunction = (...args: any[]) => any;\n\n/**\n * Configuration options for the debounce function\n * @interface DebounceOptions\n */\ninterface DebounceOptions {\n    /** Number of milliseconds to delay execution (default: 0) */\n    readonly wait?: number;\n    /** Whether to execute on the leading edge of the timeout (default: false) */\n    readonly leading?: boolean;\n    /** Whether to execute on the trailing edge of the timeout (default: true) */\n    readonly trailing?: boolean;\n    /** Maximum time the function can be delayed before forced execution */\n    readonly maxWait?: number;\n    /** Enable debug logging for troubleshooting */\n    readonly debug?: boolean;\n    /** AbortController signal for cancellation */\n    readonly signal?: AbortSignal;\n\n    onError?: (error: Error) => void;\n}\n\n/**\n * Interface for the debounced function, including utility methods\n * @interface DebouncedFunction\n * @template T - The type of the original function\n */\ninterface DebouncedFunction<T extends AnyFunction> {\n    /** Cancels any pending function invocations */\n    readonly cancel: () => void;\n    /** Immediately executes any pending function call */\n    readonly flush: (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>;\n    /** Checks if there are any pending invocations */\n    readonly pending: () => boolean;\n    /** Cleans up resources used by the debounced function */\n    readonly cleanup: () => void;\n\n    /** The debounced function that wraps the original */\n    (...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;\n}\n\n/**\n * Internal state management for the debounced function\n * @interface PrivateState\n * @template T - The type of the original function\n * @private\n */\ninterface PrivateState<T extends AnyFunction> {\n    /** Current timer ID for the debounce delay */\n    timerId?: TimerId;\n    /** Timer ID for the maximum wait limit */\n    maxTimerId?: TimerId;\n    /** Timestamp of the last function call */\n    lastCallTime?: number;\n    /** Timestamp of the last successful function invocation */\n    lastInvokeTime: number;\n    /** Arguments from the most recent function call */\n    lastArgs?: Parameters<T>;\n    /** Execution context (this) from the most recent call */\n    lastThis?: any;\n    /** Result from the last function execution */\n    result?: Awaited<ReturnType<T>>;\n    /** Array of pending promises waiting for resolution */\n    pendingPromises: Array<{\n        resolve: (value: Awaited<ReturnType<T>>) => void;\n        reject: (reason?: any) => void;\n    }>;\n    /** Flag indicating if the function has been aborted */\n    aborted: boolean;\n}\n\n/** WeakMap to store private state for each debounced function */\nconst privateState = new WeakMap<DebouncedFunction<any>, PrivateState<any>>();\n\n/**\n * Creates a logger instance based on debug flag\n * @param debug - Whether debug logging is enabled\n * @returns Object with logging methods\n * @private\n */\nconst createLogger = (debug: boolean) => ({\n    log: (...args: any[]) => debug && console.log('[Debounce]', ...args),\n    warn: (...args: any[]) => debug && console.warn('[Debounce]', ...args),\n    error: (...args: any[]) => debug && console.error('[Debounce]', ...args),\n});\n\n/**\n * Creates a debounced version of the provided function that delays invoking func until after\n * wait milliseconds have elapsed since the last time the debounced function was invoked.\n *\n * @template T - The type of the function to debounce\n * @param {T} func - The function to debounce\n * @param {DebounceOptions} [options={}] - Configuration options\n * @returns {DebouncedFunction<T>} The debounced function\n * @throws {TypeError} If func is not a function\n * @throws {RangeError} If wait or maxWait values are invalid\n * @throws {Error} If neither leading nor trailing is true\n *\n * @example\n * const debouncedFn = debounce(async (x: number) => x * 2, { wait: 1000 });\n * await debouncedFn(5); // Will execute after 1000ms of inactivity\n * const debouncedFn = debounce(\n *    async (x: number) => x * 2,\n *    {\n *      wait: 1000,\n *      onError: (error) => console.error('Error in debounced function:', error)\n *    }\n *  );\n */\nfunction debounce<T extends AnyFunction>(\n    func: T,\n    options: DebounceOptions = {},\n): DebouncedFunction<T> {\n    // Input validation\n    if (typeof func !== 'function') {\n        throw new TypeError('Expected a function');\n    }\n\n    const {\n        wait = 0,\n        leading = false,\n        trailing = true,\n        maxWait,\n        debug = false,\n        signal,\n        onError,\n    } = options;\n\n    // Validate options\n    if (wait < 0 || (maxWait !== undefined && maxWait < wait)) {\n        throw new RangeError('Invalid wait/maxWait values');\n    }\n\n    if (!leading && !trailing) {\n        throw new Error('At least one of leading or trailing must be true');\n    }\n\n    const logger = createLogger(debug);\n    const state: PrivateState<T> = {\n        lastInvokeTime: 0,\n        pendingPromises: [],\n        aborted: false,\n    };\n\n    // Setup abort controller handling\n    if (signal) {\n        signal.addEventListener('abort', () => {\n            state.aborted = true;\n            cancel();\n        });\n    }\n\n    /**\n     * Cancels all active timers\n     * @private\n     */\n    function cancelTimers(): void {\n        if (state.timerId !== undefined) {\n            clearTimeout(state.timerId);\n            state.timerId = undefined;\n            logger.log('Cleared debounce timer');\n        }\n        if (state.maxTimerId !== undefined) {\n            clearTimeout(state.maxTimerId);\n            state.maxTimerId = undefined;\n            logger.log('Cleared max wait timer');\n        }\n    }\n\n    /**\n     * Cancels any pending function invocations\n     * Rejects all pending promises and resets internal state\n     */\n    function cancel(): void {\n        logger.log('Cancelling pending invocations');\n        cancelTimers();\n        state.lastInvokeTime = 0;\n        state.lastArgs = undefined;\n        state.lastThis = undefined;\n        state.lastCallTime = undefined;\n        const error = new Error('Debounced function cancelled');\n        handleError(error);\n        state.pendingPromises.forEach(({ reject }) =>\n            reject(new Error('Debounced function cancelled')),\n        );\n        state.pendingPromises = [];\n    }\n\n    /**\n     * Handles errors during function execution\n     * @param {Error} error - The error that occurred\n     * @private\n     */\n    function handleError(error: Error): void {\n        logger.error('Error occurred:', error);\n        if (onError) {\n            try {\n                onError(error);\n            } catch (callbackError) {\n                logger.error('Error in onError callback:', callbackError);\n            }\n        }\n    }\n\n    /**\n     * Checks if there are any pending function invocations\n     * @returns {boolean} True if there are pending invocations\n     */\n    function pending(): boolean {\n        return state.timerId !== undefined;\n    }\n\n    /**\n     * Determines if the function should be invoked based on timing conditions\n     * @param {number} time - Current timestamp\n     * @returns {boolean} True if function should be invoked\n     * @private\n     */\n    function shouldInvoke(time: number): boolean {\n        if (state.aborted) return false;\n\n        const timeSinceLastCall = state.lastCallTime === undefined ? 0 : time - state.lastCallTime;\n        const timeSinceLastInvoke = time - state.lastInvokeTime;\n\n        return (\n            state.lastCallTime === undefined ||\n            timeSinceLastCall >= wait ||\n            timeSinceLastCall < 0 ||\n            (maxWait !== undefined && timeSinceLastInvoke >= maxWait)\n        );\n    }\n\n    /**\n     * Executes the underlying function and manages promise resolution\n     * @param {number} time - Current timestamp\n     * @returns {Promise} Promise resolving to function result\n     * @private\n     */\n    async function invokeFunc(time: number): Promise<Awaited<ReturnType<T>> | void> {\n        logger.log(`Invoking function at ${time}`);\n        state.lastInvokeTime = time;\n        const args = state.lastArgs!;\n        const thisArg = state.lastThis;\n\n        state.lastArgs = undefined;\n        state.lastThis = undefined;\n\n        try {\n            const result = await func.apply(thisArg, args);\n            state.result = result;\n            state.pendingPromises.forEach(({ resolve }) => resolve(result));\n            state.pendingPromises = [];\n            logger.log('Function invoked successfully', result);\n            return result;\n        } catch (error) {\n            const wrappedError = error instanceof Error ? error : new Error(String(error));\n            logger.error('Error in function invocation:', wrappedError);\n            handleError(wrappedError);\n\n            // Clear pending promises after handling error\n            const currentPromises = [...state.pendingPromises];\n            state.pendingPromises = [];\n\n            // Reject all pending promises\n            currentPromises.forEach(({ reject }) => reject(wrappedError));\n        }\n    }\n\n    /**\n     * Starts both the debounce timer and maxWait timer if configured\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function startTimer(time: number): void {\n        const remainingTime = remainingWait(time);\n        state.timerId = setTimeout(timerExpired, remainingTime);\n        logger.log(`Started debounce timer for ${remainingTime}ms`);\n\n        if (maxWait !== undefined && !state.maxTimerId) {\n            const timeToMaxWait = maxWait - (time - state.lastCallTime!);\n            state.maxTimerId = setTimeout(\n                () => {\n                    logger.log('Max wait timer expired');\n                    cancelTimers();\n                    invokeFunc(Date.now());\n                },\n                Math.max(0, timeToMaxWait),\n            );\n            logger.log(`Started max wait timer for ${timeToMaxWait}ms`);\n        }\n    }\n\n    /**\n     * Calculates remaining wait time before next execution\n     * @param {number} time - Current timestamp\n     * @returns {number} Milliseconds until next allowed execution\n     * @private\n     */\n    function remainingWait(time: number): number {\n        const timeSinceLastCall = state.lastCallTime ? time - state.lastCallTime : 0;\n        return Math.max(0, wait - timeSinceLastCall);\n    }\n\n    /**\n     * Handles timer expiration\n     * @private\n     */\n    function timerExpired(): void {\n        const time = Date.now();\n        logger.log('Debounce timer expired');\n\n        if (shouldInvoke(time)) {\n            return trailingEdge(time);\n        }\n\n        startTimer(time);\n    }\n\n    /**\n     * Handles leading edge execution\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function leadingEdge(time: number): void {\n        logger.log('Leading edge triggered');\n        state.lastInvokeTime = time;\n        startTimer(time);\n\n        if (leading) {\n            invokeFunc(time);\n        }\n    }\n\n    /**\n     * Handles trailing edge execution\n     * @param {number} time - Current timestamp\n     * @private\n     */\n    function trailingEdge(time: number): void {\n        logger.log('Trailing edge triggered');\n        cancelTimers();\n\n        if (trailing && state.lastArgs) {\n            invokeFunc(time);\n        } else {\n            state.pendingPromises.forEach(({ resolve }) => {\n                resolve(state.result as Awaited<ReturnType<T>>);\n            });\n            state.pendingPromises = [];\n        }\n    }\n\n    /**\n     * Immediately executes the debounced function\n     * @param {...Parameters<T>} args - Function arguments\n     * @returns {Promise<ReturnType<T>>} Promise resolving to function result\n     */\n    async function flush(...args: Parameters<T>): Promise<Awaited<ReturnType<T>> | void> {\n        logger.log('Flush requested');\n        const argsToUse = args.length > 0 ? args : state.lastArgs;\n        const thisArg = state.lastThis;\n\n        cancelTimers();\n\n        if (argsToUse) {\n            state.lastArgs = argsToUse;\n            state.lastThis = thisArg;\n            return invokeFunc(Date.now());\n        }\n\n        return Promise.resolve(state.result!);\n    }\n\n    /**\n     * Cleans up resources used by the debounced function\n     */\n    function cleanup(): void {\n        logger.log('Cleanup initiated');\n        cancel();\n        privateState.delete(debounced);\n    }\n\n    /**\n     * The debounced function that wraps the original\n     * @param {...Parameters<T>} args - Function arguments\n     * @returns {Promise<ReturnType<T>>} Promise resolving to function result\n     */\n    const debounced = function(\n        this: any,\n        ...args: Parameters<T>\n    ): Promise<Awaited<ReturnType<T>>> {\n        if (state.aborted) {\n            return Promise.reject(new Error('Debounced function aborted'));\n        }\n\n        const time = Date.now();\n        const isInvoking = shouldInvoke(time);\n\n        state.lastArgs = args;\n        state.lastThis = this;\n        state.lastCallTime = time;\n\n        logger.log('Function called', {\n            time,\n            isInvoking,\n            args,\n            pending: pending(),\n        });\n\n        return new Promise((resolve, reject) => {\n            state.pendingPromises.push({ resolve, reject });\n\n            if (state.timerId === undefined) {\n                leadingEdge(time);\n            } else {\n                cancelTimers();\n                startTimer(time);\n            }\n        });\n    } as DebouncedFunction<T>;\n\n    // Store private state\n    privateState.set(debounced, state);\n\n    // Add utility methods\n    Object.defineProperties(debounced, {\n        cancel: { value: cancel, writable: false, configurable: false },\n        flush: { value: flush, writable: false, configurable: false },\n        pending: { value: pending, writable: false, configurable: false },\n        cleanup: { value: cleanup, writable: false, configurable: false },\n    });\n\n    return debounced;\n}\n\nexport { debounce, type DebouncedFunction, type DebounceOptions };\n"],"names":["root","factory","exports","module","define","amd","self","this","__webpack_require__","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","Symbol","toStringTag","value","privateState","WeakMap","createLogger","debug","log","args","console","warn","error","debounce","func","options","TypeError","wait","leading","trailing","maxWait","signal","onError","undefined","RangeError","Error","logger","state","lastInvokeTime","pendingPromises","aborted","cancelTimers","timerId","clearTimeout","maxTimerId","cancel","lastArgs","lastThis","lastCallTime","handleError","forEach","reject","callbackError","pending","shouldInvoke","time","timeSinceLastCall","async","invokeFunc","thisArg","result","apply","resolve","wrappedError","String","currentPromises","startTimer","remainingTime","Math","max","remainingWait","setTimeout","timerExpired","timeToMaxWait","Date","now","trailingEdge","addEventListener","debounced","Promise","isInvoking","push","leadingEdge","set","defineProperties","writable","configurable","flush","argsToUse","length","cleanup","delete"],"sourceRoot":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avatijs/debounce",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Debounce package part of Avati project",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -19,7 +19,7 @@
   },
   "sideEffects": false,
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.20.5"
   },
   "bundlesize": [
     {
@@ -41,19 +41,20 @@
   "scripts": {
     "build": "npm run clean && npm run build:types && npm run build:prod",
     "build:dev": "webpack --mode development --progress",
-    "build:prod": "webpack --mode production --progress",
-    "build:types": "tsc --emitDeclarationOnly --outDir dist/types",
+    "build:prod": "webpack --mode production",
+    "build:types": "tsc --emitDeclarationOnly",
     "watch": "webpack --mode=development --watch",
     "watch:silent": "webpack --mode=development --watch --silent",
     "clean": "rimraf dist",
     "prepublishOnly": "npm run build",
-    "test": "jest",
+    "test": "jest --config jest.config.js",
     "typecheck": "tsc --noEmit",
     "size": "webpack --mode production --json > stats.json && webpack-bundle-analyzer stats.json",
     "analyze:deps": "madge --circular --extensions ts ./src/index.ts",
     "size:check": "bundlesize",
     "size:watch": "bundlesize --watch",
     "size:compression": "bundlesize --compression",
+    "check-deps": "depcheck --config .depcheckrc",
     "analyze": "npm run analyze:size && npm run analyze:deps && npm run analyze:duplicates",
     "analyze:size": "webpack --mode production --json > stats.json && webpack-bundle-analyzer stats.json",
     "analyze:detailed": "webpack --config webpack.analysis.config.js",
@@ -90,6 +91,11 @@
   },
   "keywords": [
     "avati",
+    "scheduler",
+    "batch",
+    "task-queue",
+    "priority-queue",
+    "async",
     "typescript",
     "debounce",
     "debouncer",
@@ -117,6 +123,7 @@
     "@typescript-eslint/eslint-plugin": "^8.15.0",
     "@typescript-eslint/parser": "^8.15.0",
     "bundlesize": "^0.18.2",
+    "depcheck": "^1.4.7",
     "dependency-cruiser": "^16.6.0",
     "eslint": "^8.57.1",
     "jest": "^29.7.0",