@questpie/admin 1.1.0 → 2.0.0

package/dist/client/hooks/use-admin-config.mjs

@@ -0,0 +1,40 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useQuery, useSuspenseQuery } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-admin-config.ts
+/**
+* Hook for fetching server-side admin config
+*/
+/** Query key for admin config */
+const adminConfigQueryKey = [
+	"questpie",
+	"admin",
+	"config"
+];
+/** Query options factory for admin config */
+function getAdminConfigQueryOptions(client) {
+	return {
+		queryKey: adminConfigQueryKey,
+		queryFn: async () => {
+			if (!client || !client.rpc) return {};
+			return client.rpc.getAdminConfig();
+		},
+		staleTime: 300 * 1e3,
+		gcTime: 1800 * 1e3
+	};
+}
+/** Standard query hook - returns loading/error states */
+function useAdminConfig(queryOptions) {
+	return useQuery({
+		...getAdminConfigQueryOptions(useAdminStore(selectClient)),
+		...queryOptions
+	});
+}
+/** Suspense query hook - suspends until data is ready, no loading checks needed */
+function useSuspenseAdminConfig() {
+	return useSuspenseQuery({ ...getAdminConfigQueryOptions(useAdminStore(selectClient)) });
+}
+
+//#endregion
+export { useAdminConfig, useSuspenseAdminConfig };
+//# sourceMappingURL=use-admin-config.mjs.map

package/dist/client/hooks/use-admin-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-admin-config.mjs","names":[],"sources":["../../../src/client/hooks/use-admin-config.ts"],"sourcesContent":["/**\n * Hook for fetching server-side admin config\n */\n\nimport {\n\ttype UseQueryOptions,\n\tuseQuery,\n\tuseSuspenseQuery,\n} from \"@tanstack/react-query\";\nimport { selectClient, useAdminStore } from \"../runtime\";\nimport type { AdminConfigResponse } from \"../types/admin-config\";\n\n/** Query key for admin config */\nexport const adminConfigQueryKey = [\"questpie\", \"admin\", \"config\"] as const;\n\n/** Query options factory for admin config */\nexport function getAdminConfigQueryOptions(client: unknown) {\n\treturn {\n\t\tqueryKey: adminConfigQueryKey,\n\t\tqueryFn: async (): Promise<AdminConfigResponse> => {\n\t\t\tif (!client || !(client as any).rpc) {\n\t\t\t\treturn {};\n\t\t\t}\n\t\t\treturn (client as any).rpc.getAdminConfig();\n\t\t},\n\t\tstaleTime: 5 * 60 * 1000,\n\t\tgcTime: 30 * 60 * 1000,\n\t};\n}\n\n/** Standard query hook - returns loading/error states */\nexport function useAdminConfig(\n\tqueryOptions?: Omit<\n\t\tUseQueryOptions<AdminConfigResponse>,\n\t\t\"queryKey\" | \"queryFn\"\n\t>,\n) {\n\tconst client = useAdminStore(selectClient);\n\n\treturn useQuery<AdminConfigResponse>({\n\t\t...getAdminConfigQueryOptions(client),\n\t\t...queryOptions,\n\t});\n}\n\n/** Suspense query hook - suspends until data is ready, no loading checks needed */\nexport function useSuspenseAdminConfig() {\n\tconst client = useAdminStore(selectClient);\n\n\treturn useSuspenseQuery<AdminConfigResponse>({\n\t\t...getAdminConfigQueryOptions(client),\n\t});\n}\n"],"mappings":";;;;;;;;AAaA,MAAa,sBAAsB;CAAC;CAAY;CAAS;CAAS;;AAGlE,SAAgB,2BAA2B,QAAiB;AAC3D,QAAO;EACN,UAAU;EACV,SAAS,YAA0C;AAClD,OAAI,CAAC,UAAU,CAAE,OAAe,IAC/B,QAAO,EAAE;AAEV,UAAQ,OAAe,IAAI,gBAAgB;;EAE5C,WAAW,MAAS;EACpB,QAAQ,OAAU;EAClB;;;AAIF,SAAgB,eACf,cAIC;AAGD,QAAO,SAA8B;EACpC,GAAG,2BAHW,cAAc,aAAa,CAGJ;EACrC,GAAG;EACH,CAAC;;;AAIH,SAAgB,yBAAyB;AAGxC,QAAO,iBAAsC,EAC5C,GAAG,2BAHW,cAAc,aAAa,CAGJ,EACrC,CAAC"}

package/dist/client/hooks/use-admin-preferences.mjs

@@ -0,0 +1,68 @@
+import { useAdminStore } from "../runtime/provider.mjs";
+import { useCurrentUser } from "./use-current-user.mjs";
+import { useMutation, useQuery, useQueryClient, useSuspenseQuery } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-admin-preferences.ts
+/**
+* Get query key for admin preference
+*/
+function getAdminPreferenceQueryKey(userId, key) {
+	return [
+		"adminPreferences",
+		userId,
+		key
+	];
+}
+/**
+* Hook to set an admin preference
+*
+* Creates or updates the preference for the current user.
+*
+* @param key - Preference key (e.g., "viewState:posts")
+* @returns Mutation for setting the preference
+*
+* @example
+* ```tsx
+* const { mutate: setPreference, isPending } = useSetAdminPreference<ViewConfiguration>("viewState:posts");
+*
+* const handleSave = () => {
+*   setPreference(viewConfig);
+* };
+* ```
+*/
+function useSetAdminPreference(key) {
+	const client = useAdminStore((s) => s.client);
+	const user = useCurrentUser();
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: async (value) => {
+			if (!user?.id) throw new Error("User must be logged in to save preferences");
+			const collections = client?.collections;
+			if (!collections?.adminPreferences) throw new Error("adminPreferences collection not available. Make sure to use adminModule in your CMS setup.");
+			const existing = await collections.adminPreferences.findOne({ where: {
+				userId: user.id,
+				key
+			} });
+			if (existing) return collections.adminPreferences.update({
+				id: existing.id,
+				data: { value }
+			});
+			return collections.adminPreferences.create({
+				userId: user.id,
+				key,
+				value
+			});
+		},
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: [
+				"adminPreferences",
+				user?.id,
+				key
+			] });
+		}
+	});
+}
+
+//#endregion
+export { getAdminPreferenceQueryKey, useSetAdminPreference };
+//# sourceMappingURL=use-admin-preferences.mjs.map

