@tanstack/solid-pacer 0.5.0 → 0.7.0

package/dist/cjs/async-debouncer/createAsyncDebouncer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createAsyncDebouncer.cjs","sources":["../../../src/async-debouncer/createAsyncDebouncer.ts"],"sourcesContent":["import { AsyncDebouncer } from '@tanstack/pacer/async-debouncer'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { AsyncDebouncerOptions } from '@tanstack/pacer/async-debouncer'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { Accessor } from 'solid-js'\n\nexport interface SolidAsyncDebouncer<TFn extends AnyAsyncFunction>\n  extends Omit<\n    AsyncDebouncer<TFn>,\n    | 'getErrorCount'\n    | 'getIsPending'\n    | 'getLastResult'\n    | 'getSettleCount'\n    | 'getSuccessCount'\n  > {\n  errorCount: Accessor<number>\n  isPending: Accessor<boolean>\n  lastResult: Accessor<ReturnType<TFn> | undefined>\n  settleCount: Accessor<number>\n  successCount: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncDebouncer` instance to delay execution of an async function.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a debouncer instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Async debouncing ensures that an async function only executes after a specified delay has passed since its last invocation.\n * This is useful for handling fast-changing inputs like search fields, form validation, or any scenario where you want to\n * wait for user input to settle before making expensive async calls.\n *\n * @example\n * ```tsx\n * // Basic API call debouncing\n * const { maybeExecute } = createAsyncDebouncer(\n *   async (query: string) => {\n *     const results = await api.search(query);\n *     return results;\n *   },\n *   { wait: 500 }\n * );\n *\n * // With state management\n * const [results, setResults] = createSignal([]);\n * const { maybeExecute } = createAsyncDebouncer(\n *   async (searchTerm) => {\n *     const data = await searchAPI(searchTerm);\n *     setResults(data);\n *   },\n *   {\n *     wait: 300,\n *   }\n * );\n * ```\n */\n\nexport function createAsyncDebouncer<TFn extends AnyAsyncFunction>(\n  fn: TFn,\n  initialOptions: AsyncDebouncerOptions<TFn>,\n): SolidAsyncDebouncer<TFn> {\n  const asyncDebouncer = new AsyncDebouncer<TFn>(fn, initialOptions)\n\n  const [errorCount, setErrorCount] = createSignal(\n    asyncDebouncer.getErrorCount(),\n  )\n  const [settleCount, setSettleCount] = createSignal(\n    asyncDebouncer.getSettleCount(),\n  )\n  const [successCount, setSuccessCount] = createSignal(\n    asyncDebouncer.getSuccessCount(),\n  )\n  const [isPending, setIsPending] = createSignal(asyncDebouncer.getIsPending())\n  const [lastResult, setLastResult] = createSignal(\n    asyncDebouncer.getLastResult(),\n  )\n\n  function setOptions(newOptions: Partial<AsyncDebouncerOptions<TFn>>) {\n    asyncDebouncer.setOptions({\n      ...newOptions,\n      onSettled: (asyncDebouncer) => {\n        setSuccessCount(asyncDebouncer.getSuccessCount())\n        setErrorCount(asyncDebouncer.getErrorCount())\n        setSettleCount(asyncDebouncer.getSettleCount())\n        setIsPending(asyncDebouncer.getIsPending())\n        setLastResult(asyncDebouncer.getLastResult())\n        const onSettled = newOptions.onSettled ?? initialOptions.onSettled\n        onSettled?.(asyncDebouncer)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...bindInstanceMethods(asyncDebouncer),\n    errorCount,\n    isPending,\n    lastResult,\n    settleCount,\n    successCount,\n    setOptions,\n  } as SolidAsyncDebouncer<TFn>\n}\n"],"names":["asyncDebouncer","AsyncDebouncer","createSignal","bindInstanceMethods"],"mappings":";;;;;AA0DgB,SAAA,qBACd,IACA,gBAC0B;AAC1B,QAAMA,mBAAiB,IAAIC,8BAAoB,IAAI,cAAc;AAE3D,QAAA,CAAC,YAAY,aAAa,IAAIC,QAAA;AAAA,IAClCF,iBAAe,cAAc;AAAA,EAC/B;AACM,QAAA,CAAC,aAAa,cAAc,IAAIE,QAAA;AAAA,IACpCF,iBAAe,eAAe;AAAA,EAChC;AACM,QAAA,CAAC,cAAc,eAAe,IAAIE,QAAA;AAAA,IACtCF,iBAAe,gBAAgB;AAAA,EACjC;AACA,QAAM,CAAC,WAAW,YAAY,IAAIE,QAAAA,aAAaF,iBAAe,cAAc;AACtE,QAAA,CAAC,YAAY,aAAa,IAAIE,QAAA;AAAA,IAClCF,iBAAe,cAAc;AAAA,EAC/B;AAEA,WAAS,WAAW,YAAiD;AACnEA,qBAAe,WAAW;AAAA,MACxB,GAAG;AAAA,MACH,WAAW,CAACA,oBAAmB;AACbA,wBAAAA,gBAAe,iBAAiB;AAClCA,sBAAAA,gBAAe,eAAe;AAC7BA,uBAAAA,gBAAe,gBAAgB;AACjCA,qBAAAA,gBAAe,cAAc;AAC5BA,sBAAAA,gBAAe,eAAe;AACtC,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAYA;AAAAA,MAAc;AAAA,IAC5B,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAGG,MAAAA,oBAAoBH,gBAAc;AAAA,IACrC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}
+{"version":3,"file":"createAsyncDebouncer.cjs","sources":["../../../src/async-debouncer/createAsyncDebouncer.ts"],"sourcesContent":["import { AsyncDebouncer } from '@tanstack/pacer/async-debouncer'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { AsyncDebouncerOptions } from '@tanstack/pacer/async-debouncer'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { Accessor } from 'solid-js'\n\nexport interface SolidAsyncDebouncer<TFn extends AnyAsyncFunction>\n  extends Omit<\n    AsyncDebouncer<TFn>,\n    | 'getErrorCount'\n    | 'getIsPending'\n    | 'getLastResult'\n    | 'getSettleCount'\n    | 'getSuccessCount'\n  > {\n  errorCount: Accessor<number>\n  isPending: Accessor<boolean>\n  lastResult: Accessor<ReturnType<TFn> | undefined>\n  settleCount: Accessor<number>\n  successCount: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncDebouncer` instance to delay execution of an async function.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a debouncer instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Async debouncing ensures that an async function only executes after a specified delay has passed since its last invocation.\n * Each new invocation resets the delay timer. This is useful for handling frequent events like window resizing\n * or input changes where you only want to execute the handler after the events have stopped occurring.\n *\n * Unlike throttling which allows execution at regular intervals, debouncing prevents any execution until\n * the function stops being called for the specified delay period.\n *\n * Unlike the non-async Debouncer, this async version supports returning values from the debounced function,\n * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call\n * instead of setting the result on a state variable from within the debounced function.\n *\n * Error Handling:\n * - If an `onError` handler is provided, it will be called with the error and debouncer instance\n * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown\n * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed\n * - Both onError and throwOnError can be used together - the handler will be called before any error is thrown\n * - The error state can be checked using the underlying AsyncDebouncer instance\n *\n * @example\n * ```tsx\n * // Basic API call debouncing\n * const { maybeExecute } = createAsyncDebouncer(\n *   async (query: string) => {\n *     const results = await api.search(query);\n *     return results;\n *   },\n *   { wait: 500 }\n * );\n *\n * // With state management\n * const [results, setResults] = createSignal([]);\n * const { maybeExecute } = createAsyncDebouncer(\n *   async (searchTerm) => {\n *     const data = await searchAPI(searchTerm);\n *     setResults(data);\n *   },\n *   {\n *     wait: 300,\n *     leading: true,   // Execute immediately on first call\n *     trailing: false, // Skip trailing edge updates\n *     onError: (error) => {\n *       console.error('API call failed:', error);\n *     }\n *   }\n * );\n * ```\n */\nexport function createAsyncDebouncer<TFn extends AnyAsyncFunction>(\n  fn: TFn,\n  initialOptions: AsyncDebouncerOptions<TFn>,\n): SolidAsyncDebouncer<TFn> {\n  const asyncDebouncer = new AsyncDebouncer<TFn>(fn, initialOptions)\n\n  const [errorCount, setErrorCount] = createSignal(\n    asyncDebouncer.getErrorCount(),\n  )\n  const [settleCount, setSettleCount] = createSignal(\n    asyncDebouncer.getSettleCount(),\n  )\n  const [successCount, setSuccessCount] = createSignal(\n    asyncDebouncer.getSuccessCount(),\n  )\n  const [isPending, setIsPending] = createSignal(asyncDebouncer.getIsPending())\n  const [lastResult, setLastResult] = createSignal(\n    asyncDebouncer.getLastResult(),\n  )\n\n  function setOptions(newOptions: Partial<AsyncDebouncerOptions<TFn>>) {\n    asyncDebouncer.setOptions({\n      ...newOptions,\n      onSettled: (asyncDebouncer) => {\n        setSuccessCount(asyncDebouncer.getSuccessCount())\n        setErrorCount(asyncDebouncer.getErrorCount())\n        setSettleCount(asyncDebouncer.getSettleCount())\n        setIsPending(asyncDebouncer.getIsPending())\n        setLastResult(asyncDebouncer.getLastResult())\n        const onSettled = newOptions.onSettled ?? initialOptions.onSettled\n        onSettled?.(asyncDebouncer)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...bindInstanceMethods(asyncDebouncer),\n    errorCount,\n    isPending,\n    lastResult,\n    settleCount,\n    successCount,\n    setOptions,\n  } as SolidAsyncDebouncer<TFn>\n}\n"],"names":["asyncDebouncer","AsyncDebouncer","createSignal","bindInstanceMethods"],"mappings":";;;;;AA4EgB,SAAA,qBACd,IACA,gBAC0B;AAC1B,QAAMA,mBAAiB,IAAIC,8BAAoB,IAAI,cAAc;AAE3D,QAAA,CAAC,YAAY,aAAa,IAAIC,QAAA;AAAA,IAClCF,iBAAe,cAAc;AAAA,EAC/B;AACM,QAAA,CAAC,aAAa,cAAc,IAAIE,QAAA;AAAA,IACpCF,iBAAe,eAAe;AAAA,EAChC;AACM,QAAA,CAAC,cAAc,eAAe,IAAIE,QAAA;AAAA,IACtCF,iBAAe,gBAAgB;AAAA,EACjC;AACA,QAAM,CAAC,WAAW,YAAY,IAAIE,QAAAA,aAAaF,iBAAe,cAAc;AACtE,QAAA,CAAC,YAAY,aAAa,IAAIE,QAAA;AAAA,IAClCF,iBAAe,cAAc;AAAA,EAC/B;AAEA,WAAS,WAAW,YAAiD;AACnEA,qBAAe,WAAW;AAAA,MACxB,GAAG;AAAA,MACH,WAAW,CAACA,oBAAmB;AACbA,wBAAAA,gBAAe,iBAAiB;AAClCA,sBAAAA,gBAAe,eAAe;AAC7BA,uBAAAA,gBAAe,gBAAgB;AACjCA,qBAAAA,gBAAe,cAAc;AAC5BA,sBAAAA,gBAAe,eAAe;AACtC,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAYA;AAAAA,MAAc;AAAA,IAC5B,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAGG,MAAAA,oBAAoBH,gBAAc;AAAA,IACrC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}

package/dist/cjs/async-debouncer/createAsyncDebouncer.d.cts

@@ -15,8 +15,22 @@ export interface SolidAsyncDebouncer<TFn extends AnyAsyncFunction> extends Omit<
  * you can integrate with any state management solution (createSignal, etc).
  *
  * Async debouncing ensures that an async function only executes after a specified delay has passed since its last invocation.
- * This is useful for handling fast-changing inputs like search fields, form validation, or any scenario where you want to
- * wait for user input to settle before making expensive async calls.
+ * Each new invocation resets the delay timer. This is useful for handling frequent events like window resizing
+ * or input changes where you only want to execute the handler after the events have stopped occurring.
+ *
+ * Unlike throttling which allows execution at regular intervals, debouncing prevents any execution until
+ * the function stops being called for the specified delay period.
+ *
+ * Unlike the non-async Debouncer, this async version supports returning values from the debounced function,
+ * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call
+ * instead of setting the result on a state variable from within the debounced function.
+ *
+ * Error Handling:
+ * - If an `onError` handler is provided, it will be called with the error and debouncer instance
+ * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown
+ * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed
+ * - Both onError and throwOnError can be used together - the handler will be called before any error is thrown
+ * - The error state can be checked using the underlying AsyncDebouncer instance
  *
  * @example
  * ```tsx
@@ -38,6 +52,11 @@ export interface SolidAsyncDebouncer<TFn extends AnyAsyncFunction> extends Omit<
  *   },
  *   {
  *     wait: 300,
+ *     leading: true,   // Execute immediately on first call
+ *     trailing: false, // Skip trailing edge updates
+ *     onError: (error) => {
+ *       console.error('API call failed:', error);
+ *     }
  *   }
  * );
  * ```

package/dist/cjs/async-queuer/createAsyncQueuer.cjs

@@ -3,10 +3,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const asyncQueuer = require("@tanstack/pacer/async-queuer");
 const solidJs = require("solid-js");
 const utils = require("@tanstack/pacer/utils");
-function createAsyncQueuer(initialOptions = {}) {
-  const asyncQueuer$1 = new asyncQueuer.AsyncQueuer(initialOptions);
-  const [executionCount, setExecutionCount] = solidJs.createSignal(
-    asyncQueuer$1.getExecutionCount()
+function createAsyncQueuer(fn, initialOptions = {}) {
+  const asyncQueuer$1 = new asyncQueuer.AsyncQueuer(fn, initialOptions);
+  const [successCount, setSuccessCount] = solidJs.createSignal(
+    asyncQueuer$1.getSuccessCount()
+  );
+  const [errorCount, setErrorCount] = solidJs.createSignal(asyncQueuer$1.getErrorCount());
+  const [settledCount, setSettledCount] = solidJs.createSignal(
+    asyncQueuer$1.getSettledCount()
   );
   const [rejectionCount, setRejectionCount] = solidJs.createSignal(
     asyncQueuer$1.getRejectionCount()
@@ -18,8 +22,12 @@ function createAsyncQueuer(initialOptions = {}) {
   const [allItems, setAllItems] = solidJs.createSignal(
     asyncQueuer$1.getAllItems()
   );
-  const [activeItems, setActiveItems] = solidJs.createSignal(asyncQueuer$1.getActiveItems());
-  const [pendingItems, setPendingItems] = solidJs.createSignal(asyncQueuer$1.getPendingItems());
+  const [activeItems, setActiveItems] = solidJs.createSignal(
+    asyncQueuer$1.getActiveItems()
+  );
+  const [pendingItems, setPendingItems] = solidJs.createSignal(
+    asyncQueuer$1.getPendingItems()
+  );
   const [peek, setPeek] = solidJs.createSignal(
     asyncQueuer$1.getPeek()
   );
@@ -27,15 +35,18 @@ function createAsyncQueuer(initialOptions = {}) {
   asyncQueuer$1.setOptions({
     onItemsChange: (queuer) => {
       var _a;
-      setExecutionCount(queuer.getExecutionCount());
+      setActiveItems(queuer.getActiveItems());
+      setAllItems(queuer.getAllItems());
+      setErrorCount(queuer.getErrorCount());
       setIsEmpty(queuer.getIsEmpty());
       setIsFull(queuer.getIsFull());
       setIsIdle(queuer.getIsIdle());
-      setAllItems(queuer.getAllItems());
-      setActiveItems(queuer.getActiveItems());
-      setPendingItems(queuer.getPendingItems());
       setPeek(() => queuer.getPeek());
+      setPendingItems(queuer.getPendingItems());
+      setRejectionCount(queuer.getRejectionCount());
+      setSettledCount(queuer.getSettledCount());
       setSize(queuer.getSize());
+      setSuccessCount(queuer.getSuccessCount());
       (_a = initialOptions.onItemsChange) == null ? void 0 : _a.call(initialOptions, queuer);
     },
     onIsRunningChange: (queuer) => {
@@ -53,16 +64,18 @@ function createAsyncQueuer(initialOptions = {}) {
   return {
     ...utils.bindInstanceMethods(asyncQueuer$1),
     activeItems,
-    executionCount,
+    allItems,
+    errorCount,
     isEmpty,
     isFull,
     isIdle,
     isRunning,
-    allItems,
     peek,
     pendingItems,
     rejectionCount,
-    size
+    settledCount,
+    size,
+    successCount
   };
 }
 exports.createAsyncQueuer = createAsyncQueuer;

package/dist/cjs/async-queuer/createAsyncQueuer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createAsyncQueuer.cjs","sources":["../../../src/async-queuer/createAsyncQueuer.ts"],"sourcesContent":["import { AsyncQueuer } from '@tanstack/pacer/async-queuer'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AsyncQueuerOptions } from '@tanstack/pacer/async-queuer'\n\nexport interface SolidAsyncQueuer<TValue>\n  extends Omit<\n    AsyncQueuer<TValue>,\n    | 'getActiveItems'\n    | 'getAllItems'\n    | 'getExecutionCount'\n    | 'getIsEmpty'\n    | 'getIsFull'\n    | 'getIsIdle'\n    | 'getIsRunning'\n    | 'getPeek'\n    | 'getPendingItems'\n    | 'getSize'\n  > {\n  /**\n   * Signal version of `getActiveItems`\n   */\n  activeItems: Accessor<Array<() => Promise<TValue>>>\n  /**\n   * Signal version of `getAllItems`\n   */\n  allItems: Accessor<Array<() => Promise<TValue>>>\n  /**\n   * Signal version of `getExecutionCount`\n   */\n  executionCount: Accessor<number>\n  /**\n   * Signal version of `getIsEmpty`\n   */\n  isEmpty: Accessor<boolean>\n  /**\n   * Signal version of `getIsFull`\n   */\n  isFull: Accessor<boolean>\n  /**\n   * Signal version of `getIsIdle`\n   */\n  isIdle: Accessor<boolean>\n  /**\n   * Signal version of `getIsRunning`\n   */\n  isRunning: Accessor<boolean>\n  /**\n   * Signal version of `getPeek`\n   */\n  peek: Accessor<(() => Promise<TValue>) | undefined>\n  /**\n   * Signal version of `getPendingItems`\n   */\n  pendingItems: Accessor<Array<() => Promise<TValue>>>\n  /**\n   * Signal version of `getRejectionCount`\n   */\n  rejectionCount: Accessor<number>\n  /**\n   * Signal version of `getSize`\n   */\n  size: Accessor<number>\n}\n\n/**\n * A lower-level React hook that creates an `AsyncQueuer` instance for managing an async queue of items.\n *\n * This hook provides a flexible, state-management agnostic way to handle queued async operations.\n * It returns a queuer instance with methods to add items, control queue execution, and monitor queue state.\n *\n * The queue can be configured with:\n * - Maximum concurrent operations\n * - Maximum queue size\n * - Processing function for queue items\n * - Various lifecycle callbacks\n *\n * The hook returns an object containing methods to:\n * - Add/remove items from the queue\n * - Start/stop queue processing\n * - Get queue status and items\n * - Register event handlers\n * - Control execution throttling\n *\n * @example\n * ```tsx\n * // Basic async queuer for API requests\n * const asyncQueuer = createAsyncQueuer({\n *   initialItems: [],\n *   concurrency: 2,\n *   maxSize: 100,\n *   started: false,\n * });\n *\n * // Add items to queue\n * asyncQueuer.addItem(newItem);\n *\n * // Start processing\n * asyncQueuer.start();\n *\n * // Handle results\n * asyncQueuer.onSuccess((result) => {\n *   console.log('Item processed:', result);\n * });\n *\n * asyncQueuer.onError((error) => {\n *   console.error('Processing failed:', error);\n * });\n * ```\n */\nexport function createAsyncQueuer<TValue>(\n  initialOptions: AsyncQueuerOptions<TValue> = {},\n): SolidAsyncQueuer<TValue> {\n  const asyncQueuer = new AsyncQueuer<TValue>(initialOptions)\n\n  const [executionCount, setExecutionCount] = createSignal(\n    asyncQueuer.getExecutionCount(),\n  )\n  const [rejectionCount, setRejectionCount] = createSignal(\n    asyncQueuer.getRejectionCount(),\n  )\n  const [isEmpty, setIsEmpty] = createSignal(asyncQueuer.getIsEmpty())\n  const [isFull, setIsFull] = createSignal(asyncQueuer.getIsFull())\n  const [isIdle, setIsIdle] = createSignal(asyncQueuer.getIsIdle())\n  const [isRunning, setIsRunning] = createSignal(asyncQueuer.getIsRunning())\n  const [allItems, setAllItems] = createSignal<Array<() => Promise<TValue>>>(\n    asyncQueuer.getAllItems(),\n  )\n  const [activeItems, setActiveItems] = createSignal<\n    Array<() => Promise<TValue>>\n  >(asyncQueuer.getActiveItems())\n  const [pendingItems, setPendingItems] = createSignal<\n    Array<() => Promise<TValue>>\n  >(asyncQueuer.getPendingItems())\n  const [peek, setPeek] = createSignal<(() => Promise<TValue>) | undefined>(\n    asyncQueuer.getPeek(),\n  )\n  const [size, setSize] = createSignal(asyncQueuer.getSize())\n\n  asyncQueuer.setOptions({\n    onItemsChange: (queuer) => {\n      setExecutionCount(queuer.getExecutionCount())\n      setIsEmpty(queuer.getIsEmpty())\n      setIsFull(queuer.getIsFull())\n      setIsIdle(queuer.getIsIdle())\n      setAllItems(queuer.getAllItems())\n      setActiveItems(queuer.getActiveItems())\n      setPendingItems(queuer.getPendingItems())\n      setPeek(() => queuer.getPeek())\n      setSize(queuer.getSize())\n      initialOptions.onItemsChange?.(queuer)\n    },\n    onIsRunningChange: (queuer) => {\n      setIsRunning(queuer.getIsRunning())\n      setIsIdle(queuer.getIsIdle())\n      initialOptions.onIsRunningChange?.(queuer)\n    },\n    onReject: (item, queuer) => {\n      setRejectionCount(queuer.getRejectionCount())\n      initialOptions.onReject?.(item, queuer)\n    },\n  })\n\n  return {\n    ...bindInstanceMethods(asyncQueuer),\n    activeItems,\n    executionCount,\n    isEmpty,\n    isFull,\n    isIdle,\n    isRunning,\n    allItems,\n    peek,\n    pendingItems,\n    rejectionCount,\n    size,\n  } as SolidAsyncQueuer<TValue>\n}\n"],"names":["asyncQueuer","AsyncQueuer","createSignal","bindInstanceMethods"],"mappings":";;;;;AA+GgB,SAAA,kBACd,iBAA6C,IACnB;AACpB,QAAAA,gBAAc,IAAIC,YAAA,YAAoB,cAAc;AAEpD,QAAA,CAAC,gBAAgB,iBAAiB,IAAIC,QAAA;AAAA,IAC1CF,cAAY,kBAAkB;AAAA,EAChC;AACM,QAAA,CAAC,gBAAgB,iBAAiB,IAAIE,QAAA;AAAA,IAC1CF,cAAY,kBAAkB;AAAA,EAChC;AACA,QAAM,CAAC,SAAS,UAAU,IAAIE,QAAAA,aAAaF,cAAY,YAAY;AACnE,QAAM,CAAC,QAAQ,SAAS,IAAIE,QAAAA,aAAaF,cAAY,WAAW;AAChE,QAAM,CAAC,QAAQ,SAAS,IAAIE,QAAAA,aAAaF,cAAY,WAAW;AAChE,QAAM,CAAC,WAAW,YAAY,IAAIE,QAAAA,aAAaF,cAAY,cAAc;AACnE,QAAA,CAAC,UAAU,WAAW,IAAIE,QAAA;AAAA,IAC9BF,cAAY,YAAY;AAAA,EAC1B;AACA,QAAM,CAAC,aAAa,cAAc,IAAIE,QAAAA,aAEpCF,cAAY,gBAAgB;AAC9B,QAAM,CAAC,cAAc,eAAe,IAAIE,QAAAA,aAEtCF,cAAY,iBAAiB;AACzB,QAAA,CAAC,MAAM,OAAO,IAAIE,QAAA;AAAA,IACtBF,cAAY,QAAQ;AAAA,EACtB;AACA,QAAM,CAAC,MAAM,OAAO,IAAIE,QAAAA,aAAaF,cAAY,SAAS;AAE1DA,gBAAY,WAAW;AAAA,IACrB,eAAe,CAAC,WAAW;;AACP,wBAAA,OAAO,mBAAmB;AACjC,iBAAA,OAAO,YAAY;AACpB,gBAAA,OAAO,WAAW;AAClB,gBAAA,OAAO,WAAW;AAChB,kBAAA,OAAO,aAAa;AACjB,qBAAA,OAAO,gBAAgB;AACtB,sBAAA,OAAO,iBAAiB;AAChC,cAAA,MAAM,OAAO,SAAS;AACtB,cAAA,OAAO,SAAS;AACxB,2BAAe,kBAAf,wCAA+B;AAAA,IACjC;AAAA,IACA,mBAAmB,CAAC,WAAW;;AAChB,mBAAA,OAAO,cAAc;AACxB,gBAAA,OAAO,WAAW;AAC5B,2BAAe,sBAAf,wCAAmC;AAAA,IACrC;AAAA,IACA,UAAU,CAAC,MAAM,WAAW;;AACR,wBAAA,OAAO,mBAAmB;AAC7B,2BAAA,aAAA,wCAAW,MAAM;AAAA,IAAM;AAAA,EACxC,CACD;AAEM,SAAA;AAAA,IACL,GAAGG,MAAAA,oBAAoBH,aAAW;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}
+{"version":3,"file":"createAsyncQueuer.cjs","sources":["../../../src/async-queuer/createAsyncQueuer.ts"],"sourcesContent":["import { AsyncQueuer } from '@tanstack/pacer/async-queuer'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AsyncQueuerOptions } from '@tanstack/pacer/async-queuer'\n\nexport interface SolidAsyncQueuer<TValue>\n  extends Omit<\n    AsyncQueuer<TValue>,\n    | 'getActiveItems'\n    | 'getAllItems'\n    | 'getErrorCount'\n    | 'getIsEmpty'\n    | 'getIsFull'\n    | 'getIsIdle'\n    | 'getIsRunning'\n    | 'getPeek'\n    | 'getPendingItems'\n    | 'getRejectionCount'\n    | 'getSettledCount'\n    | 'getSize'\n    | 'getSuccessCount'\n  > {\n  /**\n   * Signal version of `getActiveItems`\n   */\n  activeItems: Accessor<Array<TValue>>\n  /**\n   * Signal version of `getAllItems`\n   */\n  allItems: Accessor<Array<TValue>>\n  /**\n   * Signal version of `getErrorCount`\n   */\n  errorCount: Accessor<number>\n  /**\n   * Signal version of `getIsEmpty`\n   */\n  isEmpty: Accessor<boolean>\n  /**\n   * Signal version of `getIsFull`\n   */\n  isFull: Accessor<boolean>\n  /**\n   * Signal version of `getIsIdle`\n   */\n  isIdle: Accessor<boolean>\n  /**\n   * Signal version of `getIsRunning`\n   */\n  isRunning: Accessor<boolean>\n  /**\n   * Signal version of `getPeek`\n   */\n  peek: Accessor<TValue | undefined>\n  /**\n   * Signal version of `getPendingItems`\n   */\n  pendingItems: Accessor<Array<TValue>>\n  /**\n   * Signal version of `getRejectionCount`\n   */\n  rejectionCount: Accessor<number>\n  /**\n   * Signal version of `getSettledCount`\n   */\n  settledCount: Accessor<number>\n  /**\n   * Signal version of `getSize`\n   */\n  size: Accessor<number>\n  /**\n   * Signal version of `getSuccessCount`\n   */\n  successCount: Accessor<number>\n}\n\n/**\n * Creates a Solid-compatible AsyncQueuer instance for managing an asynchronous queue of items, exposing Solid signals for all stateful properties.\n *\n * Features:\n * - Priority queueing via `getPriority` or item `priority` property\n * - Configurable concurrency limit\n * - FIFO (First In First Out) or LIFO (Last In First Out) queue behavior\n * - Pause/resume processing\n * - Task cancellation\n * - Item expiration\n * - Lifecycle callbacks for success, error, settled, items change, etc.\n * - All stateful properties (active items, pending items, counts, etc.) are exposed as Solid signals for reactivity\n *\n * Tasks are processed concurrently up to the configured concurrency limit. When a task completes,\n * the next pending task is processed if the concurrency limit allows.\n *\n * Error Handling:\n * - If an `onError` handler is provided, it will be called with the error and queuer instance\n * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown\n * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed\n * - Both onError and throwOnError can be used together; the handler will be called before any error is thrown\n * - The error state can be checked using the underlying AsyncQueuer instance\n *\n * Example usage:\n * ```tsx\n * // Basic async queuer for API requests\n * const asyncQueuer = createAsyncQueuer(async (item) => {\n *   // process item\n *   return await fetchData(item);\n * }, {\n *   initialItems: [],\n *   concurrency: 2,\n *   maxSize: 100,\n *   started: false,\n *   onSuccess: (result) => {\n *     console.log('Item processed:', result);\n *   },\n *   onError: (error) => {\n *     console.error('Processing failed:', error);\n *   }\n * });\n *\n * // Add items to queue\n * asyncQueuer.addItem(newItem);\n *\n * // Start processing\n * asyncQueuer.start();\n *\n * // Use Solid signals in your UI\n * const pending = asyncQueuer.pendingItems();\n * ```\n */\nexport function createAsyncQueuer<TValue>(\n  fn: (value: TValue) => Promise<any>,\n  initialOptions: AsyncQueuerOptions<TValue> = {},\n): SolidAsyncQueuer<TValue> {\n  const asyncQueuer = new AsyncQueuer<TValue>(fn, initialOptions)\n\n  const [successCount, setSuccessCount] = createSignal(\n    asyncQueuer.getSuccessCount(),\n  )\n  const [errorCount, setErrorCount] = createSignal(asyncQueuer.getErrorCount())\n  const [settledCount, setSettledCount] = createSignal(\n    asyncQueuer.getSettledCount(),\n  )\n  const [rejectionCount, setRejectionCount] = createSignal(\n    asyncQueuer.getRejectionCount(),\n  )\n  const [isEmpty, setIsEmpty] = createSignal(asyncQueuer.getIsEmpty())\n  const [isFull, setIsFull] = createSignal(asyncQueuer.getIsFull())\n  const [isIdle, setIsIdle] = createSignal(asyncQueuer.getIsIdle())\n  const [isRunning, setIsRunning] = createSignal(asyncQueuer.getIsRunning())\n  const [allItems, setAllItems] = createSignal<Array<TValue>>(\n    asyncQueuer.getAllItems(),\n  )\n  const [activeItems, setActiveItems] = createSignal<Array<TValue>>(\n    asyncQueuer.getActiveItems(),\n  )\n  const [pendingItems, setPendingItems] = createSignal<Array<TValue>>(\n    asyncQueuer.getPendingItems(),\n  )\n  const [peek, setPeek] = createSignal<TValue | undefined>(\n    asyncQueuer.getPeek(),\n  )\n  const [size, setSize] = createSignal(asyncQueuer.getSize())\n\n  asyncQueuer.setOptions({\n    onItemsChange: (queuer) => {\n      setActiveItems(queuer.getActiveItems())\n      setAllItems(queuer.getAllItems())\n      setErrorCount(queuer.getErrorCount())\n      setIsEmpty(queuer.getIsEmpty())\n      setIsFull(queuer.getIsFull())\n      setIsIdle(queuer.getIsIdle())\n      setPeek(() => queuer.getPeek())\n      setPendingItems(queuer.getPendingItems())\n      setRejectionCount(queuer.getRejectionCount())\n      setSettledCount(queuer.getSettledCount())\n      setSize(queuer.getSize())\n      setSuccessCount(queuer.getSuccessCount())\n      initialOptions.onItemsChange?.(queuer)\n    },\n    onIsRunningChange: (queuer) => {\n      setIsRunning(queuer.getIsRunning())\n      setIsIdle(queuer.getIsIdle())\n      initialOptions.onIsRunningChange?.(queuer)\n    },\n    onReject: (item, queuer) => {\n      setRejectionCount(queuer.getRejectionCount())\n      initialOptions.onReject?.(item, queuer)\n    },\n  })\n\n  return {\n    ...bindInstanceMethods(asyncQueuer),\n    activeItems,\n    allItems,\n    errorCount,\n    isEmpty,\n    isFull,\n    isIdle,\n    isRunning,\n    peek,\n    pendingItems,\n    rejectionCount,\n    settledCount,\n    size,\n    successCount,\n  } as SolidAsyncQueuer<TValue>\n}\n"],"names":["asyncQueuer","AsyncQueuer","createSignal","bindInstanceMethods"],"mappings":";;;;;AAiIO,SAAS,kBACd,IACA,iBAA6C,IACnB;AAC1B,QAAMA,gBAAc,IAAIC,wBAAoB,IAAI,cAAc;AAExD,QAAA,CAAC,cAAc,eAAe,IAAIC,QAAA;AAAA,IACtCF,cAAY,gBAAgB;AAAA,EAC9B;AACA,QAAM,CAAC,YAAY,aAAa,IAAIE,QAAAA,aAAaF,cAAY,eAAe;AACtE,QAAA,CAAC,cAAc,eAAe,IAAIE,QAAA;AAAA,IACtCF,cAAY,gBAAgB;AAAA,EAC9B;AACM,QAAA,CAAC,gBAAgB,iBAAiB,IAAIE,QAAA;AAAA,IAC1CF,cAAY,kBAAkB;AAAA,EAChC;AACA,QAAM,CAAC,SAAS,UAAU,IAAIE,QAAAA,aAAaF,cAAY,YAAY;AACnE,QAAM,CAAC,QAAQ,SAAS,IAAIE,QAAAA,aAAaF,cAAY,WAAW;AAChE,QAAM,CAAC,QAAQ,SAAS,IAAIE,QAAAA,aAAaF,cAAY,WAAW;AAChE,QAAM,CAAC,WAAW,YAAY,IAAIE,QAAAA,aAAaF,cAAY,cAAc;AACnE,QAAA,CAAC,UAAU,WAAW,IAAIE,QAAA;AAAA,IAC9BF,cAAY,YAAY;AAAA,EAC1B;AACM,QAAA,CAAC,aAAa,cAAc,IAAIE,QAAA;AAAA,IACpCF,cAAY,eAAe;AAAA,EAC7B;AACM,QAAA,CAAC,cAAc,eAAe,IAAIE,QAAA;AAAA,IACtCF,cAAY,gBAAgB;AAAA,EAC9B;AACM,QAAA,CAAC,MAAM,OAAO,IAAIE,QAAA;AAAA,IACtBF,cAAY,QAAQ;AAAA,EACtB;AACA,QAAM,CAAC,MAAM,OAAO,IAAIE,QAAAA,aAAaF,cAAY,SAAS;AAE1DA,gBAAY,WAAW;AAAA,IACrB,eAAe,CAAC,WAAW;;AACV,qBAAA,OAAO,gBAAgB;AAC1B,kBAAA,OAAO,aAAa;AAClB,oBAAA,OAAO,eAAe;AACzB,iBAAA,OAAO,YAAY;AACpB,gBAAA,OAAO,WAAW;AAClB,gBAAA,OAAO,WAAW;AACpB,cAAA,MAAM,OAAO,SAAS;AACd,sBAAA,OAAO,iBAAiB;AACtB,wBAAA,OAAO,mBAAmB;AAC5B,sBAAA,OAAO,iBAAiB;AAChC,cAAA,OAAO,SAAS;AACR,sBAAA,OAAO,iBAAiB;AACxC,2BAAe,kBAAf,wCAA+B;AAAA,IACjC;AAAA,IACA,mBAAmB,CAAC,WAAW;;AAChB,mBAAA,OAAO,cAAc;AACxB,gBAAA,OAAO,WAAW;AAC5B,2BAAe,sBAAf,wCAAmC;AAAA,IACrC;AAAA,IACA,UAAU,CAAC,MAAM,WAAW;;AACR,wBAAA,OAAO,mBAAmB;AAC7B,2BAAA,aAAA,wCAAW,MAAM;AAAA,IAAM;AAAA,EACxC,CACD;AAEM,SAAA;AAAA,IACL,GAAGG,MAAAA,oBAAoBH,aAAW;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}

package/dist/cjs/async-queuer/createAsyncQueuer.d.cts

@@ -1,18 +1,18 @@
 import { AsyncQueuer, AsyncQueuerOptions } from '@tanstack/pacer/async-queuer';
 import { Accessor } from 'solid-js';
-export interface SolidAsyncQueuer<TValue> extends Omit<AsyncQueuer<TValue>, 'getActiveItems' | 'getAllItems' | 'getExecutionCount' | 'getIsEmpty' | 'getIsFull' | 'getIsIdle' | 'getIsRunning' | 'getPeek' | 'getPendingItems' | 'getSize'> {
+export interface SolidAsyncQueuer<TValue> extends Omit<AsyncQueuer<TValue>, 'getActiveItems' | 'getAllItems' | 'getErrorCount' | 'getIsEmpty' | 'getIsFull' | 'getIsIdle' | 'getIsRunning' | 'getPeek' | 'getPendingItems' | 'getRejectionCount' | 'getSettledCount' | 'getSize' | 'getSuccessCount'> {
     /**
      * Signal version of `getActiveItems`
      */
-    activeItems: Accessor<Array<() => Promise<TValue>>>;
+    activeItems: Accessor<Array<TValue>>;
     /**
      * Signal version of `getAllItems`
      */
-    allItems: Accessor<Array<() => Promise<TValue>>>;
+    allItems: Accessor<Array<TValue>>;
     /**
-     * Signal version of `getExecutionCount`
+     * Signal version of `getErrorCount`
      */
-    executionCount: Accessor<number>;
+    errorCount: Accessor<number>;
     /**
      * Signal version of `getIsEmpty`
      */
@@ -32,47 +32,68 @@ export interface SolidAsyncQueuer<TValue> extends Omit<AsyncQueuer<TValue>, 'get
     /**
      * Signal version of `getPeek`
      */
-    peek: Accessor<(() => Promise<TValue>) | undefined>;
+    peek: Accessor<TValue | undefined>;
     /**
      * Signal version of `getPendingItems`
      */
-    pendingItems: Accessor<Array<() => Promise<TValue>>>;
+    pendingItems: Accessor<Array<TValue>>;
     /**
      * Signal version of `getRejectionCount`
      */
     rejectionCount: Accessor<number>;
+    /**
+     * Signal version of `getSettledCount`
+     */
+    settledCount: Accessor<number>;
     /**
      * Signal version of `getSize`
      */
     size: Accessor<number>;
+    /**
+     * Signal version of `getSuccessCount`
+     */
+    successCount: Accessor<number>;
 }
 /**
- * A lower-level React hook that creates an `AsyncQueuer` instance for managing an async queue of items.
+ * Creates a Solid-compatible AsyncQueuer instance for managing an asynchronous queue of items, exposing Solid signals for all stateful properties.
  *
- * This hook provides a flexible, state-management agnostic way to handle queued async operations.
- * It returns a queuer instance with methods to add items, control queue execution, and monitor queue state.
+ * Features:
+ * - Priority queueing via `getPriority` or item `priority` property
+ * - Configurable concurrency limit
+ * - FIFO (First In First Out) or LIFO (Last In First Out) queue behavior
+ * - Pause/resume processing
+ * - Task cancellation
+ * - Item expiration
+ * - Lifecycle callbacks for success, error, settled, items change, etc.
+ * - All stateful properties (active items, pending items, counts, etc.) are exposed as Solid signals for reactivity
  *
- * The queue can be configured with:
- * - Maximum concurrent operations
- * - Maximum queue size
- * - Processing function for queue items
- * - Various lifecycle callbacks
+ * Tasks are processed concurrently up to the configured concurrency limit. When a task completes,
+ * the next pending task is processed if the concurrency limit allows.
  *
- * The hook returns an object containing methods to:
- * - Add/remove items from the queue
- * - Start/stop queue processing
- * - Get queue status and items
- * - Register event handlers
- * - Control execution throttling
+ * Error Handling:
+ * - If an `onError` handler is provided, it will be called with the error and queuer instance
+ * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown
+ * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed
+ * - Both onError and throwOnError can be used together; the handler will be called before any error is thrown
+ * - The error state can be checked using the underlying AsyncQueuer instance
  *
- * @example
+ * Example usage:
  * ```tsx
  * // Basic async queuer for API requests
- * const asyncQueuer = createAsyncQueuer({
+ * const asyncQueuer = createAsyncQueuer(async (item) => {
+ *   // process item
+ *   return await fetchData(item);
+ * }, {
  *   initialItems: [],
  *   concurrency: 2,
  *   maxSize: 100,
  *   started: false,
+ *   onSuccess: (result) => {
+ *     console.log('Item processed:', result);
+ *   },
+ *   onError: (error) => {
+ *     console.error('Processing failed:', error);
+ *   }
  * });
  *
  * // Add items to queue
@@ -81,14 +102,8 @@ export interface SolidAsyncQueuer<TValue> extends Omit<AsyncQueuer<TValue>, 'get
  * // Start processing
  * asyncQueuer.start();
  *
- * // Handle results
- * asyncQueuer.onSuccess((result) => {
- *   console.log('Item processed:', result);
- * });
- *
- * asyncQueuer.onError((error) => {
- *   console.error('Processing failed:', error);
- * });
+ * // Use Solid signals in your UI
+ * const pending = asyncQueuer.pendingItems();
  * ```
  */
-export declare function createAsyncQueuer<TValue>(initialOptions?: AsyncQueuerOptions<TValue>): SolidAsyncQueuer<TValue>;
+export declare function createAsyncQueuer<TValue>(fn: (value: TValue) => Promise<any>, initialOptions?: AsyncQueuerOptions<TValue>): SolidAsyncQueuer<TValue>;

package/dist/cjs/async-rate-limiter/createAsyncRateLimiter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createAsyncRateLimiter.cjs","sources":["../../../src/async-rate-limiter/createAsyncRateLimiter.ts"],"sourcesContent":["import { AsyncRateLimiter } from '@tanstack/pacer/async-rate-limiter'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { AsyncRateLimiterOptions } from '@tanstack/pacer/async-rate-limiter'\n\nexport interface SolidAsyncRateLimiter<TFn extends AnyAsyncFunction>\n  extends Omit<\n    AsyncRateLimiter<TFn>,\n    | 'getSuccessCount'\n    | 'getSettleCount'\n    | 'getErrorCount'\n    | 'getRejectionCount'\n    | 'getRemainingInWindow'\n    | 'getMsUntilNextWindow'\n  > {\n  successCount: Accessor<number>\n  settleCount: Accessor<number>\n  errorCount: Accessor<number>\n  rejectionCount: Accessor<number>\n  remainingInWindow: Accessor<number>\n  msUntilNextWindow: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncRateLimiter` instance to limit how many times an async function can execute within a time window.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a rate limiter instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Rate limiting allows an async function to execute up to a specified limit within a time window,\n * then blocks subsequent calls until the window passes. This is useful for respecting API rate limits,\n * managing resource constraints, or controlling bursts of async operations.\n *\n * Unlike the non-async RateLimiter, this async version supports returning values from the rate-limited function,\n * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call\n * instead of setting the result on a state variable from within the rate-limited function.\n *\n * The rate limiter supports two types of windows:\n * - 'fixed': A strict window that resets after the window period. All executions within the window count\n *   towards the limit, and the window resets completely after the period.\n * - 'sliding': A rolling window that allows executions as old ones expire. This provides a more\n *   consistent rate of execution over time.\n *\n * @example\n * ```tsx\n * // Basic API call rate limiting with return value\n * const { maybeExecute } = createAsyncRateLimiter(\n *   async (id: string) => {\n *     const data = await api.fetchData(id);\n *     return data; // Return value is preserved\n *   },\n *   { limit: 5, window: 1000 } // 5 calls per second\n * );\n *\n * // With state management and return value\n * const [data, setData] = createSignal(null);\n * const { maybeExecute } = createAsyncRateLimiter(\n *   async (query) => {\n *     const result = await searchAPI(query);\n *     setData(result);\n *     return result; // Return value can be used by the caller\n *   },\n *   {\n *     limit: 10,\n *     window: 60000, // 10 calls per minute\n *     onReject: (info) => console.log(`Rate limit exceeded: ${info.nextValidTime - Date.now()}ms until next window`)\n *   }\n * );\n * ```\n */\nexport function createAsyncRateLimiter<TFn extends AnyAsyncFunction>(\n  fn: TFn,\n  initialOptions: AsyncRateLimiterOptions<TFn>,\n): SolidAsyncRateLimiter<TFn> {\n  const asyncRateLimiter = new AsyncRateLimiter<TFn>(fn, initialOptions)\n\n  const [successCount, setSuccessCount] = createSignal(\n    asyncRateLimiter.getSuccessCount(),\n  )\n  const [rejectionCount, setRejectionCount] = createSignal(\n    asyncRateLimiter.getRejectionCount(),\n  )\n  const [errorCount, setErrorCount] = createSignal(\n    asyncRateLimiter.getErrorCount(),\n  )\n  const [settleCount, setSettleCount] = createSignal(\n    asyncRateLimiter.getSettleCount(),\n  )\n  const [remainingInWindow, setRemainingInWindow] = createSignal(\n    asyncRateLimiter.getRemainingInWindow(),\n  )\n  const [msUntilNextWindow, setMsUntilNextWindow] = createSignal(\n    asyncRateLimiter.getMsUntilNextWindow(),\n  )\n\n  function setOptions(newOptions: Partial<AsyncRateLimiterOptions<TFn>>) {\n    asyncRateLimiter.setOptions({\n      ...newOptions,\n      onSettled: (rateLimiter) => {\n        setSuccessCount(rateLimiter.getSuccessCount())\n        setSettleCount(rateLimiter.getSettleCount())\n        setErrorCount(rateLimiter.getErrorCount())\n        setRejectionCount(rateLimiter.getRejectionCount())\n        setRemainingInWindow(rateLimiter.getRemainingInWindow())\n        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow())\n\n        const onSettled = newOptions.onSettled ?? initialOptions.onSettled\n        onSettled?.(rateLimiter)\n      },\n      onReject: (rateLimiter) => {\n        setRejectionCount(rateLimiter.getRejectionCount())\n        setRemainingInWindow(rateLimiter.getRemainingInWindow())\n        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow())\n\n        const onReject = newOptions.onReject ?? initialOptions.onReject\n        onReject?.(rateLimiter)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...bindInstanceMethods(asyncRateLimiter),\n    errorCount,\n    remainingInWindow,\n    msUntilNextWindow,\n    rejectionCount,\n    setOptions,\n    settleCount,\n    successCount,\n  } as SolidAsyncRateLimiter<TFn>\n}\n"],"names":["asyncRateLimiter","AsyncRateLimiter","createSignal","bindInstanceMethods"],"mappings":";;;;;AAwEgB,SAAA,uBACd,IACA,gBAC4B;AAC5B,QAAMA,qBAAmB,IAAIC,kCAAsB,IAAI,cAAc;AAE/D,QAAA,CAAC,cAAc,eAAe,IAAIC,QAAA;AAAA,IACtCF,mBAAiB,gBAAgB;AAAA,EACnC;AACM,QAAA,CAAC,gBAAgB,iBAAiB,IAAIE,QAAA;AAAA,IAC1CF,mBAAiB,kBAAkB;AAAA,EACrC;AACM,QAAA,CAAC,YAAY,aAAa,IAAIE,QAAA;AAAA,IAClCF,mBAAiB,cAAc;AAAA,EACjC;AACM,QAAA,CAAC,aAAa,cAAc,IAAIE,QAAA;AAAA,IACpCF,mBAAiB,eAAe;AAAA,EAClC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIE,QAAA;AAAA,IAChDF,mBAAiB,qBAAqB;AAAA,EACxC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIE,QAAA;AAAA,IAChDF,mBAAiB,qBAAqB;AAAA,EACxC;AAEA,WAAS,WAAW,YAAmD;AACrEA,uBAAiB,WAAW;AAAA,MAC1B,GAAG;AAAA,MACH,WAAW,CAAC,gBAAgB;AACV,wBAAA,YAAY,iBAAiB;AAC9B,uBAAA,YAAY,gBAAgB;AAC7B,sBAAA,YAAY,eAAe;AACvB,0BAAA,YAAY,mBAAmB;AAC5B,6BAAA,YAAY,sBAAsB;AAClC,6BAAA,YAAY,sBAAsB;AAEjD,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAY;AAAA,MACd;AAAA,MACA,UAAU,CAAC,gBAAgB;AACP,0BAAA,YAAY,mBAAmB;AAC5B,6BAAA,YAAY,sBAAsB;AAClC,6BAAA,YAAY,sBAAsB;AAEjD,cAAA,WAAW,WAAW,YAAY,eAAe;AACvD,6CAAW;AAAA,MAAW;AAAA,IACxB,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAGG,MAAAA,oBAAoBH,kBAAgB;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}
+{"version":3,"file":"createAsyncRateLimiter.cjs","sources":["../../../src/async-rate-limiter/createAsyncRateLimiter.ts"],"sourcesContent":["import { AsyncRateLimiter } from '@tanstack/pacer/async-rate-limiter'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { AsyncRateLimiterOptions } from '@tanstack/pacer/async-rate-limiter'\n\nexport interface SolidAsyncRateLimiter<TFn extends AnyAsyncFunction>\n  extends Omit<\n    AsyncRateLimiter<TFn>,\n    | 'getSuccessCount'\n    | 'getSettleCount'\n    | 'getErrorCount'\n    | 'getRejectionCount'\n    | 'getRemainingInWindow'\n    | 'getMsUntilNextWindow'\n  > {\n  successCount: Accessor<number>\n  settleCount: Accessor<number>\n  errorCount: Accessor<number>\n  rejectionCount: Accessor<number>\n  remainingInWindow: Accessor<number>\n  msUntilNextWindow: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncRateLimiter` instance to limit how many times an async function can execute within a time window.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a rate limiter instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Rate limiting is a simple approach that allows a function to execute up to a limit within a time window,\n * then blocks all subsequent calls until the window passes. This can lead to \"bursty\" behavior where\n * all executions happen immediately, followed by a complete block.\n *\n * The rate limiter supports two types of windows:\n * - 'fixed': A strict window that resets after the window period. All executions within the window count\n *   towards the limit, and the window resets completely after the period.\n * - 'sliding': A rolling window that allows executions as old ones expire. This provides a more\n *   consistent rate of execution over time.\n *\n * Unlike the non-async RateLimiter, this async version supports returning values from the rate-limited function,\n * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call\n * instead of setting the result on a state variable from within the rate-limited function.\n *\n * For smoother execution patterns, consider using:\n * - Throttling: Ensures consistent spacing between executions (e.g. max once per 200ms)\n * - Debouncing: Waits for a pause in calls before executing (e.g. after 500ms of no calls)\n *\n * Rate limiting is best used for hard API limits or resource constraints. For UI updates or\n * smoothing out frequent events, throttling or debouncing usually provide better user experience.\n *\n * Error Handling:\n * - If an `onError` handler is provided, it will be called with the error and rate limiter instance\n * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown\n * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed\n * - Both onError and throwOnError can be used together - the handler will be called before any error is thrown\n * - The error state can be checked using the underlying AsyncRateLimiter instance\n * - Rate limit rejections (when limit is exceeded) are handled separately from execution errors via the `onReject` handler\n *\n * @example\n * ```tsx\n * // Basic API call rate limiting with return value\n * const { maybeExecute } = createAsyncRateLimiter(\n *   async (id: string) => {\n *     const data = await api.fetchData(id);\n *     return data; // Return value is preserved\n *   },\n *   { limit: 5, window: 1000 } // 5 calls per second\n * );\n *\n * // With state management and return value\n * const [data, setData] = createSignal(null);\n * const { maybeExecute } = createAsyncRateLimiter(\n *   async (query) => {\n *     const result = await searchAPI(query);\n *     setData(result);\n *     return result; // Return value can be used by the caller\n *   },\n *   {\n *     limit: 10,\n *     window: 60000, // 10 calls per minute\n *     onReject: (info) => console.log(`Rate limit exceeded: ${info.nextValidTime - Date.now()}ms until next window`)\n *   }\n * );\n * ```\n */\nexport function createAsyncRateLimiter<TFn extends AnyAsyncFunction>(\n  fn: TFn,\n  initialOptions: AsyncRateLimiterOptions<TFn>,\n): SolidAsyncRateLimiter<TFn> {\n  const asyncRateLimiter = new AsyncRateLimiter<TFn>(fn, initialOptions)\n\n  const [successCount, setSuccessCount] = createSignal(\n    asyncRateLimiter.getSuccessCount(),\n  )\n  const [rejectionCount, setRejectionCount] = createSignal(\n    asyncRateLimiter.getRejectionCount(),\n  )\n  const [errorCount, setErrorCount] = createSignal(\n    asyncRateLimiter.getErrorCount(),\n  )\n  const [settleCount, setSettleCount] = createSignal(\n    asyncRateLimiter.getSettleCount(),\n  )\n  const [remainingInWindow, setRemainingInWindow] = createSignal(\n    asyncRateLimiter.getRemainingInWindow(),\n  )\n  const [msUntilNextWindow, setMsUntilNextWindow] = createSignal(\n    asyncRateLimiter.getMsUntilNextWindow(),\n  )\n\n  function setOptions(newOptions: Partial<AsyncRateLimiterOptions<TFn>>) {\n    asyncRateLimiter.setOptions({\n      ...newOptions,\n      onSettled: (rateLimiter) => {\n        setSuccessCount(rateLimiter.getSuccessCount())\n        setSettleCount(rateLimiter.getSettleCount())\n        setErrorCount(rateLimiter.getErrorCount())\n        setRejectionCount(rateLimiter.getRejectionCount())\n        setRemainingInWindow(rateLimiter.getRemainingInWindow())\n        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow())\n\n        const onSettled = newOptions.onSettled ?? initialOptions.onSettled\n        onSettled?.(rateLimiter)\n      },\n      onReject: (rateLimiter) => {\n        setRejectionCount(rateLimiter.getRejectionCount())\n        setRemainingInWindow(rateLimiter.getRemainingInWindow())\n        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow())\n\n        const onReject = newOptions.onReject ?? initialOptions.onReject\n        onReject?.(rateLimiter)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...bindInstanceMethods(asyncRateLimiter),\n    errorCount,\n    remainingInWindow,\n    msUntilNextWindow,\n    rejectionCount,\n    setOptions,\n    settleCount,\n    successCount,\n  } as SolidAsyncRateLimiter<TFn>\n}\n"],"names":["asyncRateLimiter","AsyncRateLimiter","createSignal","bindInstanceMethods"],"mappings":";;;;;AAuFgB,SAAA,uBACd,IACA,gBAC4B;AAC5B,QAAMA,qBAAmB,IAAIC,kCAAsB,IAAI,cAAc;AAE/D,QAAA,CAAC,cAAc,eAAe,IAAIC,QAAA;AAAA,IACtCF,mBAAiB,gBAAgB;AAAA,EACnC;AACM,QAAA,CAAC,gBAAgB,iBAAiB,IAAIE,QAAA;AAAA,IAC1CF,mBAAiB,kBAAkB;AAAA,EACrC;AACM,QAAA,CAAC,YAAY,aAAa,IAAIE,QAAA;AAAA,IAClCF,mBAAiB,cAAc;AAAA,EACjC;AACM,QAAA,CAAC,aAAa,cAAc,IAAIE,QAAA;AAAA,IACpCF,mBAAiB,eAAe;AAAA,EAClC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIE,QAAA;AAAA,IAChDF,mBAAiB,qBAAqB;AAAA,EACxC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIE,QAAA;AAAA,IAChDF,mBAAiB,qBAAqB;AAAA,EACxC;AAEA,WAAS,WAAW,YAAmD;AACrEA,uBAAiB,WAAW;AAAA,MAC1B,GAAG;AAAA,MACH,WAAW,CAAC,gBAAgB;AACV,wBAAA,YAAY,iBAAiB;AAC9B,uBAAA,YAAY,gBAAgB;AAC7B,sBAAA,YAAY,eAAe;AACvB,0BAAA,YAAY,mBAAmB;AAC5B,6BAAA,YAAY,sBAAsB;AAClC,6BAAA,YAAY,sBAAsB;AAEjD,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAY;AAAA,MACd;AAAA,MACA,UAAU,CAAC,gBAAgB;AACP,0BAAA,YAAY,mBAAmB;AAC5B,6BAAA,YAAY,sBAAsB;AAClC,6BAAA,YAAY,sBAAsB;AAEjD,cAAA,WAAW,WAAW,YAAY,eAAe;AACvD,6CAAW;AAAA,MAAW;AAAA,IACxB,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAGG,MAAAA,oBAAoBH,kBAAgB;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}

package/dist/cjs/async-rate-limiter/createAsyncRateLimiter.d.cts

@@ -15,13 +15,9 @@ export interface SolidAsyncRateLimiter<TFn extends AnyAsyncFunction> extends Omi
  * This hook is designed to be flexible and state-management agnostic - it simply returns a rate limiter instance that
  * you can integrate with any state management solution (createSignal, etc).
  *
- * Rate limiting allows an async function to execute up to a specified limit within a time window,
- * then blocks subsequent calls until the window passes. This is useful for respecting API rate limits,
- * managing resource constraints, or controlling bursts of async operations.
- *
- * Unlike the non-async RateLimiter, this async version supports returning values from the rate-limited function,
- * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call
- * instead of setting the result on a state variable from within the rate-limited function.
+ * Rate limiting is a simple approach that allows a function to execute up to a limit within a time window,
+ * then blocks all subsequent calls until the window passes. This can lead to "bursty" behavior where
+ * all executions happen immediately, followed by a complete block.
  *
  * The rate limiter supports two types of windows:
  * - 'fixed': A strict window that resets after the window period. All executions within the window count
@@ -29,6 +25,25 @@ export interface SolidAsyncRateLimiter<TFn extends AnyAsyncFunction> extends Omi
  * - 'sliding': A rolling window that allows executions as old ones expire. This provides a more
  *   consistent rate of execution over time.
  *
+ * Unlike the non-async RateLimiter, this async version supports returning values from the rate-limited function,
+ * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call
+ * instead of setting the result on a state variable from within the rate-limited function.
+ *
+ * For smoother execution patterns, consider using:
+ * - Throttling: Ensures consistent spacing between executions (e.g. max once per 200ms)
+ * - Debouncing: Waits for a pause in calls before executing (e.g. after 500ms of no calls)
+ *
+ * Rate limiting is best used for hard API limits or resource constraints. For UI updates or
+ * smoothing out frequent events, throttling or debouncing usually provide better user experience.
+ *
+ * Error Handling:
+ * - If an `onError` handler is provided, it will be called with the error and rate limiter instance
+ * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown
+ * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed
+ * - Both onError and throwOnError can be used together - the handler will be called before any error is thrown
+ * - The error state can be checked using the underlying AsyncRateLimiter instance
+ * - Rate limit rejections (when limit is exceeded) are handled separately from execution errors via the `onReject` handler
+ *
  * @example
  * ```tsx
  * // Basic API call rate limiting with return value

package/dist/cjs/async-throttler/createAsyncThrottler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createAsyncThrottler.cjs","sources":["../../../src/async-throttler/createAsyncThrottler.ts"],"sourcesContent":["import { AsyncThrottler } from '@tanstack/pacer/async-throttler'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { AsyncThrottlerOptions } from '@tanstack/pacer/async-throttler'\n\nexport interface SolidAsyncThrottler<TFn extends AnyAsyncFunction>\n  extends Omit<\n    AsyncThrottler<TFn>,\n    | 'getSuccessCount'\n    | 'getSettleCount'\n    | 'getErrorCount'\n    | 'getIsPending'\n    | 'getIsExecuting'\n    | 'getLastResult'\n    | 'getLastExecutionTime'\n    | 'getNextExecutionTime'\n  > {\n  successCount: Accessor<number>\n  settleCount: Accessor<number>\n  errorCount: Accessor<number>\n  isPending: Accessor<boolean>\n  isExecuting: Accessor<boolean>\n  lastResult: Accessor<ReturnType<TFn> | undefined>\n  lastExecutionTime: Accessor<number>\n  nextExecutionTime: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncThrottler` instance to limit how often an async function can execute.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a throttler instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Async throttling ensures an async function executes at most once within a specified time window,\n * regardless of how many times it is called. This is useful for rate-limiting expensive API calls,\n * database operations, or other async tasks.\n *\n * @example\n * ```tsx\n * // Basic API call throttling\n * const { maybeExecute } = createAsyncThrottler(\n *   async (id: string) => {\n *     const data = await api.fetchData(id);\n *     return data;\n *   },\n *   { wait: 1000 }\n * );\n *\n * // With state management\n * const [data, setData] = createSignal(null);\n * const { maybeExecute } = createAsyncThrottler(\n *   async (query) => {\n *     const result = await searchAPI(query);\n *     setData(result);\n *   },\n *   {\n *     wait: 2000,\n *     leading: true,   // Execute immediately on first call\n *     trailing: false  // Skip trailing edge updates\n *   }\n * );\n * ```\n */\n\nexport function createAsyncThrottler<TFn extends AnyAsyncFunction>(\n  fn: TFn,\n  initialOptions: AsyncThrottlerOptions<TFn>,\n): SolidAsyncThrottler<TFn> {\n  const asyncThrottler = bindInstanceMethods(\n    new AsyncThrottler<TFn>(fn, initialOptions),\n  )\n\n  const [successCount, setSuccessCount] = createSignal(\n    asyncThrottler.getSuccessCount(),\n  )\n  const [settleCount, setSettleCount] = createSignal(\n    asyncThrottler.getSettleCount(),\n  )\n  const [errorCount, setErrorCount] = createSignal(\n    asyncThrottler.getErrorCount(),\n  )\n  const [isPending, setIsPending] = createSignal(asyncThrottler.getIsPending())\n  const [isExecuting, setIsExecuting] = createSignal(\n    asyncThrottler.getIsExecuting(),\n  )\n  const [lastResult, setLastResult] = createSignal(\n    asyncThrottler.getLastResult(),\n  )\n  const [lastExecutionTime, setLastExecutionTime] = createSignal(\n    asyncThrottler.getLastExecutionTime(),\n  )\n  const [nextExecutionTime, setNextExecutionTime] = createSignal(\n    asyncThrottler.getNextExecutionTime(),\n  )\n\n  function setOptions(newOptions: Partial<AsyncThrottlerOptions<TFn>>) {\n    asyncThrottler.setOptions({\n      ...newOptions,\n      onSettled: (throttler) => {\n        setSuccessCount(throttler.getSuccessCount())\n        setSettleCount(throttler.getSettleCount())\n        setErrorCount(throttler.getErrorCount())\n        setIsPending(throttler.getIsPending())\n        setIsExecuting(throttler.getIsExecuting())\n        setLastExecutionTime(throttler.getLastExecutionTime())\n        setNextExecutionTime(throttler.getNextExecutionTime())\n        setLastResult(throttler.getLastResult())\n\n        const onSettled = newOptions.onSettled ?? initialOptions.onSettled\n        onSettled?.(throttler)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...asyncThrottler,\n    errorCount,\n    isExecuting,\n    isPending,\n    lastExecutionTime,\n    lastResult,\n    nextExecutionTime,\n    setOptions,\n    settleCount,\n    successCount,\n  } as SolidAsyncThrottler<TFn>\n}\n"],"names":["asyncThrottler","bindInstanceMethods","AsyncThrottler","createSignal"],"mappings":";;;;;AAkEgB,SAAA,qBACd,IACA,gBAC0B;AAC1B,QAAMA,mBAAiBC,MAAA;AAAA,IACrB,IAAIC,eAAAA,eAAoB,IAAI,cAAc;AAAA,EAC5C;AAEM,QAAA,CAAC,cAAc,eAAe,IAAIC,QAAA;AAAA,IACtCH,iBAAe,gBAAgB;AAAA,EACjC;AACM,QAAA,CAAC,aAAa,cAAc,IAAIG,QAAA;AAAA,IACpCH,iBAAe,eAAe;AAAA,EAChC;AACM,QAAA,CAAC,YAAY,aAAa,IAAIG,QAAA;AAAA,IAClCH,iBAAe,cAAc;AAAA,EAC/B;AACA,QAAM,CAAC,WAAW,YAAY,IAAIG,QAAAA,aAAaH,iBAAe,cAAc;AACtE,QAAA,CAAC,aAAa,cAAc,IAAIG,QAAA;AAAA,IACpCH,iBAAe,eAAe;AAAA,EAChC;AACM,QAAA,CAAC,YAAY,aAAa,IAAIG,QAAA;AAAA,IAClCH,iBAAe,cAAc;AAAA,EAC/B;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIG,QAAA;AAAA,IAChDH,iBAAe,qBAAqB;AAAA,EACtC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIG,QAAA;AAAA,IAChDH,iBAAe,qBAAqB;AAAA,EACtC;AAEA,WAAS,WAAW,YAAiD;AACnEA,qBAAe,WAAW;AAAA,MACxB,GAAG;AAAA,MACH,WAAW,CAAC,cAAc;AACR,wBAAA,UAAU,iBAAiB;AAC5B,uBAAA,UAAU,gBAAgB;AAC3B,sBAAA,UAAU,eAAe;AAC1B,qBAAA,UAAU,cAAc;AACtB,uBAAA,UAAU,gBAAgB;AACpB,6BAAA,UAAU,sBAAsB;AAChC,6BAAA,UAAU,sBAAsB;AACvC,sBAAA,UAAU,eAAe;AAEjC,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAY;AAAA,MAAS;AAAA,IACvB,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAGA;AAAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}
+{"version":3,"file":"createAsyncThrottler.cjs","sources":["../../../src/async-throttler/createAsyncThrottler.ts"],"sourcesContent":["import { AsyncThrottler } from '@tanstack/pacer/async-throttler'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { AsyncThrottlerOptions } from '@tanstack/pacer/async-throttler'\n\nexport interface SolidAsyncThrottler<TFn extends AnyAsyncFunction>\n  extends Omit<\n    AsyncThrottler<TFn>,\n    | 'getSuccessCount'\n    | 'getSettleCount'\n    | 'getErrorCount'\n    | 'getIsPending'\n    | 'getIsExecuting'\n    | 'getLastResult'\n    | 'getLastExecutionTime'\n    | 'getNextExecutionTime'\n  > {\n  successCount: Accessor<number>\n  settleCount: Accessor<number>\n  errorCount: Accessor<number>\n  isPending: Accessor<boolean>\n  isExecuting: Accessor<boolean>\n  lastResult: Accessor<ReturnType<TFn> | undefined>\n  lastExecutionTime: Accessor<number>\n  nextExecutionTime: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncThrottler` instance to limit how often an async function can execute.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a throttler instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Async throttling ensures an async function executes at most once within a specified time window,\n * regardless of how many times it is called. This is useful for rate-limiting expensive API calls,\n * database operations, or other async tasks.\n *\n * Unlike the non-async Throttler, this async version supports returning values from the throttled function,\n * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call\n * instead of setting the result on a state variable from within the throttled function.\n *\n * Error Handling:\n * - If an `onError` handler is provided, it will be called with the error and throttler instance\n * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown\n * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed\n * - Both onError and throwOnError can be used together - the handler will be called before any error is thrown\n * - The error state can be checked using the underlying AsyncThrottler instance\n *\n * @example\n * ```tsx\n * // Basic API call throttling\n * const { maybeExecute } = createAsyncThrottler(\n *   async (id: string) => {\n *     const data = await api.fetchData(id);\n *     return data;\n *   },\n *   { wait: 1000 }\n * );\n *\n * // With state management\n * const [data, setData] = createSignal(null);\n * const { maybeExecute } = createAsyncThrottler(\n *   async (query) => {\n *     const result = await searchAPI(query);\n *     setData(result);\n *   },\n *   {\n *     wait: 2000,\n *     leading: true,   // Execute immediately on first call\n *     trailing: false, // Skip trailing edge updates\n *     onError: (error) => {\n *       console.error('API call failed:', error);\n *     }\n *   }\n * );\n * ```\n */\nexport function createAsyncThrottler<TFn extends AnyAsyncFunction>(\n  fn: TFn,\n  initialOptions: AsyncThrottlerOptions<TFn>,\n): SolidAsyncThrottler<TFn> {\n  const asyncThrottler = bindInstanceMethods(\n    new AsyncThrottler<TFn>(fn, initialOptions),\n  )\n\n  const [successCount, setSuccessCount] = createSignal(\n    asyncThrottler.getSuccessCount(),\n  )\n  const [settleCount, setSettleCount] = createSignal(\n    asyncThrottler.getSettleCount(),\n  )\n  const [errorCount, setErrorCount] = createSignal(\n    asyncThrottler.getErrorCount(),\n  )\n  const [isPending, setIsPending] = createSignal(asyncThrottler.getIsPending())\n  const [isExecuting, setIsExecuting] = createSignal(\n    asyncThrottler.getIsExecuting(),\n  )\n  const [lastResult, setLastResult] = createSignal(\n    asyncThrottler.getLastResult(),\n  )\n  const [lastExecutionTime, setLastExecutionTime] = createSignal(\n    asyncThrottler.getLastExecutionTime(),\n  )\n  const [nextExecutionTime, setNextExecutionTime] = createSignal(\n    asyncThrottler.getNextExecutionTime(),\n  )\n\n  function setOptions(newOptions: Partial<AsyncThrottlerOptions<TFn>>) {\n    asyncThrottler.setOptions({\n      ...newOptions,\n      onSettled: (throttler) => {\n        setSuccessCount(throttler.getSuccessCount())\n        setSettleCount(throttler.getSettleCount())\n        setErrorCount(throttler.getErrorCount())\n        setIsPending(throttler.getIsPending())\n        setIsExecuting(throttler.getIsExecuting())\n        setLastExecutionTime(throttler.getLastExecutionTime())\n        setNextExecutionTime(throttler.getNextExecutionTime())\n        setLastResult(throttler.getLastResult())\n\n        const onSettled = newOptions.onSettled ?? initialOptions.onSettled\n        onSettled?.(throttler)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...asyncThrottler,\n    errorCount,\n    isExecuting,\n    isPending,\n    lastExecutionTime,\n    lastResult,\n    nextExecutionTime,\n    setOptions,\n    settleCount,\n    successCount,\n  } as SolidAsyncThrottler<TFn>\n}\n"],"names":["asyncThrottler","bindInstanceMethods","AsyncThrottler","createSignal"],"mappings":";;;;;AA+EgB,SAAA,qBACd,IACA,gBAC0B;AAC1B,QAAMA,mBAAiBC,MAAA;AAAA,IACrB,IAAIC,eAAAA,eAAoB,IAAI,cAAc;AAAA,EAC5C;AAEM,QAAA,CAAC,cAAc,eAAe,IAAIC,QAAA;AAAA,IACtCH,iBAAe,gBAAgB;AAAA,EACjC;AACM,QAAA,CAAC,aAAa,cAAc,IAAIG,QAAA;AAAA,IACpCH,iBAAe,eAAe;AAAA,EAChC;AACM,QAAA,CAAC,YAAY,aAAa,IAAIG,QAAA;AAAA,IAClCH,iBAAe,cAAc;AAAA,EAC/B;AACA,QAAM,CAAC,WAAW,YAAY,IAAIG,QAAAA,aAAaH,iBAAe,cAAc;AACtE,QAAA,CAAC,aAAa,cAAc,IAAIG,QAAA;AAAA,IACpCH,iBAAe,eAAe;AAAA,EAChC;AACM,QAAA,CAAC,YAAY,aAAa,IAAIG,QAAA;AAAA,IAClCH,iBAAe,cAAc;AAAA,EAC/B;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIG,QAAA;AAAA,IAChDH,iBAAe,qBAAqB;AAAA,EACtC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAIG,QAAA;AAAA,IAChDH,iBAAe,qBAAqB;AAAA,EACtC;AAEA,WAAS,WAAW,YAAiD;AACnEA,qBAAe,WAAW;AAAA,MACxB,GAAG;AAAA,MACH,WAAW,CAAC,cAAc;AACR,wBAAA,UAAU,iBAAiB;AAC5B,uBAAA,UAAU,gBAAgB;AAC3B,sBAAA,UAAU,eAAe;AAC1B,qBAAA,UAAU,cAAc;AACtB,uBAAA,UAAU,gBAAgB;AACpB,6BAAA,UAAU,sBAAsB;AAChC,6BAAA,UAAU,sBAAsB;AACvC,sBAAA,UAAU,eAAe;AAEjC,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAY;AAAA,MAAS;AAAA,IACvB,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAGA;AAAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}

package/dist/cjs/async-throttler/createAsyncThrottler.d.cts

@@ -21,6 +21,17 @@ export interface SolidAsyncThrottler<TFn extends AnyAsyncFunction> extends Omit<
  * regardless of how many times it is called. This is useful for rate-limiting expensive API calls,
  * database operations, or other async tasks.
  *
+ * Unlike the non-async Throttler, this async version supports returning values from the throttled function,
+ * making it ideal for API calls and other async operations where you want the result of the `maybeExecute` call
+ * instead of setting the result on a state variable from within the throttled function.
+ *
+ * Error Handling:
+ * - If an `onError` handler is provided, it will be called with the error and throttler instance
+ * - If `throwOnError` is true (default when no onError handler is provided), the error will be thrown
+ * - If `throwOnError` is false (default when onError handler is provided), the error will be swallowed
+ * - Both onError and throwOnError can be used together - the handler will be called before any error is thrown
+ * - The error state can be checked using the underlying AsyncThrottler instance
+ *
  * @example
  * ```tsx
  * // Basic API call throttling
@@ -42,7 +53,10 @@ export interface SolidAsyncThrottler<TFn extends AnyAsyncFunction> extends Omit<
  *   {
  *     wait: 2000,
  *     leading: true,   // Execute immediately on first call
- *     trailing: false  // Skip trailing edge updates
+ *     trailing: false, // Skip trailing edge updates
+ *     onError: (error) => {
+ *       console.error('API call failed:', error);
+ *     }
  *   }
  * );
  * ```

package/dist/cjs/batcher/createBatcher.cjs

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const batcher = require("@tanstack/pacer/batcher");
+const solidJs = require("solid-js");
+const utils = require("@tanstack/pacer/utils");
+function createBatcher(fn, initialOptions = {}) {
+  const batcher$1 = utils.bindInstanceMethods(new batcher.Batcher(fn, initialOptions));
+  const [allItems, setAllItems] = solidJs.createSignal(
+    batcher$1.getAllItems()
+  );
+  const [batchExecutionCount, setBatchExecutionCount] = solidJs.createSignal(
+    batcher$1.getBatchExecutionCount()
+  );
+  const [itemExecutionCount, setItemExecutionCount] = solidJs.createSignal(
+    batcher$1.getItemExecutionCount()
+  );
+  const [isEmpty, setIsEmpty] = solidJs.createSignal(batcher$1.getIsEmpty());
+  const [isRunning, setIsRunning] = solidJs.createSignal(batcher$1.getIsRunning());
+  const [size, setSize] = solidJs.createSignal(batcher$1.getSize());
+  function setOptions(newOptions) {
+    batcher$1.setOptions({
+      ...newOptions,
+      onItemsChange: (batcher2) => {
+        setAllItems(batcher2.getAllItems());
+        setBatchExecutionCount(batcher2.getBatchExecutionCount());
+        setItemExecutionCount(batcher2.getItemExecutionCount());
+        setIsEmpty(batcher2.getIsEmpty());
+        setSize(batcher2.getSize());
+        const onItemsChange = newOptions.onItemsChange ?? initialOptions.onItemsChange;
+        onItemsChange == null ? void 0 : onItemsChange(batcher2);
+      },
+      onExecute: (batcher2) => {
+        setBatchExecutionCount(batcher2.getBatchExecutionCount());
+        setItemExecutionCount(batcher2.getItemExecutionCount());
+        const onExecute = newOptions.onExecute ?? initialOptions.onExecute;
+        onExecute == null ? void 0 : onExecute(batcher2);
+      },
+      onIsRunningChange: (batcher2) => {
+        setIsRunning(batcher2.getIsRunning());
+        const onIsRunningChange = newOptions.onIsRunningChange ?? initialOptions.onIsRunningChange;
+        onIsRunningChange == null ? void 0 : onIsRunningChange(batcher2);
+      }
+    });
+  }
+  setOptions(initialOptions);
+  return {
+    ...batcher$1,
+    allItems,
+    batchExecutionCount,
+    isEmpty,
+    isRunning,
+    itemExecutionCount,
+    size,
+    setOptions
+  };
+}
+exports.createBatcher = createBatcher;
+//# sourceMappingURL=createBatcher.cjs.map

package/dist/cjs/batcher/createBatcher.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBatcher.cjs","sources":["../../../src/batcher/createBatcher.ts"],"sourcesContent":["import { Batcher } from '@tanstack/pacer/batcher'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { BatcherOptions } from '@tanstack/pacer/batcher'\n\nexport interface SolidBatcher<TValue>\n  extends Omit<\n    Batcher<TValue>,\n    | 'getAllItems'\n    | 'getBatchExecutionCount'\n    | 'getIsEmpty'\n    | 'getIsRunning'\n    | 'getItemExecutionCount'\n    | 'getSize'\n  > {\n  /**\n   * Signal version of `getAllItems`\n   */\n  allItems: Accessor<Array<TValue>>\n  /**\n   * Signal version of `getBatchExecutionCount`\n   */\n  batchExecutionCount: Accessor<number>\n  /**\n   * Signal version of `getIsEmpty`\n   */\n  isEmpty: Accessor<boolean>\n  /**\n   * Signal version of `getIsRunning`\n   */\n  isRunning: Accessor<boolean>\n  /**\n   * Signal version of `getItemExecutionCount`\n   */\n  itemExecutionCount: Accessor<number>\n  /**\n   * Signal version of `getSize`\n   */\n  size: Accessor<number>\n}\n\n/**\n * Creates a Solid-compatible Batcher instance for managing batches of items, exposing Solid signals for all stateful properties.\n *\n * Features:\n * - Batch processing of items using the provided `fn` function\n * - Configurable batch size and wait time\n * - Custom batch processing logic via getShouldExecute\n * - Event callbacks for monitoring batch operations\n * - All stateful properties (items, counts, etc.) are exposed as Solid signals for reactivity\n *\n * The batcher collects items and processes them in batches based on:\n * - Maximum batch size\n * - Time-based batching (process after X milliseconds)\n * - Custom batch processing logic via getShouldExecute\n *\n * Example usage:\n * ```tsx\n * const batcher = createBatcher(\n *   (items) => {\n *     // Process batch of items\n *     console.log('Processing batch:', items);\n *   },\n *   {\n *     maxSize: 5,\n *     wait: 2000,\n *     onExecute: (batcher) => console.log('Batch executed'),\n *     getShouldExecute: (items) => items.length >= 3\n *   }\n * );\n *\n * // Add items to batch\n * batcher.addItem('task1');\n * batcher.addItem('task2');\n *\n * // Control the batcher\n * batcher.stop();  // Pause processing\n * batcher.start(); // Resume processing\n *\n * // Access batcher state via signals\n * console.log('Items:', batcher.allItems());\n * console.log('Size:', batcher.size());\n * console.log('Is empty:', batcher.isEmpty());\n * console.log('Is running:', batcher.isRunning());\n * console.log('Batch count:', batcher.batchExecutionCount());\n * console.log('Item count:', batcher.itemExecutionCount());\n * ```\n */\nexport function createBatcher<TValue>(\n  fn: (items: Array<TValue>) => void,\n  initialOptions: BatcherOptions<TValue> = {},\n): SolidBatcher<TValue> {\n  const batcher = bindInstanceMethods(new Batcher<TValue>(fn, initialOptions))\n\n  const [allItems, setAllItems] = createSignal<Array<TValue>>(\n    batcher.getAllItems(),\n  )\n  const [batchExecutionCount, setBatchExecutionCount] = createSignal(\n    batcher.getBatchExecutionCount(),\n  )\n  const [itemExecutionCount, setItemExecutionCount] = createSignal(\n    batcher.getItemExecutionCount(),\n  )\n  const [isEmpty, setIsEmpty] = createSignal(batcher.getIsEmpty())\n  const [isRunning, setIsRunning] = createSignal(batcher.getIsRunning())\n  const [size, setSize] = createSignal(batcher.getSize())\n\n  function setOptions(newOptions: Partial<BatcherOptions<TValue>>) {\n    batcher.setOptions({\n      ...newOptions,\n      onItemsChange: (batcher) => {\n        setAllItems(batcher.getAllItems())\n        setBatchExecutionCount(batcher.getBatchExecutionCount())\n        setItemExecutionCount(batcher.getItemExecutionCount())\n        setIsEmpty(batcher.getIsEmpty())\n        setSize(batcher.getSize())\n\n        const onItemsChange =\n          newOptions.onItemsChange ?? initialOptions.onItemsChange\n        onItemsChange?.(batcher)\n      },\n      onExecute: (batcher) => {\n        setBatchExecutionCount(batcher.getBatchExecutionCount())\n        setItemExecutionCount(batcher.getItemExecutionCount())\n\n        const onExecute = newOptions.onExecute ?? initialOptions.onExecute\n        onExecute?.(batcher)\n      },\n      onIsRunningChange: (batcher) => {\n        setIsRunning(batcher.getIsRunning())\n\n        const onIsRunningChange =\n          newOptions.onIsRunningChange ?? initialOptions.onIsRunningChange\n        onIsRunningChange?.(batcher)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...batcher,\n    allItems,\n    batchExecutionCount,\n    isEmpty,\n    isRunning,\n    itemExecutionCount,\n    size,\n    setOptions,\n  } as SolidBatcher<TValue>\n}\n"],"names":["batcher","bindInstanceMethods","Batcher","createSignal"],"mappings":";;;;;AAyFO,SAAS,cACd,IACA,iBAAyC,IACnB;AACtB,QAAMA,YAAUC,MAAAA,oBAAoB,IAAIC,QAAgB,QAAA,IAAI,cAAc,CAAC;AAErE,QAAA,CAAC,UAAU,WAAW,IAAIC,QAAA;AAAA,IAC9BH,UAAQ,YAAY;AAAA,EACtB;AACM,QAAA,CAAC,qBAAqB,sBAAsB,IAAIG,QAAA;AAAA,IACpDH,UAAQ,uBAAuB;AAAA,EACjC;AACM,QAAA,CAAC,oBAAoB,qBAAqB,IAAIG,QAAA;AAAA,IAClDH,UAAQ,sBAAsB;AAAA,EAChC;AACA,QAAM,CAAC,SAAS,UAAU,IAAIG,QAAAA,aAAaH,UAAQ,YAAY;AAC/D,QAAM,CAAC,WAAW,YAAY,IAAIG,QAAAA,aAAaH,UAAQ,cAAc;AACrE,QAAM,CAAC,MAAM,OAAO,IAAIG,QAAAA,aAAaH,UAAQ,SAAS;AAEtD,WAAS,WAAW,YAA6C;AAC/DA,cAAQ,WAAW;AAAA,MACjB,GAAG;AAAA,MACH,eAAe,CAACA,aAAY;AACdA,oBAAAA,SAAQ,aAAa;AACVA,+BAAAA,SAAQ,wBAAwB;AACjCA,8BAAAA,SAAQ,uBAAuB;AAC1CA,mBAAAA,SAAQ,YAAY;AACvBA,gBAAAA,SAAQ,SAAS;AAEnB,cAAA,gBACJ,WAAW,iBAAiB,eAAe;AAC7C,uDAAgBA;AAAAA,MAClB;AAAA,MACA,WAAW,CAACA,aAAY;AACCA,+BAAAA,SAAQ,wBAAwB;AACjCA,8BAAAA,SAAQ,uBAAuB;AAE/C,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAYA;AAAAA,MACd;AAAA,MACA,mBAAmB,CAACA,aAAY;AACjBA,qBAAAA,SAAQ,cAAc;AAE7B,cAAA,oBACJ,WAAW,qBAAqB,eAAe;AACjD,+DAAoBA;AAAAA,MAAO;AAAA,IAC7B,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAGA;AAAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}

package/dist/cjs/batcher/createBatcher.d.cts

@@ -0,0 +1,76 @@
+import { Batcher, BatcherOptions } from '@tanstack/pacer/batcher';
+import { Accessor } from 'solid-js';
+export interface SolidBatcher<TValue> extends Omit<Batcher<TValue>, 'getAllItems' | 'getBatchExecutionCount' | 'getIsEmpty' | 'getIsRunning' | 'getItemExecutionCount' | 'getSize'> {
+    /**
+     * Signal version of `getAllItems`
+     */
+    allItems: Accessor<Array<TValue>>;
+    /**
+     * Signal version of `getBatchExecutionCount`
+     */
+    batchExecutionCount: Accessor<number>;
+    /**
+     * Signal version of `getIsEmpty`
+     */
+    isEmpty: Accessor<boolean>;
+    /**
+     * Signal version of `getIsRunning`
+     */
+    isRunning: Accessor<boolean>;
+    /**
+     * Signal version of `getItemExecutionCount`
+     */
+    itemExecutionCount: Accessor<number>;
+    /**
+     * Signal version of `getSize`
+     */
+    size: Accessor<number>;
+}
+/**
+ * Creates a Solid-compatible Batcher instance for managing batches of items, exposing Solid signals for all stateful properties.
+ *
+ * Features:
+ * - Batch processing of items using the provided `fn` function
+ * - Configurable batch size and wait time
+ * - Custom batch processing logic via getShouldExecute
+ * - Event callbacks for monitoring batch operations
+ * - All stateful properties (items, counts, etc.) are exposed as Solid signals for reactivity
+ *
+ * The batcher collects items and processes them in batches based on:
+ * - Maximum batch size
+ * - Time-based batching (process after X milliseconds)
+ * - Custom batch processing logic via getShouldExecute
+ *
+ * Example usage:
+ * ```tsx
+ * const batcher = createBatcher(
+ *   (items) => {
+ *     // Process batch of items
+ *     console.log('Processing batch:', items);
+ *   },
+ *   {
+ *     maxSize: 5,
+ *     wait: 2000,
+ *     onExecute: (batcher) => console.log('Batch executed'),
+ *     getShouldExecute: (items) => items.length >= 3
+ *   }
+ * );
+ *
+ * // Add items to batch
+ * batcher.addItem('task1');
+ * batcher.addItem('task2');
+ *
+ * // Control the batcher
+ * batcher.stop();  // Pause processing
+ * batcher.start(); // Resume processing
+ *
+ * // Access batcher state via signals
+ * console.log('Items:', batcher.allItems());
+ * console.log('Size:', batcher.size());
+ * console.log('Is empty:', batcher.isEmpty());
+ * console.log('Is running:', batcher.isRunning());
+ * console.log('Batch count:', batcher.batchExecutionCount());
+ * console.log('Item count:', batcher.itemExecutionCount());
+ * ```
+ */
+export declare function createBatcher<TValue>(fn: (items: Array<TValue>) => void, initialOptions?: BatcherOptions<TValue>): SolidBatcher<TValue>;