@tanstack/angular-pacer 0.20.0

package/README.md

@@ -0,0 +1,165 @@
+<div align="center">
+  <img src="./media/header_pacer.png" >
+</div>
+
+<br />
+
+<div align="center">
+	<a href="https://www.npmjs.com/package/@tanstack/pacer" target="\_parent">
+	  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/pacer.svg" alt="npm downloads" />
+	</a>
+- <a href="https://github.com/TanStack/pacer" target="\_parent">
+	  <img alt="" src="https://img.shields.io/github/stars/TanStack/pacer.svg?style=social&label=Star" alt="GitHub stars" />
+	</a>
+	<a href="https://bundlephobia.com/result?p=@tanstack/react-pacer@latest" target="\_parent">
+  <img alt="" src="https://badgen.net/bundlephobia/minzip/@tanstack/react-pacer@latest" alt="Bundle size" />
+</a>
+</div>
+
+<div align="center">
+<a href="#badge">
+  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
+</a>
+	<a href="#badge">
+		<img src="https://img.shields.io/github/v/release/tanstack/pacer" alt="Release"/>
+	</a>
+	<a href="https://twitter.com/tan_stack">
+		<img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
+	</a>
+</div>
+
+<div align="center">
+  
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+</div>
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+  - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+  - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+  - Control of leading, trailing, and enabled options
+- **Throttling**
+  - Smoothly limit the rate at which a function can fire
+  - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+  - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+  - Limit the rate at which a function can fire over a period of time
+  - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+  - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+  - Queue functions to be executed in a specific order
+  - Choose from FIFO, LIFO, and Priority queue implementations
+  - Control processing speed with configurable wait times or concurrency limits
+  - Manage queue execution with start/stop capabilities
+  - Expire items from the queue after a configurable duration
+- **Batching**
+  - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+  - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+  - Choose between synchronous and asynchronous versions of each utility
+  - Optional error, success, and settled handling for async variations
+  - Retry and Abort support for async variations
+- **State Management**
+  - Uses TanStack Store under the hood for state management with fine-grained reactivity
+  - Easily integrate with your own state management library of choice
+  - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+  - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+  - Multiple layers of abstraction to choose from depending on your use case.
+  - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+  - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+  - Generics for flexible and reusable utilities
+- **Framework Adapters**
+  - React, Solid, and more
+- **Tree Shaking**
+  - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### <a href="https://tanstack.com/pacer">Read the docs →</b></a>
+
+<br />
+
+> [!NOTE]
+> You may know **TanStack Pacer** by our adapter names, too!
+>
+> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer)
+> - [**Preact Pacer**](https://tanstack.com/pacer/latest/docs/framework/preact/preact-pacer)
+> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer)
+> - [**Angular Pacer**](https://tanstack.com/pacer/latest/docs/framework/angular/angular-pacer)
+> - Svelte Pacer - needs a contributor!
+> - Vue Pacer - needs a contributor!
+
+## Get Involved
+
+- We welcome issues and pull requests!
+- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions)
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
+- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+
+## Partners
+
+<table align="center">
+  <tr>
+    <td>
+      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-CMcuvjEy.svg" height="40" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" />
+          <img src="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" alt="CodeRabbit" />
+        </picture>
+      </a>
+    </td>
+    <td>
+      <a href="https://www.cloudflare.com?utm_source=tanstack">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-DQDB7UaL.svg" height="60" />
+          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" />
+          <img src="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" alt="Cloudflare" />
+        </picture>
+      </a>
+    </td>
+    <td>
+      <a href="https://www.unkey.com/?utm_source=tanstack">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="./media/unkey_dark.svg" height="60" />
+          <source media="(prefers-color-scheme: light)" srcset="./media/unkey_logo.svg" height="60" />
+          <img src="./media/unkey_logo.svg" height="60" alt="Unkey"/>
+        </picture>
+      </a>
+    </td>
+  </tr>
+</table>
+
+<div align="center">
+<img src="./media/partner_logo.svg" alt="Pacer & you?" height="65">
+<p>
+We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together.
+</p>
+<a href="mailto:partners@tanstack.com?subject=TanStack Pacer Partnership"><b>LET'S CHAT</b></a>
+</div>
+
+</div>
+
+## Explore the TanStack Ecosystem
+
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack DevTools</b></a> – Unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
+- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
+- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
+
+… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
+
+<!-- USE THE FORCE LUKE -->

