@questpie/admin 1.1.0 → 2.0.0

package/dist/server/modules/admin/functions/execute-action.mjs

@@ -0,0 +1,331 @@
+import { z } from "zod";
+import { fn } from "questpie";
+
+//#region src/server/modules/admin/functions/execute-action.ts
+/**
+* Action Execution Functions
+*
+* Server-side functions for executing collection actions.
+* Actions can be built-in (create, delete, etc.) or custom with forms.
+*
+* @example
+* ```ts
+* // Execute a custom action
+* const result = await executeAction(app, {
+*   collection: "posts",
+*   actionId: "publish",
+*   itemId: "123",
+*   data: {},
+* });
+* ```
+*/
+/**
+* Get action configuration for introspection.
+* Returns action definitions without handlers (for client-side rendering).
+*/
+function getActionsConfig(app, collectionSlug) {
+	const collection = app.state.collections?.[collectionSlug];
+	if (!collection) return null;
+	const actionsConfig = (collection.state || collection).adminActions;
+	if (!actionsConfig) return {
+		builtin: [
+			"create",
+			"save",
+			"delete",
+			"deleteMany"
+		],
+		custom: []
+	};
+	const customWithoutHandlers = (actionsConfig.custom || []).map((action) => {
+		const { handler, ...rest } = action;
+		return rest;
+	});
+	return {
+		builtin: actionsConfig.builtin || [
+			"create",
+			"save",
+			"delete",
+			"deleteMany"
+		],
+		custom: customWithoutHandlers
+	};
+}
+/**
+* Execute a collection action.
+* Handles both built-in actions and custom actions.
+*/
+async function executeAction(app, request, session) {
+	const { collection: collectionSlug, actionId, itemId, itemIds, data, locale } = request;
+	const collection = app.state.collections?.[collectionSlug];
+	if (!collection) return {
+		success: false,
+		error: `Collection "${collectionSlug}" not found`
+	};
+	const actionsConfig = (collection.state || collection).adminActions;
+	if ((actionsConfig?.builtin || [
+		"create",
+		"save",
+		"delete",
+		"deleteMany",
+		"duplicate"
+	]).includes(actionId)) return executeBuiltinAction(app, {
+		collectionSlug,
+		actionId,
+		itemId,
+		itemIds,
+		data,
+		locale,
+		session
+	});
+	const customAction = actionsConfig?.custom?.find((a) => a.id === actionId);
+	if (!customAction) return {
+		success: false,
+		error: `Action "${actionId}" not found on collection "${collectionSlug}"`
+	};
+	if (customAction.form) {
+		const validationError = validateActionFormData(customAction.form.fields, data || {});
+		if (validationError) return {
+			success: false,
+			result: {
+				type: "error",
+				toast: { message: validationError }
+			}
+		};
+	}
+	try {
+		const context = {
+			data: data || {},
+			itemId,
+			itemIds,
+			app,
+			db: app.db,
+			session,
+			locale
+		};
+		const result = await customAction.handler(context);
+		return {
+			success: result.type === "success" || result.type === "redirect",
+			result
+		};
+	} catch (error) {
+		console.error(`Action "${actionId}" failed:`, error);
+		return {
+			success: false,
+			result: {
+				type: "error",
+				toast: { message: error instanceof Error ? error.message : "Action execution failed" }
+			}
+		};
+	}
+}
+/**
+* Execute a built-in action.
+*/
+async function executeBuiltinAction(app, params) {
+	const { collectionSlug, actionId, itemId, itemIds, data } = params;
+	try {
+		switch (actionId) {
+			case "create": {
+				const result = await app.create(collectionSlug, data || {});
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: "Item created successfully" },
+						effects: {
+							invalidate: [collectionSlug],
+							redirect: `/admin/collections/${collectionSlug}/${result.id}`
+						}
+					}
+				};
+			}
+			case "save":
+				if (!itemId) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item ID is required for save action" }
+					}
+				};
+				await app.update(collectionSlug, itemId, data || {});
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: "Item saved successfully" },
+						effects: { invalidate: [collectionSlug] }
+					}
+				};
+			case "delete":
+				if (!itemId) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item ID is required for delete action" }
+					}
+				};
+				await app.delete(collectionSlug, itemId);
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: "Item deleted successfully" },
+						effects: {
+							invalidate: [collectionSlug],
+							redirect: `/admin/collections/${collectionSlug}`
+						}
+					}
+				};
+			case "deleteMany":
+				if (!itemIds || itemIds.length === 0) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item IDs are required for bulk delete action" }
+					}
+				};
+				await Promise.all(itemIds.map((id) => app.delete(collectionSlug, id)));
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: `${itemIds.length} items deleted successfully` },
+						effects: { invalidate: [collectionSlug] }
+					}
+				};
+			case "duplicate": {
+				if (!itemId) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item ID is required for duplicate action" }
+					}
+				};
+				const original = await app.findById(collectionSlug, itemId);
+				if (!original) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item not found" }
+					}
+				};
+				const { id, createdAt, updatedAt, ...duplicateData } = original;
+				const duplicated = await app.create(collectionSlug, duplicateData);
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: "Item duplicated successfully" },
+						effects: {
+							invalidate: [collectionSlug],
+							redirect: `/admin/collections/${collectionSlug}/${duplicated.id}`
+						}
+					}
+				};
+			}
+			default: return {
+				success: false,
+				result: {
+					type: "error",
+					toast: { message: `Unknown built-in action: ${actionId}` }
+				}
+			};
+		}
+	} catch (error) {
+		console.error(`Built-in action "${actionId}" failed:`, error);
+		return {
+			success: false,
+			result: {
+				type: "error",
+				toast: { message: error instanceof Error ? error.message : "Action execution failed" }
+			}
+		};
+	}
+}
+/**
+* Check if a field is a ServerActionFormFieldDefinition (has getMetadata)
+*/
+function isFieldDefinition(field$1) {
+	return typeof field$1.getMetadata === "function";
+}
+/**
+* Extract required status from a form field (handles both config and definition)
+*/
+function isFieldRequired(field$1) {
+	if (isFieldDefinition(field$1)) return !!field$1.state?.required;
+	return !!field$1.required;
+}
+/**
+* Validate form data against action form fields.
+* Returns error message if validation fails, null if valid.
+*/
+function validateActionFormData(fields, data) {
+	for (const [fieldName, fieldConfig] of Object.entries(fields)) if (isFieldRequired(fieldConfig) && !data[fieldName]) return `Field "${fieldName}" is required`;
+	return null;
+}
+const executeActionRequestSchema = z.object({
+	collection: z.string(),
+	actionId: z.string(),
+	itemId: z.string().optional(),
+	itemIds: z.array(z.string()).optional(),
+	data: z.record(z.string(), z.unknown()).optional(),
+	locale: z.string().optional()
+});
+const executeActionResponseSchema = z.object({
+	success: z.boolean(),
+	result: z.unknown().optional(),
+	error: z.string().optional()
+});
+const getActionsConfigRequestSchema = z.object({ collection: z.string() });
+const getActionsConfigResponseSchema = z.object({
+	builtin: z.array(z.string()),
+	custom: z.array(z.unknown())
+}).nullable();
+/**
+* Execute a collection action.
+*
+* @example
+* ```ts
+* // From client
+* const result = await cms.api.functions.executeAction({
+*   collection: "posts",
+*   actionId: "publish",
+*   itemId: "123",
+* });
+* ```
+*/
+const executeActionFn = fn({
+	type: "mutation",
+	schema: executeActionRequestSchema,
+	outputSchema: executeActionResponseSchema,
+	handler: async (ctx) => {
+		const app = ctx.app;
+		const session = ctx.session;
+		return executeAction(app, ctx.input, session);
+	}
+});
+/**
+* Get actions configuration for a collection.
+* Returns action definitions without handlers for client rendering.
+*/
+const getActionsConfigFn = fn({
+	type: "query",
+	schema: getActionsConfigRequestSchema,
+	outputSchema: getActionsConfigResponseSchema,
+	handler: (ctx) => {
+		const app = ctx.app;
+		return getActionsConfig(app, ctx.input.collection);
+	}
+});
+/**
+* CMS functions for action execution.
+* These are registered on the adminModule.
+*/
+const actionFunctions = {
+	executeAction: executeActionFn,
+	getActionsConfig: getActionsConfigFn
+};
+
+//#endregion
+export { actionFunctions, executeAction, executeActionFn, getActionsConfig, getActionsConfigFn };
+//# sourceMappingURL=execute-action.mjs.map

