react-fate 0.0.5 → 0.0.7

package/README.md

@@ -526,6 +526,7 @@ Let's assume that our `Post` entity has a tRPC mutation for liking a post called
 
 ```tsx
 const LikeButton = ({ post }: { post: { id: string; likes: number } }) => {
+  const fate = useFateClient();
   const [result, like] = useActionState(fate.actions.post.like, null);
 
   return (
@@ -540,6 +541,7 @@ If you are not using an async component library, you can use React's `useTransit
 
 ```tsx
 const LikeButton = ({ post }: { post: { id: string; likes: number } }) => {
+  const fate = useFateClient();
   const [, startTransition] = useTransition();
   const [result, like, isPending] = useActionState(
     fate.actions.post.like,
@@ -766,7 +768,7 @@ Since clients can send arbitrary selection objects to the server, we need to imp
 Create a `views.ts` file next to your root tRPC router that exports the data views for each type. Here is how you can define a `User` data view for Prisma's `User` model:
 
 ```tsx
-import { dataView, DataViewResult } from '@nkzw/fate/server';
+import { dataView, type Entity } from '@nkzw/fate/server';
 import type { User as PrismaUser } from '../prisma/prisma-client/client.ts';
 
 export const userDataView = dataView<PrismaUser>('User')({
@@ -775,9 +777,7 @@ export const userDataView = dataView<PrismaUser>('User')({
   username: true,
 });
 
-export type User = DataViewResult<typeof userDataView> & {
-  __typename: 'User';
-};
+export type User = Entity<typeof userDataView, 'User'>;
 ```
 
 _Note: Currently, fate provides helpers to integrate with Prisma, but the framework is not coupled to any particular ORM or database. We hope to provide more direct integrations in the future, and are always open to contributions._
@@ -961,10 +961,10 @@ export type AppRouter = typeof appRouter;
 export * from './views.ts';
 ```
 
-_Note: We try to keep magic to a minimum and you can handwrite the [generated client](https://github.com/nkzw-tech/fate/blob/main/example/client/src/lib/fate.generated.ts) if you prefer._
+_Note: We try to keep magic to a minimum and you can handwrite the [generated client](https://github.com/nkzw-tech/fate/blob/main/example/client/src/fate.ts) if you prefer._
 
 ```bash
-pnpm fate generate @your-org/server/trpc/router.ts client/src/lib/fate.generated.ts
+pnpm fate generate @your-org/server/trpc/router.ts client/src/fate.ts
 ```
 
 _Note: fate uses the specified server module name to extract the server types it needs and uses the same module name to import the views into the generated client. Make sure that the module is available both at the root where you are running the CLI and in the client package._
@@ -1043,5 +1043,6 @@ Probably. One day. _Maybe._
 
 - [Relay](https://relay.dev/), [Isograph](https://isograph.dev/) & [GraphQL](https://graphql.org/) for inspiration
 - [Ricky Hanlon](https://x.com/rickyfm) for guidance on Async React
+- [Anthony Powell](https://x.com/Cephalization) for testing fate and providing feedback
 
 **_fate_** was created by [@cnakazawa](https://x.com/cnakazawa) and is maintained by [Nakazawa Tech](https://nakazawa.tech/).

package/lib/index.d.mts

@@ -1,8 +1,9 @@
-import { ConnectionRef, FateClient as FateClient$1, Pagination, Request, RequestOptions, RequestResult, View, ViewData, ViewEntity, ViewEntityName, ViewRef, ViewRef as ViewRef$1, ViewSelection, createClient, createTRPCTransport, mutation, view } from "@nkzw/fate";
+import { ConnectionRef, FateClient as FateClient$1, FateMutations, Pagination, Request, RequestOptions, RequestResult, View, ViewData, ViewEntity, ViewEntityName, ViewRef, ViewRef as ViewRef$1, ViewSelection, createClient, createTRPCTransport, mutation, view } from "@nkzw/fate";
 import { ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/context.d.ts
+type Mutations = keyof ClientMutations extends never ? FateMutations : ClientMutations;
 /**
  * Provider component that supplies a configured `FateClient` to React hooks.
  */
@@ -11,12 +12,12 @@ declare function FateClient({
   client
 }: {
   children: ReactNode;
-  client: FateClient$1;
+  client: FateClient$1<any>;
 }): react_jsx_runtime0.JSX.Element;
 /**
  * Returns the nearest `FateClient` from context.
  */
-declare function useFateClient(): FateClient$1;
+declare function useFateClient<M extends Mutations>(): FateClient$1<M>;
 //#endregion
 //#region src/useView.d.ts
 type ViewEntityWithTypename<V extends View<any, any>> = ViewEntity<V> & {
@@ -59,4 +60,7 @@ declare function useListView<C extends {
   pagination?: Pagination;
 } | null | undefined>(selection: ConnectionSelection, connection: C): [ConnectionItems<NonNullable<C>>, LoadMoreFn | null, LoadMoreFn | null];
 //#endregion
-export { type ConnectionRef, FateClient, type ViewRef, createClient, createTRPCTransport, mutation, useFateClient, useListView, useRequest, useView, view };
+//#region src/index.d.ts
+interface ClientMutations {}
+//#endregion
+export { ClientMutations, type ConnectionRef, FateClient, type ViewRef, createClient, createTRPCTransport, mutation, useFateClient, useListView, useRequest, useView, view };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-fate",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "fate is a modern data client for React.",
   "homepage": "https://github.com/nkzw-tech/fate",
   "repository": {
@@ -28,7 +28,7 @@
     "lib"
   ],
   "dependencies": {
-    "@nkzw/fate": "^0.0.5"
+    "@nkzw/fate": "^0.0.7"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",