@questpie/admin 1.1.1 → 2.0.0

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

@@ -0,0 +1,199 @@
+import { useCollectionSchema } from "./use-collection-schema.mjs";
+import { useGlobalSchema } from "./use-global-schema.mjs";
+import { useMemo } from "react";
+import { ajvResolver } from "@hookform/resolvers/ajv";
+
+//#region src/client/hooks/use-server-validation.ts
+/**
+* useServerValidation Hook
+*
+* Creates a react-hook-form resolver using the server's JSON Schema.
+* Uses AJV for validation, ensuring client-side validation matches server-side exactly.
+*
+* This hook fetches the collection schema from the server and uses the
+* `validation.insert` or `validation.update` JSON Schema for form validation.
+*/
+/**
+* Recursively strip `additionalProperties: false` and `$schema` from a JSON Schema.
+*
+* Zod's `z.toJSONSchema()` sets `additionalProperties: false` on every object,
+* which causes AJV to reject form data containing extra fields such as `id`,
+* `createdAt`, `updatedAt`, etc. that are part of the loaded document but not
+* in the validation schema.
+*
+* It also sets `$schema: "https://json-schema.org/draft/2020-12/schema"` which
+* is not supported by @hookform/resolvers/ajv out of the box.
+*/
+function stripAdditionalProperties(schema) {
+	if (!schema || typeof schema !== "object") return schema;
+	const s = { ...schema };
+	delete s.additionalProperties;
+	delete s.$schema;
+	if (s.properties && typeof s.properties === "object") {
+		const props = {};
+		for (const [k, v] of Object.entries(s.properties)) props[k] = stripAdditionalProperties(v);
+		s.properties = props;
+	}
+	if (s.items) s.items = stripAdditionalProperties(s.items);
+	return s;
+}
+/**
+* Hook to create a react-hook-form resolver using server's JSON Schema
+*
+* Uses the collection's validation schema from the server for client-side
+* validation, ensuring validation rules are consistent between client and server.
+*
+* @param collection - Collection name
+* @param options - Validation options
+* @returns Server validation result with resolver
+*
+* @example
+* ```tsx
+* function CreatePostForm() {
+*   const { resolver, isLoading } = useServerValidation("posts", { mode: "create" });
+*
+*   const form = useForm({
+*     resolver,
+*   });
+*
+*   if (isLoading) return <Loading />;
+*
+*   return <Form {...form}>...</Form>;
+* }
+* ```
+*
+* @example
+* ```tsx
+* // With fallback to client-side validation
+* function PostForm({ isEditing }) {
+*   const { resolver: serverResolver, hasServerSchema } = useServerValidation(
+*     "posts",
+*     { mode: isEditing ? "update" : "create" }
+*   );
+*   const clientResolver = useCollectionValidation("posts");
+*
+*   // Prefer server validation, fall back to client
+*   const resolver = hasServerSchema ? serverResolver : clientResolver;
+*
+*   const form = useForm({ resolver });
+* }
+* ```
+*/
+function useServerValidation(collection, options = {}) {
+	const { mode = "create", enabled = true } = options;
+	const { data: schema, isLoading, error } = useCollectionSchema(collection, { enabled });
+	return useMemo(() => {
+		const jsonSchema = stripAdditionalProperties(mode === "create" ? schema?.validation?.insert : schema?.validation?.update);
+		if (!jsonSchema || typeof jsonSchema !== "object") return {
+			resolver: void 0,
+			hasServerSchema: false,
+			isLoading,
+			error: error ?? null
+		};
+		try {
+			return {
+				resolver: ajvResolver(jsonSchema, {
+					allErrors: true,
+					strict: false,
+					coerceTypes: true,
+					useDefaults: true,
+					formats: {}
+				}, { mode: "async" }),
+				hasServerSchema: true,
+				isLoading: false,
+				error: null
+			};
+		} catch (e) {
+			console.warn(`[useServerValidation] Failed to compile JSON Schema for ${collection}:`, e);
+			return {
+				resolver: void 0,
+				hasServerSchema: false,
+				isLoading: false,
+				error: e instanceof Error ? e : new Error(String(e))
+			};
+		}
+	}, [
+		schema,
+		mode,
+		isLoading,
+		error,
+		collection
+	]);
+}
+/**
+* Hook to get a combined resolver that prefers server validation
+*
+* This is a convenience hook that combines server and client validation,
+* preferring server validation when available.
+*
+* @param collection - Collection name
+* @param options - Validation options
+* @param fallbackResolver - Optional client-side resolver to use as fallback
+* @returns Resolver function for react-hook-form
+*
+* @example
+* ```tsx
+* function PostForm({ isEditing }) {
+*   const clientResolver = useCollectionValidation("posts");
+*   const resolver = usePreferServerValidation("posts", {
+*     mode: isEditing ? "update" : "create"
+*   }, clientResolver);
+*
+*   const form = useForm({ resolver });
+* }
+* ```
+*/
+function usePreferServerValidation(collection, options = {}, fallbackResolver) {
+	const { resolver: serverResolver, hasServerSchema } = useServerValidation(collection, options);
+	return hasServerSchema ? serverResolver : fallbackResolver;
+}
+/**
+* Hook to create a react-hook-form resolver for global settings using server's JSON Schema
+*
+* @param globalName - Global name
+* @param options - Validation options (mode is always "update" for globals)
+* @returns Server validation result with resolver
+*/
+function useGlobalServerValidation(globalName, options = {}) {
+	const { enabled = true } = options;
+	const { data: schema, isLoading, error } = useGlobalSchema(globalName, { enabled });
+	return useMemo(() => {
+		const jsonSchema = stripAdditionalProperties(schema?.validation?.update);
+		if (!jsonSchema || typeof jsonSchema !== "object") return {
+			resolver: void 0,
+			hasServerSchema: false,
+			isLoading,
+			error: error ?? null
+		};
+		try {
+			return {
+				resolver: ajvResolver(jsonSchema, {
+					allErrors: true,
+					strict: false,
+					coerceTypes: true,
+					useDefaults: true
+				}, { mode: "async" }),
+				hasServerSchema: true,
+				isLoading: false,
+				error: null
+			};
+		} catch (e) {
+			console.warn(`[useGlobalServerValidation] Failed to compile JSON Schema for ${globalName}:`, e);
+			return {
+				resolver: void 0,
+				hasServerSchema: false,
+				isLoading: false,
+				error: e instanceof Error ? e : new Error(String(e))
+			};
+		}
+	}, [
+		schema,
+		isLoading,
+		error,
+		globalName
+	]);
+}
+
+//#endregion
+export { useGlobalServerValidation, usePreferServerValidation };
+//# sourceMappingURL=use-server-validation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-server-validation.mjs","names":["props: Record<string, unknown>"],"sources":["../../../src/client/hooks/use-server-validation.ts"],"sourcesContent":["/**\n * useServerValidation Hook\n *\n * Creates a react-hook-form resolver using the server's JSON Schema.\n * Uses AJV for validation, ensuring client-side validation matches server-side exactly.\n *\n * This hook fetches the collection schema from the server and uses the\n * `validation.insert` or `validation.update` JSON Schema for form validation.\n */\n\nimport { ajvResolver } from \"@hookform/resolvers/ajv\";\nimport type { Options as AjvOptions, JSONSchemaType } from \"ajv\";\nimport type { Questpie } from \"questpie\";\nimport { useMemo } from \"react\";\nimport type { FieldValues, Resolver } from \"react-hook-form\";\nimport type {\n\tRegisteredCMS,\n\tRegisteredCollectionNames,\n} from \"../builder/registry\";\nimport { useCollectionSchema } from \"./use-collection-schema\";\nimport { useGlobalSchema } from \"./use-global-schema\";\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Recursively strip `additionalProperties: false` and `$schema` from a JSON Schema.\n *\n * Zod's `z.toJSONSchema()` sets `additionalProperties: false` on every object,\n * which causes AJV to reject form data containing extra fields such as `id`,\n * `createdAt`, `updatedAt`, etc. that are part of the loaded document but not\n * in the validation schema.\n *\n * It also sets `$schema: \"https://json-schema.org/draft/2020-12/schema\"` which\n * is not supported by @hookform/resolvers/ajv out of the box.\n */\nfunction stripAdditionalProperties(schema: unknown): unknown {\n\tif (!schema || typeof schema !== \"object\") return schema;\n\tconst s = { ...(schema as Record<string, unknown>) };\n\tdelete s.additionalProperties;\n\t// Remove $schema as AJV resolver doesn't support draft 2020-12 by default\n\tdelete s.$schema;\n\tif (s.properties && typeof s.properties === \"object\") {\n\t\tconst props: Record<string, unknown> = {};\n\t\tfor (const [k, v] of Object.entries(\n\t\t\ts.properties as Record<string, unknown>,\n\t\t)) {\n\t\t\tprops[k] = stripAdditionalProperties(v);\n\t\t}\n\t\ts.properties = props;\n\t}\n\tif (s.items) {\n\t\ts.items = stripAdditionalProperties(s.items);\n\t}\n\treturn s;\n}\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 * Validation mode for the hook\n */\nexport type ValidationMode = \"create\" | \"update\";\n\n/**\n * Options for useServerValidation hook\n */\nexport interface UseServerValidationOptions {\n\t/** Validation mode - determines which JSON Schema to use */\n\tmode?: ValidationMode;\n\t/** Whether to enable validation (defaults to true) */\n\tenabled?: boolean;\n}\n\n/**\n * Result of useServerValidation hook\n */\nexport interface ServerValidationResult<TFieldValues extends FieldValues> {\n\t/** Resolver for react-hook-form, undefined if schema not available */\n\tresolver: Resolver<TFieldValues> | undefined;\n\t/** Whether server validation schema is available */\n\thasServerSchema: boolean;\n\t/** Whether the schema is currently loading */\n\tisLoading: boolean;\n\t/** Any error that occurred while fetching the schema */\n\terror: Error | null;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * Default AJV options for form validation\n */\nconst DEFAULT_AJV_OPTIONS: AjvOptions = {\n\tallErrors: true,\n\t// Allow additional properties by default (forms may have extra fields)\n\tstrict: false,\n\t// Coerce types for better form compatibility\n\tcoerceTypes: true,\n\t// Use defaults from schema\n\tuseDefaults: true,\n};\n\n// ============================================================================\n// Hook\n// ============================================================================\n\n/**\n * Hook to create a react-hook-form resolver using server's JSON Schema\n *\n * Uses the collection's validation schema from the server for client-side\n * validation, ensuring validation rules are consistent between client and server.\n *\n * @param collection - Collection name\n * @param options - Validation options\n * @returns Server validation result with resolver\n *\n * @example\n * ```tsx\n * function CreatePostForm() {\n *   const { resolver, isLoading } = useServerValidation(\"posts\", { mode: \"create\" });\n *\n *   const form = useForm({\n *     resolver,\n *   });\n *\n *   if (isLoading) return <Loading />;\n *\n *   return <Form {...form}>...</Form>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With fallback to client-side validation\n * function PostForm({ isEditing }) {\n *   const { resolver: serverResolver, hasServerSchema } = useServerValidation(\n *     \"posts\",\n *     { mode: isEditing ? \"update\" : \"create\" }\n *   );\n *   const clientResolver = useCollectionValidation(\"posts\");\n *\n *   // Prefer server validation, fall back to client\n *   const resolver = hasServerSchema ? serverResolver : clientResolver;\n *\n *   const form = useForm({ resolver });\n * }\n * ```\n */\nexport function useServerValidation<\n\tK extends ResolvedCollectionNames,\n\tTFieldValues extends FieldValues = FieldValues,\n>(\n\tcollection: K,\n\toptions: UseServerValidationOptions = {},\n): ServerValidationResult<TFieldValues> {\n\tconst { mode = \"create\", enabled = true } = options;\n\n\tconst {\n\t\tdata: schema,\n\t\tisLoading,\n\t\terror,\n\t} = useCollectionSchema(collection, {\n\t\tenabled,\n\t});\n\n\tconst result = useMemo((): ServerValidationResult<TFieldValues> => {\n\t\t// Get the appropriate JSON Schema based on mode\n\t\tconst rawSchema =\n\t\t\tmode === \"create\"\n\t\t\t\t? schema?.validation?.insert\n\t\t\t\t: schema?.validation?.update;\n\t\tconst jsonSchema = stripAdditionalProperties(rawSchema);\n\n\t\tif (!jsonSchema || typeof jsonSchema !== \"object\") {\n\t\t\treturn {\n\t\t\t\tresolver: undefined,\n\t\t\t\thasServerSchema: false,\n\t\t\t\tisLoading,\n\t\t\t\terror: error ?? null,\n\t\t\t};\n\t\t}\n\n\t\ttry {\n\t\t\t// Create resolver using AJV\n\t\t\tconst resolver = ajvResolver(\n\t\t\t\tjsonSchema as JSONSchemaType<TFieldValues>,\n\t\t\t\t{\n\t\t\t\t\t// Use our pre-configured AJV instance options\n\t\t\t\t\tallErrors: true,\n\t\t\t\t\tstrict: false,\n\t\t\t\t\tcoerceTypes: true,\n\t\t\t\t\tuseDefaults: true,\n\t\t\t\t\t// AJV formats plugin options\n\t\t\t\t\tformats: {},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tmode: \"async\",\n\t\t\t\t},\n\t\t\t);\n\n\t\t\treturn {\n\t\t\t\tresolver,\n\t\t\t\thasServerSchema: true,\n\t\t\t\tisLoading: false,\n\t\t\t\terror: null,\n\t\t\t};\n\t\t} catch (e) {\n\t\t\t// If schema compilation fails, return undefined resolver\n\t\t\tconsole.warn(\n\t\t\t\t`[useServerValidation] Failed to compile JSON Schema for ${collection}:`,\n\t\t\t\te,\n\t\t\t);\n\t\t\treturn {\n\t\t\t\tresolver: undefined,\n\t\t\t\thasServerSchema: false,\n\t\t\t\tisLoading: false,\n\t\t\t\terror: e instanceof Error ? e : new Error(String(e)),\n\t\t\t};\n\t\t}\n\t}, [schema, mode, isLoading, error, collection]);\n\n\treturn result;\n}\n\n/**\n * Hook to get a combined resolver that prefers server validation\n *\n * This is a convenience hook that combines server and client validation,\n * preferring server validation when available.\n *\n * @param collection - Collection name\n * @param options - Validation options\n * @param fallbackResolver - Optional client-side resolver to use as fallback\n * @returns Resolver function for react-hook-form\n *\n * @example\n * ```tsx\n * function PostForm({ isEditing }) {\n *   const clientResolver = useCollectionValidation(\"posts\");\n *   const resolver = usePreferServerValidation(\"posts\", {\n *     mode: isEditing ? \"update\" : \"create\"\n *   }, clientResolver);\n *\n *   const form = useForm({ resolver });\n * }\n * ```\n */\nexport function usePreferServerValidation<\n\tK extends ResolvedCollectionNames,\n\tTFieldValues extends FieldValues = FieldValues,\n>(\n\tcollection: K,\n\toptions: UseServerValidationOptions = {},\n\tfallbackResolver?: Resolver<TFieldValues>,\n): Resolver<TFieldValues> | undefined {\n\tconst { resolver: serverResolver, hasServerSchema } = useServerValidation<\n\t\tK,\n\t\tTFieldValues\n\t>(collection, options);\n\n\treturn hasServerSchema ? serverResolver : fallbackResolver;\n}\n\n// ============================================================================\n// Global Validation Hook\n// ============================================================================\n\n/**\n * Hook to create a react-hook-form resolver for global settings using server's JSON Schema\n *\n * @param globalName - Global name\n * @param options - Validation options (mode is always \"update\" for globals)\n * @returns Server validation result with resolver\n */\nexport function useGlobalServerValidation<\n\tTFieldValues extends FieldValues = FieldValues,\n>(\n\tglobalName: string,\n\toptions: Omit<UseServerValidationOptions, \"mode\"> = {},\n): ServerValidationResult<TFieldValues> {\n\tconst { enabled = true } = options;\n\n\tconst {\n\t\tdata: schema,\n\t\tisLoading,\n\t\terror,\n\t} = useGlobalSchema(globalName, {\n\t\tenabled,\n\t});\n\n\tconst result = useMemo((): ServerValidationResult<TFieldValues> => {\n\t\t// Globals only have update validation\n\t\tconst jsonSchema = stripAdditionalProperties(schema?.validation?.update);\n\n\t\tif (!jsonSchema || typeof jsonSchema !== \"object\") {\n\t\t\treturn {\n\t\t\t\tresolver: undefined,\n\t\t\t\thasServerSchema: false,\n\t\t\t\tisLoading,\n\t\t\t\terror: error ?? null,\n\t\t\t};\n\t\t}\n\n\t\ttry {\n\t\t\tconst resolver = ajvResolver(\n\t\t\t\tjsonSchema as JSONSchemaType<TFieldValues>,\n\t\t\t\t{\n\t\t\t\t\tallErrors: true,\n\t\t\t\t\tstrict: false,\n\t\t\t\t\tcoerceTypes: true,\n\t\t\t\t\tuseDefaults: true,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tmode: \"async\",\n\t\t\t\t},\n\t\t\t);\n\n\t\t\treturn {\n\t\t\t\tresolver,\n\t\t\t\thasServerSchema: true,\n\t\t\t\tisLoading: false,\n\t\t\t\terror: null,\n\t\t\t};\n\t\t} catch (e) {\n\t\t\tconsole.warn(\n\t\t\t\t`[useGlobalServerValidation] Failed to compile JSON Schema for ${globalName}:`,\n\t\t\t\te,\n\t\t\t);\n\t\t\treturn {\n\t\t\t\tresolver: undefined,\n\t\t\t\thasServerSchema: false,\n\t\t\t\tisLoading: false,\n\t\t\t\terror: e instanceof Error ? e : new Error(String(e)),\n\t\t\t};\n\t\t}\n\t}, [schema, isLoading, error, globalName]);\n\n\treturn result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAS,0BAA0B,QAA0B;AAC5D,KAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;CAClD,MAAM,IAAI,EAAE,GAAI,QAAoC;AACpD,QAAO,EAAE;AAET,QAAO,EAAE;AACT,KAAI,EAAE,cAAc,OAAO,EAAE,eAAe,UAAU;EACrD,MAAMA,QAAiC,EAAE;AACzC,OAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAC3B,EAAE,WACF,CACA,OAAM,KAAK,0BAA0B,EAAE;AAExC,IAAE,aAAa;;AAEhB,KAAI,EAAE,MACL,GAAE,QAAQ,0BAA0B,EAAE,MAAM;AAE7C,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGR,SAAgB,oBAIf,YACA,UAAsC,EAAE,EACD;CACvC,MAAM,EAAE,OAAO,UAAU,UAAU,SAAS;CAE5C,MAAM,EACL,MAAM,QACN,WACA,UACG,oBAAoB,YAAY,EACnC,SACA,CAAC;AA0DF,QAxDe,cAAoD;EAMlE,MAAM,aAAa,0BAHlB,SAAS,WACN,QAAQ,YAAY,SACpB,QAAQ,YAAY,OAC+B;AAEvD,MAAI,CAAC,cAAc,OAAO,eAAe,SACxC,QAAO;GACN,UAAU;GACV,iBAAiB;GACjB;GACA,OAAO,SAAS;GAChB;AAGF,MAAI;AAkBH,UAAO;IACN,UAjBgB,YAChB,YACA;KAEC,WAAW;KACX,QAAQ;KACR,aAAa;KACb,aAAa;KAEb,SAAS,EAAE;KACX,EACD,EACC,MAAM,SACN,CACD;IAIA,iBAAiB;IACjB,WAAW;IACX,OAAO;IACP;WACO,GAAG;AAEX,WAAQ,KACP,2DAA2D,WAAW,IACtE,EACA;AACD,UAAO;IACN,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,OAAO,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,EAAE,CAAC;IACpD;;IAEA;EAAC;EAAQ;EAAM;EAAW;EAAO;EAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA4BjD,SAAgB,0BAIf,YACA,UAAsC,EAAE,EACxC,kBACqC;CACrC,MAAM,EAAE,UAAU,gBAAgB,oBAAoB,oBAGpD,YAAY,QAAQ;AAEtB,QAAO,kBAAkB,iBAAiB;;;;;;;;;AAc3C,SAAgB,0BAGf,YACA,UAAoD,EAAE,EACf;CACvC,MAAM,EAAE,UAAU,SAAS;CAE3B,MAAM,EACL,MAAM,QACN,WACA,UACG,gBAAgB,YAAY,EAC/B,SACA,CAAC;AAiDF,QA/Ce,cAAoD;EAElE,MAAM,aAAa,0BAA0B,QAAQ,YAAY,OAAO;AAExE,MAAI,CAAC,cAAc,OAAO,eAAe,SACxC,QAAO;GACN,UAAU;GACV,iBAAiB;GACjB;GACA,OAAO,SAAS;GAChB;AAGF,MAAI;AAcH,UAAO;IACN,UAdgB,YAChB,YACA;KACC,WAAW;KACX,QAAQ;KACR,aAAa;KACb,aAAa;KACb,EACD,EACC,MAAM,SACN,CACD;IAIA,iBAAiB;IACjB,WAAW;IACX,OAAO;IACP;WACO,GAAG;AACX,WAAQ,KACP,iEAAiE,WAAW,IAC5E,EACA;AACD,UAAO;IACN,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,OAAO,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,EAAE,CAAC;IACpD;;IAEA;EAAC;EAAQ;EAAW;EAAO;EAAW,CAAC"}