package/dist/client/hooks/use-admin-preferences.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-admin-preferences.mjs","names":[],"sources":["../../../src/client/hooks/use-admin-preferences.ts"],"sourcesContent":["import {\n\tuseMutation,\n\tuseQuery,\n\tuseQueryClient,\n\tuseSuspenseQuery,\n} from \"@tanstack/react-query\";\nimport { useAdminStore } from \"../runtime/provider.js\";\nimport { useCurrentUser } from \"./use-current-user.js\";\n\n// ============================================================================\n// Query Keys & Options\n// ============================================================================\n\n/**\n * Get query key for admin preference\n */\nexport function getAdminPreferenceQueryKey(\n\tuserId: string | undefined,\n\tkey: string,\n) {\n\treturn [\"adminPreferences\", userId, key] as const;\n}\n\n/**\n * Query options factory for admin preference.\n * Can be used with TanStack Query's prefetching or with useSuspenseQuery.\n *\n * @param client - CMS client instance\n * @param userId - User ID (required for query to work)\n * @param key - Preference key\n *\n * @example\n * ```ts\n * // Prefetch in loader\n * await queryClient.ensureQueryData(\n *   getAdminPreferenceQueryOptions(client, userId, \"viewState:posts\")\n * );\n * ```\n */\nexport function getAdminPreferenceQueryOptions<T>(\n\tclient: any,\n\tuserId: string | undefined,\n\tkey: string,\n) {\n\treturn {\n\t\tqueryKey: getAdminPreferenceQueryKey(userId, key),\n\t\tqueryFn: async (): Promise<T | null> => {\n\t\t\tif (!userId) return null;\n\n\t\t\tconst result = await client.collections.adminPreferences.findOne({\n\t\t\t\twhere: { userId, key },\n\t\t\t});\n\n\t\t\treturn (result?.value as T) ?? null;\n\t\t},\n\t\tenabled: !!client && !!userId,\n\t\tstaleTime: 30 * 1000, // 30 seconds\n\t};\n}\n\n/**\n * Admin Preference entity from the database\n */\nexport interface AdminPreference<T = unknown> {\n\tid: string;\n\tuserId: string;\n\tkey: string;\n\tvalue: T;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\n/**\n * Hook to fetch a single admin preference by key\n *\n * @param key - Preference key (e.g., \"viewState:posts\")\n * @returns Query result with preference data or null if not found\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useAdminPreference<ViewConfiguration>(\"viewState:posts\");\n * if (isLoading) return <Loading />;\n * const viewConfig = data ?? defaultConfig;\n * ```\n */\nexport function useAdminPreference<T = unknown>(key: string) {\n\tconst client = useAdminStore((s) => s.client);\n\tconst user = useCurrentUser();\n\n\treturn useQuery({\n\t\tqueryKey: [\"adminPreferences\", user?.id, key],\n\t\tqueryFn: async (): Promise<T | null> => {\n\t\t\tif (!user?.id) return null;\n\n\t\t\tconst result = await client.collections.adminPreferences.findOne({\n\t\t\t\twhere: { userId: user.id, key },\n\t\t\t});\n\n\t\t\treturn (result?.value as T) ?? null;\n\t\t},\n\t\tenabled: !!client && !!user?.id,\n\t});\n}\n\n/**\n * Hook to set an admin preference\n *\n * Creates or updates the preference for the current user.\n *\n * @param key - Preference key (e.g., \"viewState:posts\")\n * @returns Mutation for setting the preference\n *\n * @example\n * ```tsx\n * const { mutate: setPreference, isPending } = useSetAdminPreference<ViewConfiguration>(\"viewState:posts\");\n *\n * const handleSave = () => {\n *   setPreference(viewConfig);\n * };\n * ```\n */\nexport function useSetAdminPreference<T = unknown>(key: string) {\n\tconst client = useAdminStore((s) => s.client);\n\tconst user = useCurrentUser();\n\tconst queryClient = useQueryClient();\n\n\treturn useMutation({\n\t\tmutationFn: async (value: T) => {\n\t\t\tif (!user?.id) {\n\t\t\t\tthrow new Error(\"User must be logged in to save preferences\");\n\t\t\t}\n\n\t\t\tconst collections = client?.collections as\n\t\t\t\t| Record<string, any>\n\t\t\t\t| undefined;\n\t\t\tif (!collections?.adminPreferences) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"adminPreferences collection not available. Make sure to use adminModule in your CMS setup.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Try to find existing preference\n\t\t\tconst existing = await collections.adminPreferences.findOne({\n\t\t\t\twhere: { userId: user.id, key },\n\t\t\t});\n\n\t\t\tif (existing) {\n\t\t\t\t// Update existing\n\t\t\t\treturn collections.adminPreferences.update({\n\t\t\t\t\tid: existing.id,\n\t\t\t\t\tdata: { value },\n\t\t\t\t});\n\t\t\t}\n\t\t\t// Create new\n\t\t\treturn collections.adminPreferences.create({\n\t\t\t\tuserId: user.id,\n\t\t\t\tkey,\n\t\t\t\tvalue,\n\t\t\t});\n\t\t},\n\t\tonSuccess: () => {\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: [\"adminPreferences\", user?.id, key],\n\t\t\t});\n\t\t},\n\t});\n}\n\n/**\n * Hook to delete an admin preference\n *\n * @param key - Preference key (e.g., \"viewState:posts\")\n * @returns Mutation for deleting the preference\n *\n * @example\n * ```tsx\n * const { mutate: deletePreference } = useDeleteAdminPreference(\"viewState:posts\");\n *\n * const handleReset = () => {\n *   deletePreference();\n * };\n * ```\n */\nexport function useDeleteAdminPreference(key: string) {\n\tconst client = useAdminStore((s) => s.client);\n\tconst user = useCurrentUser();\n\tconst queryClient = useQueryClient();\n\n\treturn useMutation({\n\t\tmutationFn: async () => {\n\t\t\tif (!user?.id) {\n\t\t\t\tthrow new Error(\"User must be logged in to delete preferences\");\n\t\t\t}\n\n\t\t\tconst collections = client?.collections as\n\t\t\t\t| Record<string, any>\n\t\t\t\t| undefined;\n\t\t\tif (!collections?.adminPreferences) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"adminPreferences collection not available. Make sure to use adminModule in your CMS setup.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Find existing preference\n\t\t\tconst existing = await collections.adminPreferences.findOne({\n\t\t\t\twhere: { userId: user.id, key },\n\t\t\t});\n\n\t\t\tif (existing) {\n\t\t\t\treturn collections.adminPreferences.delete({ id: existing.id });\n\t\t\t}\n\n\t\t\treturn null;\n\t\t},\n\t\tonSuccess: () => {\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: [\"adminPreferences\", user?.id, key],\n\t\t\t});\n\t\t},\n\t});\n}\n\n// ============================================================================\n// Suspense Hook\n// ============================================================================\n\n/**\n * Suspense-enabled hook to fetch admin preference.\n *\n * Uses useSuspenseQuery so the component will suspend until data is loaded.\n * Must be used within a Suspense boundary and requires userId to be known.\n *\n * @param key - Preference key (e.g., \"viewState:posts\")\n * @param userId - User ID (must be available - use after session is loaded)\n *\n * @example\n * ```tsx\n * function ViewStateInner({ collection, userId }: Props) {\n *   // This will suspend until preference is loaded\n *   const { data: storedConfig } = useSuspenseAdminPreference<ViewConfiguration>(\n *     `viewState:${collection}`,\n *     userId\n *   );\n *\n *   // storedConfig is guaranteed to be loaded (may be null if not found)\n * }\n *\n * // Wrap with Suspense\n * <Suspense fallback={<Loading />}>\n *   <ViewStateInner collection=\"posts\" userId={user.id} />\n * </Suspense>\n * ```\n */\nexport function useSuspenseAdminPreference<T = unknown>(\n\tkey: string,\n\tuserId: string,\n) {\n\tconst client = useAdminStore((s) => s.client);\n\n\treturn useSuspenseQuery<T | null>({\n\t\tqueryKey: getAdminPreferenceQueryKey(userId, key),\n\t\tqueryFn: async () => {\n\t\t\tconst result = await client.collections.adminPreferences.findOne({\n\t\t\t\twhere: { userId, key },\n\t\t\t});\n\n\t\t\treturn (result?.value as T) ?? null;\n\t\t},\n\t});\n}\n"],"mappings":";;;;;;;;AAgBA,SAAgB,2BACf,QACA,KACC;AACD,QAAO;EAAC;EAAoB;EAAQ;EAAI;;;;;;;;;;;;;;;;;;;AAqGzC,SAAgB,sBAAmC,KAAa;CAC/D,MAAM,SAAS,eAAe,MAAM,EAAE,OAAO;CAC7C,MAAM,OAAO,gBAAgB;CAC7B,MAAM,cAAc,gBAAgB;AAEpC,QAAO,YAAY;EAClB,YAAY,OAAO,UAAa;AAC/B,OAAI,CAAC,MAAM,GACV,OAAM,IAAI,MAAM,6CAA6C;GAG9D,MAAM,cAAc,QAAQ;AAG5B,OAAI,CAAC,aAAa,iBACjB,OAAM,IAAI,MACT,6FACA;GAIF,MAAM,WAAW,MAAM,YAAY,iBAAiB,QAAQ,EAC3D,OAAO;IAAE,QAAQ,KAAK;IAAI;IAAK,EAC/B,CAAC;AAEF,OAAI,SAEH,QAAO,YAAY,iBAAiB,OAAO;IAC1C,IAAI,SAAS;IACb,MAAM,EAAE,OAAO;IACf,CAAC;AAGH,UAAO,YAAY,iBAAiB,OAAO;IAC1C,QAAQ,KAAK;IACb;IACA;IACA,CAAC;;EAEH,iBAAiB;AAChB,eAAY,kBAAkB,EAC7B,UAAU;IAAC;IAAoB,MAAM;IAAI;IAAI,EAC7C,CAAC;;EAEH,CAAC"}

package/dist/client/hooks/use-admin-routes.mjs

@@ -0,0 +1,97 @@
+import { selectAdmin, selectBasePath, selectNavigate, useAdminStore } from "../runtime/provider.mjs";
+import { createAdminRoutes, createNavigator } from "../utils/routes.mjs";
+import * as React$1 from "react";
+
+//#region src/client/hooks/use-admin-routes.ts
+/**
+* Hook for type-safe admin route navigation
+*
+* @example
+* ```tsx
+* function MyComponent() {
+*   const { toDashboard, toCollection, toCollectionEdit } = useAdminRoutes<AppCMS>()
+*
+*   return (
+*     <div>
+*       <button onClick={toDashboard}>Dashboard</button>
+*       <button onClick={() => toCollection('posts')}>View Posts</button>
+*       <button onClick={() => toCollectionEdit('posts', '123')}>Edit Post</button>
+*     </div>
+*   )
+* }
+* ```
+*
+* @example
+* ```tsx
+* // Get URLs without navigating
+* function LinkList() {
+*   const { collectionUrl, globalUrl, pageUrl } = useAdminRoutes<AppCMS>()
+*
+*   return (
+*     <nav>
+*       <a href={collectionUrl('posts')}>Posts</a>
+*       <a href={collectionUrl('users')}>Users</a>
+*       <a href={globalUrl('siteSettings')}>Settings</a>
+*       <a href={pageUrl('analytics') ?? '#'}>Analytics</a>
+*     </nav>
+*   )
+* }
+* ```
+*/
+function useAdminRoutes(options = {}) {
+	const admin = useAdminStore(selectAdmin);
+	const storeBasePath = useAdminStore(selectBasePath);
+	const storeNavigate = useAdminStore(selectNavigate);
+	const basePath = options.basePath ?? storeBasePath;
+	const routes = React$1.useMemo(() => createAdminRoutes(admin, { basePath }), [admin, basePath]);
+	const navigate = storeNavigate;
+	const nav = React$1.useMemo(() => createNavigator(routes, navigate), [routes, navigate]);
+	return {
+		routes,
+		toDashboard: nav.dashboard,
+		toCollection: nav.collection,
+		toCollectionCreate: nav.collectionCreate,
+		toCollectionEdit: nav.collectionEdit,
+		toGlobal: nav.global,
+		toPage: nav.page,
+		dashboardUrl: routes.dashboard,
+		collectionUrl: routes.collections.list,
+		collectionCreateUrl: routes.collections.create,
+		collectionEditUrl: routes.collections.edit,
+		globalUrl: routes.globals.edit,
+		pageUrl: routes.pages.byId,
+		allPageUrls: routes.pages.all,
+		parse: routes.parse,
+		matches: routes.matches
+	};
+}
+/**
+* Get href for admin link props
+*
+* @example
+* ```tsx
+* function AdminLink<TApp extends Questpie<any>>(
+*   props: AdminLinkProps<TApp> & { children: React.ReactNode }
+* ) {
+*   const { routes } = useAdminRoutes<TApp>()
+*   const href = getAdminLinkHref(routes, props)
+*   return <a href={href}>{props.children}</a>
+* }
+* ```
+*/
+function getAdminLinkHref(routes, props) {
+	if (props.to === "dashboard") return routes.dashboard();
+	if (props.collection) {
+		const action = props.action ?? "list";
+		if (action === "create") return routes.collections.create(props.collection);
+		if (action === "edit" && props.id) return routes.collections.edit(props.collection, props.id);
+		return routes.collections.list(props.collection);
+	}
+	if (props.global) return routes.globals.edit(props.global);
+	if (props.pageId) return routes.pages.byId(props.pageId) ?? routes.dashboard();
+	return routes.dashboard();
+}
+
+//#endregion
+export { getAdminLinkHref, useAdminRoutes };
+//# sourceMappingURL=use-admin-routes.mjs.map

package/dist/client/hooks/use-admin-routes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-admin-routes.mjs","names":["React"],"sources":["../../../src/client/hooks/use-admin-routes.ts"],"sourcesContent":["/**\n * useAdminRoutes Hook\n *\n * React hook for type-safe admin route navigation.\n * Uses the AdminProvider context to get the current admin configuration.\n */\n\nimport type { Questpie } from \"questpie\";\nimport * as React from \"react\";\nimport {\n  selectAdmin,\n  selectBasePath,\n  selectNavigate,\n  useAdminStore,\n} from \"../runtime\";\nimport {\n  type AdminRoutes,\n  type CollectionNames,\n  createAdminRoutes,\n  createNavigator,\n  type GlobalNames,\n} from \"../utils/routes\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface UseAdminRoutesOptions {\n  /** Override the base path (default: from context or \"/admin\") */\n  basePath?: string;\n}\n\nexport interface UseAdminRoutesResult<TApp extends Questpie<any>> {\n  /** Routes builder */\n  routes: AdminRoutes<TApp>;\n\n  /** Navigate to dashboard */\n  toDashboard: () => void;\n\n  /** Navigate to collection list */\n  toCollection: <K extends CollectionNames<TApp>>(collection: K) => void;\n\n  /** Navigate to collection create */\n  toCollectionCreate: <K extends CollectionNames<TApp>>(collection: K) => void;\n\n  /** Navigate to collection edit */\n  toCollectionEdit: <K extends CollectionNames<TApp>>(\n    collection: K,\n    id: string,\n  ) => void;\n\n  /** Navigate to global edit */\n  toGlobal: <K extends GlobalNames<TApp>>(global: K) => void;\n\n  /** Navigate to custom page */\n  toPage: (pageId: string) => void;\n\n  /** Get dashboard URL */\n  dashboardUrl: () => string;\n\n  /** Get collection list URL */\n  collectionUrl: <K extends CollectionNames<TApp>>(collection: K) => string;\n\n  /** Get collection create URL */\n  collectionCreateUrl: <K extends CollectionNames<TApp>>(\n    collection: K,\n  ) => string;\n\n  /** Get collection edit URL */\n  collectionEditUrl: <K extends CollectionNames<TApp>>(\n    collection: K,\n    id: string,\n  ) => string;\n\n  /** Get global edit URL */\n  globalUrl: <K extends GlobalNames<TApp>>(global: K) => string;\n\n  /** Get custom page URL */\n  pageUrl: (pageId: string) => string | null;\n\n  /** Get all page URLs */\n  allPageUrls: () => Record<string, string>;\n\n  /** Parse current pathname */\n  parse: AdminRoutes<TApp>[\"parse\"];\n\n  /** Check if pathname matches */\n  matches: AdminRoutes<TApp>[\"matches\"];\n}\n\n// ============================================================================\n// Hook\n// ============================================================================\n\n/**\n * Hook for type-safe admin route navigation\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { toDashboard, toCollection, toCollectionEdit } = useAdminRoutes<AppCMS>()\n *\n *   return (\n *     <div>\n *       <button onClick={toDashboard}>Dashboard</button>\n *       <button onClick={() => toCollection('posts')}>View Posts</button>\n *       <button onClick={() => toCollectionEdit('posts', '123')}>Edit Post</button>\n *     </div>\n *   )\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Get URLs without navigating\n * function LinkList() {\n *   const { collectionUrl, globalUrl, pageUrl } = useAdminRoutes<AppCMS>()\n *\n *   return (\n *     <nav>\n *       <a href={collectionUrl('posts')}>Posts</a>\n *       <a href={collectionUrl('users')}>Users</a>\n *       <a href={globalUrl('siteSettings')}>Settings</a>\n *       <a href={pageUrl('analytics') ?? '#'}>Analytics</a>\n *     </nav>\n *   )\n * }\n * ```\n */\nexport function useAdminRoutes<TApp extends Questpie<any>>(\n  options: UseAdminRoutesOptions = {},\n): UseAdminRoutesResult<TApp> {\n  const admin = useAdminStore(selectAdmin);\n  const storeBasePath = useAdminStore(selectBasePath);\n  const storeNavigate = useAdminStore(selectNavigate);\n\n  const basePath = options.basePath ?? storeBasePath;\n\n  // Create routes builder (memoized)\n  const routes = React.useMemo(\n    () => createAdminRoutes<TApp>(admin, { basePath }),\n    [admin, basePath],\n  );\n\n  // Get navigate function from store\n  const navigate = storeNavigate;\n\n  // Create navigator (memoized)\n  const nav = React.useMemo(\n    () => createNavigator(routes, navigate),\n    [routes, navigate],\n  );\n\n  return {\n    routes,\n\n    // Navigation functions\n    toDashboard: nav.dashboard,\n    toCollection: nav.collection,\n    toCollectionCreate: nav.collectionCreate,\n    toCollectionEdit: nav.collectionEdit,\n    toGlobal: nav.global,\n    toPage: nav.page,\n\n    // URL getters\n    dashboardUrl: routes.dashboard,\n    collectionUrl: routes.collections.list,\n    collectionCreateUrl: routes.collections.create,\n    collectionEditUrl: routes.collections.edit,\n    globalUrl: routes.globals.edit,\n    pageUrl: routes.pages.byId,\n    allPageUrls: routes.pages.all,\n\n    // Parsing & matching\n    parse: routes.parse,\n    matches: routes.matches,\n  };\n}\n\n// ============================================================================\n// Standalone Hook (no context required)\n// ============================================================================\n\n/**\n * Hook for type-safe admin routes without requiring AdminProvider context\n *\n * @example\n * ```tsx\n * import { barbershopAdmin } from './configs/admin'\n *\n * function MyComponent() {\n *   const navigate = useNavigate() // from your router\n *   const { routes, go } = useAdminRoutesStandalone({\n *     admin: barbershopAdmin,\n *     basePath: '/admin',\n *     navigate,\n *   })\n *\n *   return <button onClick={go.dashboard}>Dashboard</button>\n * }\n * ```\n */\nexport function useAdminRoutesStandalone<TApp extends Questpie<any>>(options: {\n  admin: import(\"../builder/admin\").Admin;\n  basePath?: string;\n  navigate: (path: string) => void;\n}) {\n  const { admin, basePath = \"/admin\", navigate } = options;\n\n  const routes = React.useMemo(\n    () => createAdminRoutes<TApp>(admin, { basePath }),\n    [admin, basePath],\n  );\n\n  const go = React.useMemo(\n    () => createNavigator(routes, navigate),\n    [routes, navigate],\n  );\n\n  return { routes, go };\n}\n\n// ============================================================================\n// Link Component Helper\n// ============================================================================\n\n/**\n * Props for admin link components\n */\nexport interface AdminLinkProps<TApp extends Questpie<any>> {\n  /** Link to dashboard */\n  to?: \"dashboard\";\n  /** Link to collection */\n  collection?: CollectionNames<TApp>;\n  /** Collection action */\n  action?: \"list\" | \"create\" | \"edit\";\n  /** Item ID for edit action */\n  id?: string;\n  /** Link to global */\n  global?: GlobalNames<TApp>;\n  /** Link to custom page by ID */\n  pageId?: string;\n}\n\n/**\n * Get href for admin link props\n *\n * @example\n * ```tsx\n * function AdminLink<TApp extends Questpie<any>>(\n *   props: AdminLinkProps<TApp> & { children: React.ReactNode }\n * ) {\n *   const { routes } = useAdminRoutes<TApp>()\n *   const href = getAdminLinkHref(routes, props)\n *   return <a href={href}>{props.children}</a>\n * }\n * ```\n */\nexport function getAdminLinkHref<TApp extends Questpie<any>>(\n  routes: AdminRoutes<TApp>,\n  props: AdminLinkProps<TApp>,\n): string {\n  if (props.to === \"dashboard\") {\n    return routes.dashboard();\n  }\n\n  if (props.collection) {\n    const action = props.action ?? \"list\";\n    if (action === \"create\") {\n      return routes.collections.create(props.collection);\n    }\n    if (action === \"edit\" && props.id) {\n      return routes.collections.edit(props.collection, props.id);\n    }\n    return routes.collections.list(props.collection);\n  }\n\n  if (props.global) {\n    return routes.globals.edit(props.global);\n  }\n\n  if (props.pageId) {\n    return routes.pages.byId(props.pageId) ?? routes.dashboard();\n  }\n\n  return routes.dashboard();\n}\n\nexport default useAdminRoutes;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiIA,SAAgB,eACd,UAAiC,EAAE,EACP;CAC5B,MAAM,QAAQ,cAAc,YAAY;CACxC,MAAM,gBAAgB,cAAc,eAAe;CACnD,MAAM,gBAAgB,cAAc,eAAe;CAEnD,MAAM,WAAW,QAAQ,YAAY;CAGrC,MAAM,SAASA,QAAM,cACb,kBAAwB,OAAO,EAAE,UAAU,CAAC,EAClD,CAAC,OAAO,SAAS,CAClB;CAGD,MAAM,WAAW;CAGjB,MAAM,MAAMA,QAAM,cACV,gBAAgB,QAAQ,SAAS,EACvC,CAAC,QAAQ,SAAS,CACnB;AAED,QAAO;EACL;EAGA,aAAa,IAAI;EACjB,cAAc,IAAI;EAClB,oBAAoB,IAAI;EACxB,kBAAkB,IAAI;EACtB,UAAU,IAAI;EACd,QAAQ,IAAI;EAGZ,cAAc,OAAO;EACrB,eAAe,OAAO,YAAY;EAClC,qBAAqB,OAAO,YAAY;EACxC,mBAAmB,OAAO,YAAY;EACtC,WAAW,OAAO,QAAQ;EAC1B,SAAS,OAAO,MAAM;EACtB,aAAa,OAAO,MAAM;EAG1B,OAAO,OAAO;EACd,SAAS,OAAO;EACjB;;;;;;;;;;;;;;;;AAkFH,SAAgB,iBACd,QACA,OACQ;AACR,KAAI,MAAM,OAAO,YACf,QAAO,OAAO,WAAW;AAG3B,KAAI,MAAM,YAAY;EACpB,MAAM,SAAS,MAAM,UAAU;AAC/B,MAAI,WAAW,SACb,QAAO,OAAO,YAAY,OAAO,MAAM,WAAW;AAEpD,MAAI,WAAW,UAAU,MAAM,GAC7B,QAAO,OAAO,YAAY,KAAK,MAAM,YAAY,MAAM,GAAG;AAE5D,SAAO,OAAO,YAAY,KAAK,MAAM,WAAW;;AAGlD,KAAI,MAAM,OACR,QAAO,OAAO,QAAQ,KAAK,MAAM,OAAO;AAG1C,KAAI,MAAM,OACR,QAAO,OAAO,MAAM,KAAK,MAAM,OAAO,IAAI,OAAO,WAAW;AAG9D,QAAO,OAAO,WAAW"}

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

