@questpie/admin 2.0.0 → 3.0.0

package/dist/client/hooks/use-search-param-toggle.d.mts

@@ -0,0 +1,12 @@
+//#region src/client/hooks/use-search-param-toggle.d.ts
+interface UseSearchParamToggleOptions {
+  defaultValue?: boolean;
+  trueValue?: string;
+  legacyKeys?: Array<{
+    key: string;
+    trueValue?: string;
+  }>;
+}
+declare function useSearchParamToggle(key: string, options?: UseSearchParamToggleOptions): readonly [boolean, (next: boolean | ((prev: boolean) => boolean)) => void];
+//#endregion
+export { useSearchParamToggle };

package/dist/client/hooks/use-search-param-toggle.mjs

@@ -0,0 +1,115 @@
+import { SEARCH_PARAMS_EVENT } from "../lib/events.mjs";
+import { c } from "react/compiler-runtime";
+import * as React from "react";
+
+//#region src/client/hooks/use-search-param-toggle.ts
+function isTruthyParam(value, trueValue) {
+	if (value === null) return false;
+	if (value === trueValue) return true;
+	if (value === "true" || value === "1") return true;
+	return false;
+}
+function readToggleFromUrl(key, defaultValue, trueValue, legacyKeys = []) {
+	if (typeof window === "undefined") return defaultValue;
+	const params = new URLSearchParams(window.location.search);
+	const value = params.get(key);
+	if (isTruthyParam(value, trueValue)) return true;
+	for (const legacy of legacyKeys) if (isTruthyParam(params.get(legacy.key), legacy.trueValue ?? "true")) return true;
+	if (value === null) return defaultValue;
+	return false;
+}
+function writeToggleToUrl(key, value, trueValue, legacyKeys = []) {
+	if (typeof window === "undefined") return;
+	const url = new URL(window.location.href);
+	if (value) url.searchParams.set(key, trueValue);
+	else url.searchParams.delete(key);
+	for (const legacy of legacyKeys) url.searchParams.delete(legacy.key);
+	window.history.replaceState({}, "", url.toString());
+	window.dispatchEvent(new Event(SEARCH_PARAMS_EVENT));
+}
+function useSearchParamToggle(key, t0) {
+	const $ = c(22);
+	let t1;
+	if ($[0] !== t0) {
+		t1 = t0 === void 0 ? {} : t0;
+		$[0] = t0;
+		$[1] = t1;
+	} else t1 = $[1];
+	const options = t1;
+	const defaultValue = options.defaultValue ?? false;
+	const trueValue = options.trueValue ?? "true";
+	let t2;
+	if ($[2] !== options.legacyKeys) {
+		t2 = options.legacyKeys ?? [];
+		$[2] = options.legacyKeys;
+		$[3] = t2;
+	} else t2 = $[3];
+	const legacyKeys = t2;
+	let t3;
+	if ($[4] !== defaultValue || $[5] !== key || $[6] !== legacyKeys || $[7] !== trueValue) {
+		t3 = () => readToggleFromUrl(key, defaultValue, trueValue, legacyKeys);
+		$[4] = defaultValue;
+		$[5] = key;
+		$[6] = legacyKeys;
+		$[7] = trueValue;
+		$[8] = t3;
+	} else t3 = $[8];
+	const [value, setValue] = React.useState(t3);
+	let t4;
+	let t5;
+	if ($[9] !== defaultValue || $[10] !== key || $[11] !== legacyKeys || $[12] !== trueValue) {
+		t4 = () => {
+			const syncFromUrl = () => {
+				setValue(readToggleFromUrl(key, defaultValue, trueValue, legacyKeys));
+			};
+			window.addEventListener("popstate", syncFromUrl);
+			window.addEventListener(SEARCH_PARAMS_EVENT, syncFromUrl);
+			return () => {
+				window.removeEventListener("popstate", syncFromUrl);
+				window.removeEventListener(SEARCH_PARAMS_EVENT, syncFromUrl);
+			};
+		};
+		t5 = [
+			key,
+			defaultValue,
+			trueValue,
+			legacyKeys
+		];
+		$[9] = defaultValue;
+		$[10] = key;
+		$[11] = legacyKeys;
+		$[12] = trueValue;
+		$[13] = t4;
+		$[14] = t5;
+	} else {
+		t4 = $[13];
+		t5 = $[14];
+	}
+	React.useEffect(t4, t5);
+	let t6;
+	if ($[15] !== key || $[16] !== legacyKeys || $[17] !== trueValue) {
+		t6 = (next) => {
+			setValue((prev) => {
+				const resolved = typeof next === "function" ? next(prev) : next;
+				writeToggleToUrl(key, resolved, trueValue, legacyKeys);
+				return resolved;
+			});
+		};
+		$[15] = key;
+		$[16] = legacyKeys;
+		$[17] = trueValue;
+		$[18] = t6;
+	} else t6 = $[18];
+	const setToggle = t6;
+	let t7;
+	if ($[19] !== setToggle || $[20] !== value) {
+		t7 = [value, setToggle];
+		$[19] = setToggle;
+		$[20] = value;
+		$[21] = t7;
+	} else t7 = $[21];
+	return t7;
+}
+
+//#endregion
+export { useSearchParamToggle };