package/dist/client/hooks/use-server-widget-data.d.mts

@@ -0,0 +1,26 @@
+import { UseQueryResult } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-server-widget-data.d.ts
+
+/**
+ * Fetches widget data from server via the fetchWidgetData RPC endpoint.
+ *
+ * @param widgetId - The widget ID to fetch data for
+ * @param options - Query options
+ * @returns TanStack Query result with the widget data
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useServerWidgetData<{ count: number }>(
+ *   "my-widget",
+ *   { enabled: config.hasFetchFn }
+ * );
+ * ```
+ */
+declare function useServerWidgetData<T = unknown>(widgetId: string, options?: {
+  enabled?: boolean;
+  refreshInterval?: number;
+}): UseQueryResult<T>;
+//#endregion
+export { useServerWidgetData };
+//# sourceMappingURL=use-server-widget-data.d.mts.map

package/dist/client/hooks/use-server-widget-data.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-server-widget-data.d.mts","names":[],"sources":["../../../src/client/hooks/use-server-widget-data.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;iBAuBgB;;;IAGb,eAAe"}

package/dist/client/hooks/use-server-widget-data.mjs

@@ -0,0 +1,40 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-server-widget-data.ts
+/**
+* Hook for fetching widget data from server via fetchWidgetData RPC.
+* Used when a widget has hasFetchFn=true (server-side fetchFn).
+*/
+/**
+* Fetches widget data from server via the fetchWidgetData RPC endpoint.
+*
+* @param widgetId - The widget ID to fetch data for
+* @param options - Query options
+* @returns TanStack Query result with the widget data
+*
+* @example
+* ```tsx
+* const { data, isLoading } = useServerWidgetData<{ count: number }>(
+*   "my-widget",
+*   { enabled: config.hasFetchFn }
+* );
+* ```
+*/
+function useServerWidgetData(widgetId, options) {
+	const client = useAdminStore(selectClient);
+	return useQuery({
+		queryKey: [
+			"widget",
+			"serverData",
+			widgetId
+		],
+		queryFn: () => client.rpc.fetchWidgetData({ widgetId }),
+		enabled: options?.enabled ?? true,
+		refetchInterval: options?.refreshInterval
+	});
+}
+
+//#endregion
+export { useServerWidgetData };
+//# sourceMappingURL=use-server-widget-data.mjs.map

