@questpie/admin 1.1.0 → 2.0.0

package/dist/server/block/prefetch.mjs

@@ -0,0 +1,240 @@
+//#region src/server/block/prefetch.ts
+/**
+* Expand relation/upload fields declared in `prefetchWith`.
+*
+* Uses the same object syntax as `with` in find operations:
+* ```ts
+* { backgroundImage: true, author: { with: { avatar: true } } }
+* ```
+*
+* Nested `with` is passed through to the collection's `find` call,
+* reusing the existing relation resolution machinery.
+*
+* @internal
+*/
+async function expandDeclaredFields(allNodes, values, blockDefinitions, ctx) {
+	const expansionsByCollection = /* @__PURE__ */ new Map();
+	for (const node of allNodes) {
+		const blockDef = blockDefinitions[node.type];
+		const prefetchWith = blockDef?.state.prefetchWith;
+		if (!prefetchWith || typeof prefetchWith !== "object") continue;
+		if (!blockDef?.state.fields) continue;
+		const blockValues = values[node.id] || {};
+		for (const [fieldName, fieldConfig] of Object.entries(prefetchWith)) {
+			if (!fieldConfig) continue;
+			const fieldDef = blockDef.state.fields[fieldName];
+			if (!fieldDef || typeof fieldDef !== "object") continue;
+			const metadata = "getMetadata" in fieldDef && typeof fieldDef.getMetadata === "function" ? fieldDef.getMetadata() : void 0;
+			if (!metadata) continue;
+			if (metadata.type !== "relation") continue;
+			const targetCollection = metadata.targetCollection;
+			if (!targetCollection || typeof targetCollection !== "string") continue;
+			const value = blockValues[fieldName];
+			if (!value) continue;
+			const stringIds = (Array.isArray(value) ? value : [value]).filter((id) => typeof id === "string" && id.length > 0);
+			if (stringIds.length === 0) continue;
+			const nestedWith = typeof fieldConfig === "object" && fieldConfig.with ? fieldConfig.with : void 0;
+			const groupKey = nestedWith ? `${targetCollection}:${JSON.stringify(nestedWith)}` : targetCollection;
+			if (!expansionsByCollection.has(groupKey)) expansionsByCollection.set(groupKey, {
+				ids: /* @__PURE__ */ new Set(),
+				targets: [],
+				nestedWith
+			});
+			const entry = expansionsByCollection.get(groupKey);
+			for (const id of stringIds) entry.ids.add(id);
+			entry.targets.push({
+				blockId: node.id,
+				fieldName,
+				isSingle: !Array.isArray(value),
+				nestedWith
+			});
+		}
+	}
+	if (expansionsByCollection.size === 0) return {};
+	const fetchedByGroup = /* @__PURE__ */ new Map();
+	const fetchPromises = [...expansionsByCollection.entries()].map(async ([groupKey, { ids, nestedWith }]) => {
+		const collection = groupKey.includes(":") ? groupKey.slice(0, groupKey.indexOf(":")) : groupKey;
+		try {
+			const appApi = ctx.app?.api?.collections?.[collection];
+			if (!appApi?.find) {
+				console.warn(`[prefetch] Collection "${collection}" not found on app API, skipping`);
+				return;
+			}
+			const result = await appApi.find({
+				where: { id: { in: [...ids] } },
+				limit: ids.size,
+				...nestedWith ? { with: nestedWith } : {}
+			});
+			const recordMap = /* @__PURE__ */ new Map();
+			for (const doc of result?.docs || []) if (doc && typeof doc === "object" && "id" in doc) recordMap.set(doc.id, doc);
+			fetchedByGroup.set(groupKey, recordMap);
+		} catch (error) {
+			console.error(`[prefetch] Failed to fetch from "${collection}":`, error);
+		}
+	});
+	await Promise.all(fetchPromises);
+	const expandedData = {};
+	for (const [groupKey, { targets }] of expansionsByCollection) {
+		const recordMap = fetchedByGroup.get(groupKey);
+		if (!recordMap) continue;
+		for (const { blockId, fieldName, isSingle } of targets) {
+			if (!expandedData[blockId]) expandedData[blockId] = {};
+			const blockVal = (values[blockId] || {})[fieldName];
+			if (isSingle) expandedData[blockId][fieldName] = recordMap.get(blockVal) ?? null;
+			else {
+				const ids = blockVal;
+				expandedData[blockId][fieldName] = ids.map((id) => recordMap.get(id)).filter(Boolean);
+			}
+		}
+	}
+	return expandedData;
+}
+/**
+* Process blocks data for a single blocks document.
+*
+* This function does two things:
+* 1. **Expands declared fields** from `.prefetch({ with: [...] })` (batch-fetched)
+* 2. **Executes prefetch functions/loaders** for blocks that have them
+*
+* The results are merged into `_data[blockId]`. Prefetch function / loader data
+* takes precedence over expanded data on key conflicts.
+*
+* @param blocks - The blocks document to process
+* @param blockDefinitions - Registered block definitions
+* @param ctx - Prefetch context
+* @returns The blocks document with `_data` populated
+*/
+async function processBlocksDocument(blocks, blockDefinitions, ctx) {
+	if (!blocks || !blocks._tree || !blocks._values) return blocks;
+	const allNodes = [];
+	const collectNodes = (nodes) => {
+		for (const node of nodes) {
+			allNodes.push(node);
+			if (node.children.length > 0) collectNodes(node.children);
+		}
+	};
+	collectNodes(blocks._tree);
+	const expandedData = await expandDeclaredFields(allNodes, blocks._values, blockDefinitions, ctx);
+	const prefetchedData = await executePrefetchFunctions(allNodes, blocks._values, blockDefinitions, ctx, expandedData);
+	const mergedData = {};
+	const allBlockIds = new Set([...Object.keys(expandedData), ...Object.keys(prefetchedData)]);
+	for (const blockId of allBlockIds) mergedData[blockId] = {
+		...expandedData[blockId] || {},
+		...prefetchedData[blockId] || {}
+	};
+	return {
+		...blocks,
+		_data: mergedData
+	};
+}
+/**
+* Execute prefetch functions and loaders for blocks.
+*
+* Handles two shapes:
+* - Shape 1: `state.prefetch` — call with `{ values, ctx }`
+* - Shape 3: `state._prefetchLoader` — call with `{ values, expanded, ctx }`
+*
+* Shape 2 (with-only) has no function to call — expansion is handled separately.
+*
+* @internal
+*/
+async function executePrefetchFunctions(allNodes, values, blockDefinitions, ctx, expandedData) {
+	const prefetchedData = {};
+	const prefetchPromises = [];
+	for (const node of allNodes) {
+		const blockDef = blockDefinitions[node.type];
+		if (!blockDef) continue;
+		const blockValues = values[node.id] || {};
+		const prefetchCtx = {
+			blockId: node.id,
+			blockType: node.type,
+			app: ctx.app,
+			db: ctx.db,
+			locale: ctx.locale
+		};
+		const loader = blockDef.state._prefetchLoader;
+		if (typeof loader === "function") {
+			const expanded = expandedData[node.id] || {};
+			prefetchPromises.push((async () => {
+				try {
+					const data = await loader({
+						values: blockValues,
+						expanded,
+						ctx: prefetchCtx
+					});
+					if (data && typeof data === "object") prefetchedData[node.id] = data;
+				} catch (error) {
+					console.error(`Block prefetch loader failed for ${node.type}:${node.id}:`, error);
+					prefetchedData[node.id] = { _error: "Prefetch failed" };
+				}
+			})());
+		} else if (blockDef.state.prefetch) prefetchPromises.push((async () => {
+			try {
+				const data = await blockDef.executePrefetch(blockValues, prefetchCtx);
+				prefetchedData[node.id] = data;
+			} catch (error) {
+				console.error(`Block prefetch failed for ${node.type}:${node.id}:`, error);
+				prefetchedData[node.id] = { _error: "Prefetch failed" };
+			}
+		})());
+	}
+	await Promise.all(prefetchPromises);
+	return prefetchedData;
+}
+/**
+* Process blocks prefetch for a document.
+* Finds all blocks fields in the document and processes them.
+*
+* @param doc - The document containing blocks fields
+* @param fieldDefinitions - Field definitions to identify blocks fields
+* @param blockDefinitions - Registered block definitions
+* @param ctx - Prefetch context
+* @returns The document with blocks prefetch data attached
+*/
+async function processDocumentBlocksPrefetch(doc, fieldDefinitions, blockDefinitions, ctx) {
+	if (!doc || !blockDefinitions || Object.keys(blockDefinitions).length === 0) return doc;
+	const result = { ...doc };
+	for (const [fieldName, fieldDef] of Object.entries(fieldDefinitions)) if (fieldDef?.state?.config?.type === "blocks" && result[fieldName]) result[fieldName] = await processBlocksDocument(result[fieldName], blockDefinitions, ctx);
+	return result;
+}
+/**
+* Create an afterRead hook for processing blocks prefetch.
+* This hook can be added to collections that have blocks fields.
+*
+* @example
+* ```ts
+* import { createBlocksPrefetchHook } from "@questpie/admin/server";
+*
+* const pages = q.collection("pages")
+*   .fields((f) => ({
+*     title: f.text({ required: true }),
+*     content: f.blocks({ allowedBlocks: ["hero", "text"] }),
+*   }))
+*   .hooks({
+*     afterRead: createBlocksPrefetchHook(),
+*   });
+* ```
+*/
+function createBlocksPrefetchHook() {
+	return async (ctx) => {
+		const blocks = ctx.app?.state?.blocks;
+		if (!blocks || Object.keys(blocks).length === 0) return;
+		for (const [key, value] of Object.entries(ctx.data)) if (isBlocksDocument(value)) ctx.data[key] = await processBlocksDocument(value, blocks, {
+			app: ctx.app,
+			db: ctx.db,
+			locale: ctx.locale
+		});
+	};
+}
+/**
+* Check if a value is a blocks document.
+*/
+function isBlocksDocument(value) {
+	if (!value || typeof value !== "object") return false;
+	const doc = value;
+	return Array.isArray(doc._tree) && typeof doc._values === "object" && doc._values !== null;
+}
+
+//#endregion
+export { createBlocksPrefetchHook, processBlocksDocument, processDocumentBlocksPrefetch };
+//# sourceMappingURL=prefetch.mjs.map