package/dist/server/modules/admin/functions/execute-action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-action.mjs","names":["actionsConfig: ServerActionsConfig | undefined","context: ServerActionContext","field"],"sources":["../../../../../src/server/modules/admin/functions/execute-action.ts"],"sourcesContent":["/**\n * Action Execution Functions\n *\n * Server-side functions for executing collection actions.\n * Actions can be built-in (create, delete, etc.) or custom with forms.\n *\n * @example\n * ```ts\n * // Execute a custom action\n * const result = await executeAction(app, {\n *   collection: \"posts\",\n *   actionId: \"publish\",\n *   itemId: \"123\",\n *   data: {},\n * });\n * ```\n */\n\nimport { fn, type Questpie } from \"questpie\";\nimport { z } from \"zod\";\nimport type {\n  ServerActionContext,\n  ServerActionDefinition,\n  ServerActionFormField,\n  ServerActionResult,\n  ServerActionsConfig,\n} from \"../../../augmentation.js\";\n\n// Type alias for the CMS app\ntype App = Questpie<any>;\n\n/**\n * Request to execute an action\n */\nexport interface ExecuteActionRequest {\n  /** Collection slug */\n  collection: string;\n  /** Action ID (builtin: \"create\", \"delete\", etc. or custom id) */\n  actionId: string;\n  /** Single item ID (for single-item actions) */\n  itemId?: string;\n  /** Multiple item IDs (for bulk actions) */\n  itemIds?: string[];\n  /** Form data (for actions with forms) */\n  data?: Record<string, unknown>;\n  /** Current locale */\n  locale?: string;\n}\n\n/**\n * Response from action execution\n */\nexport interface ExecuteActionResponse {\n  success: boolean;\n  result?: ServerActionResult;\n  error?: string;\n}\n\n/**\n * Get action configuration for introspection.\n * Returns action definitions without handlers (for client-side rendering).\n */\nexport function getActionsConfig(\n  app: App,\n  collectionSlug: string,\n): {\n  builtin: string[];\n  custom: Array<Omit<ServerActionDefinition, \"handler\">>;\n} | null {\n  const state = (app as any).state as any;\n  const collection = state.collections?.[collectionSlug];\n\n  if (!collection) {\n    return null;\n  }\n\n  const collectionState = collection.state || collection;\n  const actionsConfig: ServerActionsConfig | undefined =\n    collectionState.adminActions;\n\n  if (!actionsConfig) {\n    // Return default built-in actions if no config\n    return {\n      builtin: [\"create\", \"save\", \"delete\", \"deleteMany\"],\n      custom: [],\n    };\n  }\n\n  // Strip handlers from custom actions for client\n  const customWithoutHandlers = (actionsConfig.custom || []).map((action) => {\n    const { handler, ...rest } = action;\n    return rest;\n  });\n\n  return {\n    builtin: actionsConfig.builtin || [\n      \"create\",\n      \"save\",\n      \"delete\",\n      \"deleteMany\",\n    ],\n    custom: customWithoutHandlers,\n  };\n}\n\n/**\n * Execute a collection action.\n * Handles both built-in actions and custom actions.\n */\nexport async function executeAction(\n  app: App,\n  request: ExecuteActionRequest,\n  session?: unknown,\n): Promise<ExecuteActionResponse> {\n  const {\n    collection: collectionSlug,\n    actionId,\n    itemId,\n    itemIds,\n    data,\n    locale,\n  } = request;\n\n  const state = (app as any).state as any;\n  const collection = state.collections?.[collectionSlug];\n\n  if (!collection) {\n    return {\n      success: false,\n      error: `Collection \"${collectionSlug}\" not found`,\n    };\n  }\n\n  const collectionState = collection.state || collection;\n  const actionsConfig: ServerActionsConfig | undefined =\n    collectionState.adminActions;\n\n  // Handle built-in actions\n  const builtinActions = actionsConfig?.builtin || [\n    \"create\",\n    \"save\",\n    \"delete\",\n    \"deleteMany\",\n    \"duplicate\",\n  ];\n\n  if (builtinActions.includes(actionId as any)) {\n    return executeBuiltinAction(app, {\n      collectionSlug,\n      actionId,\n      itemId,\n      itemIds,\n      data,\n      locale,\n      session,\n    });\n  }\n\n  // Find custom action\n  const customAction = actionsConfig?.custom?.find((a) => a.id === actionId);\n\n  if (!customAction) {\n    return {\n      success: false,\n      error: `Action \"${actionId}\" not found on collection \"${collectionSlug}\"`,\n    };\n  }\n\n  // Validate form data if action has a form\n  if (customAction.form) {\n    const validationError = validateActionFormData(\n      customAction.form.fields,\n      data || {},\n    );\n    if (validationError) {\n      return {\n        success: false,\n        result: {\n          type: \"error\",\n          toast: { message: validationError },\n        },\n      };\n    }\n  }\n\n  // Execute custom action handler\n  try {\n    const context: ServerActionContext = {\n      data: data || {},\n      itemId,\n      itemIds,\n      app,\n      db: (app as any).db,\n      session,\n      locale,\n    };\n\n    const result = await customAction.handler(context);\n\n    return {\n      success: result.type === \"success\" || result.type === \"redirect\",\n      result,\n    };\n  } catch (error) {\n    console.error(`Action \"${actionId}\" failed:`, error);\n    return {\n      success: false,\n      result: {\n        type: \"error\",\n        toast: {\n          message:\n            error instanceof Error ? error.message : \"Action execution failed\",\n        },\n      },\n    };\n  }\n}\n\n/**\n * Execute a built-in action.\n */\nasync function executeBuiltinAction(\n  app: App,\n  params: {\n    collectionSlug: string;\n    actionId: string;\n    itemId?: string;\n    itemIds?: string[];\n    data?: Record<string, unknown>;\n    locale?: string;\n    session?: unknown;\n  },\n): Promise<ExecuteActionResponse> {\n  const { collectionSlug, actionId, itemId, itemIds, data } = params;\n\n  try {\n    switch (actionId) {\n      case \"create\": {\n        const result = await (app as any).create(collectionSlug, data || {});\n        return {\n          success: true,\n          result: {\n            type: \"success\",\n            toast: { message: \"Item created successfully\" },\n            effects: {\n              invalidate: [collectionSlug],\n              redirect: `/admin/collections/${collectionSlug}/${result.id}`,\n            },\n          },\n        };\n      }\n\n      case \"save\": {\n        if (!itemId) {\n          return {\n            success: false,\n            result: {\n              type: \"error\",\n              toast: { message: \"Item ID is required for save action\" },\n            },\n          };\n        }\n        await (app as any).update(collectionSlug, itemId, data || {});\n        return {\n          success: true,\n          result: {\n            type: \"success\",\n            toast: { message: \"Item saved successfully\" },\n            effects: { invalidate: [collectionSlug] },\n          },\n        };\n      }\n\n      case \"delete\": {\n        if (!itemId) {\n          return {\n            success: false,\n            result: {\n              type: \"error\",\n              toast: { message: \"Item ID is required for delete action\" },\n            },\n          };\n        }\n        await (app as any).delete(collectionSlug, itemId);\n        return {\n          success: true,\n          result: {\n            type: \"success\",\n            toast: { message: \"Item deleted successfully\" },\n            effects: {\n              invalidate: [collectionSlug],\n              redirect: `/admin/collections/${collectionSlug}`,\n            },\n          },\n        };\n      }\n\n      case \"deleteMany\": {\n        if (!itemIds || itemIds.length === 0) {\n          return {\n            success: false,\n            result: {\n              type: \"error\",\n              toast: {\n                message: \"Item IDs are required for bulk delete action\",\n              },\n            },\n          };\n        }\n        // Delete items in parallel\n        await Promise.all(\n          itemIds.map((id) => (app as any).delete(collectionSlug, id)),\n        );\n        return {\n          success: true,\n          result: {\n            type: \"success\",\n            toast: { message: `${itemIds.length} items deleted successfully` },\n            effects: { invalidate: [collectionSlug] },\n          },\n        };\n      }\n\n      case \"duplicate\": {\n        if (!itemId) {\n          return {\n            success: false,\n            result: {\n              type: \"error\",\n              toast: { message: \"Item ID is required for duplicate action\" },\n            },\n          };\n        }\n        const original = await (app as any).findById(collectionSlug, itemId);\n        if (!original) {\n          return {\n            success: false,\n            result: {\n              type: \"error\",\n              toast: { message: \"Item not found\" },\n            },\n          };\n        }\n        // Remove id and timestamps for duplication\n        const { id, createdAt, updatedAt, ...duplicateData } = original;\n        const duplicated = await (app as any).create(\n          collectionSlug,\n          duplicateData,\n        );\n        return {\n          success: true,\n          result: {\n            type: \"success\",\n            toast: { message: \"Item duplicated successfully\" },\n            effects: {\n              invalidate: [collectionSlug],\n              redirect: `/admin/collections/${collectionSlug}/${duplicated.id}`,\n            },\n          },\n        };\n      }\n\n      default:\n        return {\n          success: false,\n          result: {\n            type: \"error\",\n            toast: { message: `Unknown built-in action: ${actionId}` },\n          },\n        };\n    }\n  } catch (error) {\n    console.error(`Built-in action \"${actionId}\" failed:`, error);\n    return {\n      success: false,\n      result: {\n        type: \"error\",\n        toast: {\n          message:\n            error instanceof Error ? error.message : \"Action execution failed\",\n        },\n      },\n    };\n  }\n}\n\n/**\n * Check if a field is a ServerActionFormFieldDefinition (has getMetadata)\n */\nfunction isFieldDefinition(\n  field: ServerActionFormField,\n): field is { state: any; getMetadata(): any; toZodSchema(): unknown } {\n  return typeof (field as any).getMetadata === \"function\";\n}\n\n/**\n * Extract required status from a form field (handles both config and definition)\n */\nfunction isFieldRequired(field: ServerActionFormField): boolean {\n  if (isFieldDefinition(field)) {\n    return !!field.state?.required;\n  }\n  return !!field.required;\n}\n\n/**\n * Validate form data against action form fields.\n * Returns error message if validation fails, null if valid.\n */\nfunction validateActionFormData(\n  fields: Record<string, ServerActionFormField>,\n  data: Record<string, unknown>,\n): string | null {\n  for (const [fieldName, fieldConfig] of Object.entries(fields)) {\n    if (isFieldRequired(fieldConfig) && !data[fieldName]) {\n      return `Field \"${fieldName}\" is required`;\n    }\n  }\n  return null;\n}\n\n// ============================================================================\n// Schema Definitions\n// ============================================================================\n\nconst executeActionRequestSchema = z.object({\n  collection: z.string(),\n  actionId: z.string(),\n  itemId: z.string().optional(),\n  itemIds: z.array(z.string()).optional(),\n  data: z.record(z.string(), z.unknown()).optional(),\n  locale: z.string().optional(),\n});\n\nconst executeActionResponseSchema = z.object({\n  success: z.boolean(),\n  result: z.unknown().optional(),\n  error: z.string().optional(),\n});\n\nconst getActionsConfigRequestSchema = z.object({\n  collection: z.string(),\n});\n\nconst getActionsConfigResponseSchema = z\n  .object({\n    builtin: z.array(z.string()),\n    custom: z.array(z.unknown()),\n  })\n  .nullable();\n\n// ============================================================================\n// CMS Functions\n// ============================================================================\n\n/**\n * Execute a collection action.\n *\n * @example\n * ```ts\n * // From client\n * const result = await cms.api.functions.executeAction({\n *   collection: \"posts\",\n *   actionId: \"publish\",\n *   itemId: \"123\",\n * });\n * ```\n */\nexport const executeActionFn = fn({\n  type: \"mutation\",\n  schema: executeActionRequestSchema,\n  outputSchema: executeActionResponseSchema,\n  handler: async (ctx) => {\n    const app = ctx.app as App;\n    const session = (ctx as any).session;\n    return executeAction(app, ctx.input, session);\n  },\n});\n\n/**\n * Get actions configuration for a collection.\n * Returns action definitions without handlers for client rendering.\n */\nexport const getActionsConfigFn = fn({\n  type: \"query\",\n  schema: getActionsConfigRequestSchema,\n  outputSchema: getActionsConfigResponseSchema,\n  handler: (ctx) => {\n    const app = ctx.app as App;\n    return getActionsConfig(app, ctx.input.collection);\n  },\n});\n\n/**\n * CMS functions for action execution.\n * These are registered on the adminModule.\n */\nexport const actionFunctions = {\n  executeAction: executeActionFn,\n  getActionsConfig: getActionsConfigFn,\n};\n"],"mappings":"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"}

