@questpie/admin 3.2.0 → 3.2.1

package/dist/client/preview/types.mjs

@@ -1,19 +1,98 @@
 //#region src/client/preview/types.ts
+const MAX_INLINE_EDIT_PAYLOAD_BYTES = 64 * 1024;
+const MAX_PATCH_BATCH_OPS = 500;
+function isRecord(data) {
+	return !!data && typeof data === "object" && !Array.isArray(data);
+}
+function isString(value) {
+	return typeof value === "string";
+}
+function isNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+function isPositiveInteger(value) {
+	return Number.isInteger(value) && value >= 0;
+}
+function isInputKind(value) {
+	return value === "text" || value === "textarea" || value === "number" || value === "boolean";
+}
+function isPreviewFieldType(value) {
+	return value === "regular" || value === "block" || value === "relation";
+}
+function isBlockInsertPosition(value) {
+	if (!isRecord(value)) return false;
+	return (value.parentId === null || isString(value.parentId)) && isPositiveInteger(value.index);
+}
+function isSerializableValue(value) {
+	try {
+		const seen = /* @__PURE__ */ new WeakSet();
+		JSON.stringify(value, (_key, nestedValue) => {
+			if (typeof nestedValue === "function") throw new TypeError("Functions are not serializable");
+			if (typeof nestedValue === "symbol") throw new TypeError("Symbols are not serializable");
+			if (typeof nestedValue === "bigint") throw new TypeError("BigInts are not JSON serializable");
+			if (nestedValue && typeof nestedValue === "object") {
+				if (seen.has(nestedValue)) throw new TypeError("Circular values are not serializable");
+				seen.add(nestedValue);
+			}
+			return nestedValue;
+		});
+		return true;
+	} catch {
+		return false;
+	}
+}
+function getJsonByteLength(value) {
+	try {
+		const json = JSON.stringify(value);
+		if (json === void 0) return 0;
+		if (typeof TextEncoder === "undefined") return json.length;
+		return new TextEncoder().encode(json).length;
+	} catch {
+		return Number.POSITIVE_INFINITY;
+	}
+}
+function isReasonablePayload(value, maxBytes) {
+	return isSerializableValue(value) && getJsonByteLength(value) <= maxBytes;
+}
+function isPreviewPatchOp(value) {
+	if (!isRecord(value)) return false;
+	if (value.op !== "set" && value.op !== "remove") return false;
+	if (!isString(value.path) || value.path.length === 0) return false;
+	if (value.op === "set" && !isSerializableValue(value.value)) return false;
+	return true;
+}
 /**
 * Check if a message is from admin to preview.
 */
 function isAdminToPreviewMessage(data) {
-	if (!data || typeof data !== "object") return false;
-	const msg = data;
-	return msg.type === "PREVIEW_REFRESH" || msg.type === "SELECT_BLOCK" || msg.type === "FOCUS_FIELD";
+	if (!isRecord(data)) return false;
+	switch (data.type) {
+		case "PREVIEW_REFRESH": return data.changedField === void 0 || isString(data.changedField);
+		case "SELECT_BLOCK": return isString(data.blockId) && data.blockId.length > 0;
+		case "FOCUS_FIELD": return isString(data.fieldPath) && data.fieldPath.length > 0;
+		case "INIT_SNAPSHOT":
+		case "COMMIT": return isPositiveInteger(data.seq) && isSerializableValue(data.data);
+		case "PATCH_BATCH": return isPositiveInteger(data.seq) && Array.isArray(data.ops) && data.ops.length <= MAX_PATCH_BATCH_OPS && data.ops.every(isPreviewPatchOp) && (data.snapshotVersion === void 0 || isPositiveInteger(data.snapshotVersion));
+		case "FULL_RESYNC": return data.reason === void 0 || isString(data.reason);
+		default: return false;
+	}
 }
 /**
 * Check if a message is from preview to admin.
 */
 function isPreviewToAdminMessage(data) {
-	if (!data || typeof data !== "object") return false;
-	const msg = data;
-	return msg.type === "PREVIEW_READY" || msg.type === "FIELD_CLICKED" || msg.type === "BLOCK_CLICKED" || msg.type === "REFRESH_COMPLETE";
+	if (!isRecord(data)) return false;
+	switch (data.type) {
+		case "PREVIEW_READY": return true;
+		case "FIELD_CLICKED": return isString(data.fieldPath) && data.fieldPath.length > 0 && (data.blockId === void 0 || isString(data.blockId)) && (data.fieldType === void 0 || isPreviewFieldType(data.fieldType));
+		case "BLOCK_CLICKED": return isString(data.blockId) && data.blockId.length > 0;
+		case "BLOCK_INSERT_REQUESTED": return isBlockInsertPosition(data.position) && (data.referenceBlockId === void 0 || isString(data.referenceBlockId));
+		case "REFRESH_COMPLETE": return isNumber(data.timestamp);
+		case "PATCH_APPLIED": return isPositiveInteger(data.seq);
+		case "RESYNC_REQUEST": return data.reason === void 0 || isString(data.reason);
+		case "FIELD_VALUE_EDITED": return isString(data.path) && data.path.length > 0 && isInputKind(data.inputKind) && (data.blockId === void 0 || isString(data.blockId)) && (data.fieldType === void 0 || isPreviewFieldType(data.fieldType)) && isReasonablePayload(data.value, MAX_INLINE_EDIT_PAYLOAD_BYTES);
+		default: return false;
+	}
 }
 
 //#endregion