@@ -0,0 +1,98 @@
+import { createAuthClient } from "better-auth/react";
+import { Questpie } from "questpie";
+import { BetterAuthOptions } from "better-auth";
+
+//#region src/client/hooks/use-auth.d.ts
+
+/**
+ * Extract auth options type from Questpie instance
+ */
+type ExtractAuthOptions<T extends Questpie<any>> = T extends Questpie<infer TConfig> ? TConfig["auth"] extends BetterAuthOptions ? TConfig["auth"] : BetterAuthOptions : BetterAuthOptions;
+/**
+ * Options for creating admin auth client
+ */
+type AdminAuthClientOptions = {
+  /**
+   * Base URL of the CMS API
+   * @example 'http://localhost:3000'
+   */
+  baseURL: string;
+  /**
+   * Base path for auth routes
+   * @default '/cms/auth'
+   */
+  basePath?: string;
+  /**
+   * Custom fetch implementation
+   */
+  fetchOptions?: {
+    credentials?: RequestCredentials;
+    headers?: Record<string, string>;
+  };
+};
+/**
+ * Internal client options type that includes $InferAuth
+ */
+type InternalClientOptions<T extends Questpie<any>> = {
+  baseURL: string;
+  fetchOptions?: {
+    credentials?: RequestCredentials;
+    headers?: Record<string, string>;
+  };
+  $InferAuth: ExtractAuthOptions<T>;
+};
+/**
+ * Create a type-safe Better Auth client for the admin UI
+ *
+ * The returned client includes full type inference from your CMS auth configuration:
+ * - `useSession()` - React hook for session state (typed based on your user/session schema)
+ * - `signIn` methods (email, social providers configured in CMS)
+ * - `signOut` - Sign out the current user
+ * - `signUp` - Register new users
+ * - Plugin-specific hooks (e.g., `useListAccounts` for admin plugin)
+ *
+ * @example
+ * ```tsx
+ * import { createAdminAuthClient } from '@questpie/admin/hooks'
+ * import type { cms } from './server/cms'
+ *
+ * // Create client with type inference from your CMS
+ * export const authClient = createAdminAuthClient<typeof cms>({
+ *   baseURL: 'http://localhost:3000'
+ * })
+ *
+ * // Session data is fully typed based on your CMS auth config
+ * function App() {
+ *   const { data: session, isPending } = authClient.useSession()
+ *
+ *   if (isPending) return <Loading />
+ *   if (!session) return <LoginPage authClient={authClient} />
+ *
+ *   // session.user has all fields from your user schema
+ *   return <AdminDashboard user={session.user} />
+ * }
+ * ```
+ */
+declare function createAdminAuthClient<T extends Questpie<any>>(options: AdminAuthClientOptions): ReturnType<typeof createAuthClient<InternalClientOptions<T>>>;
+/**
+ * Hook to access the auth client from AdminProvider context.
+ *
+ * @example
+ * ```tsx
+ * import { useAuthClient } from '@questpie/admin/hooks'
+ *
+ * function LoginPage() {
+ *   const authClient = useAuthClient()
+ *
+ *   const handleLogin = async (email: string, password: string) => {
+ *     await authClient.signIn.email({ email, password })
+ *   }
+ *
+ *   return <LoginForm onSubmit={handleLogin} />
+ * }
+ * ```
+ */
+declare function useAuthClient<T = any>(): T;
+//#endregion
+export { createAdminAuthClient, useAuthClient };
+//# sourceMappingURL=use-auth.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-auth.d.mts","names":[],"sources":["../../../src/client/hooks/use-auth.ts"],"sourcesContent":[],"mappings":";;;;;;AAiMA;;;KA7JK,6BAA6B,iBAChC,UAAU,0BACN,wBAAwB,oBACtB,kBACA,oBACF;;;;KAKM,sBAAA;;;;;;;;;;;;;;;kBAiBM;cACJ;;;;;;KAOT,gCAAgC;;;kBAGnB;cACJ;;cAEA,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmCjB,gCAAgC,wBACrC,yBACR,kBAAkB,iBAAiB,sBAAsB;;;;;;;;;;;;;;;;;;;iBA+E5C,0BAA0B"}

