@vinicunca/perkakas 1.9.0 → 1.13.0

package/dist/funnel.perkakas-debounce.test.js

@@ -1,2 +1,2 @@
-import{describe as e,globalExpect as t,it as n,vi as r}from"./dist-C2nNPffG.js";import{constant as i}from"./constant-DrpDXHc7.js";import{funnel as a}from"./funnel-CEbURcmp.js";import{identity as o}from"./identity-D7NWGnLw.js";import{sleep as s}from"./sleep-DvzRMgY-.js";function c(e,{timing:t,waitMs:n,maxWaitMs:r}){if(r!==void 0&&n!==void 0&&r<n)throw Error(`debounce: maxWaitMs (${r.toString()}) cannot be less than waitMs (${n.toString()})`);let i,o=a(t=>{i=e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:n??r??0,...r!==void 0&&{maxBurstDurationMs:r},...t===`leading`?{triggerAt:`start`}:t===`both`?{triggerAt:`both`}:{triggerAt:`end`}});return{call:(...e)=>(o.call(...e),i),flush:()=>(o.flush(),i),cancel:()=>{o.cancel()},get isPending(){return!o.isIdle},get cachedValue(){return i}}}e(`main functionality`,()=>{n(`should debounce a function`,async()=>{let e=r.fn(o()),n=c(e,{waitMs:32});t([n.call(`a`),n.call(`b`),n.call(`c`)]).toStrictEqual([void 0,void 0,void 0]),t(e).toHaveBeenCalledTimes(0),await s(128),t(e).toHaveBeenCalledTimes(1),t([n.call(`d`),n.call(`e`),n.call(`f`)]).toStrictEqual([`c`,`c`,`c`]),t(e).toHaveBeenCalledTimes(1),await s(256),t(e).toHaveBeenCalledTimes(2)}),n("subsequent debounced calls return the last `func` result",async()=>{let e=c(o(),{waitMs:32});e.call(`a`),await s(64),t(e.call(`b`)).toBe(`a`),await s(128),t(e.call(`c`)).toBe(`b`)}),n("should not immediately call `func` when `wait` is `0`",async()=>{let e=r.fn(),n=c(e,{});n.call(),n.call(),t(e).toHaveBeenCalledTimes(0),await s(5),t(e).toHaveBeenCalledTimes(1)}),n(`should apply default options`,async()=>{let e=r.fn();c(e,{waitMs:32}).call(),t(e).toHaveBeenCalledTimes(0),await s(64),t(e).toHaveBeenCalledTimes(1)}),n("should support a `leading` option",async()=>{let e=r.fn(),n=r.fn(),i=c(e,{waitMs:32,timing:`leading`});i.call(),t(e).toHaveBeenCalledTimes(1);let a=c(n,{waitMs:32,timing:`both`});a.call(),a.call(),t(n).toHaveBeenCalledTimes(1),await s(64),t(n).toHaveBeenCalledTimes(2),i.call(),t(e).toHaveBeenCalledTimes(2)}),n("subsequent leading debounced calls return the last `func` result",async()=>{let e=c(o(),{waitMs:32,timing:`leading`});t([e.call(`a`),e.call(`b`)]).toStrictEqual([`a`,`a`]),await s(64),t([e.call(`c`),e.call(`d`)]).toStrictEqual([`c`,`c`])}),n("should support a `trailing` option",async()=>{let e=r.fn();c(e,{waitMs:32,timing:`trailing`}).call(),t(e).toHaveBeenCalledTimes(0),await s(64),t(e).toHaveBeenCalledTimes(1)})}),e(`optional param maxWaitMs`,()=>{n("should support a `maxWait` option",async()=>{let e=r.fn(),n=c(e,{waitMs:32,maxWaitMs:64});n.call(`a`),n.call(`b`),t(e).toHaveBeenCalledTimes(0),await s(128),t(e).toHaveBeenCalledTimes(1),n.call(`c`),n.call(`d`),t(e).toHaveBeenCalledTimes(1),await s(256),t(e).toHaveBeenCalledTimes(2)}),n("should support `maxWait` in a tight loop",async()=>{let e=r.fn(),n=r.fn(),i=c(e,{waitMs:32,maxWaitMs:128}),a=c(n,{waitMs:96}),o=Date.now();for(;Date.now()-o<320;)i.call(),a.call();await s(1),t(n).toHaveBeenCalledTimes(0),t(e).not.toHaveBeenCalledTimes(0)}),n("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let e=r.fn(),n=c(e,{waitMs:200,maxWaitMs:200});n.call(),setTimeout(()=>{n.call()},190),setTimeout(()=>{n.call()},200),setTimeout(()=>{n.call()},210),await s(500),t(e).toHaveBeenCalledTimes(2)}),n("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let e=r.fn(),n=c(e,{waitMs:32,maxWaitMs:64});n.call(),await s(128),n.call(),t(e).toHaveBeenCalledTimes(1),await s(192),t(e).toHaveBeenCalledTimes(2)}),n(`works like a leaky bucket when only maxWaitMs is set`,async()=>{let e=r.fn(),n=c(e,{maxWaitMs:32});n.call(),t(e).toHaveBeenCalledTimes(0),await s(16),n.call(),t(e).toHaveBeenCalledTimes(0),await s(17),t(e).toHaveBeenCalledTimes(1)})}),e(`additional functionality`,()=>{n(`can cancel before the timer starts`,async()=>{let e=c(o(),{waitMs:32});t(()=>{e.cancel()}).not.toThrow(),t(e.call(`hello`)).toBeUndefined(),await s(32),t(e.call(`world`)).toBe(`hello`)}),n(`can cancel the timer`,async()=>{let e=r.fn(i(`Hello, World!`)),n=c(e,{waitMs:32});t(n.call()).toBeUndefined(),t(e).toHaveBeenCalledTimes(0),await s(1),t(n.call()).toBeUndefined(),t(e).toHaveBeenCalledTimes(0),n.cancel(),await s(32),t(n.call()).toBeUndefined(),t(e).toHaveBeenCalledTimes(0),await s(32),t(n.call()).toBe(`Hello, World!`),t(e).toHaveBeenCalledTimes(1)}),n(`can cancel after the timer ends`,async()=>{let e=c(o(),{waitMs:32});t(e.call(`hello`)).toBeUndefined(),await s(32),t(e.call(`world`)).toBe(`hello`),t(()=>{e.cancel()}).not.toThrow()}),n(`can cancel maxWait timer`,async()=>{let e=c(o(),{waitMs:16,maxWaitMs:32});t(e.call(`hello`)).toBeUndefined(),await s(1),e.cancel(),await s(32),t(e.call(`world`)).toBeUndefined()}),n(`can return a cached value`,()=>{let e=c(o(),{timing:`leading`,waitMs:32});t(e.cachedValue).toBeUndefined(),t(e.call(`hello`)).toBe(`hello`),t(e.cachedValue).toBe(`hello`)}),n(`can check for inflight timers (trailing)`,async()=>{let e=c(o(),{waitMs:32});t(e.isPending).toBe(!1),t(e.call(`hello`)).toBeUndefined(),t(e.isPending).toBe(!0),await s(1),t(e.isPending).toBe(!0),await s(32),t(e.isPending).toBe(!1)}),n(`can check for inflight timers (leading)`,async()=>{let e=c(o(),{timing:`leading`,waitMs:32});t(e.isPending).toBe(!1),t(e.call(`hello`)).toBe(`hello`),t(e.isPending).toBe(!0),await s(1),t(e.isPending).toBe(!0),await s(32),t(e.isPending).toBe(!1)}),n(`can flush before a cool-down`,async()=>{let e=c(o(),{waitMs:32});t(e.flush()).toBeUndefined(),t(e.call(`hello`)).toBeUndefined(),await s(32),t(e.call(`world`)).toBe(`hello`)}),n(`can flush during a cool-down`,async()=>{let e=c(o(),{waitMs:32});t(e.call(`hello`)).toBeUndefined(),await s(1),t(e.call(`world`)).toBeUndefined(),await s(1),t(e.flush()).toBe(`world`)}),n(`can flush after a cool-down`,async()=>{let e=c(o(),{waitMs:32});t(e.call(`hello`)).toBeUndefined(),await s(32),t(e.flush()).toBe(`hello`)})}),e(`errors`,()=>{n(`prevents maxWaitMs to be less then waitMs`,()=>{t(()=>c(o(),{waitMs:32,maxWaitMs:16})).toThrow(`debounce: maxWaitMs (16) cannot be less than waitMs (32)`)})});
+import{constant as e}from"./constant.js";import{a as t,i as n,n as r,r as i}from"./dist-Bd1vawFi.js";import{funnel as a}from"./funnel.js";import{identity as o}from"./identity.js";import{sleep as s}from"./sleep.js";function c(e,{timing:t,waitMs:n,maxWaitMs:r}){if(r!==void 0&&n!==void 0&&r<n)throw Error(`debounce: maxWaitMs (${r.toString()}) cannot be less than waitMs (${n.toString()})`);let i,o=a(t=>{i=e(...t)},{reducer:(e,...t)=>t,minQuietPeriodMs:n??r??0,...r!==void 0&&{maxBurstDurationMs:r},...t===`leading`?{triggerAt:`start`}:t===`both`?{triggerAt:`both`}:{triggerAt:`end`}});return{call:(...e)=>(o.call(...e),i),flush:()=>(o.flush(),i),cancel:()=>{o.cancel()},get isPending(){return!o.isIdle},get cachedValue(){return i}}}n(`main functionality`,()=>{t(`should debounce a function`,async()=>{let e=i.fn(o()),t=c(e,{waitMs:32});r([t.call(`a`),t.call(`b`),t.call(`c`)]).toStrictEqual([void 0,void 0,void 0]),r(e).toHaveBeenCalledTimes(0),await s(128),r(e).toHaveBeenCalledTimes(1),r([t.call(`d`),t.call(`e`),t.call(`f`)]).toStrictEqual([`c`,`c`,`c`]),r(e).toHaveBeenCalledTimes(1),await s(256),r(e).toHaveBeenCalledTimes(2)}),t("subsequent debounced calls return the last `func` result",async()=>{let e=c(o(),{waitMs:32});e.call(`a`),await s(64),r(e.call(`b`)).toBe(`a`),await s(128),r(e.call(`c`)).toBe(`b`)}),t("should not immediately call `func` when `wait` is `0`",async()=>{let e=i.fn(),t=c(e,{});t.call(),t.call(),r(e).toHaveBeenCalledTimes(0),await s(5),r(e).toHaveBeenCalledTimes(1)}),t(`should apply default options`,async()=>{let e=i.fn();c(e,{waitMs:32}).call(),r(e).toHaveBeenCalledTimes(0),await s(64),r(e).toHaveBeenCalledTimes(1)}),t("should support a `leading` option",async()=>{let e=i.fn(),t=i.fn(),n=c(e,{waitMs:32,timing:`leading`});n.call(),r(e).toHaveBeenCalledTimes(1);let a=c(t,{waitMs:32,timing:`both`});a.call(),a.call(),r(t).toHaveBeenCalledTimes(1),await s(64),r(t).toHaveBeenCalledTimes(2),n.call(),r(e).toHaveBeenCalledTimes(2)}),t("subsequent leading debounced calls return the last `func` result",async()=>{let e=c(o(),{waitMs:32,timing:`leading`});r([e.call(`a`),e.call(`b`)]).toStrictEqual([`a`,`a`]),await s(64),r([e.call(`c`),e.call(`d`)]).toStrictEqual([`c`,`c`])}),t("should support a `trailing` option",async()=>{let e=i.fn();c(e,{waitMs:32,timing:`trailing`}).call(),r(e).toHaveBeenCalledTimes(0),await s(64),r(e).toHaveBeenCalledTimes(1)})}),n(`optional param maxWaitMs`,()=>{t("should support a `maxWait` option",async()=>{let e=i.fn(),t=c(e,{waitMs:32,maxWaitMs:64});t.call(`a`),t.call(`b`),r(e).toHaveBeenCalledTimes(0),await s(128),r(e).toHaveBeenCalledTimes(1),t.call(`c`),t.call(`d`),r(e).toHaveBeenCalledTimes(1),await s(256),r(e).toHaveBeenCalledTimes(2)}),t("should support `maxWait` in a tight loop",async()=>{let e=i.fn(),t=i.fn(),n=c(e,{waitMs:32,maxWaitMs:128}),a=c(t,{waitMs:96}),o=Date.now();for(;Date.now()-o<320;)n.call(),a.call();await s(1),r(t).toHaveBeenCalledTimes(0),r(e).not.toHaveBeenCalledTimes(0)}),t("should queue a trailing call for subsequent debounced calls after `maxWait`",async()=>{let e=i.fn(),t=c(e,{waitMs:200,maxWaitMs:200});t.call(),setTimeout(()=>{t.call()},190),setTimeout(()=>{t.call()},200),setTimeout(()=>{t.call()},210),await s(500),r(e).toHaveBeenCalledTimes(2)}),t("should cancel `maxDelayed` when `delayed` is invoked",async()=>{let e=i.fn(),t=c(e,{waitMs:32,maxWaitMs:64});t.call(),await s(128),t.call(),r(e).toHaveBeenCalledTimes(1),await s(192),r(e).toHaveBeenCalledTimes(2)}),t(`works like a leaky bucket when only maxWaitMs is set`,async()=>{let e=i.fn(),t=c(e,{maxWaitMs:32});t.call(),r(e).toHaveBeenCalledTimes(0),await s(16),t.call(),r(e).toHaveBeenCalledTimes(0),await s(17),r(e).toHaveBeenCalledTimes(1)})}),n(`additional functionality`,()=>{t(`can cancel before the timer starts`,async()=>{let e=c(o(),{waitMs:32});r(()=>{e.cancel()}).not.toThrowError(),r(e.call(`hello`)).toBeUndefined(),await s(32),r(e.call(`world`)).toBe(`hello`)}),t(`can cancel the timer`,async()=>{let t=i.fn(e(`Hello, World!`)),n=c(t,{waitMs:32});r(n.call()).toBeUndefined(),r(t).toHaveBeenCalledTimes(0),await s(1),r(n.call()).toBeUndefined(),r(t).toHaveBeenCalledTimes(0),n.cancel(),await s(32),r(n.call()).toBeUndefined(),r(t).toHaveBeenCalledTimes(0),await s(32),r(n.call()).toBe(`Hello, World!`),r(t).toHaveBeenCalledTimes(1)}),t(`can cancel after the timer ends`,async()=>{let e=c(o(),{waitMs:32});r(e.call(`hello`)).toBeUndefined(),await s(32),r(e.call(`world`)).toBe(`hello`),r(()=>{e.cancel()}).not.toThrowError()}),t(`can cancel maxWait timer`,async()=>{let e=c(o(),{waitMs:16,maxWaitMs:32});r(e.call(`hello`)).toBeUndefined(),await s(1),e.cancel(),await s(32),r(e.call(`world`)).toBeUndefined()}),t(`can return a cached value`,()=>{let e=c(o(),{timing:`leading`,waitMs:32});r(e.cachedValue).toBeUndefined(),r(e.call(`hello`)).toBe(`hello`),r(e.cachedValue).toBe(`hello`)}),t(`can check for inflight timers (trailing)`,async()=>{let e=c(o(),{waitMs:32});r(e.isPending).toBe(!1),r(e.call(`hello`)).toBeUndefined(),r(e.isPending).toBe(!0),await s(1),r(e.isPending).toBe(!0),await s(32),r(e.isPending).toBe(!1)}),t(`can check for inflight timers (leading)`,async()=>{let e=c(o(),{timing:`leading`,waitMs:32});r(e.isPending).toBe(!1),r(e.call(`hello`)).toBe(`hello`),r(e.isPending).toBe(!0),await s(1),r(e.isPending).toBe(!0),await s(32),r(e.isPending).toBe(!1)}),t(`can flush before a cool-down`,async()=>{let e=c(o(),{waitMs:32});r(e.flush()).toBeUndefined(),r(e.call(`hello`)).toBeUndefined(),await s(32),r(e.call(`world`)).toBe(`hello`)}),t(`can flush during a cool-down`,async()=>{let e=c(o(),{waitMs:32});r(e.call(`hello`)).toBeUndefined(),await s(1),r(e.call(`world`)).toBeUndefined(),await s(1),r(e.flush()).toBe(`world`)}),t(`can flush after a cool-down`,async()=>{let e=c(o(),{waitMs:32});r(e.call(`hello`)).toBeUndefined(),await s(32),r(e.flush()).toBe(`hello`)})}),n(`errors`,()=>{t(`prevents maxWaitMs to be less then waitMs`,()=>{r(()=>c(o(),{waitMs:32,maxWaitMs:16})).toThrowError(`debounce: maxWaitMs (16) cannot be less than waitMs (32)`)})});
 //# sourceMappingURL=funnel.perkakas-debounce.test.js.map

