@nkzw/fate 1.0.2 → 1.1.0

package/docs/api/classes/FateClient.md

@@ -1,6 +1,6 @@
-# Class: FateClient\<Roots, Mutations\>
+# Class: FateClient\<Roots, Mutations, HydrationScope\>
 
-Defined in: [packages/fate/src/client.ts:361](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L361)
+Defined in: [packages/fate/src/client.ts:401](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L401)
 
 Core client that normalizes records, manages the view cache, and coordinates
 data fetching.
@@ -15,23 +15,27 @@ data fetching.
 
 `Mutations` *extends* [`FateMutations`](../type-aliases/FateMutations.md)
 
+### HydrationScope
+
+`HydrationScope` *extends* `string` = `string`
+
 ## Constructors
 
 ### Constructor
 
-> **new FateClient**\<`Roots`, `Mutations`\>(`options`): `FateClient`\<`Roots`, `Mutations`\>
+> **new FateClient**\<`Roots`, `Mutations`, `HydrationScope`\>(`options`): `FateClient`\<`Roots`, `Mutations`, `HydrationScope`\>
 
-Defined in: [packages/fate/src/client.ts:400](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L400)
+Defined in: [packages/fate/src/client.ts:447](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L447)
 
 #### Parameters
 
 ##### options
 
-`FateClientOptions`\<`Roots`, `Mutations`\>
+`FateClientOptions`\<`Roots`, `Mutations`, `HydrationScope`\>
 
 #### Returns
 
-`FateClient`\<`Roots`, `Mutations`\>
+`FateClient`\<`Roots`, `Mutations`, `HydrationScope`\>
 
 ## Properties
 
