@questpie/admin 1.1.1 → 2.0.0

package/dist/client/hooks/use-global-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-global-schema.mjs","names":[],"sources":["../../../src/client/hooks/use-global-schema.ts"],"sourcesContent":["/**\n * Hook for fetching global schema from the backend\n *\n * Returns introspection data including fields, access, and validation.\n */\n\nimport { type UseQueryOptions, useQuery } from \"@tanstack/react-query\";\nimport type { GlobalSchema, Questpie } from \"questpie\";\nimport type { RegisteredCMS, RegisteredGlobalNames } from \"../builder/registry\";\nimport { selectClient, useAdminStore } from \"../runtime\";\n\n// ==========================================================================\n// Type Helpers\n// ==========================================================================\n\n/**\n * Resolved global names (string if not registered)\n */\ntype ResolvedGlobalNames =\n  RegisteredCMS extends Questpie<any> ? RegisteredGlobalNames : string;\n\n// ==========================================================================\n// Hook\n// ==========================================================================\n\nexport function useGlobalSchema<K extends ResolvedGlobalNames>(\n  global: K,\n  queryOptions?: Omit<UseQueryOptions<GlobalSchema>, \"queryKey\" | \"queryFn\">,\n) {\n  const client = useAdminStore(selectClient);\n\n  return useQuery<GlobalSchema>({\n    queryKey: getGlobalSchemaQueryKey(global),\n    queryFn: async () => {\n      return (client as any).globals[global].schema();\n    },\n    staleTime: 5 * 60 * 1000,\n    gcTime: 30 * 60 * 1000,\n    ...queryOptions,\n  });\n}\n\nexport function getGlobalSchemaQueryKey(global: string) {\n  return [\"questpie\", \"globals\", global, \"schema\"] as const;\n}\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,gBACd,QACA,cACA;CACA,MAAM,SAAS,cAAc,aAAa;AAE1C,QAAO,SAAuB;EAC5B,UAAU,wBAAwB,OAAO;EACzC,SAAS,YAAY;AACnB,UAAQ,OAAe,QAAQ,QAAQ,QAAQ;;EAEjD,WAAW,MAAS;EACpB,QAAQ,OAAU;EAClB,GAAG;EACJ,CAAC;;AAGJ,SAAgB,wBAAwB,QAAgB;AACtD,QAAO;EAAC;EAAY;EAAW;EAAQ;EAAS"}

package/dist/client/hooks/use-global.d.mts

