@questpie/admin 1.1.0 → 2.0.0

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

@@ -0,0 +1,74 @@
+import { selectAdmin, useAdminStore } from "../runtime/provider.mjs";
+import { createFormSchema } from "../builder/validation.mjs";
+import { useCollectionFields } from "./use-collection-fields.mjs";
+import { useValidationErrorMap } from "./use-validation-error-map.mjs";
+import { useCallback, useMemo } from "react";
+
+//#region src/client/hooks/use-collection-validation.ts
+/**
+* Get a ready-to-use resolver for react-hook-form
+*
+* This is the recommended hook - provides full automatic validation
+* with i18n error messages. Just pass the result to useForm's resolver.
+*
+* @param collection - Collection name
+* @returns Resolver function for react-hook-form, or undefined if collection not found
+*
+* @example
+* ```tsx
+* function MyForm() {
+*   const resolver = useCollectionValidation("posts");
+*
+*   const form = useForm({
+*     resolver,
+*   });
+*
+*   // That's it! Validation and i18n errors work automatically.
+* }
+* ```
+*/
+function useCollectionValidation(collection) {
+	const admin = useAdminStore(selectAdmin);
+	const { fields } = useCollectionFields(collection);
+	const schema = useMemo(() => {
+		if (!admin) return void 0;
+		if (!fields || Object.keys(fields).length === 0) return void 0;
+		return createFormSchema(fields, admin.getFields());
+	}, [admin, fields]);
+	const errorMap = useValidationErrorMap();
+	const resolver = useCallback(async (values, _context, _options) => {
+		if (!schema) return {
+			values,
+			errors: {}
+		};
+		const result = schema.safeParse(values);
+		if (result.success) return {
+			values: result.data,
+			errors: {}
+		};
+		return {
+			values: {},
+			errors: zodErrorToFieldErrors(result.error, errorMap)
+		};
+	}, [schema, errorMap]);
+	return schema ? resolver : void 0;
+}
+/**
+* Convert Zod error to react-hook-form FieldErrors format with i18n support
+*/
+function zodErrorToFieldErrors(error, errorMap) {
+	const errors = {};
+	for (const issue of error.issues) {
+		const path = issue.path.join(".");
+		const { message } = errorMap(issue);
+		if (path && !errors[path]) errors[path] = {
+			type: issue.code,
+			message
+		};
+	}
+	return errors;
+}
+
+//#endregion
+export { useCollectionValidation };
+//# sourceMappingURL=use-collection-validation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection-validation.mjs","names":["resolver: Resolver<TFieldValues>","errors: FieldErrors<FieldValues>"],"sources":["../../../src/client/hooks/use-collection-validation.ts"],"sourcesContent":["/**\n * useCollectionValidation Hook\n *\n * Creates a Zod validation schema from a collection's field definitions.\n * Provides automatic validation with i18n support for react-hook-form.\n */\n\nimport type { ZodErrorMapFn } from \"questpie/shared\";\nimport { useCallback, useMemo } from \"react\";\nimport type { FieldErrors, FieldValues, Resolver } from \"react-hook-form\";\nimport type { z } from \"zod\";\nimport { createFormSchema } from \"../builder/validation\";\nimport { selectAdmin, useAdminStore } from \"../runtime\";\nimport { useCollectionFields } from \"./use-collection-fields\";\nimport { useValidationErrorMap } from \"./use-validation-error-map\";\n\n/**\n * Result of useCollectionValidation hook\n */\nexport interface CollectionValidationResult {\n  /** Zod schema for the collection's fields */\n  schema: z.ZodTypeAny | undefined;\n  /** Error map for i18n support */\n  errorMap: ZodErrorMapFn;\n}\n\n/**\n * Get a ready-to-use resolver for react-hook-form\n *\n * This is the recommended hook - provides full automatic validation\n * with i18n error messages. Just pass the result to useForm's resolver.\n *\n * @param collection - Collection name\n * @returns Resolver function for react-hook-form, or undefined if collection not found\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const resolver = useCollectionValidation(\"posts\");\n *\n *   const form = useForm({\n *     resolver,\n *   });\n *\n *   // That's it! Validation and i18n errors work automatically.\n * }\n * ```\n */\nexport function useCollectionValidation<\n  TFieldValues extends FieldValues = FieldValues,\n>(collection: string): Resolver<TFieldValues> | undefined {\n  const admin = useAdminStore(selectAdmin);\n  const { fields } = useCollectionFields(collection);\n  const schema = useMemo(() => {\n    if (!admin) return undefined;\n    if (!fields || Object.keys(fields).length === 0) return undefined;\n    return createFormSchema(fields, admin.getFields());\n  }, [admin, fields]);\n  const errorMap = useValidationErrorMap();\n\n  const resolver: Resolver<TFieldValues> = useCallback(\n    async (values, _context, _options) => {\n      if (!schema) {\n        return {\n          values: values as TFieldValues,\n          errors: {} as Record<string, never>,\n        };\n      }\n\n      const result = schema.safeParse(values);\n\n      if (result.success) {\n        return {\n          values: result.data as TFieldValues,\n          errors: {} as Record<string, never>,\n        };\n      }\n\n      return {\n        values: {} as Record<string, never>,\n        errors: zodErrorToFieldErrors(\n          result.error,\n          errorMap,\n        ) as FieldErrors<TFieldValues>,\n      };\n    },\n    [schema, errorMap],\n  );\n\n  return schema ? resolver : undefined;\n}\n\n/**\n * Convert Zod error to react-hook-form FieldErrors format with i18n support\n */\nfunction zodErrorToFieldErrors(\n  error: z.ZodError,\n  errorMap: ZodErrorMapFn,\n): FieldErrors<FieldValues> {\n  const errors: FieldErrors<FieldValues> = {};\n\n  for (const issue of error.issues) {\n    const path = issue.path.join(\".\");\n    // Apply i18n error map to get translated message\n    const { message } = errorMap(issue as Parameters<ZodErrorMapFn>[0]);\n\n    if (path && !errors[path]) {\n      errors[path] = {\n        type: issue.code,\n        message,\n      };\n    }\n  }\n\n  return errors;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,wBAEd,YAAwD;CACxD,MAAM,QAAQ,cAAc,YAAY;CACxC,MAAM,EAAE,WAAW,oBAAoB,WAAW;CAClD,MAAM,SAAS,cAAc;AAC3B,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,CAAC,UAAU,OAAO,KAAK,OAAO,CAAC,WAAW,EAAG,QAAO;AACxD,SAAO,iBAAiB,QAAQ,MAAM,WAAW,CAAC;IACjD,CAAC,OAAO,OAAO,CAAC;CACnB,MAAM,WAAW,uBAAuB;CAExC,MAAMA,WAAmC,YACvC,OAAO,QAAQ,UAAU,aAAa;AACpC,MAAI,CAAC,OACH,QAAO;GACG;GACR,QAAQ,EAAE;GACX;EAGH,MAAM,SAAS,OAAO,UAAU,OAAO;AAEvC,MAAI,OAAO,QACT,QAAO;GACL,QAAQ,OAAO;GACf,QAAQ,EAAE;GACX;AAGH,SAAO;GACL,QAAQ,EAAE;GACV,QAAQ,sBACN,OAAO,OACP,SACD;GACF;IAEH,CAAC,QAAQ,SAAS,CACnB;AAED,QAAO,SAAS,WAAW;;;;;AAM7B,SAAS,sBACP,OACA,UAC0B;CAC1B,MAAMC,SAAmC,EAAE;AAE3C,MAAK,MAAM,SAAS,MAAM,QAAQ;EAChC,MAAM,OAAO,MAAM,KAAK,KAAK,IAAI;EAEjC,MAAM,EAAE,YAAY,SAAS,MAAsC;AAEnE,MAAI,QAAQ,CAAC,OAAO,MAClB,QAAO,QAAQ;GACb,MAAM,MAAM;GACZ;GACD;;AAIL,QAAO"}

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