package/dist/funnel.perkakas-debounce.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"funnel.perkakas-debounce.test.js","names":["cachedValue: ReturnType<F> | undefined"],"sources":["../src/funnel.perkakas-debounce.test.ts"],"sourcesContent":["/* eslint-disable function-paren-newline, no-nested-ternary, ts/explicit-function-return-type, ts/no-explicit-any --\n * These aren't useful for a reference implementation!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { funnel } from './funnel';\nimport { identity } from './identity';\nimport { sleep } from './sleep';\n\ninterface Debouncer<\n  F extends (...args: any) => unknown,\n  IsNullable extends boolean = true,\n> {\n  readonly call: (\n    ...args: Parameters<F>\n  ) => ReturnType<F> | (true extends IsNullable ? undefined : never);\n  readonly cancel: () => void;\n  readonly flush: () => ReturnType<F> | undefined;\n  readonly isPending: boolean;\n  readonly cachedValue: ReturnType<F> | undefined;\n}\n\ninterface DebounceOptions {\n  readonly waitMs?: number;\n  readonly maxWaitMs?: number;\n}\n\n/**\n * A reference implementation of the now deprecated `debounce` function using\n * the `funnel` function instead. While you update your codebase you can copy\n * this function as-is and use it as a drop-in replacement; but we recommend\n * eventually inlining the call to `funnel` so you can adjust the function to\n * your specific needs.\n *\n * The following tests in this file are the original tests for debounce.\n *\n * @see debounce\n */\nfunction debounce<F extends (...args: any) => any>(\n  func: F,\n  options: DebounceOptions & { readonly timing?: 'trailing' },\n): Debouncer<F>;\nfunction debounce<F extends (...args: any) => any>(\n  func: F,\n  options:\n    | (DebounceOptions & { readonly timing: 'both' })\n    | (Omit<DebounceOptions, 'maxWaitMs'> & { readonly timing: 'leading' }),\n): Debouncer<F, false>;\nfunction debounce<F extends (...args: any) => any>(\n  func: F,\n  {\n    timing,\n    waitMs,\n    maxWaitMs,\n  }: DebounceOptions & {\n    readonly timing?: 'both' | 'leading' | 'trailing';\n  },\n) {\n  if (maxWaitMs !== undefined && waitMs !== undefined && maxWaitMs < waitMs) {\n    throw new Error(\n      `debounce: maxWaitMs (${maxWaitMs.toString()}) cannot be less than waitMs (${waitMs.toString()})`,\n    );\n  }\n\n  let cachedValue: ReturnType<F> | undefined;\n\n  const debouncingFunnel = funnel(\n    (args: Parameters<F>) => {\n      // Every time the function is invoked the cached value is updated.\n      cachedValue = func(...args) as ReturnType<F>;\n    },\n    {\n      // Debounce stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: waitMs ?? maxWaitMs ?? 0,\n      ...(maxWaitMs !== undefined && { maxBurstDurationMs: maxWaitMs }),\n      ...(timing === 'leading'\n        ? { triggerAt: 'start' }\n        : timing === 'both'\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }),\n    },\n  );\n\n  return {\n    call: (...args: Parameters<F>) => {\n      debouncingFunnel.call(...args);\n      return cachedValue;\n    },\n\n    flush: () => {\n      debouncingFunnel.flush();\n      return cachedValue;\n    },\n\n    cancel: () => {\n      debouncingFunnel.cancel();\n    },\n\n    get isPending() {\n      return !debouncingFunnel.isIdle;\n    },\n\n    get cachedValue() {\n      return cachedValue;\n    },\n  };\n}\n\ndescribe('main functionality', () => {\n  it('should debounce a function', async () => {\n    const mockFn = vi.fn<(x: string) => string>(identity());\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n\n    expect([\n      debouncer.call('a'),\n      debouncer.call('b'),\n      debouncer.call('c'),\n    ]).toStrictEqual([undefined, undefined, undefined]);\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(128);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect([\n      debouncer.call('d'),\n      debouncer.call('e'),\n      debouncer.call('f'),\n    ]).toStrictEqual(['c', 'c', 'c']);\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(256);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent debounced calls return the last `func` result', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n    debouncer.call('a');\n    await sleep(64);\n\n    expect(debouncer.call('b')).toBe('a');\n\n    await sleep(128);\n\n    expect(debouncer.call('c')).toBe('b');\n  });\n\n  it('should not immediately call `func` when `wait` is `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, {});\n    debouncer.call();\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(5);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should apply default options', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(64);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should support a `leading` option', async () => {\n    const leadingMockFn = vi.fn<() => void>();\n    const bothMockFn = vi.fn<() => void>();\n    const withLeading = debounce(leadingMockFn, {\n      waitMs: 32,\n      timing: 'leading',\n    });\n    withLeading.call();\n\n    expect(leadingMockFn).toHaveBeenCalledTimes(1);\n\n    const withLeadingAndTrailing = debounce(bothMockFn, {\n      waitMs: 32,\n      timing: 'both',\n    });\n    withLeadingAndTrailing.call();\n    withLeadingAndTrailing.call();\n\n    expect(bothMockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(64);\n\n    expect(bothMockFn).toHaveBeenCalledTimes(2);\n\n    withLeading.call();\n\n    expect(leadingMockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent leading debounced calls return the last `func` result', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32, timing: 'leading' });\n\n    expect([debouncer.call('a'), debouncer.call('b')]).toStrictEqual([\n      'a',\n      'a',\n    ]);\n\n    await sleep(64);\n\n    expect([debouncer.call('c'), debouncer.call('d')]).toStrictEqual([\n      'c',\n      'c',\n    ]);\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockFn = vi.fn<() => void>();\n    const withTrailing = debounce(mockFn, { waitMs: 32, timing: 'trailing' });\n    withTrailing.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(64);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('optional param maxWaitMs', () => {\n  it('should support a `maxWait` option', async () => {\n    const mockFn = vi.fn<(x: string) => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32, maxWaitMs: 64 });\n    debouncer.call('a');\n    debouncer.call('b');\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(128);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    debouncer.call('c');\n    debouncer.call('d');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(256);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support `maxWait` in a tight loop', async () => {\n    const withMockFn = vi.fn<() => void>();\n    const withoutMockFn = vi.fn<() => void>();\n    const withMaxWait = debounce(withMockFn, { waitMs: 32, maxWaitMs: 128 });\n    const withoutMaxWait = debounce(withoutMockFn, { waitMs: 96 });\n    const start = Date.now();\n    while (Date.now() - start < 320) {\n      withMaxWait.call();\n      withoutMaxWait.call();\n    }\n    await sleep(1);\n\n    expect(withoutMockFn).toHaveBeenCalledTimes(0);\n    expect(withMockFn).not.toHaveBeenCalledTimes(0);\n  });\n\n  it('should queue a trailing call for subsequent debounced calls after `maxWait`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 200, maxWaitMs: 200 });\n    debouncer.call();\n    setTimeout(() => {\n      debouncer.call();\n    }, 190);\n    setTimeout(() => {\n      debouncer.call();\n    }, 200);\n    setTimeout(() => {\n      debouncer.call();\n    }, 210);\n    await sleep(500);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should cancel `maxDelayed` when `delayed` is invoked', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32, maxWaitMs: 64 });\n    debouncer.call();\n    await sleep(128);\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(192);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('works like a leaky bucket when only maxWaitMs is set', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { maxWaitMs: 32 });\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(16);\n    // Without maxWaitMs this call would cause the actual invocation to be\n    // postponed for a full window.\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(17);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('additional functionality', () => {\n  it('can cancel before the timer starts', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(() => {\n      debouncer.cancel();\n    }).not.toThrow();\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n  });\n\n  it('can cancel the timer', async () => {\n    const mockFn = vi.fn<() => string>(constant('Hello, World!'));\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(1);\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    debouncer.cancel();\n    await sleep(32);\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(32);\n\n    expect(debouncer.call()).toBe('Hello, World!');\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('can cancel after the timer ends', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n    expect(() => {\n      debouncer.cancel();\n    }).not.toThrow();\n  });\n\n  it('can cancel maxWait timer', async () => {\n    const debouncer = debounce(identity(), { waitMs: 16, maxWaitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(1);\n    debouncer.cancel();\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBeUndefined();\n  });\n\n  it('can return a cached value', () => {\n    const debouncer = debounce(identity(), { timing: 'leading', waitMs: 32 });\n\n    expect(debouncer.cachedValue).toBeUndefined();\n    expect(debouncer.call('hello')).toBe('hello');\n    expect(debouncer.cachedValue).toBe('hello');\n  });\n\n  it('can check for inflight timers (trailing)', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.isPending).toBe(false);\n    expect(debouncer.call('hello')).toBeUndefined();\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(1);\n\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(32);\n\n    expect(debouncer.isPending).toBe(false);\n  });\n\n  it('can check for inflight timers (leading)', async () => {\n    const debouncer = debounce(identity(), { timing: 'leading', waitMs: 32 });\n\n    expect(debouncer.isPending).toBe(false);\n    expect(debouncer.call('hello')).toBe('hello');\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(1);\n\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(32);\n\n    expect(debouncer.isPending).toBe(false);\n  });\n\n  it('can flush before a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.flush()).toBeUndefined();\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n  });\n\n  it('can flush during a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(1);\n\n    expect(debouncer.call('world')).toBeUndefined();\n\n    await sleep(1);\n\n    expect(debouncer.flush()).toBe('world');\n  });\n\n  it('can flush after a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.flush()).toBe('hello');\n  });\n});\n\ndescribe('errors', () => {\n  it('prevents maxWaitMs to be less then waitMs', () => {\n    expect(() => debounce(identity(), { waitMs: 32, maxWaitMs: 16 })).toThrow(\n      'debounce: maxWaitMs (16) cannot be less than waitMs (32)',\n    );\n  });\n});\n"],"mappings":"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"}
+{"version":3,"file":"funnel.perkakas-debounce.test.js","names":["cachedValue: ReturnType<F> | undefined"],"sources":["../src/funnel.perkakas-debounce.test.ts"],"sourcesContent":["/* eslint-disable no-nested-ternary, ts/explicit-function-return-type --\n * These aren't useful for a reference implementation!\n */\n\nimport type { StrictFunction } from './internal/types/strict-function';\nimport { describe, expect, it, vi } from 'vitest';\nimport { constant } from './constant';\nimport { funnel } from './funnel';\nimport { identity } from './identity';\nimport { sleep } from './sleep';\n\ninterface Debouncer<F extends StrictFunction, IsNullable extends boolean = true> {\n  readonly call: (\n    ...args: Parameters<F>\n  ) => ReturnType<F> | (true extends IsNullable ? undefined : never);\n  readonly cancel: () => void;\n  readonly flush: () => ReturnType<F> | undefined;\n  readonly isPending: boolean;\n  readonly cachedValue: ReturnType<F> | undefined;\n}\n\ninterface DebounceOptions {\n  readonly waitMs?: number;\n  readonly maxWaitMs?: number;\n}\n\n/**\n * A reference implementation of the now deprecated `debounce` function using\n * the `funnel` function instead. While you update your codebase you can copy\n * this function as-is and use it as a drop-in replacement; but we recommend\n * eventually inlining the call to `funnel` so you can adjust the function to\n * your specific needs.\n *\n * The following tests in this file are the original tests for debounce.\n *\n * @see debounce\n */\nfunction debounce<F extends StrictFunction>(\n  func: F,\n  options: DebounceOptions & { readonly timing?: 'trailing' },\n): Debouncer<F>;\nfunction debounce<F extends StrictFunction>(\n  func: F,\n  options:\n    | (DebounceOptions & { readonly timing: 'both' })\n    | (Omit<DebounceOptions, 'maxWaitMs'> & { readonly timing: 'leading' }),\n): Debouncer<F, false>;\nfunction debounce<F extends StrictFunction>(\n  func: F,\n  {\n    timing,\n    waitMs,\n    maxWaitMs,\n  }: DebounceOptions & {\n    readonly timing?: 'both' | 'leading' | 'trailing';\n  },\n) {\n  if (maxWaitMs !== undefined && waitMs !== undefined && maxWaitMs < waitMs) {\n    throw new Error(\n      `debounce: maxWaitMs (${maxWaitMs.toString()}) cannot be less than waitMs (${waitMs.toString()})`,\n    );\n  }\n\n  let cachedValue: ReturnType<F> | undefined;\n\n  const debouncingFunnel = funnel(\n    (args: Parameters<F>) => {\n      // @ts-expect-error [ts2345, ts2322] -- TypeScript infers the generic sub-\n      // types too eagerly, making itself blind to the fact that the types\n      // match here.\n      cachedValue = func(...args) as ReturnType<F>;\n    },\n    {\n      // Debounce stores the latest args it was called with for the next invocation of the callback.\n      reducer: (_, ...args: Parameters<F>) => args,\n      minQuietPeriodMs: waitMs ?? maxWaitMs ?? 0,\n      ...(maxWaitMs !== undefined && { maxBurstDurationMs: maxWaitMs }),\n      ...(timing === 'leading'\n        ? { triggerAt: 'start' }\n        : timing === 'both'\n          ? { triggerAt: 'both' }\n          : { triggerAt: 'end' }),\n    },\n  );\n\n  return {\n    call: (...args: Parameters<F>) => {\n      debouncingFunnel.call(...args);\n      return cachedValue;\n    },\n\n    flush: () => {\n      debouncingFunnel.flush();\n      return cachedValue;\n    },\n\n    cancel: () => {\n      debouncingFunnel.cancel();\n    },\n\n    get isPending() {\n      return !debouncingFunnel.isIdle;\n    },\n\n    get cachedValue() {\n      return cachedValue;\n    },\n  };\n}\n\ndescribe('main functionality', () => {\n  it('should debounce a function', async () => {\n    const mockFn = vi.fn<(x: string) => string>(identity());\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n\n    expect([\n      debouncer.call('a'),\n      debouncer.call('b'),\n      debouncer.call('c'),\n    ]).toStrictEqual([undefined, undefined, undefined]);\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(128);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n    expect([\n      debouncer.call('d'),\n      debouncer.call('e'),\n      debouncer.call('f'),\n    ]).toStrictEqual(['c', 'c', 'c']);\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(256);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent debounced calls return the last `func` result', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n    debouncer.call('a');\n    await sleep(64);\n\n    expect(debouncer.call('b')).toBe('a');\n\n    await sleep(128);\n\n    expect(debouncer.call('c')).toBe('b');\n  });\n\n  it('should not immediately call `func` when `wait` is `0`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, {});\n    debouncer.call();\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(5);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should apply default options', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(64);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('should support a `leading` option', async () => {\n    const leadingMockFn = vi.fn<() => void>();\n    const bothMockFn = vi.fn<() => void>();\n    const withLeading = debounce(leadingMockFn, {\n      waitMs: 32,\n      timing: 'leading',\n    });\n    withLeading.call();\n\n    expect(leadingMockFn).toHaveBeenCalledTimes(1);\n\n    const withLeadingAndTrailing = debounce(bothMockFn, {\n      waitMs: 32,\n      timing: 'both',\n    });\n    withLeadingAndTrailing.call();\n    withLeadingAndTrailing.call();\n\n    expect(bothMockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(64);\n\n    expect(bothMockFn).toHaveBeenCalledTimes(2);\n\n    withLeading.call();\n\n    expect(leadingMockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('subsequent leading debounced calls return the last `func` result', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32, timing: 'leading' });\n\n    expect([debouncer.call('a'), debouncer.call('b')]).toStrictEqual([\n      'a',\n      'a',\n    ]);\n\n    await sleep(64);\n\n    expect([debouncer.call('c'), debouncer.call('d')]).toStrictEqual([\n      'c',\n      'c',\n    ]);\n  });\n\n  it('should support a `trailing` option', async () => {\n    const mockFn = vi.fn<() => void>();\n    const withTrailing = debounce(mockFn, { waitMs: 32, timing: 'trailing' });\n    withTrailing.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(64);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('optional param maxWaitMs', () => {\n  it('should support a `maxWait` option', async () => {\n    const mockFn = vi.fn<(x: string) => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32, maxWaitMs: 64 });\n    debouncer.call('a');\n    debouncer.call('b');\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(128);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    debouncer.call('c');\n    debouncer.call('d');\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(256);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should support `maxWait` in a tight loop', async () => {\n    const withMockFn = vi.fn<() => void>();\n    const withoutMockFn = vi.fn<() => void>();\n    const withMaxWait = debounce(withMockFn, { waitMs: 32, maxWaitMs: 128 });\n    const withoutMaxWait = debounce(withoutMockFn, { waitMs: 96 });\n    const start = Date.now();\n    while (Date.now() - start < 320) {\n      withMaxWait.call();\n      withoutMaxWait.call();\n    }\n    await sleep(1);\n\n    expect(withoutMockFn).toHaveBeenCalledTimes(0);\n    expect(withMockFn).not.toHaveBeenCalledTimes(0);\n  });\n\n  it('should queue a trailing call for subsequent debounced calls after `maxWait`', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 200, maxWaitMs: 200 });\n    debouncer.call();\n    setTimeout(() => {\n      debouncer.call();\n    }, 190);\n    setTimeout(() => {\n      debouncer.call();\n    }, 200);\n    setTimeout(() => {\n      debouncer.call();\n    }, 210);\n    await sleep(500);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('should cancel `maxDelayed` when `delayed` is invoked', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { waitMs: 32, maxWaitMs: 64 });\n    debouncer.call();\n    await sleep(128);\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n\n    await sleep(192);\n\n    expect(mockFn).toHaveBeenCalledTimes(2);\n  });\n\n  it('works like a leaky bucket when only maxWaitMs is set', async () => {\n    const mockFn = vi.fn<() => void>();\n    const debouncer = debounce(mockFn, { maxWaitMs: 32 });\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(16);\n    // Without maxWaitMs this call would cause the actual invocation to be\n    // postponed for a full window.\n    debouncer.call();\n\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(17);\n\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n});\n\ndescribe('additional functionality', () => {\n  it('can cancel before the timer starts', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(() => {\n      debouncer.cancel();\n    }).not.toThrowError();\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n  });\n\n  it('can cancel the timer', async () => {\n    const mockFn = vi.fn<() => string>(constant('Hello, World!'));\n    const debouncer = debounce(mockFn, { waitMs: 32 });\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(1);\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    debouncer.cancel();\n    await sleep(32);\n\n    expect(debouncer.call()).toBeUndefined();\n    expect(mockFn).toHaveBeenCalledTimes(0);\n\n    await sleep(32);\n\n    expect(debouncer.call()).toBe('Hello, World!');\n    expect(mockFn).toHaveBeenCalledTimes(1);\n  });\n\n  it('can cancel after the timer ends', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n    expect(() => {\n      debouncer.cancel();\n    }).not.toThrowError();\n  });\n\n  it('can cancel maxWait timer', async () => {\n    const debouncer = debounce(identity(), { waitMs: 16, maxWaitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(1);\n    debouncer.cancel();\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBeUndefined();\n  });\n\n  it('can return a cached value', () => {\n    const debouncer = debounce(identity(), { timing: 'leading', waitMs: 32 });\n\n    expect(debouncer.cachedValue).toBeUndefined();\n    expect(debouncer.call('hello')).toBe('hello');\n    expect(debouncer.cachedValue).toBe('hello');\n  });\n\n  it('can check for inflight timers (trailing)', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.isPending).toBe(false);\n    expect(debouncer.call('hello')).toBeUndefined();\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(1);\n\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(32);\n\n    expect(debouncer.isPending).toBe(false);\n  });\n\n  it('can check for inflight timers (leading)', async () => {\n    const debouncer = debounce(identity(), { timing: 'leading', waitMs: 32 });\n\n    expect(debouncer.isPending).toBe(false);\n    expect(debouncer.call('hello')).toBe('hello');\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(1);\n\n    expect(debouncer.isPending).toBe(true);\n\n    await sleep(32);\n\n    expect(debouncer.isPending).toBe(false);\n  });\n\n  it('can flush before a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.flush()).toBeUndefined();\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.call('world')).toBe('hello');\n  });\n\n  it('can flush during a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(1);\n\n    expect(debouncer.call('world')).toBeUndefined();\n\n    await sleep(1);\n\n    expect(debouncer.flush()).toBe('world');\n  });\n\n  it('can flush after a cool-down', async () => {\n    const debouncer = debounce(identity(), { waitMs: 32 });\n\n    expect(debouncer.call('hello')).toBeUndefined();\n\n    await sleep(32);\n\n    expect(debouncer.flush()).toBe('hello');\n  });\n});\n\ndescribe('errors', () => {\n  it('prevents maxWaitMs to be less then waitMs', () => {\n    expect(() => debounce(identity(), { waitMs: 32, maxWaitMs: 16 })).toThrowError(\n      'debounce: maxWaitMs (16) cannot be less than waitMs (32)',\n    );\n  });\n});\n"],"mappings":"sNA+CA,SAAS,EACP,EACA,CACE,SACA,SACA,aAIF,CACA,GAAI,IAAc,IAAA,IAAa,IAAW,IAAA,IAAa,EAAY,EACjE,MAAU,MACR,wBAAwB,EAAU,UAAU,CAAC,gCAAgC,EAAO,UAAU,CAAC,GAChG,CAGH,IAAIA,EAEE,EAAmB,EACtB,GAAwB,CAIvB,EAAc,EAAK,GAAG,EAAK,EAE7B,CAEE,SAAU,EAAG,GAAG,IAAwB,EACxC,iBAAkB,GAAU,GAAa,EACzC,GAAI,IAAc,IAAA,IAAa,CAAE,mBAAoB,EAAW,CAChE,GAAI,IAAW,UACX,CAAE,UAAW,QAAS,CACtB,IAAW,OACT,CAAE,UAAW,OAAQ,CACrB,CAAE,UAAW,MAAO,CAC3B,CACF,CAED,MAAO,CACL,MAAO,GAAG,KACR,EAAiB,KAAK,GAAG,EAAK,CACvB,GAGT,WACE,EAAiB,OAAO,CACjB,GAGT,WAAc,CACZ,EAAiB,QAAQ,EAG3B,IAAI,WAAY,CACd,MAAO,CAAC,EAAiB,QAG3B,IAAI,aAAc,CAChB,OAAO,GAEV,CAGH,EAAS,yBAA4B,CACnC,EAAG,6BAA8B,SAAY,CAC3C,IAAM,EAAS,EAAG,GAA0B,GAAU,CAAC,CACjD,EAAY,EAAS,EAAQ,CAAE,OAAQ,GAAI,CAAC,CAElD,EAAO,CACL,EAAU,KAAK,IAAI,CACnB,EAAU,KAAK,IAAI,CACnB,EAAU,KAAK,IAAI,CACpB,CAAC,CAAC,cAAc,CAAC,IAAA,GAAW,IAAA,GAAW,IAAA,GAAU,CAAC,CACnD,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,IAAI,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CACvC,EAAO,CACL,EAAU,KAAK,IAAI,CACnB,EAAU,KAAK,IAAI,CACnB,EAAU,KAAK,IAAI,CACpB,CAAC,CAAC,cAAc,CAAC,IAAK,IAAK,IAAI,CAAC,CACjC,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,IAAI,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,CAEF,EAAG,2DAA4D,SAAY,CACzE,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,CAAC,CACtD,EAAU,KAAK,IAAI,CACnB,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAErC,MAAM,EAAM,IAAI,CAEhB,EAAO,EAAU,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,EACrC,CAEF,EAAG,wDAAyD,SAAY,CACtE,IAAM,EAAS,EAAG,IAAgB,CAC5B,EAAY,EAAS,EAAQ,EAAE,CAAC,CACtC,EAAU,MAAM,CAChB,EAAU,MAAM,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,EAAE,CAEd,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,CAEF,EAAG,+BAAgC,SAAY,CAC7C,IAAM,EAAS,EAAG,IAAgB,CAChB,EAAS,EAAQ,CAAE,OAAQ,GAAI,CAAC,CACxC,MAAM,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,GAAG,CAEf,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,CAEF,EAAG,oCAAqC,SAAY,CAClD,IAAM,EAAgB,EAAG,IAAgB,CACnC,EAAa,EAAG,IAAgB,CAChC,EAAc,EAAS,EAAe,CAC1C,OAAQ,GACR,OAAQ,UACT,CAAC,CACF,EAAY,MAAM,CAElB,EAAO,EAAc,CAAC,sBAAsB,EAAE,CAE9C,IAAM,EAAyB,EAAS,EAAY,CAClD,OAAQ,GACR,OAAQ,OACT,CAAC,CACF,EAAuB,MAAM,CAC7B,EAAuB,MAAM,CAE7B,EAAO,EAAW,CAAC,sBAAsB,EAAE,CAE3C,MAAM,EAAM,GAAG,CAEf,EAAO,EAAW,CAAC,sBAAsB,EAAE,CAE3C,EAAY,MAAM,CAElB,EAAO,EAAc,CAAC,sBAAsB,EAAE,EAC9C,CAEF,EAAG,mEAAoE,SAAY,CACjF,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,OAAQ,UAAW,CAAC,CAEzE,EAAO,CAAC,EAAU,KAAK,IAAI,CAAE,EAAU,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAC/D,IACA,IACD,CAAC,CAEF,MAAM,EAAM,GAAG,CAEf,EAAO,CAAC,EAAU,KAAK,IAAI,CAAE,EAAU,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAC/D,IACA,IACD,CAAC,EACF,CAEF,EAAG,qCAAsC,SAAY,CACnD,IAAM,EAAS,EAAG,IAAgB,CACb,EAAS,EAAQ,CAAE,OAAQ,GAAI,OAAQ,WAAY,CAAC,CAC5D,MAAM,CAEnB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,GAAG,CAEf,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,EACF,CAEF,EAAS,+BAAkC,CACzC,EAAG,oCAAqC,SAAY,CAClD,IAAM,EAAS,EAAG,IAAyB,CACrC,EAAY,EAAS,EAAQ,CAAE,OAAQ,GAAI,UAAW,GAAI,CAAC,CACjE,EAAU,KAAK,IAAI,CACnB,EAAU,KAAK,IAAI,CAEnB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,IAAI,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,EAAU,KAAK,IAAI,CACnB,EAAU,KAAK,IAAI,CAEnB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,IAAI,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,CAEF,EAAG,2CAA4C,SAAY,CACzD,IAAM,EAAa,EAAG,IAAgB,CAChC,EAAgB,EAAG,IAAgB,CACnC,EAAc,EAAS,EAAY,CAAE,OAAQ,GAAI,UAAW,IAAK,CAAC,CAClE,EAAiB,EAAS,EAAe,CAAE,OAAQ,GAAI,CAAC,CACxD,EAAQ,KAAK,KAAK,CACxB,KAAO,KAAK,KAAK,CAAG,EAAQ,KAC1B,EAAY,MAAM,CAClB,EAAe,MAAM,CAEvB,MAAM,EAAM,EAAE,CAEd,EAAO,EAAc,CAAC,sBAAsB,EAAE,CAC9C,EAAO,EAAW,CAAC,IAAI,sBAAsB,EAAE,EAC/C,CAEF,EAAG,8EAA+E,SAAY,CAC5F,IAAM,EAAS,EAAG,IAAgB,CAC5B,EAAY,EAAS,EAAQ,CAAE,OAAQ,IAAK,UAAW,IAAK,CAAC,CACnE,EAAU,MAAM,CAChB,eAAiB,CACf,EAAU,MAAM,EACf,IAAI,CACP,eAAiB,CACf,EAAU,MAAM,EACf,IAAI,CACP,eAAiB,CACf,EAAU,MAAM,EACf,IAAI,CACP,MAAM,EAAM,IAAI,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,CAEF,EAAG,uDAAwD,SAAY,CACrE,IAAM,EAAS,EAAG,IAAgB,CAC5B,EAAY,EAAS,EAAQ,CAAE,OAAQ,GAAI,UAAW,GAAI,CAAC,CACjE,EAAU,MAAM,CAChB,MAAM,EAAM,IAAI,CAChB,EAAU,MAAM,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,IAAI,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,CAEF,EAAG,uDAAwD,SAAY,CACrE,IAAM,EAAS,EAAG,IAAgB,CAC5B,EAAY,EAAS,EAAQ,CAAE,UAAW,GAAI,CAAC,CACrD,EAAU,MAAM,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,GAAG,CAGf,EAAU,MAAM,CAEhB,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,GAAG,CAEf,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,EACF,CAEF,EAAS,+BAAkC,CACzC,EAAG,qCAAsC,SAAY,CACnD,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,CAAC,CAEtD,MAAa,CACX,EAAU,QAAQ,EAClB,CAAC,IAAI,cAAc,CACrB,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAE/C,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,KAAK,QAAQ,EAC7C,CAEF,EAAG,uBAAwB,SAAY,CACrC,IAAM,EAAS,EAAG,GAAiB,EAAS,gBAAgB,CAAC,CACvD,EAAY,EAAS,EAAQ,CAAE,OAAQ,GAAI,CAAC,CAElD,EAAO,EAAU,MAAM,CAAC,CAAC,eAAe,CACxC,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,EAAE,CAEd,EAAO,EAAU,MAAM,CAAC,CAAC,eAAe,CACxC,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,EAAU,QAAQ,CAClB,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,MAAM,CAAC,CAAC,eAAe,CACxC,EAAO,EAAO,CAAC,sBAAsB,EAAE,CAEvC,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,MAAM,CAAC,CAAC,KAAK,gBAAgB,CAC9C,EAAO,EAAO,CAAC,sBAAsB,EAAE,EACvC,CAEF,EAAG,kCAAmC,SAAY,CAChD,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,CAAC,CAEtD,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAE/C,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAC7C,MAAa,CACX,EAAU,QAAQ,EAClB,CAAC,IAAI,cAAc,EACrB,CAEF,EAAG,2BAA4B,SAAY,CACzC,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,UAAW,GAAI,CAAC,CAErE,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAE/C,MAAM,EAAM,EAAE,CACd,EAAU,QAAQ,CAClB,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,EAC/C,CAEF,EAAG,gCAAmC,CACpC,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,UAAW,OAAQ,GAAI,CAAC,CAEzE,EAAO,EAAU,YAAY,CAAC,eAAe,CAC7C,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAC7C,EAAO,EAAU,YAAY,CAAC,KAAK,QAAQ,EAC3C,CAEF,EAAG,2CAA4C,SAAY,CACzD,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,CAAC,CAEtD,EAAO,EAAU,UAAU,CAAC,KAAK,GAAM,CACvC,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAC/C,EAAO,EAAU,UAAU,CAAC,KAAK,GAAK,CAEtC,MAAM,EAAM,EAAE,CAEd,EAAO,EAAU,UAAU,CAAC,KAAK,GAAK,CAEtC,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,UAAU,CAAC,KAAK,GAAM,EACvC,CAEF,EAAG,0CAA2C,SAAY,CACxD,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,UAAW,OAAQ,GAAI,CAAC,CAEzE,EAAO,EAAU,UAAU,CAAC,KAAK,GAAM,CACvC,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAC7C,EAAO,EAAU,UAAU,CAAC,KAAK,GAAK,CAEtC,MAAM,EAAM,EAAE,CAEd,EAAO,EAAU,UAAU,CAAC,KAAK,GAAK,CAEtC,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,UAAU,CAAC,KAAK,GAAM,EACvC,CAEF,EAAG,+BAAgC,SAAY,CAC7C,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,CAAC,CAEtD,EAAO,EAAU,OAAO,CAAC,CAAC,eAAe,CACzC,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAE/C,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,KAAK,QAAQ,EAC7C,CAEF,EAAG,+BAAgC,SAAY,CAC7C,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,CAAC,CAEtD,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAE/C,MAAM,EAAM,EAAE,CAEd,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAE/C,MAAM,EAAM,EAAE,CAEd,EAAO,EAAU,OAAO,CAAC,CAAC,KAAK,QAAQ,EACvC,CAEF,EAAG,8BAA+B,SAAY,CAC5C,IAAM,EAAY,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,CAAC,CAEtD,EAAO,EAAU,KAAK,QAAQ,CAAC,CAAC,eAAe,CAE/C,MAAM,EAAM,GAAG,CAEf,EAAO,EAAU,OAAO,CAAC,CAAC,KAAK,QAAQ,EACvC,EACF,CAEF,EAAS,aAAgB,CACvB,EAAG,gDAAmD,CACpD,MAAa,EAAS,GAAU,CAAE,CAAE,OAAQ,GAAI,UAAW,GAAI,CAAC,CAAC,CAAC,aAChE,2DACD,EACD,EACF"}

