@tanstack/angular-pacer 0.23.1 → 0.25.0

package/dist/throttler/injectThrottler.d.cts

@@ -1,98 +0,0 @@
-import { Signal } from "@angular/core";
-import { Store } from "@tanstack/angular-store";
-import { AnyFunction } from "@tanstack/pacer/types";
-import { Throttler, ThrottlerOptions, ThrottlerState } from "@tanstack/pacer/throttler";
-
-//#region src/throttler/injectThrottler.d.ts
-interface AngularThrottlerOptions<TFn extends AnyFunction, TSelected = {}> extends ThrottlerOptions<TFn> {
-  /**
-   * Optional callback invoked when the component is destroyed. Receives the throttler instance.
-   * When provided, replaces the default cleanup (cancel); use it to call flush(), cancel(), add logging, etc.
-   */
-  onUnmount?: (throttler: AngularThrottler<TFn, TSelected>) => void;
-}
-interface AngularThrottler<TFn extends AnyFunction, TSelected = {}> extends Omit<Throttler<TFn>, 'store'> {
-  /**
-   * Reactive state signal that will be updated when the throttler state changes
-   *
-   * Use this instead of `throttler.store.state`
-   */
-  readonly state: Signal<Readonly<TSelected>>;
-  /**
-   * @deprecated Use `throttler.state` instead of `throttler.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<ThrottlerState<TFn>>>;
-}
-/**
- * An Angular function that creates and manages a Throttler instance.
- *
- * This is a lower-level function that provides direct access to the Throttler's functionality.
- * This allows you to integrate it with any state management solution you prefer.
- *
- * This function provides throttling functionality to limit how often a function can be called,
- * ensuring it executes at most once within a specified time window.
- *
- * The throttler will execute the function immediately (if leading is enabled) and then
- * prevent further executions until the wait period has elapsed.
- *
- * ## 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.
- *
- * Available state properties:
- * - `canLeadingExecute`: Whether the throttler can execute on the leading edge
- * - `canTrailingExecute`: Whether the throttler can execute on the trailing edge
- * - `executionCount`: Number of function executions that have been completed
- * - `isPending`: Whether the throttler is waiting for the timeout to trigger execution
- * - `lastArgs`: The arguments from the most recent call to maybeExecute
- * - `lastExecutionTime`: Timestamp of the last execution
- * - `nextExecutionTime`: Timestamp of the next allowed execution
- * - `status`: Current execution status ('disabled' | 'idle' | 'pending')
- *
- * ## Cleanup on Destroy
- *
- * By default, the function cancels any pending execution when the component is destroyed.
- * Use the `onUnmount` option to customize this. For example, to flush pending work instead:
- *
- * ```ts
- * const throttler = injectThrottler(fn, {
- *   wait: 100,
- *   onUnmount: (t) => t.flush()
- * });
- * ```
- *
- * @example
- * ```ts
- * // Default behavior - no reactive state subscriptions
- * const throttler = injectThrottler(
- *   (scrollY: number) => updateScrollPosition(scrollY),
- *   { wait: 100 }
- * );
- *
- * // Opt-in to track isPending changes (optimized for loading states)
- * const throttler = injectThrottler(
- *   (scrollY: number) => updateScrollPosition(scrollY),
- *   { wait: 100 },
- *   (state) => ({ isPending: state.isPending })
- * );
- *
- * // In an event handler
- * window.addEventListener('scroll', () => {
- *   throttler.maybeExecute(window.scrollY);
- * });
- *
- * // Access the selected state (will be empty object {} unless selector provided)
- * const { isPending } = throttler.state();
- * ```
- */
-declare function injectThrottler<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: AngularThrottlerOptions<TFn, TSelected>, selector?: (state: ThrottlerState<TFn>) => TSelected): AngularThrottler<TFn, TSelected>;
-//#endregion
-export { AngularThrottler, AngularThrottlerOptions, injectThrottler };
-//# sourceMappingURL=injectThrottler.d.cts.map

