Function debounce

apps/wallet/src/utils/helper.utils.ts:702–734

(
  debouncedFunction: T,
  wait: number = 500,
  opts: { immediate?: boolean | number } = {},
)

 * @returns The debounced function.
 */
export const debounce = <T extends (...args: Parameters<T>) => ReturnType<T>>(
  debouncedFunction: T,
  wait: number = 500,
  opts: { immediate?: boolean | number } = {},
): ((...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>) => {
  let timeout: NodeJS.Timeout | null = null;
  let isFirstCall = true;
  const immediateMs =
    (typeof opts.immediate === 'number' && opts.immediate >= 0) || opts.immediate === true
      ? Number(opts.immediate)
      : false;

  return (...args: Parameters<T>): Promise<Awaited<ReturnType<T>>> => {
    const waitMs = isFirstCall && immediateMs !== false ? immediateMs : wait;
    isFirstCall = false;

    return new Promise((resolve, reject) => {
      if (timeout) {
        clearTimeout(timeout);
      }

      timeout = setTimeout(() => {
        try {
          const result = debouncedFunction(...args);

          return Promise.resolve(result).then(resolve).catch(reject);
        } catch (error) {
          reject(error);
        }
      }, waitMs);
    });
  };
};