package/dist/funnel.reference-batch.test.cjs

@@ -1 +1 @@
-const e=require(`./dist-3WF0YzcR.cjs`);require(`./lazy-data-last-impl-3PAFkslW.cjs`),require(`./curry-BPVIsvo3.cjs`);const t=require(`./do-nothing-Cc1faYu6.cjs`),n=require(`./from-keys-CI2PJlIM.cjs`),r=require(`./funnel-CL-QFpGk.cjs`);function i(e,t,n=0){let i=r.funnel(n=>{e(n.map(({params:e})=>e)).then(e=>{for(let[r,{params:i,promiseCallbacks:[a]}]of n.entries())a(t(e,r,...i))}).catch(e=>{for(let{promiseCallbacks:[,t]}of n)t(e)})},{reducer:(e,t)=>[...e??[],t],maxBurstDurationMs:n,triggerAt:`end`});return{...i,call:async(...e)=>new Promise((...t)=>{i.call({promiseCallbacks:t,params:e})})}}e.describe(`showcase`,()=>{e.it(`results as object`,async()=>{let t=e.vi.fn(async e=>n.fromKeys(e,e=>e.length)),r=i(async e=>await t(e.flat()),(e,t,n)=>e[n]),a=[r.call(`short`),r.call(`medium`),r.call(`loooooooooooooong`)];e.globalExpect(t).toHaveBeenCalledTimes(0);let[o,s,c]=await Promise.all(a);e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),e.globalExpect(t).toHaveLastResolvedWith({short:5,medium:6,loooooooooooooong:17}),e.globalExpect(o).toBe(5),e.globalExpect(s).toBe(6),e.globalExpect(c).toBe(17)}),e.it(`results as array`,async()=>{let t=e.vi.fn(async e=>e.map(e=>e.length)),n=i(async e=>await t(e.flat()),(e,t)=>e[t]),r=[n.call(`short`),n.call(`medium`),n.call(`loooooooooooooong`)];e.globalExpect(t).toHaveBeenCalledTimes(0);let[a,o,s]=await Promise.all(r);e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),e.globalExpect(t).toHaveLastResolvedWith([5,6,17]),e.globalExpect(a).toBe(5),e.globalExpect(o).toBe(6),e.globalExpect(s).toBe(17)}),e.it(`error handling`,async()=>{let n=i(async e=>{if(e.length>1)throw Error(`Batch too big! ${JSON.stringify(e)}`)},t.doNothing());await e.globalExpect(n.call(`a`)).resolves.toBeUndefined(),await e.globalExpect(Promise.all([n.call(`hello`),n.call(`world`)])).rejects.toThrow(`Batch too big! [["hello"],["world"]]`)})});
+const e=require(`./dist-8XtUY3ad.cjs`),t=require(`./do-nothing.cjs`),n=require(`./from-keys.cjs`),r=require(`./funnel.cjs`);function i(e,t,n=0){let i=r.funnel(n=>{e(n.map(({params:e})=>e)).then(e=>{for(let[r,{params:i,promiseCallbacks:[a]}]of n.entries())a(t(e,r,...i))}).catch(e=>{for(let{promiseCallbacks:[,t]}of n)t(e)})},{reducer:(e,t)=>[...e??[],t],maxBurstDurationMs:n,triggerAt:`end`});return{...i,call:async(...e)=>new Promise((...t)=>{i.call({promiseCallbacks:t,params:e})})}}e.i(`showcase`,()=>{e.a(`results as object`,async()=>{let t=e.r.fn(async e=>n.fromKeys(e,e=>e.length)),r=i(async e=>await t(e.flat()),(e,t,n)=>e[n]),a=[r.call(`short`),r.call(`medium`),r.call(`loooooooooooooong`)];e.n(t).toHaveBeenCalledTimes(0);let[o,s,c]=await Promise.all(a);e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),e.n(t).toHaveLastResolvedWith({short:5,medium:6,loooooooooooooong:17}),e.n(o).toBe(5),e.n(s).toBe(6),e.n(c).toBe(17)}),e.a(`results as array`,async()=>{let t=e.r.fn(async e=>e.map(e=>e.length)),n=i(async e=>await t(e.flat()),(e,t)=>e[t]),r=[n.call(`short`),n.call(`medium`),n.call(`loooooooooooooong`)];e.n(t).toHaveBeenCalledTimes(0);let[a,o,s]=await Promise.all(r);e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),e.n(t).toHaveLastResolvedWith([5,6,17]),e.n(a).toBe(5),e.n(o).toBe(6),e.n(s).toBe(17)}),e.a(`error handling`,async()=>{let n=i(async e=>{if(e.length>1)throw Error(`Batch too big! ${JSON.stringify(e)}`)},t.doNothing());await e.n(n.call(`a`)).resolves.toBeUndefined(),await e.n(Promise.all([n.call(`hello`),n.call(`world`)])).rejects.toThrowError(`Batch too big! [["hello"],["world"]]`)})});