@@ -0,0 +1,86 @@
+import { RegisteredCMS, RegisteredCollectionNames } from "../builder/registry.mjs";
+import { UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+import { QuestpieClient } from "questpie/client";
+import { Questpie } from "questpie";
+
+//#region src/client/hooks/use-collection.d.ts
+type CollectionRealtimeOptions = {
+  realtime?: boolean;
+};
+/**
+ * Resolved CMS type (Questpie<any> if not registered)
+ */
+type ResolvedCMS = RegisteredCMS extends Questpie<any> ? RegisteredCMS : Questpie<any>;
+/**
+ * Resolved collection names (string if not registered)
+ */
+type ResolvedCollectionNames = RegisteredCMS extends Questpie<any> ? RegisteredCollectionNames : string;
+/**
+ * Hook to fetch collection list with filters, sorting, pagination
+ *
+ * Uses RegisteredCMS from module augmentation for automatic type inference.
+ *
+ * @example
+ * ```tsx
+ * // Types inferred from module augmentation!
+ * const { data } = useCollectionList("barbers");
+ * ```
+ */
+declare function useCollectionList<K extends ResolvedCollectionNames>(collection: K, options?: any, queryOptions?: Omit<UseQueryOptions, "queryKey" | "queryFn">, realtimeOptions?: CollectionRealtimeOptions): any;
+/**
+ * Hook to fetch single collection item
+ *
+ * Uses RegisteredCMS from module augmentation for automatic type inference.
+ *
+ * @example
+ * ```tsx
+ * // Types inferred from module augmentation!
+ * const { data } = useCollectionItem("barbers", "123");
+ * ```
+ */
+declare function useCollectionItem<K extends ResolvedCollectionNames>(collection: K, id: string, options?: Omit<Parameters<QuestpieClient<ResolvedCMS>["collections"][K & string]["findOne"]>[0], "where"> & {
+  localeFallback?: boolean;
+  with?: Record<string, boolean>;
+}, queryOptions?: Omit<UseQueryOptions, "queryKey" | "queryFn">): any;
+/**
+ * Hook to create collection item
+ *
+ * Uses RegisteredCMS from module augmentation for automatic type inference.
+ *
+ * @example
+ * ```tsx
+ * // Types inferred from module augmentation!
+ * const { mutate } = useCollectionCreate("barbers");
+ * mutate({ name: "John", ... });
+ * ```
+ */
+declare function useCollectionCreate<K extends ResolvedCollectionNames>(collection: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">): any;
+/**
+ * Hook to update collection item
+ *
+ * Uses RegisteredCMS from module augmentation for automatic type inference.
+ *
+ * @example
+ * ```tsx
+ * // Types inferred from module augmentation!
+ * const { mutate } = useCollectionUpdate("barbers");
+ * mutate({ id: "123", data: { name: "John" } });
+ * ```
+ */
+declare function useCollectionUpdate<K extends ResolvedCollectionNames>(collection: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">): any;
+/**
+ * Hook to delete collection item
+ *
+ * Uses RegisteredCMS from module augmentation for automatic type inference.
+ *
+ * @example
+ * ```tsx
+ * // Types inferred from module augmentation!
+ * const { mutate } = useCollectionDelete("barbers");
+ * mutate("123");
+ * ```
+ */
+declare function useCollectionDelete<K extends ResolvedCollectionNames>(collection: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">): any;
+//#endregion
+export { useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionUpdate };
+//# sourceMappingURL=use-collection.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection.d.mts","names":[],"sources":["../../../src/client/hooks/use-collection.ts"],"sourcesContent":[],"mappings":";;;;;;KAcK,yBAAA;;AAHwB,CAAA;AAGC;;;KAWzB,WAAA,GACJ,aAAsC,SAAhB,QAAgB,CAAA,GAAA,CAAA,GAAA,aAAA,GAAgB,QAAhB,CAAA,GAAA,CAAA;;;AAAwB;KAK1D,uBAAA,GACJ,aAAA,SAAsB,QAAtB,CAAA,GAAA,CAAA,GAAsC,yBAAtC,GAAA,MAAA;;;;AAiBD;;;;;;;AA+EA;AAA4C,iBA/E5B,iBA+E4B,CAAA,UA/EA,uBA+EA,CAAA,CAAA,UAAA,EA9E/B,CA8E+B,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,YAAA,CAAA,EA5E5B,IA4E4B,CA5EvB,eA4EuB,EAAA,UAAA,GAAA,SAAA,CAAA,EAAA,eAAA,CAAA,EA3EzB,yBA2EyB,CAAA,EAAA,GAAA;;AAmJ5C;;;;;;;;;;iBAnJgB,4BAA4B,qCAC/B,yBAEF,KACT,WACC,eAAe,4BAA4B;;SAKrC;kBAEO,KAAK;;;;;;;;;;;;;iBA0BL,8BAA8B,qCACjC,qBACM,KAAK;;;;;;;;;;;;;iBAgDR,8BAA8B,qCACjC,qBACM,KAAK;;;;;;;;;;;;;iBAyDR,8BAA8B,qCACjC,qBACM,KAAK"}

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

@@ -0,0 +1,214 @@
+import { useQuestpieQueryOptions } from "./use-questpie-query-options.mjs";
+import { useMutation, useQuery } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-collection.ts
+/**
+* Hook to fetch collection list with filters, sorting, pagination
+*
+* Uses RegisteredCMS from module augmentation for automatic type inference.
+*
+* @example
+* ```tsx
+* // Types inferred from module augmentation!
+* const { data } = useCollectionList("barbers");
+* ```
+*/
+function useCollectionList(collection, options, queryOptions, realtimeOptions) {
+	const { queryOpts, locale } = useQuestpieQueryOptions();
+	const findOptions = {
+		...options,
+		locale
+	};
+	return useQuery({
+		...queryOpts.collections[collection].find(findOptions, { realtime: realtimeOptions?.realtime }),
+		...queryOptions
+	});
+}
+/**
+* Hook to count collection items with optional filters
+*
+* More efficient than useCollectionList when you only need the count.
+* Uses dedicated count endpoint that doesn't fetch actual documents.
+*
+* @example
+* ```tsx
+* // Count all items
+* const { data: count } = useCollectionCount("barbers");
+*
+* // Count with filter
+* const { data: count } = useCollectionCount("appointments", {
+*   where: { status: "pending" }
+* });
+* ```
+*/
+function useCollectionCount(collection, options, queryOptions, realtimeOptions) {
+	const { queryOpts, locale } = useQuestpieQueryOptions();
+	const countOptions = {
+		...options,
+		locale
+	};
+	return useQuery({
+		...queryOpts.collections[collection].count(countOptions, { realtime: realtimeOptions?.realtime }),
+		...queryOptions
+	});
+}
+/**
+* Hook to fetch single collection item
+*
+* Uses RegisteredCMS from module augmentation for automatic type inference.
+*
+* @example
+* ```tsx
+* // Types inferred from module augmentation!
+* const { data } = useCollectionItem("barbers", "123");
+* ```
+*/
+function useCollectionItem(collection, id, options, queryOptions) {
+	const { queryOpts, locale } = useQuestpieQueryOptions();
+	return useQuery({
+		...queryOpts.collections[collection].findOne({
+			where: { id },
+			locale,
+			...options
+		}),
+		...queryOptions
+	});
+}
+/**
+* Hook to create collection item
+*
+* Uses RegisteredCMS from module augmentation for automatic type inference.
+*
+* @example
+* ```tsx
+* // Types inferred from module augmentation!
+* const { mutate } = useCollectionCreate("barbers");
+* mutate({ name: "John", ... });
+* ```
+*/
+function useCollectionCreate(collection, mutationOptions) {
+	const { queryOpts, queryClient, locale } = useQuestpieQueryOptions();
+	const baseOptions = queryOpts.collections[collection].create();
+	const listQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"find",
+		locale
+	]);
+	const countQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"count",
+		locale
+	]);
+	return useMutation({
+		...baseOptions,
+		onSuccess: (data, variables, context) => {
+			(mutationOptions?.onSuccess)?.(data, variables, context);
+		},
+		onSettled: (data, error, variables, context) => {
+			queryClient.invalidateQueries({ queryKey: listQueryKey });
+			queryClient.invalidateQueries({ queryKey: countQueryKey });
+			(mutationOptions?.onSettled)?.(data, error, variables, context);
+		},
+		...mutationOptions
+	});
+}
+/**
+* Hook to update collection item
+*
+* Uses RegisteredCMS from module augmentation for automatic type inference.
+*
+* @example
+* ```tsx
+* // Types inferred from module augmentation!
+* const { mutate } = useCollectionUpdate("barbers");
+* mutate({ id: "123", data: { name: "John" } });
+* ```
+*/
+function useCollectionUpdate(collection, mutationOptions) {
+	const { queryOpts, queryClient, locale } = useQuestpieQueryOptions();
+	const baseOptions = queryOpts.collections[collection].update();
+	const listQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"find",
+		locale
+	]);
+	const countQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"count",
+		locale
+	]);
+	const itemQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"findOne",
+		locale
+	]);
+	return useMutation({
+		...baseOptions,
+		onSuccess: (data, variables, context) => {
+			(mutationOptions?.onSuccess)?.(data, variables, context);
+		},
+		onSettled: (data, error, variables, context) => {
+			queryClient.invalidateQueries({ queryKey: listQueryKey });
+			queryClient.invalidateQueries({ queryKey: countQueryKey });
+			queryClient.invalidateQueries({ queryKey: itemQueryKey });
+			(mutationOptions?.onSettled)?.(data, error, variables, context);
+		},
+		...mutationOptions
+	});
+}
+/**
+* Hook to delete collection item
+*
+* Uses RegisteredCMS from module augmentation for automatic type inference.
+*
+* @example
+* ```tsx
+* // Types inferred from module augmentation!
+* const { mutate } = useCollectionDelete("barbers");
+* mutate("123");
+* ```
+*/
+function useCollectionDelete(collection, mutationOptions) {
+	const { queryOpts, queryClient, locale } = useQuestpieQueryOptions();
+	const baseOptions = queryOpts.collections[collection].delete();
+	const listQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"find",
+		locale
+	]);
+	const countQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"count",
+		locale
+	]);
+	const itemQueryKey = queryOpts.key([
+		"collections",
+		collection,
+		"findOne",
+		locale
+	]);
+	return useMutation({
+		...baseOptions,
+		onSuccess: (data, variables, context) => {
+			(mutationOptions?.onSuccess)?.(data, variables, context);
+		},
+		onSettled: (data, error, variables, context) => {
+			queryClient.invalidateQueries({ queryKey: listQueryKey });
+			queryClient.invalidateQueries({ queryKey: countQueryKey });
+			queryClient.invalidateQueries({ queryKey: itemQueryKey });
+			(mutationOptions?.onSettled)?.(data, error, variables, context);
+		},
+		...mutationOptions
+	});
+}
+
+//#endregion
+export { useCollectionCount, useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionUpdate };
+//# sourceMappingURL=use-collection.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection.mjs","names":[],"sources":["../../../src/client/hooks/use-collection.ts"],"sourcesContent":["import {\n\ttype UseMutationOptions,\n\ttype UseQueryOptions,\n\tuseMutation,\n\tuseQuery,\n} from \"@tanstack/react-query\";\nimport type { Questpie } from \"questpie\";\nimport type { QuestpieClient } from \"questpie/client\";\nimport type {\n\tRegisteredCMS,\n\tRegisteredCollectionNames,\n} from \"../builder/registry\";\nimport { useQuestpieQueryOptions } from \"./use-questpie-query-options\";\n\ntype CollectionRealtimeOptions = {\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 collection names (string if not registered)\n */\ntype ResolvedCollectionNames =\n\tRegisteredCMS extends Questpie<any> ? RegisteredCollectionNames : string;\n\n// ============================================================================\n// Collection Hooks\n// ============================================================================\n\n/**\n * Hook to fetch collection list with filters, sorting, pagination\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 } = useCollectionList(\"barbers\");\n * ```\n */\nexport function useCollectionList<K extends ResolvedCollectionNames>(\n\tcollection: K,\n\toptions?: any,\n\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\trealtimeOptions?: CollectionRealtimeOptions,\n): any {\n\tconst { queryOpts, locale } = useQuestpieQueryOptions();\n\n\tconst findOptions = {\n\t\t...options,\n\t\tlocale,\n\t};\n\n\t// Pass realtime option to query options builder - this uses streamedQuery internally\n\tconst baseQuery = (queryOpts as any).collections[collection as string].find(\n\t\tfindOptions 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 count collection items with optional filters\n *\n * More efficient than useCollectionList when you only need the count.\n * Uses dedicated count endpoint that doesn't fetch actual documents.\n *\n * @example\n * ```tsx\n * // Count all items\n * const { data: count } = useCollectionCount(\"barbers\");\n *\n * // Count with filter\n * const { data: count } = useCollectionCount(\"appointments\", {\n *   where: { status: \"pending\" }\n * });\n * ```\n */\nexport function useCollectionCount<K extends ResolvedCollectionNames>(\n\tcollection: K,\n\toptions?: { where?: any; includeDeleted?: boolean },\n\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\trealtimeOptions?: CollectionRealtimeOptions,\n): any {\n\tconst { queryOpts, locale } = useQuestpieQueryOptions();\n\n\tconst countOptions = {\n\t\t...options,\n\t\tlocale,\n\t};\n\n\t// Pass realtime option to query options builder - this uses streamedQuery internally\n\t// The reducer in tanstack-query already extracts totalDocs from the snapshot\n\tconst baseQuery = (queryOpts as any).collections[collection as string].count(\n\t\tcountOptions 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 fetch single collection item\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 } = useCollectionItem(\"barbers\", \"123\");\n * ```\n */\nexport function useCollectionItem<K extends ResolvedCollectionNames>(\n\tcollection: K,\n\tid: string,\n\toptions?: Omit<\n\t\tParameters<\n\t\t\tQuestpieClient<ResolvedCMS>[\"collections\"][K & string][\"findOne\"]\n\t\t>[0],\n\t\t\"where\"\n\t> & {\n\t\tlocaleFallback?: boolean;\n\t\twith?: Record<string, boolean>;\n\t},\n\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n): any {\n\tconst { queryOpts, locale } = useQuestpieQueryOptions();\n\n\treturn useQuery({\n\t\t...(queryOpts as any).collections[collection as string].findOne({\n\t\t\twhere: { id },\n\t\t\tlocale,\n\t\t\t...options,\n\t\t}),\n\t\t...queryOptions,\n\t});\n}\n\n/**\n * Hook to create collection item\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 } = useCollectionCreate(\"barbers\");\n * mutate({ name: \"John\", ... });\n * ```\n */\nexport function useCollectionCreate<K extends ResolvedCollectionNames>(\n\tcollection: K,\n\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n): any {\n\tconst { queryOpts, queryClient, locale } = useQuestpieQueryOptions();\n\n\tconst baseOptions = queryOpts.collections[collection as string].create();\n\tconst listQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"find\",\n\t\tlocale,\n\t]);\n\tconst countQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"count\",\n\t\tlocale,\n\t]);\n\n\treturn useMutation({\n\t\t...baseOptions,\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: listQueryKey,\n\t\t\t});\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: countQueryKey,\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\n/**\n * Hook to update collection item\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 } = useCollectionUpdate(\"barbers\");\n * mutate({ id: \"123\", data: { name: \"John\" } });\n * ```\n */\nexport function useCollectionUpdate<K extends ResolvedCollectionNames>(\n\tcollection: K,\n\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n): any {\n\tconst { queryOpts, queryClient, locale } = useQuestpieQueryOptions();\n\n\tconst baseOptions = queryOpts.collections[collection as string].update();\n\tconst listQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"find\",\n\t\tlocale,\n\t]);\n\tconst countQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"count\",\n\t\tlocale,\n\t]);\n\tconst itemQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"findOne\",\n\t\tlocale,\n\t]);\n\n\treturn useMutation({\n\t\t...baseOptions,\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: listQueryKey,\n\t\t\t});\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: countQueryKey,\n\t\t\t});\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: itemQueryKey,\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\n/**\n * Hook to delete collection item\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 } = useCollectionDelete(\"barbers\");\n * mutate(\"123\");\n * ```\n */\nexport function useCollectionDelete<K extends ResolvedCollectionNames>(\n\tcollection: K,\n\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n): any {\n\tconst { queryOpts, queryClient, locale } = useQuestpieQueryOptions();\n\n\tconst baseOptions = queryOpts.collections[collection as string].delete();\n\tconst listQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"find\",\n\t\tlocale,\n\t]);\n\tconst countQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"count\",\n\t\tlocale,\n\t]);\n\tconst itemQueryKey = queryOpts.key([\n\t\t\"collections\",\n\t\tcollection as string,\n\t\t\"findOne\",\n\t\tlocale,\n\t]);\n\n\treturn useMutation({\n\t\t...baseOptions,\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: listQueryKey,\n\t\t\t});\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: countQueryKey,\n\t\t\t});\n\t\t\tqueryClient.invalidateQueries({\n\t\t\t\tqueryKey: itemQueryKey,\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":"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"}