package/dist/client/hooks/use-server-widget-data.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-server-widget-data.mjs","names":[],"sources":["../../../src/client/hooks/use-server-widget-data.ts"],"sourcesContent":["/**\n * Hook for fetching widget data from server via fetchWidgetData RPC.\n * Used when a widget has hasFetchFn=true (server-side fetchFn).\n */\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { selectClient, useAdminStore } from \"../runtime\";\n\n/**\n * Fetches widget data from server via the fetchWidgetData RPC endpoint.\n *\n * @param widgetId - The widget ID to fetch data for\n * @param options - Query options\n * @returns TanStack Query result with the widget data\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useServerWidgetData<{ count: number }>(\n *   \"my-widget\",\n *   { enabled: config.hasFetchFn }\n * );\n * ```\n */\nexport function useServerWidgetData<T = unknown>(\n  widgetId: string,\n  options?: { enabled?: boolean; refreshInterval?: number },\n): UseQueryResult<T> {\n  const client = useAdminStore(selectClient);\n\n  return useQuery<T>({\n    queryKey: [\"widget\", \"serverData\", widgetId],\n    queryFn: () =>\n      (client as any).rpc.fetchWidgetData({ widgetId }) as Promise<T>,\n    enabled: options?.enabled ?? true,\n    refetchInterval: options?.refreshInterval,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,oBACd,UACA,SACmB;CACnB,MAAM,SAAS,cAAc,aAAa;AAE1C,QAAO,SAAY;EACjB,UAAU;GAAC;GAAU;GAAc;GAAS;EAC5C,eACG,OAAe,IAAI,gBAAgB,EAAE,UAAU,CAAC;EACnD,SAAS,SAAS,WAAW;EAC7B,iBAAiB,SAAS;EAC3B,CAAC"}

