@questpie/admin 1.1.1 → 2.0.0

package/dist/client/hooks/typed-hooks.d.mts

@@ -0,0 +1,84 @@
+import { UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+import { Questpie } from "questpie";
+
+//#region src/client/hooks/typed-hooks.d.ts
+
+/**
+ * Extract collection names from a Questpie app
+ */
+type CollectionNames<TApp extends Questpie<any>> = keyof TApp["config"]["collections"] & string;
+/**
+ * Extract global names from a Questpie app
+ */
+type GlobalNames<TApp extends Questpie<any>> = TApp extends Questpie<infer TConfig> ? keyof TConfig["globals"] & string : never;
+interface TypedHooks<TApp extends Questpie<any>> {
+  /**
+   * Hook to fetch collection list with filters, sorting, pagination
+   */
+  useCollectionList: <K extends CollectionNames<TApp>>(collection: K, options?: any, queryOptions?: Omit<UseQueryOptions, "queryKey" | "queryFn">) => any;
+  /**
+   * Hook to count collection items with optional filters
+   */
+  useCollectionCount: <K extends CollectionNames<TApp>>(collection: K, options?: {
+    where?: any;
+    includeDeleted?: boolean;
+  }, queryOptions?: Omit<UseQueryOptions, "queryKey" | "queryFn">) => any;
+  /**
+   * Hook to fetch single collection item
+   */
+  useCollectionItem: <K extends CollectionNames<TApp>>(collection: K, id: string, options?: {
+    localeFallback?: boolean;
+    with?: Record<string, boolean>;
+  }, queryOptions?: Omit<UseQueryOptions, "queryKey" | "queryFn">) => any;
+  /**
+   * Hook to create collection item
+   */
+  useCollectionCreate: <K extends CollectionNames<TApp>>(collection: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">) => any;
+  /**
+   * Hook to update collection item
+   */
+  useCollectionUpdate: <K extends CollectionNames<TApp>>(collection: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">) => any;
+  /**
+   * Hook to delete collection item
+   */
+  useCollectionDelete: <K extends CollectionNames<TApp>>(collection: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">) => any;
+  /**
+   * Hook to fetch global settings
+   */
+  useGlobal: <K extends GlobalNames<TApp>>(globalName: K, options?: any, queryOptions?: Omit<UseQueryOptions, "queryKey" | "queryFn">) => any;
+  /**
+   * Hook to update global settings
+   */
+  useGlobalUpdate: <K extends GlobalNames<TApp>>(globalName: K, mutationOptions?: Omit<UseMutationOptions, "mutationFn">) => any;
+}
+/**
+ * Create type-safe hooks for collections and globals.
+ *
+ * This factory creates hooks that are typed to your specific CMS configuration,
+ * providing autocomplete for collection/global names without module augmentation.
+ *
+ * @example
+ * ```ts
+ * import type { AppCMS } from './server/cms';
+ * import { createTypedHooks } from '@questpie/admin/client';
+ *
+ * // Create typed hooks
+ * export const {
+ *   useCollectionList,
+ *   useCollectionItem,
+ *   useCollectionCreate,
+ *   useCollectionUpdate,
+ *   useCollectionDelete,
+ *   useGlobal,
+ *   useGlobalUpdate,
+ * } = createTypedHooks<AppCMS>();
+ *
+ * // Usage - collection names are autocompleted!
+ * const { data } = useCollectionList("barbers");
+ * const { data: settings } = useGlobal("siteSettings");
+ * ```
+ */
+declare function createTypedHooks<TApp extends Questpie<any>>(): TypedHooks<TApp>;
+//#endregion
+export { TypedHooks, createTypedHooks };
+//# sourceMappingURL=typed-hooks.d.mts.map

package/dist/client/hooks/typed-hooks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-hooks.d.mts","names":[],"sources":["../../../src/client/hooks/typed-hooks.ts"],"sourcesContent":[],"mappings":";;;;;;;;KA6CK,eAkD4C,CAAA,aAlDf,QAkDe,CAAA,GAAA,CAAA,CAAA,GAAA,MAjD1C,IAiD0C,CAAA,QAAA,CAAA,CAAA,aAAA,CAAA,GAAA,MAAA;;;;KA5C5C,WA8Ce,CAAA,aA9CU,QA8CV,CAAA,GAAA,CAAA,CAAA,GA7CnB,IA6CmB,SA7CN,QA6CM,CAAA,KAAA,QAAA,CAAA,GAAA,MA5CV,OA4CU,CAAA,SAAA,CAAA,GAAA,MAAA,GAAA,KAAA;AAM6B,UA3ChC,UA2CgC,CAAA,aA3CR,QA2CQ,CAAA,GAAA,CAAA,CAAA,CAAA;EAAhB;;;EAEb,iBAAA,EAAA,CAAA,UAzCW,eAyCX,CAzC2B,IAyC3B,CAAA,CAAA,CAAA,UAAA,EAxCN,CAwCM,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,YAAA,CAAA,EAtCH,IAsCG,CAtCE,eAsCF,EAAA,UAAA,GAAA,SAAA,CAAA,EAAA,GAAA,GAAA;EAM6B;;;EAExB,kBAAA,EAAA,CAAA,UAxCO,eAwCP,CAxCuB,IAwCvB,CAAA,CAAA,CAAA,UAAA,EAvCX,CAuCW,EAAA,OAMF,CANE,EAAA;IAAL,KAAA,CAAA,EAAA,GAAA;IAMe,cAAA,CAAA,EAAA,OAAA;EAAZ,CAAA,EAAA,YAAA,CAAA,EA3CN,IA2CM,CA3CD,eA2CC,EAAA,UAAA,GAAA,SAAA,CAAA,EAAA,GAAA,GAAA;EACT;;;EAQ2B,iBAAA,EAAA,CAAA,UA9CV,eA8CU,CA9CM,IA8CN,CAAA,CAAA,CAAA,UAAA,EA7C3B,CA6C2B,EAAA,EAAA,EAAA,MAAA,EAAA,OAEhB,CAFgB,EAAA;IAAZ,cAAA,CAAA,EAAA,OAAA;IACf,IAAA,CAAA,EA1CJ,MA0CI,CAAA,MAAA,EAAA,OAAA,CAAA;EACW,CAAA,EAAA,YAAA,CAAA,EAzCR,IAyCQ,CAzCH,eAyCG,EAAA,UAAA,GAAA,SAAA,CAAA,EAAA,GAAA,GAAA;EAAL;;AAmCpB;EACc,mBAAA,EAAA,CAAA,UAvEmB,eAuEnB,CAvEmC,IAuEnC,CAAA,CAAA,CAAA,UAAA,EAtEA,CAsEA,EAAA,eAAA,CAAA,EArEM,IAqEN,CArEW,kBAqEX,EAAA,YAAA,CAAA,EAAA,GAAA,GAAA;EACE;;;kCAhEiB,gBAAgB,mBACnC,qBACM,KAAK;;;;kCAMQ,gBAAgB,mBACnC,qBACM,KAAK;;;;wBAMF,YAAY,mBACrB,iCAEG,KAAK;;;;8BAMO,YAAY,mBAC3B,qBACM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmCT,8BACF,kBACT,WAAW"}

package/dist/client/hooks/typed-hooks.mjs

@@ -0,0 +1,272 @@
+import { selectClient, selectContentLocale, useAdminStore } from "../runtime/provider.mjs";
+import { useScopedLocale } from "../runtime/locale-scope.mjs";
+import { createQuestpieQueryOptions } from "@questpie/tanstack-query";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+
+//#region src/client/hooks/typed-hooks.ts
+/**
+* Typed Hooks Factory
+*
+* Creates type-safe React hooks for collections and globals without module augmentation.
+* This is the recommended approach for new projects.
+*
+* @example
+* ```ts
+* // In your admin setup file:
+* import type { AppCMS } from './server/cms';
+* import { createTypedHooks } from '@questpie/admin/client';
+*
+* export const {
+*   useCollectionList,
+*   useCollectionItem,
+*   useCollectionCreate,
+*   useCollectionUpdate,
+*   useCollectionDelete,
+*   useCollectionCount,
+*   useGlobal,
+*   useGlobalUpdate,
+* } = createTypedHooks<AppCMS>();
+* ```
+*/
+/**
+* Create type-safe hooks for collections and globals.
+*
+* This factory creates hooks that are typed to your specific CMS configuration,
+* providing autocomplete for collection/global names without module augmentation.
+*
+* @example
+* ```ts
+* import type { AppCMS } from './server/cms';
+* import { createTypedHooks } from '@questpie/admin/client';
+*
+* // Create typed hooks
+* export const {
+*   useCollectionList,
+*   useCollectionItem,
+*   useCollectionCreate,
+*   useCollectionUpdate,
+*   useCollectionDelete,
+*   useGlobal,
+*   useGlobalUpdate,
+* } = createTypedHooks<AppCMS>();
+*
+* // Usage - collection names are autocompleted!
+* const { data } = useCollectionList("barbers");
+* const { data: settings } = useGlobal("siteSettings");
+* ```
+*/
+function createTypedHooks() {
+	function useCollectionList(collection, options, queryOptions) {
+		const client = useAdminStore(selectClient);
+		const { locale: contentLocale } = useScopedLocale();
+		return useQuery({
+			...createQuestpieQueryOptions(client, {
+				keyPrefix: ["questpie", "collections"],
+				locale: contentLocale
+			}).collections[collection].find({
+				...options,
+				locale: contentLocale
+			}),
+			...queryOptions
+		});
+	}
+	function useCollectionCount(collection, options, queryOptions) {
+		const client = useAdminStore(selectClient);
+		const { locale: contentLocale } = useScopedLocale();
+		return useQuery({
+			...createQuestpieQueryOptions(client, {
+				keyPrefix: ["questpie", "collections"],
+				locale: contentLocale
+			}).collections[collection].count({
+				...options,
+				locale: contentLocale
+			}),
+			...queryOptions
+		});
+	}
+	function useCollectionItem(collection, id, options, queryOptions) {
+		const client = useAdminStore(selectClient);
+		const { locale: contentLocale } = useScopedLocale();
+		return useQuery({
+			...createQuestpieQueryOptions(client, {
+				keyPrefix: ["questpie", "collections"],
+				locale: contentLocale
+			}).collections[collection].findOne({
+				where: { id },
+				locale: contentLocale,
+				...options
+			}),
+			...queryOptions
+		});
+	}
+	function useCollectionCreate(collection, mutationOptions) {
+		const client = useAdminStore(selectClient);
+		const { locale: contentLocale } = useScopedLocale();
+		const queryClient = useQueryClient();
+		const queryOpts = createQuestpieQueryOptions(client, {
+			keyPrefix: ["questpie", "collections"],
+			locale: contentLocale
+		});
+		const baseOptions = queryOpts.collections[collection].create();
+		const listQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"find",
+			contentLocale
+		]);
+		const countQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"count",
+			contentLocale
+		]);
+		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
+		});
+	}
+	function useCollectionUpdate(collection, mutationOptions) {
+		const client = useAdminStore(selectClient);
+		const { locale: contentLocale } = useScopedLocale();
+		const queryClient = useQueryClient();
+		const queryOpts = createQuestpieQueryOptions(client, {
+			keyPrefix: ["questpie", "collections"],
+			locale: contentLocale
+		});
+		const baseOptions = queryOpts.collections[collection].update();
+		const listQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"find",
+			contentLocale
+		]);
+		const countQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"count",
+			contentLocale
+		]);
+		const itemQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"findOne",
+			contentLocale
+		]);
+		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
+		});
+	}
+	function useCollectionDelete(collection, mutationOptions) {
+		const client = useAdminStore(selectClient);
+		const { locale: contentLocale } = useScopedLocale();
+		const queryClient = useQueryClient();
+		const queryOpts = createQuestpieQueryOptions(client, {
+			keyPrefix: ["questpie", "collections"],
+			locale: contentLocale
+		});
+		const baseOptions = queryOpts.collections[collection].delete();
+		const listQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"find",
+			contentLocale
+		]);
+		const countQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"count",
+			contentLocale
+		]);
+		const itemQueryKey = queryOpts.key([
+			"collections",
+			collection,
+			"findOne",
+			contentLocale
+		]);
+		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
+		});
+	}
+	function useGlobal(globalName, options, queryOptions) {
+		const client = useAdminStore(selectClient);
+		const contentLocale = useAdminStore(selectContentLocale);
+		return useQuery({
+			...createQuestpieQueryOptions(client, {
+				keyPrefix: ["questpie", "globals"],
+				locale: contentLocale
+			}).globals[globalName].get({
+				...options,
+				locale: contentLocale
+			}),
+			...queryOptions
+		});
+	}
+	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
+		});
+	}
+	return {
+		useCollectionList,
+		useCollectionCount,
+		useCollectionItem,
+		useCollectionCreate,
+		useCollectionUpdate,
+		useCollectionDelete,
+		useGlobal,
+		useGlobalUpdate
+	};
+}
+
+//#endregion
+export { createTypedHooks };
+//# sourceMappingURL=typed-hooks.mjs.map

