@nkzw/fate 1.4.0 → 1.5.0

package/lib/vite.mjs

@@ -1,3 +1,4 @@
+import { t as sortObjectKeys } from "./sortObjectKeys-yhuitEQZ.mjs";
 import path from "node:path";
 import { runnerImport, transformWithOxc } from "vite";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
@@ -69,12 +70,7 @@ const formatTypes = (types) => {
 };
 const indentBlock = (value, spaces) => value.split("\n").map((line) => line.length ? `${" ".repeat(spaces)}${line}` : line).join("\n");
 const compareStrings = (left, right) => left < right ? -1 : left > right ? 1 : 0;
-const canonicalizeHydrationScopeValue = (value) => {
-	if (Array.isArray(value)) return value.map(canonicalizeHydrationScopeValue);
-	if (!value || typeof value !== "object") return value;
-	return Object.fromEntries(Object.entries(value).sort(([left], [right]) => compareStrings(left, right)).map(([key, entry]) => [key, canonicalizeHydrationScopeValue(entry)]));
-};
-const getHydrationScope = (moduleName, roots, types) => JSON.stringify(canonicalizeHydrationScopeValue({
+const getHydrationScope = (moduleName, roots, types) => JSON.stringify(sortObjectKeys({
 	moduleName,
 	roots,
 	types: [...types].sort((left, right) => compareStrings(left.type, right.type))
@@ -260,24 +256,27 @@ export type GeneratedClientMutations = typeof mutations;
 export type GeneratedClientRoots = typeof roots;
 const hydrationScope = ${JSON.stringify(getHydrationScope(moduleName, roots, types))} as const;
 
+const trpcMutations = {
+${mutationResolverBlock}
+} as const;
+
 export const createFateClient = (options: {
   links: Parameters<typeof createTRPCProxyClient>[0]['links'];
 ${indentBlock(liveOptions.trim(), 2)}
+  mutateDurably?: Parameters<typeof createTRPCTransport<AppRouter, typeof trpcMutations>>[0]['mutateDurably'];
   onLiveError?: (error: unknown) => void;
+  persistence?: import("@nkzw/fate").Persistence;
 }) => {
   const trpcClient = createTRPCProxyClient<AppRouter>(options);
 ${liveTransportSetup}
 
-  const trpcMutations = {
-${mutationResolverBlock}
-  } as const;
-
   const transport = createTRPCTransport<AppRouter, typeof trpcMutations>({
     byId: {
 ${byIdBlock}
     },
     client: trpcClient,
 ${queriesBlock}${listsBlock}    mutations: trpcMutations,
+    mutateDurably: options.mutateDurably,
   });
 ${liveTransportAssignment}
 
@@ -285,6 +284,7 @@ ${liveTransportAssignment}
     hydrationScope,
     mutations,
     onLiveError: options.onLiveError,
+    persistence: options.persistence,
     roots,
     transport,
     types: ${typesBlock.trimStart()},
@@ -395,13 +395,16 @@ export const createFateClient = (options: {
   fetch?: typeof fetch;
   headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
   live?: Parameters<typeof createGraphQLTransport>[0]['live'];
+  mutateDurably?: Parameters<typeof createGraphQLTransport<GraphQLTransportMutations>>[0]['mutateDurably'];
   onLiveError?: (error: unknown) => void;
+  persistence?: import("@nkzw/fate").Persistence;
   url: string | URL;
 }) =>
   createClient<[GeneratedClientRoots, GeneratedClientMutations], typeof hydrationScope>({
     hydrationScope,
     mutations,
     onLiveError: options.onLiveError,
+    persistence: options.persistence,
     roots,
     transport: createGraphQLTransport<GraphQLTransportMutations>({
       decodeNodeId: options.decodeNodeId,
@@ -411,6 +414,7 @@ export const createFateClient = (options: {
       headers: options.headers,
       live: options.live,
       mutations: graphQL.mutations,
+      mutateDurably: options.mutateDurably,
       roots: graphQL.roots,
       types: ${typesBlock.trimStart()},
       url: options.url,
@@ -537,6 +541,7 @@ const toEndpointUrl = (url: string | URL | undefined, path: string, origin: stri
   liveRetryMs?: number;
   liveUrl?: string | URL;
   onLiveError?: (error: unknown) => void;
+  persistence?: import("@nkzw/fate").Persistence;
   origin?: string | URL;
   rpcPath?: string;
   url?: string | URL;
@@ -547,6 +552,7 @@ const toEndpointUrl = (url: string | URL | undefined, path: string, origin: stri
   liveRetryMs?: number;
   liveUrl?: string | URL;
   onLiveError?: (error: unknown) => void;
+  persistence?: import("@nkzw/fate").Persistence;
   url: string | URL;
 }`;
 	const clientSetup = voidTransport || cloudflareTransport ? ` => {
@@ -556,6 +562,7 @@ const toEndpointUrl = (url: string | URL | undefined, path: string, origin: stri
     hydrationScope,
     mutations,
     onLiveError: options.onLiveError,
+    persistence: options.persistence,
     roots,
     transport: createHTTPTransport<FateAPI>({
       fetch: ${voidTransport ? "createVoidFetch(options)" : "options.fetch"},
@@ -576,6 +583,7 @@ const toEndpointUrl = (url: string | URL | undefined, path: string, origin: stri
     hydrationScope,
     mutations,
     onLiveError: options.onLiveError,
+    persistence: options.persistence,
     roots,
     transport: createHTTPTransport<FateAPI>({
       fetch: options.fetch,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nkzw/fate",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "fate is a modern data client for React.",
   "homepage": "https://github.com/nkzw-tech/fate",
   "license": "MIT",
@@ -62,6 +62,16 @@
       "types": "./lib/vite.d.mts",
       "@nkzw/source": "./src/vite.ts",
       "default": "./lib/vite.mjs"
+    },
+    "./persistence": {
+      "types": "./lib/persistence.d.mts",
+      "@nkzw/source": "./src/persistence.ts",
+      "default": "./lib/persistence.mjs"
+    },
+    "./persistence/server": {
+      "types": "./lib/idempotency.d.mts",
+      "@nkzw/source": "./src/idempotency.ts",
+      "default": "./lib/idempotency.mjs"
     }
   },
   "dependencies": {
@@ -96,6 +106,6 @@
     }
   },
   "scripts": {
-    "build": "vp pack --tsconfig tsconfig.json -d lib --target=node24 src/index.ts src/clientStub.ts src/list.ts src/cli.ts src/server.ts src/server/drizzle.ts src/server/prisma.ts src/graphqlTransport.ts src/vite.ts"
+    "build": "vp pack --tsconfig tsconfig.json -d lib --target=node24 src/index.ts src/clientStub.ts src/list.ts src/cli.ts src/server.ts src/server/drizzle.ts src/server/prisma.ts src/graphqlTransport.ts src/vite.ts src/persistence.ts src/idempotency.ts"
   }
 }

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

@@ -1,7 +0,0 @@
-# Type Alias: Snapshot
-
-> **Snapshot** = `Readonly`\<\{ `mask?`: `FieldMask`; `record?`: [`FateRecord`](FateRecord.md); \}\>
-
-Defined in: [packages/fate/src/types.ts:513](https://github.com/nkzw-tech/fate/blob/aec05ea2ab0386693600d573021cd2a93f1d8b59/packages/fate/src/types.ts#L513)
-
-Snapshot captured before mutating the cache, used to roll back on errors.