package/dist/client/hooks/use-current-user.d.mts

@@ -0,0 +1,57 @@
+//#region src/client/hooks/use-current-user.d.ts
+/**
+ * Current User Hooks
+ *
+ * Convenience hooks for accessing the current user from Better Auth session.
+ * These hooks use the authClient.useSession() internally.
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const user = useCurrentUser();
+ *   const isAdmin = useIsAdmin();
+ *
+ *   if (!user) return <LoginPrompt />;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{user.name}</h1>
+ *       {isAdmin && <AdminBadge />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+/**
+ * Basic user type from Better Auth session
+ * Extended by the actual CMS user schema
+ */
+interface BasicUser {
+  id: string;
+  email: string;
+  name?: string | null;
+  image?: string | null;
+  role?: string | null;
+  emailVerified?: boolean;
+  banned?: boolean;
+  banReason?: string | null;
+}
+/**
+ * Get the current authenticated user from session.
+ *
+ * Returns null if:
+ * - No auth client is configured
+ * - User is not authenticated
+ * - Session is still loading (use useSessionState for loading state)
+ *
+ * @example
+ * ```tsx
+ * const user = useCurrentUser();
+ * if (!user) return <LoginPage />;
+ * return <div>Hello {user.name}</div>;
+ * ```
+ */
+declare function useCurrentUser<TUser = BasicUser>(): TUser | null;
+//#endregion
+export { useCurrentUser };
+//# sourceMappingURL=use-current-user.d.mts.map

