@questpie/admin 2.0.0 → 3.0.0

package/dist/server/modules/admin/{functions → routes}/execute-action.mjs

@@ -1,7 +1,8 @@
+import { getApp, getAppState, getSession } from "./route-helpers.mjs";
 import { z } from "zod";
-import { fn } from "questpie";
+import { route } from "questpie";
 
-//#region src/server/modules/admin/functions/execute-action.ts
+//#region src/server/modules/admin/routes/execute-action.ts
 /**
 * Action Execution Functions
 *
@@ -24,15 +25,19 @@ import { fn } from "questpie";
 * 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;
+	const collection$1 = getAppState(app).collections?.[collectionSlug];
+	if (!collection$1) return null;
+	const actionsConfig = (collection$1.state || collection$1).adminActions;
 	if (!actionsConfig) return {
 		builtin: [
 			"create",
 			"save",
 			"delete",
-			"deleteMany"
+			"deleteMany",
+			"restore",
+			"restoreMany",
+			"duplicate",
+			"transition"
 		],
 		custom: []
 	};
@@ -45,7 +50,10 @@ function getActionsConfig(app, collectionSlug) {
 			"create",
 			"save",
 			"delete",
-			"deleteMany"
+			"deleteMany",
+			"restore",
+			"restoreMany",
+			"duplicate"
 		],
 		custom: customWithoutHandlers
 	};
@@ -56,18 +64,21 @@ function getActionsConfig(app, collectionSlug) {
 */
 async function executeAction(app, request, session) {
 	const { collection: collectionSlug, actionId, itemId, itemIds, data, locale } = request;
-	const collection = app.state.collections?.[collectionSlug];
-	if (!collection) return {
+	const collection$1 = getAppState(app).collections?.[collectionSlug];
+	if (!collection$1) return {
 		success: false,
 		error: `Collection "${collectionSlug}" not found`
 	};
-	const actionsConfig = (collection.state || collection).adminActions;
+	const actionsConfig = (collection$1.state || collection$1).adminActions;
 	if ((actionsConfig?.builtin || [
 		"create",
 		"save",
 		"delete",
 		"deleteMany",
-		"duplicate"
+		"restore",
+		"restoreMany",
+		"duplicate",
+		"transition"
 	]).includes(actionId)) return executeBuiltinAction(app, {
 		collectionSlug,
 		actionId,
@@ -93,12 +104,15 @@ async function executeAction(app, request, session) {
 		};
 	}
 	try {
+		const appRec = app;
 		const context = {
 			data: data || {},
 			itemId,
 			itemIds,
-			app,
-			db: app.db,
+			auth: appRec.auth,
+			collections: appRec.api?.collections,
+			globals: appRec.api?.globals,
+			db: appRec.db,
 			session,
 			locale
 		};
@@ -123,10 +137,17 @@ async function executeAction(app, request, session) {
 */
 async function executeBuiltinAction(app, params) {
 	const { collectionSlug, actionId, itemId, itemIds, data } = params;
+	const appRec = app;
+	const collectionCrud = appRec.api?.collections?.[collectionSlug];
+	const crudContext = {
+		db: appRec.db,
+		session: params.session,
+		locale: params.locale
+	};
 	try {
 		switch (actionId) {
 			case "create": {
-				const result = await app.create(collectionSlug, data || {});
+				const result = await appRec.create(collectionSlug, data || {});
 				return {
 					success: true,
 					result: {
@@ -147,7 +168,7 @@ async function executeBuiltinAction(app, params) {
 						toast: { message: "Item ID is required for save action" }
 					}
 				};
-				await app.update(collectionSlug, itemId, data || {});
+				await appRec.update(collectionSlug, itemId, data || {});
 				return {
 					success: true,
 					result: {
@@ -164,7 +185,7 @@ async function executeBuiltinAction(app, params) {
 						toast: { message: "Item ID is required for delete action" }
 					}
 				};
-				await app.delete(collectionSlug, itemId);
+				await appRec.delete(collectionSlug, itemId);
 				return {
 					success: true,
 					result: {
@@ -184,7 +205,7 @@ async function executeBuiltinAction(app, params) {
 						toast: { message: "Item IDs are required for bulk delete action" }
 					}
 				};
-				await Promise.all(itemIds.map((id) => app.delete(collectionSlug, id)));
+				await Promise.all(itemIds.map((id) => appRec.delete(collectionSlug, id)));
 				return {
 					success: true,
 					result: {
@@ -193,6 +214,59 @@ async function executeBuiltinAction(app, params) {
 						effects: { invalidate: [collectionSlug] }
 					}
 				};
+			case "restore":
+				if (!itemId) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item ID is required for restore action" }
+					}
+				};
+				if (typeof appRec.restore === "function") await appRec.restore(collectionSlug, itemId);
+				else if (collectionCrud?.restoreById) await collectionCrud.restoreById({ id: itemId }, crudContext);
+				else return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Restore is not supported for this collection" }
+					}
+				};
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: "Item restored successfully" },
+						effects: {
+							invalidate: [collectionSlug],
+							redirect: `/admin/collections/${collectionSlug}/${itemId}`
+						}
+					}
+				};
+			case "restoreMany":
+				if (!itemIds || itemIds.length === 0) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item IDs are required for bulk restore action" }
+					}
+				};
+				if (typeof appRec.restore === "function") await Promise.all(itemIds.map((id) => appRec.restore(collectionSlug, id)));
+				else if (collectionCrud?.restoreById) await Promise.all(itemIds.map((id) => collectionCrud.restoreById({ id }, crudContext)));
+				else return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Restore is not supported for this collection" }
+					}
+				};
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: `${itemIds.length} items restored successfully` },
+						effects: { invalidate: [collectionSlug] }
+					}
+				};
 			case "duplicate": {
 				if (!itemId) return {
 					success: false,
@@ -201,7 +275,7 @@ async function executeBuiltinAction(app, params) {
 						toast: { message: "Item ID is required for duplicate action" }
 					}
 				};
-				const original = await app.findById(collectionSlug, itemId);
+				const original = await appRec.findById(collectionSlug, itemId);
 				if (!original) return {
 					success: false,
 					result: {
@@ -210,7 +284,7 @@ async function executeBuiltinAction(app, params) {
 					}
 				};
 				const { id, createdAt, updatedAt, ...duplicateData } = original;
-				const duplicated = await app.create(collectionSlug, duplicateData);
+				const duplicated = await appRec.create(collectionSlug, duplicateData);
 				return {
 					success: true,
 					result: {
@@ -223,6 +297,46 @@ async function executeBuiltinAction(app, params) {
 					}
 				};
 			}
+			case "transition": {
+				if (!itemId) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Item ID is required for transition action" }
+					}
+				};
+				const stage = data?.stage;
+				if (!stage) return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Target stage is required for transition action" }
+					}
+				};
+				if (collectionCrud?.transitionStage) {
+					const scheduledAt = data?.scheduledAt;
+					const transitionParams = {
+						id: itemId,
+						stage
+					};
+					if (scheduledAt) transitionParams.scheduledAt = new Date(scheduledAt);
+					await collectionCrud.transitionStage(transitionParams, crudContext);
+				} else return {
+					success: false,
+					result: {
+						type: "error",
+						toast: { message: "Workflow transitions are not supported for this collection" }
+					}
+				};
+				return {
+					success: true,
+					result: {
+						type: "success",
+						toast: { message: `Transitioned to "${stage}" successfully` },
+						effects: { invalidate: [collectionSlug] }
+					}
+				};
+			}
 			default: return {
 				success: false,
 				result: {
@@ -252,7 +366,7 @@ function isFieldDefinition(field$1) {
 * 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;
+	if (isFieldDefinition(field$1)) return !!field$1._state?.notNull;
 	return !!field$1.required;
 }
 /**
@@ -273,13 +387,13 @@ const executeActionRequestSchema = z.object({
 });
 const executeActionResponseSchema = z.object({
 	success: z.boolean(),
-	result: z.unknown().optional(),
+	result: z.record(z.string(), z.any()).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())
+	custom: z.array(z.record(z.string(), z.any()))
 }).nullable();
 /**
 * Execute a collection action.
@@ -287,39 +401,28 @@ const getActionsConfigResponseSchema = z.object({
 * @example
 * ```ts
 * // From client
-* const result = await cms.api.functions.executeAction({
+* const result = await client.routes.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);
-	}
+const executeActionFn = route().post().schema(executeActionRequestSchema).outputSchema(executeActionResponseSchema).handler(async (ctx) => {
+	const app = getApp(ctx);
+	const session = getSession(ctx);
+	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);
-	}
+const getActionsConfigFn = route().post().schema(getActionsConfigRequestSchema).outputSchema(getActionsConfigResponseSchema).handler((ctx) => {
+	return getActionsConfig(getApp(ctx), ctx.input.collection);
 });
 /**
-* CMS functions for action execution.
-* These are registered on the adminModule.
+* QUESTPIE functions for action execution.
+* These are registered on the `adminModule`.
 */
 const actionFunctions = {
 	executeAction: executeActionFn,
@@ -327,5 +430,4 @@ const actionFunctions = {
 };
 
 //#endregion
-export { actionFunctions, executeAction, executeActionFn, getActionsConfig, getActionsConfigFn };
-//# sourceMappingURL=execute-action.mjs.map
+export { actionFunctions, executeAction, executeActionFn, getActionsConfig, getActionsConfigFn };

package/dist/server/modules/admin/routes/locales.d.mts

@@ -0,0 +1,18 @@
+import * as questpie312 from "questpie";
+
+//#region src/server/modules/admin/routes/locales.d.ts
+
+/**
+ * Content Locales Functions
+ *
+ * Functions for retrieving available content locales from the app configuration.
+ * Used by the admin panel to populate locale switchers and validate locale selection.
+ */
+/**
+ * Bundle of locale-related functions.
+ */
+declare const localeFunctions: {
+  readonly getContentLocales: questpie312.JsonRouteDefinition<Record<string, never> | undefined, any>;
+};
+//#endregion
+export { localeFunctions };

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

@@ -0,0 +1,69 @@
+import { getApp } from "./route-helpers.mjs";
+import { z } from "zod";
+import { route } from "questpie";
+
+//#region src/server/modules/admin/routes/locales.ts
+/**
+* Content Locales Functions
+*
+* Functions for retrieving available content locales from the app configuration.
+* Used by the admin panel to populate locale switchers and validate locale selection.
+*/
+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 app configuration.
+*
+* Returns the list of available locales for content localization,
+* the default locale, and any fallback mappings.
+*
+* @example
+* ```ts
+* const result = await client.routes.getContentLocales({});
+* // {
+* //   locales: [
+* //     { code: "en", label: "English", fallback: true },
+* //     { code: "sk", label: "Slovenčina" },
+* //   ],
+* //   defaultLocale: "en",
+* //   fallbacks: { "en-GB": "en" },
+* // }
+* ```
+*/
+const getContentLocales = route().post().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 { localeFunctions };

package/dist/server/modules/admin/{functions → routes}/preview.d.mts

@@ -1,6 +1,6 @@
-import * as questpie18964 from "questpie";
+import * as questpie109 from "questpie";
 
-//#region src/server/modules/admin/functions/preview.d.ts
+//#region src/server/modules/admin/routes/preview.d.ts
 
 /**
  * Preview Functions - Server-side
@@ -21,20 +21,13 @@ interface PreviewTokenPayload {
  * @returns Object with preview functions
  */
 declare function createPreviewFunctions(secret: string): {
-  mintPreviewToken: questpie18964.JsonFunctionDefinition<{
+  mintPreviewToken: questpie109.JsonRouteDefinition<{
     path: string;
     ttlMs?: number | undefined;
-  }, {
+  }, any>;
+  verifyPreviewToken: questpie109.JsonRouteDefinition<{
     token: string;
-    expiresAt: number;
-  }>;
-  verifyPreviewToken: questpie18964.JsonFunctionDefinition<{
-    token: string;
-  }, {
-    valid: boolean;
-    path?: string | undefined;
-    error?: string | undefined;
-  }>;
+  }, any>;
 };
 /**
  * Verify a preview token without RPC.
@@ -65,6 +58,23 @@ declare function verifyPreviewTokenDirect(token: string, secret: string): Previe
  * ```
  */
 declare function createPreviewTokenVerifier(secret?: string): (token: string) => PreviewTokenPayload | null;
+/**
+ * Default preview functions bundle with env-based secret.
+ * Used by the `adminModule` to register preview RPC functions.
+ */
+declare const previewFunctions: {
+  getPreviewUrl: questpie109.JsonRouteDefinition<{
+    collection: string;
+    record: Record<string, unknown>;
+    locale?: string | undefined;
+  }, any>;
+  mintPreviewToken: questpie109.JsonRouteDefinition<{
+    path: string;
+    ttlMs?: number | undefined;
+  }, any>;
+  verifyPreviewToken: questpie109.JsonRouteDefinition<{
+    token: string;
+  }, any>;
+};
 //#endregion
-export { PreviewTokenPayload, createPreviewFunctions, createPreviewTokenVerifier, verifyPreviewTokenDirect };
-//# sourceMappingURL=preview.d.mts.map
+export { PreviewTokenPayload, createPreviewFunctions, createPreviewTokenVerifier, previewFunctions, verifyPreviewTokenDirect };