@nkzw/fate 1.1.0 → 1.3.0

package/lib/index.mjs

@@ -78,6 +78,10 @@ const ViewsTag = Symbol("__fate__views");
 const NodeRefTag = Symbol("__fate__node-ref");
 /** Symbol attached to connection results so pagination helpers can find their metadata. */
 const ConnectionTag = Symbol("__fate__connection");
+/** Symbol used to mark a selection as deferred. */
+const DeferTag = Symbol("__fate__defer");
+/** Symbol attached to deferred values returned from masked views. */
+const DeferredTag = Symbol("__fate__deferred");
 const viewTag = "__fate-view__";
 /** Generates a stable view tag for a view definition. */
 function getViewTag(id) {
@@ -104,6 +108,16 @@ const RootKind = "__fate__root";
 /** Brand used on mutation definitions to mark their identity in the d.ts output. */
 const MutationKind = "__fate__mutation";
 //#endregion
+//#region src/defer.ts
+function defer(selection) {
+	return Object.freeze({ [DeferTag]: selection });
+}
+const isDeferredSelection = (value) => typeof value === "object" && value !== null && DeferTag in value;
+const getDeferredSelection = (selection) => selection[DeferTag];
+const createDeferred = (metadata) => Object.freeze({ [DeferredTag]: metadata });
+const isDeferred = (value) => typeof value === "object" && value !== null && DeferredTag in value;
+const getDeferredMetadata = (deferred) => deferred[DeferredTag];
+//#endregion
 //#region src/node-ref.ts
 function createNodeRef(id) {
 	const ref = {};
@@ -706,6 +720,7 @@ const getSelectionPlan = (viewComposition, ref) => {
 				if (value) paths.add(path);
 				continue;
 			}
+			if (isDeferredSelection(value)) continue;
 			if (isViewTag(key)) {
 				if (!ref || ref[ViewsTag] && ref[ViewsTag].has(key)) walk(value.select, prefix);
 				continue;
@@ -743,6 +758,9 @@ const getSelectionPlan = (viewComposition, ref) => {
 		paths
 	};
 };
+const getDeferredSelectionPlan = (field, selection) => {
+	return getSelectionPlan({ [field]: selection }, null);
+};
 //#endregion
 //#region src/mutation.ts
 /**
@@ -1796,6 +1814,7 @@ var FateClient = class {
 		this.parentLists = /* @__PURE__ */ new Map();
 		this.rootLists = /* @__PURE__ */ new Map();
 		this.pending = /* @__PURE__ */ new Map();
+		this.pendingDeferred = /* @__PURE__ */ new Map();
 		this.pendingOptimisticMutations = /* @__PURE__ */ new Map();
 		this.optimisticMasks = /* @__PURE__ */ new Map();
 		this.optimisticByEntity = /* @__PURE__ */ new Map();
@@ -2095,6 +2114,63 @@ var FateClient = class {
 		}
 		return resolveSnapshot();
 	}
+	readDeferred(deferred) {
+		const metadata = getDeferredMetadata(deferred);
+		const resolvedOwner = this.optimisticEntityResolutions.get(metadata.owner) ?? metadata.owner;
+		const parsedOwner = parseEntityId(resolvedOwner);
+		const ownerRecord = this.store.read(resolvedOwner);
+		const rawOwnerId = ownerRecord && (typeof ownerRecord.id === "string" || typeof ownerRecord.id === "number") ? ownerRecord.id : parsedOwner.id;
+		const ownerType = parsedOwner.type || metadata.type;
+		const plan = getDeferredSelectionPlan(metadata.field, metadata.selection);
+		const selectedPaths = plan.paths;
+		const missing = this.store.missingForSelection(resolvedOwner, selectedPaths);
+		const hasMissingList = () => this.hasMissingDeferredList(resolvedOwner, ownerType, metadata.field, plan);
+		const listMissing = hasMissingList();
+		const fetchPaths = listMissing ? selectedPaths : missing;
+		const resolveSnapshot = () => {
+			const snapshot = this.readViewSelection({ [metadata.field]: metadata.selection }, this.stableRefWithViewNames(ownerType, rawOwnerId, /* @__PURE__ */ new Set()), resolvedOwner, plan);
+			const resolved = {
+				coverage: snapshot.coverage,
+				data: snapshot.data[metadata.field]
+			};
+			return {
+				status: "fulfilled",
+				then: (onfulfilled, onrejected) => Promise.resolve(resolved).then(onfulfilled, onrejected),
+				value: resolved
+			};
+		};
+		if (missing.size === 0 && !listMissing) {
+			this.clearStalledRequestsForEntity(resolvedOwner);
+			return resolveSnapshot();
+		}
+		const key = this.deferredPendingKey(resolvedOwner, fetchPaths, plan, this.deferredSelectionSignature(metadata.selection));
+		if (this.stalledRequests.has(key)) return resolveSnapshot();
+		const pendingOptimistic = this.getPendingOptimisticMutations(resolvedOwner);
+		if (pendingOptimistic) {
+			const pending = this.pendingDeferred.get(key);
+			if (pending) return pending;
+			const promise = Promise.all(pendingOptimistic).then(() => this.readDeferred(deferred)).finally(() => this.pendingDeferred.delete(key));
+			this.pendingDeferred.set(key, promise);
+			return promise;
+		}
+		const pendingPromise = this.pendingDeferred.get(key) || null;
+		if (pendingPromise) return pendingPromise;
+		const promise = this.trackPendingRequest(async () => {
+			try {
+				await this.fetchByIdAndNormalize(ownerType, [rawOwnerId], fetchPaths, plan);
+				if (this.store.missingForSelection(resolvedOwner, selectedPaths).size > 0 || hasMissingList()) {
+					this.stalledRequests.add(key);
+					return resolveSnapshot().value;
+				}
+				this.stalledRequests.delete(key);
+				return this.readDeferred(deferred).value;
+			} finally {
+				this.pendingDeferred.delete(key);
+			}
+		});
+		this.pendingDeferred.set(key, promise);
+		return promise;
+	}
 	assertLiveViewSupport() {
 		if (!this.transport.subscribeById) throw new Error(`fate: transport does not support live views. Please provide a 'subscribeById' implementation in your transport.`);
 	}
@@ -3138,8 +3214,20 @@ var FateClient = class {
 					target[ViewsTag].add(key);
 					continue;
 				}
-				coverageById.set(parentId, (coverageById.get(parentId) ?? /* @__PURE__ */ new Set()).add(key));
 				const fieldPath = prefix ? `${prefix}.${key}` : key;
+				if (isDeferredSelection(selectionKind)) {
+					const { id, type } = parseEntityId(parentId);
+					coverageById.set(parentId, (coverageById.get(parentId) ?? /* @__PURE__ */ new Set()).add(key));
+					target[key] = createDeferred({
+						field: key,
+						id,
+						owner: parentId,
+						selection: getDeferredSelection(selectionKind),
+						type
+					});
+					continue;
+				}
+				coverageById.set(parentId, (coverageById.get(parentId) ?? /* @__PURE__ */ new Set()).add(key));
 				const selectionType = typeof selectionKind;
 				if (selectionType === "boolean" && selectionKind) target[key] = record[key];
 				else if (selectionKind && selectionType === "object") {
@@ -3258,7 +3346,9 @@ var FateClient = class {
 			}
 		};
 		const data = { __typename: parseEntityId(entityId).type };
-		for (const viewPayload of getViewPayloads(viewComposition, ref)) walk(viewPayload.select, record, data, entityId, pathPrefix);
+		const payloads = getViewPayloads(viewComposition, ref);
+		if (payloads.length === 0 && isRecord(viewComposition)) walk(viewComposition, record, data, entityId, pathPrefix);
+		else for (const viewPayload of payloads) walk(viewPayload.select, record, data, entityId, pathPrefix);
 		return {
 			coverage: [...coverageById.entries()],
 			data
@@ -3274,6 +3364,32 @@ var FateClient = class {
 	pendingKey(entityId, missingFields) {
 		return `${this.pendingPrefix(entityId)}${[...missingFields].sort().join("|")}`;
 	}
+	deferredPendingKey(entityId, fields, plan, selectionSignature) {
+		const args = [...plan.args.entries()].map(([path, entry]) => `${path}:${entry.hash}`).sort().join("|");
+		return `${this.pendingKey(entityId, new Set(fields))}|${args}|${selectionSignature}`;
+	}
+	deferredSelectionSignature(selection) {
+		const seen = /* @__PURE__ */ new Set();
+		const serialize = (value) => {
+			if (value === null || typeof value !== "object") return `${typeof value}:${String(value)}`;
+			if (seen.has(value)) return "[Circular]";
+			seen.add(value);
+			if (Array.isArray(value)) return `[${value.map((item) => serialize(item)).join(",")}]`;
+			return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => isViewTag(key) ? `view:${key}` : `${key}:${serialize(entry)}`).join(",")}}`;
+		};
+		return serialize(selection);
+	}
+	hasMissingDeferredList(owner, type, field, plan) {
+		const descriptor = this.types.get(type)?.fields?.[field];
+		if (!descriptor || descriptor === "scalar" || !("listOf" in descriptor)) return false;
+		const fieldArgs = plan.args.get(field);
+		const listState = this.store.getListState(getListKey(owner, field, fieldArgs?.hash));
+		if (!listState) return true;
+		const args = fieldArgs?.value;
+		const paginationArgs = getPaginationArgsInfo(args);
+		if (paginationArgs.hasCursorArg) return true;
+		return !hasConnectionPageCoverage(listState, args, paginationArgs.direction);
+	}
 	liveSubscriptionKey(entityId, plan) {
 		return `${entityId}|${[...plan.paths].sort().join("|")}|${[...plan.args.entries()].map(([path, entry]) => `${path}:${entry.hash}`).sort().join("|")}`;
 	}
@@ -3808,4 +3924,4 @@ function clientRoot(type) {
 	});
 }
 //#endregion
-export { ConnectionTag, FateClient, clientRoot, createClient, createGraphQLTransport, createHTTPTransport, createTRPCTransport, getListEntries, getSelectionPlan, graphqlMutation, isRecord, isViewTag, liveConnectionTopic, liveEntityTopic, liveGlobalConnectionTopic, mutation, toEntityId, view };
+export { ConnectionTag, DeferTag, DeferredTag, FateClient, clientRoot, createClient, createGraphQLTransport, createHTTPTransport, createTRPCTransport, defer, getDeferredMetadata, getListEntries, getSelectionPlan, graphqlMutation, isDeferred, isRecord, isViewTag, liveConnectionTopic, liveEntityTopic, liveGlobalConnectionTopic, mutation, toEntityId, view };

package/lib/{list-CMQOQGdn.d.mts → list-BrL6PD_6.d.mts}

@@ -1,4 +1,4 @@
-import { Y as List, c as EntityId } from "./transport-BTgtSwOM.mjs";
+import { p as EntityId, tt as List } from "./transport-BjGm__3t.mjs";
 
 //#region src/list.d.ts
 type ListEntry = Readonly<{

package/lib/list.d.mts

@@ -1,2 +1,2 @@
-import { n as getListEntries, t as ListEntry } from "./list-CMQOQGdn.mjs";
+import { n as getListEntries, t as ListEntry } from "./list-BrL6PD_6.mjs";
 export { ListEntry, getListEntries };

package/lib/{record-BtdKzEGI.d.mts → record-BkvZwvFk.d.mts}

@@ -1,5 +1,5 @@
-import { r as AnyRecord } from "./transport-BTgtSwOM.mjs";
-import { N as DataViewResult, S as ConnectionResult, k as DataView, l as SourceDefinition, t as SourceRegistry } from "./executor-sLcAqDMs.mjs";
+import { r as AnyRecord } from "./transport-BjGm__3t.mjs";
+import { N as DataViewResult, S as ConnectionResult, k as DataView, l as SourceDefinition, t as SourceRegistry } from "./executor-Dh-MLUXc.mjs";
 
 //#region src/liveTopics.d.ts
 declare const liveEntityTopic: (type: string, id: string | number) => string;

package/lib/server/drizzle.d.mts

@@ -1,5 +1,5 @@
-import { Z as QueryProcedure, r as AnyRecord } from "../transport-BTgtSwOM.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-sLcAqDMs.mjs";
+import { r as AnyRecord, rt as QueryProcedure } from "../transport-BjGm__3t.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-Dh-MLUXc.mjs";
 import { AnyColumn, SQLWrapper, Table } from "drizzle-orm";
 
 //#region src/server/drizzle.d.ts

package/lib/server/prisma.d.mts

@@ -1,5 +1,5 @@
-import { Z as QueryProcedure, r as AnyRecord } from "../transport-BTgtSwOM.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-sLcAqDMs.mjs";
+import { r as AnyRecord, rt as QueryProcedure } from "../transport-BjGm__3t.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-Dh-MLUXc.mjs";
 
 //#region src/server/prisma.d.ts
 type PrismaDelegate = {

package/lib/server.d.mts

@@ -1,6 +1,6 @@
-import { X as AnyProcedure, r as AnyRecord$1 } from "./transport-BTgtSwOM.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-BtdKzEGI.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-sLcAqDMs.mjs";
+import { nt as AnyProcedure, r as AnyRecord$1 } from "./transport-BjGm__3t.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-BkvZwvFk.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-Dh-MLUXc.mjs";
 import { z } from "zod";
 
 //#region src/server/input.d.ts

package/lib/{transport-BTgtSwOM.d.mts → transport-BjGm__3t.d.mts}

@@ -741,6 +741,10 @@ type RequestMode = /** (default) Use cached data if present, otherwise fetch. */
 type RequestOptions = Readonly<{
   mode?: RequestMode;
 }>;
+type DeferredSnapshot<T> = Readonly<{
+  coverage: ReadonlyArray<readonly [id: EntityId, paths: ReadonlySet<string>]>;
+  data: T;
+}>;
 type FateClientOptions<Roots extends FateRoots, Mutations extends FateMutations, HydrationScope extends string> = {
   /**
    * Number of recently released requests to keep retained before their records
@@ -775,6 +779,7 @@ declare class FateClient<Roots extends FateRoots, Mutations extends FateMutation
   private readonly parentLists;
   private readonly rootLists;
   private readonly pending;
+  private readonly pendingDeferred;
   private readonly pendingOptimisticMutations;
   private readonly optimisticMasks;
   private readonly optimisticByEntity;
@@ -836,6 +841,7 @@ declare class FateClient<Roots extends FateRoots, Mutations extends FateMutation
     [ViewsTag]: Set<string>;
   }>;
   readView<T extends Entity, S extends Selection<T>, V extends View<T, S>>(view: V, ref: ViewRef<T['__typename']>): FateThenable<ViewSnapshot<T, S>>;
+  readDeferred<T>(deferred: Deferred<T>): PromiseLike<DeferredSnapshot<T>>;
   assertLiveViewSupport(): void;
   assertLiveConnectionSupport(): void;
   subscribeLiveView<T extends Entity, S extends Selection<T>, V extends View<T, S>>(view: V, ref: ViewRef<T['__typename']>): () => void;
@@ -926,6 +932,9 @@ declare class FateClient<Roots extends FateRoots, Mutations extends FateMutation
   private clearStalledRequestsForEntity;
   private pendingPrefix;
   private pendingKey;
+  private deferredPendingKey;
+  private deferredSelectionSignature;
+  private hasMissingDeferredList;
   private liveSubscriptionKey;
   private liveConnectionSubscriptionKey;
   private releaseLiveSubscription;
@@ -1004,6 +1013,10 @@ declare const ViewKind: unique symbol;
 declare const ViewsTag: unique symbol;
 /** Symbol attached to connection results so pagination helpers can find their metadata. */
 declare const ConnectionTag: unique symbol;
+/** Symbol used to mark a selection as deferred. */
+declare const DeferTag: unique symbol;
+/** Symbol attached to deferred values returned from masked views. */
+declare const DeferredTag: unique symbol;
 declare const __FateEntityBrand: unique symbol;
 declare const __FateSelectionBrand: unique symbol;
 declare const __FateMutationEntityBrand: unique symbol;
@@ -1011,6 +1024,7 @@ declare const __FateMutationInputBrand: unique symbol;
 declare const __FateMutationResultBrand: unique symbol;
 declare const __FateRootResultBrand: unique symbol;
 declare const __FateRootTypeBrand: unique symbol;
+declare const __FateDeferredBrand: unique symbol;
 type __ViewEntityAnchor<T extends Entity> = {
   readonly [__FateEntityBrand]?: T;
 };
@@ -1097,6 +1111,24 @@ type ConnectionRef<TName extends string> = Readonly<{
   }>;
   pagination?: Pagination;
 }>;
+/** Selection wrapper created by `defer(...)`. */
+type DeferredSelection<S> = Readonly<{
+  [DeferTag]: S;
+}>;
+/** Runtime metadata used by the client to resolve a deferred field. */
+type DeferredMetadata = Readonly<{
+  field: string;
+  id: string | number;
+  owner: EntityId;
+  selection: unknown;
+  type: string;
+}>;
+/** A deferred value returned from a masked view. Existing view hooks resolve it when read. */
+type Deferred<T> = Readonly<{
+  [DeferredTag]: DeferredMetadata;
+}> & {
+  readonly [__FateDeferredBrand]: T;
+};
 /** Base shape shared by all entities fetched by fate. */
 type Entity = {
   __typename: string;
@@ -1120,7 +1152,8 @@ type ConnectionSelectionBase<T extends Entity> = Readonly<{
 type ConnectionSelection<T extends Entity> = ConnectionSelectionBase<T> | (SelectionArgs & ConnectionSelectionBase<T>);
 type BaseSelectionFieldValue<T extends Entity, K extends keyof T> = NonNullable<T[K]> extends Array<infer U extends Entity> ? true | Selection<U> | ConnectionSelection<U> | View<U, Selection<U>> : NonNullable<T[K]> extends Entity ? true | Selection<NonNullable<T[K]>> | View<NonNullable<T[K]>, Selection<NonNullable<T[K]>>> : NonNullable<T[K]> extends AnyRecord ? PlainObjectSelection<NonNullable<T[K]>> : true;
 type SelectionFieldValue<T extends Entity, K extends keyof T> = BaseSelectionFieldValue<T, K> | SelectionArgs | (SelectionArgs & Extract<BaseSelectionFieldValue<T, K>, object>);
-type SelectionShape<T extends Entity> = { [K in keyof T as K extends '__typename' ? never : K]?: SelectionFieldValue<T, K> } & {
+type DeferrableSelectionFieldValue<T extends Entity, K extends keyof T> = SelectionFieldValue<T, K> | DeferredSelection<SelectionFieldValue<T, K>>;
+type SelectionShape<T extends Entity> = { [K in keyof T as K extends '__typename' ? never : K]?: DeferrableSelectionFieldValue<T, K> } & {
   __typename?: true;
 };
 type SelectionViewSpread<T extends Entity> = { readonly [K in ViewTag]?: Readonly<{
@@ -1182,7 +1215,7 @@ type EntityName<T> = T extends {
   __typename: infer N extends string;
 } ? N : never;
 /** Recursively applies a view selection to an entity to mask fields that aren't selected. */
-type MaskNonNullish<T, S> = T extends Array<infer U extends Entity> ? S extends true ? Array<U> : S extends ConnectionLikeSelection ? ConnectionMask<U, S> : HasViewTag<S> extends true ? Array<ViewRef<U['__typename']>> : Array<Mask<U, S>> : S extends true ? T : S extends object ? HasViewTag<S> extends true ? NonNullish<T> extends Entity ? ViewRef<EntityName<NonNullish<T>>> : ViewRef<EntityName<NonNullable<T>>> : { [K in keyof S as K extends 'args' ? never : K]: S[K] extends true ? NonNullish<T>[Extract<K, keyof T>] : Mask<NonNullish<T>[Extract<K, keyof T>], Extract<S[K], object>> } & (T extends Entity ? Pick<NonNullish<T>, '__typename'> : Record<never, never>) : T;
+type MaskNonNullish<T, S> = T extends Array<infer U extends Entity> ? S extends true ? Array<U> : S extends ConnectionLikeSelection ? ConnectionMask<U, S> : HasViewTag<S> extends true ? Array<ViewRef<U['__typename']>> : Array<Mask<U, S>> : S extends true ? T : S extends object ? HasViewTag<S> extends true ? NonNullish<T> extends Entity ? ViewRef<EntityName<NonNullish<T>>> : ViewRef<EntityName<NonNullable<T>>> : { [K in keyof S as K extends 'args' ? never : K]: S[K] extends true ? NonNullish<T>[Extract<K, keyof T>] : S[K] extends DeferredSelection<infer DeferredSelectionValue> ? Deferred<Mask<NonNullish<T>[Extract<K, keyof T>], DeferredSelectionValue>> : Mask<NonNullish<T>[Extract<K, keyof T>], Extract<S[K], object>> } & (T extends Entity ? Pick<NonNullish<T>, '__typename'> : Record<never, never>) : T;
 type Mask<T, S> = WithNullish<T, MaskNonNullish<NonNullish<T>, S>>;
 /** Entity type captured from a view definition. */
 type ViewEntity<V> = V extends View<infer T, any> ? T : never;
@@ -1410,4 +1443,4 @@ declare function createTRPCTransport<AppRouter extends AnyRouter, Mutations exte
   queries?: TRPCQueryResolvers<AppRouter>;
 }): Transport<MutationMapFromResolvers<Mutations>>;
 //#endregion
-export { ViewEntity as A, mutation as B, RootDefinition as C, TypeName as D, TypeConfig as E, ViewTag as F, getSelectionPlan as G, RequestMode as H, __FateEntityBrand as I, HydrationLimits as J, FateDehydratedState as K, __FateSelectionBrand as L, ViewRef as M, ViewSelection as N, View as O, ViewSnapshot as P, isViewTag as R, RequestResult as S, Snapshot as T, RequestOptions as U, FateClient as V, createClient as W, AnyProcedure as X, List as Y, QueryProcedure as Z, MutationResult as _, ConnectionRef as a, Pagination as b, EntityId as c, ListItem as d, Mask as f, MutationInput as g, MutationIdentifier as h, ConnectionMetadata as i, ViewEntityName as j, ViewData as k, FateRoots as l, MutationEntity as m, createTRPCTransport as n, ConnectionTag as o, MutationDefinition as p, HydrateOptions as q, AnyRecord as r, Entity as s, Transport as t, FateThenable as u, MutationShape as v, Selection as w, Request$1 as x, NodesItem as y, FateMutations as z };
+export { HydrateOptions as $, Snapshot as A, ViewTag as B, MutationShape as C, RequestResult as D, Request$1 as E, ViewEntity as F, mutation as G, __FateSelectionBrand as H, ViewEntityName as I, RequestMode as J, DeferredSnapshot as K, ViewRef as L, TypeName as M, View as N, RootDefinition as O, ViewData as P, FateDehydratedState as Q, ViewSelection as R, MutationResult as S, Pagination as T, isViewTag as U, __FateEntityBrand as V, FateMutations as W, createClient as X, RequestOptions as Y, getSelectionPlan as Z, Mask as _, ConnectionRef as a, MutationIdentifier as b, Deferred as c, DeferredTag as d, HydrationLimits as et, Entity as f, ListItem as g, FateThenable as h, ConnectionMetadata as i, TypeConfig as j, Selection as k, DeferredMetadata as l, FateRoots as m, createTRPCTransport as n, AnyProcedure as nt, ConnectionTag as o, EntityId as p, FateClient as q, AnyRecord as r, QueryProcedure as rt, DeferTag as s, Transport as t, List as tt, DeferredSelection as u, MutationDefinition as v, NodesItem as w, MutationInput as x, MutationEntity as y, ViewSnapshot as z };

package/lib/vite.d.mts

@@ -1,10 +1,10 @@
 import { Plugin } from "vite";
 
 //#region src/viteTypes.d.ts
-type FateViteTransport = 'graphql' | 'native' | 'trpc' | 'void';
+type FateViteTransport = 'cloudflare' | 'graphql' | 'native' | 'trpc' | 'void';
 //#endregion
 //#region src/vite.d.ts
-type ClientRuntime = '@nkzw/fate' | 'react-fate';
+type ClientRuntime = '@nkzw/fate' | 'react-fate' | 'vue-fate';
 type FateVitePluginOptions = {
   clientModule?: ClientRuntime;
   generatedFile?: false | string;

package/lib/vite.mjs

@@ -87,11 +87,20 @@ const createClientSource = ({ clientModule = "react-fate", moduleExports, module
 	});
 	if (transport === "native" || transport === "void") return createNativeClientSource({
 		clientModule,
+		cloudflareTransport: false,
 		moduleExports,
 		moduleName,
 		runtimeModuleName,
 		voidTransport: transport === "void"
 	});
+	if (transport === "cloudflare") return createNativeClientSource({
+		clientModule,
+		cloudflareTransport: true,
+		moduleExports,
+		moduleName,
+		runtimeModuleName,
+		voidTransport: false
+	});
 	const { appRouter, Root } = moduleExports;
 	const { roots, types } = createSchema(Object.values(moduleExports).filter(isDataView), Root ?? {});
 	const routerRecord = appRouter._def?.record ?? {};
@@ -412,7 +421,7 @@ type GeneratedCreateFateClient = typeof createFateClient;
 ${generatedClientTypes}
 `;
 };
-const createNativeClientSource = ({ clientModule, moduleExports, moduleName, runtimeModuleName, voidTransport }) => {
+const createNativeClientSource = ({ clientModule, cloudflareTransport, moduleExports, moduleName, runtimeModuleName, voidTransport }) => {
 	const { Root } = moduleExports;
 	const fateExportName = moduleExports.fate?.manifest ? "fate" : moduleExports.fateServer?.manifest ? "fateServer" : null;
 	const fateServer = fateExportName ? moduleExports[fateExportName] : null;
@@ -510,7 +519,17 @@ const createVoidFetch = (options: {
     });
 };
 ` : "";
-	const createClientOptions = voidTransport ? `options: {
+	const cloudflareHelpers = cloudflareTransport ? `
+const defaultCloudflareFateRpcPath = '/fate';
+const defaultCloudflareFateLivePath = '/fate-live';
+
+const getDefaultOrigin = () =>
+  typeof window === 'undefined' ? 'http://localhost' : window.location.origin;
+
+const toEndpointUrl = (url: string | URL | undefined, path: string, origin: string | URL) =>
+  url ?? new URL(path, origin);
+` : "";
+	const createClientOptions = voidTransport || cloudflareTransport ? `options: {
   fetch?: typeof fetch;
   headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
   livePath?: string;
@@ -529,7 +548,7 @@ const createVoidFetch = (options: {
   onLiveError?: (error: unknown) => void;
   url: string | URL;
 }`;
-	const clientSetup = voidTransport ? ` => {
+	const clientSetup = voidTransport || cloudflareTransport ? ` => {
   const origin = options.origin ?? getDefaultOrigin();
 
   return createClient<[GeneratedClientRoots, GeneratedClientMutations], typeof hydrationScope>({
@@ -538,16 +557,16 @@ const createVoidFetch = (options: {
     onLiveError: options.onLiveError,
     roots,
     transport: createHTTPTransport<FateAPI>({
-      fetch: createVoidFetch(options),
+      fetch: ${voidTransport ? "createVoidFetch(options)" : "options.fetch"},
       headers: options.headers,
-      live: ${hasLive ? "connectLiveStream" : "false"},
+      live: ${hasLive ? voidTransport ? "connectLiveStream" : "connectCloudflareFateStream" : "false"},
       liveRetryMs: options.liveRetryMs,
       liveUrl: toEndpointUrl(
         options.liveUrl,
-        options.livePath ?? defaultVoidFateLivePath,
+        options.livePath ?? ${voidTransport ? "defaultVoidFateLivePath" : "defaultCloudflareFateLivePath"},
         origin,
       ),
-      url: toEndpointUrl(options.url, options.rpcPath ?? defaultVoidFateRpcPath, origin),
+      url: toEndpointUrl(options.url, options.rpcPath ?? ${voidTransport ? "defaultVoidFateRpcPath" : "defaultCloudflareFateRpcPath"}, origin),
     }),
     types: ${typesBlock.trimStart()},
   });
@@ -581,6 +600,7 @@ declare module '${clientDeclarationModule}' {
 import type { ${importedTypes.join(", ")} } from '${moduleName}';
 import { clientRoot, createClient, createHTTPTransport, mutation, type InferFateAPI } from '${clientModule}';
 ${voidTransport && hasLive ? "import { connectLiveStream } from 'void/live/client';\n" : ""}${voidServerFetch}
+${cloudflareTransport && hasLive ? "import { connectCloudflareFateStream } from 'cf-fate/client';\n" : ""}${cloudflareHelpers}
 
 type FateAPI = InferFateAPI<typeof fateServer>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nkzw/fate",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "fate is a modern data client for React.",
   "homepage": "https://github.com/nkzw-tech/fate",
   "license": "MIT",