package/dist/client/hooks/use-current-user.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-current-user.d.mts","names":[],"sources":["../../../src/client/hooks/use-current-user.ts"],"sourcesContent":[],"mappings":";;AAkCA;AAuCA;;;;;;;;;;;;;;;;;;;;;;;;;UAvCiB,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCD,uBAAuB,cAAc"}

package/dist/client/hooks/use-current-user.mjs

@@ -0,0 +1,79 @@
+import { useAuthClientSafe } from "./use-auth.mjs";
+
+//#region src/client/hooks/use-current-user.ts
+/**
+* Current User Hooks
+*
+* Convenience hooks for accessing the current user from Better Auth session.
+* These hooks use the authClient.useSession() internally.
+*
+* @example
+* ```tsx
+* function UserProfile() {
+*   const user = useCurrentUser();
+*   const isAdmin = useIsAdmin();
+*
+*   if (!user) return <LoginPrompt />;
+*
+*   return (
+*     <div>
+*       <h1>{user.name}</h1>
+*       {isAdmin && <AdminBadge />}
+*     </div>
+*   );
+* }
+* ```
+*/
+/**
+* Get the current authenticated user from session.
+*
+* Returns null if:
+* - No auth client is configured
+* - User is not authenticated
+* - Session is still loading (use useSessionState for loading state)
+*
+* @example
+* ```tsx
+* const user = useCurrentUser();
+* if (!user) return <LoginPage />;
+* return <div>Hello {user.name}</div>;
+* ```
+*/
+function useCurrentUser() {
+	const authClient = useAuthClientSafe();
+	if (!authClient) return null;
+	const { data: session } = authClient.useSession();
+	return session?.user ?? null;
+}
+/**
+* Get full session state including loading and error.
+*
+* @example
+* ```tsx
+* const { user, isPending, error } = useSessionState();
+*
+* if (isPending) return <Loading />;
+* if (error) return <Error message={error.message} />;
+* if (!user) return <LoginPage />;
+*
+* return <Dashboard user={user} />;
+* ```
+*/
+function useSessionState() {
+	const authClient = useAuthClientSafe();
+	if (!authClient) return {
+		user: null,
+		isPending: false,
+		error: null
+	};
+	const { data: session, isPending, error } = authClient.useSession();
+	return {
+		user: session?.user ?? null,
+		isPending,
+		error: error ?? null
+	};
+}
+
+//#endregion
+export { useCurrentUser, useSessionState };
+//# sourceMappingURL=use-current-user.mjs.map