package/dist/funnel.reference-batch.test.js

@@ -1,2 +1,2 @@
-import{describe as e,globalExpect as t,it as n,vi as r}from"./dist-C2nNPffG.js";import"./lazy-data-last-impl-7QfM1xXg.js";import"./curry-CzZjDrpv.js";import{doNothing as i}from"./do-nothing-Be29JGDG.js";import{fromKeys as a}from"./from-keys-DJe8xU7b.js";import{funnel as o}from"./funnel-CEbURcmp.js";function s(e,t,n=0){let r=o(n=>{e(n.map(({params:e})=>e)).then(e=>{for(let[r,{params:i,promiseCallbacks:[a]}]of n.entries())a(t(e,r,...i))}).catch(e=>{for(let{promiseCallbacks:[,t]}of n)t(e)})},{reducer:(e,t)=>[...e??[],t],maxBurstDurationMs:n,triggerAt:`end`});return{...r,call:async(...e)=>new Promise((...t)=>{r.call({promiseCallbacks:t,params:e})})}}e(`showcase`,()=>{n(`results as object`,async()=>{let e=r.fn(async e=>a(e,e=>e.length)),n=s(async t=>await e(t.flat()),(e,t,n)=>e[n]),i=[n.call(`short`),n.call(`medium`),n.call(`loooooooooooooong`)];t(e).toHaveBeenCalledTimes(0);let[o,c,l]=await Promise.all(i);t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),t(e).toHaveLastResolvedWith({short:5,medium:6,loooooooooooooong:17}),t(o).toBe(5),t(c).toBe(6),t(l).toBe(17)}),n(`results as array`,async()=>{let e=r.fn(async e=>e.map(e=>e.length)),n=s(async t=>await e(t.flat()),(e,t)=>e[t]),i=[n.call(`short`),n.call(`medium`),n.call(`loooooooooooooong`)];t(e).toHaveBeenCalledTimes(0);let[a,o,c]=await Promise.all(i);t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),t(e).toHaveLastResolvedWith([5,6,17]),t(a).toBe(5),t(o).toBe(6),t(c).toBe(17)}),n(`error handling`,async()=>{let e=s(async e=>{if(e.length>1)throw Error(`Batch too big! ${JSON.stringify(e)}`)},i());await t(e.call(`a`)).resolves.toBeUndefined(),await t(Promise.all([e.call(`hello`),e.call(`world`)])).rejects.toThrow(`Batch too big! [["hello"],["world"]]`)})});
+import{doNothing as e}from"./do-nothing.js";import{fromKeys as t}from"./from-keys.js";import{a as n,i as r,n as i,r as a}from"./dist-Bd1vawFi.js";import{funnel as o}from"./funnel.js";function s(e,t,n=0){let r=o(n=>{e(n.map(({params:e})=>e)).then(e=>{for(let[r,{params:i,promiseCallbacks:[a]}]of n.entries())a(t(e,r,...i))}).catch(e=>{for(let{promiseCallbacks:[,t]}of n)t(e)})},{reducer:(e,t)=>[...e??[],t],maxBurstDurationMs:n,triggerAt:`end`});return{...r,call:async(...e)=>new Promise((...t)=>{r.call({promiseCallbacks:t,params:e})})}}r(`showcase`,()=>{n(`results as object`,async()=>{let e=a.fn(async e=>t(e,e=>e.length)),n=s(async t=>await e(t.flat()),(e,t,n)=>e[n]),r=[n.call(`short`),n.call(`medium`),n.call(`loooooooooooooong`)];i(e).toHaveBeenCalledTimes(0);let[o,c,l]=await Promise.all(r);i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),i(e).toHaveLastResolvedWith({short:5,medium:6,loooooooooooooong:17}),i(o).toBe(5),i(c).toBe(6),i(l).toBe(17)}),n(`results as array`,async()=>{let e=a.fn(async e=>e.map(e=>e.length)),t=s(async t=>await e(t.flat()),(e,t)=>e[t]),n=[t.call(`short`),t.call(`medium`),t.call(`loooooooooooooong`)];i(e).toHaveBeenCalledTimes(0);let[r,o,c]=await Promise.all(n);i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`short`,`medium`,`loooooooooooooong`]),i(e).toHaveLastResolvedWith([5,6,17]),i(r).toBe(5),i(o).toBe(6),i(c).toBe(17)}),n(`error handling`,async()=>{let t=s(async e=>{if(e.length>1)throw Error(`Batch too big! ${JSON.stringify(e)}`)},e());await i(t.call(`a`)).resolves.toBeUndefined(),await i(Promise.all([t.call(`hello`),t.call(`world`)])).rejects.toThrowError(`Batch too big! [["hello"],["world"]]`)})});
 //# sourceMappingURL=funnel.reference-batch.test.js.map