package/dist/{use-auth-BoLmWtmU.mjs → client/hooks/use-auth.mjs}

@@ -1,4 +1,4 @@
-import { f as useAdminStore, i as selectAuthClient } from "./content-locales-provider-BXvuIgfg.mjs";
+import { selectAuthClient, useAdminStore } from "../runtime/provider.mjs";
 import { createAuthClient } from "better-auth/react";
 
 //#region src/client/hooks/use-auth.ts
@@ -84,5 +84,5 @@ function useAuthClientSafe() {
 }
 
 //#endregion
-export { useAuthClient as n, useAuthClientSafe as r, createAdminAuthClient as t };
-//# sourceMappingURL=use-auth-BoLmWtmU.mjs.map
+export { createAdminAuthClient, useAuthClient, useAuthClientSafe };
+//# sourceMappingURL=use-auth.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-auth.mjs","names":[],"sources":["../../../src/client/hooks/use-auth.ts"],"sourcesContent":["/**\n * Auth client utilities for admin package\n *\n * Better Auth handles all auth state management internally.\n * This module provides type-safe client creation helpers with\n * full type inference from your CMS auth configuration.\n *\n * @example\n * ```tsx\n * // In your app, create the auth client once:\n * import { createAdminAuthClient } from '@questpie/admin/hooks'\n * import type { cms } from './server/cms'\n *\n * export const authClient = createAdminAuthClient<typeof cms>({\n *   baseURL: 'http://localhost:3000'\n * })\n *\n * // Then use the built-in hooks:\n * function MyComponent() {\n *   const { data: session, isPending, error } = authClient.useSession()\n *\n *   if (isPending) return <div>Loading...</div>\n *   if (!session) return <LoginForm />\n *\n *   return <div>Welcome {session.user.name}</div>\n * }\n * ```\n */\n\nimport type { BetterAuthOptions } from \"better-auth\";\nimport { createAuthClient } from \"better-auth/react\";\nimport type { Questpie } from \"questpie\";\n\n/**\n * Extract auth options type from Questpie instance\n */\ntype ExtractAuthOptions<T extends Questpie<any>> =\n  T extends Questpie<infer TConfig>\n    ? TConfig[\"auth\"] extends BetterAuthOptions\n      ? TConfig[\"auth\"]\n      : BetterAuthOptions\n    : BetterAuthOptions;\n\n/**\n * Options for creating admin auth client\n */\nexport type AdminAuthClientOptions = {\n  /**\n   * Base URL of the CMS API\n   * @example 'http://localhost:3000'\n   */\n  baseURL: string;\n\n  /**\n   * Base path for auth routes\n   * @default '/cms/auth'\n   */\n  basePath?: string;\n\n  /**\n   * Custom fetch implementation\n   */\n  fetchOptions?: {\n    credentials?: RequestCredentials;\n    headers?: Record<string, string>;\n  };\n};\n\n/**\n * Internal client options type that includes $InferAuth\n */\ntype InternalClientOptions<T extends Questpie<any>> = {\n  baseURL: string;\n  fetchOptions?: {\n    credentials?: RequestCredentials;\n    headers?: Record<string, string>;\n  };\n  $InferAuth: ExtractAuthOptions<T>;\n};\n\n/**\n * Create a type-safe Better Auth client for the admin UI\n *\n * The returned client includes full type inference from your CMS auth configuration:\n * - `useSession()` - React hook for session state (typed based on your user/session schema)\n * - `signIn` methods (email, social providers configured in CMS)\n * - `signOut` - Sign out the current user\n * - `signUp` - Register new users\n * - Plugin-specific hooks (e.g., `useListAccounts` for admin plugin)\n *\n * @example\n * ```tsx\n * import { createAdminAuthClient } from '@questpie/admin/hooks'\n * import type { cms } from './server/cms'\n *\n * // Create client with type inference from your CMS\n * export const authClient = createAdminAuthClient<typeof cms>({\n *   baseURL: 'http://localhost:3000'\n * })\n *\n * // Session data is fully typed based on your CMS auth config\n * function App() {\n *   const { data: session, isPending } = authClient.useSession()\n *\n *   if (isPending) return <Loading />\n *   if (!session) return <LoginPage authClient={authClient} />\n *\n *   // session.user has all fields from your user schema\n *   return <AdminDashboard user={session.user} />\n * }\n * ```\n */\nexport function createAdminAuthClient<T extends Questpie<any>>(\n  options: AdminAuthClientOptions,\n): ReturnType<typeof createAuthClient<InternalClientOptions<T>>> {\n  const basePath = options.basePath ?? \"/cms/auth\";\n\n  return createAuthClient<InternalClientOptions<T>>({\n    baseURL: `${options.baseURL}${basePath}`,\n    fetchOptions: {\n      credentials: options.fetchOptions?.credentials ?? \"include\",\n      headers: options.fetchOptions?.headers,\n    },\n  } as InternalClientOptions<T>);\n}\n\n/**\n * Type helper to extract auth client type from CMS instance\n *\n * @example\n * ```tsx\n * import type { AdminAuthClient } from '@questpie/admin/hooks'\n * import type { cms } from './server/cms'\n *\n * type MyAuthClient = AdminAuthClient<typeof cms>\n * ```\n */\nexport type AdminAuthClient<T extends Questpie<any>> = ReturnType<\n  typeof createAdminAuthClient<T>\n>;\n\n/**\n * Type helper to extract session type from auth client\n *\n * @example\n * ```tsx\n * import type { AdminSession } from '@questpie/admin/hooks'\n * import type { cms } from './server/cms'\n *\n * type MySession = AdminSession<typeof cms>\n * // Includes: { user: { id, email, name, role, ... }, session: { ... } }\n * ```\n */\nexport type AdminSession<T extends Questpie<any>> =\n  AdminAuthClient<T>[\"$Infer\"][\"Session\"];\n\n/**\n * Type helper to extract user type from CMS auth configuration\n *\n * @example\n * ```tsx\n * import type { AdminUser } from '@questpie/admin/hooks'\n * import type { cms } from './server/cms'\n *\n * type MyUser = AdminUser<typeof cms>\n * ```\n */\nexport type AdminUser<T extends Questpie<any>> = AdminSession<T>[\"user\"];\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\nimport { selectAuthClient, useAdminStore } from \"../runtime/provider\";\n\n/**\n * Hook to access the auth client from AdminProvider context.\n *\n * @example\n * ```tsx\n * import { useAuthClient } from '@questpie/admin/hooks'\n *\n * function LoginPage() {\n *   const authClient = useAuthClient()\n *\n *   const handleLogin = async (email: string, password: string) => {\n *     await authClient.signIn.email({ email, password })\n *   }\n *\n *   return <LoginForm onSubmit={handleLogin} />\n * }\n * ```\n */\nexport function useAuthClient<T = any>(): T {\n  const authClient = useAdminStore(selectAuthClient);\n  if (!authClient) {\n    throw new Error(\n      \"useAuthClient: authClient is not provided. \" +\n        \"Make sure to pass authClient to AdminProvider.\",\n    );\n  }\n  return authClient as T;\n}\n\n/**\n * Hook to access the auth client from AdminProvider context.\n * Returns null if authClient is not provided (safe version).\n *\n * @example\n * ```tsx\n * const authClient = useAuthClientSafe()\n * if (!authClient) {\n *   return <div>Auth not configured</div>\n * }\n * ```\n */\nexport function useAuthClientSafe<T = any>(): T | null {\n  return useAdminStore(selectAuthClient) as T | null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgHA,SAAgB,sBACd,SAC+D;CAC/D,MAAM,WAAW,QAAQ,YAAY;AAErC,QAAO,iBAA2C;EAChD,SAAS,GAAG,QAAQ,UAAU;EAC9B,cAAc;GACZ,aAAa,QAAQ,cAAc,eAAe;GAClD,SAAS,QAAQ,cAAc;GAChC;EACF,CAA6B;;;;;;;;;;;;;;;;;;;;AAsEhC,SAAgB,gBAA4B;CAC1C,MAAM,aAAa,cAAc,iBAAiB;AAClD,KAAI,CAAC,WACH,OAAM,IAAI,MACR,4FAED;AAEH,QAAO;;;;;;;;;;;;;;AAeT,SAAgB,oBAAuC;AACrD,QAAO,cAAc,iBAAiB"}