package/dist/server/block/prefetch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.mjs","names":["expandedData: Record<string, Record<string, unknown>>","allNodes: Array<{ id: string; type: string; children: any[] }>","mergedData: Record<string, Record<string, unknown>>","prefetchedData: Record<string, Record<string, unknown>>","prefetchPromises: Promise<void>[]","prefetchCtx: BlockPrefetchContext","result: Record<string, unknown>"],"sources":["../../../src/server/block/prefetch.ts"],"sourcesContent":["/**\n * Server CRUD Block Prefetch Utility\n *\n * Handles data fetching for blocks during the afterRead hook.\n * The fetched data is attached to `_data[blockId]` in the response.\n *\n * Two mechanisms populate `_data`:\n *\n * 1. **Declared field expansion** (`.prefetch({ with: [...] })`): Explicitly\n *    declared relation/upload fields are batch-fetched and expanded to full records.\n *    Only the fields listed in `with` are expanded — nothing is implicit.\n *\n * 2. **Custom prefetch function** (`.prefetch(fn)`): For computed data that can't\n *    be auto-expanded, define a prefetch function that returns arbitrary data.\n *\n * 3. **Expand + loader** (`.prefetch({ with: [...], loader })`): Expand fields\n *    first, then pass the expanded data to a loader for additional processing.\n *\n * @example\n * ```ts\n * // Shape 1: Pure function\n * block(\"featuredPosts\").prefetch(async ({ values, ctx }) => {\n *   return { posts: await fetchPosts(values.count) };\n * })\n *\n * // Shape 2: Expand specific fields\n * block(\"hero\").prefetch({ with: ['backgroundImage'] })\n *\n * // Shape 3: Expand + custom loader\n * block(\"hero\").prefetch({\n *   with: ['backgroundImage'],\n *   loader: async ({ expanded, ctx }) => ({\n *     analytics: await getStats(),\n *   }),\n * })\n * ```\n */\n\nimport type { RegisteredApp } from \"questpie\";\nimport type { BlocksDocument } from \"../fields/blocks.js\";\nimport type {\n\tAnyBlockDefinition,\n\tBlockPrefetchContext,\n} from \"./block-builder.js\";\n\n/**\n * Context for blocks prefetch processing.\n * Typed via Register.app when registered.\n */\nexport interface BlocksPrefetchContext {\n\t/** CMS app instance — typed via Register.app */\n\tapp: RegisteredApp;\n\t/** Database client */\n\tdb: unknown;\n\t/** Current locale */\n\tlocale?: string;\n}\n\n// ============================================================================\n// Declared field expansion (replaces old auto-expansion)\n// ============================================================================\n\n/**\n * Tracks a field that needs expansion.\n * @internal\n */\ninterface ExpansionTarget {\n\tblockId: string;\n\tfieldName: string;\n\t/** Whether the original value was a single ID (not an array) */\n\tisSingle: boolean;\n\t/** Nested `with` config to pass through to the collection's find call */\n\tnestedWith?: Record<string, unknown>;\n}\n\n/**\n * Expand relation/upload fields declared in `prefetchWith`.\n *\n * Uses the same object syntax as `with` in find operations:\n * ```ts\n * { backgroundImage: true, author: { with: { avatar: true } } }\n * ```\n *\n * Nested `with` is passed through to the collection's `find` call,\n * reusing the existing relation resolution machinery.\n *\n * @internal\n */\nasync function expandDeclaredFields(\n\tallNodes: Array<{ id: string; type: string }>,\n\tvalues: Record<string, Record<string, unknown>>,\n\tblockDefinitions: Record<string, AnyBlockDefinition>,\n\tctx: BlocksPrefetchContext,\n): Promise<Record<string, Record<string, unknown>>> {\n\t// Group expansion requirements by target collection for batch fetching\n\t// Key: \"collection:nestedWithHash\" to separate different with configs\n\tconst expansionsByCollection = new Map<\n\t\tstring,\n\t\t{\n\t\t\tids: Set<string>;\n\t\t\ttargets: ExpansionTarget[];\n\t\t\tnestedWith?: Record<string, unknown>;\n\t\t}\n\t>();\n\n\tfor (const node of allNodes) {\n\t\tconst blockDef = blockDefinitions[node.type];\n\t\tconst prefetchWith = blockDef?.state.prefetchWith;\n\t\tif (!prefetchWith || typeof prefetchWith !== \"object\") continue;\n\t\tif (!blockDef?.state.fields) continue;\n\n\t\tconst blockValues = values[node.id] || {};\n\n\t\tfor (const [fieldName, fieldConfig] of Object.entries(prefetchWith)) {\n\t\t\tif (!fieldConfig) continue;\n\n\t\t\tconst fieldDef = blockDef.state.fields[fieldName];\n\t\t\tif (!fieldDef || typeof fieldDef !== \"object\") continue;\n\n\t\t\t// Get field metadata to find the target collection\n\t\t\tconst metadata =\n\t\t\t\t\"getMetadata\" in fieldDef &&\n\t\t\t\ttypeof (fieldDef as any).getMetadata === \"function\"\n\t\t\t\t\t? (fieldDef as any).getMetadata()\n\t\t\t\t\t: undefined;\n\t\t\tif (!metadata) continue;\n\n\t\t\t// Support relation fields and upload fields\n\t\t\tif (metadata.type !== \"relation\") continue;\n\n\t\t\tconst targetCollection = metadata.targetCollection;\n\t\t\tif (!targetCollection || typeof targetCollection !== \"string\") continue;\n\n\t\t\t// Extract ID(s) from block value\n\t\t\tconst value = blockValues[fieldName];\n\t\t\tif (!value) continue;\n\n\t\t\tconst rawIds = Array.isArray(value) ? value : [value];\n\t\t\tconst stringIds = rawIds.filter(\n\t\t\t\t(id): id is string => typeof id === \"string\" && id.length > 0,\n\t\t\t);\n\t\t\tif (stringIds.length === 0) continue;\n\n\t\t\t// Extract nested `with` config (for passing to collection find)\n\t\t\tconst nestedWith =\n\t\t\t\ttypeof fieldConfig === \"object\" && fieldConfig.with\n\t\t\t\t\t? (fieldConfig.with as Record<string, unknown>)\n\t\t\t\t\t: undefined;\n\n\t\t\t// Group by collection + nested with config\n\t\t\tconst groupKey = nestedWith\n\t\t\t\t? `${targetCollection}:${JSON.stringify(nestedWith)}`\n\t\t\t\t: targetCollection;\n\n\t\t\tif (!expansionsByCollection.has(groupKey)) {\n\t\t\t\texpansionsByCollection.set(groupKey, {\n\t\t\t\t\tids: new Set(),\n\t\t\t\t\ttargets: [],\n\t\t\t\t\tnestedWith,\n\t\t\t\t});\n\t\t\t}\n\t\t\tconst entry = expansionsByCollection.get(groupKey)!;\n\t\t\tfor (const id of stringIds) entry.ids.add(id);\n\t\t\tentry.targets.push({\n\t\t\t\tblockId: node.id,\n\t\t\t\tfieldName,\n\t\t\t\tisSingle: !Array.isArray(value),\n\t\t\t\tnestedWith,\n\t\t\t});\n\t\t}\n\t}\n\n\tif (expansionsByCollection.size === 0) return {};\n\n\t// Batch-fetch records from each target collection\n\tconst fetchedByGroup = new Map<string, Map<string, unknown>>();\n\n\tconst fetchPromises = [...expansionsByCollection.entries()].map(\n\t\tasync ([groupKey, { ids, nestedWith }]) => {\n\t\t\t// Extract collection name from group key\n\t\t\tconst collection = groupKey.includes(\":\")\n\t\t\t\t? groupKey.slice(0, groupKey.indexOf(\":\"))\n\t\t\t\t: groupKey;\n\n\t\t\ttry {\n\t\t\t\tconst appApi = (ctx.app as any)?.api?.collections?.[collection];\n\t\t\t\tif (!appApi?.find) {\n\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t`[prefetch] Collection \"${collection}\" not found on app API, skipping`,\n\t\t\t\t\t);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Pass nested `with` through to collection's find — reuses existing\n\t\t\t\t// relation resolution machinery (same as find({ with: { ... } }))\n\t\t\t\tconst result = await appApi.find({\n\t\t\t\t\twhere: { id: { in: [...ids] } },\n\t\t\t\t\tlimit: ids.size,\n\t\t\t\t\t...(nestedWith ? { with: nestedWith } : {}),\n\t\t\t\t});\n\n\t\t\t\tconst recordMap = new Map<string, unknown>();\n\t\t\t\tfor (const doc of result?.docs || []) {\n\t\t\t\t\tif (doc && typeof doc === \"object\" && \"id\" in doc) {\n\t\t\t\t\t\trecordMap.set((doc as any).id, doc);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tfetchedByGroup.set(groupKey, recordMap);\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t`[prefetch] Failed to fetch from \"${collection}\":`,\n\t\t\t\t\terror,\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\t);\n\tawait Promise.all(fetchPromises);\n\n\t// Distribute expanded records to block _data\n\tconst expandedData: Record<string, Record<string, unknown>> = {};\n\n\tfor (const [groupKey, { targets }] of expansionsByCollection) {\n\t\tconst recordMap = fetchedByGroup.get(groupKey);\n\t\tif (!recordMap) continue;\n\n\t\tfor (const { blockId, fieldName, isSingle } of targets) {\n\t\t\tif (!expandedData[blockId]) expandedData[blockId] = {};\n\n\t\t\tconst blockVal = (values[blockId] || {})[fieldName];\n\t\t\tif (isSingle) {\n\t\t\t\texpandedData[blockId][fieldName] =\n\t\t\t\t\trecordMap.get(blockVal as string) ?? null;\n\t\t\t} else {\n\t\t\t\tconst ids = blockVal as string[];\n\t\t\t\texpandedData[blockId][fieldName] = ids\n\t\t\t\t\t.map((id) => recordMap.get(id))\n\t\t\t\t\t.filter(Boolean);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn expandedData;\n}\n\n// ============================================================================\n// Prefetch function execution\n// ============================================================================\n\n/**\n * Process blocks data for a single blocks document.\n *\n * This function does two things:\n * 1. **Expands declared fields** from `.prefetch({ with: [...] })` (batch-fetched)\n * 2. **Executes prefetch functions/loaders** for blocks that have them\n *\n * The results are merged into `_data[blockId]`. Prefetch function / loader data\n * takes precedence over expanded data on key conflicts.\n *\n * @param blocks - The blocks document to process\n * @param blockDefinitions - Registered block definitions\n * @param ctx - Prefetch context\n * @returns The blocks document with `_data` populated\n */\nexport async function processBlocksDocument(\n\tblocks: BlocksDocument | null | undefined,\n\tblockDefinitions: Record<string, AnyBlockDefinition>,\n\tctx: BlocksPrefetchContext,\n): Promise<BlocksDocument | null | undefined> {\n\tif (!blocks || !blocks._tree || !blocks._values) {\n\t\treturn blocks;\n\t}\n\n\t// Flatten the tree\n\tconst allNodes: Array<{ id: string; type: string; children: any[] }> = [];\n\tconst collectNodes = (\n\t\tnodes: Array<{ id: string; type: string; children: any[] }>,\n\t) => {\n\t\tfor (const node of nodes) {\n\t\t\tallNodes.push(node);\n\t\t\tif (node.children.length > 0) {\n\t\t\t\tcollectNodes(node.children);\n\t\t\t}\n\t\t}\n\t};\n\tcollectNodes(blocks._tree);\n\n\t// Step 1: Expand declared `with` fields (batch across all blocks)\n\tconst expandedData = await expandDeclaredFields(\n\t\tallNodes,\n\t\tblocks._values,\n\t\tblockDefinitions,\n\t\tctx,\n\t);\n\n\t// Step 2: Execute prefetch functions and loaders\n\tconst prefetchedData = await executePrefetchFunctions(\n\t\tallNodes,\n\t\tblocks._values,\n\t\tblockDefinitions,\n\t\tctx,\n\t\texpandedData,\n\t);\n\n\t// Step 3: Merge expanded + prefetched (prefetched overrides on conflict)\n\tconst mergedData: Record<string, Record<string, unknown>> = {};\n\tconst allBlockIds = new Set([\n\t\t...Object.keys(expandedData),\n\t\t...Object.keys(prefetchedData),\n\t]);\n\n\tfor (const blockId of allBlockIds) {\n\t\tmergedData[blockId] = {\n\t\t\t...(expandedData[blockId] || {}),\n\t\t\t...(prefetchedData[blockId] || {}),\n\t\t};\n\t}\n\n\treturn {\n\t\t...blocks,\n\t\t_data: mergedData,\n\t};\n}\n\n/**\n * Execute prefetch functions and loaders for blocks.\n *\n * Handles two shapes:\n * - Shape 1: `state.prefetch` — call with `{ values, ctx }`\n * - Shape 3: `state._prefetchLoader` — call with `{ values, expanded, ctx }`\n *\n * Shape 2 (with-only) has no function to call — expansion is handled separately.\n *\n * @internal\n */\nasync function executePrefetchFunctions(\n\tallNodes: Array<{ id: string; type: string }>,\n\tvalues: Record<string, Record<string, unknown>>,\n\tblockDefinitions: Record<string, AnyBlockDefinition>,\n\tctx: BlocksPrefetchContext,\n\texpandedData: Record<string, Record<string, unknown>>,\n): Promise<Record<string, Record<string, unknown>>> {\n\tconst prefetchedData: Record<string, Record<string, unknown>> = {};\n\tconst prefetchPromises: Promise<void>[] = [];\n\n\tfor (const node of allNodes) {\n\t\tconst blockDef = blockDefinitions[node.type];\n\t\tif (!blockDef) continue;\n\n\t\tconst blockValues = values[node.id] || {};\n\t\tconst prefetchCtx: BlockPrefetchContext = {\n\t\t\tblockId: node.id,\n\t\t\tblockType: node.type,\n\t\t\tapp: ctx.app,\n\t\t\tdb: ctx.db,\n\t\t\tlocale: ctx.locale,\n\t\t};\n\n\t\t// Shape 3: with + loader\n\t\tconst loader = (blockDef.state as any)._prefetchLoader;\n\t\tif (typeof loader === \"function\") {\n\t\t\tconst expanded = expandedData[node.id] || {};\n\t\t\tprefetchPromises.push(\n\t\t\t\t(async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst data = await loader({\n\t\t\t\t\t\t\tvalues: blockValues,\n\t\t\t\t\t\t\texpanded,\n\t\t\t\t\t\t\tctx: prefetchCtx,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tif (data && typeof data === \"object\") {\n\t\t\t\t\t\t\tprefetchedData[node.id] = data as Record<string, unknown>;\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\t`Block prefetch loader failed for ${node.type}:${node.id}:`,\n\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprefetchedData[node.id] = { _error: \"Prefetch failed\" };\n\t\t\t\t\t}\n\t\t\t\t})(),\n\t\t\t);\n\t\t}\n\t\t// Shape 1: pure function prefetch\n\t\telse if (blockDef.state.prefetch) {\n\t\t\tprefetchPromises.push(\n\t\t\t\t(async () => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst data = await blockDef.executePrefetch(\n\t\t\t\t\t\t\tblockValues,\n\t\t\t\t\t\t\tprefetchCtx,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprefetchedData[node.id] = data;\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\t`Block prefetch failed for ${node.type}:${node.id}:`,\n\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprefetchedData[node.id] = { _error: \"Prefetch failed\" };\n\t\t\t\t\t}\n\t\t\t\t})(),\n\t\t\t);\n\t\t}\n\t}\n\n\tawait Promise.all(prefetchPromises);\n\treturn prefetchedData;\n}\n\n/**\n * Process blocks prefetch for a document.\n * Finds all blocks fields in the document and processes them.\n *\n * @param doc - The document containing blocks fields\n * @param fieldDefinitions - Field definitions to identify blocks fields\n * @param blockDefinitions - Registered block definitions\n * @param ctx - Prefetch context\n * @returns The document with blocks prefetch data attached\n */\nexport async function processDocumentBlocksPrefetch<\n\tT extends Record<string, unknown>,\n>(\n\tdoc: T,\n\tfieldDefinitions: Record<string, { state: { config: { type?: string } } }>,\n\tblockDefinitions: Record<string, AnyBlockDefinition>,\n\tctx: BlocksPrefetchContext,\n): Promise<T> {\n\tif (!doc || !blockDefinitions || Object.keys(blockDefinitions).length === 0) {\n\t\treturn doc;\n\t}\n\n\tconst result: Record<string, unknown> = { ...doc };\n\n\t// Find all blocks fields and process them\n\tfor (const [fieldName, fieldDef] of Object.entries(fieldDefinitions)) {\n\t\tconst fieldType = fieldDef?.state?.config?.type;\n\n\t\tif (fieldType === \"blocks\" && result[fieldName]) {\n\t\t\tresult[fieldName] = await processBlocksDocument(\n\t\t\t\tresult[fieldName] as BlocksDocument,\n\t\t\t\tblockDefinitions,\n\t\t\t\tctx,\n\t\t\t);\n\t\t}\n\t}\n\n\treturn result as T;\n}\n\n/**\n * Create an afterRead hook for processing blocks prefetch.\n * This hook can be added to collections that have blocks fields.\n *\n * @example\n * ```ts\n * import { createBlocksPrefetchHook } from \"@questpie/admin/server\";\n *\n * const pages = q.collection(\"pages\")\n *   .fields((f) => ({\n *     title: f.text({ required: true }),\n *     content: f.blocks({ allowedBlocks: [\"hero\", \"text\"] }),\n *   }))\n *   .hooks({\n *     afterRead: createBlocksPrefetchHook(),\n *   });\n * ```\n */\nexport function createBlocksPrefetchHook() {\n\treturn async (ctx: {\n\t\tdata: Record<string, unknown>;\n\t\tapp: any;\n\t\tdb: unknown;\n\t\tlocale?: string;\n\t}) => {\n\t\tconst blocks = ctx.app?.state?.blocks;\n\t\tif (!blocks || Object.keys(blocks).length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Process any field that looks like blocks data\n\t\tfor (const [key, value] of Object.entries(ctx.data)) {\n\t\t\tif (isBlocksDocument(value)) {\n\t\t\t\tctx.data[key] = await processBlocksDocument(value, blocks, {\n\t\t\t\t\tapp: ctx.app,\n\t\t\t\t\tdb: ctx.db,\n\t\t\t\t\tlocale: ctx.locale,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t};\n}\n\n/**\n * Check if a value is a blocks document.\n */\nfunction isBlocksDocument(value: unknown): value is BlocksDocument {\n\tif (!value || typeof value !== \"object\") return false;\n\tconst doc = value as Record<string, unknown>;\n\treturn (\n\t\tArray.isArray(doc._tree) &&\n\t\ttypeof doc._values === \"object\" &&\n\t\tdoc._values !== null\n\t);\n}\n"],"mappings":"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"}