package/dist/server/modules/admin/functions/locales.mjs

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { fn } from "questpie";
+
+//#region src/server/modules/admin/functions/locales.ts
+/**
+* Content Locales Functions
+*
+* Functions for retrieving available content locales from the CMS configuration.
+* Used by the admin panel to populate locale switchers and validate locale selection.
+*/
+/**
+* Helper to get typed CMS app from handler context.
+*/
+function getApp(ctx) {
+	return ctx.app;
+}
+const getContentLocalesSchema = z.object({}).optional();
+const getContentLocalesOutputSchema = z.object({
+	locales: z.array(z.object({
+		code: z.string(),
+		label: z.string().optional(),
+		fallback: z.boolean().optional(),
+		flagCountryCode: z.string().optional()
+	})),
+	defaultLocale: z.string(),
+	fallbacks: z.record(z.string(), z.string()).optional()
+});
+/**
+* Get available content locales from CMS configuration.
+*
+* Returns the list of available locales for content localization,
+* the default locale, and any fallback mappings.
+*
+* @example
+* ```ts
+* const result = await client.rpc.getContentLocales({});
+* // {
+* //   locales: [
+* //     { code: "en", label: "English", fallback: true },
+* //     { code: "sk", label: "Slovenčina" },
+* //   ],
+* //   defaultLocale: "en",
+* //   fallbacks: { "en-GB": "en" },
+* // }
+* ```
+*/
+const getContentLocales = fn({
+	type: "query",
+	schema: getContentLocalesSchema,
+	outputSchema: getContentLocalesOutputSchema,
+	handler: async (ctx) => {
+		const localeConfig = getApp(ctx).config.locale;
+		if (!localeConfig) return {
+			locales: [{
+				code: "en",
+				label: "English",
+				fallback: true
+			}],
+			defaultLocale: "en"
+		};
+		return {
+			locales: (typeof localeConfig.locales === "function" ? await localeConfig.locales() : localeConfig.locales).map((l) => ({
+				code: l.code,
+				label: l.label,
+				fallback: l.fallback,
+				flagCountryCode: l.flagCountryCode
+			})),
+			defaultLocale: localeConfig.defaultLocale,
+			fallbacks: localeConfig.fallbacks
+		};
+	}
+});
+/**
+* Bundle of locale-related functions.
+*/
+const localeFunctions = { getContentLocales };
+
+//#endregion
+export { getContentLocales, localeFunctions };
+//# sourceMappingURL=locales.mjs.map

