@nkzw/fate 1.5.0 → 1.5.1

package/docs/api/type-aliases/MutationIdentifier.md

@@ -2,7 +2,7 @@
 
 > **MutationIdentifier**\<`T`, `I`, `R`\> = [`MutationDefinition`](MutationDefinition.md)\<`T`, `I`, `R`\> & `Readonly`\<\{ `key`: `string`; \}\>
 
-Defined in: [packages/fate/src/types.ts:473](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L473)
+Defined in: [packages/fate/src/types.ts:473](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L473)
 
 ## Type Parameters
 

package/docs/api/type-aliases/MutationIdentity.md

@@ -2,6 +2,6 @@
 
 > **MutationIdentity** = `Readonly`\<\{ `id`: `string`; `replayOnly?`: `true`; `scope`: `string`; \}\>
 
-Defined in: [packages/fate/src/persistence-types.ts:7](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/persistence-types.ts#L7)
+Defined in: [packages/fate/src/persistence-types.ts:7](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/persistence-types.ts#L7)
 
 Identity of one logical mutation, reused across every delivery attempt.

package/docs/api/type-aliases/MutationInput.md

@@ -2,7 +2,7 @@
 
 > **MutationInput**\<`M`\> = `M` *extends* `__MutationInputAnchor`\<infer I\> ? `I` : `never`
 
-Defined in: [packages/fate/src/types.ts:477](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L477)
+Defined in: [packages/fate/src/types.ts:477](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L477)
 
 Extracts the input type from a mutation definition or identifier.
 

package/docs/api/type-aliases/MutationResult.md

@@ -2,7 +2,7 @@
 
 > **MutationResult**\<`M`\> = `M` *extends* `__MutationResultAnchor`\<infer R\> ? `R` : `never`
 
-Defined in: [packages/fate/src/types.ts:480](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L480)
+Defined in: [packages/fate/src/types.ts:480](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L480)
 
 Extracts the result type from a mutation definition or identifier.
 

package/docs/api/type-aliases/NodesItem.md

@@ -2,7 +2,7 @@
 
 > **NodesItem**\<`V`\> = `Readonly`\<\{ `ids`: `ReadonlyArray`\<`string` \| `number`\>; `view`: `V`; \}\>
 
-Defined in: [packages/fate/src/types.ts:365](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L365)
+Defined in: [packages/fate/src/types.ts:365](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L365)
 
 Definition of a node request with explicit IDs for fetching data from the backend.
 

package/docs/api/type-aliases/Pagination.md

@@ -2,7 +2,7 @@
 
 > **Pagination** = `object`
 
-Defined in: [packages/fate/src/types.ts:130](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L130)
+Defined in: [packages/fate/src/types.ts:130](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L130)
 
 Pagination state returned alongside connection lists.
 
@@ -12,7 +12,7 @@ Pagination state returned alongside connection lists.
 
 > **hasNext**: `boolean`
 
-Defined in: [packages/fate/src/types.ts:131](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L131)
+Defined in: [packages/fate/src/types.ts:131](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L131)
 
 ***
 
@@ -20,7 +20,7 @@ Defined in: [packages/fate/src/types.ts:131](https://github.com/nkzw-tech/fate/b
 
 > **hasPrevious**: `boolean`
 
-Defined in: [packages/fate/src/types.ts:132](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L132)
+Defined in: [packages/fate/src/types.ts:132](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L132)
 
 ***
 
@@ -28,7 +28,7 @@ Defined in: [packages/fate/src/types.ts:132](https://github.com/nkzw-tech/fate/b
 
 > `optional` **nextCursor?**: `string`
 
-Defined in: [packages/fate/src/types.ts:133](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L133)
+Defined in: [packages/fate/src/types.ts:133](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L133)
 
 ***
 
@@ -36,4 +36,4 @@ Defined in: [packages/fate/src/types.ts:133](https://github.com/nkzw-tech/fate/b
 
 > `optional` **previousCursor?**: `string`
 
-Defined in: [packages/fate/src/types.ts:134](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L134)
+Defined in: [packages/fate/src/types.ts:134](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L134)

package/docs/api/type-aliases/PersistedMutationStatus.md

@@ -0,0 +1,5 @@
+# Type Alias: PersistedMutationStatus
+
+> **PersistedMutationStatus** = `Readonly`\<\{ `error?`: `string`; `id`: `string`; `input`: `unknown`; `name`: `string`; `status`: `"queued"` \| `"sending"` \| `"failed"`; \}\>
+
+Defined in: [packages/fate/src/persistence-types.ts:20](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/persistence-types.ts#L20)

package/docs/api/type-aliases/PersistenceSnapshot.md

@@ -1,5 +1,5 @@
 # Type Alias: PersistenceSnapshot
 
-> **PersistenceSnapshot** = `Readonly`\<\{ `error?`: `Error`; `mutations`: `ReadonlyArray`\<`PersistedMutationStatus`\>; `status`: `"restoring"` \| `"ready"` \| `"error"` \| `"disposed"`; \}\>
+> **PersistenceSnapshot** = `Readonly`\<\{ `error?`: `Error`; `mutations`: `ReadonlyArray`\<[`PersistedMutationStatus`](PersistedMutationStatus.md)\>; `status`: `"restoring"` \| `"ready"` \| `"error"` \| `"disposed"`; \}\>
 
-Defined in: [packages/fate/src/persistence-types.ts:26](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/persistence-types.ts#L26)
+Defined in: [packages/fate/src/persistence-types.ts:28](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/persistence-types.ts#L28)

package/docs/api/type-aliases/Request.md

@@ -2,6 +2,6 @@
 
 > **Request** = `Record`\<`string`, `RequestItem`\>
 
-Defined in: [packages/fate/src/types.ts:377](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L377)
+Defined in: [packages/fate/src/types.ts:377](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L377)
 
 Collection of node and list requests describing the data a screen needs.

package/docs/api/type-aliases/RequestMode.md

@@ -2,6 +2,6 @@
 
 > **RequestMode** = `"cache-first"` \| `"stale-while-revalidate"` \| `"network-only"`
 
-Defined in: [packages/fate/src/client.ts:89](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L89)
+Defined in: [packages/fate/src/client.ts:96](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L96)
 
 Strategy used when resolving a request.

package/docs/api/type-aliases/RequestOptions.md

@@ -1,7 +1,7 @@
 # Type Alias: RequestOptions
 
-> **RequestOptions** = `Readonly`\<\{ `mode?`: [`RequestMode`](RequestMode.md); `persist?`: \{ `maxAge`: `number`; \}; \}\>
+> **RequestOptions** = `Readonly`\<\{ `mode?`: [`RequestMode`](RequestMode.md); `persist?`: [`RequestPersistenceOptions`](RequestPersistenceOptions.md); \}\>
 
-Defined in: [packages/fate/src/client.ts:100](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L100)
+Defined in: [packages/fate/src/client.ts:107](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L107)
 
 Request options that affect how requests are fetched and retained.

package/docs/api/type-aliases/RequestPersistenceOptions.md

@@ -0,0 +1,5 @@
+# Type Alias: RequestPersistenceOptions
+
+> **RequestPersistenceOptions** = `Readonly`\<\{ `maxAge`: `number`; \}\>
+
+Defined in: [packages/fate/src/persistence-types.ts:34](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/persistence-types.ts#L34)

package/docs/api/type-aliases/RequestResult.md

@@ -2,7 +2,7 @@
 
 > **RequestResult**\<`R`, `Q`\> = `{ [K in keyof Q]: K extends keyof R ? ListResult<Q[K], RootType<R[K]>, RootResult<R[K]>> : never }`
 
-Defined in: [packages/fate/src/types.ts:423](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L423)
+Defined in: [packages/fate/src/types.ts:423](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L423)
 
 The result of a `FateClient.request` and `useRequest` call, mapping each
 request key to its corresponding result.

package/docs/api/type-aliases/Selection.md

@@ -2,7 +2,7 @@
 
 > **Selection**\<`T`\> = `SelectionShape`\<`T`\> & `SelectionViewSpread`\<`T`\>
 
-Defined in: [packages/fate/src/types.ts:228](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L228)
+Defined in: [packages/fate/src/types.ts:228](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L228)
 
 Declarative selection of the fields a view needs from an entity.
 

package/docs/api/type-aliases/TypeConfig.md

@@ -2,7 +2,7 @@
 
 > **TypeConfig** = `object`
 
-Defined in: [packages/fate/src/types.ts:123](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L123)
+Defined in: [packages/fate/src/types.ts:123](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L123)
 
 Configuration for a server entity type used by the client cache.
 
@@ -12,7 +12,7 @@ Configuration for a server entity type used by the client cache.
 
 > `optional` **fields?**: `Record`\<`string`, `RelationDescriptor`\>
 
-Defined in: [packages/fate/src/types.ts:124](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L124)
+Defined in: [packages/fate/src/types.ts:124](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L124)
 
 ***
 
@@ -20,7 +20,7 @@ Defined in: [packages/fate/src/types.ts:124](https://github.com/nkzw-tech/fate/b
 
 > **getId**: (`record`) => `string` \| `number`
 
-Defined in: [packages/fate/src/types.ts:125](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L125)
+Defined in: [packages/fate/src/types.ts:125](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L125)
 
 #### Parameters
 
@@ -38,4 +38,4 @@ Defined in: [packages/fate/src/types.ts:125](https://github.com/nkzw-tech/fate/b
 
 > **type**: `string`
 
-Defined in: [packages/fate/src/types.ts:126](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L126)
+Defined in: [packages/fate/src/types.ts:126](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L126)

package/docs/api/type-aliases/View.md

@@ -2,7 +2,7 @@
 
 > **View**\<`T`, `S`\> = `Readonly`\<\{\[`viewTag`: `` `__fate-view__${string}` ``\]: `Readonly`\<\{ `[ViewKind]`: `true`; `select`: `S`; \}\>; \}\> & `__ViewEntityAnchor`\<`T`\> & `__ViewSelectionAnchor`\<`S`\>
 
-Defined in: [packages/fate/src/types.ts:244](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L244)
+Defined in: [packages/fate/src/types.ts:244](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L244)
 
 Definition of a view over an entity type, including the selection of fields.
 

package/docs/api/type-aliases/ViewData.md

@@ -2,7 +2,7 @@
 
 > **ViewData**\<`T`, `S`\> = `Readonly`\<`S` *extends* [`Selection`](Selection.md)\<`T`\> ? [`Mask`](Mask.md)\<`T`, `S`\> : `T` & `object`\>
 
-Defined in: [packages/fate/src/types.ts:260](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L260)
+Defined in: [packages/fate/src/types.ts:260](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L260)
 
 Data returned from a resolved view with masking applied and view tags
 attached for downstream composition.

package/docs/api/type-aliases/ViewEntity.md

@@ -2,7 +2,7 @@
 
 > **ViewEntity**\<`V`\> = `V` *extends* [`View`](View.md)\<infer T, `any`\> ? `T` : `never`
 
-Defined in: [packages/fate/src/types.ts:334](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L334)
+Defined in: [packages/fate/src/types.ts:334](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L334)
 
 Entity type captured from a view definition.
 

package/docs/api/type-aliases/ViewEntityName.md

@@ -2,7 +2,7 @@
 
 > **ViewEntityName**\<`V`\> = [`ViewEntity`](ViewEntity.md)\<`V`\>\[`"__typename"`\] & `string`
 
-Defined in: [packages/fate/src/types.ts:337](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L337)
+Defined in: [packages/fate/src/types.ts:337](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L337)
 
 Name of the entity type captured from a view definition.
 

package/docs/api/type-aliases/ViewRef.md

@@ -2,7 +2,7 @@
 
 > **ViewRef**\<`TName`\> = `Readonly`\<\{ `__typename`: `TName`; `[ViewsTag]`: `Set`\<`string`\>; `id`: `string` \| `number`; \}\>
 
-Defined in: [packages/fate/src/types.ts:107](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L107)
+Defined in: [packages/fate/src/types.ts:107](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L107)
 
 Reference to a normalized entity instance that can be resolved against one or more view tags.
 

package/docs/api/type-aliases/ViewSelection.md

@@ -2,7 +2,7 @@
 
 > **ViewSelection**\<`V`\> = `V` *extends* `object` ? `S` : `never`
 
-Defined in: [packages/fate/src/types.ts:340](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L340)
+Defined in: [packages/fate/src/types.ts:340](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L340)
 
 Selection captured from a view definition.
 

package/docs/api/type-aliases/ViewSnapshot.md

@@ -2,7 +2,7 @@
 
 > **ViewSnapshot**\<`T`, `S`\> = `Readonly`\<\{ `coverage`: `ReadonlyArray`\<readonly \[[`EntityId`](EntityId.md), `ReadonlySet`\<`string`\>\]\>; `data`: [`ViewData`](ViewData.md)\<`T`, `S`\>; \}\>
 
-Defined in: [packages/fate/src/types.ts:270](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L270)
+Defined in: [packages/fate/src/types.ts:270](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L270)
 
 Snapshot returned by the cache for a view, including the masked data and all
 referenced entity IDs.

package/docs/api/type-aliases/ViewTag.md

@@ -2,6 +2,6 @@
 
 > **ViewTag** = `` `__fate-view__${string}` ``
 
-Defined in: [packages/fate/src/types.ts:55](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L55)
+Defined in: [packages/fate/src/types.ts:55](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L55)
 
 Unique key that identifies a view composition entry inside a selection or reference.

package/docs/api/variables/ConnectionTag.md

@@ -2,6 +2,6 @@
 
 > `const` **ConnectionTag**: *typeof* `ConnectionTag`
 
-Defined in: [packages/fate/src/types.ts:19](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L19)
+Defined in: [packages/fate/src/types.ts:19](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L19)
 
 Symbol attached to connection results so pagination helpers can find their metadata.

package/docs/api/variables/DeferTag.md

@@ -2,6 +2,6 @@
 
 > `const` **DeferTag**: *typeof* `DeferTag`
 
-Defined in: [packages/fate/src/types.ts:22](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L22)
+Defined in: [packages/fate/src/types.ts:22](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L22)
 
 Symbol used to mark a selection as deferred.

package/docs/api/variables/DeferredTag.md

@@ -2,6 +2,6 @@
 
 > `const` **DeferredTag**: *typeof* `DeferredTag`
 
-Defined in: [packages/fate/src/types.ts:25](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L25)
+Defined in: [packages/fate/src/types.ts:25](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L25)
 
 Symbol attached to deferred values returned from masked views.

package/docs/guide/persistence.md

@@ -16,13 +16,13 @@ Then pass `persistence` when creating the client:
 
 ```tsx
 import { createPersistence } from '@nkzw/fate/persistence';
-import { indexedDB } from '@nkzw/fate-indexeddb';
+import { createIndexedDBStorage } from '@nkzw/fate-indexeddb';
 import { createFateClient } from 'react-fate/client';
 
 const fate = createFateClient({
   persistence: createPersistence({
     key: `workspace:${workspaceId}:user:${userId}`,
-    storage: indexedDB(),
+    storage: createIndexedDBStorage(),
   }),
   url: '/api/fate',
 });
@@ -35,7 +35,7 @@ persistence: createPersistence({
   key: `workspace:${workspaceId}:user:${userId}`,
   maxAge: 24 * 60 * 60 * 1000,
   maxBytes: 25 * 1024 * 1024,
-  storage: indexedDB(),
+  storage: createIndexedDBStorage(),
 }),
 ```
 
@@ -207,7 +207,7 @@ const durableHTTP = createHTTPTransport<MyAPI>({
 
 const fate = createFateClient({
   // ...your generated tRPC or GraphQL client options...
-  persistence: createPersistence({ key: accountKey, storage: indexedDB() }),
+  persistence: createPersistence({ key: accountKey, storage: createIndexedDBStorage() }),
   mutateDurably: durableHTTP.mutateDurably,
 });
 ```
@@ -297,7 +297,6 @@ The core persistence layer has no IndexedDB dependency. You can use another back
 ```ts
 interface PersistenceStorage {
   read(key: string): Promise<unknown>;
-  write(key: string, value: unknown): Promise<void>;
   scan(
     prefix: string,
     after?: string,
@@ -312,9 +311,8 @@ interface PersistenceStorage {
 Values use fate's hydration codec and can be stored as JSON. The adapter handles storage and coordination:
 
 - `read` returns the saved value for a key.
-- `write` replaces one value atomically and resolves after it has committed.
 - `scan` returns keys under a prefix in ascending order, strictly after the optional cursor, up to the limit (64 by default). Use your backend's ordered index to keep each scan small.
-- `writeBatch` commits all entries atomically. An `undefined` value deletes the key.
+- `writeBatch` commits all entries atomically and resolves after they have committed. An `undefined` value deletes the key. Use a one-entry batch for a single write.
 - `exclusive` coordinates every tab or process sharing the backend. Different lock names are independent: fate holds a delivery lock during network work and acquires a separate write lock when updating storage. Your adapter must allow that nesting.
 - `subscribe` notifies other clients after a change commits, including keys changed by `writeBatch`. Without notifications, clients check saved mutations during delivery attempts and explicit `retry()` calls.
 

package/lib/{executor-DoiTBiVv.d.mts → executor-oPTYqgQV.d.mts}

@@ -1,4 +1,4 @@
-import { st as QueryProcedure, v as AnyRecord } from "./transport-DqjhjLfC.mjs";
+import { b as AnyRecord, lt as QueryProcedure } from "./transport-DR0fwleU.mjs";
 import { z } from "zod";
 //#region src/server/dataView.d.ts
 declare const dataViewFieldsKey: unique symbol;

package/lib/{graphqlTransport-DGLYyRxL.d.mts → graphqlTransport-CGYE4NdD.d.mts}

@@ -1,4 +1,4 @@
-import { D as Entity, G as TypeConfig, R as MutationShape, t as Transport } from "./transport-DqjhjLfC.mjs";
+import { B as MutationShape, k as Entity, q as TypeConfig, t as Transport } from "./transport-DR0fwleU.mjs";
 //#region src/graphqlTransport.d.ts
 type TransportMutations = Record<string, MutationShape>;
 type EmptyTransportMutations = Record<never, MutationShape>;

package/lib/graphqlTransport.d.mts

@@ -1,2 +1,2 @@
-import { a as GraphQLTransportOptions, i as GraphQLMutationOutput, n as GraphQLMutationInput, o as createGraphQLTransport, r as GraphQLMutationMap, s as graphqlMutation, t as GraphQLMutationDefinition } from "./graphqlTransport-DGLYyRxL.mjs";
+import { a as GraphQLTransportOptions, i as GraphQLMutationOutput, n as GraphQLMutationInput, o as createGraphQLTransport, r as GraphQLMutationMap, s as graphqlMutation, t as GraphQLMutationDefinition } from "./graphqlTransport-CGYE4NdD.mjs";
 export { GraphQLMutationDefinition, GraphQLMutationInput, GraphQLMutationMap, GraphQLMutationOutput, GraphQLTransportOptions, createGraphQLTransport, graphqlMutation };

package/lib/idempotency-types-DuqJ7KSd.d.mts

@@ -0,0 +1,16 @@
+import { r as MutationIdentity } from "./transport-DR0fwleU.mjs";
+//#region src/server/idempotency-types.d.ts
+/** Server enforcement for a durable mutation. The resolver must use the supplied context. */
+interface MutationIdempotency<Context> {
+  execute<Result>(options: MutationIdempotencyOptions<Context, Result>): Promise<Result>;
+}
+type MutationIdempotencyOptions<Context, Result> = Readonly<{
+  ctx: Context;
+  identity: MutationIdentity;
+  input: unknown;
+  name: string;
+  resolve(ctx: Context): Promise<Result>;
+  select: ReadonlyArray<string>;
+}>;
+//#endregion
+export { MutationIdempotencyOptions as n, MutationIdempotency as t };

package/lib/idempotency.d.mts

@@ -1,5 +1,5 @@
-import { h as encodeHydrationValue } from "./transport-DqjhjLfC.mjs";
-import { t as MutationIdempotency } from "./idempotency-types-CqA-BFpn.mjs";
+import { _ as encodeHydrationValue } from "./transport-DR0fwleU.mjs";
+import { n as MutationIdempotencyOptions, t as MutationIdempotency } from "./idempotency-types-DuqJ7KSd.mjs";
 //#region src/idempotency.d.ts
 type MutationReceipt = Readonly<{
   fingerprint: string;
@@ -10,17 +10,17 @@ type MutationReceipt = Readonly<{
  * The adapter must serialize concurrent calls for the same scope and ID,
  * including calls from different processes. Receipts must not expire.
  */
-interface IdempotencyStore<Context> {
+interface IdempotencyStore<Context, TransactionContext extends Context = Context> {
   transaction<T>(context: Context, scope: string, id: string, run: (transaction: {
-    context: Context;
+    context: TransactionContext;
     read(): Promise<MutationReceipt | undefined>;
     write(receipt: MutationReceipt): Promise<void>;
   }) => Promise<T>): Promise<T>;
 }
 /** Enforces durable deduplication using the application's own transaction adapter. */
-declare function createMutationIdempotency<Context>(options: {
+declare function createMutationIdempotency<Context, TransactionContext extends Context = Context>(options: {
   scope(context: Context): string | Promise<string>;
-  store: IdempotencyStore<Context>;
+  store: IdempotencyStore<Context, TransactionContext>;
 }): MutationIdempotency<Context>;
 //#endregion
-export { IdempotencyStore, type MutationIdempotency, MutationReceipt, createMutationIdempotency };
+export { IdempotencyStore, type MutationIdempotency, type MutationIdempotencyOptions, MutationReceipt, createMutationIdempotency };

package/lib/index.d.mts

@@ -1,7 +1,7 @@
-import { $ as ViewSnapshot, A as FateThenable, B as Pagination, C as Deferred, D as Entity, E as DeferredTag, F as MutationIdentifier, G as TypeConfig, H as RequestResult, I as MutationInput, J as ViewData, K as TypeName, L as MutationResult, M as Mask, N as MutationDefinition, O as EntityId, P as MutationEntity, Q as ViewSelection, R as MutationShape, S as DeferTag, T as DeferredSelection, U as RootDefinition, V as Request$1, W as Selection, X as ViewEntityName, Y as ViewEntity, Z as ViewRef, _ as getSelectionPlan, a as PersistenceSession, at as mutation, b as ConnectionRef, c as FateClient, d as createClient, et as ViewTag, f as FateDehydratedState, g as List, i as Persistence, it as FateMutations, j as ListItem, k as FateRoots, l as RequestMode, m as HydrationLimits, n as createTRPCTransport, nt as __FateSelectionBrand, o as PersistenceSnapshot, p as HydrateOptions, q as View, r as MutationIdentity, rt as isViewTag, s as DeferredSnapshot, t as Transport, tt as __FateEntityBrand, u as RequestOptions, v as AnyRecord, w as DeferredMetadata, x as ConnectionTag, y as ConnectionMetadata, z as NodesItem } from "./transport-DqjhjLfC.mjs";
-import { a as GraphQLTransportOptions, i as GraphQLMutationOutput, n as GraphQLMutationInput, o as createGraphQLTransport, r as GraphQLMutationMap, s as graphqlMutation, t as GraphQLMutationDefinition } from "./graphqlTransport-DGLYyRxL.mjs";
-import { C as liveGlobalConnectionTopic, S as liveEntityTopic, a as FateProtocolRequest, i as FateOperation, n as FateLiveConnectionEvent, o as FateProtocolResponse, r as FateLiveEvent, t as isRecord, u as InferFateAPI, x as liveConnectionTopic } from "./record-DITM4zb_.mjs";
-import { n as getListEntries, t as ListEntry } from "./list-BRT1VtiT.mjs";
+import { $ as ViewRef, A as EntityId, B as MutationShape, C as ConnectionTag, D as DeferredSelection, E as DeferredMetadata, F as MutationDefinition, G as RootDefinition, H as Pagination, I as MutationEntity, J as TypeName, K as Selection, L as MutationIdentifier, M as FateThenable, N as ListItem, O as DeferredTag, P as Mask, Q as ViewEntityName, R as MutationInput, S as ConnectionRef, T as Deferred, U as Request$1, V as NodesItem, W as RequestResult, X as ViewData, Y as View, Z as ViewEntity, a as Persistence, at as isViewTag, b as AnyRecord, c as RequestPersistenceOptions, d as RequestMode, et as ViewSelection, f as RequestOptions, g as HydrationLimits, h as HydrateOptions, i as PersistedMutationStatus, it as __FateSelectionBrand, j as FateRoots, k as Entity, l as DeferredSnapshot, m as FateDehydratedState, n as createTRPCTransport, nt as ViewTag, o as PersistenceSession, ot as FateMutations, p as createClient, q as TypeConfig, r as MutationIdentity, rt as __FateEntityBrand, s as PersistenceSnapshot, st as mutation, t as Transport, tt as ViewSnapshot, u as FateClient, v as List, w as DeferTag, x as ConnectionMetadata, y as getSelectionPlan, z as MutationResult } from "./transport-DR0fwleU.mjs";
+import { a as GraphQLTransportOptions, i as GraphQLMutationOutput, n as GraphQLMutationInput, o as createGraphQLTransport, r as GraphQLMutationMap, s as graphqlMutation, t as GraphQLMutationDefinition } from "./graphqlTransport-CGYE4NdD.mjs";
+import { C as liveGlobalConnectionTopic, S as liveEntityTopic, a as FateProtocolRequest, i as FateOperation, n as FateLiveConnectionEvent, o as FateProtocolResponse, r as FateLiveEvent, t as isRecord, u as InferFateAPI, x as liveConnectionTopic } from "./record-Dxjvpsep.mjs";
+import { n as getListEntries, t as ListEntry } from "./list-5hrTVoiB.mjs";
 //#region src/defer.d.ts
 declare function defer<S>(selection: S): DeferredSelection<S>;
 declare const isDeferred: (value: unknown) => value is Deferred<unknown>;
@@ -84,4 +84,4 @@ type SelectionValidation<T extends Entity, S extends Selection<T>> = Exclude<key
  */
 declare function view<T extends Entity>(): <S extends Selection<T>>(select: S & SelectionValidation<T, S>) => View<T, S>;
 //#endregion
-export { type ConnectionMetadata, type ConnectionRef, ConnectionTag, DeferTag, type Deferred, type DeferredMetadata, type DeferredSelection, type DeferredSnapshot, DeferredTag, type Entity, type EntityId, FateClient, type FateDehydratedState, type FateLiveConnectionEvent, type FateLiveEvent, type FateMutations, type FateOperation, type FateProtocolRequest, type FateProtocolResponse, type AnyRecord as FateRecord, type FateRoots, type FateThenable, type GraphQLMutationDefinition, type GraphQLMutationInput, type GraphQLMutationMap, type GraphQLMutationOutput, type GraphQLTransportOptions, type HydrateOptions, type HydrationLimits, type InferFateAPI, type List, type ListEntry, type ListItem, type Mask, type MutationDefinition, type MutationEntity, type MutationIdentifier, type MutationIdentity, type MutationInput, type MutationResult, type NodesItem, type Pagination, type Persistence, type PersistenceSession, type PersistenceSnapshot, type Request$1 as Request, type RequestMode, type RequestOptions, type RequestResult, type Selection, type Transport, type TypeConfig, type View, type ViewData, type ViewEntity, type ViewEntityName, type ViewRef, type ViewSelection, type ViewSnapshot, type ViewTag, clientRoot, createClient, createGraphQLTransport, createHTTPTransport, createTRPCTransport, defer, getDeferredMetadata, getListEntries, getSelectionPlan, graphqlMutation, isDeferred, isRecord, isViewTag, liveConnectionTopic, liveEntityTopic, liveGlobalConnectionTopic, mutation, toEntityId, view };
+export { type ConnectionMetadata, type ConnectionRef, ConnectionTag, DeferTag, type Deferred, type DeferredMetadata, type DeferredSelection, type DeferredSnapshot, DeferredTag, type Entity, type EntityId, FateClient, type FateDehydratedState, type FateLiveConnectionEvent, type FateLiveEvent, type FateMutations, type FateOperation, type FateProtocolRequest, type FateProtocolResponse, type AnyRecord as FateRecord, type FateRoots, type FateThenable, type GraphQLMutationDefinition, type GraphQLMutationInput, type GraphQLMutationMap, type GraphQLMutationOutput, type GraphQLTransportOptions, type HydrateOptions, type HydrationLimits, type InferFateAPI, type List, type ListEntry, type ListItem, type Mask, type MutationDefinition, type MutationEntity, type MutationIdentifier, type MutationIdentity, type MutationInput, type MutationResult, type NodesItem, type Pagination, type PersistedMutationStatus, type Persistence, type PersistenceSession, type PersistenceSnapshot, type Request$1 as Request, type RequestMode, type RequestOptions, type RequestPersistenceOptions, type RequestResult, type Selection, type Transport, type TypeConfig, type View, type ViewData, type ViewEntity, type ViewEntityName, type ViewRef, type ViewSelection, type ViewSnapshot, type ViewTag, clientRoot, createClient, createGraphQLTransport, createHTTPTransport, createTRPCTransport, defer, getDeferredMetadata, getListEntries, getSelectionPlan, graphqlMutation, isDeferred, isRecord, isViewTag, liveConnectionTopic, liveEntityTopic, liveGlobalConnectionTopic, mutation, toEntityId, view };

package/lib/index.mjs

@@ -1,7 +1,7 @@
 import { t as isRecord } from "./record-B07VwXd-.mjs";
 import { a as hashArgs, c as scopeArgsPayload, i as filterConnectionArgs, r as combineArgsPayload, s as resolvedArgsFromPlan, t as applyArgsPayloadToPlan } from "./args-CRLIRl_v.mjs";
 import { _ as isNodesItem, a as createNodeRef, c as ConnectionTag, f as RootKind, g as isNodeItem, i as resolveHydrationLimits, l as DeferTag, m as ViewsTag, o as getNodeRefId, r as encodeHydrationValue, s as isNodeRef, t as decodeClientHydrationState, u as DeferredTag, v as isQueryItem, y as isViewTag } from "./hydration-DPZRJgnu.mjs";
-import { C as isDeferredSelection, S as isDeferred, _ as view, a as mutation, b as getDeferredMetadata, c as getDeferredSelectionPlan, d as createRefWithViewNames, f as getRootViewNames, g as getViewPayloads, h as getViewNames, l as getSelectionPlan, m as toEntityId, n as getListKey, p as parseEntityId, r as mergePreservingExisting, s as wrapMutation, t as Store, u as assignViewTag, v as createDeferred, x as getDeferredSelection, y as defer } from "./store-CeatPJeK.mjs";
+import { C as isDeferredSelection, S as isDeferred, _ as view, a as mutation, b as getDeferredMetadata, c as getDeferredSelectionPlan, d as createRefWithViewNames, f as getRootViewNames, g as getViewPayloads, h as getViewNames, l as getSelectionPlan, m as toEntityId, n as getListKey, p as parseEntityId, r as mergePreservingExisting, s as wrapMutation, t as Store, u as assignViewTag, v as createDeferred, x as getDeferredSelection, y as defer } from "./store-CakBBzWG.mjs";
 import { t as getListEntries } from "./list-_6fXYLtJ.mjs";
 import { n as errorCodeFromStatus, t as FateRequestError } from "./protocol-DS5sf6sd.mjs";
 import { n as graphqlMutation, t as createGraphQLTransport } from "./graphqlTransport-DmheG3AO.mjs";
@@ -478,7 +478,7 @@ var FateClient = class {
 		this.store = new Store((ids) => {
 			for (const id of ids) this.viewDataCache.invalidate(id);
 			this.runPendingGarbageCollection();
-		}, (kind, key, paths, previousList) => this.persistence?.changed(kind, key, paths, previousList));
+		}, (change) => this.persistenceRuntime?.changed(change));
 		this.viewDataCache = new ViewDataCache(() => !this.store.isRebasing);
 		this.liveConnectionInvalidationToken = 0;
 		this.persistenceDisposal = options.persistence ? new AbortController() : void 0;
@@ -508,7 +508,8 @@ var FateClient = class {
 			setNestedValue(this.actions, key, async (_previousState, data) => data === "reset" ? null : await this.mutationMap[key](data));
 		}
 		this.initializeParentLists();
-		this.persistence = options.persistence?.attach(this);
+		this.persistenceRuntime = options.persistence?.attach(this);
+		this.persistence = this.persistenceRuntime;
 	}
 	initializeParentLists() {
 		for (const config of this.types.values()) {
@@ -704,6 +705,11 @@ var FateClient = class {
 		if (this.mutationEntities?.size) this.requireDurableMutationTransport();
 	}
 	/** @internal */
+	persistMutation(command) {
+		if (!this.persistenceRuntime) throw new Error("fate: Persistence is not configured.");
+		return this.persistenceRuntime.mutate(command);
+	}
+	/** @internal */
 	assertPersistenceActive() {
 		if (this.persistenceDisposal?.signal.aborted || this.persistence?.getSnapshot().status === "disposed") throw new Error("fate: Persistence was disposed.");
 	}
@@ -828,7 +834,8 @@ var FateClient = class {
 			const pendingPromise = this.pending.get(key) || null;
 			if (pendingPromise) return pendingPromise;
 			const promise = this.trackPendingRequest(async () => {
-				if (this.persistence) {
+				const persistence = this.persistenceRuntime;
+				if (persistence) {
 					const persistedRequest = {
 						items: [{
 							ids: [id],
@@ -841,11 +848,11 @@ var FateClient = class {
 						}],
 						key: `view:${key}`
 					};
-					await this.persistence.restoreRequest(persistedRequest);
+					await persistence.restoreRequest(persistedRequest);
 					const remaining = this.store.missingForSelection(entityId, selectedPaths);
 					if (remaining.size) {
 						await this.fetchByIdAndNormalize(type, [id], remaining, plan);
-						this.persistence.fetched({
+						persistence.fetched({
 							...persistedRequest,
 							items: persistedRequest.items.map((item) => ({
 								...item,
@@ -1433,15 +1440,16 @@ var FateClient = class {
 	}
 	requestWithDescriptor(descriptor, mode, { revalidateExisting }, options) {
 		this.assertPersistenceActive();
-		if (this.persistence && options?.persist && (!Number.isSafeInteger(options.persist.maxAge) || options.persist.maxAge < 0 || options.persist.maxAge > Number.MAX_SAFE_INTEGER - Date.now())) throw new Error("fate: Persistence maxAge must be a non-negative finite duration.");
+		const persistence = this.persistenceRuntime;
+		if (persistence && options?.persist && (!Number.isSafeInteger(options.persist.maxAge) || options.persist.maxAge < 0 || options.persist.maxAge > Number.MAX_SAFE_INTEGER - Date.now())) throw new Error("fate: Persistence maxAge must be a non-negative finite duration.");
 		const requestKey = descriptor.key;
 		const existingRequest = this.requests.get(requestKey)?.get(mode);
 		if (existingRequest) {
-			if (this.persistence && options?.persist) {
+			if (persistence && options?.persist) {
 				const executionOptions = this.requestExecutionOptions.get(existingRequest.descriptor);
 				if (executionOptions) executionOptions.persist = { ...options.persist };
 			}
-			if (this.persistence && options?.persist && existingRequest.status === "fulfilled") this.persistence.used(existingRequest.descriptor, options.persist);
+			if (persistence && options?.persist && existingRequest.status === "fulfilled") persistence.used(existingRequest.descriptor, options.persist);
 			const isFulfilledCacheFirstWithMissingData = mode === "cache-first" && existingRequest.status === "fulfilled" && !this.hasRequestData(existingRequest.descriptor);
 			if (existingRequest.status !== "pending" && (isFulfilledCacheFirstWithMissingData || revalidateExisting && (mode === "network-only" || mode === "stale-while-revalidate" || mode === "cache-first" && existingRequest.status === "rejected"))) this.executeRequestHandle(existingRequest, mode, options);
 			return existingRequest;
@@ -1562,17 +1570,18 @@ var FateClient = class {
 		}
 	}
 	executeRequestHandle(handle, mode, options) {
+		const persistence = this.persistenceRuntime;
 		const executionOptions = {
 			fetchAll: mode !== "cache-first",
 			persist: options?.persist ? { ...options.persist } : void 0
 		};
-		if (this.persistence) this.requestExecutionOptions.set(handle.descriptor, executionOptions);
+		if (persistence) this.requestExecutionOptions.set(handle.descriptor, executionOptions);
 		const execute = () => {
 			this.assertPersistenceActive();
 			if (mode === "stale-while-revalidate") return this.handleStoreAndNetworkRequest(handle.descriptor, executionOptions);
 			return this.executeRequest(handle.descriptor, executionOptions).then(() => this.getRequestResultFromDescriptor(handle.descriptor));
 		};
-		handle.start(this.persistence ? this.withPersistenceLifecycle(() => this.persistence.ready.then(() => mode === "network-only" ? void 0 : this.persistence.restoreRequest(handle.descriptor)).then(execute)) : execute());
+		handle.start(persistence ? this.withPersistenceLifecycle(() => persistence.ready.then(() => mode === "network-only" ? void 0 : persistence.restoreRequest(handle.descriptor)).then(execute)) : execute());
 	}
 	markRecordReferences(record, markRecord) {
 		const seen = /* @__PURE__ */ new Set();
@@ -1625,7 +1634,7 @@ var FateClient = class {
 				return await this.withPersistenceLifecycle(request);
 			} finally {
 				this.pendingNetworkRequests -= 1;
-				this.persistence?.changed();
+				this.persistenceRuntime?.changed();
 			}
 		});
 	}
@@ -1714,12 +1723,13 @@ var FateClient = class {
 			fetchedItems.push(item);
 		}
 		await Promise.all([...promises, ...Array.from(groups.values()).map((group) => group.ids.length ? this.fetchByIdAndNormalize(group.type, group.ids, group.fields, group.plan) : Promise.resolve())]);
-		if (this.persistence) {
-			if (fetchedItems.length) this.persistence.fetched(fetchedAll ? request : {
+		const persistence = this.persistenceRuntime;
+		if (persistence) {
+			if (fetchedItems.length) persistence.fetched(fetchedAll ? request : {
 				items: fetchedItems,
 				key: `partial:${JSON.stringify([request.key, fetchedItems.map((item) => [item.name, "ids" in item ? item.ids : null])])}`
 			}, options.persist);
-			if (!fetchedItems.length || !fetchedAll) this.persistence.used(request, options.persist);
+			if (!fetchedItems.length || !fetchedAll) persistence.used(request, options.persist);
 		}
 	}
 	hasRequestData(request) {

package/lib/{list-BRT1VtiT.d.mts → list-5hrTVoiB.d.mts}

@@ -1,4 +1,4 @@
-import { O as EntityId, g as List } from "./transport-DqjhjLfC.mjs";
+import { A as EntityId, v as List } from "./transport-DR0fwleU.mjs";
 //#region src/list.d.ts
 type ListEntry = Readonly<{
   cursor?: string;

package/lib/list.d.mts

@@ -1,2 +1,2 @@
-import { n as getListEntries, t as ListEntry } from "./list-BRT1VtiT.mjs";
+import { n as getListEntries, t as ListEntry } from "./list-5hrTVoiB.mjs";
 export { ListEntry, getListEntries };