@nkzw/fate 1.5.0 → 1.5.1

package/README.md

@@ -1354,13 +1354,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',
 });
@@ -1373,7 +1373,7 @@ persistence: createPersistence({
   key: `workspace:${workspaceId}:user:${userId}`,
   maxAge: 24 * 60 * 60 * 1000,
   maxBytes: 25 * 1024 * 1024,
-  storage: indexedDB(),
+  storage: createIndexedDBStorage(),
 }),
 ```
 
@@ -1545,7 +1545,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,
 });
 ```
@@ -1635,7 +1635,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,
@@ -1650,9 +1649,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/docs/api/classes/FateClient.md

@@ -1,6 +1,6 @@
 # Class: FateClient\<Roots, Mutations, HydrationScope\>
 
-Defined in: [packages/fate/src/client.ts:419](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L419)
+Defined in: [packages/fate/src/client.ts:426](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L426)
 
 Core client that normalizes records, manages the view cache, and coordinates
 data fetching.
@@ -25,7 +25,7 @@ data fetching.
 
 > **new FateClient**\<`Roots`, `Mutations`, `HydrationScope`\>(`options`): `FateClient`\<`Roots`, `Mutations`, `HydrationScope`\>
 
-Defined in: [packages/fate/src/client.ts:479](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L479)
+Defined in: [packages/fate/src/client.ts:487](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L487)
 
 #### Parameters
 