package/dist/async-batcher/index.cjs

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_injectAsyncBatcher = require('./injectAsyncBatcher.cjs');
+const require_injectAsyncBatchedCallback = require('./injectAsyncBatchedCallback.cjs');
+
+exports.injectAsyncBatchedCallback = require_injectAsyncBatchedCallback.injectAsyncBatchedCallback;
+exports.injectAsyncBatcher = require_injectAsyncBatcher.injectAsyncBatcher;
+var _tanstack_pacer_async_batcher = require("@tanstack/pacer/async-batcher");
+Object.keys(_tanstack_pacer_async_batcher).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _tanstack_pacer_async_batcher[k]; }
+  });
+});

package/dist/async-batcher/index.d.cts

@@ -0,0 +1,4 @@
+import { injectAsyncBatchedCallback } from "./injectAsyncBatchedCallback.cjs";
+import { AngularAsyncBatcher, injectAsyncBatcher } from "./injectAsyncBatcher.cjs";
+export * from "@tanstack/pacer/async-batcher";
+export { AngularAsyncBatcher, injectAsyncBatchedCallback, injectAsyncBatcher };

package/dist/async-batcher/index.d.ts

@@ -0,0 +1,4 @@
+import { injectAsyncBatchedCallback } from "./injectAsyncBatchedCallback.js";
+import { AngularAsyncBatcher, injectAsyncBatcher } from "./injectAsyncBatcher.js";
+export * from "@tanstack/pacer/async-batcher";
+export { AngularAsyncBatcher, injectAsyncBatchedCallback, injectAsyncBatcher };

package/dist/async-batcher/index.js

@@ -0,0 +1,6 @@
+import { injectAsyncBatcher } from "./injectAsyncBatcher.js";
+import { injectAsyncBatchedCallback } from "./injectAsyncBatchedCallback.js";
+
+export * from "@tanstack/pacer/async-batcher"
+
+export { injectAsyncBatchedCallback, injectAsyncBatcher };

package/dist/async-batcher/injectAsyncBatchedCallback.cjs

@@ -0,0 +1,49 @@
+const require_injectAsyncBatcher = require('./injectAsyncBatcher.cjs');
+
+//#region src/async-batcher/injectAsyncBatchedCallback.ts
+/**
+* An Angular function that creates an async batched version of a callback function.
+* This function is essentially a wrapper around `injectAsyncBatcher` that provides
+* a simplified API for basic async batching needs.
+*
+* The batched function will collect items and process them in batches asynchronously based on
+* the configured conditions (maxSize, wait time, etc.).
+*
+* This function provides a simpler API compared to `injectAsyncBatcher`, making it ideal for basic
+* async batching needs. However, it does not expose the underlying AsyncBatcher instance.
+*
+* For advanced usage requiring features like:
+* - Manual flushing
+* - Access to batch state
+* - Error handling callbacks
+* - Retry support
+*
+* Consider using the `injectAsyncBatcher` function instead.
+*
+* @example
+* ```ts
+* // Batch async API calls
+* const batchApiCall = injectAsyncBatchedCallback(
+*   async (items: Array<Data>) => {
+*     const response = await fetch('/api/batch', {
+*       method: 'POST',
+*       body: JSON.stringify(items)
+*     });
+*     return response.json();
+*   },
+*   { maxSize: 10, wait: 1000 }
+* );
+*
+* // Items will be batched and sent together
+* await batchApiCall(data1);
+* await batchApiCall(data2);
+* ```
+*/
+function injectAsyncBatchedCallback(fn, options) {
+	const batcher = require_injectAsyncBatcher.injectAsyncBatcher(fn, options);
+	return (item) => batcher.addItem(item);
+}
+
+//#endregion
+exports.injectAsyncBatchedCallback = injectAsyncBatchedCallback;
+//# sourceMappingURL=injectAsyncBatchedCallback.cjs.map