@@ -0,0 +1,40 @@
+import { RegisteredCMS, RegisteredGlobalNames } from "../builder/registry.mjs";
+import { UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+import { Questpie } from "questpie";
+
+//#region src/client/hooks/use-global.d.ts
+type GlobalRealtimeOptions = {
+  realtime?: boolean;
+};
+/**
+ * Resolved global names (string if not registered)
+ */
+type ResolvedGlobalNames = RegisteredCMS extends Questpie<any> ? RegisteredGlobalNames : string;
+/**
+ * Hook to fetch global settings
+ *
+ * Uses RegisteredCMS from module augmentation for automatic type inference.
+ *
+ * @example
+ * ```tsx
+ * // Types inferred from module augmentation!
+ * const { data } = useGlobal("siteSettings");
+ * ```
+ */
+declare function useGlobal<K extends ResolvedGlobalNames>(globalName: K, options?: any, queryOptions?: Omit<UseQueryOptions, "queryKey" | "queryFn">, realtimeOptions?: GlobalRealtimeOptions): any;
+/**
+ * Hook to update global settings
+ *
+ * Uses RegisteredCMS from module augmentation for automatic type inference.
+ *
+ * @example
+ * ```tsx
+ * // Types inferred from module augmentation!
+ * const { mutate } = useGlobalUpdate("siteSettings");
+ * mutate({ data: { siteName: "New Name" } });
+ * ```
+ */
+declare function useGlobalUpdate<K extends ResolvedGlobalNames>(globalName: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">): any;
+//#endregion
+export { useGlobal, useGlobalUpdate };
+//# sourceMappingURL=use-global.d.mts.map

package/dist/client/hooks/use-global.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-global.d.mts","names":[],"sources":["../../../src/client/hooks/use-global.ts"],"sourcesContent":[],"mappings":";;;;;KAiBK,qBAAA;;AAP2E,CAAA;AAOtD;;;KAiBrB,mBAAA,GACJ,aAAsC,SAAhB,QAAgB,CAAA,GAAA,CAAA,GAAA,qBAAA,GAAA,MAAA;;AAiBvC;;;;;;;AA0CA;;;AAEwB,iBA5CR,SA4CQ,CAAA,UA5CY,mBA4CZ,CAAA,CAAA,UAAA,EA3CX,CA2CW,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,YAAA,CAAA,EAzCR,IAyCQ,CAzCH,eAyCG,EAAA,UAAA,GAAA,SAAA,CAAA,EAAA,eAAA,CAAA,EAxCL,qBAwCK,CAAA,EAAA,GAAA;;;;;;;;;;;;;iBAFR,0BAA0B,iCAC7B,qBACM,KAAK"}

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

@@ -0,0 +1,74 @@
+import { selectClient, selectContentLocale, useAdminStore } from "../runtime/provider.mjs";
+import { createQuestpieQueryOptions } from "@questpie/tanstack-query";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-global.ts
+/**
+* Hook to fetch global settings
+*
+* Uses RegisteredCMS from module augmentation for automatic type inference.
+*
+* @example
+* ```tsx
+* // Types inferred from module augmentation!
+* const { data } = useGlobal("siteSettings");
+* ```
+*/
+function useGlobal(globalName, options, queryOptions, realtimeOptions) {
+	const client = useAdminStore(selectClient);
+	const contentLocale = useAdminStore(selectContentLocale);
+	const queryOpts = createQuestpieQueryOptions(client, {
+		keyPrefix: ["questpie", "globals"],
+		locale: contentLocale
+	});
+	const globalOptions = {
+		...options,
+		locale: contentLocale
+	};
+	return useQuery({
+		...queryOpts.globals[globalName].get(globalOptions, { realtime: realtimeOptions?.realtime }),
+		...queryOptions
+	});
+}
+/**
+* Hook to update global settings
+*
+* Uses RegisteredCMS from module augmentation for automatic type inference.
+*
+* @example
+* ```tsx
+* // Types inferred from module augmentation!
+* const { mutate } = useGlobalUpdate("siteSettings");
+* mutate({ data: { siteName: "New Name" } });
+* ```
+*/
+function useGlobalUpdate(globalName, mutationOptions) {
+	const client = useAdminStore(selectClient);
+	const contentLocale = useAdminStore(selectContentLocale);
+	const queryClient = useQueryClient();
+	const queryOpts = createQuestpieQueryOptions(client, {
+		keyPrefix: ["questpie", "globals"],
+		locale: contentLocale
+	});
+	const globalQueryKey = queryOpts.key([
+		"globals",
+		globalName,
+		"get",
+		contentLocale
+	]);
+	return useMutation({
+		...queryOpts.globals[globalName].update(),
+		onSuccess: (data, variables, context) => {
+			(mutationOptions?.onSuccess)?.(data, variables, context);
+		},
+		onSettled: (data, error, variables, context) => {
+			queryClient.invalidateQueries({ queryKey: globalQueryKey });
+			(mutationOptions?.onSettled)?.(data, error, variables, context);
+		},
+		...mutationOptions
+	});
+}
+
+//#endregion
+export { useGlobal, useGlobalUpdate };
+//# sourceMappingURL=use-global.mjs.map

package/dist/client/hooks/use-global.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-global.mjs","names":[],"sources":["../../../src/client/hooks/use-global.ts"],"sourcesContent":["import { createQuestpieQueryOptions } from \"@questpie/tanstack-query\";\nimport {\n\ttype UseMutationOptions,\n\ttype UseQueryOptions,\n\tuseMutation,\n\tuseQuery,\n\tuseQueryClient,\n} from \"@tanstack/react-query\";\nimport type { Questpie } from \"questpie\";\nimport type { QuestpieClient } from \"questpie/client\";\nimport type { RegisteredCMS, RegisteredGlobalNames } from \"../builder/registry\";\nimport {\n\tselectClient,\n\tselectContentLocale,\n\tuseAdminStore,\n} from \"../runtime\";\n\ntype GlobalRealtimeOptions = {\n\trealtime?: boolean;\n};\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Resolved CMS type (Questpie<any> if not registered)\n */\ntype ResolvedCMS =\n\tRegisteredCMS extends Questpie<any> ? RegisteredCMS : Questpie<any>;\n\n/**\n * Resolved global names (string if not registered)\n */\ntype ResolvedGlobalNames =\n\tRegisteredCMS extends Questpie<any> ? RegisteredGlobalNames : string;\n\n// ============================================================================\n// Global Hooks\n// ============================================================================\n\n/**\n * Hook to fetch global settings\n *\n * Uses RegisteredCMS from module augmentation for automatic type inference.\n *\n * @example\n * ```tsx\n * // Types inferred from module augmentation!\n * const { data } = useGlobal(\"siteSettings\");\n * ```\n */\nexport function useGlobal<K extends ResolvedGlobalNames>(\n\tglobalName: K,\n\toptions?: any,\n\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\trealtimeOptions?: GlobalRealtimeOptions,\n): any {\n\tconst client = useAdminStore(selectClient);\n\tconst contentLocale = useAdminStore(selectContentLocale);\n\tconst queryOpts = createQuestpieQueryOptions(client as any, {\n\t\tkeyPrefix: [\"questpie\", \"globals\"],\n\t\tlocale: contentLocale,\n\t});\n\n\tconst globalOptions = {\n\t\t...options,\n\t\tlocale: contentLocale,\n\t};\n\n\t// Pass realtime option to query options builder - this uses streamedQuery internally\n\tconst baseQuery = (queryOpts as any).globals[globalName as string].get(\n\t\tglobalOptions as any,\n\t\t{ realtime: realtimeOptions?.realtime },\n\t);\n\n\treturn useQuery({\n\t\t...baseQuery,\n\t\t...queryOptions,\n\t});\n}\n\n/**\n * Hook to update global settings\n *\n * Uses RegisteredCMS from module augmentation for automatic type inference.\n *\n * @example\n * ```tsx\n * // Types inferred from module augmentation!\n * const { mutate } = useGlobalUpdate(\"siteSettings\");\n * mutate({ data: { siteName: \"New Name\" } });\n * ```\n */\nexport function useGlobalUpdate<K extends ResolvedGlobalNames>(\n\tglobalName: K,\n\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n): any {\n\tconst client = useAdminStore(selectClient);\n\tconst contentLocale = useAdminStore(selectContentLocale);\n\tconst queryClient = useQueryClient();\n\tconst queryOpts = createQuestpieQueryOptions(client as any, {\n\t\tkeyPrefix: [\"questpie\", \"globals\"],\n\t\tlocale: contentLocale,\n\t});\n\n\tconst globalQueryKey = queryOpts.key([\n\t\t\"globals\",\n\t\tglobalName as string,\n\t\t\"get\",\n\t\tcontentLocale,\n\t]);\n\n\treturn useMutation({\n\t\t...(queryOpts as any).globals[globalName as string].update(),\n\t\tonSuccess: (data: any, variables: any, context: any) => {\n\t\t\t(mutationOptions?.onSuccess as any)?.(data, variables, context);\n\t\t},\n\t\tonSettled: (data: any, error: any, variables: any, context: any) => {\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: globalQueryKey,\n\t\t\t});\n\t\t\t(mutationOptions?.onSettled as any)?.(data, error, variables, context);\n\t\t},\n\t\t...mutationOptions,\n\t} as any);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAoDA,SAAgB,UACf,YACA,SACA,cACA,iBACM;CACN,MAAM,SAAS,cAAc,aAAa;CAC1C,MAAM,gBAAgB,cAAc,oBAAoB;CACxD,MAAM,YAAY,2BAA2B,QAAe;EAC3D,WAAW,CAAC,YAAY,UAAU;EAClC,QAAQ;EACR,CAAC;CAEF,MAAM,gBAAgB;EACrB,GAAG;EACH,QAAQ;EACR;AAQD,QAAO,SAAS;EACf,GANkB,UAAkB,QAAQ,YAAsB,IAClE,eACA,EAAE,UAAU,iBAAiB,UAAU,CACvC;EAIA,GAAG;EACH,CAAC;;;;;;;;;;;;;;AAeH,SAAgB,gBACf,YACA,iBACM;CACN,MAAM,SAAS,cAAc,aAAa;CAC1C,MAAM,gBAAgB,cAAc,oBAAoB;CACxD,MAAM,cAAc,gBAAgB;CACpC,MAAM,YAAY,2BAA2B,QAAe;EAC3D,WAAW,CAAC,YAAY,UAAU;EAClC,QAAQ;EACR,CAAC;CAEF,MAAM,iBAAiB,UAAU,IAAI;EACpC;EACA;EACA;EACA;EACA,CAAC;AAEF,QAAO,YAAY;EAClB,GAAI,UAAkB,QAAQ,YAAsB,QAAQ;EAC5D,YAAY,MAAW,WAAgB,YAAiB;AACvD,IAAC,iBAAiB,aAAoB,MAAM,WAAW,QAAQ;;EAEhE,YAAY,MAAW,OAAY,WAAgB,YAAiB;AACnE,eAAY,kBAAkB,EAC7B,UAAU,gBACV,CAAC;AACF,IAAC,iBAAiB,aAAoB,MAAM,OAAO,WAAW,QAAQ;;EAEvE,GAAG;EACH,CAAQ"}

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

@@ -0,0 +1,245 @@
+import { useCurrentUser } from "./use-current-user.mjs";
+import { useQuestpieQueryOptions } from "./use-questpie-query-options.mjs";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useCallback, useEffect, useRef } from "react";
+
+//#region src/client/hooks/use-locks.ts
+/**
+* Hooks for document locking (collaborative editing awareness)
+*
+* Provides realtime tracking of who is editing which documents.
+* Used in table view to show lock indicators and in form view to manage locks.
+*/
+/**
+* Default lock duration in milliseconds (60 seconds)
+* Lock expires if not refreshed within this time.
+* Form should call refresh() on user activity (typing, clicking).
+*/
+const LOCK_DURATION_MS = 6e4;
+/** Helper to get user info from lock (handles both expanded and non-expanded) */
+function getLockUser(lock) {
+	if (typeof lock.user === "string") return null;
+	return lock.user;
+}
+/** Helper to get user ID from lock */
+function getLockUserId(lock) {
+	if (typeof lock.user === "string") return lock.user;
+	return lock.user.id;
+}
+/**
+* Generate a unique session ID for this browser tab.
+* Persisted in sessionStorage so it survives page refreshes but not tab close.
+*/
+function getSessionId() {
+	if (typeof window === "undefined") return "server";
+	const key = "__questpie_lock_session_id__";
+	let sessionId = sessionStorage.getItem(key);
+	if (!sessionId) {
+		sessionId = crypto.randomUUID();
+		sessionStorage.setItem(key, sessionId);
+	}
+	return sessionId;
+}
+/**
+* Track all active locks for a collection/global.
+*
+* Used in table views to show who is editing which rows.
+*
+* @example
+* ```tsx
+* const { locks, isLocked, getLock } = useLocks({
+*   resourceType: "collection",
+*   resource: "posts",
+*   realtime: true,
+* });
+*
+* // In table row
+* {isLocked(row.id) && (
+*   <LockIndicator user={getLock(row.id)?.userName} />
+* )}
+* ```
+*/
+function useLocks(options) {
+	const { resourceType, resource, realtime = true } = options;
+	const { queryOpts } = useQuestpieQueryOptions();
+	const currentUser = useCurrentUser();
+	const { data: rawData, isLoading } = useQuery({ ...queryOpts.collections.adminLocks.find({
+		where: {
+			resourceType,
+			resource,
+			expiresAt: { gt: /* @__PURE__ */ new Date() }
+		},
+		with: { user: true }
+	}, { realtime }) });
+	const data = rawData;
+	const locks = /* @__PURE__ */ new Map();
+	if (data?.docs) for (const lock of data.docs) locks.set(lock.resourceId, lock);
+	return {
+		locks,
+		isLocked: useCallback((resourceId) => locks.has(resourceId), [locks]),
+		getLock: useCallback((resourceId) => locks.get(resourceId), [locks]),
+		isOwnLock: useCallback((resourceId) => {
+			const lock = locks.get(resourceId);
+			if (!lock) return false;
+			return getLockUserId(lock) === currentUser?.id;
+		}, [locks, currentUser?.id]),
+		isLoading
+	};
+}
+/**
+* Manage a document lock for editing.
+*
+* Automatically acquires lock on mount, sends heartbeats, and releases on unmount.
+*
+* @example
+* ```tsx
+* function EditForm({ collection, id }) {
+*   const { isLocked, isBlocked, blockedBy } = useLock({
+*     resourceType: "collection",
+*     resource: collection,
+*     resourceId: id,
+*   });
+*
+*   if (isBlocked) {
+*     return <LockedBanner user={blockedBy?.userName} />;
+*   }
+*
+*   return <Form disabled={!isLocked} />;
+* }
+* ```
+*/
+function useLock(options) {
+	const { resourceType, resource, resourceId, autoAcquire = true, onAcquired, onBlocked, onReleased } = options;
+	const { queryOpts } = useQuestpieQueryOptions();
+	const queryClient = useQueryClient();
+	const currentUser = useCurrentUser();
+	const lockIdRef = useRef(null);
+	const { data: rawExistingLockData, isLoading: isCheckingLock } = useQuery({
+		...queryOpts.collections.adminLocks.find({
+			where: {
+				resourceType,
+				resource,
+				resourceId,
+				expiresAt: { gt: /* @__PURE__ */ new Date() }
+			},
+			with: { user: true },
+			limit: 1
+		}),
+		enabled: !!resourceId
+	});
+	const existingLock = rawExistingLockData?.docs?.[0] ?? null;
+	const sessionId = getSessionId();
+	const isOwnSession = existingLock?.sessionId === sessionId;
+	const isOwnUser = existingLock ? getLockUserId(existingLock) === currentUser?.id : false;
+	const blockedBy = existingLock && !isOwnUser ? existingLock : null;
+	const ownLockElsewhere = existingLock && isOwnUser && !isOwnSession;
+	const createMutation = useMutation({
+		mutationFn: async () => {
+			if (!currentUser) throw new Error("Not authenticated");
+			const expiresAt = new Date(Date.now() + LOCK_DURATION_MS);
+			return await queryOpts.collections.adminLocks.create({
+				resourceType,
+				resource,
+				resourceId,
+				user: currentUser.id,
+				sessionId,
+				expiresAt
+			});
+		},
+		onSuccess: (lock) => {
+			lockIdRef.current = lock.id;
+			onAcquired?.(lock);
+			queryClient.invalidateQueries({ queryKey: ["collections", "adminLocks"] });
+		}
+	});
+	const updateMutation = useMutation({ mutationFn: async () => {
+		if (!lockIdRef.current) return;
+		const expiresAt = new Date(Date.now() + LOCK_DURATION_MS);
+		await queryOpts.collections.adminLocks.update({
+			id: lockIdRef.current,
+			data: { expiresAt }
+		});
+	} });
+	const deleteMutation = useMutation({
+		mutationFn: async () => {
+			if (!lockIdRef.current) return;
+			await queryOpts.collections.adminLocks.delete({ id: lockIdRef.current });
+		},
+		onSuccess: () => {
+			lockIdRef.current = null;
+			onReleased?.();
+			queryClient.invalidateQueries({ queryKey: ["collections", "adminLocks"] });
+		}
+	});
+	const acquire = useCallback(async () => {
+		if (existingLock && !isOwnUser) {
+			onBlocked?.(existingLock);
+			return null;
+		}
+		if (isOwnSession && existingLock) {
+			lockIdRef.current = existingLock.id;
+			return existingLock;
+		}
+		try {
+			return await createMutation.mutateAsync();
+		} catch (error) {
+			console.error("Failed to acquire lock:", error);
+			return null;
+		}
+	}, [
+		existingLock,
+		isOwnUser,
+		isOwnSession,
+		createMutation,
+		onBlocked
+	]);
+	const release = useCallback(async () => {
+		if (lockIdRef.current) try {
+			await deleteMutation.mutateAsync();
+		} catch (error) {
+			console.error("Failed to release lock:", error);
+		}
+	}, [deleteMutation]);
+	const refresh = useCallback(async () => {
+		if (lockIdRef.current) try {
+			await updateMutation.mutateAsync();
+		} catch (error) {
+			console.error("Failed to refresh lock:", error);
+		}
+	}, [updateMutation]);
+	useEffect(() => {
+		if (!autoAcquire || !resourceId || !currentUser || isCheckingLock) return;
+		if (existingLock !== void 0) if (blockedBy) onBlocked?.(blockedBy);
+		else acquire();
+	}, [
+		autoAcquire,
+		resourceId,
+		currentUser,
+		isCheckingLock,
+		existingLock,
+		blockedBy,
+		acquire,
+		onBlocked
+	]);
+	useEffect(() => {
+		const mutate = deleteMutation.mutate;
+		return () => {
+			if (lockIdRef.current) mutate();
+		};
+	}, [deleteMutation.mutate]);
+	return {
+		lock: isOwnSession ? existingLock : null,
+		blockedBy,
+		isLocked: isOwnSession && !!existingLock,
+		isBlocked: !!blockedBy,
+		isOpenElsewhere: !!ownLockElsewhere,
+		isPending: isCheckingLock || createMutation.isPending || updateMutation.isPending || deleteMutation.isPending,
+		acquire,
+		release,
+		refresh
+	};
+}
+
+//#endregion
+export { getLockUser, useLock, useLocks };
+//# sourceMappingURL=use-locks.mjs.map

