@questpie/admin 1.1.1 → 3.0.0

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

@@ -0,0 +1,258 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useScopedLocale } from "../runtime/locale-scope.mjs";
+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 app Search API.
+* Returns full records with search metadata (score, highlights, indexed title).
+*/
+/**
+* Hook to debounce a value
+*
+* @example
+* ```tsx
+* const [searchTerm, setSearchTerm] = useState("");
+* const debouncedSearch = useDebouncedValue(searchTerm, 300);
+* ```
+*/
+function useDebouncedValue(value, delay) {
+	const $ = c(4);
+	const [debouncedValue, setDebouncedValue] = useState(value);
+	let t0;
+	let t1;
+	if ($[0] !== delay || $[1] !== value) {
+		t0 = () => {
+			const timer = setTimeout(() => {
+				setDebouncedValue(value);
+			}, delay);
+			return () => {
+				clearTimeout(timer);
+			};
+		};
+		t1 = [value, delay];
+		$[0] = delay;
+		$[1] = value;
+		$[2] = t0;
+		$[3] = t1;
+	} else {
+		t0 = $[2];
+		t1 = $[3];
+	}
+	useEffect(t0, t1);
+	return debouncedValue;
+}
+/**
+* Hook for FTS-powered collection search
+*
+* Returns full records directly with search metadata attached.
+* No need for a second CRUD fetch - records are populated server-side.
+*
+* @example
+* ```tsx
+* const [searchTerm, setSearchTerm] = useState("");
+* const debouncedSearch = useDebouncedValue(searchTerm, 300);
+*
+* const { data, isLoading } = useSearch({
+*   collection: "posts",
+*   query: debouncedSearch,
+*   limit: 50,
+* });
+*
+* // Use docs directly - they're full records!
+* const items = data?.docs ?? [];
+*
+* // Access search metadata
+* items.forEach(item => {
+*   console.log(item.title); // Full record field
+*   console.log(item._search.score); // Search score
+*   console.log(item._search.highlights?.title); // Highlighted title
+* });
+* ```
+*/
+function useSearch(options, queryOptions) {
+	const $ = c(25);
+	const client = useAdminStore(selectClient);
+	const { locale: contentLocale } = useScopedLocale();
+	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,
+			query,
+			filters,
+			limit,
+			offset,
+			contentLocale
+		];
+		$[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],
+				locale: contentLocale,
+				limit,
+				offset,
+				filters,
+				highlights,
+				facets
+			});
+		};
+		$[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 app.
+*
+* @example
+* ```tsx
+* const [query, setQuery] = useState("");
+* const debouncedQuery = useDebouncedValue(query, 300);
+*
+* const { data, isLoading } = useGlobalSearch({
+*   query: debouncedQuery,
+*   limit: 10,
+* });
+*
+* // Show results grouped by collection
+* data?.docs.forEach(item => {
+*   console.log(`${item._collection}: ${item._search.indexedTitle}`);
+* });
+* ```
+*/
+function useGlobalSearch(options, queryOptions) {
+	const $ = c(18);
+	const client = useAdminStore(selectClient);
+	const { locale: contentLocale } = useScopedLocale();
+	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
+		];
+		$[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
+			});
+		};
+		$[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 };

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 };