package/dist/funnel.reference-batch.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"funnel.reference-batch.test.js","names":["expect"],"sources":["../src/funnel.reference-batch.test.ts"],"sourcesContent":["/* eslint-disable ts/explicit-function-return-type,  ts/no-explicit-any --\n * These aren't useful for a reference implementation!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { doNothing } from './do-nothing';\nimport { fromKeys } from './from-keys';\nimport { funnel } from './funnel';\n\ninterface BatchRequest<Params extends Array<any>, Result> {\n  readonly params: Params;\n  readonly promiseCallbacks: Readonly<\n    Parameters<ConstructorParameters<typeof Promise<Result>>[0]>\n  >;\n}\n\n/**\n * A reference implementation for an async batching utility function built on\n * top of the `funnel` general purpose execution utility function. It will\n * accumulate all params passed to an async `call` method within the defined\n * burst duration and then use an async executor to process them in one\n * invocation. It then extracts an individual result for each call which is\n * used to resolve the original call.\n *\n * This allows synchronizing multiple async calls while keeping each call site\n * isolated from the rest (for example, as react components).\n *\n * This reference implementation can be copied into your project as-is, or you\n * can use it as the basis for a more complex implementation with additional\n * features.\n *\n * @param callback - The main function that takes a batch and returns an\n * aggregated response. The typing for the it's parameters will derive the\n * typing for the extractor and the `call` method.\n * @param extractor - A function that takes the aggregated response and extracts\n * from it the result for each individual call. The function is called with both\n * the index in the batch, and the params passed to the `call` method. This\n * allows handling APIs that return batch results as both objects and arrays.\n * @param maxBurstDurationMs - The period of time where the batcher would\n * collect params before triggering the executor. When set to 0 the batcher\n * does not incur any additional delays to the execution and would trigger at\n * the next tick, just like a regular async function would. This is also the\n * default value.\n * @returns A Funnel object with the `call` method augmented to support async\n * response.\n */\nfunction batch<Params extends Array<any>, BatchResponse, Result>(\n  callback: (requests: ReadonlyArray<Params>) => Promise<BatchResponse>,\n  extractor: (\n    response: BatchResponse,\n    index: number,\n    ...params: Params\n  ) => Result,\n  maxBurstDurationMs = 0,\n) {\n  const batchFunnel = funnel(\n    // Passes all accumulated parameters to the callback and then extracts the response for each individual call via the extractor.\n    (requests: ReadonlyArray<BatchRequest<Params, Result>>) => {\n      callback(requests.map(({ params }) => params))\n        // On success we iterate again over all calls and allow the extractor to pull a value out of the aggregated response for each one.\n        .then((response) => {\n          for (const [\n            index,\n            {\n              params,\n              promiseCallbacks: [resolve],\n            },\n          ] of requests.entries()) {\n            const result = extractor(response, index, ...params);\n            resolve(result);\n          }\n        })\n\n        // On error we simply pass the error along to all reject callbacks.\n        .catch((error) => {\n          for (const {\n            promiseCallbacks: [, reject],\n          } of requests) {\n            reject(error);\n          }\n        });\n    },\n    {\n      // Reducer: Accumulates the parameters for each call, together with the promise executor callbacks needed to resolve or reject the call.\n      reducer: (requests, request: BatchRequest<Params, Result>) => [\n        ...(requests ?? []),\n        request,\n      ],\n      maxBurstDurationMs,\n      triggerAt: 'end',\n    },\n  );\n\n  return {\n    ...batchFunnel,\n\n    call: async (...params: Params) =>\n      new Promise<Result>((...promiseCallbacks) => {\n        batchFunnel.call({ promiseCallbacks, params });\n      }),\n  };\n}\n\ndescribe('showcase', () => {\n  it('results as object', async () => {\n    const mockApi = vi.fn<\n      (words: ReadonlyArray<string>) => Promise<Record<string, number>>\n        >(async (words) => fromKeys(words, (word) => word.length));\n\n    const countLettersApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[word: string]>) =>\n        await mockApi(requests.flat()),\n      (response, _, word) => response[word],\n    );\n\n    const prepared = [\n      countLettersApi.call('short'),\n      countLettersApi.call('medium'),\n      countLettersApi.call('loooooooooooooong'),\n    ];\n\n    expect(mockApi).toHaveBeenCalledTimes(0);\n\n    const [shortResult, mediumResult, longResult] = await Promise.all(prepared);\n\n    expect(mockApi).toHaveBeenCalledTimes(1);\n    expect(mockApi).toHaveBeenLastCalledWith([\n      'short',\n      'medium',\n      'loooooooooooooong',\n    ]);\n    expect(mockApi).toHaveLastResolvedWith({\n      short: 5,\n      medium: 6,\n      loooooooooooooong: 17,\n    });\n    expect(shortResult).toBe(5);\n    expect(mediumResult).toBe(6);\n    expect(longResult).toBe(17);\n  });\n\n  it('results as array', async () => {\n    const mockApi = vi.fn<\n      (words: ReadonlyArray<string>) => Promise<ReadonlyArray<number>>\n        >(async (words) => words.map((word) => word.length));\n\n    const countLettersApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[word: string]>) =>\n        await mockApi(requests.flat()),\n      (response, index) => response[index],\n    );\n\n    const prepared = [\n      countLettersApi.call('short'),\n      countLettersApi.call('medium'),\n      countLettersApi.call('loooooooooooooong'),\n    ];\n\n    expect(mockApi).toHaveBeenCalledTimes(0);\n\n    const [shortResult, mediumResult, longResult] = await Promise.all(prepared);\n\n    expect(mockApi).toHaveBeenCalledTimes(1);\n    expect(mockApi).toHaveBeenLastCalledWith([\n      'short',\n      'medium',\n      'loooooooooooooong',\n    ]);\n    expect(mockApi).toHaveLastResolvedWith([5, 6, 17]);\n    expect(shortResult).toBe(5);\n    expect(mediumResult).toBe(6);\n    expect(longResult).toBe(17);\n  });\n\n  it('error handling', async () => {\n    const failingApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[id: string]>) => {\n        if (requests.length > 1) {\n          throw new Error(`Batch too big! ${JSON.stringify(requests)}`);\n        }\n      },\n      doNothing(),\n    );\n\n    await expect(failingApi.call('a')).resolves.toBeUndefined();\n\n    await expect(\n      Promise.all([failingApi.call('hello'), failingApi.call('world')]),\n    ).rejects.toThrow('Batch too big! [[\"hello\"],[\"world\"]]');\n  });\n});\n"],"mappings":"4SA8CA,SAAS,EACP,EACA,EAKA,EAAqB,EACrB,CACA,IAAM,EAAc,EAEjB,GAA0D,CACzD,EAAS,EAAS,KAAK,CAAE,YAAa,EAAO,CAAC,CAE3C,KAAM,GAAa,CAClB,IAAK,GAAM,CACT,EACA,CACE,SACA,iBAAkB,CAAC,OAElB,EAAS,SAAS,CAErB,EADe,EAAU,EAAU,EAAO,GAAG,EAAO,CACrC,EAEjB,CAGD,MAAO,GAAU,CAChB,IAAK,GAAM,CACT,iBAAkB,EAAG,MAClB,EACH,EAAO,EAAM,EAEf,EAEN,CAEE,SAAU,EAAU,IAA0C,CAC5D,GAAI,GAAY,EAAE,CAClB,EACD,CACD,qBACA,UAAW,MACZ,CACF,CAED,MAAO,CACL,GAAG,EAEH,KAAM,MAAO,GAAG,IACd,IAAI,SAAiB,GAAG,IAAqB,CAC3C,EAAY,KAAK,CAAE,mBAAkB,SAAQ,CAAC,EAC9C,CACL,CAGH,EAAS,eAAkB,CACzB,EAAG,oBAAqB,SAAY,CAClC,IAAM,EAAU,EAAG,GAEb,KAAO,IAAU,EAAS,EAAQ,GAAS,EAAK,OAAO,CAAC,CAExD,EAAkB,EAGtB,KAAO,IACL,MAAM,EAAQ,EAAS,MAAM,CAAC,EAC/B,EAAU,EAAG,IAAS,EAAS,GACjC,CAEK,EAAW,CACf,EAAgB,KAAK,QAAQ,CAC7B,EAAgB,KAAK,SAAS,CAC9B,EAAgB,KAAK,oBAAoB,CAC1C,CAED,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CAExC,GAAM,CAAC,EAAa,EAAc,GAAc,MAAM,QAAQ,IAAI,EAAS,CAE3E,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CACxC,EAAO,EAAQ,CAAC,yBAAyB,CACvC,QACA,SACA,oBACD,CAAC,CACF,EAAO,EAAQ,CAAC,uBAAuB,CACrC,MAAO,EACP,OAAQ,EACR,kBAAmB,GACpB,CAAC,CACF,EAAO,EAAY,CAAC,KAAK,EAAE,CAC3B,EAAO,EAAa,CAAC,KAAK,EAAE,CAC5B,EAAO,EAAW,CAAC,KAAK,GAAG,EAC3B,CAEF,EAAG,mBAAoB,SAAY,CACjC,IAAM,EAAU,EAAG,GAEb,KAAO,IAAU,EAAM,IAAK,GAAS,EAAK,OAAO,CAAC,CAElD,EAAkB,EAGtB,KAAO,IACL,MAAM,EAAQ,EAAS,MAAM,CAAC,EAC/B,EAAU,IAAU,EAAS,GAC/B,CAEK,EAAW,CACf,EAAgB,KAAK,QAAQ,CAC7B,EAAgB,KAAK,SAAS,CAC9B,EAAgB,KAAK,oBAAoB,CAC1C,CAED,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CAExC,GAAM,CAAC,EAAa,EAAc,GAAc,MAAM,QAAQ,IAAI,EAAS,CAE3E,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CACxC,EAAO,EAAQ,CAAC,yBAAyB,CACvC,QACA,SACA,oBACD,CAAC,CACF,EAAO,EAAQ,CAAC,uBAAuB,CAAC,EAAG,EAAG,GAAG,CAAC,CAClD,EAAO,EAAY,CAAC,KAAK,EAAE,CAC3B,EAAO,EAAa,CAAC,KAAK,EAAE,CAC5B,EAAO,EAAW,CAAC,KAAK,GAAG,EAC3B,CAEF,EAAG,iBAAkB,SAAY,CAC/B,IAAM,EAAa,EAGjB,KAAO,IAA0C,CAC/C,GAAI,EAAS,OAAS,EACpB,MAAU,MAAM,kBAAkB,KAAK,UAAU,EAAS,GAAG,EAGjE,GAAW,CACZ,CAED,MAAMA,EAAO,EAAW,KAAK,IAAI,CAAC,CAAC,SAAS,eAAe,CAE3D,MAAMA,EACJ,QAAQ,IAAI,CAAC,EAAW,KAAK,QAAQ,CAAE,EAAW,KAAK,QAAQ,CAAC,CAAC,CAClE,CAAC,QAAQ,QAAQ,uCAAuC,EACzD,EACF"}
+{"version":3,"file":"funnel.reference-batch.test.js","names":["expect"],"sources":["../src/funnel.reference-batch.test.ts"],"sourcesContent":["/* eslint-disable ts/explicit-function-return-type,  ts/no-explicit-any --\n * These aren't useful for a reference implementation!\n */\n\nimport { describe, expect, it, vi } from 'vitest';\nimport { doNothing } from './do-nothing';\nimport { fromKeys } from './from-keys';\nimport { funnel } from './funnel';\n\ninterface BatchRequest<Params extends Array<any>, Result> {\n  readonly params: Params;\n  readonly promiseCallbacks: Readonly<\n    Parameters<ConstructorParameters<typeof Promise<Result>>[0]>\n  >;\n}\n\n/**\n * A reference implementation for an async batching utility function built on\n * top of the `funnel` general purpose execution utility function. It will\n * accumulate all params passed to an async `call` method within the defined\n * burst duration and then use an async executor to process them in one\n * invocation. It then extracts an individual result for each call which is\n * used to resolve the original call.\n *\n * This allows synchronizing multiple async calls while keeping each call site\n * isolated from the rest (for example, as react components).\n *\n * This reference implementation can be copied into your project as-is, or you\n * can use it as the basis for a more complex implementation with additional\n * features.\n *\n * @param callback - The main function that takes a batch and returns an\n * aggregated response. The typing for the it's parameters will derive the\n * typing for the extractor and the `call` method.\n * @param extractor - A function that takes the aggregated response and extracts\n * from it the result for each individual call. The function is called with both\n * the index in the batch, and the params passed to the `call` method. This\n * allows handling APIs that return batch results as both objects and arrays.\n * @param maxBurstDurationMs - The period of time where the batcher would\n * collect params before triggering the executor. When set to 0 the batcher\n * does not incur any additional delays to the execution and would trigger at\n * the next tick, just like a regular async function would. This is also the\n * default value.\n * @returns A Funnel object with the `call` method augmented to support async\n * response.\n */\nfunction batch<Params extends Array<any>, BatchResponse, Result>(\n  callback: (requests: ReadonlyArray<Params>) => Promise<BatchResponse>,\n  extractor: (\n    response: BatchResponse,\n    index: number,\n    ...params: Params\n  ) => Result,\n  maxBurstDurationMs = 0,\n) {\n  const batchFunnel = funnel(\n    // Passes all accumulated parameters to the callback and then extracts the response for each individual call via the extractor.\n    (requests: ReadonlyArray<BatchRequest<Params, Result>>) => {\n      callback(requests.map(({ params }) => params))\n        // On success we iterate again over all calls and allow the extractor to pull a value out of the aggregated response for each one.\n        .then((response) => {\n          for (const [\n            index,\n            {\n              params,\n              promiseCallbacks: [resolve],\n            },\n          ] of requests.entries()) {\n            const result = extractor(response, index, ...params);\n            resolve(result);\n          }\n        })\n\n        // On error we simply pass the error along to all reject callbacks.\n        .catch((error) => {\n          for (const {\n            promiseCallbacks: [, reject],\n          } of requests) {\n            reject(error);\n          }\n        });\n    },\n    {\n      // Reducer: Accumulates the parameters for each call, together with the promise executor callbacks needed to resolve or reject the call.\n      reducer: (requests, request: BatchRequest<Params, Result>) => [\n        ...(requests ?? []),\n        request,\n      ],\n      maxBurstDurationMs,\n      triggerAt: 'end',\n    },\n  );\n\n  return {\n    ...batchFunnel,\n\n    call: async (...params: Params) =>\n      new Promise<Result>((...promiseCallbacks) => {\n        batchFunnel.call({ promiseCallbacks, params });\n      }),\n  };\n}\n\ndescribe('showcase', () => {\n  it('results as object', async () => {\n    const mockApi = vi.fn<\n      (words: ReadonlyArray<string>) => Promise<Record<string, number>>\n    >(async (words) => fromKeys(words, (word) => word.length));\n\n    const countLettersApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[word: string]>) =>\n        await mockApi(requests.flat()),\n      (response, _, word) => response[word],\n    );\n\n    const prepared = [\n      countLettersApi.call('short'),\n      countLettersApi.call('medium'),\n      countLettersApi.call('loooooooooooooong'),\n    ];\n\n    expect(mockApi).toHaveBeenCalledTimes(0);\n\n    const [shortResult, mediumResult, longResult] = await Promise.all(prepared);\n\n    expect(mockApi).toHaveBeenCalledTimes(1);\n    expect(mockApi).toHaveBeenLastCalledWith([\n      'short',\n      'medium',\n      'loooooooooooooong',\n    ]);\n    expect(mockApi).toHaveLastResolvedWith({\n      short: 5,\n      medium: 6,\n      loooooooooooooong: 17,\n    });\n    expect(shortResult).toBe(5);\n    expect(mediumResult).toBe(6);\n    expect(longResult).toBe(17);\n  });\n\n  it('results as array', async () => {\n    const mockApi = vi.fn<\n      (words: ReadonlyArray<string>) => Promise<ReadonlyArray<number>>\n    >(async (words) => words.map((word) => word.length));\n\n    const countLettersApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[word: string]>) =>\n        await mockApi(requests.flat()),\n      (response, index) => response[index],\n    );\n\n    const prepared = [\n      countLettersApi.call('short'),\n      countLettersApi.call('medium'),\n      countLettersApi.call('loooooooooooooong'),\n    ];\n\n    expect(mockApi).toHaveBeenCalledTimes(0);\n\n    const [shortResult, mediumResult, longResult] = await Promise.all(prepared);\n\n    expect(mockApi).toHaveBeenCalledTimes(1);\n    expect(mockApi).toHaveBeenLastCalledWith([\n      'short',\n      'medium',\n      'loooooooooooooong',\n    ]);\n    expect(mockApi).toHaveLastResolvedWith([5, 6, 17]);\n    expect(shortResult).toBe(5);\n    expect(mediumResult).toBe(6);\n    expect(longResult).toBe(17);\n  });\n\n  it('error handling', async () => {\n    const failingApi = batch(\n      // We only need to type the `requests` param of the `executor` callback.\n      // All other types are derived from it.\n      async (requests: ReadonlyArray<[id: string]>) => {\n        if (requests.length > 1) {\n          throw new Error(`Batch too big! ${JSON.stringify(requests)}`);\n        }\n      },\n      doNothing(),\n    );\n\n    await expect(failingApi.call('a')).resolves.toBeUndefined();\n\n    await expect(\n      Promise.all([failingApi.call('hello'), failingApi.call('world')]),\n    ).rejects.toThrowError('Batch too big! [[\"hello\"],[\"world\"]]');\n  });\n});\n"],"mappings":"uLA8CA,SAAS,EACP,EACA,EAKA,EAAqB,EACrB,CACA,IAAM,EAAc,EAEjB,GAA0D,CACzD,EAAS,EAAS,KAAK,CAAE,YAAa,EAAO,CAAC,CAE3C,KAAM,GAAa,CAClB,IAAK,GAAM,CACT,EACA,CACE,SACA,iBAAkB,CAAC,OAElB,EAAS,SAAS,CAErB,EADe,EAAU,EAAU,EAAO,GAAG,EAAO,CACrC,EAEjB,CAGD,MAAO,GAAU,CAChB,IAAK,GAAM,CACT,iBAAkB,EAAG,MAClB,EACH,EAAO,EAAM,EAEf,EAEN,CAEE,SAAU,EAAU,IAA0C,CAC5D,GAAI,GAAY,EAAE,CAClB,EACD,CACD,qBACA,UAAW,MACZ,CACF,CAED,MAAO,CACL,GAAG,EAEH,KAAM,MAAO,GAAG,IACd,IAAI,SAAiB,GAAG,IAAqB,CAC3C,EAAY,KAAK,CAAE,mBAAkB,SAAQ,CAAC,EAC9C,CACL,CAGH,EAAS,eAAkB,CACzB,EAAG,oBAAqB,SAAY,CAClC,IAAM,EAAU,EAAG,GAEjB,KAAO,IAAU,EAAS,EAAQ,GAAS,EAAK,OAAO,CAAC,CAEpD,EAAkB,EAGtB,KAAO,IACL,MAAM,EAAQ,EAAS,MAAM,CAAC,EAC/B,EAAU,EAAG,IAAS,EAAS,GACjC,CAEK,EAAW,CACf,EAAgB,KAAK,QAAQ,CAC7B,EAAgB,KAAK,SAAS,CAC9B,EAAgB,KAAK,oBAAoB,CAC1C,CAED,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CAExC,GAAM,CAAC,EAAa,EAAc,GAAc,MAAM,QAAQ,IAAI,EAAS,CAE3E,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CACxC,EAAO,EAAQ,CAAC,yBAAyB,CACvC,QACA,SACA,oBACD,CAAC,CACF,EAAO,EAAQ,CAAC,uBAAuB,CACrC,MAAO,EACP,OAAQ,EACR,kBAAmB,GACpB,CAAC,CACF,EAAO,EAAY,CAAC,KAAK,EAAE,CAC3B,EAAO,EAAa,CAAC,KAAK,EAAE,CAC5B,EAAO,EAAW,CAAC,KAAK,GAAG,EAC3B,CAEF,EAAG,mBAAoB,SAAY,CACjC,IAAM,EAAU,EAAG,GAEjB,KAAO,IAAU,EAAM,IAAK,GAAS,EAAK,OAAO,CAAC,CAE9C,EAAkB,EAGtB,KAAO,IACL,MAAM,EAAQ,EAAS,MAAM,CAAC,EAC/B,EAAU,IAAU,EAAS,GAC/B,CAEK,EAAW,CACf,EAAgB,KAAK,QAAQ,CAC7B,EAAgB,KAAK,SAAS,CAC9B,EAAgB,KAAK,oBAAoB,CAC1C,CAED,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CAExC,GAAM,CAAC,EAAa,EAAc,GAAc,MAAM,QAAQ,IAAI,EAAS,CAE3E,EAAO,EAAQ,CAAC,sBAAsB,EAAE,CACxC,EAAO,EAAQ,CAAC,yBAAyB,CACvC,QACA,SACA,oBACD,CAAC,CACF,EAAO,EAAQ,CAAC,uBAAuB,CAAC,EAAG,EAAG,GAAG,CAAC,CAClD,EAAO,EAAY,CAAC,KAAK,EAAE,CAC3B,EAAO,EAAa,CAAC,KAAK,EAAE,CAC5B,EAAO,EAAW,CAAC,KAAK,GAAG,EAC3B,CAEF,EAAG,iBAAkB,SAAY,CAC/B,IAAM,EAAa,EAGjB,KAAO,IAA0C,CAC/C,GAAI,EAAS,OAAS,EACpB,MAAU,MAAM,kBAAkB,KAAK,UAAU,EAAS,GAAG,EAGjE,GAAW,CACZ,CAED,MAAMA,EAAO,EAAW,KAAK,IAAI,CAAC,CAAC,SAAS,eAAe,CAE3D,MAAMA,EACJ,QAAQ,IAAI,CAAC,EAAW,KAAK,QAAQ,CAAE,EAAW,KAAK,QAAQ,CAAC,CAAC,CAClE,CAAC,QAAQ,aAAa,uCAAuC,EAC9D,EACF"}