package/dist/server/modules/admin/functions/locales.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.mjs","names":[],"sources":["../../../../../src/server/modules/admin/functions/locales.ts"],"sourcesContent":["/**\n * Content Locales Functions\n *\n * Functions for retrieving available content locales from the CMS configuration.\n * Used by the admin panel to populate locale switchers and validate locale selection.\n */\n\nimport { fn, type Questpie } from \"questpie\";\nimport { z } from \"zod\";\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Helper to get typed CMS app from handler context.\n */\nfunction getApp(ctx: { app: unknown }): Questpie<any> {\n  return ctx.app as Questpie<any>;\n}\n\n// ============================================================================\n// Schema Definitions\n// ============================================================================\n\nconst getContentLocalesSchema = z.object({}).optional();\n\nconst getContentLocalesOutputSchema = z.object({\n  locales: z.array(\n    z.object({\n      code: z.string(),\n      label: z.string().optional(),\n      fallback: z.boolean().optional(),\n      flagCountryCode: z.string().optional(),\n    }),\n  ),\n  defaultLocale: z.string(),\n  fallbacks: z.record(z.string(), z.string()).optional(),\n});\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Get available content locales from CMS configuration.\n *\n * Returns the list of available locales for content localization,\n * the default locale, and any fallback mappings.\n *\n * @example\n * ```ts\n * const result = await client.rpc.getContentLocales({});\n * // {\n * //   locales: [\n * //     { code: \"en\", label: \"English\", fallback: true },\n * //     { code: \"sk\", label: \"Slovenčina\" },\n * //   ],\n * //   defaultLocale: \"en\",\n * //   fallbacks: { \"en-GB\": \"en\" },\n * // }\n * ```\n */\nexport const getContentLocales = fn({\n  type: \"query\",\n  schema: getContentLocalesSchema,\n  outputSchema: getContentLocalesOutputSchema,\n  handler: async (ctx) => {\n    const cms = getApp(ctx);\n    const localeConfig = cms.config.locale;\n\n    // If no locale config, return sensible defaults\n    if (!localeConfig) {\n      return {\n        locales: [{ code: \"en\", label: \"English\", fallback: true }],\n        defaultLocale: \"en\",\n      };\n    }\n\n    // Resolve locales (can be async function)\n    const locales =\n      typeof localeConfig.locales === \"function\"\n        ? await localeConfig.locales()\n        : localeConfig.locales;\n\n    return {\n      locales: locales.map(\n        (l: {\n          code: string;\n          label?: string;\n          fallback?: boolean;\n          flagCountryCode?: string;\n        }) => ({\n          code: l.code,\n          label: l.label,\n          fallback: l.fallback,\n          flagCountryCode: l.flagCountryCode,\n        }),\n      ),\n      defaultLocale: localeConfig.defaultLocale,\n      fallbacks: localeConfig.fallbacks,\n    };\n  },\n});\n\n// ============================================================================\n// Export Bundle\n// ============================================================================\n\n/**\n * Bundle of locale-related functions.\n */\nexport const localeFunctions = {\n  getContentLocales,\n} as const;\n"],"mappings":";;;;;;;;;;;;;AAiBA,SAAS,OAAO,KAAsC;AACpD,QAAO,IAAI;;AAOb,MAAM,0BAA0B,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU;AAEvD,MAAM,gCAAgC,EAAE,OAAO;CAC7C,SAAS,EAAE,MACT,EAAE,OAAO;EACP,MAAM,EAAE,QAAQ;EAChB,OAAO,EAAE,QAAQ,CAAC,UAAU;EAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;EAChC,iBAAiB,EAAE,QAAQ,CAAC,UAAU;EACvC,CAAC,CACH;CACD,eAAe,EAAE,QAAQ;CACzB,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC,UAAU;CACvD,CAAC;;;;;;;;;;;;;;;;;;;;AAyBF,MAAa,oBAAoB,GAAG;CAClC,MAAM;CACN,QAAQ;CACR,cAAc;CACd,SAAS,OAAO,QAAQ;EAEtB,MAAM,eADM,OAAO,IAAI,CACE,OAAO;AAGhC,MAAI,CAAC,aACH,QAAO;GACL,SAAS,CAAC;IAAE,MAAM;IAAM,OAAO;IAAW,UAAU;IAAM,CAAC;GAC3D,eAAe;GAChB;AASH,SAAO;GACL,UALA,OAAO,aAAa,YAAY,aAC5B,MAAM,aAAa,SAAS,GAC5B,aAAa,SAGA,KACd,OAKM;IACL,MAAM,EAAE;IACR,OAAO,EAAE;IACT,UAAU,EAAE;IACZ,iBAAiB,EAAE;IACpB,EACF;GACD,eAAe,aAAa;GAC5B,WAAW,aAAa;GACzB;;CAEJ,CAAC;;;;AASF,MAAa,kBAAkB,EAC7B,mBACD"}