package/dist/client/hooks/use-locks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-locks.mjs","names":[],"sources":["../../../src/client/hooks/use-locks.ts"],"sourcesContent":["/**\n * Hooks for document locking (collaborative editing awareness)\n *\n * Provides realtime tracking of who is editing which documents.\n * Used in table view to show lock indicators and in form view to manage locks.\n */\n\nimport {\n\ttype UseMutationOptions,\n\tuseMutation,\n\tuseQuery,\n\tuseQueryClient,\n} from \"@tanstack/react-query\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { useCurrentUser } from \"./use-current-user\";\nimport { useQuestpieQueryOptions } from \"./use-questpie-query-options\";\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * Default lock duration in milliseconds (60 seconds)\n * Lock expires if not refreshed within this time.\n * Form should call refresh() on user activity (typing, clicking).\n */\nexport const LOCK_DURATION_MS = 60_000;\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface LockUser {\n\tid: string;\n\tname?: string | null;\n\temail: string;\n\timage?: string | null;\n}\n\nexport interface LockInfo {\n\tid: string;\n\tresourceType: \"collection\" | \"global\";\n\tresource: string;\n\tresourceId: string;\n\tuser: LockUser | string;\n\tsessionId: string;\n\texpiresAt: Date | string;\n\tcreatedAt?: Date | string;\n\tupdatedAt?: Date | string;\n}\n\n/** Helper to get user info from lock (handles both expanded and non-expanded) */\nexport function getLockUser(lock: LockInfo): LockUser | null {\n\tif (typeof lock.user === \"string\") return null;\n\treturn lock.user;\n}\n\n/** Helper to get user ID from lock */\nexport function getLockUserId(lock: LockInfo): string {\n\tif (typeof lock.user === \"string\") return lock.user;\n\treturn lock.user.id;\n}\n\n/**\n * Generate a unique session ID for this browser tab.\n * Persisted in sessionStorage so it survives page refreshes but not tab close.\n */\nfunction getSessionId(): string {\n\tif (typeof window === \"undefined\") return \"server\";\n\n\tconst key = \"__questpie_lock_session_id__\";\n\tlet sessionId = sessionStorage.getItem(key);\n\n\tif (!sessionId) {\n\t\tsessionId = crypto.randomUUID();\n\t\tsessionStorage.setItem(key, sessionId);\n\t}\n\n\treturn sessionId;\n}\n\nexport interface UseLockOptions {\n\t/** Resource type: collection or global */\n\tresourceType: \"collection\" | \"global\";\n\t/** Resource name (collection slug or global slug) */\n\tresource: string;\n\t/** Document ID to lock */\n\tresourceId: string;\n\t/** Whether to auto-acquire lock on mount (default: true) */\n\tautoAcquire?: boolean;\n\t/** Callback when lock is acquired */\n\tonAcquired?: (lock: LockInfo) => void;\n\t/** Callback when lock acquisition fails (someone else has it) */\n\tonBlocked?: (lock: LockInfo) => void;\n\t/** Callback when lock is released */\n\tonReleased?: () => void;\n}\n\nexport interface UseLockResult {\n\t/** Current lock info if we have the lock */\n\tlock: LockInfo | null;\n\t/** Lock info if someone else has the lock */\n\tblockedBy: LockInfo | null;\n\t/** Whether we currently hold the lock */\n\tisLocked: boolean;\n\t/** Whether someone else holds the lock */\n\tisBlocked: boolean;\n\t/** Whether same user has it open in another tab */\n\tisOpenElsewhere: boolean;\n\t/** Whether lock operations are in progress */\n\tisPending: boolean;\n\t/** Acquire the lock manually */\n\tacquire: () => Promise<LockInfo | null>;\n\t/** Release the lock manually */\n\trelease: () => Promise<void>;\n\t/** Refresh the lock (extend expiration) */\n\trefresh: () => Promise<void>;\n}\n\nexport interface UseLocksOptions {\n\t/** Resource type: collection or global */\n\tresourceType: \"collection\" | \"global\";\n\t/** Resource name (collection slug or global slug) */\n\tresource: string;\n\t/** Whether realtime updates are enabled */\n\trealtime?: boolean;\n}\n\nexport interface UseLocksResult {\n\t/** Map of resourceId -> lock info */\n\tlocks: Map<string, LockInfo>;\n\t/** Check if a specific resource is locked */\n\tisLocked: (resourceId: string) => boolean;\n\t/** Get lock info for a specific resource */\n\tgetLock: (resourceId: string) => LockInfo | undefined;\n\t/** Check if current user owns the lock */\n\tisOwnLock: (resourceId: string) => boolean;\n\t/** Whether data is loading */\n\tisLoading: boolean;\n}\n\n// ============================================================================\n// useLocks - Track all locks for a resource (for table view)\n// ============================================================================\n\n/**\n * Track all active locks for a collection/global.\n *\n * Used in table views to show who is editing which rows.\n *\n * @example\n * ```tsx\n * const { locks, isLocked, getLock } = useLocks({\n *   resourceType: \"collection\",\n *   resource: \"posts\",\n *   realtime: true,\n * });\n *\n * // In table row\n * {isLocked(row.id) && (\n *   <LockIndicator user={getLock(row.id)?.userName} />\n * )}\n * ```\n */\nexport function useLocks(options: UseLocksOptions): UseLocksResult {\n\tconst { resourceType, resource, realtime = true } = options;\n\tconst { queryOpts } = useQuestpieQueryOptions();\n\tconst currentUser = useCurrentUser();\n\n\t// Query active locks for this resource (with user data expanded)\n\tconst { data: rawData, isLoading } = useQuery({\n\t\t...(queryOpts as any).collections.adminLocks.find(\n\t\t\t{\n\t\t\t\twhere: {\n\t\t\t\t\tresourceType,\n\t\t\t\t\tresource,\n\t\t\t\t\t// Only get non-expired locks\n\t\t\t\t\texpiresAt: { gt: new Date() },\n\t\t\t\t},\n\t\t\t\twith: { user: true },\n\t\t\t},\n\t\t\t{ realtime },\n\t\t),\n\t});\n\n\tconst data = rawData as { docs?: LockInfo[] } | undefined;\n\n\t// Build lock map\n\tconst locks = new Map<string, LockInfo>();\n\tif (data?.docs) {\n\t\tfor (const lock of data.docs) {\n\t\t\tlocks.set(lock.resourceId, lock);\n\t\t}\n\t}\n\n\tconst isLocked = useCallback(\n\t\t(resourceId: string) => locks.has(resourceId),\n\t\t[locks],\n\t);\n\n\tconst getLock = useCallback(\n\t\t(resourceId: string) => locks.get(resourceId),\n\t\t[locks],\n\t);\n\n\tconst isOwnLock = useCallback(\n\t\t(resourceId: string) => {\n\t\t\tconst lock = locks.get(resourceId);\n\t\t\tif (!lock) return false;\n\t\t\treturn getLockUserId(lock) === currentUser?.id;\n\t\t},\n\t\t[locks, currentUser?.id],\n\t);\n\n\treturn {\n\t\tlocks,\n\t\tisLocked,\n\t\tgetLock,\n\t\tisOwnLock,\n\t\tisLoading,\n\t};\n}\n\n// ============================================================================\n// useLock - Manage a single document lock (for form view)\n// ============================================================================\n\n/**\n * Manage a document lock for editing.\n *\n * Automatically acquires lock on mount, sends heartbeats, and releases on unmount.\n *\n * @example\n * ```tsx\n * function EditForm({ collection, id }) {\n *   const { isLocked, isBlocked, blockedBy } = useLock({\n *     resourceType: \"collection\",\n *     resource: collection,\n *     resourceId: id,\n *   });\n *\n *   if (isBlocked) {\n *     return <LockedBanner user={blockedBy?.userName} />;\n *   }\n *\n *   return <Form disabled={!isLocked} />;\n * }\n * ```\n */\nexport function useLock(options: UseLockOptions): UseLockResult {\n\tconst {\n\t\tresourceType,\n\t\tresource,\n\t\tresourceId,\n\t\tautoAcquire = true,\n\t\tonAcquired,\n\t\tonBlocked,\n\t\tonReleased,\n\t} = options;\n\n\tconst { queryOpts } = useQuestpieQueryOptions();\n\tconst queryClient = useQueryClient();\n\tconst currentUser = useCurrentUser();\n\n\tconst lockIdRef = useRef<string | null>(null);\n\n\t// Query existing lock for this resource (with user data expanded)\n\tconst { data: rawExistingLockData, isLoading: isCheckingLock } = useQuery({\n\t\t...(queryOpts as any).collections.adminLocks.find({\n\t\t\twhere: {\n\t\t\t\tresourceType,\n\t\t\t\tresource,\n\t\t\t\tresourceId,\n\t\t\t\texpiresAt: { gt: new Date() },\n\t\t\t},\n\t\t\twith: { user: true },\n\t\t\tlimit: 1,\n\t\t}),\n\t\tenabled: !!resourceId,\n\t});\n\n\tconst existingLockData = rawExistingLockData as\n\t\t| { docs?: LockInfo[] }\n\t\t| undefined;\n\tconst existingLock = existingLockData?.docs?.[0] ?? null;\n\n\t// Lock is \"own\" only if it's from this exact browser tab (same sessionId)\n\tconst sessionId = getSessionId();\n\tconst isOwnSession = existingLock?.sessionId === sessionId;\n\tconst isOwnUser = existingLock\n\t\t? getLockUserId(existingLock) === currentUser?.id\n\t\t: false;\n\n\t// For UI: show as blocked only if different user has the lock\n\t// Same user in different tab can see they have it open elsewhere\n\tconst blockedBy = existingLock && !isOwnUser ? existingLock : null;\n\tconst ownLockElsewhere = existingLock && isOwnUser && !isOwnSession;\n\n\t// Create lock mutation\n\tconst createMutation = useMutation({\n\t\tmutationFn: async () => {\n\t\t\tif (!currentUser) throw new Error(\"Not authenticated\");\n\n\t\t\tconst expiresAt = new Date(Date.now() + LOCK_DURATION_MS);\n\n\t\t\tconst result = await (queryOpts as any).collections.adminLocks.create({\n\t\t\t\tresourceType,\n\t\t\t\tresource,\n\t\t\t\tresourceId,\n\t\t\t\tuser: currentUser.id,\n\t\t\t\tsessionId,\n\t\t\t\texpiresAt,\n\t\t\t});\n\n\t\t\treturn result as LockInfo;\n\t\t},\n\t\tonSuccess: (lock) => {\n\t\t\tlockIdRef.current = lock.id;\n\t\t\tonAcquired?.(lock);\n\n\t\t\t// Invalidate locks query\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: [\"collections\", \"adminLocks\"],\n\t\t\t});\n\t\t},\n\t});\n\n\t// Update lock mutation (for heartbeat)\n\tconst updateMutation = useMutation({\n\t\tmutationFn: async () => {\n\t\t\tif (!lockIdRef.current) return;\n\n\t\t\tconst expiresAt = new Date(Date.now() + LOCK_DURATION_MS);\n\n\t\t\tawait (queryOpts as any).collections.adminLocks.update({\n\t\t\t\tid: lockIdRef.current,\n\t\t\t\tdata: { expiresAt },\n\t\t\t});\n\t\t},\n\t});\n\n\t// Delete lock mutation\n\tconst deleteMutation = useMutation({\n\t\tmutationFn: async () => {\n\t\t\tif (!lockIdRef.current) return;\n\n\t\t\tawait (queryOpts as any).collections.adminLocks.delete({\n\t\t\t\tid: lockIdRef.current,\n\t\t\t});\n\t\t},\n\t\tonSuccess: () => {\n\t\t\tlockIdRef.current = null;\n\t\t\tonReleased?.();\n\n\t\t\t// Invalidate locks query\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: [\"collections\", \"adminLocks\"],\n\t\t\t});\n\t\t},\n\t});\n\n\t// Acquire lock\n\tconst acquire = useCallback(async () => {\n\t\t// Check if already locked by someone else (different user)\n\t\tif (existingLock && !isOwnUser) {\n\t\t\tonBlocked?.(existingLock);\n\t\t\treturn null;\n\t\t}\n\n\t\t// If we already have the lock in this session, just use it\n\t\tif (isOwnSession && existingLock) {\n\t\t\tlockIdRef.current = existingLock.id;\n\t\t\treturn existingLock;\n\t\t}\n\n\t\t// Same user but different tab - they can open, but need own lock\n\t\t// Or no existing lock - acquire new one\n\t\ttry {\n\t\t\tconst lock = await createMutation.mutateAsync();\n\t\t\treturn lock;\n\t\t} catch (error) {\n\t\t\tconsole.error(\"Failed to acquire lock:\", error);\n\t\t\treturn null;\n\t\t}\n\t}, [existingLock, isOwnUser, isOwnSession, createMutation, onBlocked]);\n\n\t// Release lock\n\tconst release = useCallback(async () => {\n\t\tif (lockIdRef.current) {\n\t\t\ttry {\n\t\t\t\tawait deleteMutation.mutateAsync();\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"Failed to release lock:\", error);\n\t\t\t}\n\t\t}\n\t}, [deleteMutation]);\n\n\t// Refresh lock (extend expiration)\n\tconst refresh = useCallback(async () => {\n\t\tif (lockIdRef.current) {\n\t\t\ttry {\n\t\t\t\tawait updateMutation.mutateAsync();\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"Failed to refresh lock:\", error);\n\t\t\t}\n\t\t}\n\t}, [updateMutation]);\n\n\t// Auto-acquire on mount\n\tuseEffect(() => {\n\t\tif (!autoAcquire || !resourceId || !currentUser || isCheckingLock) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Wait for existing lock check to complete\n\t\tif (existingLock !== undefined) {\n\t\t\tif (blockedBy) {\n\t\t\t\tonBlocked?.(blockedBy);\n\t\t\t} else {\n\t\t\t\tacquire();\n\t\t\t}\n\t\t}\n\t}, [\n\t\tautoAcquire,\n\t\tresourceId,\n\t\tcurrentUser,\n\t\tisCheckingLock,\n\t\texistingLock,\n\t\tblockedBy,\n\t\tacquire,\n\t\tonBlocked,\n\t]);\n\n\t// No automatic heartbeat - form will call refresh() on user activity\n\n\t// Release on unmount\n\tuseEffect(() => {\n\t\tconst mutate = deleteMutation.mutate;\n\t\treturn () => {\n\t\t\tif (lockIdRef.current) {\n\t\t\t\t// Fire and forget - component is unmounting\n\t\t\t\tmutate();\n\t\t\t}\n\t\t};\n\t}, [deleteMutation.mutate]);\n\n\treturn {\n\t\t// Lock info if we own it in this session\n\t\tlock: isOwnSession ? existingLock : null,\n\t\t// Who is blocking us (different user)\n\t\tblockedBy,\n\t\t// True if we have the lock in this session\n\t\tisLocked: isOwnSession && !!existingLock,\n\t\t// True if different user has the lock\n\t\tisBlocked: !!blockedBy,\n\t\t// True if same user has it open in another tab\n\t\tisOpenElsewhere: !!ownLockElsewhere,\n\t\tisPending:\n\t\t\tisCheckingLock ||\n\t\t\tcreateMutation.isPending ||\n\t\t\tupdateMutation.isPending ||\n\t\t\tdeleteMutation.isPending,\n\t\tacquire,\n\t\trelease,\n\t\trefresh,\n\t};\n}\n"],"mappings":"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"}

