@nkzw/fate 1.4.0 → 1.5.0

package/lib/protocol-DS5sf6sd.mjs

@@ -0,0 +1,44 @@
+//#region src/protocol.ts
+var FateRequestError = class extends Error {
+	constructor(code, message, options = {}) {
+		super(message);
+		this.name = "FateRequestError";
+		this.code = code;
+		this.issues = options.issues;
+		this.status = options.status ?? statusFromErrorCode(code);
+	}
+};
+const statusFromErrorCode = (code) => {
+	switch (code) {
+		case "BAD_REQUEST":
+		case "VALIDATION_ERROR": return 400;
+		case "UNAUTHORIZED": return 401;
+		case "FORBIDDEN": return 403;
+		case "NOT_FOUND": return 404;
+		case "INTERNAL_ERROR": return 500;
+	}
+};
+const errorCodeFromStatus = (status) => {
+	if (status === 400) return "BAD_REQUEST";
+	if (status === 401) return "UNAUTHORIZED";
+	if (status === 403) return "FORBIDDEN";
+	if (status === 404) return "NOT_FOUND";
+	return "INTERNAL_ERROR";
+};
+const toProtocolError = (error) => {
+	if (error instanceof FateRequestError) return {
+		code: error.code,
+		issues: error.issues,
+		message: error.message
+	};
+	if (error instanceof Error) return {
+		code: "INTERNAL_ERROR",
+		message: "Internal server error."
+	};
+	return {
+		code: "INTERNAL_ERROR",
+		message: "Internal server error."
+	};
+};
+//#endregion
+export { errorCodeFromStatus as n, toProtocolError as r, FateRequestError as t };

package/lib/{record-BTUXkHQU.d.mts → record-DITM4zb_.d.mts}

@@ -1,5 +1,6 @@
-import { r as AnyRecord } from "./transport-Bo1Jgo9R.mjs";
-import { N as DataViewResult, S as ConnectionResult, k as DataView, l as SourceDefinition, t as SourceRegistry } from "./executor-BRudKWDY.mjs";
+import { r as MutationIdentity, v as AnyRecord } from "./transport-DqjhjLfC.mjs";
+import { t as MutationIdempotency } from "./idempotency-types-CqA-BFpn.mjs";
+import { N as DataViewResult, S as ConnectionResult, k as DataView, l as SourceDefinition, t as SourceRegistry } from "./executor-DoiTBiVv.mjs";
 //#region src/liveTopics.d.ts
 declare const liveEntityTopic: (type: string, id: string | number) => string;
 declare const liveConnectionTopic: (procedure: string, args?: Record<string, unknown>) => string;
@@ -153,6 +154,7 @@ type ContextOptions<AdapterContext> = {
 };
 type FateServerOptions<Context, Roots extends RootMap, Queries extends Record<string, QueryDefinition<Context, any, any>>, Lists extends Record<string, ListDefinition<Context, any, any>>, Mutations extends Record<string, MutationDefinition<Context, any, any>>, AdapterContext> = {
   context?: (options: ContextOptions<AdapterContext>) => MaybePromise<Context>;
+  idempotency?: MutationIdempotency<Context>;
   lists?: Lists;
   live?: false | LiveConfig;
   mutations?: Mutations;
@@ -219,7 +221,7 @@ type FateServerManifest = Readonly<{
   }>;
   types: Record<string, true>;
 }>;