package/dist/throttler/injectThrottler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"injectThrottler.js","names":[],"sources":["../../src/throttler/injectThrottler.ts"],"sourcesContent":["import { DestroyRef, inject } from '@angular/core'\nimport { injectSelector } from '@tanstack/angular-store'\nimport { Throttler } from '@tanstack/pacer/throttler'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/angular-store'\nimport type { AnyFunction } from '@tanstack/pacer/types'\nimport type {\n  ThrottlerOptions,\n  ThrottlerState,\n} from '@tanstack/pacer/throttler'\n\nexport interface AngularThrottlerOptions<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends ThrottlerOptions<TFn> {\n  /**\n   * Optional callback invoked when the component is destroyed. Receives the throttler instance.\n   * When provided, replaces the default cleanup (cancel); use it to call flush(), cancel(), add logging, etc.\n   */\n  onUnmount?: (throttler: AngularThrottler<TFn, TSelected>) => void\n}\n\nexport interface AngularThrottler<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends Omit<Throttler<TFn>, 'store'> {\n  /**\n   * Reactive state signal that will be updated when the throttler state changes\n   *\n   * Use this instead of `throttler.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `throttler.state` instead of `throttler.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<ThrottlerState<TFn>>>\n}\n\n/**\n * An Angular function that creates and manages a Throttler instance.\n *\n * This is a lower-level function that provides direct access to the Throttler's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * This function provides throttling functionality to limit how often a function can be called,\n * ensuring it executes at most once within a specified time window.\n *\n * The throttler will execute the function immediately (if leading is enabled) and then\n * prevent further executions until the wait period has elapsed.\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 * Available state properties:\n * - `canLeadingExecute`: Whether the throttler can execute on the leading edge\n * - `canTrailingExecute`: Whether the throttler can execute on the trailing edge\n * - `executionCount`: Number of function executions that have been completed\n * - `isPending`: Whether the throttler is waiting for the timeout to trigger execution\n * - `lastArgs`: The arguments from the most recent call to maybeExecute\n * - `lastExecutionTime`: Timestamp of the last execution\n * - `nextExecutionTime`: Timestamp of the next allowed execution\n * - `status`: Current execution status ('disabled' | 'idle' | 'pending')\n *\n * ## Cleanup on Destroy\n *\n * By default, the function cancels any pending execution when the component is destroyed.\n * Use the `onUnmount` option to customize this. For example, to flush pending work instead:\n *\n * ```ts\n * const throttler = injectThrottler(fn, {\n *   wait: 100,\n *   onUnmount: (t) => t.flush()\n * });\n * ```\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const throttler = injectThrottler(\n *   (scrollY: number) => updateScrollPosition(scrollY),\n *   { wait: 100 }\n * );\n *\n * // Opt-in to track isPending changes (optimized for loading states)\n * const throttler = injectThrottler(\n *   (scrollY: number) => updateScrollPosition(scrollY),\n *   { wait: 100 },\n *   (state) => ({ isPending: state.isPending })\n * );\n *\n * // In an event handler\n * window.addEventListener('scroll', () => {\n *   throttler.maybeExecute(window.scrollY);\n * });\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { isPending } = throttler.state();\n * ```\n */\nexport function injectThrottler<TFn extends AnyFunction, TSelected = {}>(\n  fn: TFn,\n  options: AngularThrottlerOptions<TFn, TSelected>,\n  selector: (state: ThrottlerState<TFn>) => TSelected = () => ({}) as TSelected,\n): AngularThrottler<TFn, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().throttler,\n    ...options,\n  } as AngularThrottlerOptions<TFn, TSelected>\n\n  const throttler = new Throttler<TFn>(fn, mergedOptions)\n  const state = injectSelector(throttler.store, selector)\n\n  const result = {\n    ...throttler,\n    state,\n  } as AngularThrottler<TFn, TSelected>\n\n  const destroyRef = inject(DestroyRef, { optional: true })\n  destroyRef?.onDestroy(() => {\n    if (mergedOptions.onUnmount) {\n      mergedOptions.onUnmount(result)\n    } else {\n      throttler.cancel()\n    }\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4GA,SAAgB,gBACd,IACA,SACA,kBAA6D,EAAE,GAC7B;CAClC,MAAM,gBAAgB;EACpB,GAAG,oBAAoB,CAAC;EACxB,GAAG;EACJ;CAED,MAAM,YAAY,IAAI,UAAe,IAAI,cAAc;CACvD,MAAM,QAAQ,eAAe,UAAU,OAAO,SAAS;CAEvD,MAAM,SAAS;EACb,GAAG;EACH;EACD;CAGD,AADmB,OAAO,YAAY,EAAE,UAAU,MAAM,CAC9C,EAAE,gBAAgB;EAC1B,IAAI,cAAc,WAChB,cAAc,UAAU,OAAO;OAE/B,UAAU,QAAQ;GAEpB;CAEF,OAAO"}