package/dist/funnel.test-d.cjs

@@ -1 +1 @@
-const e=require(`./dist-3WF0YzcR.cjs`),t=require(`./do-nothing-Cc1faYu6.cjs`),n=require(`./funnel-CL-QFpGk.cjs`);e.describe(`'call' method args`,()=>{e.it(`no args`,()=>{(0,e.import_dist.expectTypeOf)(n.funnel(t.doNothing(),{reducer:e=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.it(`non-optional args`,()=>{(0,e.import_dist.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,t,n,r)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.it(`optional args`,()=>{(0,e.import_dist.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.it(`rest args`,()=>{(0,e.import_dist.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,...t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()})}),e.describe(`derive the reducer accumulator type from the executor param`,()=>{e.it(`simple types`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.import_dist.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})}),e.it(`arrays`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.import_dist.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})}),e.it(`objects`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.import_dist.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})})}),e.describe(`prevent bad options`,()=>{e.it(`minGapMs cannot be the only option with timing: end`,()=>{n.funnel(t.doNothing(),{minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`end`,minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`start`,minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`both`,minGapMs:100})})});
+const e=require(`./dist-8XtUY3ad.cjs`),t=require(`./do-nothing.cjs`),n=require(`./funnel.cjs`);e.i(`'call' method args`,()=>{e.a(`no args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:e=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.a(`non-optional args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,t,n,r)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.a(`optional args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),e.a(`rest args`,()=>{(0,e.t.expectTypeOf)(n.funnel(t.doNothing(),{reducer:(e,...t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()})}),e.i(`derive the reducer accumulator type from the executor param`,()=>{e.a(`simple types`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.t.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})}),e.a(`arrays`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.t.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})}),e.a(`objects`,()=>{n.funnel(e=>{},{reducer:t=>((0,e.t.expectTypeOf)(t).toEqualTypeOf(),t),triggerAt:`start`})})}),e.i(`prevent bad options`,()=>{e.a(`minGapMs cannot be the only option with timing: end`,()=>{n.funnel(t.doNothing(),{minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`end`,minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`start`,minGapMs:100}),n.funnel(t.doNothing(),{triggerAt:`both`,minGapMs:100})})});

package/dist/funnel.test-d.js

@@ -1,2 +1,2 @@
-import{describe as e,expectTypeOf as t,it as n}from"./dist-C2nNPffG.js";import{doNothing as r}from"./do-nothing-Be29JGDG.js";import{funnel as i}from"./funnel-CEbURcmp.js";e(`'call' method args`,()=>{n(`no args`,()=>{t(i(r(),{reducer:e=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),n(`non-optional args`,()=>{t(i(r(),{reducer:(e,t,n,r)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),n(`optional args`,()=>{t(i(r(),{reducer:(e,t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),n(`rest args`,()=>{t(i(r(),{reducer:(e,...t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()})}),e(`derive the reducer accumulator type from the executor param`,()=>{n(`simple types`,()=>{i(e=>{},{reducer:e=>(t(e).toEqualTypeOf(),e),triggerAt:`start`})}),n(`arrays`,()=>{i(e=>{},{reducer:e=>(t(e).toEqualTypeOf(),e),triggerAt:`start`})}),n(`objects`,()=>{i(e=>{},{reducer:e=>(t(e).toEqualTypeOf(),e),triggerAt:`start`})})}),e(`prevent bad options`,()=>{n(`minGapMs cannot be the only option with timing: end`,()=>{i(r(),{minGapMs:100}),i(r(),{triggerAt:`end`,minGapMs:100}),i(r(),{triggerAt:`start`,minGapMs:100}),i(r(),{triggerAt:`both`,minGapMs:100})})});
+import{doNothing as e}from"./do-nothing.js";import{a as t,i as n,t as r}from"./dist-Bd1vawFi.js";import{funnel as i}from"./funnel.js";n(`'call' method args`,()=>{t(`no args`,()=>{r(i(e(),{reducer:e=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),t(`non-optional args`,()=>{r(i(e(),{reducer:(e,t,n,r)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),t(`optional args`,()=>{r(i(e(),{reducer:(e,t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()}),t(`rest args`,()=>{r(i(e(),{reducer:(e,...t)=>`test`,triggerAt:`start`}).call).parameters.toEqualTypeOf()})}),n(`derive the reducer accumulator type from the executor param`,()=>{t(`simple types`,()=>{i(e=>{},{reducer:e=>(r(e).toEqualTypeOf(),e),triggerAt:`start`})}),t(`arrays`,()=>{i(e=>{},{reducer:e=>(r(e).toEqualTypeOf(),e),triggerAt:`start`})}),t(`objects`,()=>{i(e=>{},{reducer:e=>(r(e).toEqualTypeOf(),e),triggerAt:`start`})})}),n(`prevent bad options`,()=>{t(`minGapMs cannot be the only option with timing: end`,()=>{i(e(),{minGapMs:100}),i(e(),{triggerAt:`end`,minGapMs:100}),i(e(),{triggerAt:`start`,minGapMs:100}),i(e(),{triggerAt:`both`,minGapMs:100})})});
 //# sourceMappingURL=funnel.test-d.js.map

package/dist/funnel.test-d.js.map

@@ -1 +1 @@
-{"version":3,"file":"funnel.test-d.js","names":[],"sources":["../src/funnel.test-d.ts"],"sourcesContent":["/* eslint-disable ts/no-unused-vars -- We just want to build types, we don't care about using the params... */\n\nimport { describe, expectTypeOf, it } from 'vitest';\nimport { doNothing } from './do-nothing';\nimport { funnel } from './funnel';\n\ndescribe('\\'call\\' method args', () => {\n  it('no args', () => {\n    const foo = funnel(doNothing(), {\n      reducer: (_: 'test' | undefined) => 'test' as const,\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<[]>();\n  });\n\n  it('non-optional args', () => {\n    const foo = funnel(doNothing(), {\n      // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n      reducer: (_: 'test' | undefined, a: string, b: number, c: boolean) =>\n        'test' as const,\n\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<\n      [a: string, b: number, c: boolean]\n    >();\n  });\n\n  it('optional args', () => {\n    const foo = funnel(doNothing(), {\n      // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n      reducer: (_: 'test' | undefined, a?: string) => 'test' as const,\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<[a?: string | undefined]>();\n  });\n\n  it('rest args', () => {\n    const foo = funnel(doNothing(), {\n      reducer:\n        // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n        (_: 'test' | undefined, ...as: Array<string>) => 'test' as const,\n\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<Array<string>>();\n  });\n});\n\ndescribe('derive the reducer accumulator type from the executor param', () => {\n  it('simple types', () => {\n    funnel(\n      (_: number) => {\n        // do nothing\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<number | undefined>();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n\n  it('arrays', () => {\n    funnel(\n      (_: ReadonlyArray<number>) => {\n        // do nothing,\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<\n            ReadonlyArray<number> | undefined\n          >();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n\n  it('objects', () => {\n    funnel(\n      (_: { readonly a: number }) => {\n        // do nothing\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<\n            { readonly a: number } | undefined\n          >();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n});\n\ndescribe('prevent bad options', () => {\n  it('minGapMs cannot be the only option with timing: end', () => {\n    funnel(\n      doNothing(),\n      // @ts-expect-error [ts(2345)] -- minGapMs cannot be set alone]\n      { minGapMs: 100 },\n    );\n\n    funnel(\n      doNothing(),\n      // @ts-expect-error [ts(2345)] -- minGapMs cannot be set alone]\n      { triggerAt: 'end', minGapMs: 100 },\n    );\n\n    // But it works with \"start\" and \"both\"\n\n    funnel(doNothing(), { triggerAt: 'start', minGapMs: 100 });\n    funnel(doNothing(), { triggerAt: 'both', minGapMs: 100 });\n  });\n});\n"],"mappings":"2KAMA,EAAS,yBAA8B,CACrC,EAAG,cAAiB,CAMlB,EALY,EAAO,GAAW,CAAE,CAC9B,QAAU,GAA0B,OACpC,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAAmB,EACrD,CAEF,EAAG,wBAA2B,CAS5B,EARY,EAAO,GAAW,CAAE,CAE9B,SAAU,EAAuB,EAAW,EAAW,IACrD,OAEF,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAE/B,EACH,CAEF,EAAG,oBAAuB,CAOxB,EANY,EAAO,GAAW,CAAE,CAE9B,SAAU,EAAuB,IAAe,OAChD,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAAyC,EAC3E,CAEF,EAAG,gBAAmB,CASpB,EARY,EAAO,GAAW,CAAE,CAC9B,SAEG,EAAuB,GAAG,IAAsB,OAEnD,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAA8B,EAChE,EACF,CAEF,EAAS,kEAAqE,CAC5E,EAAG,mBAAsB,CACvB,EACG,GAAc,GAGf,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAAmC,CAElD,GAET,UAAW,QACZ,CACF,EACD,CAEF,EAAG,aAAgB,CACjB,EACG,GAA6B,GAG9B,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAEnB,CAEI,GAET,UAAW,QACZ,CACF,EACD,CAEF,EAAG,cAAiB,CAClB,EACG,GAA8B,GAG/B,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAEnB,CAEI,GAET,UAAW,QACZ,CACF,EACD,EACF,CAEF,EAAS,0BAA6B,CACpC,EAAG,0DAA6D,CAC9D,EACE,GAAW,CAEX,CAAE,SAAU,IAAK,CAClB,CAED,EACE,GAAW,CAEX,CAAE,UAAW,MAAO,SAAU,IAAK,CACpC,CAID,EAAO,GAAW,CAAE,CAAE,UAAW,QAAS,SAAU,IAAK,CAAC,CAC1D,EAAO,GAAW,CAAE,CAAE,UAAW,OAAQ,SAAU,IAAK,CAAC,EACzD,EACF"}
+{"version":3,"file":"funnel.test-d.js","names":[],"sources":["../src/funnel.test-d.ts"],"sourcesContent":["/* eslint-disable ts/no-unused-vars -- We just want to build types, we don't care about using the params... */\n\nimport { describe, expectTypeOf, it } from 'vitest';\nimport { doNothing } from './do-nothing';\nimport { funnel } from './funnel';\n\ndescribe('\\'call\\' method args', () => {\n  it('no args', () => {\n    const foo = funnel(doNothing(), {\n      reducer: (_: 'test' | undefined) => 'test' as const,\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<[]>();\n  });\n\n  it('non-optional args', () => {\n    const foo = funnel(doNothing(), {\n      // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n      reducer: (_: 'test' | undefined, a: string, b: number, c: boolean) =>\n        'test' as const,\n\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<\n      [a: string, b: number, c: boolean]\n    >();\n  });\n\n  it('optional args', () => {\n    const foo = funnel(doNothing(), {\n      // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n      reducer: (_: 'test' | undefined, a?: string) => 'test' as const,\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<[a?: string | undefined]>();\n  });\n\n  it('rest args', () => {\n    const foo = funnel(doNothing(), {\n      reducer:\n        // @ts-expect-error [ts(6133)] -- We want to use explicit names, not prefixed with _\n        (_: 'test' | undefined, ...as: Array<string>) => 'test' as const,\n\n      triggerAt: 'start',\n    });\n\n    expectTypeOf(foo.call).parameters.toEqualTypeOf<Array<string>>();\n  });\n});\n\ndescribe('derive the reducer accumulator type from the executor param', () => {\n  it('simple types', () => {\n    funnel(\n      (_: number) => {\n        // do nothing\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<number | undefined>();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n\n  it('arrays', () => {\n    funnel(\n      (_: ReadonlyArray<number>) => {\n        // do nothing,\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<\n            ReadonlyArray<number> | undefined\n          >();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n\n  it('objects', () => {\n    funnel(\n      (_: { readonly a: number }) => {\n        // do nothing\n      },\n      {\n        reducer: (reduced) => {\n          expectTypeOf(reduced).toEqualTypeOf<\n            { readonly a: number } | undefined\n          >();\n\n          return reduced!;\n        },\n        triggerAt: 'start',\n      },\n    );\n  });\n});\n\ndescribe('prevent bad options', () => {\n  it('minGapMs cannot be the only option with timing: end', () => {\n    funnel(\n      doNothing(),\n      // @ts-expect-error [ts(2345)] -- minGapMs cannot be set alone]\n      { minGapMs: 100 },\n    );\n\n    funnel(\n      doNothing(),\n      // @ts-expect-error [ts(2345)] -- minGapMs cannot be set alone]\n      { triggerAt: 'end', minGapMs: 100 },\n    );\n\n    // But it works with \"start\" and \"both\"\n\n    funnel(doNothing(), { triggerAt: 'start', minGapMs: 100 });\n    funnel(doNothing(), { triggerAt: 'both', minGapMs: 100 });\n  });\n});\n"],"mappings":"sIAMA,EAAS,yBAA8B,CACrC,EAAG,cAAiB,CAMlB,EALY,EAAO,GAAW,CAAE,CAC9B,QAAU,GAA0B,OACpC,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAAmB,EACrD,CAEF,EAAG,wBAA2B,CAS5B,EARY,EAAO,GAAW,CAAE,CAE9B,SAAU,EAAuB,EAAW,EAAW,IACrD,OAEF,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAE/B,EACH,CAEF,EAAG,oBAAuB,CAOxB,EANY,EAAO,GAAW,CAAE,CAE9B,SAAU,EAAuB,IAAe,OAChD,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAAyC,EAC3E,CAEF,EAAG,gBAAmB,CASpB,EARY,EAAO,GAAW,CAAE,CAC9B,SAEG,EAAuB,GAAG,IAAsB,OAEnD,UAAW,QACZ,CAAC,CAEe,KAAK,CAAC,WAAW,eAA8B,EAChE,EACF,CAEF,EAAS,kEAAqE,CAC5E,EAAG,mBAAsB,CACvB,EACG,GAAc,GAGf,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAAmC,CAElD,GAET,UAAW,QACZ,CACF,EACD,CAEF,EAAG,aAAgB,CACjB,EACG,GAA6B,GAG9B,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAEnB,CAEI,GAET,UAAW,QACZ,CACF,EACD,CAEF,EAAG,cAAiB,CAClB,EACG,GAA8B,GAG/B,CACE,QAAU,IACR,EAAa,EAAQ,CAAC,eAEnB,CAEI,GAET,UAAW,QACZ,CACF,EACD,EACF,CAEF,EAAS,0BAA6B,CACpC,EAAG,0DAA6D,CAC9D,EACE,GAAW,CAEX,CAAE,SAAU,IAAK,CAClB,CAED,EACE,GAAW,CAEX,CAAE,UAAW,MAAO,SAAU,IAAK,CACpC,CAID,EAAO,GAAW,CAAE,CAAE,UAAW,QAAS,SAAU,IAAK,CAAC,CAC1D,EAAO,GAAW,CAAE,CAAE,UAAW,OAAQ,SAAU,IAAK,CAAC,EACzD,EACF"}

package/dist/funnel.test.cjs

@@ -1 +1 @@
-const e=require(`./dist-3WF0YzcR.cjs`),t=require(`./constant-BuIJ9GIn.cjs`),n=require(`./do-nothing-Cc1faYu6.cjs`),r=require(`./funnel-CL-QFpGk.cjs`),i=require(`./sleep-1rGV3wAg.cjs`),a=16;function o(e,t){return e===void 0?[t]:[...e,t]}e.describe(`reducer behavior`,()=>{e.it(`passes the reduced arg to the executor`,()=>{let n=e.vi.fn();r.funnel(n,{reducer:t.constant(`hello world`),triggerAt:`start`,minQuietPeriodMs:16}).call(),e.globalExpect(n).toHaveBeenCalledTimes(1),e.globalExpect(n).toHaveBeenLastCalledWith(`hello world`)}),e.it(`reduces call args`,async()=>{let t=e.vi.fn(e=>{}),n=r.funnel(t,{reducer:(e,t)=>(e??0)+t,minQuietPeriodMs:32,triggerAt:`end`});n.call(1),n.call(2),n.call(3),await i.sleep(16),n.call(4),n.call(5),n.call(6),await i.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith(21)}),e.it(`does not invoke if reduceArgs returns undefined`,async()=>{let n=e.vi.fn();r.funnel(n,{reducer:t.constant(void 0),triggerAt:`end`,minQuietPeriodMs:16}).call(),await i.sleep(32),e.globalExpect(n).toHaveBeenCalledTimes(0)}),e.it(`supports multiple arguments`,()=>{let t=e.vi.fn();r.funnel(t,{reducer:(e,t,n,r)=>[e,t,n,r],triggerAt:`start`,minQuietPeriodMs:16}).call(1,`a`,!0),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([void 0,1,`a`,!0])}),e.it(`reducer isn't called again when 'invokedAt: start'`,async()=>{let t=e.vi.fn(o),a=r.funnel(n.doNothing(),{reducer:t,triggerAt:`start`,minQuietPeriodMs:16});a.call(`a`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith(void 0,`a`),a.call(`b`),a.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1)})}),e.describe(`non-trivial (>0ms) timer duration`,()=>{e.describe(`delay timer`,()=>{e.it(`invokedAt: start`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1),n.call(`d`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`d`])}),e.it(`invokedAt: both`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(2),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(3),e.globalExpect(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.it(`invocations in the middle of a window`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(.75*16),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(.75*16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])})}),e.describe(`burst timer`,()=>{e.it(`invokedAt: start`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1),n.call(`d`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`d`])}),e.it(`invokedAt: both`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(3),e.globalExpect(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(4),e.globalExpect(t).toHaveBeenLastCalledWith([`e`,`f`])}),e.it(`invokedAt: end`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`e`),n.call(`f`),n.call(`g`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`e`,`f`,`g`])}),e.it(`invocations in the middle of a window`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(.9*16),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(.1*16),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`,`b`,`c`,`d`,`e`,`f`])}),e.it(`maxBurstDurationMs limits the burst duration`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,minQuietPeriodMs:16,maxBurstDurationMs:32,triggerAt:`end`});n.call(`a`),await i.sleep(.75*16),n.call(`b`),await i.sleep(.75*16),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(.75*16),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),e.describe(`both timers`,()=>{e.it(`delay is longer than burst`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,minGapMs:32,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.it(`burst is longer than delay`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:32,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.it(`burst and delay are equal`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(3),e.globalExpect(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.it(`delay and maxBurstDurationMs are equal`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:32,maxBurstDurationMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(3),e.globalExpect(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])})})}),e.describe(`immediate (===0) timer durations`,()=>{e.describe(`delay timer`,()=>{e.it(`invokedAt: start`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it(`invokedAt: both`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(3),e.globalExpect(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.it(`with a non-trivial burst timer`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:16});n.call(`a`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`])})}),e.describe(`burst timer`,()=>{e.it(`invokedAt: start`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(2)}),e.it(`invokedAt: both`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(3),e.globalExpect(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(4),e.globalExpect(t).toHaveBeenLastCalledWith([`e`,`f`])}),e.it(`invokedAt: end`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.it(`with a non-trivial delay timer`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`])}),e.it(`burst timer with non-trivial maxBurstDuration`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,minQuietPeriodMs:0,maxBurstDurationMs:16,triggerAt:`end`});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(0),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),e.it(`both timers`,async()=>{let t=e.vi.fn();r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0}).call(`a`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it(`maxBurstDurationMs = 0 limits the burst immediately`,async()=>{let t=e.vi.fn();r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16,maxBurstDurationMs:0}).call(`a`),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`])}),e.it(`all timeouts zero`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0,maxBurstDurationMs:0});n.call(`a`),n.call(`b`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`])})}),e.describe(`default minQuietPeriodMs === 0 when minGapMs is not defined`,()=>{e.it(`invokedAt: start`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`});n.call(`a`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(1),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`c`])}),e.it(`invokedAt: both`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`});n.call(`a`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`]),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(3),e.globalExpect(t).toHaveBeenLastCalledWith([`c`])})}),e.describe(`utility functions`,()=>{e.describe(`flush`,()=>{e.it(`flush triggers an immediate invocation`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.flush(),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1)}),e.it(`flush during active burst`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:32});n.call(`a`),n.call(`b`),n.call(`c`),await i.sleep(16),n.flush(),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await i.sleep(32),e.globalExpect(t).toHaveBeenCalledTimes(1)})}),e.describe(`cancel`,()=>{e.it(`cancel prevents invocation`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.cancel(),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(0)}),e.it(`cancel during delay period`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:32});n.call(`a`),n.call(`b`),await i.sleep(16),n.cancel(),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1)})}),e.describe(`isIdle`,()=>{e.it(`isIdle reflects the funnel's state`,()=>{let t=r.funnel(e.vi.fn(),{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});e.globalExpect(t.isIdle).toBe(!0),t.call(`a`),e.globalExpect(t.isIdle).toBe(!1),t.cancel(),e.globalExpect(t.isIdle).toBe(!0)}),e.it(`isIdle works when burst duration is 0`,async()=>{let t=r.funnel(e.vi.fn(),{reducer:o,triggerAt:`end`,minQuietPeriodMs:0});e.globalExpect(t.isIdle).toBe(!0),t.call(`a`),t.call(`b`),t.call(`c`),e.globalExpect(t.isIdle).toBe(!1),await i.sleep(0),e.globalExpect(t.isIdle).toBe(!0)})})}),e.describe(`edge-cases`,()=>{e.it(`bursts that start late don't prevent delayed invocations`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:16,minGapMs:32});n.call(`a`),n.call(`b`),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(1.5*16),e.globalExpect(t).toHaveBeenCalledTimes(1),n.call(`d`),n.call(`e`),n.call(`f`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(.5*16),e.globalExpect(t).toHaveBeenCalledTimes(2),e.globalExpect(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.it(`delay timeouts don't cause an invocation in the middle of bursts`,async()=>{let t=e.vi.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:32,minGapMs:16});n.call(`a`),e.globalExpect(t).toHaveBeenCalledTimes(1),e.globalExpect(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`b`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),n.call(`c`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),n.call(`d`),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.globalExpect(t).toHaveBeenCalledTimes(2)})});
+const e=require(`./dist-8XtUY3ad.cjs`),t=require(`./constant.cjs`),n=require(`./do-nothing.cjs`),r=require(`./funnel.cjs`),i=require(`./sleep.cjs`),a=16;function o(e,t){return e===void 0?[t]:[...e,t]}e.i(`reducer behavior`,()=>{e.a(`passes the reduced arg to the executor`,()=>{let n=e.r.fn();r.funnel(n,{reducer:t.constant(`hello world`),triggerAt:`start`,minQuietPeriodMs:16}).call(),e.n(n).toHaveBeenCalledTimes(1),e.n(n).toHaveBeenLastCalledWith(`hello world`)}),e.a(`reduces call args`,async()=>{let t=e.r.fn(e=>{}),n=r.funnel(t,{reducer:(e,t)=>(e??0)+t,minQuietPeriodMs:32,triggerAt:`end`});n.call(1),n.call(2),n.call(3),await i.sleep(16),n.call(4),n.call(5),n.call(6),await i.sleep(32),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith(21)}),e.a(`does not invoke if reduceArgs returns undefined`,async()=>{let n=e.r.fn();r.funnel(n,{reducer:t.constant(void 0),triggerAt:`end`,minQuietPeriodMs:16}).call(),await i.sleep(32),e.n(n).toHaveBeenCalledTimes(0)}),e.a(`supports multiple arguments`,()=>{let t=e.r.fn();r.funnel(t,{reducer:(e,t,n,r)=>[e,t,n,r],triggerAt:`start`,minQuietPeriodMs:16}).call(1,`a`,!0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([void 0,1,`a`,!0])}),e.a(`reducer isn't called again when 'invokedAt: start'`,async()=>{let t=e.r.fn(o),a=r.funnel(n.doNothing(),{reducer:t,triggerAt:`start`,minQuietPeriodMs:16});a.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith(void 0,`a`),a.call(`b`),a.call(`c`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(32),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`non-trivial (>0ms) timer duration`,()=>{e.i(`delay timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),n.call(`d`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`])}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`invocations in the middle of a window`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(.75*16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(.75*16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])})}),e.i(`burst timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),n.call(`d`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`])}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(4),e.n(t).toHaveBeenLastCalledWith([`e`,`f`])}),e.a(`invokedAt: end`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`e`),n.call(`f`),n.call(`g`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`e`,`f`,`g`])}),e.a(`invocations in the middle of a window`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(.9*16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(.1*16),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`,`d`,`e`,`f`])}),e.a(`maxBurstDurationMs limits the burst duration`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minQuietPeriodMs:16,maxBurstDurationMs:32,triggerAt:`end`});n.call(`a`),await i.sleep(.75*16),n.call(`b`),await i.sleep(.75*16),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(.75*16),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),e.i(`both timers`,()=>{e.a(`delay is longer than burst`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:32,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.a(`burst is longer than delay`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:32,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.a(`burst and delay are equal`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`delay and maxBurstDurationMs are equal`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minGapMs:16,minQuietPeriodMs:32,maxBurstDurationMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])})})}),e.i(`immediate (===0) timer durations`,()=>{e.i(`delay timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`with a non-trivial burst timer`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:16});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`])})}),e.i(`burst timer`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2)}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`d`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(4),e.n(t).toHaveBeenLastCalledWith([`e`,`f`])}),e.a(`invokedAt: end`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),e.a(`with a non-trivial delay timer`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:16,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`])}),e.a(`burst timer with non-trivial maxBurstDuration`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,minQuietPeriodMs:0,maxBurstDurationMs:16,triggerAt:`end`});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(0),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),e.a(`both timers`,async()=>{let t=e.r.fn();r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0}).call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`maxBurstDurationMs = 0 limits the burst immediately`,async()=>{let t=e.r.fn();r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16,maxBurstDurationMs:0}).call(`a`),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`])}),e.a(`all timeouts zero`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0,maxBurstDurationMs:0});n.call(`a`),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`])})}),e.i(`default minQuietPeriodMs === 0 when minGapMs is not defined`,()=>{e.a(`invokedAt: start`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(1),n.call(`c`),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`c`])}),e.a(`invokedAt: both`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(0),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`]),n.call(`c`),e.n(t).toHaveBeenCalledTimes(3),e.n(t).toHaveBeenLastCalledWith([`c`])})}),e.i(`utility functions`,()=>{e.i(`flush`,()=>{e.a(`flush triggers an immediate invocation`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.flush(),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1)}),e.a(`flush during active burst`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:32});n.call(`a`),n.call(`b`),n.call(`c`),await i.sleep(16),n.flush(),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await i.sleep(32),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`cancel`,()=>{e.a(`cancel prevents invocation`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.cancel(),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(0)}),e.a(`cancel during delay period`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`start`,minGapMs:32});n.call(`a`),n.call(`b`),await i.sleep(16),n.cancel(),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1)})}),e.i(`isIdle`,()=>{e.a(`isIdle reflects the funnel's state`,()=>{let t=r.funnel(e.r.fn(),{reducer:o,triggerAt:`end`,minQuietPeriodMs:16});e.n(t.isIdle).toBe(!0),t.call(`a`),e.n(t.isIdle).toBe(!1),t.cancel(),e.n(t.isIdle).toBe(!0)}),e.a(`isIdle works when burst duration is 0`,async()=>{let t=r.funnel(e.r.fn(),{reducer:o,triggerAt:`end`,minQuietPeriodMs:0});e.n(t.isIdle).toBe(!0),t.call(`a`),t.call(`b`),t.call(`c`),e.n(t.isIdle).toBe(!1),await i.sleep(0),e.n(t.isIdle).toBe(!0)})})}),e.i(`edge-cases`,()=>{e.a(`bursts that start late don't prevent delayed invocations`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:16,minGapMs:32});n.call(`a`),n.call(`b`),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(1.5*16),e.n(t).toHaveBeenCalledTimes(1),n.call(`d`),n.call(`e`),n.call(`f`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(.5*16),e.n(t).toHaveBeenCalledTimes(2),e.n(t).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),e.a(`delay timeouts don't cause an invocation in the middle of bursts`,async()=>{let t=e.r.fn(),n=r.funnel(t,{reducer:o,triggerAt:`both`,minQuietPeriodMs:32,minGapMs:16});n.call(`a`),e.n(t).toHaveBeenCalledTimes(1),e.n(t).toHaveBeenLastCalledWith([`a`]),await i.sleep(16),n.call(`b`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),n.call(`c`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),n.call(`d`),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(1),await i.sleep(16),e.n(t).toHaveBeenCalledTimes(2)})});

package/dist/funnel.test.js

@@ -1,2 +1,2 @@
-import{describe as e,globalExpect as t,it as n,vi as r}from"./dist-C2nNPffG.js";import{constant as i}from"./constant-DrpDXHc7.js";import{doNothing as a}from"./do-nothing-Be29JGDG.js";import{funnel as o}from"./funnel-CEbURcmp.js";import{sleep as s}from"./sleep-DvzRMgY-.js";function c(e,t){return e===void 0?[t]:[...e,t]}e(`reducer behavior`,()=>{n(`passes the reduced arg to the executor`,()=>{let e=r.fn();o(e,{reducer:i(`hello world`),triggerAt:`start`,minQuietPeriodMs:16}).call(),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith(`hello world`)}),n(`reduces call args`,async()=>{let e=r.fn(e=>{}),n=o(e,{reducer:(e,t)=>(e??0)+t,minQuietPeriodMs:32,triggerAt:`end`});n.call(1),n.call(2),n.call(3),await s(16),n.call(4),n.call(5),n.call(6),await s(32),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith(21)}),n(`does not invoke if reduceArgs returns undefined`,async()=>{let e=r.fn();o(e,{reducer:i(void 0),triggerAt:`end`,minQuietPeriodMs:16}).call(),await s(32),t(e).toHaveBeenCalledTimes(0)}),n(`supports multiple arguments`,()=>{let e=r.fn();o(e,{reducer:(e,t,n,r)=>[e,t,n,r],triggerAt:`start`,minQuietPeriodMs:16}).call(1,`a`,!0),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([void 0,1,`a`,!0])}),n(`reducer isn't called again when 'invokedAt: start'`,async()=>{let e=r.fn(c),n=o(a(),{reducer:e,triggerAt:`start`,minQuietPeriodMs:16});n.call(`a`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith(void 0,`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),await s(32),t(e).toHaveBeenCalledTimes(1)})}),e(`non-trivial (>0ms) timer duration`,()=>{e(`delay timer`,()=>{n(`invokedAt: start`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`start`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),t(e).toHaveBeenCalledTimes(1),n.call(`d`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`d`])}),n(`invokedAt: both`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(2),await s(16),t(e).toHaveBeenCalledTimes(3),t(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`invocations in the middle of a window`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minGapMs:16});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(.75*16),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(1),await s(.75*16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])})}),e(`burst timer`,()=>{n(`invokedAt: start`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`start`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),t(e).toHaveBeenCalledTimes(1),n.call(`d`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`d`])}),n(`invokedAt: both`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(3),t(e).toHaveBeenLastCalledWith([`d`]),await s(16),t(e).toHaveBeenCalledTimes(4),t(e).toHaveBeenLastCalledWith([`e`,`f`])}),n(`invokedAt: end`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(0),await s(16),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`e`),n.call(`f`),n.call(`g`),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`e`,`f`,`g`])}),n(`invocations in the middle of a window`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(0),await s(.9*16),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(0),await s(.1*16),t(e).toHaveBeenCalledTimes(0),await s(16),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`,`b`,`c`,`d`,`e`,`f`])}),n(`maxBurstDurationMs limits the burst duration`,async()=>{let e=r.fn(),n=o(e,{reducer:c,minQuietPeriodMs:16,maxBurstDurationMs:32,triggerAt:`end`});n.call(`a`),await s(.75*16),n.call(`b`),await s(.75*16),n.call(`c`),t(e).toHaveBeenCalledTimes(0),await s(.75*16),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),e(`both timers`,()=>{n(`delay is longer than burst`,async()=>{let e=r.fn(),n=o(e,{reducer:c,minGapMs:32,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`burst is longer than delay`,async()=>{let e=r.fn(),n=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:32,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`burst and delay are equal`,async()=>{let e=r.fn(),n=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(16),t(e).toHaveBeenCalledTimes(3),t(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`delay and maxBurstDurationMs are equal`,async()=>{let e=r.fn(),n=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:32,maxBurstDurationMs:16,triggerAt:`both`});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(16),t(e).toHaveBeenCalledTimes(3),t(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])})})}),e(`immediate (===0) timer durations`,()=>{e(`delay timer`,()=>{n(`invokedAt: start`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`start`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(0),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`d`]),await s(0),t(e).toHaveBeenCalledTimes(2)}),n(`invokedAt: both`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minGapMs:0});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(0),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(0),t(e).toHaveBeenCalledTimes(3),t(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`with a non-trivial burst timer`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:16});n.call(`a`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),n.call(`b`),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`])})}),e(`burst timer`,()=>{n(`invokedAt: start`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`start`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(0),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`d`]),await s(0),t(e).toHaveBeenCalledTimes(2)}),n(`invokedAt: both`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(0),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(3),t(e).toHaveBeenLastCalledWith([`d`]),await s(0),t(e).toHaveBeenCalledTimes(4),t(e).toHaveBeenLastCalledWith([`e`,`f`])}),n(`invokedAt: end`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(0),await s(0),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(1),await s(0),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`with a non-trivial delay timer`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minGapMs:16,minQuietPeriodMs:0});n.call(`a`),n.call(`b`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(0),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`])}),n(`burst timer with non-trivial maxBurstDuration`,async()=>{let e=r.fn(),n=o(e,{reducer:c,minQuietPeriodMs:0,maxBurstDurationMs:16,triggerAt:`end`});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(0),await s(0),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),n(`both timers`,async()=>{let e=r.fn();o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0}).call(`a`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(0),t(e).toHaveBeenCalledTimes(1)}),n(`maxBurstDurationMs = 0 limits the burst immediately`,async()=>{let e=r.fn();o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16,maxBurstDurationMs:0}).call(`a`),await s(0),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`])}),n(`all timeouts zero`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0,maxBurstDurationMs:0});n.call(`a`),n.call(`b`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(0),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`])})}),e(`default minQuietPeriodMs === 0 when minGapMs is not defined`,()=>{n(`invokedAt: start`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`start`});n.call(`a`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),n.call(`b`),t(e).toHaveBeenCalledTimes(1),await s(0),t(e).toHaveBeenCalledTimes(1),n.call(`c`),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`c`])}),n(`invokedAt: both`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`});n.call(`a`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),n.call(`b`),t(e).toHaveBeenCalledTimes(1),await s(0),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`]),n.call(`c`),t(e).toHaveBeenCalledTimes(3),t(e).toHaveBeenLastCalledWith([`c`])})}),e(`utility functions`,()=>{e(`flush`,()=>{n(`flush triggers an immediate invocation`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.flush(),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await s(16),t(e).toHaveBeenCalledTimes(1)}),n(`flush during active burst`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:32});n.call(`a`),n.call(`b`),n.call(`c`),await s(16),n.flush(),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await s(32),t(e).toHaveBeenCalledTimes(1)})}),e(`cancel`,()=>{n(`cancel prevents invocation`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});n.call(`a`),n.call(`b`),n.call(`c`),n.cancel(),await s(16),t(e).toHaveBeenCalledTimes(0)}),n(`cancel during delay period`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`start`,minGapMs:32});n.call(`a`),n.call(`b`),await s(16),n.cancel(),await s(16),t(e).toHaveBeenCalledTimes(1)})}),e(`isIdle`,()=>{n(`isIdle reflects the funnel's state`,()=>{let e=o(r.fn(),{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t(e.isIdle).toBe(!0),e.call(`a`),t(e.isIdle).toBe(!1),e.cancel(),t(e.isIdle).toBe(!0)}),n(`isIdle works when burst duration is 0`,async()=>{let e=o(r.fn(),{reducer:c,triggerAt:`end`,minQuietPeriodMs:0});t(e.isIdle).toBe(!0),e.call(`a`),e.call(`b`),e.call(`c`),t(e.isIdle).toBe(!1),await s(0),t(e.isIdle).toBe(!0)})})}),e(`edge-cases`,()=>{n(`bursts that start late don't prevent delayed invocations`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:16,minGapMs:32});n.call(`a`),n.call(`b`),n.call(`c`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(1.5*16),t(e).toHaveBeenCalledTimes(1),n.call(`d`),n.call(`e`),n.call(`f`),t(e).toHaveBeenCalledTimes(1),await s(.5*16),t(e).toHaveBeenCalledTimes(2),t(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`delay timeouts don't cause an invocation in the middle of bursts`,async()=>{let e=r.fn(),n=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:32,minGapMs:16});n.call(`a`),t(e).toHaveBeenCalledTimes(1),t(e).toHaveBeenLastCalledWith([`a`]),await s(16),n.call(`b`),t(e).toHaveBeenCalledTimes(1),await s(16),n.call(`c`),t(e).toHaveBeenCalledTimes(1),await s(16),n.call(`d`),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(1),await s(16),t(e).toHaveBeenCalledTimes(2)})});
+import{constant as e}from"./constant.js";import{doNothing as t}from"./do-nothing.js";import{a as n,i as r,n as i,r as a}from"./dist-Bd1vawFi.js";import{funnel as o}from"./funnel.js";import{sleep as s}from"./sleep.js";function c(e,t){return e===void 0?[t]:[...e,t]}r(`reducer behavior`,()=>{n(`passes the reduced arg to the executor`,()=>{let t=a.fn();o(t,{reducer:e(`hello world`),triggerAt:`start`,minQuietPeriodMs:16}).call(),i(t).toHaveBeenCalledTimes(1),i(t).toHaveBeenLastCalledWith(`hello world`)}),n(`reduces call args`,async()=>{let e=a.fn(e=>{}),t=o(e,{reducer:(e,t)=>(e??0)+t,minQuietPeriodMs:32,triggerAt:`end`});t.call(1),t.call(2),t.call(3),await s(16),t.call(4),t.call(5),t.call(6),await s(32),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith(21)}),n(`does not invoke if reduceArgs returns undefined`,async()=>{let t=a.fn();o(t,{reducer:e(void 0),triggerAt:`end`,minQuietPeriodMs:16}).call(),await s(32),i(t).toHaveBeenCalledTimes(0)}),n(`supports multiple arguments`,()=>{let e=a.fn();o(e,{reducer:(e,t,n,r)=>[e,t,n,r],triggerAt:`start`,minQuietPeriodMs:16}).call(1,`a`,!0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([void 0,1,`a`,!0])}),n(`reducer isn't called again when 'invokedAt: start'`,async()=>{let e=a.fn(c),n=o(t(),{reducer:e,triggerAt:`start`,minQuietPeriodMs:16});n.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith(void 0,`a`),n.call(`b`),n.call(`c`),i(e).toHaveBeenCalledTimes(1),await s(32),i(e).toHaveBeenCalledTimes(1)})}),r(`non-trivial (>0ms) timer duration`,()=>{r(`delay timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minGapMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(1),t.call(`d`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`])}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),await s(16),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`invocations in the middle of a window`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(.75*16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(.75*16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])})}),r(`burst timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(1),t.call(`d`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`])}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`]),await s(16),i(e).toHaveBeenCalledTimes(4),i(e).toHaveBeenLastCalledWith([`e`,`f`])}),n(`invokedAt: end`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(16),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),t.call(`e`),t.call(`f`),t.call(`g`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`e`,`f`,`g`])}),n(`invocations in the middle of a window`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(.9*16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(0),await s(.1*16),i(e).toHaveBeenCalledTimes(0),await s(16),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`,`d`,`e`,`f`])}),n(`maxBurstDurationMs limits the burst duration`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minQuietPeriodMs:16,maxBurstDurationMs:32,triggerAt:`end`});t.call(`a`),await s(.75*16),t.call(`b`),await s(.75*16),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(.75*16),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),r(`both timers`,()=>{n(`delay is longer than burst`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:32,minQuietPeriodMs:16,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`burst is longer than delay`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:32,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`burst and delay are equal`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:16,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(16),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`delay and maxBurstDurationMs are equal`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minGapMs:16,minQuietPeriodMs:32,maxBurstDurationMs:16,triggerAt:`both`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(16),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])})})}),r(`immediate (===0) timer durations`,()=>{r(`delay timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minGapMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`]),await s(0),i(e).toHaveBeenCalledTimes(2)}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),await s(0),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`with a non-trivial burst timer`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:16});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`])})}),r(`burst timer`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`]),await s(0),i(e).toHaveBeenCalledTimes(2)}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`d`]),await s(0),i(e).toHaveBeenCalledTimes(4),i(e).toHaveBeenLastCalledWith([`e`,`f`])}),n(`invokedAt: end`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`d`,`e`,`f`])}),n(`with a non-trivial delay timer`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:16,minQuietPeriodMs:0});t.call(`a`),t.call(`b`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`])}),n(`burst timer with non-trivial maxBurstDuration`,async()=>{let e=a.fn(),t=o(e,{reducer:c,minQuietPeriodMs:0,maxBurstDurationMs:16,triggerAt:`end`});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(0),await s(0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`])})}),n(`both timers`,async()=>{let e=a.fn();o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0}).call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(1)}),n(`maxBurstDurationMs = 0 limits the burst immediately`,async()=>{let e=a.fn();o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16,maxBurstDurationMs:0}).call(`a`),await s(0),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`])}),n(`all timeouts zero`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minGapMs:0,minQuietPeriodMs:0,maxBurstDurationMs:0});t.call(`a`),t.call(`b`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`])})}),r(`default minQuietPeriodMs === 0 when minGapMs is not defined`,()=>{n(`invokedAt: start`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(0),i(e).toHaveBeenCalledTimes(1),t.call(`c`),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`c`])}),n(`invokedAt: both`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(0),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`]),t.call(`c`),i(e).toHaveBeenCalledTimes(3),i(e).toHaveBeenLastCalledWith([`c`])})}),r(`utility functions`,()=>{r(`flush`,()=>{n(`flush triggers an immediate invocation`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),t.flush(),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await s(16),i(e).toHaveBeenCalledTimes(1)}),n(`flush during active burst`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:32});t.call(`a`),t.call(`b`),t.call(`c`),await s(16),t.flush(),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`,`b`,`c`]),await s(32),i(e).toHaveBeenCalledTimes(1)})}),r(`cancel`,()=>{n(`cancel prevents invocation`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});t.call(`a`),t.call(`b`),t.call(`c`),t.cancel(),await s(16),i(e).toHaveBeenCalledTimes(0)}),n(`cancel during delay period`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`start`,minGapMs:32});t.call(`a`),t.call(`b`),await s(16),t.cancel(),await s(16),i(e).toHaveBeenCalledTimes(1)})}),r(`isIdle`,()=>{n(`isIdle reflects the funnel's state`,()=>{let e=o(a.fn(),{reducer:c,triggerAt:`end`,minQuietPeriodMs:16});i(e.isIdle).toBe(!0),e.call(`a`),i(e.isIdle).toBe(!1),e.cancel(),i(e.isIdle).toBe(!0)}),n(`isIdle works when burst duration is 0`,async()=>{let e=o(a.fn(),{reducer:c,triggerAt:`end`,minQuietPeriodMs:0});i(e.isIdle).toBe(!0),e.call(`a`),e.call(`b`),e.call(`c`),i(e.isIdle).toBe(!1),await s(0),i(e.isIdle).toBe(!0)})})}),r(`edge-cases`,()=>{n(`bursts that start late don't prevent delayed invocations`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:16,minGapMs:32});t.call(`a`),t.call(`b`),t.call(`c`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(1.5*16),i(e).toHaveBeenCalledTimes(1),t.call(`d`),t.call(`e`),t.call(`f`),i(e).toHaveBeenCalledTimes(1),await s(.5*16),i(e).toHaveBeenCalledTimes(2),i(e).toHaveBeenLastCalledWith([`b`,`c`,`d`,`e`,`f`])}),n(`delay timeouts don't cause an invocation in the middle of bursts`,async()=>{let e=a.fn(),t=o(e,{reducer:c,triggerAt:`both`,minQuietPeriodMs:32,minGapMs:16});t.call(`a`),i(e).toHaveBeenCalledTimes(1),i(e).toHaveBeenLastCalledWith([`a`]),await s(16),t.call(`b`),i(e).toHaveBeenCalledTimes(1),await s(16),t.call(`c`),i(e).toHaveBeenCalledTimes(1),await s(16),t.call(`d`),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(1),await s(16),i(e).toHaveBeenCalledTimes(2)})});
 //# sourceMappingURL=funnel.test.js.map