TanStack · KevinVandy · Aug 5, 2025 · Aug 6, 2025 · Aug 7, 2025 · Aug 10, 2025
diff --git a/.changeset/chubby-laws-smile.md b/.changeset/chubby-laws-smile.md
@@ -0,0 +1,10 @@
+---
+'@tanstack/react-pacer-devtools': minor
+'@tanstack/solid-pacer-devtools': minor
+'@tanstack/pacer-devtools': minor
+'@tanstack/react-pacer': minor
+'@tanstack/solid-pacer': minor
+'@tanstack/pacer': minor
+---
+
+feat: added built-in retries and added better abort support to async utils
diff --git a/docs/config.json b/docs/config.json
@@ -89,6 +89,10 @@
         {
           "label": "Async Batching Guide",
           "to": "guides/async-batching"
+        },
+        {
+          "label": "Async Retrying Guide",
+          "to": "guides/async-retrying"
         }
       ]
     },

diff --git a/docs/framework/react/reference/functions/pacerprovider.md b/docs/framework/react/reference/functions/pacerprovider.md
@@ -0,0 +1,24 @@
+---
+id: PacerProvider
+title: PacerProvider
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: PacerProvider()
+
+```ts
+function PacerProvider(__namedParameters): Element
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:46](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L46)
+
+## Parameters
+
+### \_\_namedParameters
+
+[`PacerProviderProps`](../../interfaces/pacerproviderprops.md)
+
+## Returns
+
+`Element`
diff --git a/docs/framework/react/reference/functions/useasyncbatcher.md b/docs/framework/react/reference/functions/useasyncbatcher.md
@@ -14,7 +14,7 @@ function useAsyncBatcher<TValue, TSelected>(
 selector): ReactAsyncBatcher<TValue, TSelected>
 ```
 
-Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:167](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L167)
+Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:168](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L168)
 
 A React hook that creates an `AsyncBatcher` instance for managing asynchronous batches of items.
 

diff --git a/docs/framework/react/reference/functions/useasyncdebouncer.md b/docs/framework/react/reference/functions/useasyncdebouncer.md
@@ -14,7 +14,7 @@ function useAsyncDebouncer<TFn, TSelected>(
 selector): ReactAsyncDebouncer<TFn, TSelected>
 ```
 
-Defined in: [react-pacer/src/async-debouncer/useAsyncDebouncer.ts:149](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-debouncer/useAsyncDebouncer.ts#L149)
+Defined in: [react-pacer/src/async-debouncer/useAsyncDebouncer.ts:150](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-debouncer/useAsyncDebouncer.ts#L150)
 
 A low-level React hook that creates an `AsyncDebouncer` instance to delay execution of an async function.
 

diff --git a/docs/framework/react/reference/functions/useasyncqueuer.md b/docs/framework/react/reference/functions/useasyncqueuer.md
@@ -14,7 +14,7 @@ function useAsyncQueuer<TValue, TSelected>(
 selector): ReactAsyncQueuer<TValue, TSelected>
 ```
 