package/dist/types/index.cjs

@@ -1,9 +0,0 @@
-
-
-var _tanstack_pacer_types = require("@tanstack/pacer/types");
-Object.keys(_tanstack_pacer_types).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return _tanstack_pacer_types[k]; }
-  });
-});

package/dist/types/index.d.cts

@@ -1 +0,0 @@
-export * from "@tanstack/pacer/types";

package/dist/utils/index.cjs

@@ -1,9 +0,0 @@
-
-
-var _tanstack_pacer_utils = require("@tanstack/pacer/utils");
-Object.keys(_tanstack_pacer_utils).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return _tanstack_pacer_utils[k]; }
-  });
-});

package/dist/utils/index.d.cts

@@ -1 +0,0 @@
-export * from "@tanstack/pacer/utils";

package/src/async-batcher/index.ts

@@ -1,4 +0,0 @@
-export * from '@tanstack/pacer/async-batcher'
-
-export * from './injectAsyncBatchedCallback'
-export * from './injectAsyncBatcher'

package/src/async-batcher/injectAsyncBatchedCallback.ts

@@ -1,48 +0,0 @@
-import { injectAsyncBatcher } from './injectAsyncBatcher'
-import type { AsyncBatcherOptions } from '@tanstack/pacer/async-batcher'
-
-/**
- * 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);
- * ```
- */
-export function injectAsyncBatchedCallback<TValue>(
-  fn: (items: Array<TValue>) => Promise<any>,
-  options: AsyncBatcherOptions<TValue>,
-): (item: TValue) => Promise<void> {
-  const batcher = injectAsyncBatcher(fn, options)
-  return (item: TValue) => batcher.addItem(item)
-}

package/src/async-batcher/injectAsyncBatcher.ts