package/dist/client/hooks/use-media-query.d.mts

@@ -0,0 +1,23 @@
+//#region src/client/hooks/use-media-query.d.ts
+/**
+ * Hook to detect media query matches
+ *
+ * @example
+ * ```tsx
+ * const isMobile = useMediaQuery("(max-width: 768px)");
+ * const isDesktop = useMediaQuery("(min-width: 769px)");
+ * const prefersDark = useMediaQuery("(prefers-color-scheme: dark)");
+ * ```
+ */
+declare function useMediaQuery(query: string): boolean;
+/**
+ * Hook to check if viewport is mobile (below md breakpoint)
+ */
+declare function useIsMobile(): boolean;
+/**
+ * Hook to check if viewport is desktop (md breakpoint and above)
+ */
+declare function useIsDesktop(): boolean;
+//#endregion
+export { useIsDesktop, useIsMobile, useMediaQuery };
+//# sourceMappingURL=use-media-query.d.mts.map

package/dist/client/hooks/use-media-query.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.d.mts","names":[],"sources":["../../../src/client/hooks/use-media-query.ts"],"sourcesContent":[],"mappings":";;AAcA;AA2DA;AAOA;;;;;;;iBAlEgB,aAAA;;;;iBA2DA,WAAA,CAAA;;;;iBAOA,YAAA,CAAA"}

