@nkzw/fate 1.0.0 → 1.0.1

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

@@ -2,7 +2,7 @@
 
 > **TypeConfig** = `object`
 
-Defined in: [packages/fate/src/types.ts:117](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L117)
+Defined in: [packages/fate/src/types.ts:117](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L117)
 
 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:118](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L118)
+Defined in: [packages/fate/src/types.ts:118](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L118)
 
 ***
 
@@ -20,7 +20,7 @@ Defined in: [packages/fate/src/types.ts:118](https://github.com/nkzw-tech/fate/b
 
 > **getId**: (`record`) => `string` \| `number`
 
-Defined in: [packages/fate/src/types.ts:119](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L119)
+Defined in: [packages/fate/src/types.ts:119](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L119)
 
 #### Parameters
 
@@ -38,4 +38,4 @@ Defined in: [packages/fate/src/types.ts:119](https://github.com/nkzw-tech/fate/b
 
 > **type**: `string`
 
-Defined in: [packages/fate/src/types.ts:120](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L120)
+Defined in: [packages/fate/src/types.ts:120](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L120)

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:215](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L215)
+Defined in: [packages/fate/src/types.ts:215](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L215)
 
 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:231](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L231)
+Defined in: [packages/fate/src/types.ts:231](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L231)
 
 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:303](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L303)
+Defined in: [packages/fate/src/types.ts:303](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L303)
 
 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:306](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L306)
+Defined in: [packages/fate/src/types.ts:306](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L306)
 
 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:101](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L101)
+Defined in: [packages/fate/src/types.ts:101](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L101)
 
 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:309](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L309)
+Defined in: [packages/fate/src/types.ts:309](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L309)
 
 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:241](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L241)
+Defined in: [packages/fate/src/types.ts:241](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L241)
 
 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:49](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L49)