package/dist/server/fields/blocks.d.mts

@@ -0,0 +1,139 @@
+import { AnyBlockDefinition } from "../block/block-builder.mjs";
+import { z } from "zod";
+import * as questpie18982 from "questpie";
+import { BaseFieldConfig, ContextualOperators, FieldMetadataBase } from "questpie";
+
+//#region src/server/fields/blocks.d.ts
+
+/**
+ * Block node in the tree structure.
+ * Each block has an id, type, and optional children.
+ */
+interface BlockNode {
+  /** Unique identifier for this block instance */
+  id: string;
+  /** Block type name (e.g., "hero", "text", "image") */
+  type: string;
+  /** Nested child blocks */
+  children: BlockNode[];
+}
+/**
+ * Block field values.
+ * Maps field names to their values for a single block.
+ */
+type BlockValues = Record<string, {}>;
+/**
+ * Blocks document structure.
+ * Normalized format separating tree structure from values.
+ */
+interface BlocksDocument {
+  /** Tree structure defining block hierarchy */
+  _tree: BlockNode[];
+  /** Map of block id to field values */
+  _values: Record<string, BlockValues>;
+  /** Prefetched data for blocks (populated by afterRead hook) */
+  _data?: Record<string, Record<string, {}>>;
+}
+/**
+ * Blocks field metadata - augmentable by external packages.
+ *
+ * @example Admin augmentation:
+ * ```ts
+ * declare module "@questpie/admin/server" {
+ *   interface BlocksFieldMeta {
+ *     admin?: {
+ *       addLabel?: string;
+ *       emptyMessage?: string;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+interface BlocksFieldMeta {
+  /** Phantom property to prevent interface collapse - enables module augmentation */
+  _?: never;
+}
+/**
+ * Blocks field configuration options.
+ */
+interface BlocksFieldConfig extends BaseFieldConfig {
+  /** Field-specific metadata, augmentable by external packages. */
+  meta?: BlocksFieldMeta;
+  /**
+   * Allowed block types.
+   * If specified, only these block types can be added.
+   * Block types must be registered via `.blocks()` on the CMS builder.
+   */
+  allowedBlocks?: string[];
+  /**
+   * Minimum number of blocks required.
+   */
+  minBlocks?: number;
+  /**
+   * Maximum number of blocks allowed.
+   */
+  maxBlocks?: number;
+  /**
+   * Allow nesting blocks (blocks with children).
+   * @default true
+   */
+  allowNesting?: boolean;
+  /**
+   * Maximum nesting depth for blocks.
+   * Only applies when allowNesting is true.
+   * @default 3
+   */
+  maxDepth?: number;
+  /**
+   * Placeholder text shown when no blocks exist.
+   */
+  placeholder?: string;
+  /**
+   * Block definitions injected at build time by `.blocks()` patch.
+   * Used for per-block field validation in toZodSchema().
+   * @internal
+   */
+  _blockDefinitions?: Record<string, AnyBlockDefinition>;
+}
+/**
+ * Blocks field factory.
+ * Creates a visual block editor field for page builder functionality.
+ *
+ * @example
+ * ```ts
+ * // Basic blocks field
+ * const content = blocksField({ label: "Content" });
+ *
+ * // With allowed blocks
+ * const pageContent = blocksField({
+ *   label: "Page Sections",
+ *   allowedBlocks: ["hero", "features", "testimonials", "cta"],
+ *   minBlocks: 1,
+ *   maxBlocks: 20,
+ * });
+ *
+ * // With nesting disabled
+ * const simpleBlocks = blocksField({
+ *   label: "Components",
+ *   allowNesting: false,
+ * });
+ * ```
+ */
+declare const blocksField: {
+  readonly type: "blocks";
+  readonly _value: BlocksDocument;
+  readonly toColumn: (_name: string, config: BlocksFieldConfig) => any;
+  readonly toZodSchema: (config: BlocksFieldConfig) => z.ZodType<BlocksDocument | null | undefined, unknown, z.core.$ZodTypeInternals<BlocksDocument | null | undefined, unknown>>;
+  readonly getOperators: <TApp>() => ContextualOperators<questpie18982.OperatorMap, questpie18982.OperatorMap>;
+  readonly getMetadata: (config: BlocksFieldConfig) => FieldMetadataBase & {
+    allowedBlocks?: string[];
+    minBlocks?: number;
+    maxBlocks?: number;
+    allowNesting: boolean;
+    maxDepth: number;
+    placeholder?: string;
+  };
+};
+//#endregion
+export { BlockNode, BlockValues, BlocksDocument, BlocksFieldConfig, BlocksFieldMeta, blocksField };
+//# sourceMappingURL=blocks.d.mts.map