package/dist/client/hooks/use-collection-fields.mjs

@@ -0,0 +1,32 @@
+import { selectAdmin, useAdminStore } from "../runtime/provider.mjs";
+import { buildFieldDefinitionsFromSchema } from "../utils/build-field-definitions-from-schema.mjs";
+import { useCollectionSchema } from "./use-collection-schema.mjs";
+import { useMemo } from "react";
+
+//#region src/client/hooks/use-collection-fields.ts
+function useCollectionFields(collection, options = {}) {
+	const admin = useAdminStore(selectAdmin);
+	const { data: schema, isLoading, error } = useCollectionSchema(collection, options.schemaQueryOptions);
+	return {
+		fields: useMemo(() => {
+			const fallback = options.fallbackFields ?? {};
+			if (!schema || !admin) return fallback;
+			return {
+				...buildFieldDefinitionsFromSchema(schema, admin.getFields(), options.buildOptions),
+				...fallback
+			};
+		}, [
+			schema,
+			admin,
+			options.buildOptions,
+			options.fallbackFields
+		]),
+		schema,
+		isLoading,
+		error
+	};
+}
+
+//#endregion
+export { useCollectionFields };
+//# sourceMappingURL=use-collection-fields.mjs.map

package/dist/client/hooks/use-collection-fields.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection-fields.mjs","names":[],"sources":["../../../src/client/hooks/use-collection-fields.ts"],"sourcesContent":["/**\n * Hook for resolving field definitions from collection schema\n *\n * Builds FieldDefinition objects from server introspection schema\n * and merges with any local overrides.\n */\n\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { CollectionSchema } from \"questpie\";\nimport { useMemo } from \"react\";\nimport type { FieldDefinition } from \"../builder/field/field\";\nimport { selectAdmin, useAdminStore } from \"../runtime\";\nimport {\n  type BuildFieldDefinitionsOptions,\n  buildFieldDefinitionsFromSchema,\n} from \"../utils/build-field-definitions-from-schema\";\nimport { useCollectionSchema } from \"./use-collection-schema\";\n\nexport interface UseCollectionFieldsOptions {\n  /**\n   * React Query options for schema fetching\n   */\n  schemaQueryOptions?: Omit<\n    UseQueryOptions<CollectionSchema>,\n    \"queryKey\" | \"queryFn\"\n  >;\n  /**\n   * Options for building field definitions from schema\n   */\n  buildOptions?: BuildFieldDefinitionsOptions;\n  /**\n   * Local field definitions to merge as overrides\n   */\n  fallbackFields?: Record<string, FieldDefinition>;\n}\n\nexport function useCollectionFields(\n  collection: string,\n  options: UseCollectionFieldsOptions = {},\n) {\n  const admin = useAdminStore(selectAdmin);\n  const {\n    data: schema,\n    isLoading,\n    error,\n  } = useCollectionSchema(collection, options.schemaQueryOptions);\n\n  const fields = useMemo(() => {\n    const fallback = options.fallbackFields ?? {};\n    if (!schema || !admin) {\n      return fallback;\n    }\n\n    const registry = admin.getFields() as Record<string, any>;\n    const schemaFields = buildFieldDefinitionsFromSchema(\n      schema,\n      registry,\n      options.buildOptions,\n    );\n\n    return {\n      ...schemaFields,\n      ...fallback,\n    };\n  }, [schema, admin, options.buildOptions, options.fallbackFields]);\n\n  return { fields, schema, isLoading, error };\n}\n"],"mappings":";;;;;;AAoCA,SAAgB,oBACd,YACA,UAAsC,EAAE,EACxC;CACA,MAAM,QAAQ,cAAc,YAAY;CACxC,MAAM,EACJ,MAAM,QACN,WACA,UACE,oBAAoB,YAAY,QAAQ,mBAAmB;AAqB/D,QAAO;EAAE,QAnBM,cAAc;GAC3B,MAAM,WAAW,QAAQ,kBAAkB,EAAE;AAC7C,OAAI,CAAC,UAAU,CAAC,MACd,QAAO;AAUT,UAAO;IACL,GAPmB,gCACnB,QAFe,MAAM,WAAW,EAIhC,QAAQ,aACT;IAIC,GAAG;IACJ;KACA;GAAC;GAAQ;GAAO,QAAQ;GAAc,QAAQ;GAAe,CAAC;EAEhD;EAAQ;EAAW;EAAO"}

