@avatijs/debounce 0.1.1 → 0.1.3

package/dist/esm/index.js

@@ -1,7 +1,358 @@
 /*!
- * @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.
- */var e={d:(n,r)=>{for(var o in r)e.o(r,o)&&!e.o(n,o)&&Object.defineProperty(n,o,{enumerable:!0,get:r[o]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)},n={};e.d(n,{s:()=>t});const r=new WeakMap,o=e=>({log:(...n)=>e&&void 0,warn:(...n)=>e&&void 0,error:(...n)=>e&&void 0});function t(e,n={}){if("function"!=typeof e)throw new TypeError("Expected a function");const{wait:t=0,leading:i=!1,trailing:c=!0,maxWait:a,debug:u=!1,signal:d,onError:l}=n;if(0>t||void 0!==a&&t>a)throw new RangeError("Invalid wait/maxWait values");if(!i&&!c)throw Error("At least one of leading or trailing must be true");const s=o(u),f={lastInvokeTime:0,pendingPromises:[],aborted:!1};function v(){void 0!==f.timerId&&(clearTimeout(f.timerId),f.timerId=void 0,s.log("Cleared debounce timer")),void 0!==f.maxTimerId&&(clearTimeout(f.maxTimerId),f.maxTimerId=void 0,s.log("Cleared max wait timer"))}function g(){s.log("Cancelling pending invocations"),v(),f.lastInvokeTime=0,f.lastArgs=void 0,f.lastThis=void 0,f.lastCallTime=void 0,b(Error("Debounced function cancelled")),f.pendingPromises.forEach((({reject:e})=>e(Error("Debounced function cancelled")))),f.pendingPromises=[]}function b(e){if(s.error("Error occurred:",e),l)try{l(e)}catch(e){s.error("Error in onError callback:",e)}}function m(){return void 0!==f.timerId}function w(e){if(f.aborted)return!1;const n=void 0===f.lastCallTime?0:e-f.lastCallTime;return void 0===f.lastCallTime||n>=t||0>n||void 0!==a&&e-f.lastInvokeTime>=a}async function E(n){s.log("Invoking function at "+n),f.lastInvokeTime=n;const r=f.lastArgs,o=f.lastThis;f.lastArgs=void 0,f.lastThis=void 0;try{const n=await e.apply(o,r);return f.result=n,f.pendingPromises.forEach((({resolve:e})=>e(n))),f.pendingPromises=[],s.log("Function invoked successfully",n),n}catch(e){const n=e instanceof Error?e:Error(e+"");s.error("Error in function invocation:",n),b(n);const r=[...f.pendingPromises];f.pendingPromises=[],r.forEach((({reject:e})=>e(n)))}}function p(e){const n=function(e){return Math.max(0,t-(f.lastCallTime?e-f.lastCallTime:0))}(e);if(f.timerId=setTimeout(h,n),s.log(`Started debounce timer for ${n}ms`),void 0!==a&&!f.maxTimerId){const n=a-(e-f.lastCallTime);f.maxTimerId=setTimeout((()=>{s.log("Max wait timer expired"),v(),E(Date.now())}),Math.max(0,n)),s.log(`Started max wait timer for ${n}ms`)}}function h(){const e=Date.now();if(s.log("Debounce timer expired"),w(e))return function(e){s.log("Trailing edge triggered"),v(),c&&f.lastArgs?E(e):(f.pendingPromises.forEach((({resolve:e})=>{e(f.result)})),f.pendingPromises=[])}(e);p(e)}d&&d.addEventListener("abort",(()=>{f.aborted=!0,g()}));const x=function(...e){if(f.aborted)return Promise.reject(Error("Debounced function aborted"));const n=Date.now(),r=w(n);return f.lastArgs=e,f.lastThis=this,f.lastCallTime=n,s.log("Function called",{time:n,isInvoking:r,args:e,pending:m()}),new Promise(((e,r)=>{f.pendingPromises.push({resolve:e,reject:r}),void 0===f.timerId?function(e){s.log("Leading edge triggered"),f.lastInvokeTime=e,p(e),i&&E(e)}(n):(v(),p(n))}))};return r.set(x,f),Object.defineProperties(x,{cancel:{value:g,writable:!1,configurable:!1},flush:{value:async function(...e){s.log("Flush requested");const n=e.length>0?e:f.lastArgs,r=f.lastThis;return v(),n?(f.lastArgs=n,f.lastThis=r,E(Date.now())):Promise.resolve(f.result)},writable:!1,configurable:!1},pending:{value:m,writable:!1,configurable:!1},cleanup:{value:function(){s.log("Cleanup initiated"),g(),r.delete(x)},writable:!1,configurable:!1}}),x}var i=n.s;export{i as debounce};
+ */
+
+/* eslint-disable */
+
+/******/ // 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))
+/******/ })();
+/******/ 
+/************************************************************************/
+var __webpack_exports__ = {};
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  s: () => (/* 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
+
+
+var __webpack_exports__debounce = __webpack_exports__.s;
+export { __webpack_exports__debounce as debounce };
+
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","mappings":"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","sources":["webpack://@avatijs/debounce/webpack/bootstrap","webpack://@avatijs/debounce/webpack/runtime/define property getters","webpack://@avatijs/debounce/webpack/runtime/hasOwnProperty shorthand","webpack://@avatijs/debounce/./src/debouce.ts"],"sourcesContent":["// 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))","/**\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":["__webpack_require__","exports","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","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","this","push","leadingEdge","set","defineProperties","value","writable","configurable","flush","argsToUse","length","cleanup","delete"],"sourceRoot":""}
+{"version":3,"file":"index.js","mappings":"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","sources":["webpack://@avatijs/debounce/webpack/bootstrap","webpack://@avatijs/debounce/webpack/runtime/define property getters","webpack://@avatijs/debounce/webpack/runtime/hasOwnProperty shorthand","webpack://@avatijs/debounce/./src/debouce.ts","webpack://@avatijs/debounce/./src/index.ts"],"sourcesContent":["// 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))","/**\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/esm/index.min.js

@@ -0,0 +1,7 @@
+/*!
+ * @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.
+ */var e={d:(n,r)=>{for(var o in r)e.o(r,o)&&!e.o(n,o)&&Object.defineProperty(n,o,{enumerable:!0,get:r[o]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)},n={};e.d(n,{s:()=>t});const r=new WeakMap,o=e=>({log:(...n)=>e&&void 0,warn:(...n)=>e&&void 0,error:(...n)=>e&&void 0});function t(e,n={}){if("function"!=typeof e)throw new TypeError("Expected a function");const{wait:t=0,leading:i=!1,trailing:c=!0,maxWait:a,debug:u=!1,signal:d,onError:l}=n;if(0>t||void 0!==a&&t>a)throw new RangeError("Invalid wait/maxWait values");if(!i&&!c)throw Error("At least one of leading or trailing must be true");const s=o(u),f={lastInvokeTime:0,pendingPromises:[],aborted:!1};function v(){void 0!==f.timerId&&(clearTimeout(f.timerId),f.timerId=void 0,s.log("Cleared debounce timer")),void 0!==f.maxTimerId&&(clearTimeout(f.maxTimerId),f.maxTimerId=void 0,s.log("Cleared max wait timer"))}function g(){s.log("Cancelling pending invocations"),v(),f.lastInvokeTime=0,f.lastArgs=void 0,f.lastThis=void 0,f.lastCallTime=void 0,b(Error("Debounced function cancelled")),f.pendingPromises.forEach((({reject:e})=>e(Error("Debounced function cancelled")))),f.pendingPromises=[]}function b(e){if(s.error("Error occurred:",e),l)try{l(e)}catch(e){s.error("Error in onError callback:",e)}}function m(){return void 0!==f.timerId}function w(e){if(f.aborted)return!1;const n=void 0===f.lastCallTime?0:e-f.lastCallTime;return void 0===f.lastCallTime||n>=t||0>n||void 0!==a&&e-f.lastInvokeTime>=a}async function E(n){s.log("Invoking function at "+n),f.lastInvokeTime=n;const r=f.lastArgs,o=f.lastThis;f.lastArgs=void 0,f.lastThis=void 0;try{const n=await e.apply(o,r);return f.result=n,f.pendingPromises.forEach((({resolve:e})=>e(n))),f.pendingPromises=[],s.log("Function invoked successfully",n),n}catch(e){const n=e instanceof Error?e:Error(e+"");s.error("Error in function invocation:",n),b(n);const r=[...f.pendingPromises];f.pendingPromises=[],r.forEach((({reject:e})=>e(n)))}}function p(e){const n=function(e){return Math.max(0,t-(f.lastCallTime?e-f.lastCallTime:0))}(e);if(f.timerId=setTimeout(h,n),s.log(`Started debounce timer for ${n}ms`),void 0!==a&&!f.maxTimerId){const n=a-(e-f.lastCallTime);f.maxTimerId=setTimeout((()=>{s.log("Max wait timer expired"),v(),E(Date.now())}),Math.max(0,n)),s.log(`Started max wait timer for ${n}ms`)}}function h(){const e=Date.now();if(s.log("Debounce timer expired"),w(e))return function(e){s.log("Trailing edge triggered"),v(),c&&f.lastArgs?E(e):(f.pendingPromises.forEach((({resolve:e})=>{e(f.result)})),f.pendingPromises=[])}(e);p(e)}d&&d.addEventListener("abort",(()=>{f.aborted=!0,g()}));const x=function(...e){if(f.aborted)return Promise.reject(Error("Debounced function aborted"));const n=Date.now(),r=w(n);return f.lastArgs=e,f.lastThis=this,f.lastCallTime=n,s.log("Function called",{time:n,isInvoking:r,args:e,pending:m()}),new Promise(((e,r)=>{f.pendingPromises.push({resolve:e,reject:r}),void 0===f.timerId?function(e){s.log("Leading edge triggered"),f.lastInvokeTime=e,p(e),i&&E(e)}(n):(v(),p(n))}))};return r.set(x,f),Object.defineProperties(x,{cancel:{value:g,writable:!1,configurable:!1},flush:{value:async function(...e){s.log("Flush requested");const n=e.length>0?e:f.lastArgs,r=f.lastThis;return v(),n?(f.lastArgs=n,f.lastThis=r,E(Date.now())):Promise.resolve(f.result)},writable:!1,configurable:!1},pending:{value:m,writable:!1,configurable:!1},cleanup:{value:function(){s.log("Cleanup initiated"),g(),r.delete(x)},writable:!1,configurable:!1}}),x}var i=n.s;export{i as debounce};
+//# sourceMappingURL=index.min.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.min.js","mappings":"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","sources":["webpack://@avatijs/debounce/webpack/bootstrap","webpack://@avatijs/debounce/webpack/runtime/define property getters","webpack://@avatijs/debounce/webpack/runtime/hasOwnProperty shorthand","webpack://@avatijs/debounce/./src/debouce.ts"],"sourcesContent":["// 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))","/**\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":["__webpack_require__","exports","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","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","this","push","leadingEdge","set","defineProperties","value","writable","configurable","flush","argsToUse","length","cleanup","delete"],"sourceRoot":""}

package/dist/types/debouce.d.ts

@@ -70,3 +70,4 @@ interface DebouncedFunction<T extends AnyFunction> {
  */
 declare function debounce<T extends AnyFunction>(func: T, options?: DebounceOptions): DebouncedFunction<T>;
 export { debounce, type DebouncedFunction, type DebounceOptions };
+//# sourceMappingURL=debouce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debouce.d.ts","sourceRoot":"","sources":["../../src/debouce.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;GAGG;AACH,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAE3C;;;GAGG;AACH,UAAU,eAAe;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,UAAU,iBAAiB,CAAC,CAAC,SAAS,WAAW;IAC7C,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAE7B,qDAAqD;IACrD,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7D;AA+CD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,QAAQ,CAAC,CAAC,SAAS,WAAW,EACnC,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,eAAoB,GAC9B,iBAAiB,CAAC,CAAC,CAAC,CAiUtB;AAED,OAAO,EAAE,QAAQ,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/dist/types/index.d.ts

@@ -1 +1,2 @@
 export * from './debouce';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}