package/dist/client/hooks/use-media-query.mjs

@@ -0,0 +1,62 @@
+"use client";
+
+import * as React$1 from "react";
+
+//#region src/client/hooks/use-media-query.ts
+/**
+* Hook to detect media query matches
+*
+* @example
+* ```tsx
+* const isMobile = useMediaQuery("(max-width: 768px)");
+* const isDesktop = useMediaQuery("(min-width: 769px)");
+* const prefersDark = useMediaQuery("(prefers-color-scheme: dark)");
+* ```
+*/
+function useMediaQuery(query) {
+	const [matches, setMatches] = React$1.useState(() => {
+		if (typeof window === "undefined") return false;
+		return window.matchMedia(query).matches;
+	});
+	React$1.useEffect(() => {
+		if (typeof window === "undefined") return;
+		const mediaQuery = window.matchMedia(query);
+		setMatches(mediaQuery.matches);
+		const listener = (event) => {
+			setMatches(event.matches);
+		};
+		if (mediaQuery.addEventListener) mediaQuery.addEventListener("change", listener);
+		else mediaQuery.addListener(listener);
+		return () => {
+			if (mediaQuery.removeEventListener) mediaQuery.removeEventListener("change", listener);
+			else mediaQuery.removeListener(listener);
+		};
+	}, [query]);
+	return matches;
+}
+/**
+* Predefined breakpoints matching Tailwind CSS defaults
+*/
+const breakpoints = {
+	sm: "(min-width: 640px)",
+	md: "(min-width: 768px)",
+	lg: "(min-width: 1024px)",
+	xl: "(min-width: 1280px)",
+	"2xl": "(min-width: 1536px)"
+};
+/**
+* Hook to check if viewport is mobile (below md breakpoint)
+*/
+function useIsMobile() {
+	return !useMediaQuery(breakpoints.md);
+}
+/**
+* Hook to check if viewport is desktop (md breakpoint and above)
+*/
+function useIsDesktop() {
+	return useMediaQuery(breakpoints.md);
+}
+
+//#endregion
+export { useIsDesktop, useIsMobile, useMediaQuery };
+//# sourceMappingURL=use-media-query.mjs.map

