debounce

function debounce<Args extends unknown[], R>(
  fn: (...args: Args) => PromiseLike<R> | R,
  waitMs: number,
  options?: DebounceOptions,
): (...args: Args) => Promise<R>

import { debounce } from '@temelj/async';

const search = debounce(async (query: string) => {
  const results = await api.search(query);
  return results;
}, 300);

// Only the last call executes after 300ms
search('a');
search('ab');
search('abc'); // This call executes

import { debounce } from '@temelj/async';

const handleClick = debounce(
  async () => {
    await submitForm();
  },
  1000,
  { leading: true, trailing: false }
);

// Executes immediately on first click, then ignores subsequent clicks for 1s
handleClick();
handleClick(); // Ignored
handleClick(); // Ignored

import { debounce } from '@temelj/async';

const controller = new AbortController();

const autosave = debounce(
  async (data: string) => {
    await saveToServer(data);
  },
  500,
  { signal: controller.signal }
);

autosave('draft 1');
autosave('draft 2');

// Cancel pending autosave
controller.abort();

import { debounce } from '@temelj/async';

const debouncedSearch = debounce(async (query: string) => {
  if (!query) return [];
  const response = await fetch(`/api/search?q=${query}`);
  return await response.json();
}, 300);

input.addEventListener('input', async (e) => {
  const results = await debouncedSearch(e.target.value);
  displayResults(results);
});