create-fate 1.8.0 → 1.10.0

package/templates/fate/graphql/server/src/graphql/fate.ts

@@ -1,4 +1,3 @@
-import { graphqlMutation } from '@nkzw/fate';
 import { createLiveEventBus } from '@nkzw/fate/server';
 import { createPrismaSourceAdapter } from '@nkzw/fate/server/prisma';
 import type { AppContext } from './context.tsx';
@@ -11,38 +10,8 @@ import {
   Root,
   tagDataView,
   userDataView,
-  type Comment,
-  type Post,
-  type User,
 } from './views.ts';
 
-type FateMutationInput<Input extends Record<string, unknown>> = Input & {
-  args?: Record<string, unknown>;
-};
-
-export type PostAddInput = FateMutationInput<{
-  content: string;
-  title: string;
-}>;
-export type PostLikeInput = FateMutationInput<{
-  error?: 'boundary' | 'callSite';
-  id: string;
-  slow?: boolean;
-}>;
-export type PostUnlikeInput = FateMutationInput<{
-  id: string;
-}>;
-export type CommentAddInput = FateMutationInput<{
-  content: string;
-  postId: string;
-}>;
-export type CommentDeleteInput = FateMutationInput<{
-  id: string;
-}>;
-export type UserUpdateInput = FateMutationInput<{
-  name: string;
-}>;
-
 export const live = createLiveEventBus();
 
 export const fate = createPrismaSourceAdapter<AppContext>({
@@ -58,28 +27,3 @@ export const viewsByType = {
   Tag: tagDataView,
   User: userDataView,
 } as const;
-
-export const fateGraphQL = {
-  mutations: {
-    'comment.add': graphqlMutation<Comment, CommentAddInput, Comment>('Comment', {
-      field: 'commentAdd',
-    }),
-    'comment.delete': graphqlMutation<Comment, CommentDeleteInput, Comment>('Comment', {
-      field: 'commentDelete',
-    }),
-    'post.add': graphqlMutation<Post, PostAddInput, Post>('Post', {
-      field: 'postAdd',
-    }),
-    'post.like': graphqlMutation<Post, PostLikeInput, Post>('Post', {
-      field: 'postLike',
-    }),
-    'post.unlike': graphqlMutation<Post, PostUnlikeInput, Post>('Post', {
-      field: 'postUnlike',
-    }),
-    'user.update': graphqlMutation<User, UserUpdateInput, User>('User', {
-      field: 'userUpdate',
-    }),
-  },
-} as const;
-
-export * from './views.ts';

package/templates/fate/graphql/server/src/graphql/schema.tsx

@@ -1,14 +1,33 @@
 import { writeFileSync } from 'node:fs';
 import './schemaImportMap.tsx';
-import { join } from 'node:path';
 import { printSchemaWithDirectives } from '@graphql-tools/utils';
+import {
+  DirectiveLocation,
+  GraphQLBoolean,
+  GraphQLDirective,
+  GraphQLString,
+  specifiedDirectives,
+} from 'graphql';
 import builder from './builder.tsx';
 
-const schema = builder.toSchema();
+const schema = builder.toSchema({
+  directives: [
+    ...specifiedDirectives,
+    new GraphQLDirective({
+      args: { role: { type: GraphQLString }, self: { type: GraphQLBoolean } },
+      locations: [
+        DirectiveLocation.FIELD_DEFINITION,
+        DirectiveLocation.OBJECT,
+        DirectiveLocation.INTERFACE,
+      ],
+      name: 'auth',
+    }),
+  ],
+});
 
 if (process.env.NODE_ENV === 'development') {
   writeFileSync(
-    join(process.cwd(), 'src/graphql/schema.graphql'),
+    new URL('./schema.graphql', import.meta.url),
     printSchemaWithDirectives(schema),
     'utf8',
   );

package/templates/fate/graphql/server/src/graphql/views.ts

@@ -138,49 +138,6 @@ export const eventDataView = dataView<EventItem>('Event')({
   type: true,
 });
 
-export type User = Entity<typeof userDataView, 'User'>;
-export type Tag = Entity<typeof tagDataView, 'Tag'>;
-export type Comment = Entity<
-  typeof commentDataView,
-  'Comment',
-  {
-    author: User;
-    post: Post;
-  }
->;
-export type EventAttendee = Entity<
-  typeof eventAttendeeDataView,
-  'EventAttendee',
-  {
-    user: User;
-  }
->;
-export type Post = Entity<
-  typeof postDataView,
-  'Post',
-  {
-    author: User;
-    category: Category | null;
-    comments: Array<Comment>;
-    tags: Array<Tag>;
-  }
->;
-export type Category = Entity<
-  typeof categoryDataView,
-  'Category',
-  {
-    posts: Array<Post>;
-  }
->;
-export type Event = Entity<
-  typeof eventDataView,
-  'Event',
-  {
-    attendees: Array<EventAttendee>;
-    host: User;
-  }
->;
-
 export const Root = {
   categories: list(categoryDataView, { orderBy: { createdAt: 'asc', id: 'asc' } }),
   commentSearch: {

package/templates/fate/graphql-client/README.md

@@ -34,22 +34,16 @@ VITE_GRAPHQL_URL="https://api.example.com/graphql" vp run build
 
 These `VITE_*` values are embedded in the client bundle. Do not put credentials in them. Production builds do not read `.env`.
 
-Then edit `src/fate/graphql.ts`. This file is the mapping layer between your GraphQL schema and _fate_:
+Replace `src/fate/schema.graphql` with your server's schema, then edit `src/fate/graphql.ts`:
 
-- `dataView(...)` describes the fields React components are allowed to select.
-- `Root` describes the root GraphQL fields _fate_ can request.
-- `fateGraphQL.roots` maps _fate_ root names to GraphQL field names.
-- `fateGraphQL.mutations` maps _fate_ mutation names to GraphQL mutation fields.
+- `fateGraphQL.schema` supplies the schema used to generate client types.
+- `fateGraphQL.roots` exposes query fields. Use `field` to map a different name.
+- `fateGraphQL.mutations` maps application mutation names to schema fields.
+- `fateGraphQL.scalars` optionally describes custom scalar types, which default to `unknown`.
 
-The sample assumes your GraphQL server exposes:
+The sample schema includes `viewer`, `posts(first:, after:)`, `postLike(input:)`, `node(id:)`, and `nodes(ids:)`, with Relay-style connections. Replace these with your server's fields and arguments.
 
-- `viewer`
-- `posts(first:, after:)`
-- `node(id:)` or `nodes(ids:)`
-- Relay-style connections with `edges`, `cursor`, `node`, and `pageInfo`
-- Entity objects with stable `id` and `__typename`
-
-Replace the sample `User` and `Post` views with your own schema types.
+After changing the schema or mapping, run `vp run fate:generate`. Client views use `GraphQLEntities` from the generated `.fate/schema.generated.ts`. The schema stays out of the browser bundle.
 
 ## Development
 
@@ -74,7 +68,7 @@ vp run dev
 Common commands:
 
 - `vp run dev` starts the client.
-- `vp run fate:generate` refreshes _fate_ client support after changing `src/fate/graphql.ts`.
+- `vp run fate:generate` refreshes _fate_ client support after changing the schema or `src/fate/graphql.ts`.
 - `vp check --fix` formats, lints, and type-checks the project.
 - `vp run test:all` verifies the project.
 

package/templates/fate/graphql-client/package.json

@@ -23,29 +23,30 @@
   },
   "dependencies": {
     "@nkzw/fate": "latest",
-    "@void/react": "^1.1.0",
+    "@void/react": "^1.1.12",
     "fbtee": "^5.0.0",
-    "graphql-sse": "^2.6.1",
-    "lucide-react": "^1.34.0",
-    "react": "^19.3.0",
-    "react-dom": "^19.3.0",
-    "react-error-boundary": "^6.1.3",
+    "graphql-sse": "^2.6.3",
+    "lucide-react": "^1.59.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "react-error-boundary": "^6.1.6",
     "react-fate": "latest",
-    "void": "^1.1.0"
+    "void": "^1.1.12"
   },
   "devDependencies": {
     "@nkzw/eslint-plugin": "^2.0.0",
     "@nkzw/fbtee-compiler": "^5.0.0",
     "@nkzw/oxlint-config": "^2.0.1",
     "@nkzw/vite-plugin-fbtee": "^5.0.0",
-    "@oxc-node/core": "^0.1.0",
-    "@swc/core": "^1.16.1",
+    "@oxc-node/core": "^0.1.7",
+    "@swc/core": "^1.16.18",
     "@tailwindcss/vite": "^4.3.3",
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
-    "@vitejs/plugin-react": "^6.1.0",
-    "oxc-transform-react": "^0.147.0",
+    "@vitejs/plugin-react": "^6.1.2",
+    "graphql": "^17.0.2",
+    "oxc-transform-react": "^0.154.0",
     "tailwindcss": "^4.3.3",
     "typescript": "^7.0.2",
     "vite": "catalog:",
@@ -61,5 +62,5 @@
     "node": ">=24.0.0",
     "pnpm": ">=11.0.0"
   },
-  "packageManager": "pnpm@11.0.6"
+  "packageManager": "pnpm@12.6.0"
 }

package/templates/fate/graphql-client/pages/index.tsx

@@ -90,8 +90,8 @@ export default function HomePage() {
         </h1>
         <p className="max-w-2xl text-slate-600 dark:text-slate-300">
           <fbt desc="GraphQL client setup instructions">
-            Replace the sample views in <code>src/fate/graphql.ts</code> with your schema types and
-            point <code>VITE_GRAPHQL_URL</code> at your API.
+            Replace <code>src/fate/schema.graphql</code> with your server schema and point{' '}
+            <code>VITE_GRAPHQL_URL</code> at your API.
           </fbt>
         </p>
       </header>

package/templates/fate/graphql-client/pnpm-workspace.yaml

@@ -3,15 +3,15 @@ packages:
 
 allowBuilds:
   '@swc/core': true
-  better-sqlite3: true
+  better-sqlite3: false
   esbuild: true
   sharp: true
   workerd: true
 
 catalog:
-  vite: npm:@voidzero-dev/vite-plus-core@1.2.0
-  vite-plus: 1.2.0
-  vitest: 5.0.4
+  vite: npm:@voidzero-dev/vite-plus-core@1.3.0
+  vite-plus: 1.3.0
+  vitest: 5.0.5
 
 minimumReleaseAgeExclude:
   - '@voidzero-dev/vite-plus-core'
@@ -20,14 +20,13 @@ minimumReleaseAgeExclude:
 onlyBuiltDependencies:
   - '@swc/core'
   - '@tailwindcss/oxide'
-  - better-sqlite3
   - esbuild
   - msgpackr-extract
   - sharp
   - workerd
 
 overrides:
-  better-auth: 1.7.7
+  better-auth: 1.7.11
   vite: 'catalog:'
   vitest: 'catalog:'
 

package/templates/fate/graphql-client/src/fate/graphql.ts

@@ -1,52 +1,11 @@
-import { graphqlMutation } from '@nkzw/fate';
-import { dataView, list, type Entity } from '@nkzw/fate/server';
+import type { GraphQLEntities } from '../../.fate/schema.generated.ts';
+import schema from './schema.graphql?raw';
 
-type GraphQLUser = {
-  id: string;
-  name?: string | null;
-  username?: string | null;
-};
-
-type GraphQLPost = {
-  author?: GraphQLUser | null;
-  id: string;
-  title: string;
-};
-
-export const userDataView = dataView<GraphQLUser>('User')({
-  id: true,
-  name: true,
-  username: true,
-});
-
-export const postDataView = dataView<GraphQLPost>('Post')({
-  author: userDataView,
-  id: true,
-  title: true,
-});
-
-export type User = Entity<typeof userDataView, 'User'>;
-export type Post = Entity<
-  typeof postDataView,
-  'Post',
-  {
-    author: User | null;
-  }
->;
-
-export const Root = {
-  posts: list(postDataView),
-  viewer: userDataView,
-};
+export type User = GraphQLEntities['User'];
+export type Post = GraphQLEntities['Post'];
 
 export const fateGraphQL = {
-  mutations: {
-    'post.like': graphqlMutation<Post, { id: string }, Post>('Post', {
-      field: 'postLike',
-    }),
-  },
-  roots: {
-    posts: { field: 'posts' },
-    viewer: { field: 'viewer' },
-  },
+  mutations: { 'post.like': { entity: 'Post', field: 'postLike' } },
+  roots: { posts: {}, viewer: {} },
+  schema,
 } as const;

package/templates/fate/graphql-client/src/fate/schema.graphql

@@ -0,0 +1,48 @@
+# Replace this sample with the schema exported by your GraphQL server.
+interface Node {
+  id: ID!
+}
+
+type User implements Node {
+  id: ID!
+  name: String
+  username: String
+}
+
+type Post implements Node {
+  author: User
+  id: ID!
+  title: String!
+}
+
+type Query {
+  node(id: ID!): Node
+  nodes(ids: [ID!]!): [Node]!
+  posts(first: Int, after: String): PostConnection!
+  viewer: User
+}
+
+type PostConnection {
+  edges: [PostEdge!]!
+  pageInfo: PageInfo!
+}
+
+type PostEdge {
+  cursor: String!
+  node: Post!
+}
+
+type PageInfo {
+  startCursor: String
+  endCursor: String
+  hasNextPage: Boolean!
+  hasPreviousPage: Boolean!
+}
+
+type Mutation {
+  postLike(input: PostLikeInput!): Post
+}
+
+input PostLikeInput {
+  id: ID!
+}

package/templates/fate/http/client/package.json

@@ -21,33 +21,33 @@
   },
   "dependencies": {
     "@app/server": "workspace:*",
-    "@hono/node-server": "^2.1.1",
+    "@hono/node-server": "^2.1.5",
     "@nkzw/core": "^1.3.1",
     "@nkzw/define-env": "^1.1.0",
     "@nkzw/stack": "^2.3.2",
-    "@radix-ui/react-slot": "^1.3.3",
-    "@void/react": "^1.1.0",
-    "better-auth": "^1.7.7",
+    "@radix-ui/react-slot": "^1.5.0",
+    "@void/react": "^1.1.12",
+    "better-auth": "^1.7.11",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "fbtee": "^5.0.0",
-    "lucide-react": "^1.34.0",
-    "react": "^19.3.0",
-    "react-dom": "^19.3.0",
-    "react-error-boundary": "^6.1.3",
+    "lucide-react": "^1.59.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "react-error-boundary": "^6.1.6",
     "react-fate": "latest",
-    "tailwind-merge": "^3.6.0",
-    "void": "^1.1.0"
+    "tailwind-merge": "^3.7.0",
+    "void": "^1.1.12"
   },
   "devDependencies": {
     "@nkzw/fbtee-compiler": "^5.0.0",
     "@nkzw/vite-plugin-fbtee": "^5.0.0",
     "@tailwindcss/vite": "^4.3.3",
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
-    "@vitejs/plugin-react": "^6.1.0",
-    "oxc-transform-react": "^0.147.0",
+    "@vitejs/plugin-react": "^6.1.2",
+    "oxc-transform-react": "^0.154.0",
     "tailwindcss": "^4.3.3",
     "vite": "catalog:",
     "vite-plus": "catalog:"

package/templates/fate/http/client/src/ui/PostCard.tsx

@@ -74,7 +74,11 @@ const CommentInput = ({
   post,
 }: {
   error?: unknown;
-  post: { commentCount: number; id: string };
+  post: {
+    commentCount: number;
+    comments: Deferred<{ items: ReadonlyArray<{ node: ViewRef<'Comment'> }> }>;
+    id: string;
+  };
 }) => {
   const fate = useFateClient();
   const { data: session } = AuthClient.useSession();
@@ -90,6 +94,7 @@ const CommentInput = ({
 
     const result = await fate.mutations.comment.add({
       input: { content, postId: post.id },
+      insert: { into: post.comments, position: 'after' },
       optimistic: {
         author: user
           ? {

package/templates/fate/http/package.json

@@ -10,7 +10,7 @@
   },
   "type": "module",
   "scripts": {
-    "build": "dotenv -e server/.env -- vp run --filter '@app/client' --filter '@app/server' build",
+    "build": "dotenv run -f server/.env -- vp run --filter '@app/client' --filter '@app/server' build",
     "dev": "npm-run-all --parallel dev:client dev:server",
     "dev:client": "cd client && vp dev",
     "dev:server": "cd server && vp run dev",
@@ -23,11 +23,10 @@
     "@app/server": "workspace:*",
     "@nkzw/eslint-plugin": "^2.0.0",
     "@nkzw/oxlint-config": "^2.0.1",
-    "@oxc-node/core": "^0.1.0",
-    "@swc/core": "^1.16.1",
-    "@types/node": "^26.4.0",
-    "dotenv": "^17.4.2",
-    "dotenv-cli": "^11.0.0",
+    "@oxc-node/core": "^0.1.7",
+    "@swc/core": "^1.16.18",
+    "@types/node": "^26.6.5",
+    "dotenv": "^18.0.8",
     "npm-run-all2": "^9.0.3",
     "typescript": "^7.0.2",
     "vite": "catalog:",
@@ -38,5 +37,5 @@
     "node": ">=24.0.0",
     "pnpm": ">=11.0.0"
   },
-  "packageManager": "pnpm@11.0.6"
+  "packageManager": "pnpm@12.6.0"
 }

package/templates/fate/http/pnpm-workspace.yaml

@@ -4,16 +4,16 @@ packages:
 
 allowBuilds:
   '@swc/core': true
-  better-sqlite3: true
+  better-sqlite3: false
   drizzle-kit: true
   esbuild: true
   sharp: true
   workerd: true
 
 catalog:
-  vite: npm:@voidzero-dev/vite-plus-core@1.2.0
-  vite-plus: 1.2.0
-  vitest: 5.0.4
+  vite: npm:@voidzero-dev/vite-plus-core@1.3.0
+  vite-plus: 1.3.0
+  vitest: 5.0.5
 
 minimumReleaseAgeExclude:
   - '@voidzero-dev/vite-plus-core'
@@ -28,7 +28,7 @@ onlyBuiltDependencies:
   - unrs-resolver
 
 overrides:
-  better-auth: 1.7.7
+  better-auth: 1.7.11
   drizzle-orm: 0.45.4
   kysely: 0.28.17
   vite: 'catalog:'

package/templates/fate/http/server/package.json

@@ -20,20 +20,20 @@
     "drizzle": "drizzle-kit --config drizzle.config.ts"
   },
   "dependencies": {
-    "@hono/node-server": "^2.1.1",
+    "@hono/node-server": "^2.1.5",
     "@nkzw/core": "^1.3.1",
     "@nkzw/define-env": "^1.1.0",
     "@nkzw/fate": "latest",
-    "better-auth": "^1.7.7",
+    "better-auth": "^1.7.11",
     "drizzle-orm": "^0.45.4",
-    "hono": "^4.13.5",
-    "pg": "^8.23.1",
-    "zod": "^4.4.3"
+    "hono": "^4.13.13",
+    "pg": "8.23.1",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.6.5",
     "@types/pg": "^8.23.1",
-    "drizzle-kit": "^0.31.10",
+    "drizzle-kit": "^0.31.11",
     "nodemon": "^3.1.14",
     "vite-plus": "catalog:"
   },

package/templates/fate/prisma/client/package.json

@@ -21,35 +21,35 @@
   },
   "dependencies": {
     "@app/server": "workspace:*",
-    "@hono/node-server": "^2.1.1",
+    "@hono/node-server": "^2.1.5",
     "@nkzw/core": "^1.3.1",
     "@nkzw/define-env": "^1.1.0",
     "@nkzw/stack": "^2.3.2",
-    "@radix-ui/react-slot": "^1.3.3",
-    "@trpc/client": "^11.18.0",
-    "@void/react": "^1.1.0",
-    "better-auth": "^1.7.7",
+    "@radix-ui/react-slot": "^1.5.0",
+    "@trpc/client": "^11.19.0",
+    "@void/react": "^1.1.12",
+    "better-auth": "^1.7.11",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "fbtee": "^5.0.0",
-    "lucide-react": "^1.34.0",
-    "react": "^19.3.0",
-    "react-dom": "^19.3.0",
-    "react-error-boundary": "^6.1.3",
+    "lucide-react": "^1.59.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "react-error-boundary": "^6.1.6",
     "react-fate": "latest",
-    "tailwind-merge": "^3.6.0",
-    "void": "^1.1.0"
+    "tailwind-merge": "^3.7.0",
+    "void": "^1.1.12"
   },
   "devDependencies": {
     "@nkzw/fbtee-compiler": "^5.0.0",
     "@nkzw/vite-plugin-fbtee": "^5.0.0",
     "@tailwindcss/vite": "^4.3.3",
-    "@trpc/server": "^11.18.0",
-    "@types/node": "^26.4.0",
+    "@trpc/server": "^11.19.0",
+    "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
-    "@vitejs/plugin-react": "^6.1.0",
-    "oxc-transform-react": "^0.147.0",
+    "@vitejs/plugin-react": "^6.1.2",
+    "oxc-transform-react": "^0.154.0",
     "tailwindcss": "^4.3.3",
     "vite": "catalog:",
     "vite-plus": "catalog:"

package/templates/fate/prisma/client/src/ui/PostCard.tsx

@@ -74,7 +74,11 @@ const CommentInput = ({
   post,
 }: {
   error?: unknown;
-  post: { commentCount: number; id: string };
+  post: {
+    commentCount: number;
+    comments: Deferred<{ items: ReadonlyArray<{ node: ViewRef<'Comment'> }> }>;
+    id: string;
+  };
 }) => {
   const fate = useFateClient();
   const { data: session } = AuthClient.useSession();
@@ -90,6 +94,7 @@ const CommentInput = ({
 
     const result = await fate.mutations.comment.add({
       input: { content, postId: post.id },
+      insert: { into: post.comments, position: 'after' },
       optimistic: {
         author: user
           ? {