package/dist/client/hooks/use-media-query.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.mjs","names":["React"],"sources":["../../../src/client/hooks/use-media-query.ts"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\n\n/**\n * Hook to detect media query matches\n *\n * @example\n * ```tsx\n * const isMobile = useMediaQuery(\"(max-width: 768px)\");\n * const isDesktop = useMediaQuery(\"(min-width: 769px)\");\n * const prefersDark = useMediaQuery(\"(prefers-color-scheme: dark)\");\n * ```\n */\nexport function useMediaQuery(query: string): boolean {\n  const [matches, setMatches] = React.useState<boolean>(() => {\n    // Check if we're on the server\n    if (typeof window === \"undefined\") {\n      return false;\n    }\n    return window.matchMedia(query).matches;\n  });\n\n  React.useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return;\n    }\n\n    const mediaQuery = window.matchMedia(query);\n\n    // Set initial value\n    setMatches(mediaQuery.matches);\n\n    // Create listener\n    const listener = (event: MediaQueryListEvent) => {\n      setMatches(event.matches);\n    };\n\n    // Add listener (using modern API with fallback)\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener(\"change\", listener);\n    } else {\n      // Fallback for older browsers\n      mediaQuery.addListener(listener);\n    }\n\n    // Cleanup\n    return () => {\n      if (mediaQuery.removeEventListener) {\n        mediaQuery.removeEventListener(\"change\", listener);\n      } else {\n        mediaQuery.removeListener(listener);\n      }\n    };\n  }, [query]);\n\n  return matches;\n}\n\n/**\n * Predefined breakpoints matching Tailwind CSS defaults\n */\nexport const breakpoints = {\n  sm: \"(min-width: 640px)\",\n  md: \"(min-width: 768px)\",\n  lg: \"(min-width: 1024px)\",\n  xl: \"(min-width: 1280px)\",\n  \"2xl\": \"(min-width: 1536px)\",\n} as const;\n\n/**\n * Hook to check if viewport is mobile (below md breakpoint)\n */\nexport function useIsMobile(): boolean {\n  return !useMediaQuery(breakpoints.md);\n}\n\n/**\n * Hook to check if viewport is desktop (md breakpoint and above)\n */\nexport function useIsDesktop(): boolean {\n  return useMediaQuery(breakpoints.md);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,cAAc,OAAwB;CACpD,MAAM,CAAC,SAAS,cAAcA,QAAM,eAAwB;AAE1D,MAAI,OAAO,WAAW,YACpB,QAAO;AAET,SAAO,OAAO,WAAW,MAAM,CAAC;GAChC;AAEF,SAAM,gBAAgB;AACpB,MAAI,OAAO,WAAW,YACpB;EAGF,MAAM,aAAa,OAAO,WAAW,MAAM;AAG3C,aAAW,WAAW,QAAQ;EAG9B,MAAM,YAAY,UAA+B;AAC/C,cAAW,MAAM,QAAQ;;AAI3B,MAAI,WAAW,iBACb,YAAW,iBAAiB,UAAU,SAAS;MAG/C,YAAW,YAAY,SAAS;AAIlC,eAAa;AACX,OAAI,WAAW,oBACb,YAAW,oBAAoB,UAAU,SAAS;OAElD,YAAW,eAAe,SAAS;;IAGtC,CAAC,MAAM,CAAC;AAEX,QAAO;;;;;AAMT,MAAa,cAAc;CACzB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,OAAO;CACR;;;;AAKD,SAAgB,cAAuB;AACrC,QAAO,CAAC,cAAc,YAAY,GAAG;;;;;AAMvC,SAAgB,eAAwB;AACtC,QAAO,cAAc,YAAY,GAAG"}