package/dist/server/fields/blocks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.mts","names":[],"sources":["../../../src/server/fields/blocks.ts"],"sourcesContent":[],"mappings":";;;;;;;AAkFA;AAYA;;;AA4CqB,UAvGJ,SAAA,CAuGI;EA5CsB;EAAe,EAAA,EAAA,MAAA;EAsJ7C;EAEoB,IAAA,EAAA,MAAA;EAEA;EAmBZ,QAAA,EAlOV,SAkOU,EAAA;;;;;;AAuGH,KAlUN,WAAA,GAAc,MAkUR,CAAA,MAAA,EAAA,CAAA,CAAA,CAAA;;;;;UA5TD,cAAA;;SAET;;WAEE,eAAe;;UAEhB,eAAe;;;;;;;;;;;;;;;;;UAsBP,eAAA;;;;;;;UAYA,iBAAA,SAA0B;;SAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA0Ca,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;cA0GvB;;mBAEoB;6CAEA;iCAmBZ,sBAAiB,CAAA,CAAA,QAAA,4CAAA,CAAA,CAAA,IAAA,CAAA,kBAAA;qCAuGpB,oBAvGoB,aAAA,CAuGpB,WAAA,EAAA,aAAA,CAAA,WAAA;iCAIG,sBAAoB"}