@@ -1,126 +0,0 @@
-import { DestroyRef, inject } from '@angular/core'
-import { injectSelector } from '@tanstack/angular-store'
-import { AsyncBatcher } from '@tanstack/pacer/async-batcher'
-import { injectPacerOptions } from '../provider/pacer-context'
-import type { Signal } from '@angular/core'
-import type { Store } from '@tanstack/angular-store'
-import type {
-  AsyncBatcherOptions,
-  AsyncBatcherState,
-} from '@tanstack/pacer/async-batcher'
-
-export interface AngularAsyncBatcherOptions<
-  TValue,
-  TSelected = {},
-> extends AsyncBatcherOptions<TValue> {
-  /**
-   * Optional callback invoked when the component is destroyed. Receives the batcher instance.
-   * When provided, replaces the default cleanup (cancel + abort); use it to call flush(), cancel(), add logging, etc.
-   * When using onUnmount with flush, guard your callbacks since the component may already be destroyed.
-   */
-  onUnmount?: (batcher: AngularAsyncBatcher<TValue, TSelected>) => void
-}
-
-export 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.
- *
- * ## Cleanup on Destroy
- *
- * By default, the function cancels any pending batch and aborts in-flight work when the component is destroyed.
- * Use the `onUnmount` option to customize this. For example, to flush pending work instead:
- *
- * ```ts
- * const batcher = injectAsyncBatcher(fn, {
- *   maxSize: 10,
- *   onUnmount: (b) => b.flush()
- * });
- * ```
- *
- * When using onUnmount with flush, guard your callbacks since the component may already be destroyed.
- *
- * @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();
- * ```
- */
-export function injectAsyncBatcher<TValue, TSelected = {}>(
-  fn: (items: Array<TValue>) => Promise<any>,
-  options: AngularAsyncBatcherOptions<TValue, TSelected> = {},
-  selector: (state: AsyncBatcherState<TValue>) => TSelected = () =>
-    ({}) as TSelected,
-): AngularAsyncBatcher<TValue, TSelected> {
-  const mergedOptions = {
-    ...injectPacerOptions().asyncBatcher,
-    ...options,
-  } as AngularAsyncBatcherOptions<TValue, TSelected>
-
-  const batcher = new AsyncBatcher<TValue>(fn, mergedOptions)
-  const state = injectSelector(batcher.store, selector)
-
-  const result = {
-    ...batcher,
-    state,
-  } as AngularAsyncBatcher<TValue, TSelected>
-
-  const destroyRef = inject(DestroyRef, { optional: true })
-  destroyRef?.onDestroy(() => {
-    if (mergedOptions.onUnmount) {
-      mergedOptions.onUnmount(result)
-    } else {
-      batcher.cancel()
-      batcher.abort()
-    }
-  })
-
-  return result
-}

package/src/async-debouncer/index.ts

@@ -1,4 +0,0 @@
-export * from '@tanstack/pacer/async-debouncer'
-
-export * from './injectAsyncDebouncedCallback'
-export * from './injectAsyncDebouncer'

package/src/async-debouncer/injectAsyncDebouncedCallback.ts

@@ -1,50 +0,0 @@
-import { injectAsyncDebouncer } from './injectAsyncDebouncer'
-import type { AsyncDebouncerOptions } from '@tanstack/pacer/async-debouncer'
-import type { AnyAsyncFunction } from '@tanstack/pacer/types'
-
-/**
- * An Angular function that creates an async debounced version of a callback function.
- * This function is essentially a wrapper around `injectAsyncDebouncer` that provides
- * a simplified API for basic async debouncing needs.
- *
- * The debounced function will only execute after the specified wait time has elapsed
- * since its last invocation. If called again before the wait time expires, the timer
- * resets and starts waiting again.
- *
- * This function provides a simpler API compared to `injectAsyncDebouncer`, making it ideal for basic
- * async debouncing needs. However, it does not expose the underlying AsyncDebouncer instance.
- *
- * For advanced usage requiring features like:
- * - Manual cancellation
- * - Access to execution counts
- * - Error handling callbacks
- * - Retry support
- *
- * Consider using the `injectAsyncDebouncer` function instead.
- *
- * @example
- * ```ts
- * // Debounce an async search handler
- * const handleSearch = injectAsyncDebouncedCallback(
- *   async (query: string) => {
- *     const response = await fetch(`/api/search?q=${query}`);
- *     return response.json();
- *   },
- *   { wait: 500 }
- * );
- *
- * // Use in an input
- * const results = await handleSearch(searchQuery);
- * ```
- */
-export function injectAsyncDebouncedCallback<TFn extends AnyAsyncFunction>(
-  fn: TFn,
-  options: AsyncDebouncerOptions<TFn>,
-): (...args: Parameters<TFn>) => Promise<Awaited<ReturnType<TFn>> | undefined> {
-  const debouncer = injectAsyncDebouncer(fn, options)
-  return async (...args: Parameters<TFn>) => {
-    const result = await debouncer.maybeExecute(...args)
-    // Not sure if this is the best way to handle this,
-    return result !== undefined ? await result : undefined
-  }
-}

package/src/async-debouncer/injectAsyncDebouncer.ts

@@ -1,152 +0,0 @@
-import { DestroyRef, inject } from '@angular/core'
-import { injectSelector } from '@tanstack/angular-store'
-import { AsyncDebouncer } from '@tanstack/pacer/async-debouncer'
-import { injectPacerOptions } from '../provider/pacer-context'
-import type { Signal } from '@angular/core'
-import type { Store } from '@tanstack/angular-store'
-import type { AnyAsyncFunction } from '@tanstack/pacer/types'
-import type {
-  AsyncDebouncerOptions,
-  AsyncDebouncerState,
-} from '@tanstack/pacer/async-debouncer'
-
-export interface AngularAsyncDebouncerOptions<
-  TFn extends AnyAsyncFunction,
-  TSelected = {},
-> extends AsyncDebouncerOptions<TFn> {
-  /**
-   * Optional callback invoked when the component is destroyed. Receives the debouncer instance.
-   * When provided, replaces the default cleanup (cancel + abort); use it to call flush(), cancel(), add logging, etc.
-   * When using onUnmount with flush, guard your callbacks since the component may already be destroyed.
-   */
-  onUnmount?: (debouncer: AngularAsyncDebouncer<TFn, TSelected>) => void
-}
-
-export interface AngularAsyncDebouncer<
-  TFn extends AnyAsyncFunction,
-  TSelected = {},
-> extends Omit<AsyncDebouncer<TFn>, 'store'> {
-  /**
-   * Reactive state signal that will be updated when the async debouncer state changes
-   *
-   * Use this instead of `debouncer.store.state`
-   */
-  readonly state: Signal<Readonly<TSelected>>
-  /**
-   * @deprecated Use `debouncer.state` instead of `debouncer.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<AsyncDebouncerState<TFn>>>
-}
-
-/**
- * An Angular function that creates and manages an AsyncDebouncer instance.
- *
- * This is a lower-level function that provides direct access to the AsyncDebouncer's functionality.
- * This allows you to integrate it with any state management solution you prefer.
- *
- * This function provides async debouncing functionality with promise support, error handling,
- * retry capabilities, and abort support.
- *
- * The debouncer will only execute the function after the specified wait time has elapsed
- * since the last call. If the function is called again before the wait time expires, the
- * timer resets and starts waiting again.
- *
- * ## 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.
- *
- * Available state properties:
- * - `canLeadingExecute`: Whether the debouncer can execute on the leading edge
- * - `errorCount`: Number of function executions that have resulted in errors
- * - `isExecuting`: Whether the debounced function is currently executing asynchronously
- * - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution
- * - `lastArgs`: The arguments from the most recent call to maybeExecute
- * - `lastResult`: The result from the most recent successful function execution
- * - `settleCount`: Number of function executions that have completed (either successfully or with errors)
- * - `status`: Current execution status ('disabled' | 'idle' | 'pending' | 'executing' | 'settled')
- * - `successCount`: Number of function executions that have completed successfully
- *
- * ## Cleanup on Destroy
- *
- * By default, the function cancels any pending execution and aborts in-flight work when the component is destroyed.
- * Use the `onUnmount` option to customize this. For example, to flush pending work instead:
- *
- * ```ts
- * const debouncer = injectAsyncDebouncer(fn, {
- *   wait: 500,
- *   onUnmount: (d) => d.flush()
- * });
- * ```
- *
- * When using onUnmount with flush, guard your callbacks since the component may already be destroyed.
- *
- * @example
- * ```ts
- * // Default behavior - no reactive state subscriptions
- * const debouncer = injectAsyncDebouncer(
- *   async (query: string) => {
- *     const response = await fetch(`/api/search?q=${query}`);
- *     return response.json();
- *   },
- *   { wait: 500 }
- * );
- *
- * // Opt-in to track isExecuting changes (optimized for loading states)
- * const debouncer = injectAsyncDebouncer(
- *   async (query: string) => fetchSearchResults(query),
- *   { wait: 500 },
- *   (state) => ({ isExecuting: state.isExecuting, isPending: state.isPending })
- * );
- *
- * // In an event handler
- * const handleChange = async (e: Event) => {
- *   const target = e.target as HTMLInputElement;
- *   const result = await debouncer.maybeExecute(target.value);
- *   console.log('Search results:', result);
- * };
- *
- * // Access the selected state
- * const { isExecuting, errorCount } = debouncer.state();
- * ```
- */
-export function injectAsyncDebouncer<
-  TFn extends AnyAsyncFunction,
-  TSelected = {},
->(
-  fn: TFn,
-  options: AngularAsyncDebouncerOptions<TFn, TSelected>,
-  selector: (state: AsyncDebouncerState<TFn>) => TSelected = () =>
-    ({}) as TSelected,
-): AngularAsyncDebouncer<TFn, TSelected> {
-  const mergedOptions = {
-    ...injectPacerOptions().asyncDebouncer,
-    ...options,
-  } as AngularAsyncDebouncerOptions<TFn, TSelected>
-
-  const debouncer = new AsyncDebouncer<TFn>(fn, mergedOptions)
-  const state = injectSelector(debouncer.store, selector)
-
-  const result = {
-    ...debouncer,
-    state,
-  } as AngularAsyncDebouncer<TFn, TSelected>
-
-  const destroyRef = inject(DestroyRef, { optional: true })
-  destroyRef?.onDestroy(() => {
-    if (mergedOptions.onUnmount) {
-      mergedOptions.onUnmount(result)
-    } else {
-      debouncer.cancel()
-      debouncer.abort()
-    }
-  })
-
-  return result
-}