package/dist/client/hooks/use-collection-meta.mjs

@@ -0,0 +1,121 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useQuery, useSuspenseQuery } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-collection-meta.ts
+/**
+* Hook for fetching collection metadata from the backend
+*
+* Used to get introspection info about collections like:
+* - Title field configuration (which field to display first)
+* - Whether timestamps are enabled
+* - Whether soft delete is enabled
+* - Localized fields
+* - Virtual fields
+*/
+/**
+* Hook to fetch collection metadata from the backend
+*
+* Returns introspection info useful for building dynamic UIs:
+* - title.fieldName: The field to use as display title (instead of _title)
+* - title.type: "field" (sortable) or "virtual" (computed)
+* - timestamps: Whether createdAt/updatedAt are enabled
+* - softDelete: Whether soft delete is enabled
+* - localizedFields: Fields that support i18n
+*
+* @example
+* ```tsx
+* const { data: meta } = useCollectionMeta("posts");
+*
+* // Use title.fieldName instead of _title for first column
+* const firstColumn = meta?.title.fieldName || "_title";
+*
+* // Only show timestamps columns if enabled
+* if (meta?.timestamps) {
+*   columns.push("createdAt", "updatedAt");
+* }
+* ```
+*/
+function useCollectionMeta(collection, queryOptions) {
+	const client = useAdminStore(selectClient);
+	return useQuery({
+		queryKey: [
+			"questpie",
+			"collections",
+			collection,
+			"meta"
+		],
+		queryFn: async () => {
+			return client.collections[collection].meta();
+		},
+		staleTime: 300 * 1e3,
+		gcTime: 1800 * 1e3,
+		...queryOptions
+	});
+}
+/**
+* Query key for collection meta
+* Useful for prefetching or invalidation
+*/
+function getCollectionMetaQueryKey(collection) {
+	return [
+		"questpie",
+		"collections",
+		collection,
+		"meta"
+	];
+}
+/**
+* Query options factory for collection metadata.
+* Can be used with TanStack Query's prefetching in loaders or with useSuspenseQuery.
+*
+* @example
+* ```ts
+* // In TanStack Start loader
+* export const Route = createFileRoute("/admin/collections/:name")({
+*   loader: async ({ context, params }) => {
+*     await context.queryClient.ensureQueryData(
+*       getCollectionMetaQueryOptions(params.name, context.client)
+*     );
+*   },
+* });
+* ```
+*/
+function getCollectionMetaQueryOptions(collection, client) {
+	return {
+		queryKey: getCollectionMetaQueryKey(collection),
+		queryFn: async () => {
+			return client.collections[collection].meta();
+		},
+		staleTime: 300 * 1e3,
+		gcTime: 1800 * 1e3
+	};
+}
+/**
+* Suspense-enabled hook to fetch collection metadata.
+*
+* Uses useSuspenseQuery so the component will suspend until data is loaded.
+* Must be used within a Suspense boundary.
+*
+* @example
+* ```tsx
+* function TableViewInner({ collection }: Props) {
+*   // This will suspend until meta is loaded
+*   const { data: meta } = useSuspenseCollectionMeta(collection);
+*
+*   // meta is guaranteed to be defined here
+*   const titleField = meta.title.fieldName;
+* }
+*
+* // Wrap with Suspense
+* <Suspense fallback={<Loading />}>
+*   <TableViewInner collection="posts" />
+* </Suspense>
+* ```
+*/
+function useSuspenseCollectionMeta(collection) {
+	return useSuspenseQuery(getCollectionMetaQueryOptions(collection, useAdminStore(selectClient)));
+}
+
+//#endregion
+export { useCollectionMeta, useSuspenseCollectionMeta };
+//# sourceMappingURL=use-collection-meta.mjs.map