@@ -39,7 +43,7 @@ Defined in: [packages/fate/src/client.ts:400](https://github.com/nkzw-tech/fate/
 
 > `readonly` **actions**: `MutationTreeFromRecord`\<`Mutations`\>
 
-Defined in: [packages/fate/src/client.ts:396](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L396)
+Defined in: [packages/fate/src/client.ts:443](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L443)
 
 ***
 
@@ -47,7 +51,7 @@ Defined in: [packages/fate/src/client.ts:396](https://github.com/nkzw-tech/fate/
 
 > `readonly` **mutations**: `MutationTreeFromRecord`\<`Mutations`\>
 
-Defined in: [packages/fate/src/client.ts:397](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L397)
+Defined in: [packages/fate/src/client.ts:444](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L444)
 
 ***
 
@@ -55,7 +59,7 @@ Defined in: [packages/fate/src/client.ts:397](https://github.com/nkzw-tech/fate/
 
 > `readonly` **roots**: `Roots`
 
-Defined in: [packages/fate/src/client.ts:398](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L398)
+Defined in: [packages/fate/src/client.ts:445](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L445)
 
 ***
 
@@ -63,7 +67,7 @@ Defined in: [packages/fate/src/client.ts:398](https://github.com/nkzw-tech/fate/
 
 > `readonly` **store**: `Store`
 
-Defined in: [packages/fate/src/client.ts:389](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L389)
+Defined in: [packages/fate/src/client.ts:434](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L434)
 
 ## Methods
 
@@ -71,7 +75,7 @@ Defined in: [packages/fate/src/client.ts:389](https://github.com/nkzw-tech/fate/
 
 > **assertLiveConnectionSupport**(): `void`
 
-Defined in: [packages/fate/src/client.ts:845](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L845)
+Defined in: [packages/fate/src/client.ts:987](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L987)
 
 #### Returns
 
@@ -83,7 +87,7 @@ Defined in: [packages/fate/src/client.ts:845](https://github.com/nkzw-tech/fate/
 
 > **assertLiveViewSupport**(): `void`
 
-Defined in: [packages/fate/src/client.ts:837](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L837)
+Defined in: [packages/fate/src/client.ts:979](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L979)
 
 #### Returns
 
@@ -95,7 +99,7 @@ Defined in: [packages/fate/src/client.ts:837](https://github.com/nkzw-tech/fate/
 
 > **clearOptimisticUpdate**(`token`): `void`
 
-Defined in: [packages/fate/src/client.ts:1496](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1496)
+Defined in: [packages/fate/src/client.ts:1638](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1638)
 
 #### Parameters
 
@@ -109,11 +113,27 @@ Defined in: [packages/fate/src/client.ts:1496](https://github.com/nkzw-tech/fate
 
 ***
 
+### dehydrate()
+
+> **dehydrate**(): [`FateDehydratedState`](../type-aliases/FateDehydratedState.md)\<`HydrationScope`\>
+
+Defined in: [packages/fate/src/client.ts:539](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L539)
+
+Exports the durable normalized cache as an opaque JSON-safe value for SSR
+transfer or persistence. Runtime requests, subscriptions, retainers, and
+optimistic state are intentionally excluded.
+
+#### Returns
+
+[`FateDehydratedState`](../type-aliases/FateDehydratedState.md)\<`HydrationScope`\>
+
+***
+
 ### deleteRecord()
 
 > **deleteRecord**(`type`, `id`, `snapshots?`, `listSnapshots?`): `void`
 
-Defined in: [packages/fate/src/client.ts:650](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L650)
+Defined in: [packages/fate/src/client.ts:789](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L789)
 
 #### Parameters
 
@@ -143,7 +163,7 @@ Defined in: [packages/fate/src/client.ts:650](https://github.com/nkzw-tech/fate/
 
 > **executeMutation**(`key`, `input`, `select`, `options?`): `Promise`\<`unknown`\>
 
-Defined in: [packages/fate/src/client.ts:594](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L594)
+Defined in: [packages/fate/src/client.ts:731](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L731)
 
 #### Parameters
 
@@ -179,7 +199,7 @@ Defined in: [packages/fate/src/client.ts:594](https://github.com/nkzw-tech/fate/
 
 > **filterSelectionForPendingOptimistics**(`entityId`, `select`, `options?`): `Set`\<`string`\>
 
-Defined in: [packages/fate/src/client.ts:1559](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1559)
+Defined in: [packages/fate/src/client.ts:1701](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1701)
 
 #### Parameters
 
@@ -207,7 +227,7 @@ Defined in: [packages/fate/src/client.ts:1559](https://github.com/nkzw-tech/fate
 
 > **gc**(): `void`
 
-Defined in: [packages/fate/src/client.ts:1871](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1871)
+Defined in: [packages/fate/src/client.ts:2024](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L2024)
 
 Removes records and lists that are not reachable from retained requests or
 the release buffer.
@@ -226,7 +246,7 @@ memory-management flows.
 
 > **getPendingOptimisticMask**(`entityId`, `options?`): `FieldMask` \| `null`
 
-Defined in: [packages/fate/src/client.ts:1518](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1518)
+Defined in: [packages/fate/src/client.ts:1660](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1660)
 
 #### Parameters
 
@@ -250,7 +270,7 @@ Defined in: [packages/fate/src/client.ts:1518](https://github.com/nkzw-tech/fate
 
 > **getRequestKey**(`request`): `string`
 
-Defined in: [packages/fate/src/client.ts:2089](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L2089)
+Defined in: [packages/fate/src/client.ts:2255](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L2255)
 
 #### Parameters
 
@@ -268,7 +288,7 @@ Defined in: [packages/fate/src/client.ts:2089](https://github.com/nkzw-tech/fate
 
 > **getRequestResult**\<`R`\>(`request`): [`RequestResult`](../type-aliases/RequestResult.md)\<`Roots`, `R`\>
 
-Defined in: [packages/fate/src/client.ts:2229](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L2229)
+Defined in: [packages/fate/src/client.ts:2395](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L2395)
 
 #### Type Parameters
 
@@ -292,7 +312,7 @@ Defined in: [packages/fate/src/client.ts:2229](https://github.com/nkzw-tech/fate
 
 > **getTypeConfig**(`type`): [`TypeConfig`](../type-aliases/TypeConfig.md)
 
-Defined in: [packages/fate/src/client.ts:586](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L586)
+Defined in: [packages/fate/src/client.ts:723](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L723)
 
 #### Parameters
 
@@ -306,11 +326,37 @@ Defined in: [packages/fate/src/client.ts:586](https://github.com/nkzw-tech/fate/
 
 ***
 
+### hydrate()
+
+> **hydrate**(`state`, `options?`): `void`
+
+Defined in: [packages/fate/src/client.ts:566](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L566)
+
+Restores a durable normalized cache snapshot without restoring runtime
+request handles, retainers, subscriptions, or optimistic update state.
+Hydrate before rendering SSR content. Replaying the same snapshot is safe.
+
+#### Parameters
+
+##### state
+
+[`FateDehydratedState`](../type-aliases/FateDehydratedState.md)\<`HydrationScope`\>
+
+##### options?
+
+[`HydrateOptions`](../type-aliases/HydrateOptions.md) = `{}`
+
+#### Returns
+
+`void`
+
+***
+
 ### loadConnection()
 
 > **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:1583](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1583)
+Defined in: [packages/fate/src/client.ts:1725](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1725)
 
 #### Type Parameters
 
@@ -348,7 +394,7 @@ Defined in: [packages/fate/src/client.ts:1583](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:1753](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1753)
+Defined in: [packages/fate/src/client.ts:1906](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1906)
 
 #### Type Parameters
 
@@ -376,7 +422,7 @@ Defined in: [packages/fate/src/client.ts:1753](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:713](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L713)
+Defined in: [packages/fate/src/client.ts:852](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L852)
 
 #### Type Parameters
 
@@ -412,7 +458,7 @@ Defined in: [packages/fate/src/client.ts:713](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:700](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L700)
+Defined in: [packages/fate/src/client.ts:839](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L839)
 
 #### Type Parameters
 
@@ -444,7 +490,7 @@ Defined in: [packages/fate/src/client.ts:700](https://github.com/nkzw-tech/fate/
 
 > **registerOptimisticUpdate**(`entityId`, `select`): `number` \| `null`
 
-Defined in: [packages/fate/src/client.ts:1477](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1477)
+Defined in: [packages/fate/src/client.ts:1619](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1619)
 
 #### Parameters
 
@@ -466,7 +512,7 @@ Defined in: [packages/fate/src/client.ts:1477](https://github.com/nkzw-tech/fate
 
 > **registerPendingOptimisticMutation**(`entityId`, `promise`): `void`
 
-Defined in: [packages/fate/src/client.ts:1447](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1447)
+Defined in: [packages/fate/src/client.ts:1589](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1589)
 
 #### Parameters
 
@@ -488,7 +534,7 @@ Defined in: [packages/fate/src/client.ts:1447](https://github.com/nkzw-tech/fate
 
 > **releaseRequest**(`request`, `mode`): `void`
 
-Defined in: [packages/fate/src/client.ts:1810](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1810)
+Defined in: [packages/fate/src/client.ts:1963](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1963)
 
 #### Parameters
 
@@ -510,7 +556,7 @@ Defined in: [packages/fate/src/client.ts:1810](https://github.com/nkzw-tech/fate
 
 > **releaseRequestKey**(`requestKey`, `mode`): `void`
 
-Defined in: [packages/fate/src/client.ts:1814](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1814)
+Defined in: [packages/fate/src/client.ts:1967](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1967)
 
 #### Parameters
 
@@ -532,7 +578,7 @@ Defined in: [packages/fate/src/client.ts:1814](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:1736](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1736)
+Defined in: [packages/fate/src/client.ts:1889](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1889)
 
 #### Type Parameters
 
@@ -560,7 +606,7 @@ Defined in: [packages/fate/src/client.ts:1736](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:1746](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1746)
+Defined in: [packages/fate/src/client.ts:1899](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1899)
 
 #### Type Parameters
 
@@ -588,7 +634,7 @@ Defined in: [packages/fate/src/client.ts:1746](https://github.com/nkzw-tech/fate
 
 > **resolveOptimisticEntity**(`optimisticEntityId`, `resolvedEntityId`): `void`
 
-Defined in: [packages/fate/src/client.ts:1472](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1472)
+Defined in: [packages/fate/src/client.ts:1614](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1614)
 
 #### Parameters
 
@@ -610,7 +656,7 @@ Defined in: [packages/fate/src/client.ts:1472](https://github.com/nkzw-tech/fate
 
 > **restore**(`id`, `snapshot`): `void`
 
-Defined in: [packages/fate/src/client.ts:668](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L668)
+Defined in: [packages/fate/src/client.ts:807](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L807)
 
 #### Parameters
 
@@ -632,7 +678,7 @@ Defined in: [packages/fate/src/client.ts:668](https://github.com/nkzw-tech/fate/
 
 > **restoreList**(`name`, `list?`): `void`
 
-Defined in: [packages/fate/src/client.ts:673](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L673)
+Defined in: [packages/fate/src/client.ts:812](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L812)
 
 #### Parameters
 
@@ -654,7 +700,7 @@ Defined in: [packages/fate/src/client.ts:673](https://github.com/nkzw-tech/fate/
 
 > **retain**(`request`): `RetainHandle`
 
-Defined in: [packages/fate/src/client.ts:1845](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1845)
+Defined in: [packages/fate/src/client.ts:1998](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1998)
 
 Keeps the records and lists reachable from a request alive until the
 returned handle is disposed.
@@ -679,7 +725,7 @@ that must survive manual garbage collection.
 
 > **retainRequestKey**(`requestKey`, `mode?`): `RetainHandle`
 
-Defined in: [packages/fate/src/client.ts:1826](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L1826)
+Defined in: [packages/fate/src/client.ts:1979](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1979)
 
 #### Parameters
 
@@ -701,7 +747,7 @@ Defined in: [packages/fate/src/client.ts:1826](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:708](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L708)
+Defined in: [packages/fate/src/client.ts:847](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L847)
 
 #### Parameters
 
@@ -723,7 +769,7 @@ Defined in: [packages/fate/src/client.ts:708](https://github.com/nkzw-tech/fate/
 
 > **subscribeLiveListView**\<`V`\>(`view`, `connection`): () => `void`
 
-Defined in: [packages/fate/src/client.ts:937](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L937)
+Defined in: [packages/fate/src/client.ts:1079](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L1079)
 
 #### Type Parameters
 
@@ -751,7 +797,7 @@ Defined in: [packages/fate/src/client.ts:937](https://github.com/nkzw-tech/fate/
 
 > **subscribeLiveView**\<`T`, `S`, `V`\>(`view`, `ref`): () => `void`
 
-Defined in: [packages/fate/src/client.ts:853](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L853)
+Defined in: [packages/fate/src/client.ts:995](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L995)
 
 #### Type Parameters
 
@@ -783,11 +829,35 @@ Defined in: [packages/fate/src/client.ts:853](https://github.com/nkzw-tech/fate/
 
 ***
 
+### trackPendingRequest()
+
+> **trackPendingRequest**\<`T`\>(`request`): `Promise`\<`T`\>
+
+Defined in: [packages/fate/src/client.ts:2212](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L2212)
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+#### Parameters
+
+##### request
+
+() => `Promise`\<`T`\>
+
+#### Returns
+
+`Promise`\<`T`\>
+
+***
+
 ### write()
 
 > **write**(`type`, `data`, `select`, `snapshots?`, `plan?`, `pathPrefix?`, `blockedMask?`, `insert?`, `listSnapshots?`): `string`
 
-Defined in: [packages/fate/src/client.ts:626](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L626)
+Defined in: [packages/fate/src/client.ts:765](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L765)
 
 #### 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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/root.ts#L7)
+Defined in: [packages/fate/src/root.ts:7](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/root.ts#L7)
 
 Defines a root query for an entity type, capturing the response shape.
 

package/docs/api/functions/createClient.md

@@ -1,8 +1,8 @@
 # Function: createClient()
 
-> **createClient**\<`T`\>(`options`): [`FateClient`](../classes/FateClient.md)\<`T`\[`0`\], `T`\[`1`\]\>
+> **createClient**\<`T`, `HydrationScope`\>(`options`): [`FateClient`](../classes/FateClient.md)\<`T`\[`0`\], `T`\[`1`\], `HydrationScope`\>
 
-Defined in: [packages/fate/src/client.ts:3009](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/client.ts#L3009)
+Defined in: [packages/fate/src/client.ts:3181](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/client.ts#L3181)
 
 ## Type Parameters
 
@@ -10,12 +10,16 @@ Defined in: [packages/fate/src/client.ts:3009](https://github.com/nkzw-tech/fate
 
 `T` *extends* \[[`FateRoots`](../type-aliases/FateRoots.md), [`FateMutations`](../type-aliases/FateMutations.md)\] = \[`Record`\<`never`, `RootDefinition`\<`any`, `any`\>\>, `Record`\<`never`, [`MutationDefinition`](../type-aliases/MutationDefinition.md)\<`any`, `any`, `any`\>\>\]
 
+### HydrationScope
+
+`HydrationScope` *extends* `string` = `string`
+
 ## Parameters
 
 ### options
 
-`FateClientOptions`\<`T`\[`0`\], `T`\[`1`\]\>
+`FateClientOptions`\<`T`\[`0`\], `T`\[`1`\], `HydrationScope`\>
 
 ## Returns
 
-[`FateClient`](../classes/FateClient.md)\<`T`\[`0`\], `T`\[`1`\]\>
+[`FateClient`](../classes/FateClient.md)\<`T`\[`0`\], `T`\[`1`\], `HydrationScope`\>

package/docs/api/functions/createGraphQLTransport.md

@@ -0,0 +1,21 @@
+# Function: createGraphQLTransport()
+
+> **createGraphQLTransport**\<`Mutations`\>(`__namedParameters`): [`Transport`](../interfaces/Transport.md)\<`Mutations`\>
+
+Defined in: [packages/fate/src/graphqlTransport.ts:578](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/graphqlTransport.ts#L578)
+
+## Type Parameters
+
+### Mutations
+
+`Mutations` *extends* `TransportMutations` = `EmptyTransportMutations`
+
+## Parameters
+
+### \_\_namedParameters
+
+[`GraphQLTransportOptions`](../type-aliases/GraphQLTransportOptions.md)\<`Mutations`\>
+
+## Returns
+
+[`Transport`](../interfaces/Transport.md)\<`Mutations`\>

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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/httpTransport.ts#L265)
+Defined in: [packages/fate/src/httpTransport.ts:265](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/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:149](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/transport.ts#L149)
+Defined in: [packages/fate/src/transport.ts:149](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/transport.ts#L149)
 
 Builds a `Transport` backed by a tRPC client using the configured resolvers
 for by-id queries, lists, and mutations.

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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/list.ts#L6)
+Defined in: [packages/fate/src/list.ts:6](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/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:37](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/selection.ts#L37)
+Defined in: [packages/fate/src/selection.ts:37](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/selection.ts#L37)
 
 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

@@ -0,0 +1,39 @@
+# Function: graphqlMutation()
+
+> **graphqlMutation**\<`T`, `Input`, `Output`\>(`entity`, `options`): [`GraphQLMutationDefinition`](../type-aliases/GraphQLMutationDefinition.md)\<`T`, `Input`, `Output`\>
+
+Defined in: [packages/fate/src/graphqlTransport.ts:567](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/graphqlTransport.ts#L567)
+
+## Type Parameters
+
+### T
+
+`T` *extends* [`Entity`](../type-aliases/Entity.md)
+
+### Input
+
+`Input`
+
+### Output
+
+`Output`
+
+## Parameters
+
+### entity
+
+`T`\[`"__typename"`\]
+
+### options
+
+#### field
+
+`string`
+
+#### inputArg?
+
+`string` \| `false`
+
+## Returns
+
+[`GraphQLMutationDefinition`](../type-aliases/GraphQLMutationDefinition.md)\<`T`, `Input`, `Output`\>

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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/record.ts#L3)
+Defined in: [packages/fate/src/record.ts:3](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/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:59](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/types.ts#L59)
+Defined in: [packages/fate/src/types.ts:59](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/types.ts#L59)
 
 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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/liveTopics.ts#L20)
+Defined in: [packages/fate/src/liveTopics.ts:20](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/liveTopics.ts#L17)
+Defined in: [packages/fate/src/liveTopics.ts:17](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/liveTopics.ts#L25)
+Defined in: [packages/fate/src/liveTopics.ts:25](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/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:28](https://github.com/nkzw-tech/fate/blob/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/mutation.ts#L28)
+Defined in: [packages/fate/src/mutation.ts:28](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/mutation.ts#L28)
 
 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/2b217058fdff50f3598b704f486529cd23a8dbb6/packages/fate/src/ref.ts#L16)
+Defined in: [packages/fate/src/ref.ts:16](https://github.com/nkzw-tech/fate/blob/b6f90b96eb193852523df58a538c7900829d4862/packages/fate/src/ref.ts#L16)
 
 Builds the canonical cache ID for an entity.