+Defined in: [packages/fate/src/types.ts:49](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L49)
 
 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:20](https://github.com/nkzw-tech/fate/blob/17081c4f677e224e55b75d9a31bd6e0a7ee94af1/packages/fate/src/types.ts#L20)
+Defined in: [packages/fate/src/types.ts:20](https://github.com/nkzw-tech/fate/blob/641aeb0396b93477dc2e75fdb2c29a4c2b62a272/packages/fate/src/types.ts#L20)
 
 Symbol attached to connection results so pagination helpers can find their metadata.

package/docs/guide/actions.md

@@ -5,9 +5,13 @@ fate does not provide hooks for mutations like traditional data fetching librari
 - `fate.actions` for use with [`useActionState`](https://react.dev/reference/react/useActionState) and React Actions.
 - `fate.mutations` for traditional imperative mutation calls.
 
-Mutations in your tRPC backend are made available as actions and mutations by fate's generated client.
+Server mutations are exposed automatically as actions and mutations by fate's Vite plugin. The transport determines where those mutations are declared:
 
-Let's assume that our `Post` entity has a tRPC mutation for liking a post called `post.like`. A `LikeButton` component using fate Actions and an async component library could then look like this:
+- With the [native HTTP transport](server-integration.md#native-fate-protocol), mutations come from the `mutations` object passed to `createFateServer`.
+- With the [tRPC adapter](server-integration.md#trpc-fate-setup), mutations come from tRPC mutation procedures exposed through your fate-enabled router.
+- With [Void](void-integration.md), mutations use the same native fate server shape and are exposed through the Void route helpers.
+
+If you have a mutation named `post.like`, a `LikeButton` component using fate Actions and an async component library could look like this:
 
 ```tsx
 import { useActionState } from 'react';
@@ -142,7 +146,45 @@ You can call mutations from anywhere, and without waiting for previous mutations
 
 ## Mutation Server Implementation
 
-fate Actions & Mutations are backed by regular tRPC mutations on the server. Here is an example implementation of the `like` mutation in the `postRouter`.
+fate Actions & Mutations are backed by regular server mutations. If you already know how your fate server is wired, the client-side API above is the same regardless of transport. If not, start with the server setup for your environment:
+
+- [Native HTTP custom mutations](server-integration.md#custom-mutations) use `createFateServer({ mutations })`.
+- [tRPC fate setup](server-integration.md#trpc-fate-setup) wires fate into your tRPC router; custom writes can use the same `fate.createPlan` and `fate.resolveById` helpers shown there.
+- [Void integration](void-integration.md) exposes a native fate server from Void routes; define mutations with the native `createFateServer({ mutations })` API and serve them through `defineVoidFateRoute`.
+
+Here is a native HTTP mutation for `post.like`:
+
+```tsx
+export const fate = createFateServer({
+  mutations: {
+    'post.like': {
+      input: likeInput,
+      resolve: async ({ ctx, input, select }) => {
+        await ctx.prisma.post.update({
+          data: {
+            likes: {
+              increment: 1,
+            },
+          },
+          where: { id: input.id },
+        });
+
+        return sources.resolveById({
+          ctx,
+          id: input.id,
+          input: { select },
+          view: postDataView,
+        });
+      },
+      type: 'Post',
+    },
+  },
+  roots: Root,
+  sources,
+});
+```
+
+The equivalent tRPC mutation lives in your router and returns the selected shape that the client asked for:
 
 ```tsx
 import { z } from 'zod';
@@ -181,7 +223,7 @@ export const postRouter = router({
 });
 ```
 
-See the [Server Integration](#server-integration) section for more details on how to integrate tRPC routers with fate.
+See [Server Integration](server-integration.md) for complete native HTTP and tRPC setup examples, and [Void Integration](void-integration.md) for route helpers when your app runs on Void.
 
 ## Action & Mutation Error Handling
 

package/docs/guide/live-views.md

@@ -22,7 +22,7 @@ The API mirrors `useView`: pass a view and a ref, and get back the same masked d
 
 ## How Live Updates Work
 
-The native HTTP transport opens one Server-Sent Events (SSE) connection per Fate client. When components mount or unmount live views, the client sends subscribe and unsubscribe control messages to the server. The server keeps those selections on the connection and sends updates only for records that connection subscribed to.
+The native HTTP transport opens one Server-Sent Events (SSE) connection per fate client. When components mount or unmount live views, the client sends subscribe and unsubscribe control messages to the server. The server keeps those selections on the connection and sends updates only for records that connection subscribed to.
 
 When the server sends an update, fate normalizes the selected record into the same cache used by requests, actions, and mutations. Components that read affected fields re-render automatically.
 
@@ -32,7 +32,7 @@ Live deletion events remove the record from the normalized cache in the same way
 
 ## Client Setup
 
-Generate the client with the native transport and point it at your Fate endpoint:
+Configure the native transport and point the client at your fate endpoint:
 
 ```tsx
 import { FateClient } from 'react-fate';
@@ -83,6 +83,19 @@ export const fate = createFateServer<AppContext>({
 app.all('/fate/*', createHonoFateHandler(fate));
 ```
 
+fate keeps a bounded in-memory queue for each native SSE connection while live events are waiting to be resolved and sent. The default limit is `1000` queued events per connection. If a client falls behind and exceeds the limit, fate closes that live connection so server memory cannot grow without bound. You can tune the limit by passing the object form:
+
+```tsx
+export const fate = createFateServer<AppContext>({
+  live: {
+    bus: live,
+    maxQueueSize: 500,
+  },
+  roots: Root,
+  sources,
+});
+```
+
 Once this is in place, components can switch from `useView` to `useLiveView` without changing their view definitions or return types.
 
 ## Live List Views

package/docs/guide/requests.md

@@ -26,7 +26,7 @@ This component suspends or throws errors, which bubble up to the nearest error b
 
 > [!NOTE]
 >
-> `useRequest` might issue multiple requests which are automatically batched together by tRPC's [HTTP Batch Link](https://trpc.io/docs/client/links/httpBatchLink) into a single network request.
+> `useRequest` may issue multiple operations in the same render pass. fate transports can batch those operations into fewer network requests: the native HTTP transport batches same-microtask operations into one `POST /fate` request, and the tRPC adapter can use tRPC's [HTTP Batch Link](https://trpc.io/docs/client/links/httpBatchLink).
 
 ## Requesting Objects by ID
 

package/docs/guide/server-integration.md

@@ -1,8 +1,8 @@
 # Server Integration
 
-Until now, we have focused on the client-side API of fate. You'll need a backend that follows fate's data protocol so the Vite plugin can provide a typed client module. _fate_ currently ships two server paths:
+Until now, we have focused on the client-side API of fate. You'll need a backend that follows fate's data protocol so the Vite plugin can wire the typed fate APIs into your app. _fate_ currently ships two server paths:
 
-- The native Fate protocol, which is transport-agnostic and can be hosted by any Fetch-compatible server.
+- The native fate protocol, which is transport-agnostic and can be hosted by any Fetch-compatible server.
 - The tRPC adapter, which keeps compatibility with existing tRPC backends.
 
 _fate_ currently provides database adapters for Prisma and Drizzle, but the framework itself is not coupled to a particular ORM. The adapters plug into the same source execution runtime and can be exposed through the native protocol or through tRPC.
@@ -16,7 +16,7 @@ fate expects that data is served by a backend that follows these conventions:
 
 Objects are identified by their ID and type name (`__typename`, e.g. `Post`, `User`), and stored by `__typename:id` (e.g. "Post:123") in the client cache. fate keeps list orderings under stable keys derived from the backend procedure and args. Relations are stored as IDs and returned to components as ViewRef tokens.
 
-fate's type definitions might seem verbose at first glance. However, with fate's minimal API surface, AI tools can easily generate this code for you, or you can let the Vite plugin provide the typed client module for your app.
+fate's type definitions might seem verbose at first glance. However, with fate's minimal API surface, AI tools can easily write this code for you, and the Vite plugin takes care of connecting it to your app.
 
 > [!NOTE]
 > You can adopt _fate_ incrementally in an existing tRPC codebase without changing your existing schema by adding these queries alongside your existing procedures.
@@ -112,9 +112,9 @@ export const Root = {
 };
 ```
 
-Entries that wrap their view in `list(...)` are treated as list resolvers. In the native protocol, the root key is the operation name sent by the generated client. In the tRPC adapter, `procedure` can point that root at a specific router procedure. If you omit `list(...)`, fate treats the entry as a standard query.
+Entries that wrap their view in `list(...)` are treated as list resolvers. In the native protocol, the root key is the operation name used by the client. In the tRPC adapter, `procedure` can point that root at a specific router procedure. If you omit `list(...)`, fate treats the entry as a standard query.
 
-You can pass default list options such as `orderBy` to `list(...)`. Ordering is scoped to that specific list wrapper: `Root.posts` can order posts by `createdAt desc`, while `categoryDataView.posts` or `postDataView.comments` can choose their own order. If no order is provided, Fate orders by `id asc`. Fate always appends `id asc` as a tie-breaker when no `id` order is present; include `id` yourself when you need a different tie-breaker direction such as `id desc`. Use the array form when ordering by multiple fields so the priority is unambiguous.
+You can pass default list options such as `orderBy` to `list(...)`. Ordering is scoped to that specific list wrapper: `Root.posts` can order posts by `createdAt desc`, while `categoryDataView.posts` or `postDataView.comments` can choose their own order. If no order is provided, fate orders by `id asc`. fate always appends `id asc` as a tie-breaker when no `id` order is present; include `id` yourself when you need a different tie-breaker direction such as `id desc`. Use the array form when ordering by multiple fields so the priority is unambiguous.
 
 For the above `Root` definitions, you can make the following requests using `useRequest`:
 
@@ -135,7 +135,7 @@ const { posts, categories, viewer } = useRequest({
 });
 ```
 
-## Native Fate Protocol
+## Native fate protocol
 
 The native protocol keeps tRPC optional. Create a source adapter from your ORM integration, pass it to `createFateServer`, and expose the returned server through a Fetch-compatible handler.
 
@@ -198,7 +198,7 @@ export default defineConfig({
 });
 ```
 
-The generated client uses `createHTTPTransport`:
+With the native transport, the Vite plugin handles the HTTP transport setup. If you need to create a client manually, use `createFateClient` with the same route:
 
 ```tsx
 import { createFateClient } from 'react-fate/client';
@@ -208,7 +208,7 @@ const client = createFateClient({
 });
 ```
 
-The HTTP transport batches operations issued in the same microtask into one `POST /fate` request. Live views use one `GET /fate/live` SSE stream per Fate client and `POST /fate/live` control messages when views subscribe or unsubscribe.
+The HTTP transport batches operations issued in the same microtask into one `POST /fate` request. Live views use one `GET /fate/live` SSE stream per fate client and `POST /fate/live` control messages when views subscribe or unsubscribe.
 
 ### Custom Queries
 
@@ -297,15 +297,17 @@ live.update('Post', post.id, {
 
 `changed` is optional. When provided, fate resolves only the changed fields selected by each live subscription and skips subscriptions that do not select those fields. `createLiveEventBus` is an in-memory fanout bus. It forwards `eventId` to SSE clients, but it does not replay events after reconnects. If your app needs lossless reconnect behavior, provide a durable live bus implementation that uses the `lastEventId` passed to `listen`, `listenConnection`, `subscribe`, and `subscribeConnection`.
 
-## tRPC Fate Setup
+Native SSE connections keep a bounded in-memory queue while events are waiting to be resolved and sent. The default is `1000` queued events per connection. If a client falls behind and exceeds that limit, fate closes the live connection instead of buffering indefinitely. Configure it with `live: { bus: live, maxQueueSize: 500 }`.
+
+## tRPC fate setup
 
 The Prisma and Drizzle tRPC integrations connect your data views to your database, bind fate's standard tRPC procedures, and expose helpers for custom queries and mutations.
 
-Pass the `Root` export from `views.ts` to Fate in your tRPC `init.ts` file. Fate walks that view graph to find the data views it needs. `id` defaults to `"id"`, and Fate uses it as the fallback ordering for cursor pagination. Relations are inferred from the data view and ORM schema: a nested data view is loaded as a singular relation, `list(view)` is loaded as a list relation, and Drizzle join tables are discovered from relation metadata.
+Pass the `Root` export from `views.ts` to fate in your tRPC `init.ts` file. fate walks that view graph to find the data views it needs. `id` defaults to `"id"`, and fate uses it as the fallback ordering for cursor pagination. Relations are inferred from the data view and ORM schema: a nested data view is loaded as a singular relation, `list(view)` is loaded as a list relation, and Drizzle join tables are discovered from relation metadata.
 
 ### Prisma
 
-Use `createPrismaFate` from `@nkzw/fate/server/prisma` next to your tRPC helpers. By default, Fate reads Prisma delegates from `ctx.prisma` using each data view's type name:
+Use `createPrismaFate` from `@nkzw/fate/server/prisma` next to your tRPC helpers. By default, fate reads Prisma delegates from `ctx.prisma` using each data view's type name:
 
 ```tsx
 import { initTRPC } from '@trpc/server';
@@ -354,7 +356,7 @@ return plan.resolve(post);
 
 ### Drizzle
 
-Use `createDrizzleFate` from `@nkzw/fate/server/drizzle`. Fate matches data view type names to Drizzle tables from your schema. The `db` option can be a Drizzle database object or a function that receives your tRPC context and returns a request-scoped database object:
+Use `createDrizzleFate` from `@nkzw/fate/server/drizzle`. fate matches data view type names to Drizzle tables from your schema. The `db` option can be a Drizzle database object or a function that receives your tRPC context and returns a request-scoped database object:
 
 ```tsx
 import { initTRPC } from '@trpc/server';
@@ -393,9 +395,21 @@ export const fate = createDrizzleFate<AppContext, typeof procedure>({
 
 The Drizzle adapter builds SQL queries from your registered data views. It selects only requested columns, hydrates singular, list, and many-to-many relations, supports nested cursor pagination, and hydrates computed `count(...)` dependencies with SQL grouped counts. Count filters may be plain equality objects or Drizzle SQL predicates written as `(columns) => eq(columns.status, 'GOING')`.
 
+Nested paginated relations are resolved with one child-page query per parent row. fate runs those child queries with a default concurrency limit of `10` so a single request cannot flood the database connection pool. Tune this with `nestedPaginationConcurrency` if your database pool or workload needs a different limit:
+
+```tsx
+export const fate = createDrizzleFate<AppContext, typeof procedure>({
+  db,
+  nestedPaginationConcurrency: 5,
+  procedure,
+  schema,
+  views: Root,
+});
+```
+
 For request-specific sorting, prefer a custom root query that validates and translates explicit sort args.
 
-For many-to-many relations, define the join table relations in your Drizzle schema. Fate discovers a join table that points at both the source table and the target table:
+For many-to-many relations, define the join table relations in your Drizzle schema. fate discovers a join table that points at both the source table and the target table:
 
 ```tsx
 export const fate = createDrizzleFate<AppContext, typeof procedure>({
@@ -453,7 +467,7 @@ return post;
 
 ## tRPC Procedures
 
-Use `fate.procedures` to build the standard `byId` and `list` procedures expected by the generated fate client:
+Use `fate.procedures` to build the standard `byId` and `list` procedures expected by fate's request APIs:
 
 ```tsx
 import { fate, router } from '../init.ts';
@@ -547,11 +561,11 @@ export const postDataView = dataView<PostItem>('Post')({
 
 The adapters fetch the hidden `field(...)` and `count(...)` dependencies for you. This keeps private fields like `email` available to the resolver without exposing them to the client selection.
 
-## Configuring the typed client
+## Connecting the Client
 
-Now that we have defined our client views and our tRPC server, we need to connect them with some glue code. We recommend using fate's Vite plugin for convenience.
+Now that we have defined our client views and our server module, add fate's Vite plugin to the client app. The plugin reads your server exports and wires the typed fate APIs into your app.
 
-First, make sure our tRPC `router.ts` file exports the `appRouter` object, `AppRouter` type and all the views we have defined:
+For tRPC, make sure the `router.ts` file exports the `appRouter` object, `AppRouter` type and all the views we have defined:
 
 ```tsx
 import { router } from './init.ts';
@@ -583,11 +597,11 @@ export default defineConfig({
 });
 ```
 
-_Note: fate uses the specified server module name to extract the server types it needs and uses the same module name in the generated client. Make sure that the module is available to the client package's Vite config._
+_Note: fate uses the specified server module name to find the server types it needs. Make sure that the module is available to the client package's Vite config._
 
-During development, the plugin watches the server module and the files it imports. When one of those files changes, fate regenerates the project-local client and invalidates `@nkzw/fate/client` in Vite's module graph.
+During development, the plugin watches the server module and the files it imports. When one of those files changes, fate updates the internal client wiring and invalidates `@nkzw/fate/client` in Vite's module graph.
 
-For a barebones client without React, import the plugin from `@nkzw/fate/vite` and the generated client from `@nkzw/fate/client`. The plugin writes the project-local client for the selected client module path.
+For a barebones client without React, import the plugin from `@nkzw/fate/vite` and the client APIs from `@nkzw/fate/client`. The plugin wires the same server types for the selected import path.
 
 The plugin writes project-local types under `.fate/`. If your TypeScript config does not already include dot-directories, extend the generated config:
 
@@ -599,7 +613,7 @@ The plugin writes project-local types under `.fate/`. If your TypeScript config
 
 ## Creating a _fate_ Client
 
-Now that the Vite plugin provides the client types, all that remains is creating an instance of the fate client, and using it in our React app using the `FateClient` context provider:
+Now that the Vite plugin has connected the types, create a fate client instance and provide it to your React app with the `FateClient` context provider:
 
 ```tsx
 import { httpBatchLink } from '@trpc/client';

package/docs/guide/views.md

@@ -104,7 +104,7 @@ This code fetches the author associated with the Post and makes it available to
 In fate, views are composable and reusable. Instead of inlining the selection, we can define a `UserView` and compose it into the `PostView` like this:
 
 ```tsx
-import type { Post, User } from '@your-org/server/trpc/views';
+import type { Post, User } from '@your-org/server/views';
 import { view } from 'react-fate';
 
 export const UserView = view<User>()({

package/docs/guide/void-integration.md

@@ -33,7 +33,7 @@ export default defineConfig({
 });
 ```
 
-The generated client uses `/fate` for RPC requests and `/fate-live` for live
+The Void transport uses `/fate` for RPC requests and `/fate-live` for live
 updates by default. In SSR, it calls the exported fate server directly. In the
 browser, it uses fetch and the SSE live endpoint.
 
@@ -106,8 +106,8 @@ control messages. `void-fate` does not use WebSockets.
 
 ## React Layout
 
-Wrap your app with `VoidFateClient` from `void-fate/react`. It creates the
-generated fate client and provides it through `react-fate`:
+Wrap your app with `VoidFateClient` from `void-fate/react`. It creates and
+provides the fate client through `react-fate`:
 
 ```tsx
 import { useShared } from '@void/react';

package/lib/index.d.mts

@@ -1,5 +1,5 @@
 import { A as ViewRef, B as RequestMode, C as Snapshot, D as ViewData, E as View, F as __FateSelectionBrand, G as createTRPCTransport, H as createClient, I as isViewTag, J as getSelectionPlan, L as FateMutations, M as ViewSnapshot, N as ViewTag, O as ViewEntity, P as __FateEntityBrand, R as mutation, S as Selection, T as TypeName, U as List, V as RequestOptions, W as Transport, _ as NodesItem, a as Entity, b as RequestResult, c as FateThenable, d as MutationDefinition, f as MutationEntity, g as MutationShape, h as MutationResult, i as ConnectionTag, j as ViewSelection, k as ViewEntityName, l as ListItem, m as MutationInput, n as ConnectionMetadata, o as EntityId, p as MutationIdentifier, r as ConnectionRef, s as FateRoots, t as AnyRecord, u as Mask, v as Pagination, w as TypeConfig, x as RootDefinition, y as Request$1, z as FateClient } from "./types-Dz46PXr3.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-ENh92gyb.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-CirbfZWX.mjs";
 import { n as getListEntries, t as ListEntry } from "./list-4wRNSVgI.mjs";
 
 //#region src/httpTransport.d.ts

package/lib/index.mjs

@@ -1197,7 +1197,7 @@ const getRequestDescriptorKey = (items) => {
 			parts.push(`query:${item.name}:${item.viewSignature}:${item.argsPayload ? hashArgs(item.argsPayload) : ""}`);
 			continue;
 		}
-		if (item.kind === "list") parts.push(`list:${item.name}:${item.viewSignature}:${item.argsPayload ? hashArgs(item.argsPayload) : ""}`);
+		if (item.kind === "list") parts.push(`list:${item.name}:${item.hasItems ? "connection" : "entity"}:${item.viewSignature}:${item.argsPayload ? hashArgs(item.argsPayload) : ""}`);
 	}
 	return parts.join("$");
 };
@@ -2156,7 +2156,7 @@ var FateClient = class {
 				...getPaginationMergeInfo(requestArgs),
 				replace: true
 			});
-			if (!connection.args) this.registerRootList(connection.type, connection.key);
+			if (!filterConnectionArgs(connection.args)) this.registerRootList(connection.type, connection.key);
 			this.store.setList(connection.key, nextListState);
 			return nextListState;
 		}
@@ -2231,7 +2231,8 @@ var FateClient = class {
 		const requestKey = descriptor.key;
 		const existingRequest = this.requests.get(requestKey)?.get(mode);
 		if (existingRequest) {
-			if (revalidateExisting && existingRequest.status !== "pending" && (mode === "network-only" || mode === "stale-while-revalidate" || mode === "cache-first" && (existingRequest.status === "rejected" || existingRequest.status === "fulfilled" && !this.hasRequestData(existingRequest.descriptor)))) this.executeRequestHandle(existingRequest, mode);
+			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);
 			return existingRequest;
 		}
 		const handle = new FateRequestPromise(descriptor, () => this.getRequestResultFromDescriptor(descriptor));
@@ -2553,7 +2554,7 @@ var FateClient = class {
 			ids.push(id);
 			cursors.push(entry.cursor);
 		}
-		if (!item.argsPayload) this.registerRootList(item.type, item.listKey);
+		if (!filterConnectionArgs(item.argsPayload)) this.registerRootList(item.type, item.listKey);
 		const previous = this.store.getListState(item.listKey);
 		this.store.setList(item.listKey, this.mergeListState(previous, ids, cursors, pagination, {
 			...getPaginationMergeInfo(item.argsPayload),

package/lib/{record-ENh92gyb.d.mts → record-CirbfZWX.d.mts}

@@ -87,7 +87,7 @@ type LiveEventBus = Readonly<{
   }) => void;
 }>;
 /**
- * Creates a small in-memory event bus for Fate live view subscriptions.
+ * Creates a small in-memory event bus for fate live view subscriptions.
  *
  * The bus signals that an entity changed and can optionally include changed
  * field paths. The native live handler refetches the selected record, or only
@@ -146,6 +146,7 @@ type MutationDefinition<Context, Input = unknown, Output = unknown> = {
 };
 type LiveConfig = LiveEventBus | {
   bus: LiveEventBus;
+  maxQueueSize?: number;
 };
 type ContextOptions<AdapterContext> = {
   adapterContext?: AdapterContext;

package/lib/server/drizzle.d.mts

@@ -45,6 +45,7 @@ type DrizzleViewConfig<Item extends AnyRecord = AnyRecord, TTable extends Drizzl
 type DrizzleViewsInput = Array<DataView<AnyRecord> | DrizzleViewConfig<AnyRecord>> | DataViewModule;
 type DrizzleSourceAdapterOptions<Context> = {
   db: DrizzleDatabaseInput<Context>;
+  nestedPaginationConcurrency?: number;
   schema?: Record<string, unknown>;
   views: DrizzleViewsInput;
 };
@@ -124,6 +125,7 @@ type SourceInput = {
 };
 declare function createDrizzleSourceAdapter<Context>({
   db,
+  nestedPaginationConcurrency,
   schema,
   views
 }: DrizzleSourceAdapterOptions<Context>): DrizzleSourceAdapter<Context>;

package/lib/server/drizzle.mjs

@@ -1,9 +1,9 @@
 import { t as isRecord } from "../record-AeZJC9fd.mjs";
-import { O as withConnection, S as isDataView, c as resolveSourceConnection, d as createSourceDefinitions, f as createSourcePlan, g as attachComputedState, i as createSourceRegistry, l as collectDataViewConfigs, o as resolveSourceById, p as getDataViewSourceConfig, s as resolveSourceByIds, t as bindSourceProcedures } from "../sourceRouter-Bwpkr062.mjs";
+import { O as withConnection, S as isDataView, c as resolveSourceConnection, d as createSourceDefinitions, f as createSourcePlan, g as attachComputedState, i as createSourceRegistry, l as collectDataViewConfigs, o as resolveSourceById, p as getDataViewSourceConfig, s as resolveSourceByIds, t as bindSourceProcedures } from "../sourceRouter-C22uFcZg.mjs";
 import { and, asc, createTableRelationsHelpers, desc, eq, extractTablesRelationalConfig, getTableColumns, gt, inArray, isTable, lt, normalizeRelation, or, sql } from "drizzle-orm";
 //#region src/server/drizzle.ts
 /**
-* Fate's Drizzle integration.
+* fate's Drizzle integration.
 *
 * @example
 * import { createDrizzleFate } from '@nkzw/fate/server/drizzle';
@@ -29,6 +29,21 @@ const hasPagination = (args) => {
 };
 const getConnectionDirection = (args) => args?.before !== void 0 || typeof args?.last === "number" ? "backward" : "forward";
 const getConnectionSize = (fallback, args) => (typeof args?.first === "number" ? args.first : void 0) ?? (typeof args?.last === "number" ? args.last : void 0) ?? fallback;
+const defaultNestedPaginationConcurrency = 10;
+const getNestedPaginationConcurrency = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : defaultNestedPaginationConcurrency;
+const mapWithConcurrency = async (items, concurrency, fn) => {
+	if (items.length === 0) return [];
+	const results = new Array(items.length);
+	let nextIndex = 0;
+	const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+		while (nextIndex < items.length) {
+			const index = nextIndex++;
+			results[index] = await fn(items[index], index);
+		}
+	});
+	await Promise.all(workers);
+	return results;
+};
 const buildConnection = ({ cursor, direction, items, pageSize }) => {
 	const hasMore = items.length > pageSize;
 	const connectionItems = (direction === "forward" ? items.slice(0, pageSize) : items.slice(-pageSize)).map((node) => ({
@@ -251,7 +266,8 @@ const resolveManyToManyConfig = ({ field, source, sourceRelation, through: throu
 		table: through.table
 	};
 };
-function createDrizzleSourceAdapter({ db, schema, views }) {
+function createDrizzleSourceAdapter({ db, nestedPaginationConcurrency, schema, views }) {
+	const nestedPaginationLimit = getNestedPaginationConcurrency(nestedPaginationConcurrency);
 	const metadata = getDrizzleSchemaMetadata({
 		db,
 		schema
@@ -517,7 +533,7 @@ function createDrizzleSourceAdapter({ db, schema, views }) {
 					through: throughConfig
 				});
 				if (hasPagination(relationNode.args)) {
-					const connections = await Promise.all(items.map(async (item) => [item[sourceRelation.localKey], await fetchManyToManyConnection(item[sourceRelation.localKey], relationNode, sourceRelation, through, ctx)]));
+					const connections = await mapWithConcurrency(items, nestedPaginationLimit, async (item) => [item[sourceRelation.localKey], await fetchManyToManyConnection(item[sourceRelation.localKey], relationNode, sourceRelation, through, ctx)]);
 					const connectionByParentKey = new Map(connections);
 					for (const item of items) item[field] = connectionByParentKey.get(item[sourceRelation.localKey]);
 					continue;
@@ -534,7 +550,7 @@ function createDrizzleSourceAdapter({ db, schema, views }) {
 				continue;
 			}
 			if (hasPagination(relationNode.args)) {
-				const connections = await Promise.all(items.map(async (item) => [item[sourceRelation.localKey], await fetchManyConnection(item[sourceRelation.localKey], relationNode, sourceRelation, ctx)]));
+				const connections = await mapWithConcurrency(items, nestedPaginationLimit, async (item) => [item[sourceRelation.localKey], await fetchManyConnection(item[sourceRelation.localKey], relationNode, sourceRelation, ctx)]);
 				const connectionByParentKey = new Map(connections);
 				for (const item of items) item[field] = connectionByParentKey.get(item[sourceRelation.localKey]);
 				continue;

package/lib/server/prisma.mjs

@@ -1,8 +1,8 @@
 import { t as isRecord } from "../record-AeZJC9fd.mjs";
-import { O as withConnection, S as isDataView, T as toPrismaSelect, c as resolveSourceConnection, d as createSourceDefinitions, f as createSourcePlan, g as attachComputedState, i as createSourceRegistry, l as collectDataViewConfigs, o as resolveSourceById, p as getDataViewSourceConfig, s as resolveSourceByIds, t as bindSourceProcedures } from "../sourceRouter-Bwpkr062.mjs";
+import { O as withConnection, S as isDataView, T as toPrismaSelect, c as resolveSourceConnection, d as createSourceDefinitions, f as createSourcePlan, g as attachComputedState, i as createSourceRegistry, l as collectDataViewConfigs, o as resolveSourceById, p as getDataViewSourceConfig, s as resolveSourceByIds, t as bindSourceProcedures } from "../sourceRouter-C22uFcZg.mjs";
 //#region src/server/prisma.ts
 /**
-* Fate's Prisma integration.
+* fate's Prisma integration.
 *
 * @example
 * import { createPrismaFate } from '@nkzw/fate/server/prisma';

package/lib/server.d.mts

@@ -1,5 +1,5 @@
 import { K as AnyProcedure, t as AnyRecord$1 } from "./types-Dz46PXr3.mjs";
-import { C as liveGlobalConnectionTopic, S as liveEntityTopic, _ as LiveEventBus, b as createLiveEventBus, c as FateServer, d as NativeFateAPI, f as createFateFetchHandler, g as LiveConnectionSourceEvent, h as LiveConnectionEventType, l as FateServerManifest, m as createHonoFateHandler, p as createFateServer, s as FateRequestError, t as isRecord, u as InferFateAPI, v as LiveEventType, x as liveConnectionTopic, y as LiveSourceEvent } from "./record-ENh92gyb.mjs";
+import { C as liveGlobalConnectionTopic, S as liveEntityTopic, _ as LiveEventBus, b as createLiveEventBus, c as FateServer, d as NativeFateAPI, f as createFateFetchHandler, g as LiveConnectionSourceEvent, h as LiveConnectionEventType, l as FateServerManifest, m as createHonoFateHandler, p as createFateServer, s as FateRequestError, t as isRecord, u as InferFateAPI, v as LiveEventType, x as liveConnectionTopic, y as LiveSourceEvent } from "./record-CirbfZWX.mjs";
 import { A as DataViewListOptions, B as dataView, C as connectionArgs, D as CountSelection, E as ComputedSelection, F as FieldSelection, H as list$1, I as ViewPlan, L as computed, M as DataViewOrderDirection, N as DataViewResult, O as CountWhere, P as Entity, R as count, S as ConnectionResult, T as ComputedField, U as resolver, V as field, _ as createSourcePlan, a as resolveSourceConnection, b as ConnectionItem, c as SourceConfig, d as SourceOrderField, f as SourcePlan, g as createNestedSourcePlan, h as SourceRelationConfig, i as resolveSourceByIds, j as DataViewOrderBy, l as SourceDefinition, m as SourceRelation, n as refetchSourceById, p as SourcePlanNode, r as resolveSourceById, s as OrderDirection, t as SourceRegistry, u as SourceOrder, v as getNestedSelection, w as withConnection, x as ConnectionPagination, y as hasNestedSelection, z as createResolver } from "./executor-BqwHdN3n.mjs";
 import { z } from "zod";
 
@@ -74,7 +74,7 @@ type SourceProcedureResult<ById extends boolean | undefined, List extends boolea
   list: ConnectionProcedureResult<ConnectionProcedure>;
 });
 /**
- * Creates standard `byId` and `list` procedures for a Fate source.
+ * Creates standard `byId` and `list` procedures for a fate source.
  *
  * Use this when a router also has custom mutations or custom queries and you
  * want to spread the generated source procedures into that router.