package/dist/client/hooks/use-collection-meta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection-meta.mjs","names":[],"sources":["../../../src/client/hooks/use-collection-meta.ts"],"sourcesContent":["/**\n * Hook for fetching collection metadata from the backend\n *\n * Used to get introspection info about collections like:\n * - Title field configuration (which field to display first)\n * - Whether timestamps are enabled\n * - Whether soft delete is enabled\n * - Localized fields\n * - Virtual fields\n */\n\nimport {\n\ttype UseQueryOptions,\n\tuseQuery,\n\tuseSuspenseQuery,\n} from \"@tanstack/react-query\";\nimport type { Questpie } from \"questpie\";\nimport type { CollectionMeta } from \"questpie/client\";\nimport type {\n\tRegisteredCMS,\n\tRegisteredCollectionNames,\n} from \"../builder/registry\";\nimport { selectClient, useAdminStore } from \"../runtime\";\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Resolved collection names (string if not registered)\n */\ntype ResolvedCollectionNames =\n\tRegisteredCMS extends Questpie<any> ? RegisteredCollectionNames : string;\n\n// ============================================================================\n// Hook\n// ============================================================================\n\n/**\n * Hook to fetch collection metadata from the backend\n *\n * Returns introspection info useful for building dynamic UIs:\n * - title.fieldName: The field to use as display title (instead of _title)\n * - title.type: \"field\" (sortable) or \"virtual\" (computed)\n * - timestamps: Whether createdAt/updatedAt are enabled\n * - softDelete: Whether soft delete is enabled\n * - localizedFields: Fields that support i18n\n *\n * @example\n * ```tsx\n * const { data: meta } = useCollectionMeta(\"posts\");\n *\n * // Use title.fieldName instead of _title for first column\n * const firstColumn = meta?.title.fieldName || \"_title\";\n *\n * // Only show timestamps columns if enabled\n * if (meta?.timestamps) {\n *   columns.push(\"createdAt\", \"updatedAt\");\n * }\n * ```\n */\nexport function useCollectionMeta<K extends ResolvedCollectionNames>(\n\tcollection: K,\n\tqueryOptions?: Omit<UseQueryOptions<CollectionMeta>, \"queryKey\" | \"queryFn\">,\n) {\n\tconst client = useAdminStore(selectClient);\n\n\treturn useQuery<CollectionMeta>({\n\t\tqueryKey: [\"questpie\", \"collections\", collection, \"meta\"],\n\t\tqueryFn: async () => {\n\t\t\treturn (client as any).collections[collection].meta();\n\t\t},\n\t\t// Meta rarely changes, cache aggressively\n\t\tstaleTime: 5 * 60 * 1000, // 5 minutes\n\t\tgcTime: 30 * 60 * 1000, // 30 minutes (formerly cacheTime)\n\t\t...queryOptions,\n\t});\n}\n\n/**\n * Query key for collection meta\n * Useful for prefetching or invalidation\n */\nexport function getCollectionMetaQueryKey(collection: string) {\n\treturn [\"questpie\", \"collections\", collection, \"meta\"] as const;\n}\n\n// ============================================================================\n// Query Options Factory\n// ============================================================================\n\n/**\n * Query options factory for collection metadata.\n * Can be used with TanStack Query's prefetching in loaders or with useSuspenseQuery.\n *\n * @example\n * ```ts\n * // In TanStack Start loader\n * export const Route = createFileRoute(\"/admin/collections/:name\")({\n *   loader: async ({ context, params }) => {\n *     await context.queryClient.ensureQueryData(\n *       getCollectionMetaQueryOptions(params.name, context.client)\n *     );\n *   },\n * });\n * ```\n */\nexport function getCollectionMetaQueryOptions(collection: string, client: any) {\n\treturn {\n\t\tqueryKey: getCollectionMetaQueryKey(collection),\n\t\tqueryFn: async (): Promise<CollectionMeta> => {\n\t\t\treturn client.collections[collection].meta();\n\t\t},\n\t\tstaleTime: 5 * 60 * 1000, // 5 minutes\n\t\tgcTime: 30 * 60 * 1000, // 30 minutes\n\t};\n}\n\n// ============================================================================\n// Suspense Hook\n// ============================================================================\n\n/**\n * Suspense-enabled hook to fetch collection metadata.\n *\n * Uses useSuspenseQuery so the component will suspend until data is loaded.\n * Must be used within a Suspense boundary.\n *\n * @example\n * ```tsx\n * function TableViewInner({ collection }: Props) {\n *   // This will suspend until meta is loaded\n *   const { data: meta } = useSuspenseCollectionMeta(collection);\n *\n *   // meta is guaranteed to be defined here\n *   const titleField = meta.title.fieldName;\n * }\n *\n * // Wrap with Suspense\n * <Suspense fallback={<Loading />}>\n *   <TableViewInner collection=\"posts\" />\n * </Suspense>\n * ```\n */\nexport function useSuspenseCollectionMeta<K extends ResolvedCollectionNames>(\n\tcollection: K,\n) {\n\tconst client = useAdminStore(selectClient);\n\n\treturn useSuspenseQuery<CollectionMeta>(\n\t\tgetCollectionMetaQueryOptions(collection, client),\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,kBACf,YACA,cACC;CACD,MAAM,SAAS,cAAc,aAAa;AAE1C,QAAO,SAAyB;EAC/B,UAAU;GAAC;GAAY;GAAe;GAAY;GAAO;EACzD,SAAS,YAAY;AACpB,UAAQ,OAAe,YAAY,YAAY,MAAM;;EAGtD,WAAW,MAAS;EACpB,QAAQ,OAAU;EAClB,GAAG;EACH,CAAC;;;;;;AAOH,SAAgB,0BAA0B,YAAoB;AAC7D,QAAO;EAAC;EAAY;EAAe;EAAY;EAAO;;;;;;;;;;;;;;;;;;AAuBvD,SAAgB,8BAA8B,YAAoB,QAAa;AAC9E,QAAO;EACN,UAAU,0BAA0B,WAAW;EAC/C,SAAS,YAAqC;AAC7C,UAAO,OAAO,YAAY,YAAY,MAAM;;EAE7C,WAAW,MAAS;EACpB,QAAQ,OAAU;EAClB;;;;;;;;;;;;;;;;;;;;;;;;AA6BF,SAAgB,0BACf,YACC;AAGD,QAAO,iBACN,8BAA8B,YAHhB,cAAc,aAAa,CAGQ,CACjD"}