package/dist/async-batcher/injectAsyncBatchedCallback.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectAsyncBatchedCallback.cjs","names":["injectAsyncBatcher"],"sources":["../../src/async-batcher/injectAsyncBatchedCallback.ts"],"sourcesContent":["import { injectAsyncBatcher } from './injectAsyncBatcher'\nimport type { AsyncBatcherOptions } from '@tanstack/pacer/async-batcher'\n\n/**\n * An Angular function that creates an async batched version of a callback function.\n * This function is essentially a wrapper around `injectAsyncBatcher` that provides\n * a simplified API for basic async batching needs.\n *\n * The batched function will collect items and process them in batches asynchronously based on\n * the configured conditions (maxSize, wait time, etc.).\n *\n * This function provides a simpler API compared to `injectAsyncBatcher`, making it ideal for basic\n * async batching needs. However, it does not expose the underlying AsyncBatcher instance.\n *\n * For advanced usage requiring features like:\n * - Manual flushing\n * - Access to batch state\n * - Error handling callbacks\n * - Retry support\n *\n * Consider using the `injectAsyncBatcher` function instead.\n *\n * @example\n * ```ts\n * // Batch async API calls\n * const batchApiCall = injectAsyncBatchedCallback(\n *   async (items: Array<Data>) => {\n *     const response = await fetch('/api/batch', {\n *       method: 'POST',\n *       body: JSON.stringify(items)\n *     });\n *     return response.json();\n *   },\n *   { maxSize: 10, wait: 1000 }\n * );\n *\n * // Items will be batched and sent together\n * await batchApiCall(data1);\n * await batchApiCall(data2);\n * ```\n */\nexport function injectAsyncBatchedCallback<TValue>(\n  fn: (items: Array<TValue>) => Promise<any>,\n  options: AsyncBatcherOptions<TValue>,\n): (item: TValue) => Promise<void> {\n  const batcher = injectAsyncBatcher(fn, options)\n  return (item: TValue) => batcher.addItem(item)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,2BACd,IACA,SACiC;CACjC,MAAM,UAAUA,8CAAmB,IAAI,QAAQ;AAC/C,SAAQ,SAAiB,QAAQ,QAAQ,KAAK"}

package/dist/async-batcher/injectAsyncBatchedCallback.d.cts

@@ -0,0 +1,45 @@
+import { AsyncBatcherOptions } from "@tanstack/pacer/async-batcher";
+
+//#region src/async-batcher/injectAsyncBatchedCallback.d.ts
+/**
+ * An Angular function that creates an async batched version of a callback function.
+ * This function is essentially a wrapper around `injectAsyncBatcher` that provides
+ * a simplified API for basic async batching needs.
+ *
+ * The batched function will collect items and process them in batches asynchronously based on
+ * the configured conditions (maxSize, wait time, etc.).
+ *
+ * This function provides a simpler API compared to `injectAsyncBatcher`, making it ideal for basic
+ * async batching needs. However, it does not expose the underlying AsyncBatcher instance.
+ *
+ * For advanced usage requiring features like:
+ * - Manual flushing
+ * - Access to batch state
+ * - Error handling callbacks
+ * - Retry support
+ *
+ * Consider using the `injectAsyncBatcher` function instead.
+ *
+ * @example
+ * ```ts
+ * // Batch async API calls
+ * const batchApiCall = injectAsyncBatchedCallback(
+ *   async (items: Array<Data>) => {
+ *     const response = await fetch('/api/batch', {
+ *       method: 'POST',
+ *       body: JSON.stringify(items)
+ *     });
+ *     return response.json();
+ *   },
+ *   { maxSize: 10, wait: 1000 }
+ * );
+ *
+ * // Items will be batched and sent together
+ * await batchApiCall(data1);
+ * await batchApiCall(data2);
+ * ```
+ */
+declare function injectAsyncBatchedCallback<TValue>(fn: (items: Array<TValue>) => Promise<any>, options: AsyncBatcherOptions<TValue>): (item: TValue) => Promise<void>;
+//#endregion
+export { injectAsyncBatchedCallback };
+//# sourceMappingURL=injectAsyncBatchedCallback.d.cts.map

package/dist/async-batcher/injectAsyncBatchedCallback.d.ts

@@ -0,0 +1,45 @@
+import { AsyncBatcherOptions } from "@tanstack/pacer/async-batcher";
+
+//#region src/async-batcher/injectAsyncBatchedCallback.d.ts
+/**
+ * An Angular function that creates an async batched version of a callback function.
+ * This function is essentially a wrapper around `injectAsyncBatcher` that provides
+ * a simplified API for basic async batching needs.
+ *
+ * The batched function will collect items and process them in batches asynchronously based on
+ * the configured conditions (maxSize, wait time, etc.).
+ *
+ * This function provides a simpler API compared to `injectAsyncBatcher`, making it ideal for basic
+ * async batching needs. However, it does not expose the underlying AsyncBatcher instance.
+ *
+ * For advanced usage requiring features like:
+ * - Manual flushing
+ * - Access to batch state
+ * - Error handling callbacks
+ * - Retry support
+ *
+ * Consider using the `injectAsyncBatcher` function instead.
+ *
+ * @example
+ * ```ts
+ * // Batch async API calls
+ * const batchApiCall = injectAsyncBatchedCallback(
+ *   async (items: Array<Data>) => {
+ *     const response = await fetch('/api/batch', {
+ *       method: 'POST',
+ *       body: JSON.stringify(items)
+ *     });
+ *     return response.json();
+ *   },
+ *   { maxSize: 10, wait: 1000 }
+ * );
+ *
+ * // Items will be batched and sent together
+ * await batchApiCall(data1);
+ * await batchApiCall(data2);
+ * ```
+ */
+declare function injectAsyncBatchedCallback<TValue>(fn: (items: Array<TValue>) => Promise<any>, options: AsyncBatcherOptions<TValue>): (item: TValue) => Promise<void>;
+//#endregion
+export { injectAsyncBatchedCallback };
+//# sourceMappingURL=injectAsyncBatchedCallback.d.ts.map

package/dist/async-batcher/injectAsyncBatchedCallback.js

@@ -0,0 +1,49 @@
+import { injectAsyncBatcher } from "./injectAsyncBatcher.js";
+
+//#region src/async-batcher/injectAsyncBatchedCallback.ts
+/**
+* An Angular function that creates an async batched version of a callback function.
+* This function is essentially a wrapper around `injectAsyncBatcher` that provides
+* a simplified API for basic async batching needs.
+*
+* The batched function will collect items and process them in batches asynchronously based on
+* the configured conditions (maxSize, wait time, etc.).
+*
+* This function provides a simpler API compared to `injectAsyncBatcher`, making it ideal for basic
+* async batching needs. However, it does not expose the underlying AsyncBatcher instance.
+*
+* For advanced usage requiring features like:
+* - Manual flushing
+* - Access to batch state
+* - Error handling callbacks
+* - Retry support
+*
+* Consider using the `injectAsyncBatcher` function instead.
+*
+* @example
+* ```ts
+* // Batch async API calls
+* const batchApiCall = injectAsyncBatchedCallback(
+*   async (items: Array<Data>) => {
+*     const response = await fetch('/api/batch', {
+*       method: 'POST',
+*       body: JSON.stringify(items)
+*     });
+*     return response.json();
+*   },
+*   { maxSize: 10, wait: 1000 }
+* );
+*
+* // Items will be batched and sent together
+* await batchApiCall(data1);
+* await batchApiCall(data2);
+* ```
+*/
+function injectAsyncBatchedCallback(fn, options) {
+	const batcher = injectAsyncBatcher(fn, options);
+	return (item) => batcher.addItem(item);
+}
+
+//#endregion
+export { injectAsyncBatchedCallback };
+//# sourceMappingURL=injectAsyncBatchedCallback.js.map

package/dist/async-batcher/injectAsyncBatchedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectAsyncBatchedCallback.js","names":[],"sources":["../../src/async-batcher/injectAsyncBatchedCallback.ts"],"sourcesContent":["import { injectAsyncBatcher } from './injectAsyncBatcher'\nimport type { AsyncBatcherOptions } from '@tanstack/pacer/async-batcher'\n\n/**\n * An Angular function that creates an async batched version of a callback function.\n * This function is essentially a wrapper around `injectAsyncBatcher` that provides\n * a simplified API for basic async batching needs.\n *\n * The batched function will collect items and process them in batches asynchronously based on\n * the configured conditions (maxSize, wait time, etc.).\n *\n * This function provides a simpler API compared to `injectAsyncBatcher`, making it ideal for basic\n * async batching needs. However, it does not expose the underlying AsyncBatcher instance.\n *\n * For advanced usage requiring features like:\n * - Manual flushing\n * - Access to batch state\n * - Error handling callbacks\n * - Retry support\n *\n * Consider using the `injectAsyncBatcher` function instead.\n *\n * @example\n * ```ts\n * // Batch async API calls\n * const batchApiCall = injectAsyncBatchedCallback(\n *   async (items: Array<Data>) => {\n *     const response = await fetch('/api/batch', {\n *       method: 'POST',\n *       body: JSON.stringify(items)\n *     });\n *     return response.json();\n *   },\n *   { maxSize: 10, wait: 1000 }\n * );\n *\n * // Items will be batched and sent together\n * await batchApiCall(data1);\n * await batchApiCall(data2);\n * ```\n */\nexport function injectAsyncBatchedCallback<TValue>(\n  fn: (items: Array<TValue>) => Promise<any>,\n  options: AsyncBatcherOptions<TValue>,\n): (item: TValue) => Promise<void> {\n  const batcher = injectAsyncBatcher(fn, options)\n  return (item: TValue) => batcher.addItem(item)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,2BACd,IACA,SACiC;CACjC,MAAM,UAAU,mBAAmB,IAAI,QAAQ;AAC/C,SAAQ,SAAiB,QAAQ,QAAQ,KAAK"}

package/dist/async-batcher/injectAsyncBatcher.cjs

@@ -0,0 +1,61 @@
+const require_pacer_context = require('../provider/pacer-context.cjs');
+let _tanstack_angular_store = require("@tanstack/angular-store");
+let _tanstack_pacer_async_batcher = require("@tanstack/pacer/async-batcher");
+
+//#region src/async-batcher/injectAsyncBatcher.ts
+/**
+* An Angular function that creates and manages an AsyncBatcher instance.
+*
+* This is a lower-level function that provides direct access to the AsyncBatcher's functionality.
+* This allows you to integrate it with any state management solution you prefer.
+*
+* The AsyncBatcher collects items and processes them in batches asynchronously with support for
+* promise-based processing, error handling, retry capabilities, and abort support.
+*
+* ## State Management and Selector
+*
+* The function uses TanStack Store for state management and wraps it with Angular signals.
+* The `selector` parameter allows you to specify which state changes will trigger signal updates,
+* optimizing performance by preventing unnecessary updates when irrelevant state changes occur.
+*
+* **By default, there will be no reactive state subscriptions** and you must opt-in to state
+* tracking by providing a selector function. This prevents unnecessary updates and gives you
+* full control over when your component tracks state changes.
+*
+* @example
+* ```ts
+* // Default behavior - no reactive state subscriptions
+* const batcher = injectAsyncBatcher(
+*   async (items: Array<Data>) => {
+*     const response = await fetch('/api/batch', {
+*       method: 'POST',
+*       body: JSON.stringify(items)
+*     });
+*     return response.json();
+*   },
+*   { maxSize: 10, wait: 2000 }
+* );
+*
+* // Add items
+* batcher.addItem(data1);
+* batcher.addItem(data2);
+*
+* // Access the selected state
+* const { items, isExecuting } = batcher.state();
+* ```
+*/
+function injectAsyncBatcher(fn, options = {}, selector = () => ({})) {
+	const batcher = new _tanstack_pacer_async_batcher.AsyncBatcher(fn, {
+		...require_pacer_context.injectPacerOptions().asyncBatcher,
+		...options
+	});
+	const state = (0, _tanstack_angular_store.injectStore)(batcher.store, selector);
+	return {
+		...batcher,
+		state
+	};
+}
+
+//#endregion
+exports.injectAsyncBatcher = injectAsyncBatcher;
+//# sourceMappingURL=injectAsyncBatcher.cjs.map

package/dist/async-batcher/injectAsyncBatcher.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectAsyncBatcher.cjs","names":["AsyncBatcher","injectPacerOptions"],"sources":["../../src/async-batcher/injectAsyncBatcher.ts"],"sourcesContent":["import { injectStore } from '@tanstack/angular-store'\nimport { AsyncBatcher } from '@tanstack/pacer/async-batcher'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/store'\nimport type {\n  AsyncBatcherOptions,\n  AsyncBatcherState,\n} from '@tanstack/pacer/async-batcher'\n\nexport interface AngularAsyncBatcher<TValue, TSelected = {}> extends Omit<\n  AsyncBatcher<TValue>,\n  'store'\n> {\n  /**\n   * Reactive state signal that will be updated when the async batcher state changes\n   *\n   * Use this instead of `batcher.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `batcher.state` instead of `batcher.store.state` if you want to read reactive state.\n   * The state on the store object is not reactive in Angular signals.\n   */\n  readonly store: Store<Readonly<AsyncBatcherState<TValue>>>\n}\n\n/**\n * An Angular function that creates and manages an AsyncBatcher instance.\n *\n * This is a lower-level function that provides direct access to the AsyncBatcher's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * The AsyncBatcher collects items and processes them in batches asynchronously with support for\n * promise-based processing, error handling, retry capabilities, and abort support.\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates when irrelevant state changes occur.\n *\n * **By default, there will be no reactive state subscriptions** and you must opt-in to state\n * tracking by providing a selector function. This prevents unnecessary updates and gives you\n * full control over when your component tracks state changes.\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const batcher = injectAsyncBatcher(\n *   async (items: Array<Data>) => {\n *     const response = await fetch('/api/batch', {\n *       method: 'POST',\n *       body: JSON.stringify(items)\n *     });\n *     return response.json();\n *   },\n *   { maxSize: 10, wait: 2000 }\n * );\n *\n * // Add items\n * batcher.addItem(data1);\n * batcher.addItem(data2);\n *\n * // Access the selected state\n * const { items, isExecuting } = batcher.state();\n * ```\n */\nexport function injectAsyncBatcher<TValue, TSelected = {}>(\n  fn: (items: Array<TValue>) => Promise<any>,\n  options: AsyncBatcherOptions<TValue> = {},\n  selector: (state: AsyncBatcherState<TValue>) => TSelected = () =>\n    ({}) as TSelected,\n): AngularAsyncBatcher<TValue, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().asyncBatcher,\n    ...options,\n  } as AsyncBatcherOptions<TValue>\n\n  const batcher = new AsyncBatcher<TValue>(fn, mergedOptions)\n  const state = injectStore(batcher.store, selector)\n\n  return {\n    ...batcher,\n    state,\n  } as AngularAsyncBatcher<TValue, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,mBACd,IACA,UAAuC,EAAE,EACzC,kBACG,EAAE,GACmC;CAMxC,MAAM,UAAU,IAAIA,2CAAqB,IALnB;EACpB,GAAGC,0CAAoB,CAAC;EACxB,GAAG;EACJ,CAE0D;CAC3D,MAAM,iDAAoB,QAAQ,OAAO,SAAS;AAElD,QAAO;EACL,GAAG;EACH;EACD"}

package/dist/async-batcher/injectAsyncBatcher.d.cts

@@ -0,0 +1,63 @@
+import { AsyncBatcher, AsyncBatcherOptions, AsyncBatcherState } from "@tanstack/pacer/async-batcher";
+import { Signal } from "@angular/core";
+import { Store } from "@tanstack/store";
+
+//#region src/async-batcher/injectAsyncBatcher.d.ts
+interface AngularAsyncBatcher<TValue, TSelected = {}> extends Omit<AsyncBatcher<TValue>, 'store'> {
+  /**
+   * Reactive state signal that will be updated when the async batcher state changes
+   *
+   * Use this instead of `batcher.store.state`
+   */
+  readonly state: Signal<Readonly<TSelected>>;
+  /**
+   * @deprecated Use `batcher.state` instead of `batcher.store.state` if you want to read reactive state.
+   * The state on the store object is not reactive in Angular signals.
+   */
+  readonly store: Store<Readonly<AsyncBatcherState<TValue>>>;
+}
+/**
+ * An Angular function that creates and manages an AsyncBatcher instance.
+ *
+ * This is a lower-level function that provides direct access to the AsyncBatcher's functionality.
+ * This allows you to integrate it with any state management solution you prefer.
+ *
+ * The AsyncBatcher collects items and processes them in batches asynchronously with support for
+ * promise-based processing, error handling, retry capabilities, and abort support.
+ *
+ * ## State Management and Selector
+ *
+ * The function uses TanStack Store for state management and wraps it with Angular signals.
+ * The `selector` parameter allows you to specify which state changes will trigger signal updates,
+ * optimizing performance by preventing unnecessary updates when irrelevant state changes occur.
+ *
+ * **By default, there will be no reactive state subscriptions** and you must opt-in to state
+ * tracking by providing a selector function. This prevents unnecessary updates and gives you
+ * full control over when your component tracks state changes.
+ *
+ * @example
+ * ```ts
+ * // Default behavior - no reactive state subscriptions
+ * const batcher = injectAsyncBatcher(
+ *   async (items: Array<Data>) => {
+ *     const response = await fetch('/api/batch', {
+ *       method: 'POST',
+ *       body: JSON.stringify(items)
+ *     });
+ *     return response.json();
+ *   },
+ *   { maxSize: 10, wait: 2000 }
+ * );
+ *
+ * // Add items
+ * batcher.addItem(data1);
+ * batcher.addItem(data2);
+ *
+ * // Access the selected state
+ * const { items, isExecuting } = batcher.state();
+ * ```
+ */
+declare function injectAsyncBatcher<TValue, TSelected = {}>(fn: (items: Array<TValue>) => Promise<any>, options?: AsyncBatcherOptions<TValue>, selector?: (state: AsyncBatcherState<TValue>) => TSelected): AngularAsyncBatcher<TValue, TSelected>;
+//#endregion
+export { AngularAsyncBatcher, injectAsyncBatcher };
+//# sourceMappingURL=injectAsyncBatcher.d.cts.map

package/dist/async-batcher/injectAsyncBatcher.d.ts

@@ -0,0 +1,63 @@
+import { Signal } from "@angular/core";
+import { AsyncBatcher, AsyncBatcherOptions, AsyncBatcherState } from "@tanstack/pacer/async-batcher";
+import { Store } from "@tanstack/store";
+
+//#region src/async-batcher/injectAsyncBatcher.d.ts
+interface AngularAsyncBatcher<TValue, TSelected = {}> extends Omit<AsyncBatcher<TValue>, 'store'> {
+  /**
+   * Reactive state signal that will be updated when the async batcher state changes
+   *
+   * Use this instead of `batcher.store.state`
+   */
+  readonly state: Signal<Readonly<TSelected>>;
+  /**
+   * @deprecated Use `batcher.state` instead of `batcher.store.state` if you want to read reactive state.
+   * The state on the store object is not reactive in Angular signals.
+   */
+  readonly store: Store<Readonly<AsyncBatcherState<TValue>>>;
+}
+/**
+ * An Angular function that creates and manages an AsyncBatcher instance.
+ *
+ * This is a lower-level function that provides direct access to the AsyncBatcher's functionality.
+ * This allows you to integrate it with any state management solution you prefer.
+ *
+ * The AsyncBatcher collects items and processes them in batches asynchronously with support for
+ * promise-based processing, error handling, retry capabilities, and abort support.
+ *
+ * ## State Management and Selector
+ *
+ * The function uses TanStack Store for state management and wraps it with Angular signals.
+ * The `selector` parameter allows you to specify which state changes will trigger signal updates,
+ * optimizing performance by preventing unnecessary updates when irrelevant state changes occur.
+ *
+ * **By default, there will be no reactive state subscriptions** and you must opt-in to state
+ * tracking by providing a selector function. This prevents unnecessary updates and gives you
+ * full control over when your component tracks state changes.
+ *
+ * @example
+ * ```ts
+ * // Default behavior - no reactive state subscriptions
+ * const batcher = injectAsyncBatcher(
+ *   async (items: Array<Data>) => {
+ *     const response = await fetch('/api/batch', {
+ *       method: 'POST',
+ *       body: JSON.stringify(items)
+ *     });
+ *     return response.json();
+ *   },
+ *   { maxSize: 10, wait: 2000 }
+ * );
+ *
+ * // Add items
+ * batcher.addItem(data1);
+ * batcher.addItem(data2);
+ *
+ * // Access the selected state
+ * const { items, isExecuting } = batcher.state();
+ * ```
+ */
+declare function injectAsyncBatcher<TValue, TSelected = {}>(fn: (items: Array<TValue>) => Promise<any>, options?: AsyncBatcherOptions<TValue>, selector?: (state: AsyncBatcherState<TValue>) => TSelected): AngularAsyncBatcher<TValue, TSelected>;
+//#endregion
+export { AngularAsyncBatcher, injectAsyncBatcher };
+//# sourceMappingURL=injectAsyncBatcher.d.ts.map