-Defined in: [react-pacer/src/async-queuer/useAsyncQueuer.ts:167](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-queuer/useAsyncQueuer.ts#L167)
+Defined in: [react-pacer/src/async-queuer/useAsyncQueuer.ts:168](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-queuer/useAsyncQueuer.ts#L168)
 
 A lower-level React hook that creates an `AsyncQueuer` instance for managing an async queue of items.
 

diff --git a/docs/framework/react/reference/functions/useasyncratelimiter.md b/docs/framework/react/reference/functions/useasyncratelimiter.md
@@ -14,7 +14,7 @@ function useAsyncRateLimiter<TFn, TSelected>(
 selector): ReactAsyncRateLimiter<TFn, TSelected>
 ```
 
-Defined in: [react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts:178](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts#L178)
+Defined in: [react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts:179](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts#L179)
 
 A low-level React hook that creates an `AsyncRateLimiter` instance to limit how many times an async function can execute within a time window.
 

diff --git a/docs/framework/react/reference/functions/useasyncthrottler.md b/docs/framework/react/reference/functions/useasyncthrottler.md
@@ -14,7 +14,7 @@ function useAsyncThrottler<TFn, TSelected>(
 selector): ReactAsyncThrottler<TFn, TSelected>
 ```
 
-Defined in: [react-pacer/src/async-throttler/useAsyncThrottler.ts:160](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-throttler/useAsyncThrottler.ts#L160)
+Defined in: [react-pacer/src/async-throttler/useAsyncThrottler.ts:161](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-throttler/useAsyncThrottler.ts#L161)
 
 A low-level React hook that creates an `AsyncThrottler` instance to limit how often an async function can execute.
 

diff --git a/docs/framework/react/reference/functions/usebatcher.md b/docs/framework/react/reference/functions/usebatcher.md
@@ -14,7 +14,7 @@ function useBatcher<TValue, TSelected>(
 selector): ReactBatcher<TValue, TSelected>
 ```
 
-Defined in: [react-pacer/src/batcher/useBatcher.ts:121](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/batcher/useBatcher.ts#L121)
+Defined in: [react-pacer/src/batcher/useBatcher.ts:122](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/batcher/useBatcher.ts#L122)
 
 A React hook that creates and manages a Batcher instance.
 

diff --git a/docs/framework/react/reference/functions/usedebouncer.md b/docs/framework/react/reference/functions/usedebouncer.md
@@ -14,7 +14,7 @@ function useDebouncer<TFn, TSelected>(
 selector): ReactDebouncer<TFn, TSelected>
 ```
 
-Defined in: [react-pacer/src/debouncer/useDebouncer.ts:102](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/debouncer/useDebouncer.ts#L102)
+Defined in: [react-pacer/src/debouncer/useDebouncer.ts:103](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/debouncer/useDebouncer.ts#L103)
 
 A React hook that creates and manages a Debouncer instance.
 

diff --git a/docs/framework/react/reference/functions/usedefaultpaceroptions.md b/docs/framework/react/reference/functions/usedefaultpaceroptions.md
@@ -0,0 +1,18 @@
+---
+id: useDefaultPacerOptions
+title: useDefaultPacerOptions
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: useDefaultPacerOptions()
+
+```ts
+function useDefaultPacerOptions(): PacerProviderOptions
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:68](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L68)
+
+## Returns
+
+[`PacerProviderOptions`](../../interfaces/pacerprovideroptions.md)
diff --git a/docs/framework/react/reference/functions/usepacercontext.md b/docs/framework/react/reference/functions/usepacercontext.md
@@ -0,0 +1,18 @@
+---
+id: usePacerContext
+title: usePacerContext
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: usePacerContext()
+
+```ts
+function usePacerContext(): null | PacerContextValue
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:64](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L64)
+
+## Returns
+
+`null` \| `PacerContextValue`
diff --git a/docs/framework/react/reference/functions/usequeuer.md b/docs/framework/react/reference/functions/usequeuer.md
@@ -14,7 +14,7 @@ function useQueuer<TValue, TSelected>(
 selector): ReactQueuer<TValue, TSelected>
 ```
 
-Defined in: [react-pacer/src/queuer/useQueuer.ts:132](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/queuer/useQueuer.ts#L132)
+Defined in: [react-pacer/src/queuer/useQueuer.ts:133](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/queuer/useQueuer.ts#L133)
 
 A React hook that creates and manages a Queuer instance.
 

diff --git a/docs/framework/react/reference/functions/useratelimiter.md b/docs/framework/react/reference/functions/useratelimiter.md
@@ -14,7 +14,7 @@ function useRateLimiter<TFn, TSelected>(
 selector): ReactRateLimiter<TFn, TSelected>
 ```
 
-Defined in: [react-pacer/src/rate-limiter/useRateLimiter.ts:141](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/rate-limiter/useRateLimiter.ts#L141)
+Defined in: [react-pacer/src/rate-limiter/useRateLimiter.ts:142](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/rate-limiter/useRateLimiter.ts#L142)
 
 A low-level React hook that creates a `RateLimiter` instance to enforce rate limits on function execution.
 

diff --git a/docs/framework/react/reference/functions/usethrottler.md b/docs/framework/react/reference/functions/usethrottler.md
@@ -14,7 +14,7 @@ function useThrottler<TFn, TSelected>(
 selector): ReactThrottler<TFn, TSelected>
 ```
 
-Defined in: [react-pacer/src/throttler/useThrottler.ts:107](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/throttler/useThrottler.ts#L107)
+Defined in: [react-pacer/src/throttler/useThrottler.ts:108](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/throttler/useThrottler.ts#L108)
 
 A low-level React hook that creates a `Throttler` instance that limits how often the provided function can execute.
 

diff --git a/docs/framework/react/reference/index.md b/docs/framework/react/reference/index.md
@@ -9,6 +9,8 @@ title: "@tanstack/react-pacer"
 
 ## Interfaces
 
+- [PacerProviderOptions](../interfaces/pacerprovideroptions.md)
+- [PacerProviderProps](../interfaces/pacerproviderprops.md)
 - [ReactAsyncBatcher](../interfaces/reactasyncbatcher.md)
 - [ReactAsyncDebouncer](../interfaces/reactasyncdebouncer.md)
 - [ReactAsyncQueuer](../interfaces/reactasyncqueuer.md)
@@ -22,6 +24,7 @@ title: "@tanstack/react-pacer"
 
 ## Functions
 
+- [PacerProvider](../functions/pacerprovider.md)
 - [useAsyncBatchedCallback](../functions/useasyncbatchedcallback.md)
 - [useAsyncBatcher](../functions/useasyncbatcher.md)
 - [useAsyncDebouncedCallback](../functions/useasyncdebouncedcallback.md)
@@ -38,6 +41,8 @@ title: "@tanstack/react-pacer"
 - [useDebouncedState](../functions/usedebouncedstate.md)
 - [useDebouncedValue](../functions/usedebouncedvalue.md)
 - [useDebouncer](../functions/usedebouncer.md)
+- [useDefaultPacerOptions](../functions/usedefaultpaceroptions.md)
+- [usePacerContext](../functions/usepacercontext.md)
 - [useQueuedState](../functions/usequeuedstate.md)
 - [useQueuedValue](../functions/usequeuedvalue.md)
 - [useQueuer](../functions/usequeuer.md)

diff --git a/docs/framework/react/reference/interfaces/pacerprovideroptions.md b/docs/framework/react/reference/interfaces/pacerprovideroptions.md
@@ -0,0 +1,120 @@
+---
+id: PacerProviderOptions
+title: PacerProviderOptions
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Interface: PacerProviderOptions
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:19](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L19)
+
+## Properties
+
+### asyncBatcher?
+
+```ts
+optional asyncBatcher: Partial<AsyncBatcherOptions<any>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:20](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L20)
+
+***
+
+### asyncDebouncer?
+
+```ts
+optional asyncDebouncer: Partial<AsyncDebouncerOptions<AnyAsyncFunction>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:21](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L21)
+
+***
+
+### asyncQueuer?
+
+```ts
+optional asyncQueuer: Partial<AsyncQueuerOptions<any>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:22](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L22)
+
+***
+
+### asyncRateLimiter?
+
+```ts
+optional asyncRateLimiter: Partial<AsyncRateLimiterOptions<AnyAsyncFunction>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:23](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L23)
+
+***
+
+### asyncRetryer?
+
+```ts
+optional asyncRetryer: Partial<AsyncRetryerOptions<AnyAsyncFunction>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:24](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L24)
+
+***
+
+### asyncThrottler?
+
+```ts
+optional asyncThrottler: Partial<AsyncThrottlerOptions<AnyAsyncFunction>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:25](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L25)
+
+***
+
+### batcher?
+
+```ts
+optional batcher: Partial<BatcherOptions<any>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:26](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L26)
+
+***
+
+### debouncer?
+
+```ts
+optional debouncer: Partial<DebouncerOptions<AnyFunction>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:27](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L27)
+
+***
+
+### queuer?
+
+```ts
+optional queuer: Partial<QueuerOptions<any>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:28](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L28)
+
+***
+
+### rateLimiter?
+
+```ts
+optional rateLimiter: Partial<RateLimiterOptions<AnyFunction>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:29](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L29)
+
+***
+
+### throttler?
+
+```ts
+optional throttler: Partial<ThrottlerOptions<AnyFunction>>;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:30](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L30)
diff --git a/docs/framework/react/reference/interfaces/pacerproviderprops.md b/docs/framework/react/reference/interfaces/pacerproviderprops.md
@@ -0,0 +1,30 @@
+---
+id: PacerProviderProps
+title: PacerProviderProps
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Interface: PacerProviderProps
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:39](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L39)
+
+## Properties
+
+### children
+
+```ts
+children: ReactNode;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:40](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L40)
+
+***
+
+### defaultOptions?
+
+```ts
+optional defaultOptions: PacerProviderOptions;
+```
+
+Defined in: [react-pacer/src/provider/PacerProvider.tsx:41](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/provider/PacerProvider.tsx#L41)
diff --git a/docs/framework/react/reference/interfaces/reactasyncbatcher.md b/docs/framework/react/reference/interfaces/reactasyncbatcher.md
@@ -7,7 +7,7 @@ title: ReactAsyncBatcher
 
 # Interface: ReactAsyncBatcher\<TValue, TSelected\>
 
-Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:10](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L10)
+Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:11](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L11)
 
 ## Extends
 
@@ -27,7 +27,7 @@ Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:10](https://github
 readonly state: Readonly<TSelected>;
 ```
 
-Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:17](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L17)
+Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:18](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L18)
 
 Reactive state that will be updated and re-rendered when the batcher state changes
 
@@ -41,7 +41,7 @@ Use this instead of `batcher.store.state`
 readonly store: Store<Readonly<AsyncBatcherState<TValue>>>;
 ```
 
-Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:23](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L23)
+Defined in: [react-pacer/src/async-batcher/useAsyncBatcher.ts:24](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-batcher/useAsyncBatcher.ts#L24)
 
 #### Deprecated