package/dist/client/hooks/use-collection-schema.mjs

@@ -0,0 +1,67 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-collection-schema.ts
+/**
+* Hook for fetching collection schema from the backend
+*
+* Returns full introspection data including:
+* - Field schemas with metadata and validation
+* - Relations metadata
+* - Access control information for current user
+* - JSON Schema for client-side validation
+*/
+/**
+* Hook to fetch collection schema from the backend
+*
+* Returns full introspection data useful for building dynamic forms and UIs:
+* - fields: Complete field metadata including type, label, validation, admin config
+* - relations: Relation metadata with type, target collection(s), and keys
+* - access: Evaluated access control for the current user
+* - validation: JSON Schema for client-side validation
+* - options: Collection options (timestamps, softDelete, versioning)
+*
+* @example
+* ```tsx
+* const { data: schema } = useCollectionSchema("posts");
+*
+* // Build fields dynamically from schema
+* for (const [name, field] of Object.entries(schema?.fields ?? {})) {
+*   const FieldComponent = getFieldComponent(field.metadata.type);
+*   // Use field.metadata for rendering configuration
+* }
+*
+* // Check user access
+* if (schema?.access.operations.create.allowed) {
+*   // Show create button
+* }
+* ```
+*/
+function useCollectionSchema(collection, queryOptions) {
+	const client = useAdminStore(selectClient);
+	return useQuery({
+		queryKey: getCollectionSchemaQueryKey(collection),
+		queryFn: async () => {
+			return client.collections[collection].schema();
+		},
+		staleTime: 300 * 1e3,
+		gcTime: 1800 * 1e3,
+		...queryOptions
+	});
+}
+/**
+* Query key for collection schema
+* Useful for prefetching or invalidation
+*/
+function getCollectionSchemaQueryKey(collection) {
+	return [
+		"questpie",
+		"collections",
+		collection,
+		"schema"
+	];
+}
+
+//#endregion
+export { useCollectionSchema };
+//# sourceMappingURL=use-collection-schema.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection-schema.mjs","names":[],"sources":["../../../src/client/hooks/use-collection-schema.ts"],"sourcesContent":["/**\n * Hook for fetching collection schema from the backend\n *\n * Returns full introspection data including:\n * - Field schemas with metadata and validation\n * - Relations metadata\n * - Access control information for current user\n * - JSON Schema for client-side validation\n */\n\nimport { type UseQueryOptions, useQuery } from \"@tanstack/react-query\";\nimport type { Questpie } from \"questpie\";\nimport type { CollectionSchema } from \"questpie/client\";\nimport type {\n  RegisteredCMS,\n  RegisteredCollectionNames,\n} from \"../builder/registry\";\nimport { selectClient, useAdminStore } from \"../runtime\";\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Resolved collection names (string if not registered)\n */\ntype ResolvedCollectionNames =\n  RegisteredCMS extends Questpie<any> ? RegisteredCollectionNames : string;\n\n// ============================================================================\n// Hook\n// ============================================================================\n\n/**\n * Hook to fetch collection schema from the backend\n *\n * Returns full introspection data useful for building dynamic forms and UIs:\n * - fields: Complete field metadata including type, label, validation, admin config\n * - relations: Relation metadata with type, target collection(s), and keys\n * - access: Evaluated access control for the current user\n * - validation: JSON Schema for client-side validation\n * - options: Collection options (timestamps, softDelete, versioning)\n *\n * @example\n * ```tsx\n * const { data: schema } = useCollectionSchema(\"posts\");\n *\n * // Build fields dynamically from schema\n * for (const [name, field] of Object.entries(schema?.fields ?? {})) {\n *   const FieldComponent = getFieldComponent(field.metadata.type);\n *   // Use field.metadata for rendering configuration\n * }\n *\n * // Check user access\n * if (schema?.access.operations.create.allowed) {\n *   // Show create button\n * }\n * ```\n */\nexport function useCollectionSchema<K extends ResolvedCollectionNames>(\n  collection: K,\n  queryOptions?: Omit<\n    UseQueryOptions<CollectionSchema>,\n    \"queryKey\" | \"queryFn\"\n  >,\n) {\n  const client = useAdminStore(selectClient);\n\n  return useQuery<CollectionSchema>({\n    queryKey: getCollectionSchemaQueryKey(collection),\n    queryFn: async () => {\n      return (client as any).collections[collection].schema();\n    },\n    // Schema rarely changes, cache aggressively\n    staleTime: 5 * 60 * 1000, // 5 minutes\n    gcTime: 30 * 60 * 1000, // 30 minutes\n    ...queryOptions,\n  });\n}\n\n/**\n * Query key for collection schema\n * Useful for prefetching or invalidation\n */\nexport function getCollectionSchemaQueryKey(collection: string) {\n  return [\"questpie\", \"collections\", collection, \"schema\"] as const;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2DA,SAAgB,oBACd,YACA,cAIA;CACA,MAAM,SAAS,cAAc,aAAa;AAE1C,QAAO,SAA2B;EAChC,UAAU,4BAA4B,WAAW;EACjD,SAAS,YAAY;AACnB,UAAQ,OAAe,YAAY,YAAY,QAAQ;;EAGzD,WAAW,MAAS;EACpB,QAAQ,OAAU;EAClB,GAAG;EACJ,CAAC;;;;;;AAOJ,SAAgB,4BAA4B,YAAoB;AAC9D,QAAO;EAAC;EAAY;EAAe;EAAY;EAAS"}