create-fate 1.7.7 → 1.9.0

package/templates/fate/graphql/client/src/ui/UserCard.tsx

@@ -1,4 +1,3 @@
-import type { User } from '@app/server/src/graphql/fate.ts';
 import safeParse from '@nkzw/core/safeParse.js';
 import Stack, { VStack } from '@nkzw/stack';
 import { fbs } from 'fbtee';
@@ -7,6 +6,7 @@ import { view } from 'react-fate';
 import { useFateClient } from 'react-fate';
 import { ViewRef } from 'react-fate';
 import { useView } from 'react-fate';
+import type { User } from '../fate/graphql.ts';
 import { Button } from '../ui/Button.tsx';
 import Card from '../ui/Card.tsx';
 import AuthClient from '../user/AuthClient.tsx';

package/templates/fate/graphql/client/vite.config.ts

@@ -29,7 +29,7 @@ export default defineConfig({
       voidReact({ react: { compiler: true } }),
     ]) ?? []),
     fate({
-      module: '@app/server/src/graphql/fate.ts',
+      module: './src/fate/graphql.ts',
       transport: 'graphql',
     }),
   ],

package/templates/fate/graphql/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",
     "prisma": "^7.10.0",
     "typescript": "^7.0.2",
@@ -39,5 +38,5 @@
     "node": ">=24.0.0",
     "pnpm": ">=11.0.0"
   },
-  "packageManager": "pnpm@11.0.6"
+  "packageManager": "pnpm@12.6.0"
 }

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

@@ -5,16 +5,16 @@ packages:
 allowBuilds:
   '@prisma/engines': true
   '@swc/core': true
-  better-sqlite3: true
+  better-sqlite3: false
   esbuild: true
   prisma: true
   sharp: true
   workerd: true
 
 catalog:
-  vite: npm:@voidzero-dev/vite-plus-core@1.0.0
-  vite-plus: 1.0.0
-  vitest: 5.0.2
+  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'
@@ -31,7 +31,7 @@ onlyBuiltDependencies:
   - unrs-resolver
 
 overrides:
-  better-auth: 1.7.7
+  better-auth: 1.7.11
   kysely: 0.28.17
   vite: 'catalog:'
   vitest: 'catalog:'

package/templates/fate/graphql/server/README.md

@@ -14,14 +14,15 @@ vp run dev
 
 The server defaults to `http://localhost:9000/graphql`.
 
-To generate the Fate client against this server, point the Vite plugin at:
+The client mapping imports the SDL exported from the Pothos schema during `dev:setup`. From the client directory, configure the Vite plugin with:
 
 ```ts
 fate({
-  module: '@app/server/src/graphql/fate.ts',
+  module: './src/fate/graphql.ts',
   transport: 'graphql',
 });
 ```
 
-The generated client keeps the same Fate roots, views, mutations, store, and cache behavior;
-only the transport and server module change.
+Fate derives entity fields, connection roots, mutation inputs, and selected results from the schema.
+The server data views in `src/graphql/views.ts` remain responsible for live-event resolution,
+including authorization and computed fields. They do not define the GraphQL client types.

package/templates/fate/graphql/server/package.json

@@ -16,37 +16,37 @@
     "prisma": "prisma"
   },
   "dependencies": {
-    "@graphql-tools/utils": "^12.0.0",
-    "@graphql-yoga/plugin-graphql-sse": "^3.22.0",
-    "@hono/node-server": "^2.1.1",
+    "@graphql-tools/utils": "^12.1.0",
+    "@graphql-yoga/plugin-graphql-sse": "^3.24.6",
+    "@hono/node-server": "^2.1.5",
     "@nkzw/core": "^1.3.1",
     "@nkzw/define-env": "^1.1.0",
     "@nkzw/fate": "latest",
-    "@pothos/core": "^4.13.1",
-    "@pothos/plugin-complexity": "^4.2.1",
-    "@pothos/plugin-directives": "^4.3.1",
-    "@pothos/plugin-prisma": "^4.15.0",
-    "@pothos/plugin-relay": "^4.7.1",
-    "@pothos/plugin-scope-auth": "^4.1.7",
-    "@prisma/adapter-pg": "^7.10.0",
-    "@prisma/client": "^7.10.0",
-    "better-auth": "^1.7.7",
+    "@pothos/core": "^4.15.1",
+    "@pothos/plugin-complexity": "^4.2.3",
+    "@pothos/plugin-directives": "^4.3.2",
+    "@pothos/plugin-prisma": "^4.17.0",
+    "@pothos/plugin-relay": "^4.8.1",
+    "@pothos/plugin-scope-auth": "^4.2.1",
+    "@prisma/adapter-pg": "^7.10.1",
+    "@prisma/client": "^7.10.1",
+    "better-auth": "^1.7.11",
     "graphql": "^17.0.2",
-    "graphql-yoga": "^5.22.0",
-    "hono": "^4.13.5"
+    "graphql-yoga": "^5.24.6",
+    "hono": "^4.13.13"
   },
   "devDependencies": {
     "@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",
+    "@oxc-node/core": "^0.1.7",
+    "@swc/core": "^1.16.18",
+    "@types/node": "^26.6.5",
+    "dotenv": "^18.0.8",
     "glob": "^13.0.6",
     "nodemon": "^3.1.14",
     "oxfmt": "^0.65.0",
     "prisma": "^7.10.0",
-    "prisma-json-types-generator": "^5.1.1",
+    "prisma-json-types-generator": "^5.2.0",
     "typescript": "^7.0.2",
     "vite-plus": "catalog:",
     "vitest": "catalog:"

package/templates/fate/graphql/server/scripts/generate-graphql.tsx

@@ -3,6 +3,8 @@ import { createHash } from 'node:crypto';
 import { writeFileSync } from 'node:fs';
 import { join, posix, relative, sep } from 'node:path';
 import { styleText } from 'node:util';
+import { printSchemaWithDirectives } from '@graphql-tools/utils';
+import dotenv from 'dotenv';
 import { globSync } from 'glob';
 import { format } from 'oxfmt';
 
@@ -37,4 +39,8 @@ writeFileSync(
   ),
 );
 