-declare function createFateServer<Context = unknown, Roots extends RootMap = RootMap, Queries extends Record<string, QueryDefinition<Context, any, any>> = Record<never, never>, Lists extends Record<string, ListDefinition<Context, any, any>> = Record<never, never>, Mutations extends Record<string, MutationDefinition<Context, any, any>> = Record<never, never>, AdapterContext = unknown>({ context, lists, live, mutations, queries, roots, sources }: FateServerOptions<Context, Roots, Queries, Lists, Mutations, AdapterContext>): FateServer<NativeFateAPI<Roots, Queries, Lists, Mutations>, AdapterContext>;
+declare function createFateServer<Context = unknown, Roots extends RootMap = RootMap, Queries extends Record<string, QueryDefinition<Context, any, any>> = Record<never, never>, Lists extends Record<string, ListDefinition<Context, any, any>> = Record<never, never>, Mutations extends Record<string, MutationDefinition<Context, any, any>> = Record<never, never>, AdapterContext = unknown>({ context, idempotency, lists, live, mutations, queries, roots, sources }: FateServerOptions<Context, Roots, Queries, Lists, Mutations, AdapterContext>): FateServer<NativeFateAPI<Roots, Queries, Lists, Mutations>, AdapterContext>;
 declare function createFateFetchHandler<AdapterContext>(server: FateServer<unknown, AdapterContext>): (request: Request, adapterContext?: AdapterContext) => Promise<Response>;
 declare function createHonoFateHandler<Context>(server: FateServer<unknown, Context>): (context: Context & {
   req: {
@@ -228,7 +230,8 @@ declare function createHonoFateHandler<Context>(server: FateServer<unknown, Cont
 }) => Promise<Response>;
 //#endregion
 //#region src/protocol.d.ts
-type FateProtocolVersion = 1;
+/** Version 2 requires support for durable mutation identities and receipt-only recovery. */
+type FateProtocolVersion = 1 | 2;
 type FateOperationKind = 'byId' | 'list' | 'mutation' | 'query';
 type FateOperation = Readonly<{
   args?: Record<string, unknown>;
@@ -236,6 +239,7 @@ type FateOperation = Readonly<{
   ids?: Array<string | number>;
   input?: unknown;
   kind: FateOperationKind;
+  mutation?: MutationIdentity;
   name?: string;
   select: Array<string>;
   type?: string;

package/lib/server/drizzle.d.mts

@@ -1,5 +1,5 @@
-import { nt as QueryProcedure, r as AnyRecord } from "../transport-Bo1Jgo9R.mjs";
-import { S as ConnectionResult, c as SourceConfig, f as SourcePlan, k as DataView, l as SourceDefinition, o as DataViewModule, p as SourcePlanNode, t as SourceRegistry } from "../executor-BRudKWDY.mjs";
+import { st as QueryProcedure, v as AnyRecord } from "../transport-DqjhjLfC.mjs";
+import { S as ConnectionResult, c as SourceConfig, f as SourcePlan, k as DataView, l as SourceDefinition, o as DataViewModule, p as SourcePlanNode, t as SourceRegistry } from "../executor-DoiTBiVv.mjs";
 import { AnyColumn, SQLWrapper, Table } from "drizzle-orm";
 //#region src/server/drizzle.d.ts
 type SourceTarget<Item extends AnyRecord = AnyRecord> = DataView<Item> | SourceDefinition<Item, unknown>;

package/lib/server/drizzle.mjs

@@ -1,5 +1,5 @@
 import { t as isRecord } from "../record-B07VwXd-.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-DSaADXSf.mjs";
+import { S as isDataView, c as resolveSourceConnection, d as createSourceDefinitions, f as createSourcePlan, g as attachComputedState, i as createSourceRegistry, k as withConnection, l as collectDataViewConfigs, o as resolveSourceById, p as getDataViewSourceConfig, s as resolveSourceByIds, t as bindSourceProcedures } from "../sourceRouter-51POBlEE.mjs";
 import { Many, and, asc, createTableRelationsHelpers, desc, eq, extractTablesRelationalConfig, getTableColumns, gt, inArray, is, isTable, lt, normalizeRelation, or, sql } from "drizzle-orm";
 //#region src/server/drizzle.ts
 /**

package/lib/server/prisma.d.mts

@@ -1,5 +1,5 @@
-import { nt as QueryProcedure, r as AnyRecord } from "../transport-Bo1Jgo9R.mjs";
-import { S as ConnectionResult, c as SourceConfig, f as SourcePlan, k as DataView, l as SourceDefinition, o as DataViewModule, p as SourcePlanNode, s as OrderDirection, t as SourceRegistry } from "../executor-BRudKWDY.mjs";
+import { st as QueryProcedure, v as AnyRecord } from "../transport-DqjhjLfC.mjs";
+import { S as ConnectionResult, c as SourceConfig, f as SourcePlan, k as DataView, l as SourceDefinition, o as DataViewModule, p as SourcePlanNode, s as OrderDirection, t as SourceRegistry } from "../executor-DoiTBiVv.mjs";
 //#region src/server/prisma.d.ts
 type PrismaDelegate = {
   findMany?: (args: any) => Promise<Array<AnyRecord>>;

package/lib/server/prisma.mjs

@@ -1,5 +1,5 @@
 import { t as isRecord } from "../record-B07VwXd-.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-DSaADXSf.mjs";
+import { E as stableStringify, S as isDataView, T as toPrismaSelect, c as resolveSourceConnection, d as createSourceDefinitions, f as createSourcePlan, g as attachComputedState, i as createSourceRegistry, k as withConnection, l as collectDataViewConfigs, o as resolveSourceById, p as getDataViewSourceConfig, s as resolveSourceByIds, t as bindSourceProcedures } from "../sourceRouter-51POBlEE.mjs";
 //#region src/server/prisma.ts
 /**
 * fate's Prisma integration.
@@ -50,11 +50,6 @@ const inferPrismaRelation = ({ field, kind, source, target }) => {
 		localKey: source.id
 	};
 };
-const stableStringify = (value) => {
-	if (Array.isArray(value)) return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
-	if (isRecord(value)) return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => `${JSON.stringify(key)}:${stableStringify(entry)}`).join(",")}}`;
-	return JSON.stringify(value);
-};
 const resolveSourceReference = (source) => typeof source === "function" ? source() : source;
 const isSourceDefinition = (target) => "view" in target && "id" in target;
 const toPrismaOrderBy = (orderBy) => orderBy.map((entry) => ({ [entry.field]: entry.direction }));

package/lib/server.d.mts

@@ -1,6 +1,6 @@
-import { r as AnyRecord$1, tt as AnyProcedure } from "./transport-Bo1Jgo9R.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-BTUXkHQU.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-BRudKWDY.mjs";
+import { ot as AnyProcedure, v as AnyRecord$1 } from "./transport-DqjhjLfC.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-DITM4zb_.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-DoiTBiVv.mjs";
 import { z } from "zod";
 //#region src/server/input.d.ts
 declare const byIdInput: z.ZodObject<{

package/lib/server.mjs

@@ -1,6 +1,8 @@
 import { t as isRecord } from "./record-B07VwXd-.mjs";
-import { d as hashArgs, i as FateRequestError, n as liveEntityTopic, o as toProtocolError, r as liveGlobalConnectionTopic, t as liveConnectionTopic, u as filterConnectionArgs } from "./liveTopics-uVP0LG-Q.mjs";
-import { C as list, D as resolveConnection, E as connectionArgs, O as withConnection, S as isDataView, T as toPrismaSelect, _ as computed, a as refetchSourceById, b as dataView, c as resolveSourceConnection, f as createSourcePlan, h as hasNestedSelection, k as getScopedArgs, m as getNestedSelection, n as createSourceProcedures, o as resolveSourceById, r as byIdInput, s as resolveSourceByIds, t as bindSourceProcedures, u as createNestedSourcePlan, v as count, w as resolver, x as field, y as createResolver } from "./sourceRouter-DSaADXSf.mjs";
+import { a as hashArgs, i as filterConnectionArgs } from "./args-CRLIRl_v.mjs";
+import { r as toProtocolError, t as FateRequestError } from "./protocol-DS5sf6sd.mjs";
+import { n as liveEntityTopic, r as liveGlobalConnectionTopic, t as liveConnectionTopic } from "./liveTopics-DuFkDZQm.mjs";
+import { A as getScopedArgs, C as list, D as connectionArgs, O as resolveConnection, S as isDataView, T as toPrismaSelect, _ as computed, a as refetchSourceById, b as dataView, c as resolveSourceConnection, f as createSourcePlan, h as hasNestedSelection, k as withConnection, m as getNestedSelection, n as createSourceProcedures, o as resolveSourceById, r as byIdInput, s as resolveSourceByIds, t as bindSourceProcedures, u as createNestedSourcePlan, v as count, w as resolver, x as field, y as createResolver } from "./sourceRouter-51POBlEE.mjs";
 import { EventEmitter, on } from "node:events";
 //#region src/server/live.ts
 const eventName = (type, id) => `${type}:${String(id)}`;
@@ -288,9 +290,10 @@ const operationKinds = /* @__PURE__ */ new Set([
 	"query"
 ]);
 const assertProtocolRequest = (value) => {
-	if (!isRecord(value) || value.version !== 1 || !Array.isArray(value.operations)) throw new FateRequestError("BAD_REQUEST", "Invalid Fate protocol request.");
+	if (!isRecord(value) || value.version !== 1 && value.version !== 2 || !Array.isArray(value.operations)) throw new FateRequestError("BAD_REQUEST", "Invalid Fate protocol request.");
 	for (const operation of value.operations) {
 		if (!isRecord(operation) || typeof operation.id !== "string" || typeof operation.kind !== "string" || !operationKinds.has(operation.kind) || !isStringArray(operation.select) || "args" in operation && operation.args !== void 0 && !isRecord(operation.args)) throw new FateRequestError("BAD_REQUEST", "Invalid Fate protocol operation.");
+		if (operation.mutation !== void 0 && (value.version !== 2 || operation.kind !== "mutation" || !isRecord(operation.mutation) || operation.mutation.replayOnly !== void 0 && operation.mutation.replayOnly !== true || typeof operation.mutation.id !== "string" || !operation.mutation.id || operation.mutation.id.length > 256 || typeof operation.mutation.scope !== "string" || operation.mutation.scope.length > 1024)) throw new FateRequestError("BAD_REQUEST", "Invalid durable mutation metadata.");
 		if (operation.kind === "byId" && (typeof operation.type !== "string" || !Array.isArray(operation.ids) || !operation.ids.every(isProtocolId))) throw new FateRequestError("BAD_REQUEST", "Invalid Fate byId operation.");
 		if ((operation.kind === "list" || operation.kind === "mutation" || operation.kind === "query") && typeof operation.name !== "string") throw new FateRequestError("BAD_REQUEST", "Invalid Fate named operation.");
 	}
@@ -371,7 +374,7 @@ const liveConnectionPayload = (event, node) => {
 	}
 };
 const sourceScore = (source) => Object.keys(source.view.fields).length + Object.keys(source.relations ?? {}).length;
-function createFateServer({ context, lists, live, mutations, queries, roots, sources }) {
+function createFateServer({ context, idempotency, lists, live, mutations, queries, roots, sources }) {
 	const rootLists = /* @__PURE__ */ new Map();
 	const rootQueries = /* @__PURE__ */ new Map();
 	const sourcesByType = /* @__PURE__ */ new Map();
@@ -475,12 +478,21 @@ function createFateServer({ context, lists, live, mutations, queries, roots, sou
 			}
 			const mutation = mutations?.[operation.name];
 			if (!mutation) throw new FateRequestError("NOT_FOUND", `No mutation registered for '${operation.name}'.`);
+			const resolve = async (context) => mutation.resolve({
+				ctx: context,
+				input: await parseInput(mutation.input, operation.input),
+				select: operation.select
+			});
+			if (operation.mutation && !idempotency) throw new FateRequestError("BAD_REQUEST", "fate: Configure createFateServer({ idempotency: createMutationIdempotency({ scope, store }) }) to accept persisted mutations. The store must commit mutation effects and receipts in the same database transaction.");
 			return {
-				data: await mutation.resolve({
+				data: operation.mutation ? await idempotency.execute({
 					ctx,
-					input: await parseInput(mutation.input, operation.input),
+					identity: operation.mutation,
+					input: operation.input,
+					name: operation.name,
+					resolve,
 					select: operation.select
-				}),
+				}) : await resolve(ctx),
 				id: operation.id,
 				ok: true
 			};

package/lib/sortObjectKeys-yhuitEQZ.mjs

@@ -0,0 +1,9 @@
+//#region src/sortObjectKeys.ts
+/** Recursively sorts plain-object keys, preserving array order and non-plain values. */
+const sortObjectKeys = (value) => {
+	if (Array.isArray(value)) return value.map(sortObjectKeys);
+	if (value && typeof value === "object" && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null)) return Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortObjectKeys(value[key])]));
+	return value;
+};
+//#endregion
+export { sortObjectKeys as t };

package/lib/{sourceRouter-DSaADXSf.mjs → sourceRouter-51POBlEE.mjs}

@@ -217,6 +217,14 @@ function withConnection(procedure) {
 	};
 }
 //#endregion
+//#region src/server/stableStringify.ts
+/** Serializes values with sorted object keys, including undefined properties. */
+const stableStringify = (value) => {
+	if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
+	if (value && typeof value === "object") return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => `${JSON.stringify(key)}:${stableStringify(entry)}`).join(",")}}`;
+	return JSON.stringify(value);
+};
+//#endregion
 //#region src/server/prismaSelect.ts
 const toPrismaOrderBy = (orderBy) => orderBy.map((entry) => ({ [entry.field]: entry.direction }));
 const mergeObject = (target, source) => {
@@ -229,11 +237,6 @@ const mergeObject = (target, source) => {
 		target[key] = value;
 	}
 };
-const stableStringify = (value) => {
-	if (Array.isArray(value)) return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
-	if (value && typeof value === "object") return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => `${JSON.stringify(key)}:${stableStringify(entry)}`).join(",")}}`;
-	return JSON.stringify(value);
-};
 const getConflictingCountRelations = (node) => {
 	const signaturesByRelation = /* @__PURE__ */ new Map();
 	for (const computed of node.computeds.values()) {
@@ -973,4 +976,4 @@ function bindSourceProcedures(defaults) {
 	});
 }
 //#endregion