package/dist/client/hooks/use-setup-status.d.mts

@@ -0,0 +1,39 @@
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/client/hooks/use-setup-status.d.ts
+
+/**
+ * Setup Status Hook
+ *
+ * Hook to check if the CMS setup is required (no users exist).
+ * Useful for redirecting to setup page on first visit.
+ */
+interface SetupStatus {
+  /** Whether setup is required (no users exist) */
+  required: boolean;
+}
+/**
+ * Check if CMS setup is required.
+ *
+ * Returns `required: true` if no users exist in the system,
+ * meaning the setup page should be shown to create the first admin.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { data, isLoading } = useSetupStatus();
+ *
+ *   if (isLoading) return <LoadingSpinner />;
+ *
+ *   if (data?.required) {
+ *     return <Navigate to="/admin/setup" />;
+ *   }
+ *
+ *   return <AdminPanel />;
+ * }
+ * ```
+ */
+declare function useSetupStatus(): _tanstack_react_query0.UseQueryResult<SetupStatus, Error>;
+//#endregion
+export { SetupStatus, useSetupStatus };
+//# sourceMappingURL=use-setup-status.d.mts.map

package/dist/client/hooks/use-setup-status.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-setup-status.d.mts","names":[],"sources":["../../../src/client/hooks/use-setup-status.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AA0BA;;AAA8B,UA1Bb,WAAA,CA0Ba;EAAA;EAAA,QAAA,EAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;iBAAd,cAAA,CAAA,GAAc,sBAAA,CAAA,eAAA,aAAA"}