-console.log(styleText(['green', 'bold'], '✓ Done generating GraphQL schema import map.'));
+dotenv.config({ path: join(root, '.env'), quiet: true });
+const { default: schema } = await import('../src/graphql/schema.tsx');
+writeFileSync(join(path, 'schema.graphql'), printSchemaWithDirectives(schema), 'utf8');
+
+console.log(styleText(['green', 'bold'], '✓ Done generating GraphQL schema and import map.'));

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/AGENTS.md

@@ -1,3 +1,23 @@
+# Using fate
+
+Before working on fate, read only the relevant Markdown docs in `node_modules/react-fate/docs/`. Start with `index.md` to find guides, integrations, and API references. The docs match the installed package version. Online documentation is at [fate.technology](https://fate.technology/).
+
+<!--VITE PLUS START-->
+
+# Using Vite+, the Unified Toolchain for the Web
+
+This project is using Vite+, a unified toolchain built on top of Vite, Rolldown, Vitest, tsdown, Oxlint, Oxfmt, and Vite Task. Vite+ wraps runtime management, package management, and frontend tooling in a single global CLI called `vp`. Vite+ is distinct from Vite, and it invokes Vite through `vp dev` and `vp build`. Run `vp help` to print a list of commands and `vp <command> --help` for information about a specific command.
+
+Docs are local at `node_modules/vite-plus/docs` or online at https://viteplus.dev/guide/.
+
+## Review Checklist
+
+- [ ] Run `vp install` after pulling remote changes and before getting started.
+- [ ] Run `vp check` and `vp test` to format, lint, type check and test changes.
+- [ ] Check if there are `vite.config.ts` tasks or `package.json` scripts necessary for validation, run via `vp run <script>`.
+
 Run `vp run test:all` to verify changes.
 
 Run `vp check --fix` to fix formatting and lint errors.
+
+<!--VITE PLUS END-->

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

@@ -34,22 +34,24 @@ 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 the schema exported by your existing
+GraphQL server, then edit `src/fate/graphql.ts` to map application names:
 
-- `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 SDL used during generation.
+- `fateGraphQL.roots` exposes query fields and optionally maps different names
+  through `field`. Entity and connection types are inferred from the schema.
+- `fateGraphQL.mutations` maps application mutation names to schema fields.
+- `fateGraphQL.scalars` optionally describes custom scalar wire types. Unmapped
+  custom scalars are `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 it with your
+server's actual contract, including nullability 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.
+Run `vp run fate:generate` to generate `.fate/schema.generated.ts`. Client views
+use `GraphQLEntities` from that file; there are no handwritten entity or mutation
+input types to keep synchronized. The schema and generation imports are excluded
+from the browser client.
 
 ## Development
 
@@ -74,7 +76,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/_gitignore

@@ -1,6 +1,7 @@
 .fate/
 **/.fate/
 .void/
+.wrangler/
 **/.void/
 .eslintcache
 .pnpm-debug.log

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

@@ -23,29 +23,30 @@
   },
   "dependencies": {
     "@nkzw/fate": "latest",
-    "@void/react": "^0.24.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": "^0.24.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.0.0
-  vite-plus: 1.0.0
-  vitest: 5.0.2
+  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/App.css

@@ -5,13 +5,7 @@ body {
   background: #f8fafc;
   color: #111827;
   font-family:
-    Inter,
-    ui-sans-serif,
-    system-ui,
-    -apple-system,
-    BlinkMacSystemFont,
-    'Segoe UI',
-    sans-serif;
+    Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
 }
 
 button,

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!
+}