-export { list as C, resolveConnection as D, connectionArgs as E, withConnection as O, isDataView as S, toPrismaSelect as T, computed as _, refetchSourceById as a, dataView as b, resolveSourceConnection as c, createSourceDefinitions as d, createSourcePlan as f, attachComputedState as g, hasNestedSelection as h, createSourceRegistry as i, getScopedArgs as k, collectDataViewConfigs as l, getNestedSelection as m, createSourceProcedures as n, resolveSourceById as o, getDataViewSourceConfig as p, byIdInput as r, resolveSourceByIds as s, bindSourceProcedures as t, createNestedSourcePlan as u, count as v, resolver as w, field as x, createResolver as y };
+export { getScopedArgs as A, list as C, connectionArgs as D, stableStringify as E, resolveConnection as O, isDataView as S, toPrismaSelect as T, computed as _, refetchSourceById as a, dataView as b, resolveSourceConnection as c, createSourceDefinitions as d, createSourcePlan as f, attachComputedState as g, hasNestedSelection as h, createSourceRegistry as i, withConnection as k, collectDataViewConfigs as l, getNestedSelection as m, createSourceProcedures as n, resolveSourceById as o, getDataViewSourceConfig as p, byIdInput as r, resolveSourceByIds as s, bindSourceProcedures as t, createNestedSourcePlan as u, count as v, resolver as w, field as x, createResolver as y };