package/dist/client/hooks/use-setup-status.mjs

@@ -0,0 +1,50 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/client/hooks/use-setup-status.ts
+/**
+* Setup Status Hook
+*
+* Hook to check if the CMS setup is required (no users exist).
+* Useful for redirecting to setup page on first visit.
+*/
+/**
+* Check if CMS setup is required.
+*
+* Returns `required: true` if no users exist in the system,
+* meaning the setup page should be shown to create the first admin.
+*
+* @example
+* ```tsx
+* function App() {
+*   const { data, isLoading } = useSetupStatus();
+*
+*   if (isLoading) return <LoadingSpinner />;
+*
+*   if (data?.required) {
+*     return <Navigate to="/admin/setup" />;
+*   }
+*
+*   return <AdminPanel />;
+* }
+* ```
+*/
+function useSetupStatus() {
+	const client = useAdminStore(selectClient);
+	return useQuery({
+		queryKey: ["questpie", "setup-status"],
+		queryFn: async () => {
+			try {
+				return { required: (await client.rpc.isSetupRequired({})).required };
+			} catch {
+				return { required: false };
+			}
+		},
+		staleTime: 1e3 * 60,
+		retry: false
+	});
+}
+
+//#endregion
+export { useSetupStatus };
+//# sourceMappingURL=use-setup-status.mjs.map

package/dist/client/hooks/use-setup-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-setup-status.mjs","names":[],"sources":["../../../src/client/hooks/use-setup-status.ts"],"sourcesContent":["/**\n * Setup Status Hook\n *\n * Hook to check if the CMS setup is required (no users exist).\n * Useful for redirecting to setup page on first visit.\n */\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { selectClient, useAdminStore } from \"../runtime/provider\";\n\nexport interface SetupStatus {\n  /** Whether setup is required (no users exist) */\n  required: boolean;\n}\n\n/**\n * Check if CMS setup is required.\n *\n * Returns `required: true` if no users exist in the system,\n * meaning the setup page should be shown to create the first admin.\n *\n * @example\n * ```tsx\n * function App() {\n *   const { data, isLoading } = useSetupStatus();\n *\n *   if (isLoading) return <LoadingSpinner />;\n *\n *   if (data?.required) {\n *     return <Navigate to=\"/admin/setup\" />;\n *   }\n *\n *   return <AdminPanel />;\n * }\n * ```\n */\nexport function useSetupStatus() {\n  const client = useAdminStore(selectClient);\n\n  return useQuery<SetupStatus>({\n    queryKey: [\"questpie\", \"setup-status\"],\n    queryFn: async () => {\n      try {\n        const result = await (client as any).rpc.isSetupRequired({});\n        return { required: result.required };\n      } catch {\n        // If the function doesn't exist, setup is not required\n        return { required: false };\n      }\n    },\n    staleTime: 1000 * 60, // Cache for 1 minute\n    retry: false,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,iBAAiB;CAC/B,MAAM,SAAS,cAAc,aAAa;AAE1C,QAAO,SAAsB;EAC3B,UAAU,CAAC,YAAY,eAAe;EACtC,SAAS,YAAY;AACnB,OAAI;AAEF,WAAO,EAAE,WADM,MAAO,OAAe,IAAI,gBAAgB,EAAE,CAAC,EAClC,UAAU;WAC9B;AAEN,WAAO,EAAE,UAAU,OAAO;;;EAG9B,WAAW,MAAO;EAClB,OAAO;EACR,CAAC"}

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