package/dist/client/hooks/use-search.mjs

@@ -1,13 +1,14 @@
 import { selectClient, useAdminStore } from "../runtime/provider.mjs";
 import { useScopedLocale } from "../runtime/locale-scope.mjs";
-import { useQuery } from "@tanstack/react-query";
+import { c } from "react/compiler-runtime";
 import { useEffect, useState } from "react";
+import { useQuery } from "@tanstack/react-query";
 
 //#region src/client/hooks/use-search.ts
 /**
 * Search Hook
 *
-* React hook for FTS-powered search using the CMS Search API.
+* React hook for FTS-powered search using the app Search API.
 * Returns full records with search metadata (score, highlights, indexed title).
 */
 /**
@@ -20,15 +21,29 @@ import { useEffect, useState } from "react";
 * ```
 */
 function useDebouncedValue(value, delay) {
+	const $ = c(4);
 	const [debouncedValue, setDebouncedValue] = useState(value);
-	useEffect(() => {
-		const timer = setTimeout(() => {
-			setDebouncedValue(value);
-		}, delay);
-		return () => {
-			clearTimeout(timer);
+	let t0;
+	let t1;
+	if ($[0] !== delay || $[1] !== value) {
+		t0 = () => {
+			const timer = setTimeout(() => {
+				setDebouncedValue(value);
+			}, delay);
+			return () => {
+				clearTimeout(timer);
+			};
 		};
-	}, [value, delay]);
+		t1 = [value, delay];
+		$[0] = delay;
+		$[1] = value;
+		$[2] = t0;
+		$[3] = t1;
+	} else {
+		t0 = $[2];
+		t1 = $[3];
+	}
+	useEffect(t0, t1);
 	return debouncedValue;
 }
 /**
@@ -60,12 +75,24 @@ function useDebouncedValue(value, delay) {
 * ```
 */
 function useSearch(options, queryOptions) {
+	const $ = c(25);
 	const client = useAdminStore(selectClient);
 	const { locale: contentLocale } = useScopedLocale();
-	const { collection, query, filters, limit = 50, offset = 0, highlights = true, facets, enabled } = options;
-	const isEnabled = enabled ?? query?.trim().length > 0;
-	return useQuery({
-		queryKey: [
+	const { collection, query, filters, limit: t0, offset: t1, highlights: t2, facets, enabled } = options;
+	const limit = t0 === void 0 ? 50 : t0;
+	const offset = t1 === void 0 ? 0 : t1;
+	const highlights = t2 === void 0 ? true : t2;
+	let t3;
+	if ($[0] !== enabled || $[1] !== query) {
+		t3 = enabled ?? query?.trim().length > 0;
+		$[0] = enabled;
+		$[1] = query;
+		$[2] = t3;
+	} else t3 = $[2];
+	const isEnabled = t3;
+	let t4;
+	if ($[3] !== collection || $[4] !== contentLocale || $[5] !== filters || $[6] !== limit || $[7] !== offset || $[8] !== query) {
+		t4 = [
 			"questpie",
 			"search",
 			collection,
@@ -74,8 +101,18 @@ function useSearch(options, queryOptions) {
 			limit,
 			offset,
 			contentLocale
-		],
-		queryFn: async () => {
+		];
+		$[3] = collection;
+		$[4] = contentLocale;
+		$[5] = filters;
+		$[6] = limit;
+		$[7] = offset;
+		$[8] = query;
+		$[9] = t4;
+	} else t4 = $[9];
+	let t5;
+	if ($[10] !== client || $[11] !== collection || $[12] !== contentLocale || $[13] !== facets || $[14] !== filters || $[15] !== highlights || $[16] !== limit || $[17] !== offset || $[18] !== query) {
+		t5 = async () => {
 			return await client.search.search({
 				query,
 				collections: [collection],
@@ -86,17 +123,52 @@ function useSearch(options, queryOptions) {
 				highlights,
 				facets
 			});
-		},
-		enabled: isEnabled,
-		placeholderData: (prev) => prev,
-		staleTime: 30 * 1e3,
-		...queryOptions
-	});
+		};
+		$[10] = client;
+		$[11] = collection;
+		$[12] = contentLocale;
+		$[13] = facets;
+		$[14] = filters;
+		$[15] = highlights;
+		$[16] = limit;
+		$[17] = offset;
+		$[18] = query;
+		$[19] = t5;
+	} else t5 = $[19];
+	let t6;
+	if ($[20] !== isEnabled || $[21] !== queryOptions || $[22] !== t4 || $[23] !== t5) {
+		t6 = {
+			queryKey: t4,
+			queryFn: t5,
+			enabled: isEnabled,
+			placeholderData: _temp,
+			staleTime: 3e4,
+			...queryOptions
+		};
+		$[20] = isEnabled;
+		$[21] = queryOptions;
+		$[22] = t4;
+		$[23] = t5;
+		$[24] = t6;
+	} else t6 = $[24];
+	return useQuery(t6);
+}
+/**
+* Hook for reindexing a collection
+*
+* @example
+* ```tsx
+* const { reindex } = useReindex();
+* await reindex("posts");
+* ```
+*/
+function _temp(prev) {
+	return prev;
 }
 /**
 * Hook for FTS-powered search across ALL collections
 *
-* Used by the global search (Cmd+K) to find records across the entire CMS.
+* Used by the global search (Cmd+K) to find records across the entire app.
 *
 * @example
 * ```tsx
@@ -115,33 +187,72 @@ function useSearch(options, queryOptions) {
 * ```
 */
 function useGlobalSearch(options, queryOptions) {
+	const $ = c(18);
 	const client = useAdminStore(selectClient);
 	const { locale: contentLocale } = useScopedLocale();
-	const { query, limit = 10, highlights = true, enabled } = options;
-	const isEnabled = enabled ?? query?.trim().length >= 2;
-	return useQuery({
-		queryKey: [
+	const { query, limit: t0, highlights: t1, enabled } = options;
+	const limit = t0 === void 0 ? 10 : t0;
+	const highlights = t1 === void 0 ? true : t1;
+	let t2;
+	if ($[0] !== enabled || $[1] !== query) {
+		t2 = enabled ?? query?.trim().length >= 2;
+		$[0] = enabled;
+		$[1] = query;
+		$[2] = t2;
+	} else t2 = $[2];
+	const isEnabled = t2;
+	let t3;
+	if ($[3] !== contentLocale || $[4] !== limit || $[5] !== query) {
+		t3 = [
 			"questpie",
 			"global-search",
 			query,
 			limit,
 			contentLocale
-		],
-		queryFn: async () => {
+		];
+		$[3] = contentLocale;
+		$[4] = limit;
+		$[5] = query;
+		$[6] = t3;
+	} else t3 = $[6];
+	let t4;
+	if ($[7] !== client || $[8] !== contentLocale || $[9] !== highlights || $[10] !== limit || $[11] !== query) {
+		t4 = async () => {
 			return await client.search.search({
 				query,
 				locale: contentLocale,
 				limit,
 				highlights
 			});
-		},
-		enabled: isEnabled,
-		placeholderData: (prev) => prev,
-		staleTime: 10 * 1e3,
-		...queryOptions
-	});
+		};
+		$[7] = client;
+		$[8] = contentLocale;
+		$[9] = highlights;
+		$[10] = limit;
+		$[11] = query;
+		$[12] = t4;
+	} else t4 = $[12];
+	let t5;
+	if ($[13] !== isEnabled || $[14] !== queryOptions || $[15] !== t3 || $[16] !== t4) {
+		t5 = {
+			queryKey: t3,
+			queryFn: t4,
+			enabled: isEnabled,
+			placeholderData: _temp2,
+			staleTime: 1e4,
+			...queryOptions
+		};
+		$[13] = isEnabled;
+		$[14] = queryOptions;
+		$[15] = t3;
+		$[16] = t4;
+		$[17] = t5;
+	} else t5 = $[17];
+	return useQuery(t5);
+}
+function _temp2(prev) {
+	return prev;
 }
 
 //#endregion
-export { useDebouncedValue, useGlobalSearch, useSearch };
-//# sourceMappingURL=use-search.mjs.map
+export { useDebouncedValue, useGlobalSearch, useSearch };

package/dist/client/hooks/use-server-actions.mjs

@@ -0,0 +1,191 @@
+"use client";
+
+import { selectAdmin, selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useCollectionSchema } from "./use-collection-schema.mjs";
+import { c } from "react/compiler-runtime";
+
+//#region src/client/hooks/use-server-actions.ts
+/**
+* useServerActions Hook
+*
+* Maps server-defined actions (from collection schema) to client ActionDefinitions.
+* Server actions have their handlers stripped during serialization; this hook
+* creates client-side wrappers that execute actions via the server API.
+*/
+function getActionErrorMessage(response) {
+	if (response.error) return response.error;
+	if (response.result?.toast?.message) return response.result.toast.message;
+	return "Action execution failed";
+}
+async function applyServerActionEffects(result, ctx) {
+	if (!result) return;
+	if (result.effects?.invalidate === true) await ctx.helpers.invalidateAll();
+	else if (Array.isArray(result.effects?.invalidate)) for (const col of result.effects.invalidate) await ctx.helpers.invalidateCollection(col);
+	if (result.effects?.redirect) ctx.helpers.navigate(result.effects.redirect);
+	if (result.type === "redirect" && result.url) ctx.helpers.navigate(result.url);
+}
+function buildServerFormFields(rawFields, fieldRegistry) {
+	if (!rawFields || !fieldRegistry) return {};
+	const result = {};
+	for (const [fieldName, fieldConfig] of Object.entries(rawFields)) {
+		const fc = fieldConfig;
+		if (fieldConfig && typeof fieldConfig === "object" && "name" in fieldConfig && "field" in fieldConfig && "~options" in fieldConfig) {
+			result[fieldName] = fieldConfig;
+			continue;
+		}
+		const fieldBuilder = fieldRegistry[typeof fc.type === "string" && fc.type.length > 0 ? fc.type : "text"] ?? fieldRegistry.text ?? null;
+		if (!fieldBuilder || typeof fieldBuilder.$options !== "function") continue;
+		const options = {
+			label: fc.label,
+			description: fc.description,
+			required: fc.required,
+			defaultValue: fc.default
+		};
+		if (fc.options && typeof fc.options === "object") Object.assign(options, fc.options);
+		result[fieldName] = fieldBuilder.$options(options);
+	}
+	return result;
+}
+/**
+* Map a server action definition (from collection schema) to a client ActionDefinition
+*/
+function mapServerAction(serverAction, collection, fieldRegistry, client) {
+	const action = {
+		id: serverAction.id,
+		label: serverAction.label,
+		icon: serverAction.icon,
+		variant: serverAction.variant,
+		scope: serverAction.scope,
+		handler: {
+			type: "server",
+			actionId: serverAction.id,
+			collection
+		}
+	};
+	if (serverAction.confirmation) action.confirmation = {
+		title: serverAction.confirmation.title ?? {
+			key: "common.confirm",
+			fallback: "Confirm"
+		},
+		description: serverAction.confirmation.description,
+		confirmLabel: serverAction.confirmation.confirmLabel,
+		cancelLabel: serverAction.confirmation.cancelLabel,
+		destructive: serverAction.confirmation.destructive
+	};
+	if (serverAction.form) {
+		const form = serverAction.form;
+		const fields = buildServerFormFields(form.fields, fieldRegistry);
+		action.handler = {
+			type: "form",
+			config: {
+				title: form.title,
+				description: form.description,
+				fields,
+				submitLabel: form.submitLabel,
+				cancelLabel: form.cancelLabel,
+				width: form.width,
+				onSubmit: async (data, ctx) => {
+					const routes = client?.routes;
+					if (!routes?.executeAction) throw new Error("executeAction route is not available");
+					const itemId = ctx.item && !Array.isArray(ctx.item) ? ctx.item.id : void 0;
+					const idsFromItems = Array.isArray(ctx.items) ? ctx.items.map((it) => it?.id).filter(Boolean) : [];
+					const idsFromItemArray = Array.isArray(ctx.item) ? ctx.item.map((it) => it?.id).filter(Boolean) : [];
+					const itemIds = idsFromItems.length > 0 ? idsFromItems : idsFromItemArray.length > 0 ? idsFromItemArray : void 0;
+					const response = await routes.executeAction({
+						collection,
+						actionId: serverAction.id,
+						itemId,
+						itemIds,
+						data
+					});
+					if (!response.success || response.result?.type === "error") throw new Error(getActionErrorMessage(response));
+					await applyServerActionEffects(response.result, ctx);
+				}
+			}
+		};
+	}
+	return action;
+}
+/**
+* Hook to fetch and map server-defined actions for a collection.
+* Reads actions from the collection schema endpoint (admin.actions).
+*
+* @example
+* ```tsx
+* const { serverActions } = useServerActions({ collection: "posts" });
+* // Merge with local actions in useActions hook
+* ```
+*/
+function useServerActions(t0) {
+	const $ = c(9);
+	const { collection } = t0;
+	const admin = useAdminStore(selectAdmin);
+	const client = useAdminStore(selectClient);
+	const { data: schema, isPending } = useCollectionSchema(collection);
+	schema?.admin?.actions;
+	let t1;
+	bb0: {
+		const actionsConfig = schema?.admin?.actions;
+		if (!actionsConfig?.custom?.length) {
+			let t2$2;
+			if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
+				t2$2 = [];
+				$[0] = t2$2;
+			} else t2$2 = $[0];
+			t1 = t2$2;
+			break bb0;
+		}
+		let t2$1;
+		if ($[1] !== actionsConfig.custom || $[2] !== admin || $[3] !== client || $[4] !== collection) {
+			const fieldRegistry = admin?.getFields?.() ?? null;
+			t2$1 = actionsConfig.custom.map((serverAction) => mapServerAction(serverAction, collection, fieldRegistry, client));
+			$[1] = actionsConfig.custom;
+			$[2] = admin;
+			$[3] = client;
+			$[4] = collection;
+			$[5] = t2$1;
+		} else t2$1 = $[5];
+		t1 = t2$1;
+	}
+	const serverActions = t1;
+	let t2;
+	if ($[6] !== isPending || $[7] !== serverActions) {
+		t2 = {
+			serverActions,
+			isLoading: isPending
+		};
+		$[6] = isPending;
+		$[7] = serverActions;
+		$[8] = t2;
+	} else t2 = $[8];
+	return t2;
+}
+/**
+* Merge server actions with local actions config.
+* Server actions are added to the appropriate section based on their scope.
+*/
+function mergeServerActions(localActions, serverActions) {
+	if (!serverActions.length) return localActions;
+	const headerActions = [...localActions.header?.primary ?? []];
+	const headerSecondary = [...localActions.header?.secondary ?? []];
+	const bulkActions = [...localActions.bulk ?? []];
+	for (const action of serverActions) switch (action.scope) {
+		case "bulk":
+			bulkActions.push(action);
+			break;
+		case "header":
+			headerActions.push(action);
+			break;
+		default: break;
+	}
+	return {
+		header: {
+			primary: headerActions,
+			secondary: headerSecondary
+		},
+		bulk: bulkActions
+	};
+}
+
+//#endregion
+export { mergeServerActions, useServerActions };