package/dist/server/fields/blocks.mjs

@@ -0,0 +1,192 @@
+import { z } from "zod";
+import { field, isNotNull, isNull, jsonb, sql } from "questpie";
+
+//#region src/server/fields/blocks.ts
+/**
+* Blocks Field Type
+*
+* Visual block editor field stored as JSONB.
+* Provides a tree-based structure for page builder functionality.
+*
+* The blocks field stores data in a normalized format:
+* - _tree: Array of block nodes with id, type, and children
+* - _values: Record mapping block id to field values
+*
+* This field type is only available when using adminModule.
+*/
+/**
+* Get operators for blocks field.
+* Provides operators for querying block content.
+*/
+function getBlocksOperators() {
+	return {
+		column: {
+			hasBlockType: (col, value) => sql`EXISTS (
+					SELECT 1 FROM jsonb_array_elements(${col}->'_tree') AS block
+					WHERE block->>'type' = ${value}
+				)`,
+			blockCount: (col, value) => {
+				const { op, count } = value;
+				const operator = op === "gte" ? ">=" : op === "lte" ? "<=" : "=";
+				return sql`jsonb_array_length(${col}->'_tree') ${sql.raw(operator)} ${count}`;
+			},
+			isEmpty: (col) => sql`(
+					${col} IS NULL 
+					OR ${col}->'_tree' IS NULL
+					OR jsonb_array_length(${col}->'_tree') = 0
+				)`,
+			isNotEmpty: (col) => sql`(
+					${col} IS NOT NULL 
+					AND ${col}->'_tree' IS NOT NULL
+					AND jsonb_array_length(${col}->'_tree') > 0
+				)`,
+			isNull: (col) => isNull(col),
+			isNotNull: (col) => isNotNull(col)
+		},
+		jsonb: {
+			hasBlockType: (col, value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`EXISTS (
+					SELECT 1 FROM jsonb_array_elements(${col}#>'{${sql.raw(path)},_tree}') AS block
+					WHERE block->>'type' = ${value}
+				)`;
+			},
+			isEmpty: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`(
+					${col}#>'{${sql.raw(path)}}' IS NULL 
+					OR ${col}#>'{${sql.raw(path)},_tree}' IS NULL
+					OR jsonb_array_length(${col}#>'{${sql.raw(path)},_tree}') = 0
+				)`;
+			},
+			isNotEmpty: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`(
+					${col}#>'{${sql.raw(path)}}' IS NOT NULL 
+					AND ${col}#>'{${sql.raw(path)},_tree}' IS NOT NULL
+					AND jsonb_array_length(${col}#>'{${sql.raw(path)},_tree}') > 0
+				)`;
+			},
+			isNull: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`${col}#>'{${sql.raw(path)}}' IS NULL`;
+			},
+			isNotNull: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`${col}#>'{${sql.raw(path)}}' IS NOT NULL`;
+			}
+		}
+	};
+}
+/**
+* Blocks field factory.
+* Creates a visual block editor field for page builder functionality.
+*
+* @example
+* ```ts
+* // Basic blocks field
+* const content = blocksField({ label: "Content" });
+*
+* // With allowed blocks
+* const pageContent = blocksField({
+*   label: "Page Sections",
+*   allowedBlocks: ["hero", "features", "testimonials", "cta"],
+*   minBlocks: 1,
+*   maxBlocks: 20,
+* });
+*
+* // With nesting disabled
+* const simpleBlocks = blocksField({
+*   label: "Components",
+*   allowNesting: false,
+* });
+* ```
+*/
+const blocksField = field()({
+	type: "blocks",
+	_value: void 0,
+	toColumn(_name, config) {
+		let column = jsonb();
+		if (config.required && config.nullable !== true) column = column.notNull();
+		if (config.default !== void 0) {
+			const defaultValue = typeof config.default === "function" ? config.default() : config.default;
+			column = column.default(defaultValue);
+		}
+		return column;
+	},
+	toZodSchema(config) {
+		const blockNodeSchema = z.lazy(() => z.object({
+			id: z.string(),
+			type: z.string(),
+			children: z.array(blockNodeSchema).default([])
+		}));
+		let docSchema = z.object({
+			_tree: z.array(blockNodeSchema),
+			_values: z.record(z.string(), z.record(z.string(), z.any()))
+		});
+		if (config.minBlocks !== void 0 || config.maxBlocks !== void 0) docSchema = docSchema.refine((doc) => {
+			const count = doc._tree.length;
+			if (config.minBlocks !== void 0 && count < config.minBlocks) return false;
+			if (config.maxBlocks !== void 0 && count > config.maxBlocks) return false;
+			return true;
+		}, { message: config.minBlocks !== void 0 && config.maxBlocks !== void 0 ? `Must have between ${config.minBlocks} and ${config.maxBlocks} blocks` : config.minBlocks !== void 0 ? `Must have at least ${config.minBlocks} blocks` : `Must have at most ${config.maxBlocks} blocks` });
+		if (config._blockDefinitions && Object.keys(config._blockDefinitions).length > 0) {
+			const blockDefs = config._blockDefinitions;
+			docSchema = docSchema.superRefine((doc, ctx) => {
+				const allNodes = [];
+				const collectNodes = (nodes) => {
+					for (const node of nodes) {
+						allNodes.push(node);
+						if (node.children.length > 0) collectNodes(node.children);
+					}
+				};
+				collectNodes(doc._tree);
+				for (const node of allNodes) {
+					const blockDef = blockDefs[node.type];
+					if (!blockDef?.state.fields) continue;
+					const blockValues = doc._values[node.id] || {};
+					for (const [fieldName, fieldDef] of Object.entries(blockDef.state.fields)) if (fieldDef && typeof fieldDef === "object" && "toZodSchema" in fieldDef && typeof fieldDef.toZodSchema === "function") {
+						const result = fieldDef.toZodSchema().safeParse(blockValues[fieldName]);
+						if (!result.success) for (const issue of result.error.issues) ctx.addIssue({
+							...issue,
+							path: [
+								"_values",
+								node.id,
+								fieldName,
+								...issue.path
+							],
+							message: `Block "${node.type}" field "${fieldName}": ${issue.message}`
+						});
+					}
+				}
+			});
+		}
+		if (!config.required && config.nullable !== false) return docSchema.nullish();
+		return docSchema;
+	},
+	getOperators() {
+		return getBlocksOperators();
+	},
+	getMetadata(config) {
+		return {
+			type: "blocks",
+			label: config.label,
+			description: config.description,
+			required: config.required ?? false,
+			localized: config.localized ?? false,
+			readOnly: config.input === false,
+			writeOnly: config.output === false,
+			meta: config.meta,
+			allowedBlocks: config.allowedBlocks,
+			minBlocks: config.minBlocks,
+			maxBlocks: config.maxBlocks,
+			allowNesting: config.allowNesting ?? true,
+			maxDepth: config.maxDepth ?? 3,
+			placeholder: config.placeholder
+		};
+	}
+});
+
+//#endregion
+export { blocksField };
+//# sourceMappingURL=blocks.mjs.map