package/dist/client/hooks/use-prefill-params.mjs

@@ -0,0 +1,47 @@
+import "react";
+
+//#region src/client/hooks/use-prefill-params.ts
+/**
+* Parse prefill parameters from a URLSearchParams object
+*/
+function parsePrefillParams(searchParams) {
+	const prefill = {};
+	for (const [key, value] of searchParams.entries()) if (key.startsWith("prefill.")) {
+		const fieldName = key.slice(8);
+		if (fieldName) try {
+			if (value.startsWith("[") || value.startsWith("{") || value === "true" || value === "false" || value === "null" || !isNaN(Number(value))) prefill[fieldName] = JSON.parse(value);
+			else prefill[fieldName] = value;
+		} catch {
+			prefill[fieldName] = value;
+		}
+	}
+	return prefill;
+}
+/**
+* Build URL with prefill parameters
+*
+* @param baseUrl - Base URL to add params to
+* @param prefillData - Object with field names and values to prefill
+* @returns URL with prefill query params
+*
+* @example
+* ```ts
+* buildPrefillUrl("/admin/collections/barbers/create", { services: "123" })
+* // Returns: "/admin/collections/barbers/create?prefill.services=123"
+*
+* buildPrefillUrl("/admin/collections/posts/create", { tags: ["a", "b"] })
+* // Returns: "/admin/collections/posts/create?prefill.tags=%5B%22a%22%2C%22b%22%5D"
+* ```
+*/
+function buildPrefillUrl(baseUrl, prefillData) {
+	const url = new URL(baseUrl, "http://localhost");
+	for (const [key, value] of Object.entries(prefillData)) if (value !== void 0 && value !== null) {
+		const stringValue = typeof value === "object" ? JSON.stringify(value) : String(value);
+		url.searchParams.set(`prefill.${key}`, stringValue);
+	}
+	return url.pathname + url.search;
+}
+
+//#endregion
+export { buildPrefillUrl, parsePrefillParams };
+//# sourceMappingURL=use-prefill-params.mjs.map