package/dist/client/preview/use-collection-preview.d.mts

@@ -15,7 +15,7 @@ type UseCollectionPreviewOptions<TData> = {
   onRefresh: () => void | Promise<void>;
 };
 type UseCollectionPreviewResult<TData> = {
-  /** Current data (from initialData, refreshed via onRefresh) */
+  /** Current data from the iframe draft mirror */
   data: TData;
   /** Whether we're in preview mode (inside admin iframe) */
   isPreviewMode: boolean;
@@ -30,6 +30,24 @@ type UseCollectionPreviewResult<TData> = {
   }) => void;
   /** Call when a block is clicked in preview */
   handleBlockClick: (blockId: string) => void;
+  /** Call when a preview insert control requests a new block */
+  handleBlockInsert: (payload: PreviewBlockInsertRequestedPayload) => void;
+  /** Call when an inline preview edit is committed */
+  handleFieldValueEdited: (payload: PreviewFieldValueEditedPayload) => void;
+};
+type PreviewBlockInsertRequestedPayload = {
+  position: {
+    parentId: string | null;
+    index: number;
+  };
+  referenceBlockId?: string;
+};
+type PreviewFieldValueEditedPayload = {
+  path: string;
+  value: unknown;
+  inputKind: "text" | "textarea" | "number" | "boolean";
+  blockId?: string;
+  fieldType?: "regular" | "block" | "relation";
 };
 /**
  * Hook for receiving live preview data from admin.

package/dist/client/preview/use-collection-preview.mjs

@@ -1,5 +1,6 @@
 "use client";
 
+import { applyPatchBatchImmutable, cloneSnapshot, shouldApplyPatchBatch } from "./patch.mjs";
 import { c } from "react/compiler-runtime";
 import * as React from "react";
 
@@ -42,84 +43,151 @@ import * as React from "react";
 * ```
 */
 function useCollectionPreview(t0) {
-	const $ = c(11);
+	const $ = c(30);
 	const { initialData, onRefresh } = t0;
+	let t1;
+	if ($[0] !== initialData) {
+		t1 = () => cloneSnapshot(initialData);
+		$[0] = initialData;
+		$[1] = t1;
+	} else t1 = $[1];
+	const [draftData, setDraftData] = React.useState(t1);
 	const [selectedBlockId, setSelectedBlockId] = React.useState(null);
 	const [focusedField, setFocusedField] = React.useState(null);
-	let t1;
-	bb0: {
-		if (typeof window === "undefined") {
-			t1 = false;
-			break bb0;
-		}
-		try {
-			t1 = window.self !== window.top;
-		} catch {
-			t1 = true;
-		}
-	}
-	const isPreviewMode = t1;
-	const onRefreshRef = React.useRef(onRefresh);
+	const [isPreviewMode, setIsPreviewMode] = React.useState(false);
+	const lastAppliedSeqRef = React.useRef(null);
+	const initialDataRef = React.useRef(initialData);
 	let t2;
 	let t3;
-	if ($[0] !== onRefresh) {
+	if ($[2] === Symbol.for("react.memo_cache_sentinel")) {
 		t2 = () => {
-			onRefreshRef.current = onRefresh;
+			try {
+				setIsPreviewMode(window.self !== window.top);
+			} catch {
+				setIsPreviewMode(true);
+			}
 		};
-		t3 = [onRefresh];
-		$[0] = onRefresh;
-		$[1] = t2;
-		$[2] = t3;
+		t3 = [];
+		$[2] = t2;
+		$[3] = t3;
 	} else {
-		t2 = $[1];
-		t3 = $[2];
+		t2 = $[2];
+		t3 = $[3];
 	}
 	React.useEffect(t2, t3);
+	const onRefreshRef = React.useRef(onRefresh);
 	let t4;
 	let t5;
-	if ($[3] === Symbol.for("react.memo_cache_sentinel")) {
+	if ($[4] !== onRefresh) {
 		t4 = () => {
+			onRefreshRef.current = onRefresh;
+		};
+		t5 = [onRefresh];
+		$[4] = onRefresh;
+		$[5] = t4;
+		$[6] = t5;
+	} else {
+		t4 = $[5];
+		t5 = $[6];
+	}
+	React.useEffect(t4, t5);
+	let t6;
+	let t7;
+	if ($[7] !== initialData) {
+		t6 = () => {
+			initialDataRef.current = initialData;
+			setDraftData(cloneSnapshot(initialData));
+		};
+		t7 = [initialData];
+		$[7] = initialData;
+		$[8] = t6;
+		$[9] = t7;
+	} else {
+		t6 = $[8];
+		t7 = $[9];
+	}
+	React.useEffect(t6, t7);
+	let t8;
+	let t9;
+	if ($[10] !== isPreviewMode) {
+		t8 = () => {
 			if (!isPreviewMode) return;
 			window.parent.postMessage({ type: "PREVIEW_READY" }, "*");
 			const handleMessage = async (event) => {
 				const message = event.data;
-				if (!message || typeof message !== "object" || !message.type) return;
-				bb32: switch (message.type) {
+				if (!isPreviewAdminMessage(message)) return;
+				bb24: switch (message.type) {
 					case "PREVIEW_REFRESH":
 						await onRefreshRef.current();
+						setDraftData(cloneSnapshot(initialDataRef.current));
 						window.parent.postMessage({
 							type: "REFRESH_COMPLETE",
 							timestamp: Date.now()
 						}, "*");
-						break bb32;
+						break bb24;
 					case "SELECT_BLOCK":
 						setSelectedBlockId(message.blockId);
-						break bb32;
+						break bb24;
 					case "FOCUS_FIELD":
 						setFocusedField(message.fieldPath);
 						setTimeout(() => {
-							const element = document.querySelector(`[data-preview-field="${message.fieldPath}"]`);
+							const element = findPreviewFieldElement(message.fieldPath);
 							if (element) element.scrollIntoView({
 								behavior: "smooth",
 								block: "center"
 							});
 						}, 150);
+						break bb24;
+					case "INIT_SNAPSHOT":
+						lastAppliedSeqRef.current = message.seq;
+						setDraftData(cloneSnapshot(message.data));
+						break bb24;
+					case "PATCH_BATCH":
+						if (!shouldApplyPatchBatch(lastAppliedSeqRef.current, message.seq)) break bb24;
+						try {
+							setDraftData((current) => applyPatchBatchImmutable(current, message.ops));
+							lastAppliedSeqRef.current = message.seq;
+							window.parent.postMessage({
+								type: "PATCH_APPLIED",
+								seq: message.seq,
+								snapshotVersion: message.snapshotVersion
+							}, "*");
+						} catch (t10$1) {
+							const error = t10$1;
+							window.parent.postMessage({
+								type: "RESYNC_REQUEST",
+								reason: error instanceof Error ? error.message : "Failed to apply preview patch batch"
+							}, "*");
+						}
+						break bb24;
+					case "COMMIT":
+						lastAppliedSeqRef.current = message.seq;
+						setDraftData(cloneSnapshot(message.data));
+						break bb24;
+					case "FULL_RESYNC":
+						await onRefreshRef.current();
+						setDraftData(cloneSnapshot(initialDataRef.current));
+						window.parent.postMessage({
+							type: "REFRESH_COMPLETE",
+							timestamp: Date.now()
+						}, "*");
 				}
 			};
 			window.addEventListener("message", handleMessage);
 			return () => window.removeEventListener("message", handleMessage);
 		};
-		t5 = [isPreviewMode];
-		$[3] = t4;
-		$[4] = t5;
+		t9 = [isPreviewMode];
+		$[10] = isPreviewMode;
+		$[11] = t8;
+		$[12] = t9;
 	} else {
-		t4 = $[3];
-		t5 = $[4];
+		t8 = $[11];
+		t9 = $[12];
 	}
-	React.useEffect(t4, t5);
-	let t6;
-	if ($[5] === Symbol.for("react.memo_cache_sentinel")) {
-		t6 = (fieldPath, context) => {
+	React.useEffect(t8, t9);
+	let t10;
+	if ($[13] !== isPreviewMode) {
+		t10 = (fieldPath, context) => {
 			if (isPreviewMode) window.parent.postMessage({
 				type: "FIELD_CLICKED",
 				fieldPath,
@@ -127,36 +195,92 @@ function useCollectionPreview(t0) {
 				fieldType: context?.fieldType
 			}, "*");
 		};
-		$[5] = t6;
-	} else t6 = $[5];
-	const handleFieldClick = t6;
-	let t7;
-	if ($[6] === Symbol.for("react.memo_cache_sentinel")) {
-		t7 = (blockId) => {
+		$[13] = isPreviewMode;
+		$[14] = t10;
+	} else t10 = $[14];
+	const handleFieldClick = t10;
+	let t11;
+	if ($[15] !== isPreviewMode) {
+		t11 = (blockId) => {
 			if (isPreviewMode) window.parent.postMessage({
 				type: "BLOCK_CLICKED",
 				blockId
 			}, "*");
 		};
-		$[6] = t7;
-	} else t7 = $[6];
-	const handleBlockClick = t7;
-	let t8;
-	if ($[7] !== focusedField || $[8] !== initialData || $[9] !== selectedBlockId) {
-		t8 = {
-			data: initialData,
+		$[15] = isPreviewMode;
+		$[16] = t11;
+	} else t11 = $[16];
+	const handleBlockClick = t11;
+	let t12;
+	if ($[17] !== isPreviewMode) {
+		t12 = (payload) => {
+			if (isPreviewMode) window.parent.postMessage({
+				type: "FIELD_VALUE_EDITED",
+				...payload
+			}, "*");
+		};
+		$[17] = isPreviewMode;
+		$[18] = t12;
+	} else t12 = $[18];
+	const handleFieldValueEdited = t12;
+	let t13;
+	if ($[19] !== isPreviewMode) {
+		t13 = (payload_0) => {
+			if (isPreviewMode) window.parent.postMessage({
+				type: "BLOCK_INSERT_REQUESTED",
+				...payload_0
+			}, "*");
+		};
+		$[19] = isPreviewMode;
+		$[20] = t13;
+	} else t13 = $[20];
+	const handleBlockInsert = t13;
+	let t14;
+	if ($[21] !== draftData || $[22] !== focusedField || $[23] !== handleBlockClick || $[24] !== handleBlockInsert || $[25] !== handleFieldClick || $[26] !== handleFieldValueEdited || $[27] !== isPreviewMode || $[28] !== selectedBlockId) {
+		t14 = {
+			data: draftData,
 			isPreviewMode,
 			selectedBlockId,
 			focusedField,
 			handleFieldClick,
-			handleBlockClick
+			handleBlockClick,
+			handleBlockInsert,
+			handleFieldValueEdited
 		};
-		$[7] = focusedField;
-		$[8] = initialData;
-		$[9] = selectedBlockId;
-		$[10] = t8;
-	} else t8 = $[10];
-	return t8;
+		$[21] = draftData;
+		$[22] = focusedField;
+		$[23] = handleBlockClick;
+		$[24] = handleBlockInsert;
+		$[25] = handleFieldClick;
+		$[26] = handleFieldValueEdited;
+		$[27] = isPreviewMode;
+		$[28] = selectedBlockId;
+		$[29] = t14;
+	} else t14 = $[29];
+	return t14;
+}
+function isPreviewAdminMessage(data) {
+	if (!data || typeof data !== "object") return false;
+	const message = data;
+	switch (message.type) {
+		case "PREVIEW_REFRESH":
+		case "FULL_RESYNC": return true;
+		case "SELECT_BLOCK": return typeof message.blockId === "string";
+		case "FOCUS_FIELD": return typeof message.fieldPath === "string";
+		case "INIT_SNAPSHOT":
+		case "COMMIT": return typeof message.seq === "number";
+		case "PATCH_BATCH": return typeof message.seq === "number" && Array.isArray(message.ops) && message.ops.every(isPreviewPatchOp);
+		default: return false;
+	}
+}
+function isPreviewPatchOp(value) {
+	if (!value || typeof value !== "object") return false;
+	const op = value;
+	return (op.op === "set" || op.op === "remove") && typeof op.path === "string";
+}
+function findPreviewFieldElement(fieldPath) {
+	const escaped = typeof CSS !== "undefined" && typeof CSS.escape === "function" ? CSS.escape(fieldPath) : fieldPath.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+	return document.querySelector(`[data-preview-field="${escaped}"]`);
 }
 
 //#endregion

package/dist/client/runtime/index.d.mts

@@ -1,5 +1,5 @@
 import "./content-locales-provider.mjs";
 import "./locale-scope.mjs";
 import { AdminProvider, AdminProviderProps, AdminState, AdminStore, selectAdmin, selectBasePath, selectClient, selectNavigate, useAdminStore } from "./provider.mjs";
-import { useShallow } from "zustand/shallow";
-export { useShallow };
+import { useShallow as useShallow$1 } from "zustand/shallow";
+export { useShallow$1 as useShallow };

package/dist/client/runtime/index.mjs

@@ -1,6 +1,6 @@
 import { AdminProvider, selectAdmin, selectAuthClient, selectBasePath, selectClient, selectContentLocale, selectNavigate, selectRealtime, selectSetContentLocale, useAdminStore } from "./provider.mjs";
 import { useSafeContentLocales } from "./content-locales-provider.mjs";
 import { LocaleScopeProvider, useScopedLocale } from "./locale-scope.mjs";
-import { useShallow } from "zustand/shallow";
+import { useShallow as useShallow$1 } from "zustand/shallow";
 
-export { useShallow };
+export { useShallow$1 as useShallow };

package/dist/client/runtime/provider.d.mts

@@ -106,17 +106,17 @@ interface AdminProviderProps {
   /**
    * Use server-side translations (fetched via getAdminTranslations RPC).
    * When true, translations are fetched from the server configured via
-   * .adminLocale() and config translations.
+   * config/admin.ts and config translations.
    *
    * @default false (for backwards compatibility)
    *
    * @example
    * ```tsx
    * // Server configures locales and messages
-   * const app = runtimeConfig({
-   *   modules: [adminModule],
-   *   adminLocale: { locales: ["en", "sk"], defaultLocale: "en" },
-   *   messages: { sk: { "common.save": "Ulozit" } },
+   * import { adminConfig } from "#questpie/factories";
+   *
+   * export default adminConfig({
+   *   locale: { locales: ["en", "sk"], defaultLocale: "en" },
    * });
    *
    * // Client fetches from server

package/dist/client/utils/build-field-definitions-from-schema.mjs

@@ -78,7 +78,7 @@ function buildFieldDefinition(fieldName, fieldSchema, relations, registry, overr
 	const fieldBuilder = registry[fieldType];
 	if (!fieldBuilder) return null;
 	const config = buildFieldConfig(fieldName, metadata, relations, registry, fieldType);
-	const adminConfig = metadata.meta?.admin;
+	const adminConfig = getAdminConfig(metadata.meta);
 	if (adminConfig) applyAdminConfig(config, adminConfig);
 	if (overrides) Object.assign(config, overrides);
 	return configureField(fieldBuilder, config);
@@ -211,7 +211,7 @@ function buildNestedFieldDefinitions(nestedFields, relations, registry) {
 		const fieldBuilder = registry[fieldType];
 		if (!fieldBuilder) continue;
 		const config = buildFieldConfig(nestedName, nestedMetadata, relations, registry, fieldType);
-		const adminConfig = nestedMetadata.meta?.admin;
+		const adminConfig = getAdminConfig(nestedMetadata.meta);
 		if (adminConfig) applyAdminConfig(config, adminConfig);
 		result[nestedName] = configureField(fieldBuilder, config);
 	}
@@ -233,7 +233,7 @@ function mapArrayItemType(type) {
 	]).has(type) ? type : null;
 }
 /**
-* Apply admin config overrides from server meta.admin
+* Apply admin config overrides from server meta
 *
 * Since each field type has its own admin meta with only valid properties,
 * we simply copy all defined properties from adminConfig to config.
@@ -241,6 +241,11 @@ function mapArrayItemType(type) {
 function applyAdminConfig(config, adminConfig) {
 	for (const [key, value] of Object.entries(adminConfig)) if (value !== void 0) config[key] = value;
 }
+function getAdminConfig(meta) {
+	if (!meta || typeof meta !== "object") return void 0;
+	const record = meta;
+	return record.admin ?? record;
+}
 /**
 * Check if a field is a system field that shouldn't be in forms
 */

package/dist/client/views/auth/reset-password-form.d.mts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime6 from "react/jsx-runtime";
+import * as react_jsx_runtime5 from "react/jsx-runtime";
 
 //#region src/client/views/auth/reset-password-form.d.ts
 /**
@@ -60,6 +60,6 @@ declare function ResetPasswordForm({
   minPasswordLength,
   className,
   error
-}: ResetPasswordFormProps): react_jsx_runtime6.JSX.Element;
+}: ResetPasswordFormProps): react_jsx_runtime5.JSX.Element;
 //#endregion
 export { ResetPasswordForm };

package/dist/client/views/auth/setup-form.d.mts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime5 from "react/jsx-runtime";
+import * as react_jsx_runtime6 from "react/jsx-runtime";
 
 //#region src/client/views/auth/setup-form.d.ts
 /**
@@ -55,6 +55,6 @@ declare function SetupForm({
   className,
   error,
   minPasswordLength
-}: SetupFormProps): react_jsx_runtime5.JSX.Element;
+}: SetupFormProps): react_jsx_runtime6.JSX.Element;
 //#endregion
 export { SetupForm, SetupFormValues };