package/dist/client/hooks/use-current-user.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-current-user.mjs","names":[],"sources":["../../../src/client/hooks/use-current-user.ts"],"sourcesContent":["/**\n * Current User Hooks\n *\n * Convenience hooks for accessing the current user from Better Auth session.\n * These hooks use the authClient.useSession() internally.\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const user = useCurrentUser();\n *   const isAdmin = useIsAdmin();\n *\n *   if (!user) return <LoginPrompt />;\n *\n *   return (\n *     <div>\n *       <h1>{user.name}</h1>\n *       {isAdmin && <AdminBadge />}\n *     </div>\n *   );\n * }\n * ```\n */\n\nimport { useAuthClientSafe } from \"./use-auth\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Basic user type from Better Auth session\n * Extended by the actual CMS user schema\n */\nexport interface BasicUser {\n  id: string;\n  email: string;\n  name?: string | null;\n  image?: string | null;\n  role?: string | null;\n  emailVerified?: boolean;\n  banned?: boolean;\n  banReason?: string | null;\n}\n\n/**\n * Session state returned by useSession hooks\n */\nexport interface SessionState<TUser = BasicUser> {\n  user: TUser | null;\n  isPending: boolean;\n  error: Error | null;\n}\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\n/**\n * Get the current authenticated user from session.\n *\n * Returns null if:\n * - No auth client is configured\n * - User is not authenticated\n * - Session is still loading (use useSessionState for loading state)\n *\n * @example\n * ```tsx\n * const user = useCurrentUser();\n * if (!user) return <LoginPage />;\n * return <div>Hello {user.name}</div>;\n * ```\n */\nexport function useCurrentUser<TUser = BasicUser>(): TUser | null {\n  const authClient = useAuthClientSafe();\n\n  if (!authClient) {\n    return null;\n  }\n\n  const { data: session } = authClient.useSession();\n  return (session?.user as TUser) ?? null;\n}\n\n/**\n * Get full session state including loading and error.\n *\n * @example\n * ```tsx\n * const { user, isPending, error } = useSessionState();\n *\n * if (isPending) return <Loading />;\n * if (error) return <Error message={error.message} />;\n * if (!user) return <LoginPage />;\n *\n * return <Dashboard user={user} />;\n * ```\n */\nexport function useSessionState<TUser = BasicUser>(): SessionState<TUser> {\n  const authClient = useAuthClientSafe();\n\n  if (!authClient) {\n    return {\n      user: null,\n      isPending: false,\n      error: null,\n    };\n  }\n\n  const { data: session, isPending, error } = authClient.useSession();\n\n  return {\n    user: (session?.user as TUser) ?? null,\n    isPending,\n    error: error ?? null,\n  };\n}\n\n/**\n * Check if the current user is authenticated.\n *\n * Returns false while session is loading.\n * For loading-aware check, use useSessionState().\n *\n * @example\n * ```tsx\n * const isAuthenticated = useIsAuthenticated();\n * if (!isAuthenticated) return <LoginButton />;\n * ```\n */\nexport function useIsAuthenticated(): boolean {\n  const authClient = useAuthClientSafe();\n\n  if (!authClient) {\n    return false;\n  }\n\n  const { data: session, isPending } = authClient.useSession();\n  return !isPending && session?.user != null;\n}\n\n/**\n * Check if the current user has the admin role.\n *\n * @example\n * ```tsx\n * const isAdmin = useIsAdmin();\n * if (!isAdmin) return <AccessDenied />;\n * ```\n */\nexport function useIsAdmin(): boolean {\n  const user = useCurrentUser();\n  return user?.role === \"admin\";\n}\n\n/**\n * Check if the current user has a specific role.\n *\n * @example\n * ```tsx\n * const canEdit = useHasRole(\"admin\") || useHasRole(\"editor\");\n * ```\n */\nexport function useHasRole(role: string): boolean {\n  const user = useCurrentUser();\n  return user?.role === role;\n}\n\n/**\n * Check if the current user has any of the specified roles.\n *\n * @example\n * ```tsx\n * const canManageUsers = useHasAnyRole([\"admin\", \"moderator\"]);\n * ```\n */\nexport function useHasAnyRole(roles: string[]): boolean {\n  const user = useCurrentUser();\n  return user?.role != null && roles.includes(user.role);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,SAAgB,iBAAkD;CAChE,MAAM,aAAa,mBAAmB;AAEtC,KAAI,CAAC,WACH,QAAO;CAGT,MAAM,EAAE,MAAM,YAAY,WAAW,YAAY;AACjD,QAAQ,SAAS,QAAkB;;;;;;;;;;;;;;;;AAiBrC,SAAgB,kBAA0D;CACxE,MAAM,aAAa,mBAAmB;AAEtC,KAAI,CAAC,WACH,QAAO;EACL,MAAM;EACN,WAAW;EACX,OAAO;EACR;CAGH,MAAM,EAAE,MAAM,SAAS,WAAW,UAAU,WAAW,YAAY;AAEnE,QAAO;EACL,MAAO,SAAS,QAAkB;EAClC;EACA,OAAO,SAAS;EACjB"}