package/dist/client/hooks/use-prefill-params.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-prefill-params.mjs","names":["prefill: Record<string, unknown>"],"sources":["../../../src/client/hooks/use-prefill-params.ts"],"sourcesContent":["/**\n * usePrefillParams Hook\n *\n * Reads prefill parameters from URL query string for pre-populating form fields.\n * Supports the pattern: ?prefill.fieldName=value\n *\n * @example\n * ```tsx\n * // URL: /admin/collections/barbers/create?prefill.services=123\n *\n * const prefill = usePrefillParams();\n * // prefill = { services: \"123\" }\n *\n * <CollectionForm defaultValues={prefill} ... />\n * ```\n */\n\nimport * as React from \"react\";\n\n/**\n * Parse prefill parameters from a URLSearchParams object\n */\nexport function parsePrefillParams(\n  searchParams: URLSearchParams,\n): Record<string, unknown> {\n  const prefill: Record<string, unknown> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    if (key.startsWith(\"prefill.\")) {\n      const fieldName = key.slice(\"prefill.\".length);\n      if (fieldName) {\n        // Try to parse JSON for complex values (arrays, objects)\n        try {\n          // Check if value looks like JSON\n          if (\n            value.startsWith(\"[\") ||\n            value.startsWith(\"{\") ||\n            value === \"true\" ||\n            value === \"false\" ||\n            value === \"null\" ||\n            !isNaN(Number(value))\n          ) {\n            prefill[fieldName] = JSON.parse(value);\n          } else {\n            prefill[fieldName] = value;\n          }\n        } catch {\n          // If parsing fails, use as string\n          prefill[fieldName] = value;\n        }\n      }\n    }\n  }\n\n  return prefill;\n}\n\n/**\n * Parse prefill parameters from URL string\n */\nexport function parsePrefillParamsFromUrl(\n  url: string,\n): Record<string, unknown> {\n  try {\n    const urlObj = new URL(url, \"http://localhost\");\n    return parsePrefillParams(urlObj.searchParams);\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Hook to read prefill parameters from current URL\n *\n * @returns Object with field names as keys and prefill values\n */\nexport function usePrefillParams(): Record<string, unknown> {\n  const [prefill, setPrefill] = React.useState<Record<string, unknown>>({});\n\n  React.useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    // Parse initial URL\n    const searchParams = new URLSearchParams(window.location.search);\n    setPrefill(parsePrefillParams(searchParams));\n\n    // Listen for URL changes (for SPA navigation)\n    const handlePopState = () => {\n      const params = new URLSearchParams(window.location.search);\n      setPrefill(parsePrefillParams(params));\n    };\n\n    window.addEventListener(\"popstate\", handlePopState);\n    return () => window.removeEventListener(\"popstate\", handlePopState);\n  }, []);\n\n  return prefill;\n}\n\n/**\n * Build URL with prefill parameters\n *\n * @param baseUrl - Base URL to add params to\n * @param prefillData - Object with field names and values to prefill\n * @returns URL with prefill query params\n *\n * @example\n * ```ts\n * buildPrefillUrl(\"/admin/collections/barbers/create\", { services: \"123\" })\n * // Returns: \"/admin/collections/barbers/create?prefill.services=123\"\n *\n * buildPrefillUrl(\"/admin/collections/posts/create\", { tags: [\"a\", \"b\"] })\n * // Returns: \"/admin/collections/posts/create?prefill.tags=%5B%22a%22%2C%22b%22%5D\"\n * ```\n */\nexport function buildPrefillUrl(\n  baseUrl: string,\n  prefillData: Record<string, unknown>,\n): string {\n  const url = new URL(baseUrl, \"http://localhost\");\n\n  for (const [key, value] of Object.entries(prefillData)) {\n    if (value !== undefined && value !== null) {\n      const stringValue =\n        typeof value === \"object\" ? JSON.stringify(value) : String(value);\n      url.searchParams.set(`prefill.${key}`, stringValue);\n    }\n  }\n\n  // Return path + search (without origin for relative URLs)\n  return url.pathname + url.search;\n}\n\nexport default usePrefillParams;\n"],"mappings":";;;;;;AAsBA,SAAgB,mBACd,cACyB;CACzB,MAAMA,UAAmC,EAAE;AAE3C,MAAK,MAAM,CAAC,KAAK,UAAU,aAAa,SAAS,CAC/C,KAAI,IAAI,WAAW,WAAW,EAAE;EAC9B,MAAM,YAAY,IAAI,MAAM,EAAkB;AAC9C,MAAI,UAEF,KAAI;AAEF,OACE,MAAM,WAAW,IAAI,IACrB,MAAM,WAAW,IAAI,IACrB,UAAU,UACV,UAAU,WACV,UAAU,UACV,CAAC,MAAM,OAAO,MAAM,CAAC,CAErB,SAAQ,aAAa,KAAK,MAAM,MAAM;OAEtC,SAAQ,aAAa;UAEjB;AAEN,WAAQ,aAAa;;;AAM7B,QAAO;;;;;;;;;;;;;;;;;;AA6DT,SAAgB,gBACd,SACA,aACQ;CACR,MAAM,MAAM,IAAI,IAAI,SAAS,mBAAmB;AAEhD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,YAAY,CACpD,KAAI,UAAU,UAAa,UAAU,MAAM;EACzC,MAAM,cACJ,OAAO,UAAU,WAAW,KAAK,UAAU,MAAM,GAAG,OAAO,MAAM;AACnE,MAAI,aAAa,IAAI,WAAW,OAAO,YAAY;;AAKvD,QAAO,IAAI,WAAW,IAAI"}

package/dist/client/hooks/use-questpie-query-options.mjs

@@ -0,0 +1,28 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useScopedLocale } from "../runtime/locale-scope.mjs";
+import { createQuestpieQueryOptions } from "@questpie/tanstack-query";
+import { useQueryClient } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-questpie-query-options.ts
+/**
+* Shared hook that creates questpie query options with the current client and scoped locale.
+* Deduplicates the common pattern used across collection/global hooks.
+*/
+function useQuestpieQueryOptions(keyPrefix = ["questpie", "collections"]) {
+	const client = useAdminStore(selectClient);
+	const { locale } = useScopedLocale();
+	const queryClient = useQueryClient();
+	return {
+		queryOpts: createQuestpieQueryOptions(client, {
+			keyPrefix,
+			locale
+		}),
+		queryClient,
+		locale,
+		client
+	};
+}
+
+//#endregion
+export { useQuestpieQueryOptions };
+//# sourceMappingURL=use-questpie-query-options.mjs.map

package/dist/client/hooks/use-questpie-query-options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-questpie-query-options.mjs","names":[],"sources":["../../../src/client/hooks/use-questpie-query-options.ts"],"sourcesContent":["import { createQuestpieQueryOptions } from \"@questpie/tanstack-query\";\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport {\n\tselectClient,\n\tuseAdminStore,\n\tuseScopedLocale,\n} from \"../runtime\";\n\n/**\n * Shared hook that creates questpie query options with the current client and scoped locale.\n * Deduplicates the common pattern used across collection/global hooks.\n */\nexport function useQuestpieQueryOptions(\n\tkeyPrefix: readonly string[] = [\"questpie\", \"collections\"],\n) {\n\tconst client = useAdminStore(selectClient);\n\tconst { locale } = useScopedLocale();\n\tconst queryClient = useQueryClient();\n\tconst queryOpts = createQuestpieQueryOptions(client as any, {\n\t\tkeyPrefix,\n\t\tlocale,\n\t});\n\n\treturn { queryOpts, queryClient, locale, client } as const;\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAgB,wBACf,YAA+B,CAAC,YAAY,cAAc,EACzD;CACD,MAAM,SAAS,cAAc,aAAa;CAC1C,MAAM,EAAE,WAAW,iBAAiB;CACpC,MAAM,cAAc,gBAAgB;AAMpC,QAAO;EAAE,WALS,2BAA2B,QAAe;GAC3D;GACA;GACA,CAAC;EAEkB;EAAa;EAAQ;EAAQ"}