@@ -0,0 +1,32 @@
+import { useAdminConfig } from "./use-admin-config.mjs";
+import { useMemo } from "react";
+
+//#region src/client/hooks/use-upload-collection.ts
+function normalizeCollectionName(value) {
+	if (typeof value !== "string") return void 0;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+function resolveUploadCollection(preferred, uploads) {
+	const preferredCollection = normalizeCollectionName(preferred);
+	if (preferredCollection) return preferredCollection;
+	const defaultCollection = normalizeCollectionName(uploads?.defaultCollection);
+	if (defaultCollection) return defaultCollection;
+	if (uploads?.collections?.length === 1) return uploads.collections[0];
+}
+function useUploadCollection(preferred) {
+	const { data: adminConfig } = useAdminConfig();
+	const collections = adminConfig?.uploads?.collections ?? [];
+	return useMemo(() => ({
+		collection: resolveUploadCollection(preferred, adminConfig?.uploads),
+		collections
+	}), [
+		preferred,
+		collections.join("|"),
+		adminConfig?.uploads?.defaultCollection
+	]);
+}
+
+//#endregion
+export { useUploadCollection };
+//# sourceMappingURL=use-upload-collection.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-upload-collection.mjs","names":[],"sources":["../../../src/client/hooks/use-upload-collection.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { AdminConfigResponse } from \"../types/admin-config\";\nimport { useAdminConfig } from \"./use-admin-config\";\n\ntype UploadConfig = AdminConfigResponse[\"uploads\"];\n\nexport type UploadCollectionResolution = {\n\tcollection?: string;\n\tcollections: string[];\n};\n\nfunction normalizeCollectionName(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst trimmed = value.trim();\n\treturn trimmed.length > 0 ? trimmed : undefined;\n}\n\nexport function resolveUploadCollection(\n\tpreferred?: string,\n\tuploads?: UploadConfig,\n): string | undefined {\n\tconst preferredCollection = normalizeCollectionName(preferred);\n\tif (preferredCollection) {\n\t\treturn preferredCollection;\n\t}\n\n\tconst defaultCollection = normalizeCollectionName(uploads?.defaultCollection);\n\tif (defaultCollection) {\n\t\treturn defaultCollection;\n\t}\n\n\tif (uploads?.collections?.length === 1) {\n\t\treturn uploads.collections[0];\n\t}\n\n\treturn undefined;\n}\n\nexport function useUploadCollection(\n\tpreferred?: string,\n): UploadCollectionResolution {\n\tconst { data: adminConfig } = useAdminConfig();\n\n\tconst collections = adminConfig?.uploads?.collections ?? [];\n\tconst collectionsKey = collections.join(\"|\");\n\n\treturn useMemo(\n\t\t() => ({\n\t\t\tcollection: resolveUploadCollection(preferred, adminConfig?.uploads),\n\t\t\tcollections,\n\t\t}),\n\t\t[preferred, collectionsKey, adminConfig?.uploads?.defaultCollection],\n\t);\n}\n"],"mappings":";;;;AAWA,SAAS,wBAAwB,OAAoC;AACpE,KAAI,OAAO,UAAU,SAAU,QAAO;CACtC,MAAM,UAAU,MAAM,MAAM;AAC5B,QAAO,QAAQ,SAAS,IAAI,UAAU;;AAGvC,SAAgB,wBACf,WACA,SACqB;CACrB,MAAM,sBAAsB,wBAAwB,UAAU;AAC9D,KAAI,oBACH,QAAO;CAGR,MAAM,oBAAoB,wBAAwB,SAAS,kBAAkB;AAC7E,KAAI,kBACH,QAAO;AAGR,KAAI,SAAS,aAAa,WAAW,EACpC,QAAO,QAAQ,YAAY;;AAM7B,SAAgB,oBACf,WAC6B;CAC7B,MAAM,EAAE,MAAM,gBAAgB,gBAAgB;CAE9C,MAAM,cAAc,aAAa,SAAS,eAAe,EAAE;AAG3D,QAAO,eACC;EACN,YAAY,wBAAwB,WAAW,aAAa,QAAQ;EACpE;EACA,GACD;EAAC;EAPqB,YAAY,KAAK,IAAI;EAOf,aAAa,SAAS;EAAkB,CACpE"}

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

@@ -0,0 +1,23 @@
+//#region src/client/hooks/use-upload.d.ts
+
+/**
+ * Asset record returned from upload
+ */
+interface Asset {
+  id: string;
+  key: string;
+  filename: string;
+  mimeType: string;
+  size: number;
+  visibility: "public" | "private";
+  url?: string;
+  width?: number | null;
+  height?: number | null;
+  alt?: string | null;
+  caption?: string | null;
+  createdAt?: string;
+  updatedAt?: string;
+}
+//#endregion
+export { Asset };
+//# sourceMappingURL=use-upload.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-upload.d.mts","names":[],"sources":["../../../src/client/hooks/use-upload.ts"],"sourcesContent":[],"mappings":";;;;;UA8CiB,KAAA"}

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

@@ -0,0 +1,145 @@
+import { selectClient, useAdminStore } from "../runtime/provider.mjs";
+import { useUploadCollection } from "./use-upload-collection.mjs";
+import { useQueryClient } from "@tanstack/react-query";
+import { useCallback, useState } from "react";
+
+//#region src/client/hooks/use-upload.ts
+/**
+* useUpload Hook
+*
+* Handles file uploads to the CMS with progress tracking.
+* Uses the QuestpieClient's upload method which uses XMLHttpRequest for progress.
+*
+* @example
+* ```tsx
+* const { upload, uploadMany, isUploading, progress } = useUpload();
+*
+* // Single file upload
+* const asset = await upload(file);
+*
+* // Multiple files upload
+* const assets = await uploadMany(files, {
+*   onProgress: (p) => console.log(`${p}%`),
+* });
+* ```
+*/
+/**
+* Hook for uploading files to the CMS
+*
+* Uses the QuestpieClient's built-in upload method which provides
+* progress tracking via XMLHttpRequest.
+*/
+function useUpload() {
+	const client = useAdminStore(selectClient);
+	const queryClient = useQueryClient();
+	const { collection: defaultUploadCollection, collections: uploadCollections } = useUploadCollection();
+	const [isUploading, setIsUploading] = useState(false);
+	const [progress, setProgress] = useState(0);
+	const [error, setError] = useState(null);
+	const resolveTargetCollection = useCallback((to) => {
+		const explicit = typeof to === "string" ? to.trim() : "";
+		if (explicit.length > 0) return explicit;
+		return defaultUploadCollection;
+	}, [defaultUploadCollection]);
+	const getMissingCollectionMessage = useCallback(() => {
+		if (uploadCollections.length === 0) return "No upload-enabled collection is registered. Configure a collection with .upload() and ensure it is accessible in admin config.";
+		if (uploadCollections.length > 1) return `Multiple upload collections are available (${uploadCollections.join(", ")}). Pass UploadOptions.to to select one.`;
+		return "Upload collection is not configured.";
+	}, [uploadCollections]);
+	return {
+		upload: useCallback(async (file, options = {}) => {
+			const { to, onProgress, signal } = options;
+			const targetCollection = resolveTargetCollection(to);
+			if (!targetCollection) {
+				const missingCollectionError = new Error(getMissingCollectionMessage());
+				setError(missingCollectionError);
+				throw missingCollectionError;
+			}
+			setIsUploading(true);
+			setProgress(0);
+			setError(null);
+			try {
+				const collectionApi = client.collections[targetCollection];
+				if (!collectionApi?.upload) throw new Error(`Collection "${targetCollection}" does not support uploads. Make sure .upload() is enabled on the collection.`);
+				const result = await collectionApi.upload(file, {
+					signal,
+					onProgress: (p) => {
+						setProgress(p);
+						onProgress?.(p);
+					}
+				});
+				queryClient.invalidateQueries({ queryKey: [
+					"questpie",
+					"collections",
+					targetCollection
+				] });
+				return result;
+			} catch (err) {
+				const uploadError = err instanceof Error ? err : /* @__PURE__ */ new Error("Upload failed");
+				setError(uploadError);
+				throw uploadError;
+			} finally {
+				setIsUploading(false);
+			}
+		}, [
+			client,
+			queryClient,
+			resolveTargetCollection,
+			getMissingCollectionMessage
+		]),
+		uploadMany: useCallback(async (files, options = {}) => {
+			const { to, onProgress, signal } = options;
+			const targetCollection = resolveTargetCollection(to);
+			if (!targetCollection) {
+				const missingCollectionError = new Error(getMissingCollectionMessage());
+				setError(missingCollectionError);
+				throw missingCollectionError;
+			}
+			if (files.length === 0) return [];
+			setIsUploading(true);
+			setProgress(0);
+			setError(null);
+			try {
+				const collectionApi = client.collections[targetCollection];
+				if (!collectionApi?.uploadMany) throw new Error(`Collection "${targetCollection}" does not support uploads. Make sure .upload() is enabled on the collection.`);
+				const results = await collectionApi.uploadMany(files, {
+					signal,
+					onProgress: (p, fileIndex) => {
+						setProgress(p);
+						onProgress?.(p, fileIndex);
+					}
+				});
+				queryClient.invalidateQueries({ queryKey: [
+					"questpie",
+					"collections",
+					targetCollection
+				] });
+				setProgress(100);
+				return results;
+			} catch (err) {
+				const uploadError = err instanceof Error ? err : /* @__PURE__ */ new Error("Upload failed");
+				setError(uploadError);
+				throw uploadError;
+			} finally {
+				setIsUploading(false);
+			}
+		}, [
+			client,
+			queryClient,
+			resolveTargetCollection,
+			getMissingCollectionMessage
+		]),
+		isUploading,
+		progress,
+		error,
+		reset: useCallback(() => {
+			setIsUploading(false);
+			setProgress(0);
+			setError(null);
+		}, [])
+	};
+}
+
+//#endregion
+export { useUpload };
+//# sourceMappingURL=use-upload.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-upload.mjs","names":[],"sources":["../../../src/client/hooks/use-upload.ts"],"sourcesContent":["/**\n * useUpload Hook\n *\n * Handles file uploads to the CMS with progress tracking.\n * Uses the QuestpieClient's upload method which uses XMLHttpRequest for progress.\n *\n * @example\n * ```tsx\n * const { upload, uploadMany, isUploading, progress } = useUpload();\n *\n * // Single file upload\n * const asset = await upload(file);\n *\n * // Multiple files upload\n * const assets = await uploadMany(files, {\n *   onProgress: (p) => console.log(`${p}%`),\n * });\n * ```\n */\n\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport { useCallback, useState } from \"react\";\nimport { selectClient, useAdminStore } from \"../runtime\";\nimport { useUploadCollection } from \"./use-upload-collection\";\n\n/**\n * Upload error with additional context\n */\nexport class UploadError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly status?: number,\n\t\tpublic readonly response?: unknown,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"UploadError\";\n\t}\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Asset record returned from upload\n */\nexport interface Asset {\n\tid: string;\n\tkey: string;\n\tfilename: string;\n\tmimeType: string;\n\tsize: number;\n\tvisibility: \"public\" | \"private\";\n\turl?: string;\n\twidth?: number | null;\n\theight?: number | null;\n\talt?: string | null;\n\tcaption?: string | null;\n\tcreatedAt?: string;\n\tupdatedAt?: string;\n}\n\n/**\n * Options for upload operations\n */\nexport interface UploadOptions {\n\t/**\n\t * Target collection for upload (must have .upload() enabled)\n\t */\n\tto?: string;\n\n\t/**\n\t * Progress callback (0-100)\n\t */\n\tonProgress?: (progress: number) => void;\n\n\t/**\n\t * Abort signal for cancellation\n\t */\n\tsignal?: AbortSignal;\n}\n\n/**\n * Options for uploadMany operation\n */\nexport interface UploadManyOptions extends UploadOptions {\n\t/**\n\t * Progress callback receives overall progress (0-100)\n\t * and optionally individual file progress\n\t */\n\tonProgress?: (progress: number, fileIndex?: number) => void;\n}\n\n/**\n * Return type for useUpload hook\n */\nexport interface UseUploadReturn {\n\t/**\n\t * Upload a single file\n\t */\n\tupload: (file: File, options?: UploadOptions) => Promise<Asset>;\n\n\t/**\n\t * Upload multiple files sequentially\n\t */\n\tuploadMany: (files: File[], options?: UploadManyOptions) => Promise<Asset[]>;\n\n\t/**\n\t * Whether an upload is currently in progress\n\t */\n\tisUploading: boolean;\n\n\t/**\n\t * Current upload progress (0-100)\n\t */\n\tprogress: number;\n\n\t/**\n\t * Current error, if any\n\t */\n\terror: Error | null;\n\n\t/**\n\t * Reset state (clear error, progress)\n\t */\n\treset: () => void;\n}\n\n// ============================================================================\n// Hook Implementation\n// ============================================================================\n\n/**\n * Hook for uploading files to the CMS\n *\n * Uses the QuestpieClient's built-in upload method which provides\n * progress tracking via XMLHttpRequest.\n */\nexport function useUpload(): UseUploadReturn {\n\tconst client = useAdminStore(selectClient);\n\tconst queryClient = useQueryClient();\n\tconst {\n\t\tcollection: defaultUploadCollection,\n\t\tcollections: uploadCollections,\n\t} = useUploadCollection();\n\n\tconst [isUploading, setIsUploading] = useState(false);\n\tconst [progress, setProgress] = useState(0);\n\tconst [error, setError] = useState<Error | null>(null);\n\n\tconst resolveTargetCollection = useCallback(\n\t\t(to?: string): string | undefined => {\n\t\t\tconst explicit = typeof to === \"string\" ? to.trim() : \"\";\n\t\t\tif (explicit.length > 0) {\n\t\t\t\treturn explicit;\n\t\t\t}\n\n\t\t\treturn defaultUploadCollection;\n\t\t},\n\t\t[defaultUploadCollection],\n\t);\n\n\tconst getMissingCollectionMessage = useCallback((): string => {\n\t\tif (uploadCollections.length === 0) {\n\t\t\treturn \"No upload-enabled collection is registered. Configure a collection with .upload() and ensure it is accessible in admin config.\";\n\t\t}\n\n\t\tif (uploadCollections.length > 1) {\n\t\t\treturn `Multiple upload collections are available (${uploadCollections.join(\", \")}). Pass UploadOptions.to to select one.`;\n\t\t}\n\n\t\treturn \"Upload collection is not configured.\";\n\t}, [uploadCollections]);\n\n\t/**\n\t * Upload a single file\n\t */\n\tconst upload = useCallback(\n\t\tasync (file: File, options: UploadOptions = {}): Promise<Asset> => {\n\t\t\tconst { to, onProgress, signal } = options;\n\t\t\tconst targetCollection = resolveTargetCollection(to);\n\n\t\t\tif (!targetCollection) {\n\t\t\t\tconst missingCollectionError = new Error(getMissingCollectionMessage());\n\t\t\t\tsetError(missingCollectionError);\n\t\t\t\tthrow missingCollectionError;\n\t\t\t}\n\n\t\t\tsetIsUploading(true);\n\t\t\tsetProgress(0);\n\t\t\tsetError(null);\n\n\t\t\ttry {\n\t\t\t\t// Get the collection API from client\n\t\t\t\tconst collectionApi = (client.collections as any)[targetCollection];\n\n\t\t\t\tif (!collectionApi?.upload) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Collection \"${targetCollection}\" does not support uploads. Make sure .upload() is enabled on the collection.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tconst result = await collectionApi.upload(file, {\n\t\t\t\t\tsignal,\n\t\t\t\t\tonProgress: (p: number) => {\n\t\t\t\t\t\tsetProgress(p);\n\t\t\t\t\t\tonProgress?.(p);\n\t\t\t\t\t},\n\t\t\t\t});\n\n\t\t\t\t// Invalidate collection queries to refresh lists\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: [\"questpie\", \"collections\", targetCollection],\n\t\t\t\t});\n\n\t\t\t\treturn result as Asset;\n\t\t\t} catch (err) {\n\t\t\t\tconst uploadError =\n\t\t\t\t\terr instanceof Error ? err : new Error(\"Upload failed\");\n\t\t\t\tsetError(uploadError);\n\t\t\t\tthrow uploadError;\n\t\t\t} finally {\n\t\t\t\tsetIsUploading(false);\n\t\t\t}\n\t\t},\n\t\t[client, queryClient, resolveTargetCollection, getMissingCollectionMessage],\n\t);\n\n\t/**\n\t * Upload multiple files sequentially\n\t */\n\tconst uploadMany = useCallback(\n\t\tasync (\n\t\t\tfiles: File[],\n\t\t\toptions: UploadManyOptions = {},\n\t\t): Promise<Asset[]> => {\n\t\t\tconst { to, onProgress, signal } = options;\n\t\t\tconst targetCollection = resolveTargetCollection(to);\n\n\t\t\tif (!targetCollection) {\n\t\t\t\tconst missingCollectionError = new Error(getMissingCollectionMessage());\n\t\t\t\tsetError(missingCollectionError);\n\t\t\t\tthrow missingCollectionError;\n\t\t\t}\n\n\t\t\tif (files.length === 0) {\n\t\t\t\treturn [];\n\t\t\t}\n\n\t\t\tsetIsUploading(true);\n\t\t\tsetProgress(0);\n\t\t\tsetError(null);\n\n\t\t\ttry {\n\t\t\t\t// Get the collection API from client\n\t\t\t\tconst collectionApi = (client.collections as any)[targetCollection];\n\n\t\t\t\tif (!collectionApi?.uploadMany) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Collection \"${targetCollection}\" does not support uploads. Make sure .upload() is enabled on the collection.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tconst results = await collectionApi.uploadMany(files, {\n\t\t\t\t\tsignal,\n\t\t\t\t\tonProgress: (p: number, fileIndex?: number) => {\n\t\t\t\t\t\tsetProgress(p);\n\t\t\t\t\t\tonProgress?.(p, fileIndex);\n\t\t\t\t\t},\n\t\t\t\t});\n\n\t\t\t\t// Invalidate collection queries\n\t\t\t\tqueryClient.invalidateQueries({\n\t\t\t\t\tqueryKey: [\"questpie\", \"collections\", targetCollection],\n\t\t\t\t});\n\n\t\t\t\tsetProgress(100);\n\t\t\t\treturn results as Asset[];\n\t\t\t} catch (err) {\n\t\t\t\tconst uploadError =\n\t\t\t\t\terr instanceof Error ? err : new Error(\"Upload failed\");\n\t\t\t\tsetError(uploadError);\n\t\t\t\tthrow uploadError;\n\t\t\t} finally {\n\t\t\t\tsetIsUploading(false);\n\t\t\t}\n\t\t},\n\t\t[client, queryClient, resolveTargetCollection, getMissingCollectionMessage],\n\t);\n\n\t/**\n\t * Reset hook state\n\t */\n\tconst reset = useCallback(() => {\n\t\tsetIsUploading(false);\n\t\tsetProgress(0);\n\t\tsetError(null);\n\t}, []);\n\n\treturn {\n\t\tupload,\n\t\tuploadMany,\n\t\tisUploading,\n\t\tprogress,\n\t\terror,\n\t\treset,\n\t};\n}\n"],"mappings":"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"}