package/dist/server/modules/admin/functions/preview.d.mts

@@ -0,0 +1,70 @@
+import * as questpie18964 from "questpie";
+
+//#region src/server/modules/admin/functions/preview.d.ts
+
+/**
+ * Preview Functions - Server-side
+ *
+ * RPC functions for draft mode preview.
+ * Handles token minting for secure, shareable preview links.
+ *
+ * Browser-safe utilities (isDraftMode, createDraftModeCookie, etc.) are in @questpie/admin/shared
+ */
+interface PreviewTokenPayload {
+  path: string;
+  exp: number;
+}
+/**
+ * Create preview-related RPC functions.
+ *
+ * @param secret - Secret key for signing tokens
+ * @returns Object with preview functions
+ */
+declare function createPreviewFunctions(secret: string): {
+  mintPreviewToken: questpie18964.JsonFunctionDefinition<{
+    path: string;
+    ttlMs?: number | undefined;
+  }, {
+    token: string;
+    expiresAt: number;
+  }>;
+  verifyPreviewToken: questpie18964.JsonFunctionDefinition<{
+    token: string;
+  }, {
+    valid: boolean;
+    path?: string | undefined;
+    error?: string | undefined;
+  }>;
+};
+/**
+ * Verify a preview token without RPC.
+ * Used directly in route handlers where RPC is not available.
+ *
+ * @param token - The preview token to verify
+ * @param secret - The secret used to sign the token
+ * @returns The payload if valid, null otherwise
+ */
+declare function verifyPreviewTokenDirect(token: string, secret: string): PreviewTokenPayload | null;
+/**
+ * Create a preview token verifier with bound secret.
+ * Use this in route handlers to avoid passing secret repeatedly.
+ *
+ * @param secret - The secret used to sign tokens (optional, uses env if not provided)
+ * @returns A verify function that only needs the token
+ *
+ * @example
+ * ```ts
+ * // Create once at module level
+ * const verifyPreviewToken = createPreviewTokenVerifier();
+ *
+ * // Use in route handler
+ * const payload = verifyPreviewToken(token);
+ * if (!payload) {
+ *   return new Response("Invalid token", { status: 401 });
+ * }
+ * ```
+ */
+declare function createPreviewTokenVerifier(secret?: string): (token: string) => PreviewTokenPayload | null;
+//#endregion
+export { PreviewTokenPayload, createPreviewFunctions, createPreviewTokenVerifier, verifyPreviewTokenDirect };
+//# sourceMappingURL=preview.d.mts.map

package/dist/server/modules/admin/functions/preview.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.mts","names":[],"sources":["../../../../../src/server/modules/admin/functions/preview.ts"],"sourcesContent":[],"mappings":";;;;;;;AAiEA;AAiBA;AAgIA;AAuDA;;UAxMiB,mBAAA;;;;;;;;;;iBAiBD,sBAAA;oBAAsB,aAAA,CAAA;;;;;;;sBAAA,aAAA,CAAA;;;;;;;;;;;;;;;;iBAgItB,wBAAA,iCAGb;;;;;;;;;;;;;;;;;;;;iBAoDa,0BAAA,sCAGS"}