package/dist/server/fields/blocks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.mjs","names":["column: any","blockNodeSchema: z.ZodType<BlockNode>","allNodes: BlockNode[]"],"sources":["../../../src/server/fields/blocks.ts"],"sourcesContent":["/**\n * Blocks Field Type\n *\n * Visual block editor field stored as JSONB.\n * Provides a tree-based structure for page builder functionality.\n *\n * The blocks field stores data in a normalized format:\n * - _tree: Array of block nodes with id, type, and children\n * - _values: Record mapping block id to field values\n *\n * This field type is only available when using adminModule.\n */\n\nimport {\n\ttype BaseFieldConfig,\n\ttype ContextualOperators,\n\ttype FieldMetadataBase,\n\tfield,\n\tisNotNull,\n\tisNull,\n\tjsonb,\n\tsql,\n} from \"questpie\";\n\nimport { z } from \"zod\";\nimport type { AnyBlockDefinition } from \"../block/block-builder.js\";\n\n// ============================================================================\n// Blocks Data Schema\n// ============================================================================\n\n/**\n * Block node in the tree structure.\n * Each block has an id, type, and optional children.\n */\nexport interface BlockNode {\n\t/** Unique identifier for this block instance */\n\tid: string;\n\t/** Block type name (e.g., \"hero\", \"text\", \"image\") */\n\ttype: string;\n\t/** Nested child blocks */\n\tchildren: BlockNode[];\n}\n\n/**\n * Block field values.\n * Maps field names to their values for a single block.\n */\nexport type BlockValues = Record<string, {}>;\n\n/**\n * Blocks document structure.\n * Normalized format separating tree structure from values.\n */\nexport interface BlocksDocument {\n\t/** Tree structure defining block hierarchy */\n\t_tree: BlockNode[];\n\t/** Map of block id to field values */\n\t_values: Record<string, BlockValues>;\n\t/** Prefetched data for blocks (populated by afterRead hook) */\n\t_data?: Record<string, Record<string, {}>>;\n}\n\n// ============================================================================\n// Blocks Field Meta (augmentable by admin)\n// ============================================================================\n\n/**\n * Blocks field metadata - augmentable by external packages.\n *\n * @example Admin augmentation:\n * ```ts\n * declare module \"@questpie/admin/server\" {\n *   interface BlocksFieldMeta {\n *     admin?: {\n *       addLabel?: string;\n *       emptyMessage?: string;\n *     }\n *   }\n * }\n * ```\n */\nexport interface BlocksFieldMeta {\n\t/** Phantom property to prevent interface collapse - enables module augmentation */\n\t_?: never;\n}\n\n// ============================================================================\n// Blocks Field Configuration\n// ============================================================================\n\n/**\n * Blocks field configuration options.\n */\nexport interface BlocksFieldConfig extends BaseFieldConfig {\n\t/** Field-specific metadata, augmentable by external packages. */\n\tmeta?: BlocksFieldMeta;\n\n\t/**\n\t * Allowed block types.\n\t * If specified, only these block types can be added.\n\t * Block types must be registered via `.blocks()` on the CMS builder.\n\t */\n\tallowedBlocks?: string[];\n\n\t/**\n\t * Minimum number of blocks required.\n\t */\n\tminBlocks?: number;\n\n\t/**\n\t * Maximum number of blocks allowed.\n\t */\n\tmaxBlocks?: number;\n\n\t/**\n\t * Allow nesting blocks (blocks with children).\n\t * @default true\n\t */\n\tallowNesting?: boolean;\n\n\t/**\n\t * Maximum nesting depth for blocks.\n\t * Only applies when allowNesting is true.\n\t * @default 3\n\t */\n\tmaxDepth?: number;\n\n\t/**\n\t * Placeholder text shown when no blocks exist.\n\t */\n\tplaceholder?: string;\n\n\t/**\n\t * Block definitions injected at build time by `.blocks()` patch.\n\t * Used for per-block field validation in toZodSchema().\n\t * @internal\n\t */\n\t_blockDefinitions?: Record<string, AnyBlockDefinition>;\n}\n\n// ============================================================================\n// Blocks Field Operators\n// ============================================================================\n\n/**\n * Get operators for blocks field.\n * Provides operators for querying block content.\n */\nfunction getBlocksOperators(): ContextualOperators {\n\treturn {\n\t\tcolumn: {\n\t\t\t// Check if any block of a specific type exists\n\t\t\thasBlockType: (col, value) =>\n\t\t\t\tsql`EXISTS (\n\t\t\t\t\tSELECT 1 FROM jsonb_array_elements(${col}->'_tree') AS block\n\t\t\t\t\tWHERE block->>'type' = ${value}\n\t\t\t\t)`,\n\t\t\t// Count blocks at root level\n\t\t\tblockCount: (col, value) => {\n\t\t\t\tconst { op, count } = value as { op: string; count: number };\n\t\t\t\tconst operator = op === \"gte\" ? \">=\" : op === \"lte\" ? \"<=\" : \"=\";\n\t\t\t\treturn sql`jsonb_array_length(${col}->'_tree') ${sql.raw(operator)} ${count}`;\n\t\t\t},\n\t\t\t// Check if document is empty (no blocks)\n\t\t\tisEmpty: (col) =>\n\t\t\t\tsql`(\n\t\t\t\t\t${col} IS NULL \n\t\t\t\t\tOR ${col}->'_tree' IS NULL\n\t\t\t\t\tOR jsonb_array_length(${col}->'_tree') = 0\n\t\t\t\t)`,\n\t\t\tisNotEmpty: (col) =>\n\t\t\t\tsql`(\n\t\t\t\t\t${col} IS NOT NULL \n\t\t\t\t\tAND ${col}->'_tree' IS NOT NULL\n\t\t\t\t\tAND jsonb_array_length(${col}->'_tree') > 0\n\t\t\t\t)`,\n\t\t\tisNull: (col) => isNull(col),\n\t\t\tisNotNull: (col) => isNotNull(col),\n\t\t},\n\t\tjsonb: {\n\t\t\thasBlockType: (col, value, ctx) => {\n\t\t\t\tconst path = ctx.jsonbPath?.join(\",\") ?? \"\";\n\t\t\t\treturn sql`EXISTS (\n\t\t\t\t\tSELECT 1 FROM jsonb_array_elements(${col}#>'{${sql.raw(path)},_tree}') AS block\n\t\t\t\t\tWHERE block->>'type' = ${value}\n\t\t\t\t)`;\n\t\t\t},\n\t\t\tisEmpty: (col, _value, ctx) => {\n\t\t\t\tconst path = ctx.jsonbPath?.join(\",\") ?? \"\";\n\t\t\t\treturn sql`(\n\t\t\t\t\t${col}#>'{${sql.raw(path)}}' IS NULL \n\t\t\t\t\tOR ${col}#>'{${sql.raw(path)},_tree}' IS NULL\n\t\t\t\t\tOR jsonb_array_length(${col}#>'{${sql.raw(path)},_tree}') = 0\n\t\t\t\t)`;\n\t\t\t},\n\t\t\tisNotEmpty: (col, _value, ctx) => {\n\t\t\t\tconst path = ctx.jsonbPath?.join(\",\") ?? \"\";\n\t\t\t\treturn sql`(\n\t\t\t\t\t${col}#>'{${sql.raw(path)}}' IS NOT NULL \n\t\t\t\t\tAND ${col}#>'{${sql.raw(path)},_tree}' IS NOT NULL\n\t\t\t\t\tAND jsonb_array_length(${col}#>'{${sql.raw(path)},_tree}') > 0\n\t\t\t\t)`;\n\t\t\t},\n\t\t\tisNull: (col, _value, ctx) => {\n\t\t\t\tconst path = ctx.jsonbPath?.join(\",\") ?? \"\";\n\t\t\t\treturn sql`${col}#>'{${sql.raw(path)}}' IS NULL`;\n\t\t\t},\n\t\t\tisNotNull: (col, _value, ctx) => {\n\t\t\t\tconst path = ctx.jsonbPath?.join(\",\") ?? \"\";\n\t\t\t\treturn sql`${col}#>'{${sql.raw(path)}}' IS NOT NULL`;\n\t\t\t},\n\t\t},\n\t};\n}\n\n// ============================================================================\n// Blocks Field Definition\n// ============================================================================\n\n/**\n * Blocks field factory.\n * Creates a visual block editor field for page builder functionality.\n *\n * @example\n * ```ts\n * // Basic blocks field\n * const content = blocksField({ label: \"Content\" });\n *\n * // With allowed blocks\n * const pageContent = blocksField({\n *   label: \"Page Sections\",\n *   allowedBlocks: [\"hero\", \"features\", \"testimonials\", \"cta\"],\n *   minBlocks: 1,\n *   maxBlocks: 20,\n * });\n *\n * // With nesting disabled\n * const simpleBlocks = blocksField({\n *   label: \"Components\",\n *   allowNesting: false,\n * });\n * ```\n */\nexport const blocksField = field<BlocksFieldConfig, BlocksDocument>()({\n\ttype: \"blocks\" as const,\n\t_value: undefined as unknown as BlocksDocument,\n\n\ttoColumn(_name: string, config: BlocksFieldConfig) {\n\t\t// Blocks are always stored as JSONB\n\t\tlet column: any = jsonb();\n\n\t\t// Apply constraints\n\t\tif (config.required && config.nullable !== true) {\n\t\t\tcolumn = column.notNull();\n\t\t}\n\t\tif (config.default !== undefined) {\n\t\t\tconst defaultValue =\n\t\t\t\ttypeof config.default === \"function\"\n\t\t\t\t\t? config.default()\n\t\t\t\t\t: config.default;\n\t\t\tcolumn = column.default(defaultValue);\n\t\t}\n\n\t\treturn column;\n\t},\n\n\ttoZodSchema(config: BlocksFieldConfig) {\n\t\t// Block node schema (recursive for nested blocks)\n\t\tconst blockNodeSchema: z.ZodType<BlockNode> = z.lazy(() =>\n\t\t\tz.object({\n\t\t\t\tid: z.string(),\n\t\t\t\ttype: z.string(),\n\t\t\t\tchildren: z.array(blockNodeSchema).default([]),\n\t\t\t}),\n\t\t);\n\n\t\t// Blocks document schema\n\t\tlet docSchema = z.object({\n\t\t\t_tree: z.array(blockNodeSchema),\n\t\t\t_values: z.record(z.string(), z.record(z.string(), z.any())),\n\t\t});\n\n\t\t// Apply validation for min/max blocks\n\t\tif (config.minBlocks !== undefined || config.maxBlocks !== undefined) {\n\t\t\tdocSchema = docSchema.refine(\n\t\t\t\t(doc) => {\n\t\t\t\t\tconst count = doc._tree.length;\n\t\t\t\t\tif (config.minBlocks !== undefined && count < config.minBlocks) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\tif (config.maxBlocks !== undefined && count > config.maxBlocks) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\treturn true;\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tmessage:\n\t\t\t\t\t\tconfig.minBlocks !== undefined && config.maxBlocks !== undefined\n\t\t\t\t\t\t\t? `Must have between ${config.minBlocks} and ${config.maxBlocks} blocks`\n\t\t\t\t\t\t\t: config.minBlocks !== undefined\n\t\t\t\t\t\t\t\t? `Must have at least ${config.minBlocks} blocks`\n\t\t\t\t\t\t\t\t: `Must have at most ${config.maxBlocks} blocks`,\n\t\t\t\t},\n\t\t\t) as typeof docSchema;\n\t\t}\n\n\t\t// Per-block field validation when block definitions are available\n\t\tif (\n\t\t\tconfig._blockDefinitions &&\n\t\t\tObject.keys(config._blockDefinitions).length > 0\n\t\t) {\n\t\t\tconst blockDefs = config._blockDefinitions;\n\t\t\tdocSchema = docSchema.superRefine((doc, ctx) => {\n\t\t\t\t// Collect all block nodes (flatten tree)\n\t\t\t\tconst allNodes: BlockNode[] = [];\n\t\t\t\tconst collectNodes = (nodes: BlockNode[]) => {\n\t\t\t\t\tfor (const node of nodes) {\n\t\t\t\t\t\tallNodes.push(node);\n\t\t\t\t\t\tif (node.children.length > 0) {\n\t\t\t\t\t\t\tcollectNodes(node.children);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\tcollectNodes(doc._tree);\n\n\t\t\t\t// Validate each block's values against its definition's field schemas\n\t\t\t\tfor (const node of allNodes) {\n\t\t\t\t\tconst blockDef = blockDefs[node.type];\n\t\t\t\t\tif (!blockDef?.state.fields) continue;\n\n\t\t\t\t\tconst blockValues = doc._values[node.id] || {};\n\n\t\t\t\t\tfor (const [fieldName, fieldDef] of Object.entries(\n\t\t\t\t\t\tblockDef.state.fields,\n\t\t\t\t\t)) {\n\t\t\t\t\t\t// Server FieldDefinition has toZodSchema()\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\tfieldDef &&\n\t\t\t\t\t\t\ttypeof fieldDef === \"object\" &&\n\t\t\t\t\t\t\t\"toZodSchema\" in fieldDef &&\n\t\t\t\t\t\t\ttypeof (fieldDef as any).toZodSchema === \"function\"\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\tconst fieldSchema = (fieldDef as any).toZodSchema() as z.ZodType;\n\t\t\t\t\t\t\tconst result = fieldSchema.safeParse(blockValues[fieldName]);\n\t\t\t\t\t\t\tif (!result.success) {\n\t\t\t\t\t\t\t\tfor (const issue of result.error.issues) {\n\t\t\t\t\t\t\t\t\tctx.addIssue({\n\t\t\t\t\t\t\t\t\t\t...issue,\n\t\t\t\t\t\t\t\t\t\tpath: [\"_values\", node.id, fieldName, ...issue.path],\n\t\t\t\t\t\t\t\t\t\tmessage: `Block \"${node.type}\" field \"${fieldName}\": ${issue.message}`,\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}) as typeof docSchema;\n\t\t}\n\n\t\t// Nullability\n\t\tif (!config.required && config.nullable !== false) {\n\t\t\treturn docSchema.nullish() as z.ZodType<\n\t\t\t\tBlocksDocument | null | undefined\n\t\t\t>;\n\t\t}\n\n\t\treturn docSchema as z.ZodType<BlocksDocument>;\n\t},\n\n\tgetOperators<TApp>() {\n\t\treturn getBlocksOperators();\n\t},\n\n\tgetMetadata(config: BlocksFieldConfig): FieldMetadataBase & {\n\t\tallowedBlocks?: string[];\n\t\tminBlocks?: number;\n\t\tmaxBlocks?: number;\n\t\tallowNesting: boolean;\n\t\tmaxDepth: number;\n\t\tplaceholder?: string;\n\t} {\n\t\treturn {\n\t\t\ttype: \"blocks\",\n\t\t\tlabel: config.label,\n\t\t\tdescription: config.description,\n\t\t\trequired: config.required ?? false,\n\t\t\tlocalized: config.localized ?? false,\n\t\t\treadOnly: config.input === false,\n\t\t\twriteOnly: config.output === false,\n\t\t\tmeta: config.meta,\n\t\t\t// Blocks specific\n\t\t\tallowedBlocks: config.allowedBlocks,\n\t\t\tminBlocks: config.minBlocks,\n\t\t\tmaxBlocks: config.maxBlocks,\n\t\t\tallowNesting: config.allowNesting ?? true,\n\t\t\tmaxDepth: config.maxDepth ?? 3,\n\t\t\tplaceholder: config.placeholder,\n\t\t};\n\t},\n});\n"],"mappings":"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"}