package/src/async-queuer/index.ts

@@ -1,4 +0,0 @@
-export * from '@tanstack/pacer/async-queuer'
-
-export * from './injectAsyncQueuedSignal'
-export * from './injectAsyncQueuer'

package/src/async-queuer/injectAsyncQueuedSignal.ts

@@ -1,74 +0,0 @@
-import { computed } from '@angular/core'
-import { injectAsyncQueuer } from './injectAsyncQueuer'
-import type { AngularAsyncQueuer } from './injectAsyncQueuer'
-import type {
-  AsyncQueuerOptions,
-  AsyncQueuerState,
-} from '@tanstack/pacer/async-queuer'
-
-export interface AsyncQueuedSignal<TValue, TSelected = {}> {
-  (): Array<TValue>
-  addItem: AngularAsyncQueuer<TValue, TSelected>['addItem']
-  queuer: AngularAsyncQueuer<TValue, TSelected>
-}
-
-/**
- * An Angular function that creates an async queuer with managed state, combining Angular's signals with async queuing functionality.
- * This function provides both the current queue state and queue control methods.
- *
- * The queue state is automatically updated whenever items are added, removed, or processed in the queue.
- * All queue operations are reflected in the state array returned by the function.
- *
- * The function returns a callable object:
- * - `queued()`: Get the current queue items as an array
- * - `queued.addItem(...)`: Add an item to the queue
- * - `queued.queue`: The queuer instance with additional control methods
- *
- * @example
- * ```ts
- * // Default behavior - track items
- * const queued = injectAsyncQueuedSignal(
- *   async (item) => {
- *     const response = await fetch('/api/process', {
- *       method: 'POST',
- *       body: JSON.stringify(item)
- *     });
- *     return response.json();
- *   },
- *   { concurrency: 2, wait: 1000 }
- * );
- *
- * // Add items
- * queued.addItem(data1);
- *
- * // Access items
- * console.log(queued()); // [data1, ...]
- *
- * // Control the queue
- * queued.queuer.start();
- * queued.queuer.stop();
- * ```
- */
-export function injectAsyncQueuedSignal<
-  TValue,
-  TSelected extends Pick<AsyncQueuerState<TValue>, 'items'> = Pick<
-    AsyncQueuerState<TValue>,
-    'items'
-  >,
->(
-  fn: (value: TValue) => Promise<any>,
-  options: AsyncQueuerOptions<TValue> = {},
-  selector: (state: AsyncQueuerState<TValue>) => TSelected = (state) =>
-    ({ items: state.items }) as TSelected,
-): AsyncQueuedSignal<TValue, TSelected> {
-  const queuer = injectAsyncQueuer(fn, options, selector)
-
-  const items = computed(() => queuer.state().items as Array<TValue>)
-
-  const queued = Object.assign(items, {
-    addItem: queuer.addItem.bind(queuer),
-    queuer,
-  }) as AsyncQueuedSignal<TValue, TSelected>
-
-  return queued
-}