@@ -43,7 +43,7 @@ Defined in: [packages/fate/src/client.ts:479](https://github.com/nkzw-tech/fate/
 
 > `readonly` **actions**: `MutationTreeFromRecord`\<`Mutations`\>
 
-Defined in: [packages/fate/src/client.ts:475](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L475)
+Defined in: [packages/fate/src/client.ts:483](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L483)
 
 ***
 
@@ -51,7 +51,7 @@ Defined in: [packages/fate/src/client.ts:475](https://github.com/nkzw-tech/fate/
 
 > `readonly` **mutations**: `MutationTreeFromRecord`\<`Mutations`\>
 
-Defined in: [packages/fate/src/client.ts:476](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L476)
+Defined in: [packages/fate/src/client.ts:484](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L484)
 
 ***
 
@@ -59,7 +59,7 @@ Defined in: [packages/fate/src/client.ts:476](https://github.com/nkzw-tech/fate/
 
 > `readonly` `optional` **persistence?**: [`PersistenceSession`](../interfaces/PersistenceSession.md)
 
-Defined in: [packages/fate/src/client.ts:474](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L474)
+Defined in: [packages/fate/src/client.ts:482](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L482)
 
 ***
 
@@ -67,7 +67,7 @@ Defined in: [packages/fate/src/client.ts:474](https://github.com/nkzw-tech/fate/
 
 > `readonly` **roots**: `Roots`
 
-Defined in: [packages/fate/src/client.ts:477](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L477)
+Defined in: [packages/fate/src/client.ts:485](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L485)
 
 ***
 
@@ -75,7 +75,7 @@ Defined in: [packages/fate/src/client.ts:477](https://github.com/nkzw-tech/fate/
 
 > `readonly` **store**: `Store`
 
-Defined in: [packages/fate/src/client.ts:456](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L456)
+Defined in: [packages/fate/src/client.ts:464](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L464)
 
 ## Methods
 
@@ -83,7 +83,7 @@ Defined in: [packages/fate/src/client.ts:456](https://github.com/nkzw-tech/fate/
 
 > **assertLiveConnectionSupport**(): `void`
 
-Defined in: [packages/fate/src/client.ts:1258](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1258)
+Defined in: [packages/fate/src/client.ts:1276](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1276)
 
 #### Returns
 
@@ -95,7 +95,7 @@ Defined in: [packages/fate/src/client.ts:1258](https://github.com/nkzw-tech/fate
 
 > **assertLiveViewSupport**(): `void`
 
-Defined in: [packages/fate/src/client.ts:1250](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1250)
+Defined in: [packages/fate/src/client.ts:1268](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1268)
 
 #### Returns
 
@@ -107,7 +107,7 @@ Defined in: [packages/fate/src/client.ts:1250](https://github.com/nkzw-tech/fate
 
 > **dehydrate**(): [`FateDehydratedState`](../type-aliases/FateDehydratedState.md)\<`HydrationScope`\>
 
-Defined in: [packages/fate/src/client.ts:581](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L581)
+Defined in: [packages/fate/src/client.ts:590](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L590)
 
 Exports the durable normalized cache as an opaque JSON-safe value for SSR
 transfer or persistence. Runtime requests, subscriptions, retainers, and
@@ -123,7 +123,7 @@ optimistic state are intentionally excluded.
 
 > **deleteRecord**(`type`, `id`): `void`
 
-Defined in: [packages/fate/src/client.ts:933](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L933)
+Defined in: [packages/fate/src/client.ts:950](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L950)
 
 #### Parameters
 
@@ -145,7 +145,7 @@ Defined in: [packages/fate/src/client.ts:933](https://github.com/nkzw-tech/fate/
 
 > **executeMutation**(`key`, `input`, `select`, `options?`): `Promise`\<`unknown`\>
 
-Defined in: [packages/fate/src/client.ts:885](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L885)
+Defined in: [packages/fate/src/client.ts:902](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L902)
 
 #### Parameters
 
@@ -185,7 +185,7 @@ Defined in: [packages/fate/src/client.ts:885](https://github.com/nkzw-tech/fate/
 
 > **gc**(): `void`
 
-Defined in: [packages/fate/src/client.ts:2221](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2221)
+Defined in: [packages/fate/src/client.ts:2240](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2240)
 
 Removes records and lists that are not reachable from retained requests or
 the release buffer.
@@ -204,7 +204,7 @@ memory-management flows.
 
 > **getRequestKey**(`request`): `string`
 
-Defined in: [packages/fate/src/client.ts:2505](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2505)
+Defined in: [packages/fate/src/client.ts:2525](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2525)
 
 #### Parameters
 
@@ -222,7 +222,7 @@ Defined in: [packages/fate/src/client.ts:2505](https://github.com/nkzw-tech/fate
 
 > **getRequestResult**\<`R`\>(`request`): [`RequestResult`](../type-aliases/RequestResult.md)\<`Roots`, `R`\>
 
-Defined in: [packages/fate/src/client.ts:2681](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2681)
+Defined in: [packages/fate/src/client.ts:2702](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2702)
 
 #### Type Parameters
 
@@ -246,7 +246,7 @@ Defined in: [packages/fate/src/client.ts:2681](https://github.com/nkzw-tech/fate
 
 > **getTypeConfig**(`type`): [`TypeConfig`](../type-aliases/TypeConfig.md)
 
-Defined in: [packages/fate/src/client.ts:830](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L830)
+Defined in: [packages/fate/src/client.ts:839](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L839)
 
 #### Parameters
 
@@ -264,7 +264,7 @@ Defined in: [packages/fate/src/client.ts:830](https://github.com/nkzw-tech/fate/
 
 > **hydrate**(`state`, `options?`): `void`
 
-Defined in: [packages/fate/src/client.ts:608](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L608)
+Defined in: [packages/fate/src/client.ts:617](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L617)
 
 Restores a durable normalized cache snapshot without restoring runtime
 request handles, retainers, subscriptions, or optimistic update state.
@@ -290,7 +290,7 @@ Hydrate before rendering SSR content. Replaying the same snapshot is safe.
 
 > **loadConnection**\<`V`\>(`view`, `connection`, `args`, `options?`): `Promise`\<`Readonly`\<\{ `backwardPageLimit?`: `number`; `cursors?`: readonly (`string` \| `undefined`)[]; `forwardPageLimit?`: `number`; `ids`: readonly `string`[]; `liveAfterIds?`: readonly `string`[]; `liveBeforeIds?`: readonly `string`[]; `pagination?`: [`Pagination`](../type-aliases/Pagination.md); `pendingAfterIds?`: readonly `string`[]; `pendingBeforeIds?`: readonly `string`[]; \}\> \| `undefined`\>
 
-Defined in: [packages/fate/src/client.ts:1910](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1910)
+Defined in: [packages/fate/src/client.ts:1928](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1928)
 
 #### Type Parameters
 
@@ -328,7 +328,7 @@ Defined in: [packages/fate/src/client.ts:1910](https://github.com/nkzw-tech/fate
 
 > **prepareRequestForRender**\<`R`\>(`request`, `options`): `Readonly`\<\{ `promise`: `Promise`\<[`RequestResult`](../type-aliases/RequestResult.md)\<`Roots`, `R`\>\>; `requestKey`: `string`; \}\>
 
-Defined in: [packages/fate/src/client.ts:2083](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2083)
+Defined in: [packages/fate/src/client.ts:2101](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2101)
 
 #### Type Parameters
 
@@ -344,7 +344,7 @@ Defined in: [packages/fate/src/client.ts:2083](https://github.com/nkzw-tech/fate
 
 ##### options
 
-`Readonly`\<\{ `mode?`: [`RequestMode`](../type-aliases/RequestMode.md); `persist?`: \{ `maxAge`: `number`; \}; \}\> \| `undefined`
+`Readonly`\<\{ `mode?`: [`RequestMode`](../type-aliases/RequestMode.md); `persist?`: `Readonly`\<\{ `maxAge`: `number`; \}\>; \}\> \| `undefined`
 
 #### Returns
 
@@ -356,7 +356,7 @@ Defined in: [packages/fate/src/client.ts:2083](https://github.com/nkzw-tech/fate
 
 > **readDeferred**\<`T`\>(`deferred`): `PromiseLike`\<`Readonly`\<\{ `coverage`: readonly readonly \[`string`, `ReadonlySet`\<`string`\>\][]; `data`: `T`; \}\>\>
 
-Defined in: [packages/fate/src/client.ts:1153](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1153)
+Defined in: [packages/fate/src/client.ts:1171](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1171)
 
 #### Type Parameters
 
@@ -380,7 +380,7 @@ Defined in: [packages/fate/src/client.ts:1153](https://github.com/nkzw-tech/fate
 
 > **readView**\<`T`, `S`, `V`\>(`view`, `ref`): [`FateThenable`](../interfaces/FateThenable.md)\<`Readonly`\<\{ `coverage`: readonly readonly \[`string`, `ReadonlySet`\<`string`\>\][]; `data`: [`ViewData`](../type-aliases/ViewData.md)\<`T`, `S`\>; \}\>\>
 
-Defined in: [packages/fate/src/client.ts:980](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L980)
+Defined in: [packages/fate/src/client.ts:997](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L997)
 
 #### Type Parameters
 
@@ -416,7 +416,7 @@ Defined in: [packages/fate/src/client.ts:980](https://github.com/nkzw-tech/fate/
 
 > **ref**\<`T`\>(`type`, `id`, `view`): [`ViewRef`](../type-aliases/ViewRef.md)\<`T`\[`"__typename"`\]\>
 
-Defined in: [packages/fate/src/client.ts:967](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L967)
+Defined in: [packages/fate/src/client.ts:984](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L984)
 
 #### Type Parameters
 
@@ -448,7 +448,7 @@ Defined in: [packages/fate/src/client.ts:967](https://github.com/nkzw-tech/fate/
 
 > **registerPendingOptimisticMutation**(`entityId`, `promise`): `void`
 
-Defined in: [packages/fate/src/client.ts:1873](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1873)
+Defined in: [packages/fate/src/client.ts:1891](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1891)
 
 #### Parameters
 
@@ -470,7 +470,7 @@ Defined in: [packages/fate/src/client.ts:1873](https://github.com/nkzw-tech/fate
 
 > **releaseRequest**(`request`, `mode`): `void`
 
-Defined in: [packages/fate/src/client.ts:2160](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2160)
+Defined in: [packages/fate/src/client.ts:2179](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2179)
 
 #### Parameters
 
@@ -492,7 +492,7 @@ Defined in: [packages/fate/src/client.ts:2160](https://github.com/nkzw-tech/fate
 
 > **releaseRequestKey**(`requestKey`, `mode`): `void`
 
-Defined in: [packages/fate/src/client.ts:2164](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2164)
+Defined in: [packages/fate/src/client.ts:2183](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2183)
 
 #### Parameters
 
@@ -514,7 +514,7 @@ Defined in: [packages/fate/src/client.ts:2164](https://github.com/nkzw-tech/fate
 
 > **request**\<`R`\>(`request`, `options?`): `Promise`\<[`RequestResult`](../type-aliases/RequestResult.md)\<`Roots`, `R`\>\>
 
-Defined in: [packages/fate/src/client.ts:2061](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2061)
+Defined in: [packages/fate/src/client.ts:2079](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2079)
 
 #### Type Parameters
 
@@ -530,7 +530,7 @@ Defined in: [packages/fate/src/client.ts:2061](https://github.com/nkzw-tech/fate
 
 ##### options?
 
-`Readonly`\<\{ `mode?`: [`RequestMode`](../type-aliases/RequestMode.md); `persist?`: \{ `maxAge`: `number`; \}; \}\>
+`Readonly`\<\{ `mode?`: [`RequestMode`](../type-aliases/RequestMode.md); `persist?`: `Readonly`\<\{ `maxAge`: `number`; \}\>; \}\>
 
 #### Returns
 
@@ -542,7 +542,7 @@ Defined in: [packages/fate/src/client.ts:2061](https://github.com/nkzw-tech/fate
 
 > **requestForRender**\<`R`\>(`request`, `options?`): `Promise`\<[`RequestResult`](../type-aliases/RequestResult.md)\<`Roots`, `R`\>\>
 
-Defined in: [packages/fate/src/client.ts:2076](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2076)
+Defined in: [packages/fate/src/client.ts:2094](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2094)
 
 #### Type Parameters
 
@@ -558,7 +558,7 @@ Defined in: [packages/fate/src/client.ts:2076](https://github.com/nkzw-tech/fate
 
 ##### options?
 
-`Readonly`\<\{ `mode?`: [`RequestMode`](../type-aliases/RequestMode.md); `persist?`: \{ `maxAge`: `number`; \}; \}\>
+`Readonly`\<\{ `mode?`: [`RequestMode`](../type-aliases/RequestMode.md); `persist?`: `Readonly`\<\{ `maxAge`: `number`; \}\>; \}\>
 
 #### Returns
 
@@ -570,7 +570,7 @@ Defined in: [packages/fate/src/client.ts:2076](https://github.com/nkzw-tech/fate
 
 > **resolveOptimisticEntity**(`optimisticEntityId`, `resolvedEntityId`): `void`
 
-Defined in: [packages/fate/src/client.ts:1898](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1898)
+Defined in: [packages/fate/src/client.ts:1916](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1916)
 
 #### Parameters
 
@@ -592,7 +592,7 @@ Defined in: [packages/fate/src/client.ts:1898](https://github.com/nkzw-tech/fate
 
 > **retain**(`request`): `RetainHandle`
 
-Defined in: [packages/fate/src/client.ts:2195](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2195)
+Defined in: [packages/fate/src/client.ts:2214](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2214)
 
 Keeps the records and lists reachable from a request alive until the
 returned handle is disposed.
@@ -617,7 +617,7 @@ that must survive manual garbage collection.
 
 > **retainRequestKey**(`requestKey`, `mode?`): `RetainHandle`
 
-Defined in: [packages/fate/src/client.ts:2176](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2176)
+Defined in: [packages/fate/src/client.ts:2195](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2195)
 
 #### Parameters
 
@@ -639,7 +639,7 @@ Defined in: [packages/fate/src/client.ts:2176](https://github.com/nkzw-tech/fate
 
 > **rootListRef**(`entityId`, `rootView`): `Readonly`\<\{ `__typename`: `string`; `[ViewsTag]`: `Set`\<`string`\>; `id`: `string` \| `number`; \}\>
 
-Defined in: [packages/fate/src/client.ts:975](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L975)
+Defined in: [packages/fate/src/client.ts:992](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L992)
 
 #### Parameters
 
@@ -661,7 +661,7 @@ Defined in: [packages/fate/src/client.ts:975](https://github.com/nkzw-tech/fate/
 
 > **subscribeLiveListView**\<`V`\>(`view`, `connection`): () => `void`
 
-Defined in: [packages/fate/src/client.ts:1351](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1351)
+Defined in: [packages/fate/src/client.ts:1369](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1369)
 
 #### Type Parameters
 
@@ -689,7 +689,7 @@ Defined in: [packages/fate/src/client.ts:1351](https://github.com/nkzw-tech/fate
 
 > **subscribeLiveView**\<`T`, `S`, `V`\>(`view`, `ref`): () => `void`
 
-Defined in: [packages/fate/src/client.ts:1266](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L1266)
+Defined in: [packages/fate/src/client.ts:1284](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L1284)
 
 #### Type Parameters
 
@@ -725,7 +725,7 @@ Defined in: [packages/fate/src/client.ts:1266](https://github.com/nkzw-tech/fate
 
 > **trackPendingRequest**\<`T`\>(`request`): `Promise`\<`T`\>
 
-Defined in: [packages/fate/src/client.ts:2454](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L2454)
+Defined in: [packages/fate/src/client.ts:2474](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L2474)
 
 #### Type Parameters
 
@@ -749,7 +749,7 @@ Defined in: [packages/fate/src/client.ts:2454](https://github.com/nkzw-tech/fate
 
 > **write**(`type`, `data`, `select`, `plan?`, `insert?`): `string`
 
-Defined in: [packages/fate/src/client.ts:923](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L923)
+Defined in: [packages/fate/src/client.ts:940](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L940)
 
 #### Parameters
 

package/docs/api/functions/clientRoot.md

@@ -2,7 +2,7 @@
 
 > **clientRoot**\<`Result`, `Type`\>(`type`): `RootDefinition`\<`Type`, `Result`\>
 
-Defined in: [packages/fate/src/root.ts:7](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/root.ts#L7)
+Defined in: [packages/fate/src/root.ts:7](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/root.ts#L7)
 
 Defines a root query for an entity type, capturing the response shape.
 

package/docs/api/functions/createClient.md

@@ -2,7 +2,7 @@
 
 > **createClient**\<`T`, `HydrationScope`\>(`options`): [`FateClient`](../classes/FateClient.md)\<`T`\[`0`\], `T`\[`1`\], `HydrationScope`\>
 
-Defined in: [packages/fate/src/client.ts:3501](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/client.ts#L3501)
+Defined in: [packages/fate/src/client.ts:3522](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/client.ts#L3522)
 
 ## Type Parameters
 

package/docs/api/functions/createGraphQLTransport.md

@@ -2,7 +2,7 @@
 
 > **createGraphQLTransport**\<`Mutations`\>(`__namedParameters`): [`Transport`](../interfaces/Transport.md)\<`Mutations`\>
 
-Defined in: [packages/fate/src/graphqlTransport.ts:579](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/graphqlTransport.ts#L579)
+Defined in: [packages/fate/src/graphqlTransport.ts:579](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/graphqlTransport.ts#L579)
 
 ## Type Parameters
 

package/docs/api/functions/createHTTPTransport.md

@@ -2,7 +2,7 @@
 
 > **createHTTPTransport**\<`API`, `Mutations`\>(`__namedParameters`): [`Transport`](../interfaces/Transport.md)\<`Mutations`\>
 
-Defined in: [packages/fate/src/httpTransport.ts:265](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/httpTransport.ts#L265)
+Defined in: [packages/fate/src/httpTransport.ts:265](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/httpTransport.ts#L265)
 
 ## Type Parameters
 

package/docs/api/functions/createTRPCTransport.md

@@ -2,7 +2,7 @@
 
 > **createTRPCTransport**\<`AppRouter`, `Mutations`\>(`__namedParameters`): [`Transport`](../interfaces/Transport.md)\<`MutationMapFromResolvers`\<`Mutations`\>\>
 
-Defined in: [packages/fate/src/transport.ts:160](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/transport.ts#L160)
+Defined in: [packages/fate/src/transport.ts:160](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/transport.ts#L160)
 
 Builds a `Transport` backed by a tRPC client using the configured resolvers
 for by-id queries, lists, and mutations.

package/docs/api/functions/defer.md

@@ -2,7 +2,7 @@
 
 > **defer**\<`S`\>(`selection`): [`DeferredSelection`](../type-aliases/DeferredSelection.md)\<`S`\>
 
-Defined in: [packages/fate/src/defer.ts:9](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/defer.ts#L9)
+Defined in: [packages/fate/src/defer.ts:9](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/defer.ts#L9)
 
 ## Type Parameters
 

package/docs/api/functions/getDeferredMetadata.md

@@ -2,7 +2,7 @@
 
 > **getDeferredMetadata**\<`T`\>(`deferred`): [`DeferredMetadata`](../type-aliases/DeferredMetadata.md)
 
-Defined in: [packages/fate/src/defer.ts:28](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/defer.ts#L28)
+Defined in: [packages/fate/src/defer.ts:28](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/defer.ts#L28)
 
 ## Type Parameters
 

package/docs/api/functions/getListEntries.md

@@ -2,7 +2,7 @@
 
 > **getListEntries**(`listState`): `Readonly`\<\{ `cursor?`: `string`; `id`: `string`; \}\>[]
 
-Defined in: [packages/fate/src/list.ts:6](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/list.ts#L6)
+Defined in: [packages/fate/src/list.ts:6](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/list.ts#L6)
 
 ## Parameters
 

package/docs/api/functions/getSelectionPlan.md

@@ -2,7 +2,7 @@
 
 > **getSelectionPlan**\<`T`, `S`, `V`\>(`viewComposition`, `ref`): `SelectionPlan`
 
-Defined in: [packages/fate/src/selection.ts:38](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/selection.ts#L38)
+Defined in: [packages/fate/src/selection.ts:38](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/selection.ts#L38)
 
 Flattens a view into a `SelectionPlan`, expanding composed views and
 partitioning nested args so the client can fetch exactly what is declared.

package/docs/api/functions/graphqlMutation.md

@@ -2,7 +2,7 @@
 
 > **graphqlMutation**\<`T`, `Input`, `Output`\>(`entity`, `options`): [`GraphQLMutationDefinition`](../type-aliases/GraphQLMutationDefinition.md)\<`T`, `Input`, `Output`\>
 
-Defined in: [packages/fate/src/graphqlTransport.ts:568](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/graphqlTransport.ts#L568)
+Defined in: [packages/fate/src/graphqlTransport.ts:568](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/graphqlTransport.ts#L568)
 
 ## Type Parameters
 

package/docs/api/functions/isDeferred.md

@@ -2,7 +2,7 @@
 
 > **isDeferred**(`value`): `value is Deferred<unknown>`
 
-Defined in: [packages/fate/src/defer.ts:25](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/defer.ts#L25)
+Defined in: [packages/fate/src/defer.ts:25](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/defer.ts#L25)
 
 ## Parameters
 

package/docs/api/functions/isRecord.md

@@ -2,7 +2,7 @@
 
 > **isRecord**(`value`): `value is FateRecord`
 
-Defined in: [packages/fate/src/record.ts:3](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/record.ts#L3)
+Defined in: [packages/fate/src/record.ts:3](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/record.ts#L3)
 
 ## Parameters
 

package/docs/api/functions/isViewTag.md

@@ -2,7 +2,7 @@
 
 > **isViewTag**(`key`): `` key is `__fate-view__${string}` ``
 
-Defined in: [packages/fate/src/types.ts:65](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L65)
+Defined in: [packages/fate/src/types.ts:65](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L65)
 
 Determines whether a property key is a fate view tag.
 

package/docs/api/functions/liveConnectionTopic.md

@@ -2,7 +2,7 @@
 
 > **liveConnectionTopic**(`procedure`, `args?`): `string`
 
-Defined in: [packages/fate/src/liveTopics.ts:20](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/liveTopics.ts#L20)
+Defined in: [packages/fate/src/liveTopics.ts:20](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/liveTopics.ts#L20)
 
 ## Parameters
 

package/docs/api/functions/liveEntityTopic.md

@@ -2,7 +2,7 @@
 
 > **liveEntityTopic**(`type`, `id`): `string`
 
-Defined in: [packages/fate/src/liveTopics.ts:17](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/liveTopics.ts#L17)
+Defined in: [packages/fate/src/liveTopics.ts:17](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/liveTopics.ts#L17)
 
 ## Parameters
 

package/docs/api/functions/liveGlobalConnectionTopic.md

@@ -2,7 +2,7 @@
 
 > **liveGlobalConnectionTopic**(`procedure`): `string`
 
-Defined in: [packages/fate/src/liveTopics.ts:25](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/liveTopics.ts#L25)
+Defined in: [packages/fate/src/liveTopics.ts:25](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/liveTopics.ts#L25)
 
 ## Parameters
 

package/docs/api/functions/mutation.md

@@ -2,7 +2,7 @@
 
 > **mutation**\<`T`, `I`, `R`\>(`entity`): [`MutationDefinition`](../type-aliases/MutationDefinition.md)\<`T`, `I`, `R`\>
 
-Defined in: [packages/fate/src/mutation.ts:27](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/mutation.ts#L27)
+Defined in: [packages/fate/src/mutation.ts:27](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/mutation.ts#L27)
 
 Defines a mutation for a given entity type, preserving the input and output
 types for transports.

package/docs/api/functions/toEntityId.md

@@ -2,7 +2,7 @@
 
 > **toEntityId**(`type`, `rawId`): `string`
 
-Defined in: [packages/fate/src/ref.ts:16](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/ref.ts#L16)
+Defined in: [packages/fate/src/ref.ts:16](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/ref.ts#L16)
 
 Builds the canonical cache ID for an entity.
 

package/docs/api/functions/view.md

@@ -2,7 +2,7 @@
 
 > **view**\<`T`\>(): \<`S`\>(`select`) => [`View`](../type-aliases/View.md)\<`T`, `S`\>
 
-Defined in: [packages/fate/src/view.ts:111](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/view.ts#L111)
+Defined in: [packages/fate/src/view.ts:111](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/view.ts#L111)
 
 Creates a reusable view for an object using the declared selection.
 

package/docs/api/index.md

@@ -58,10 +58,12 @@ import { view } from '@nkzw/fate';
 - [MutationResult](type-aliases/MutationResult.md)
 - [NodesItem](type-aliases/NodesItem.md)
 - [Pagination](type-aliases/Pagination.md)
+- [PersistedMutationStatus](type-aliases/PersistedMutationStatus.md)
 - [PersistenceSnapshot](type-aliases/PersistenceSnapshot.md)
 - [Request](type-aliases/Request.md)
 - [RequestMode](type-aliases/RequestMode.md)
 - [RequestOptions](type-aliases/RequestOptions.md)
+- [RequestPersistenceOptions](type-aliases/RequestPersistenceOptions.md)
 - [RequestResult](type-aliases/RequestResult.md)
 - [Selection](type-aliases/Selection.md)
 - [TypeConfig](type-aliases/TypeConfig.md)

package/docs/api/interfaces/FateThenable.md

@@ -1,6 +1,6 @@
 # Interface: FateThenable\<T\>
 
-Defined in: [packages/fate/src/types.ts:512](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L512)
+Defined in: [packages/fate/src/types.ts:512](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L512)
 
 Promise-like value returned by cache reads that already have a resolved payload for React `use`.
 
@@ -20,7 +20,7 @@ Promise-like value returned by cache reads that already have a resolved payload
 
 > **status**: `"fulfilled"`
 
-Defined in: [packages/fate/src/types.ts:513](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L513)
+Defined in: [packages/fate/src/types.ts:513](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L513)
 
 ***
 
@@ -28,4 +28,4 @@ Defined in: [packages/fate/src/types.ts:513](https://github.com/nkzw-tech/fate/b
 
 > **value**: `T`
 
-Defined in: [packages/fate/src/types.ts:514](https://github.com/nkzw-tech/fate/blob/0dec4f3068f60a4fbf85796c9934f6112afe09a2/packages/fate/src/types.ts#L514)
+Defined in: [packages/fate/src/types.ts:514](https://github.com/nkzw-tech/fate/blob/4d2c828cce4c513c8e424ff1ffe320bb387c49f2/packages/fate/src/types.ts#L514)