package/dist/client/hooks/typed-hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-hooks.mjs","names":[],"sources":["../../../src/client/hooks/typed-hooks.ts"],"sourcesContent":["/**\n * Typed Hooks Factory\n *\n * Creates type-safe React hooks for collections and globals without module augmentation.\n * This is the recommended approach for new projects.\n *\n * @example\n * ```ts\n * // In your admin setup file:\n * import type { AppCMS } from './server/cms';\n * import { createTypedHooks } from '@questpie/admin/client';\n *\n * export const {\n *   useCollectionList,\n *   useCollectionItem,\n *   useCollectionCreate,\n *   useCollectionUpdate,\n *   useCollectionDelete,\n *   useCollectionCount,\n *   useGlobal,\n *   useGlobalUpdate,\n * } = createTypedHooks<AppCMS>();\n * ```\n */\n\nimport { 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 { selectClient, useAdminStore, useScopedLocale } from \"../runtime\";\nimport { selectContentLocale } from \"../runtime/provider\";\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Extract collection names from a Questpie app\n */\ntype CollectionNames<TApp extends Questpie<any>> =\n\tkeyof TApp[\"config\"][\"collections\"] & string;\n\n/**\n * Extract global names from a Questpie app\n */\ntype GlobalNames<TApp extends Questpie<any>> =\n\tTApp extends Questpie<infer TConfig>\n\t\t? keyof TConfig[\"globals\"] & string\n\t\t: never;\n\n// ============================================================================\n// Typed Hooks Interface\n// ============================================================================\n\nexport interface TypedHooks<TApp extends Questpie<any>> {\n\t/**\n\t * Hook to fetch collection list with filters, sorting, pagination\n\t */\n\tuseCollectionList: <K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\toptions?: any,\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t) => any;\n\n\t/**\n\t * Hook to count collection items with optional filters\n\t */\n\tuseCollectionCount: <K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\toptions?: { where?: any; includeDeleted?: boolean },\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t) => any;\n\n\t/**\n\t * Hook to fetch single collection item\n\t */\n\tuseCollectionItem: <K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tid: string,\n\t\toptions?: {\n\t\t\tlocaleFallback?: boolean;\n\t\t\twith?: Record<string, boolean>;\n\t\t},\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t) => any;\n\n\t/**\n\t * Hook to create collection item\n\t */\n\tuseCollectionCreate: <K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t) => any;\n\n\t/**\n\t * Hook to update collection item\n\t */\n\tuseCollectionUpdate: <K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t) => any;\n\n\t/**\n\t * Hook to delete collection item\n\t */\n\tuseCollectionDelete: <K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t) => any;\n\n\t/**\n\t * Hook to fetch global settings\n\t */\n\tuseGlobal: <K extends GlobalNames<TApp>>(\n\t\tglobalName: K,\n\t\toptions?: any,\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t) => any;\n\n\t/**\n\t * Hook to update global settings\n\t */\n\tuseGlobalUpdate: <K extends GlobalNames<TApp>>(\n\t\tglobalName: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t) => any;\n}\n\n// ============================================================================\n// Factory Implementation\n// ============================================================================\n\n/**\n * Create type-safe hooks for collections and globals.\n *\n * This factory creates hooks that are typed to your specific CMS configuration,\n * providing autocomplete for collection/global names without module augmentation.\n *\n * @example\n * ```ts\n * import type { AppCMS } from './server/cms';\n * import { createTypedHooks } from '@questpie/admin/client';\n *\n * // Create typed hooks\n * export const {\n *   useCollectionList,\n *   useCollectionItem,\n *   useCollectionCreate,\n *   useCollectionUpdate,\n *   useCollectionDelete,\n *   useGlobal,\n *   useGlobalUpdate,\n * } = createTypedHooks<AppCMS>();\n *\n * // Usage - collection names are autocompleted!\n * const { data } = useCollectionList(\"barbers\");\n * const { data: settings } = useGlobal(\"siteSettings\");\n * ```\n */\nexport function createTypedHooks<\n\tTApp extends Questpie<any>,\n>(): TypedHooks<TApp> {\n\t// Collection list hook\n\tfunction useCollectionList<K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\toptions?: any,\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst { locale: contentLocale } = useScopedLocale();\n\t\tconst keyPrefix = [\"questpie\", \"collections\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(\n\t\t\tclient as any,\n\t\t\t{\n\t\t\t\tkeyPrefix,\n\t\t\t\tlocale: contentLocale,\n\t\t\t} as any,\n\t\t);\n\n\t\treturn useQuery({\n\t\t\t...(queryOpts as any).collections[collection as string].find({\n\t\t\t\t...options,\n\t\t\t\tlocale: contentLocale,\n\t\t\t} as any),\n\t\t\t...queryOptions,\n\t\t});\n\t}\n\n\t// Collection count hook\n\tfunction useCollectionCount<K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\toptions?: { where?: any; includeDeleted?: boolean },\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst { locale: contentLocale } = useScopedLocale();\n\t\tconst keyPrefix = [\"questpie\", \"collections\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(\n\t\t\tclient as any,\n\t\t\t{\n\t\t\t\tkeyPrefix,\n\t\t\t\tlocale: contentLocale,\n\t\t\t} as any,\n\t\t);\n\n\t\treturn useQuery({\n\t\t\t...(queryOpts as any).collections[collection as string].count({\n\t\t\t\t...options,\n\t\t\t\tlocale: contentLocale,\n\t\t\t} as any),\n\t\t\t...queryOptions,\n\t\t});\n\t}\n\n\t// Collection item hook\n\tfunction useCollectionItem<K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tid: string,\n\t\toptions?: {\n\t\t\tlocaleFallback?: boolean;\n\t\t\twith?: Record<string, boolean>;\n\t\t},\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst { locale: contentLocale } = useScopedLocale();\n\t\tconst keyPrefix = [\"questpie\", \"collections\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(client as any, {\n\t\t\tkeyPrefix,\n\t\t\tlocale: contentLocale,\n\t\t});\n\n\t\treturn useQuery({\n\t\t\t...(queryOpts as any).collections[collection as string].findOne({\n\t\t\t\twhere: { id },\n\t\t\t\tlocale: contentLocale,\n\t\t\t\t...options,\n\t\t\t}),\n\t\t\t...queryOptions,\n\t\t});\n\t}\n\n\t// Collection create hook\n\tfunction useCollectionCreate<K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst { locale: contentLocale } = useScopedLocale();\n\t\tconst queryClient = useQueryClient();\n\t\tconst keyPrefix = [\"questpie\", \"collections\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(client as any, {\n\t\t\tkeyPrefix,\n\t\t\tlocale: contentLocale,\n\t\t});\n\n\t\tconst baseOptions = queryOpts.collections[collection as string].create();\n\t\tconst listQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"find\",\n\t\t\tcontentLocale,\n\t\t]);\n\t\tconst countQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"count\",\n\t\t\tcontentLocale,\n\t\t]);\n\n\t\treturn useMutation({\n\t\t\t...baseOptions,\n\t\t\tonSuccess: (data: any, variables: any, context: any) => {\n\t\t\t\t(mutationOptions?.onSuccess as any)?.(data, variables, context);\n\t\t\t},\n\t\t\tonSettled: (data: any, error: any, variables: any, context: any) => {\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: listQueryKey,\n\t\t\t\t});\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: countQueryKey,\n\t\t\t\t});\n\t\t\t\t(mutationOptions?.onSettled as any)?.(data, error, variables, context);\n\t\t\t},\n\t\t\t...mutationOptions,\n\t\t} as any);\n\t}\n\n\t// Collection update hook\n\tfunction useCollectionUpdate<K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst { locale: contentLocale } = useScopedLocale();\n\t\tconst queryClient = useQueryClient();\n\t\tconst keyPrefix = [\"questpie\", \"collections\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(client as any, {\n\t\t\tkeyPrefix,\n\t\t\tlocale: contentLocale,\n\t\t});\n\n\t\tconst baseOptions = queryOpts.collections[collection as string].update();\n\t\tconst listQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"find\",\n\t\t\tcontentLocale,\n\t\t]);\n\t\tconst countQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"count\",\n\t\t\tcontentLocale,\n\t\t]);\n\t\tconst itemQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"findOne\",\n\t\t\tcontentLocale,\n\t\t]);\n\n\t\treturn useMutation({\n\t\t\t...baseOptions,\n\t\t\tonSuccess: (data: any, variables: any, context: any) => {\n\t\t\t\t(mutationOptions?.onSuccess as any)?.(data, variables, context);\n\t\t\t},\n\t\t\tonSettled: (data: any, error: any, variables: any, context: any) => {\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: listQueryKey,\n\t\t\t\t});\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: countQueryKey,\n\t\t\t\t});\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: itemQueryKey,\n\t\t\t\t});\n\t\t\t\t(mutationOptions?.onSettled as any)?.(data, error, variables, context);\n\t\t\t},\n\t\t\t...mutationOptions,\n\t\t} as any);\n\t}\n\n\t// Collection delete hook\n\tfunction useCollectionDelete<K extends CollectionNames<TApp>>(\n\t\tcollection: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst { locale: contentLocale } = useScopedLocale();\n\t\tconst queryClient = useQueryClient();\n\t\tconst keyPrefix = [\"questpie\", \"collections\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(client as any, {\n\t\t\tkeyPrefix,\n\t\t\tlocale: contentLocale,\n\t\t});\n\n\t\tconst baseOptions = queryOpts.collections[collection as string].delete();\n\t\tconst listQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"find\",\n\t\t\tcontentLocale,\n\t\t]);\n\t\tconst countQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"count\",\n\t\t\tcontentLocale,\n\t\t]);\n\t\tconst itemQueryKey = queryOpts.key([\n\t\t\t\"collections\",\n\t\t\tcollection as string,\n\t\t\t\"findOne\",\n\t\t\tcontentLocale,\n\t\t]);\n\n\t\treturn useMutation({\n\t\t\t...baseOptions,\n\t\t\tonSuccess: (data: any, variables: any, context: any) => {\n\t\t\t\t(mutationOptions?.onSuccess as any)?.(data, variables, context);\n\t\t\t},\n\t\t\tonSettled: (data: any, error: any, variables: any, context: any) => {\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: listQueryKey,\n\t\t\t\t});\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: countQueryKey,\n\t\t\t\t});\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: itemQueryKey,\n\t\t\t\t});\n\t\t\t\t(mutationOptions?.onSettled as any)?.(data, error, variables, context);\n\t\t\t},\n\t\t\t...mutationOptions,\n\t\t} as any);\n\t}\n\n\t// Global hook\n\tfunction useGlobal<K extends GlobalNames<TApp>>(\n\t\tglobalName: K,\n\t\toptions?: any,\n\t\tqueryOptions?: Omit<UseQueryOptions, \"queryKey\" | \"queryFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst contentLocale = useAdminStore(selectContentLocale);\n\t\tconst keyPrefix = [\"questpie\", \"globals\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(\n\t\t\tclient as any,\n\t\t\t{\n\t\t\t\tkeyPrefix,\n\t\t\t\tlocale: contentLocale,\n\t\t\t} as any,\n\t\t);\n\n\t\treturn useQuery({\n\t\t\t...(queryOpts as any).globals[globalName as string].get({\n\t\t\t\t...options,\n\t\t\t\tlocale: contentLocale,\n\t\t\t} as any),\n\t\t\t...queryOptions,\n\t\t});\n\t}\n\n\t// Global update hook\n\tfunction useGlobalUpdate<K extends GlobalNames<TApp>>(\n\t\tglobalName: K,\n\t\tmutationOptions?: Omit<UseMutationOptions, \"mutationFn\">,\n\t): any {\n\t\tconst client = useAdminStore(selectClient);\n\t\tconst contentLocale = useAdminStore(selectContentLocale);\n\t\tconst queryClient = useQueryClient();\n\t\tconst keyPrefix = [\"questpie\", \"globals\"] as const;\n\t\tconst queryOpts = createQuestpieQueryOptions(\n\t\t\tclient as any,\n\t\t\t{\n\t\t\t\tkeyPrefix,\n\t\t\t\tlocale: contentLocale,\n\t\t\t} as any,\n\t\t);\n\n\t\tconst globalQueryKey = queryOpts.key([\n\t\t\t\"globals\",\n\t\t\tglobalName as string,\n\t\t\t\"get\",\n\t\t\tcontentLocale,\n\t\t]);\n\n\t\treturn useMutation({\n\t\t\t...(queryOpts as any).globals[globalName as string].update(),\n\t\t\tonSuccess: (data: any, variables: any, context: any) => {\n\t\t\t\t(mutationOptions?.onSuccess as any)?.(data, variables, context);\n\t\t\t},\n\t\t\tonSettled: (data: any, error: any, variables: any, context: any) => {\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: globalQueryKey,\n\t\t\t\t});\n\t\t\t\t(mutationOptions?.onSettled as any)?.(data, error, variables, context);\n\t\t\t},\n\t\t\t...mutationOptions,\n\t\t} as any);\n\t}\n\n\treturn {\n\t\tuseCollectionList,\n\t\tuseCollectionCount,\n\t\tuseCollectionItem,\n\t\tuseCollectionCreate,\n\t\tuseCollectionUpdate,\n\t\tuseCollectionDelete,\n\t\tuseGlobal,\n\t\tuseGlobalUpdate,\n\t};\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,201 @@
+"use client";
+
+import { getDefaultActionsConfig } from "../builder/types/action-registry.mjs";
+import { useTranslation } from "../i18n/hooks.mjs";
+import { selectBasePath, selectClient, selectContentLocale, selectNavigate, useAdminStore } from "../runtime/provider.mjs";
+import { createQuestpieQueryOptions } from "@questpie/tanstack-query";
+import { useQueryClient } from "@tanstack/react-query";
+import * as React$1 from "react";
+import { toast } from "sonner";
+
+//#region src/client/hooks/use-action.ts
+/**
+* useAction Hook
+*
+* Provides action helpers and state management for collection actions.
+* Handles action execution, navigation, and API calls.
+*/
+/** Query key prefix for CMS queries (must match use-collection.ts) */
+const QUERY_KEY_PREFIX = ["questpie", "collections"];
+/**
+* Hook to create action helpers for a collection
+*
+* @example
+* ```tsx
+* const { helpers } = useActionHelpers({ collection: "posts" });
+*
+* return (
+*   <HeaderActions
+*     actions={headerActions}
+*     collection="posts"
+*     helpers={helpers}
+*   />
+* );
+* ```
+*/
+function useActionHelpers({ collection, onRefresh }) {
+	const basePath = useAdminStore(selectBasePath);
+	const navigate = useAdminStore(selectNavigate);
+	const client = useAdminStore(selectClient);
+	const contentLocale = useAdminStore(selectContentLocale);
+	const queryClient = useQueryClient();
+	const { t } = useTranslation();
+	const queryOpts = React$1.useMemo(() => createQuestpieQueryOptions(client, {
+		keyPrefix: QUERY_KEY_PREFIX,
+		locale: contentLocale
+	}), [client, contentLocale]);
+	return { helpers: React$1.useMemo(() => ({
+		navigate,
+		toast: {
+			success: toast.success,
+			error: toast.error,
+			info: toast.info,
+			warning: toast.warning
+		},
+		t,
+		invalidateCollection: async (targetCollection) => {
+			const col = targetCollection || collection;
+			await queryClient.invalidateQueries({ queryKey: queryOpts.key([
+				"collections",
+				col,
+				"find",
+				contentLocale
+			]) });
+			await queryClient.invalidateQueries({ queryKey: queryOpts.key([
+				"collections",
+				col,
+				"count",
+				contentLocale
+			]) });
+			onRefresh?.();
+		},
+		invalidateItem: async (itemId, targetCollection) => {
+			const col = targetCollection || collection;
+			await queryClient.invalidateQueries({ queryKey: queryOpts.key([
+				"collections",
+				col,
+				"findOne",
+				contentLocale,
+				{ id: itemId }
+			]) });
+			await queryClient.invalidateQueries({ queryKey: queryOpts.key([
+				"collections",
+				col,
+				"find",
+				contentLocale
+			]) });
+		},
+		invalidateAll: async () => {
+			await queryClient.invalidateQueries({ queryKey: [...QUERY_KEY_PREFIX] });
+			onRefresh?.();
+		},
+		refresh: () => {
+			queryClient.invalidateQueries({ queryKey: queryOpts.key([
+				"collections",
+				collection,
+				"find",
+				contentLocale
+			]) });
+			queryClient.invalidateQueries({ queryKey: queryOpts.key([
+				"collections",
+				collection,
+				"count",
+				contentLocale
+			]) });
+			onRefresh?.();
+		},
+		closeDialog: () => {},
+		basePath
+	}), [
+		navigate,
+		queryClient,
+		queryOpts,
+		collection,
+		contentLocale,
+		onRefresh,
+		basePath,
+		t
+	]) };
+}
+/**
+* Hook to manage collection actions with dialog state
+*
+* @example
+* ```tsx
+* const {
+*   helpers,
+*   actions,
+*   dialogAction,
+*   dialogItem,
+*   openDialog,
+*   closeDialog,
+* } = useActions({
+*   collection: "posts",
+*   actionsConfig: config.actions,
+* });
+*
+* return (
+*   <>
+*     <HeaderActions
+*       actions={actions.header}
+*       collection="posts"
+*       helpers={helpers}
+*       onOpenDialog={openDialog}
+*     />
+*
+*     {dialogAction && (
+*       <ActionDialog
+*         open={!!dialogAction}
+*         onOpenChange={(open) => !open && closeDialog()}
+*         action={dialogAction}
+*         collection="posts"
+*         item={dialogItem}
+*         helpers={helpers}
+*       />
+*     )}
+*   </>
+* );
+* ```
+*/
+function useActions({ collection, actionsConfig, onRefresh }) {
+	const [dialogAction, setDialogAction] = React$1.useState(null);
+	const [dialogItem, setDialogItem] = React$1.useState(null);
+	const defaultActions = React$1.useMemo(() => getDefaultActionsConfig(), []);
+	const actions = React$1.useMemo(() => ({
+		header: actionsConfig?.header ?? defaultActions.header ?? {
+			primary: [],
+			secondary: []
+		},
+		bulk: actionsConfig?.bulk ?? defaultActions.bulk ?? []
+	}), [actionsConfig, defaultActions]);
+	const closeDialog = React$1.useCallback(() => {
+		setDialogAction(null);
+		setDialogItem(null);
+	}, []);
+	const { helpers: baseHelpers } = useActionHelpers({
+		collection,
+		onRefresh: () => {
+			onRefresh?.();
+		}
+	});
+	return {
+		helpers: React$1.useMemo(() => ({
+			...baseHelpers,
+			closeDialog
+		}), [baseHelpers, closeDialog]),
+		actions,
+		dialogAction,
+		setDialogAction,
+		dialogItem,
+		setDialogItem,
+		openDialog: React$1.useCallback((action, item) => {
+			setDialogAction(action);
+			setDialogItem(item ?? null);
+		}, []),
+		closeDialog
+	};
+}
+
+//#endregion
+export { useActions };
+//# sourceMappingURL=use-action.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-action.mjs","names":["React","actions: Required<ActionsConfig<TItem>>"],"sources":["../../../src/client/hooks/use-action.ts"],"sourcesContent":["/**\n * useAction Hook\n *\n * Provides action helpers and state management for collection actions.\n * Handles action execution, navigation, and API calls.\n */\n\n\"use client\";\n\nimport { createQuestpieQueryOptions } from \"@questpie/tanstack-query\";\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport * as React from \"react\";\nimport { toast } from \"sonner\";\nimport { getDefaultActionsConfig } from \"../builder/types/action-registry\";\nimport type {\n  ActionContext,\n  ActionDefinition,\n  ActionHelpers,\n  ActionQueryClient,\n  ActionsConfig,\n  HeaderActionsConfig,\n} from \"../builder/types/action-types\";\nimport { useTranslation } from \"../i18n/hooks\";\nimport {\n  selectAuthClient,\n  selectBasePath,\n  selectClient,\n  selectContentLocale,\n  selectNavigate,\n  useAdminStore,\n} from \"../runtime/provider\";\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** Query key prefix for CMS queries (must match use-collection.ts) */\nconst QUERY_KEY_PREFIX = [\"questpie\", \"collections\"] as const;\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface UseActionHelpersOptions {\n  /** Collection name */\n  collection: string;\n  /** Custom refresh callback */\n  onRefresh?: () => void;\n}\n\nexport interface UseActionHelpersReturn {\n  /** Action helpers to pass to action components */\n  helpers: ActionHelpers;\n}\n\nexport interface UseActionsOptions<TItem = any> {\n  /** Collection name */\n  collection: string;\n  /** Actions configuration from collection config */\n  actionsConfig?: ActionsConfig<TItem>;\n  /** Custom refresh callback */\n  onRefresh?: () => void;\n}\n\nexport interface UseActionsReturn<TItem = any> {\n  /** Action helpers */\n  helpers: ActionHelpers;\n  /** Resolved actions config (with defaults) */\n  actions: Required<ActionsConfig<TItem>>;\n  /** Currently active dialog action */\n  dialogAction: ActionDefinition<TItem> | null;\n  /** Set active dialog action */\n  setDialogAction: (action: ActionDefinition<TItem> | null) => void;\n  /** Item for dialog action (for row actions) */\n  dialogItem: TItem | null;\n  /** Set item for dialog action */\n  setDialogItem: (item: TItem | null) => void;\n  /** Open dialog for an action */\n  openDialog: (action: ActionDefinition<TItem>, item?: TItem) => void;\n  /** Close dialog */\n  closeDialog: () => void;\n}\n\n// ============================================================================\n// useActionHelpers Hook\n// ============================================================================\n\n/**\n * Hook to create action helpers for a collection\n *\n * @example\n * ```tsx\n * const { helpers } = useActionHelpers({ collection: \"posts\" });\n *\n * return (\n *   <HeaderActions\n *     actions={headerActions}\n *     collection=\"posts\"\n *     helpers={helpers}\n *   />\n * );\n * ```\n */\nexport function useActionHelpers({\n  collection,\n  onRefresh,\n}: UseActionHelpersOptions): UseActionHelpersReturn {\n  const basePath = useAdminStore(selectBasePath);\n  const navigate = useAdminStore(selectNavigate);\n  const client = useAdminStore(selectClient);\n  const contentLocale = useAdminStore(selectContentLocale);\n  const queryClient = useQueryClient();\n  const { t } = useTranslation();\n\n  // Create query options proxy for key building (same as use-collection hooks)\n  const queryOpts = React.useMemo(\n    () =>\n      createQuestpieQueryOptions(client as any, {\n        keyPrefix: QUERY_KEY_PREFIX,\n        locale: contentLocale,\n      }),\n    [client, contentLocale],\n  );\n\n  const helpers: ActionHelpers = React.useMemo(\n    () => ({\n      navigate,\n      toast: {\n        success: toast.success,\n        error: toast.error,\n        info: toast.info,\n        warning: toast.warning,\n      },\n      t,\n      invalidateCollection: async (targetCollection?: string) => {\n        const col = targetCollection || collection;\n        // Invalidate list and count queries for the collection\n        await queryClient.invalidateQueries({\n          queryKey: queryOpts.key([\"collections\", col, \"find\", contentLocale]),\n        });\n        await queryClient.invalidateQueries({\n          queryKey: queryOpts.key([\"collections\", col, \"count\", contentLocale]),\n        });\n        // Call custom refresh handler\n        onRefresh?.();\n      },\n      invalidateItem: async (itemId: string, targetCollection?: string) => {\n        const col = targetCollection || collection;\n        // Invalidate findOne query for specific item\n        await queryClient.invalidateQueries({\n          queryKey: queryOpts.key([\n            \"collections\",\n            col,\n            \"findOne\",\n            contentLocale,\n            { id: itemId },\n          ]),\n        });\n        // Also invalidate list queries since item data changed\n        await queryClient.invalidateQueries({\n          queryKey: queryOpts.key([\"collections\", col, \"find\", contentLocale]),\n        });\n      },\n      invalidateAll: async () => {\n        // Invalidate all CMS queries\n        await queryClient.invalidateQueries({\n          queryKey: [...QUERY_KEY_PREFIX],\n        });\n        // Call custom refresh handler\n        onRefresh?.();\n      },\n      refresh: () => {\n        // Invalidate collection queries (better than page reload)\n        queryClient.invalidateQueries({\n          queryKey: queryOpts.key([\n            \"collections\",\n            collection,\n            \"find\",\n            contentLocale,\n          ]),\n        });\n        queryClient.invalidateQueries({\n          queryKey: queryOpts.key([\n            \"collections\",\n            collection,\n            \"count\",\n            contentLocale,\n          ]),\n        });\n        // Call custom refresh handler\n        onRefresh?.();\n      },\n      closeDialog: () => {\n        // This will be overridden by the component managing dialog state\n      },\n      basePath,\n    }),\n    [\n      navigate,\n      queryClient,\n      queryOpts,\n      collection,\n      contentLocale,\n      onRefresh,\n      basePath,\n      t,\n    ],\n  );\n\n  return { helpers };\n}\n\n// ============================================================================\n// useActions Hook\n// ============================================================================\n\n/**\n * Hook to manage collection actions with dialog state\n *\n * @example\n * ```tsx\n * const {\n *   helpers,\n *   actions,\n *   dialogAction,\n *   dialogItem,\n *   openDialog,\n *   closeDialog,\n * } = useActions({\n *   collection: \"posts\",\n *   actionsConfig: config.actions,\n * });\n *\n * return (\n *   <>\n *     <HeaderActions\n *       actions={actions.header}\n *       collection=\"posts\"\n *       helpers={helpers}\n *       onOpenDialog={openDialog}\n *     />\n *\n *     {dialogAction && (\n *       <ActionDialog\n *         open={!!dialogAction}\n *         onOpenChange={(open) => !open && closeDialog()}\n *         action={dialogAction}\n *         collection=\"posts\"\n *         item={dialogItem}\n *         helpers={helpers}\n *       />\n *     )}\n *   </>\n * );\n * ```\n */\nexport function useActions<TItem = any>({\n  collection,\n  actionsConfig,\n  onRefresh,\n}: UseActionsOptions<TItem>): UseActionsReturn<TItem> {\n  const [dialogAction, setDialogAction] =\n    React.useState<ActionDefinition<TItem> | null>(null);\n  const [dialogItem, setDialogItem] = React.useState<TItem | null>(null);\n\n  // Get default actions if not provided\n  const defaultActions = React.useMemo(\n    () => getDefaultActionsConfig<TItem>(),\n    [],\n  );\n\n  // Merge provided config with defaults\n  const actions: Required<ActionsConfig<TItem>> = React.useMemo(\n    () => ({\n      header: actionsConfig?.header ??\n        defaultActions.header ?? { primary: [], secondary: [] },\n      bulk: actionsConfig?.bulk ?? defaultActions.bulk ?? [],\n    }),\n    [actionsConfig, defaultActions],\n  );\n\n  // Close dialog handler\n  const closeDialog = React.useCallback(() => {\n    setDialogAction(null);\n    setDialogItem(null);\n  }, []);\n\n  // Get base helpers\n  const { helpers: baseHelpers } = useActionHelpers({\n    collection,\n    onRefresh: () => {\n      onRefresh?.();\n    },\n  });\n\n  // Enhanced helpers with dialog control\n  const helpers: ActionHelpers = React.useMemo(\n    () => ({\n      ...baseHelpers,\n      closeDialog,\n    }),\n    [baseHelpers, closeDialog],\n  );\n\n  // Open dialog for an action\n  const openDialog = React.useCallback(\n    (action: ActionDefinition<TItem>, item?: TItem) => {\n      setDialogAction(action);\n      setDialogItem(item ?? null);\n    },\n    [],\n  );\n\n  return {\n    helpers,\n    actions,\n    dialogAction,\n    setDialogAction,\n    dialogItem,\n    setDialogItem,\n    openDialog,\n    closeDialog,\n  };\n}\n\n// ============================================================================\n// useActionExecution Hook\n// ============================================================================\n\nexport interface UseActionExecutionOptions<TItem = any> {\n  /** Collection name */\n  collection: string;\n  /** Action helpers */\n  helpers: ActionHelpers;\n}\n\n/**\n * Hook for executing individual actions\n *\n * Provides a function to execute an action with proper error handling\n * and loading state management.\n */\nexport function useActionExecution<TItem = any>({\n  collection,\n  helpers,\n}: UseActionExecutionOptions<TItem>) {\n  const client = useAdminStore(selectClient);\n  const authClient = useAdminStore(selectAuthClient);\n  const queryClient = useQueryClient();\n  const [isExecuting, setIsExecuting] = React.useState(false);\n\n  // Wrapped query client for action context\n  const actionQueryClient: ActionQueryClient = React.useMemo(\n    () => ({\n      invalidateQueries: (filters) => queryClient.invalidateQueries(filters),\n      refetchQueries: (filters) => queryClient.refetchQueries(filters),\n      resetQueries: (filters) => queryClient.resetQueries(filters),\n    }),\n    [queryClient],\n  );\n\n  const executeAction = React.useCallback(\n    async (\n      action: ActionDefinition<TItem>,\n      item?: TItem,\n      items?: TItem[],\n    ): Promise<void> => {\n      const ctx: ActionContext<TItem> = {\n        item,\n        items,\n        collection,\n        helpers,\n        queryClient: actionQueryClient,\n        authClient,\n      };\n\n      setIsExecuting(true);\n      try {\n        const { handler } = action;\n\n        switch (handler.type) {\n          case \"navigate\": {\n            const path =\n              typeof handler.path === \"function\"\n                ? handler.path(item!)\n                : handler.path;\n            helpers.navigate(\n              `${helpers.basePath}/collections/${collection}/${path}`,\n            );\n            break;\n          }\n\n          case \"api\": {\n            // Replace {id} placeholder in endpoint\n            const endpoint = handler.endpoint.replace(\n              \"{id}\",\n              String((item as any)?.id || \"\"),\n            );\n\n            // Execute API call\n            const method = (handler.method || \"POST\").toLowerCase();\n\n            // Get collection-specific client\n            const collectionClient = (client as any).collections?.[collection];\n\n            if (collectionClient) {\n              if (method === \"delete\" && collectionClient.delete) {\n                await collectionClient.delete({ id: (item as any)?.id });\n                helpers.toast.success(\"Item deleted successfully\");\n              } else {\n                // For other methods, show info (actual implementation would call the API)\n                helpers.toast.info(`${handler.method || \"POST\"} ${endpoint}`);\n              }\n            } else {\n              helpers.toast.info(\n                `API call: ${handler.method || \"POST\"} ${endpoint}`,\n              );\n            }\n\n            helpers.refresh();\n            break;\n          }\n\n          case \"custom\": {\n            await handler.fn(ctx);\n            break;\n          }\n\n          case \"dialog\":\n          case \"form\": {\n            // These are handled by the ActionDialog component\n            break;\n          }\n\n          case \"server\": {\n            // Execute server-side action via API\n            const serverHandler = handler as {\n              type: \"server\";\n              actionId: string;\n              collection: string;\n            };\n            try {\n              const collectionClient = (client as any).collections?.[\n                serverHandler.collection\n              ];\n              if (collectionClient?.executeAction) {\n                const result = await collectionClient.executeAction(\n                  serverHandler.actionId,\n                  {\n                    itemId: (item as any)?.id,\n                    itemIds: items?.map((i: any) => i?.id).filter(Boolean),\n                  },\n                );\n                if (result?.toast) {\n                  if (result.type === \"error\") {\n                    helpers.toast.error(result.toast.message);\n                  } else {\n                    helpers.toast.success(result.toast.message);\n                  }\n                }\n                if (result?.effects?.invalidate) {\n                  if (result.effects.invalidate === true) {\n                    await helpers.invalidateAll();\n                  } else {\n                    for (const col of result.effects.invalidate) {\n                      await helpers.invalidateCollection(col);\n                    }\n                  }\n                }\n                if (result?.effects?.closeModal) {\n                  helpers.closeDialog();\n                }\n              } else {\n                helpers.toast.info(`Server action: ${serverHandler.actionId}`);\n              }\n            } catch (err) {\n              helpers.toast.error(\n                err instanceof Error ? err.message : \"Server action failed\",\n              );\n            }\n            break;\n          }\n        }\n      } catch (error) {\n        helpers.toast.error(\n          error instanceof Error ? error.message : \"Action failed\",\n        );\n      } finally {\n        setIsExecuting(false);\n      }\n    },\n    [collection, helpers, client, authClient, actionQueryClient],\n  );\n\n  return {\n    executeAction,\n    isExecuting,\n  };\n}\n"],"mappings":"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"}