@questpie/admin 1.1.1 → 2.0.0

package/dist/server/modules/admin/functions/admin-config.mjs

@@ -0,0 +1,348 @@
+import { introspectBlocks } from "../../../block/introspection.mjs";
+import { z } from "zod";
+import { executeAccessRule, fn } from "questpie";
+
+//#region src/server/modules/admin/functions/admin-config.ts
+/**
+* Admin Config Functions
+*
+* Provides server-defined admin configuration (dashboard, sidebar,
+* collection/global metadata) to the client via functions API.
+*
+* Filters results by the current user's read access.
+*
+* @example
+* ```ts
+* // Client usage
+* const config = await cms.api.functions.getAdminConfig();
+* // { dashboard: {...}, sidebar: {...}, collections: {...}, globals: {...} }
+* ```
+*/
+/**
+* Helper to get typed CMS app from handler context.
+*/
+function getApp(ctx) {
+	return ctx.app;
+}
+/**
+* Check if the current user has read access to a collection or global.
+* Returns true if accessible, false if denied.
+* Fail-open: returns true on errors to avoid hiding content due to rule bugs.
+*/
+async function hasReadAccess(readRule, ctx) {
+	if (readRule === void 0 || readRule === true) return true;
+	if (readRule === false) return false;
+	try {
+		return await executeAccessRule(readRule, {
+			cms: ctx.app,
+			db: ctx.db,
+			session: ctx.session,
+			locale: ctx.locale
+		}) !== false;
+	} catch {
+		return true;
+	}
+}
+/**
+* Extract admin metadata from all registered collections.
+*/
+function extractCollectionsMeta(cms) {
+	const result = {};
+	const collections = cms.getCollections();
+	for (const [name, collection] of Object.entries(collections)) {
+		const admin = collection.state?.admin;
+		if (admin) result[name] = {
+			label: admin.label,
+			description: admin.description,
+			icon: admin.icon,
+			hidden: admin.hidden,
+			group: admin.group,
+			order: admin.order
+		};
+		else result[name] = {};
+	}
+	return result;
+}
+/**
+* Extract admin metadata from all registered globals.
+*/
+function extractGlobalsMeta(cms) {
+	const result = {};
+	const globals = cms.getGlobals();
+	for (const [name, global] of Object.entries(globals)) {
+		const admin = global.state?.admin;
+		if (admin) result[name] = {
+			label: admin.label,
+			description: admin.description,
+			icon: admin.icon,
+			hidden: admin.hidden,
+			group: admin.group,
+			order: admin.order
+		};
+		else result[name] = {};
+	}
+	return result;
+}
+/**
+* Auto-generate a sidebar config from pre-filtered collection and global metadata.
+* Used when no explicit `.sidebar()` is configured.
+*/
+function buildAutoSidebar(collectionsMeta, globalsMeta) {
+	const ungrouped = [];
+	const grouped = {};
+	for (const [name, meta] of Object.entries(collectionsMeta)) {
+		if (meta.hidden) continue;
+		if (meta.group) {
+			if (!grouped[meta.group]) grouped[meta.group] = [];
+			grouped[meta.group].push({
+				name,
+				meta
+			});
+		} else ungrouped.push({
+			name,
+			meta
+		});
+	}
+	const sortByOrder = (a, b) => (a.meta.order ?? 0) - (b.meta.order ?? 0);
+	ungrouped.sort(sortByOrder);
+	for (const items of Object.values(grouped)) items.sort(sortByOrder);
+	const sections = [];
+	if (ungrouped.length > 0) sections.push({
+		id: "content",
+		title: { en: "Content" },
+		items: ungrouped.map(({ name, meta }) => ({
+			type: "collection",
+			collection: name,
+			label: meta.label,
+			icon: meta.icon
+		}))
+	});
+	const sortedGroupNames = Object.keys(grouped).sort();
+	for (const groupName of sortedGroupNames) {
+		const items = grouped[groupName];
+		sections.push({
+			id: `group:${groupName}`,
+			title: { en: groupName.charAt(0).toUpperCase() + groupName.slice(1) },
+			items: items.map(({ name, meta }) => ({
+				type: "collection",
+				collection: name,
+				label: meta.label,
+				icon: meta.icon
+			}))
+		});
+	}
+	const visibleGlobals = Object.entries(globalsMeta).filter(([, meta]) => !meta.hidden);
+	if (visibleGlobals.length > 0) {
+		visibleGlobals.sort(([, a], [, b]) => (a.order ?? 0) - (b.order ?? 0));
+		sections.push({
+			id: "globals",
+			title: { en: "Globals" },
+			items: visibleGlobals.map(([name, meta]) => ({
+				type: "global",
+				global: name,
+				label: meta.label,
+				icon: meta.icon
+			}))
+		});
+	}
+	return { sections };
+}
+/**
+* Filter an explicit sidebar config by accessible collections and globals.
+* Removes items referencing inaccessible collections/globals.
+* Removes empty sections after filtering.
+*/
+function filterSidebarConfig(config, accessibleCollections, accessibleGlobals) {
+	return { sections: config.sections.map((s) => ({
+		...s,
+		items: (s.items ?? []).filter((item) => {
+			if (item.type === "collection") return accessibleCollections.has(item.collection);
+			if (item.type === "global") return accessibleGlobals.has(item.global);
+			return true;
+		})
+	})).filter((s) => (s.items?.length ?? 0) > 0 || (s.sections?.length ?? 0) > 0) };
+}
+/**
+* Collect all collection and global names referenced in a sidebar config.
+*/
+function collectSidebarReferences(config) {
+	const collections = /* @__PURE__ */ new Set();
+	const globals = /* @__PURE__ */ new Set();
+	function collectFromSection(section) {
+		for (const item of section.items ?? []) if (item.type === "collection") collections.add(item.collection);
+		else if (item.type === "global") globals.add(item.global);
+		for (const subSection of section.sections ?? []) collectFromSection(subSection);
+	}
+	for (const section of config.sections) collectFromSection(section);
+	return {
+		collections,
+		globals
+	};
+}
+/**
+* Auto-assign IDs to widgets that don't have one.
+* Needed for fetchWidgetData lookup by widget ID.
+*/
+function assignWidgetIds(items) {
+	let counter = 0;
+	function walk(items$1) {
+		for (const item of items$1) if (item.type === "section") walk(item.items || []);
+		else if (item.type === "tabs") for (const tab of item.tabs || []) walk(tab.items || []);
+		else if (!item.id) item.id = `__auto_${item.type}_${counter++}`;
+	}
+	walk(items);
+}
+/**
+* Process dashboard items: evaluate access, strip non-serializable props,
+* mark hasFetchFn, and filter by collection access.
+*/
+async function processDashboardItems(items, accessibleCollections, accessCtx) {
+	const result = [];
+	for (const item of items) {
+		if (item.type === "section") {
+			const filtered = await processDashboardItems(item.items || [], accessibleCollections, accessCtx);
+			if (filtered.length > 0) result.push({
+				...item,
+				items: filtered
+			});
+			continue;
+		}
+		if (item.type === "tabs") {
+			const tabs = [];
+			for (const tab of item.tabs || []) {
+				const filtered = await processDashboardItems(tab.items || [], accessibleCollections, accessCtx);
+				tabs.push({
+					...tab,
+					items: filtered
+				});
+			}
+			result.push({
+				...item,
+				tabs
+			});
+			continue;
+		}
+		const widget = item;
+		if (widget.access !== void 0) {
+			if ((typeof widget.access === "function" ? await widget.access({
+				cms: accessCtx.app,
+				db: accessCtx.db,
+				session: accessCtx.session,
+				locale: accessCtx.locale
+			}) : widget.access) === false) continue;
+		}
+		if (widget.collection && !accessibleCollections.has(widget.collection)) continue;
+		if (widget.type === "quickActions") {
+			const actions = (widget.actions || []).filter((action) => {
+				if (action.action?.type === "create") return accessibleCollections.has(action.action.collection);
+				return true;
+			});
+			const { fetchFn: fetchFn$1, access: access$1, ...serializable$1 } = widget;
+			result.push({
+				...serializable$1,
+				actions
+			});
+			continue;
+		}
+		const { fetchFn, access, filterFn, ...serializable } = widget;
+		if (fetchFn) serializable.hasFetchFn = true;
+		result.push(serializable);
+	}
+	return result;
+}
+const getAdminConfigSchema = z.object({}).optional();
+const getAdminConfigOutputSchema = z.object({
+	dashboard: z.unknown().optional(),
+	sidebar: z.unknown().optional(),
+	branding: z.unknown().optional(),
+	blocks: z.record(z.string(), z.unknown()).optional(),
+	collections: z.record(z.string(), z.unknown()).optional(),
+	globals: z.record(z.string(), z.unknown()).optional(),
+	uploads: z.object({
+		collections: z.array(z.string()),
+		defaultCollection: z.string().optional()
+	}).optional()
+});
+/**
+* Get admin configuration including dashboard, sidebar, blocks,
+* and collection/global metadata.
+*
+* Filters all results by the current user's read access rules.
+*
+* @example
+* ```ts
+* // In your CMS
+* const cms = q({ name: "my-app" })
+*   .use(adminModule)
+*   .dashboard(({ d }) => d.dashboard({
+*     title: { en: "Dashboard" },
+*     items: [...],
+*   }))
+*   .sidebar(({ s }) => s.sidebar({
+*     sections: [...],
+*   }))
+*   .build({ ... });
+*
+* // Client fetches config
+* const config = await cms.api.functions.getAdminConfig();
+* ```
+*/
+const getAdminConfig = fn({
+	type: "query",
+	schema: getAdminConfigSchema,
+	outputSchema: getAdminConfigOutputSchema,
+	handler: async (ctx) => {
+		const cms = getApp(ctx);
+		const state = cms.state || {};
+		const collections = cms.getCollections();
+		const globals = cms.getGlobals();
+		const accessCtx = {
+			app: cms,
+			session: ctx.session,
+			db: ctx.db,
+			locale: ctx.locale
+		};
+		const accessibleCollections = /* @__PURE__ */ new Set();
+		for (const [name, col] of Object.entries(collections)) if (await hasReadAccess(col.state?.access?.read, accessCtx)) accessibleCollections.add(name);
+		const accessibleGlobals = /* @__PURE__ */ new Set();
+		for (const [name, g] of Object.entries(globals)) if (await hasReadAccess(g.state?.access?.read, accessCtx)) accessibleGlobals.add(name);
+		const allCollectionsMeta = extractCollectionsMeta(cms);
+		const allGlobalsMeta = extractGlobalsMeta(cms);
+		const filteredCollectionsMeta = Object.fromEntries(Object.entries(allCollectionsMeta).filter(([n]) => accessibleCollections.has(n)));
+		const filteredGlobalsMeta = Object.fromEntries(Object.entries(allGlobalsMeta).filter(([n]) => accessibleGlobals.has(n)));
+		const response = {};
+		const uploadCollections = Object.entries(collections).filter(([name, collection]) => accessibleCollections.has(name) && Boolean(collection?.state?.upload)).map(([name]) => name);
+		response.uploads = {
+			collections: uploadCollections,
+			defaultCollection: uploadCollections.length === 1 ? uploadCollections[0] : void 0
+		};
+		if (state.branding) response.branding = state.branding;
+		if (state.dashboard) {
+			const dashboard = state.dashboard;
+			if (dashboard.items) assignWidgetIds(dashboard.items);
+			response.dashboard = {
+				...dashboard,
+				items: dashboard.items ? await processDashboardItems(dashboard.items, accessibleCollections, accessCtx) : void 0
+			};
+		}
+		if (state.sidebar) {
+			const filteredSidebar = filterSidebarConfig(state.sidebar, accessibleCollections, accessibleGlobals);
+			const referenced = collectSidebarReferences(state.sidebar);
+			const unlistedSidebar = buildAutoSidebar(Object.fromEntries(Object.entries(filteredCollectionsMeta).filter(([name, meta]) => !referenced.collections.has(name) && !meta.hidden)), Object.fromEntries(Object.entries(filteredGlobalsMeta).filter(([name, meta]) => !referenced.globals.has(name) && !meta.hidden)));
+			response.sidebar = { sections: [...filteredSidebar.sections, ...unlistedSidebar.sections] };
+		} else response.sidebar = buildAutoSidebar(filteredCollectionsMeta, filteredGlobalsMeta);
+		if (state.blocks && Object.keys(state.blocks).length > 0) response.blocks = introspectBlocks(state.blocks);
+		response.collections = filteredCollectionsMeta;
+		response.globals = filteredGlobalsMeta;
+		return response;
+	}
+});
+/**
+* Admin config functions group.
+* Add to your CMS via `.functions(adminConfigFunctions)`.
+*/
+const adminConfigFunctions = { getAdminConfig };
+
+//#endregion
+export { adminConfigFunctions, getAdminConfig };
+//# sourceMappingURL=admin-config.mjs.map

package/dist/server/modules/admin/functions/admin-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-config.mjs","names":["result: Record<string, AdminConfigItemMeta>","admin: AdminCollectionConfig | undefined","admin: AdminGlobalConfig | undefined","ungrouped: Array<{ name: string; meta: AdminConfigItemMeta }>","grouped: Record<\n\t\tstring,\n\t\tArray<{ name: string; meta: AdminConfigItemMeta }>\n\t>","sections: ServerSidebarSection[]","items","result: ServerDashboardItem[]","serializable","response: {\n\t\t\tdashboard?: unknown;\n\t\t\tsidebar?: unknown;\n\t\t\tbranding?: { name?: unknown; logo?: unknown };\n\t\t\tblocks?: Record<string, unknown>;\n\t\t\tcollections?: Record<string, unknown>;\n\t\t\tglobals?: Record<string, unknown>;\n\t\t\tuploads?: { collections: string[]; defaultCollection?: string };\n\t\t}"],"sources":["../../../../../src/server/modules/admin/functions/admin-config.ts"],"sourcesContent":["/**\n * Admin Config Functions\n *\n * Provides server-defined admin configuration (dashboard, sidebar,\n * collection/global metadata) to the client via functions API.\n *\n * Filters results by the current user's read access.\n *\n * @example\n * ```ts\n * // Client usage\n * const config = await cms.api.functions.getAdminConfig();\n * // { dashboard: {...}, sidebar: {...}, collections: {...}, globals: {...} }\n * ```\n */\n\nimport { executeAccessRule, fn, type Questpie } from \"questpie\";\nimport { z } from \"zod\";\nimport type {\n\tAdminCollectionConfig,\n\tAdminGlobalConfig,\n\tComponentReference,\n\tServerDashboardConfig,\n\tServerDashboardItem,\n\tServerSidebarConfig,\n\tServerSidebarSection,\n} from \"../../../augmentation.js\";\nimport { introspectBlocks } from \"../../../block/introspection.js\";\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\ntype AdminConfigItemMeta = {\n\tlabel?: unknown;\n\tdescription?: unknown;\n\ticon?: ComponentReference;\n\thidden?: boolean;\n\tgroup?: string;\n\torder?: number;\n};\n\n/**\n * Helper to get typed CMS app from handler context.\n */\nfunction getApp(ctx: { app: unknown }): Questpie<any> {\n\treturn ctx.app as Questpie<any>;\n}\n\n// ============================================================================\n// Access Control Helpers\n// ============================================================================\n\n/**\n * Check if the current user has read access to a collection or global.\n * Returns true if accessible, false if denied.\n * Fail-open: returns true on errors to avoid hiding content due to rule bugs.\n */\nasync function hasReadAccess(\n\treadRule: unknown,\n\tctx: { app: unknown; session?: any; db: any; locale?: string },\n): Promise<boolean> {\n\tif (readRule === undefined || readRule === true) return true;\n\tif (readRule === false) return false;\n\ttry {\n\t\tconst result = await executeAccessRule(readRule as any, {\n\t\t\tcms: ctx.app as any,\n\t\t\tdb: ctx.db,\n\t\t\tsession: ctx.session,\n\t\t\tlocale: ctx.locale,\n\t\t});\n\t\treturn result !== false; // AccessWhere = still visible (row-level filter, but collection itself is accessible)\n\t} catch {\n\t\treturn true; // Fail-open: don't hide content due to access rule errors\n\t}\n}\n\n// ============================================================================\n// Metadata Extraction\n// ============================================================================\n\n/**\n * Extract admin metadata from all registered collections.\n */\nfunction extractCollectionsMeta(\n\tcms: Questpie<any>,\n): Record<string, AdminConfigItemMeta> {\n\tconst result: Record<string, AdminConfigItemMeta> = {};\n\tconst collections = cms.getCollections();\n\n\tfor (const [name, collection] of Object.entries(collections)) {\n\t\tconst admin: AdminCollectionConfig | undefined = (collection as any).state\n\t\t\t?.admin;\n\t\tif (admin) {\n\t\t\tresult[name] = {\n\t\t\t\tlabel: admin.label,\n\t\t\t\tdescription: admin.description,\n\t\t\t\ticon: admin.icon,\n\t\t\t\thidden: admin.hidden,\n\t\t\t\tgroup: admin.group,\n\t\t\t\torder: admin.order,\n\t\t\t};\n\t\t} else {\n\t\t\tresult[name] = {};\n\t\t}\n\t}\n\n\treturn result;\n}\n\n/**\n * Extract admin metadata from all registered globals.\n */\nfunction extractGlobalsMeta(\n\tcms: Questpie<any>,\n): Record<string, AdminConfigItemMeta> {\n\tconst result: Record<string, AdminConfigItemMeta> = {};\n\tconst globals = cms.getGlobals();\n\n\tfor (const [name, global] of Object.entries(globals)) {\n\t\tconst admin: AdminGlobalConfig | undefined = (global as any).state?.admin;\n\t\tif (admin) {\n\t\t\tresult[name] = {\n\t\t\t\tlabel: admin.label,\n\t\t\t\tdescription: admin.description,\n\t\t\t\ticon: admin.icon,\n\t\t\t\thidden: admin.hidden,\n\t\t\t\tgroup: admin.group,\n\t\t\t\torder: admin.order,\n\t\t\t};\n\t\t} else {\n\t\t\tresult[name] = {};\n\t\t}\n\t}\n\n\treturn result;\n}\n\n// ============================================================================\n// Auto-Sidebar Generation\n// ============================================================================\n\n/**\n * Auto-generate a sidebar config from pre-filtered collection and global metadata.\n * Used when no explicit `.sidebar()` is configured.\n */\nfunction buildAutoSidebar(\n\tcollectionsMeta: Record<string, AdminConfigItemMeta>,\n\tglobalsMeta: Record<string, AdminConfigItemMeta>,\n): ServerSidebarConfig {\n\t// Group collections by their admin.group property\n\tconst ungrouped: Array<{ name: string; meta: AdminConfigItemMeta }> = [];\n\tconst grouped: Record<\n\t\tstring,\n\t\tArray<{ name: string; meta: AdminConfigItemMeta }>\n\t> = {};\n\n\tfor (const [name, meta] of Object.entries(collectionsMeta)) {\n\t\tif (meta.hidden) continue;\n\t\tif (meta.group) {\n\t\t\tif (!grouped[meta.group]) grouped[meta.group] = [];\n\t\t\tgrouped[meta.group].push({ name, meta });\n\t\t} else {\n\t\t\tungrouped.push({ name, meta });\n\t\t}\n\t}\n\n\t// Sort by order within each group\n\tconst sortByOrder = (\n\t\ta: { meta: AdminConfigItemMeta },\n\t\tb: { meta: AdminConfigItemMeta },\n\t) => (a.meta.order ?? 0) - (b.meta.order ?? 0);\n\n\tungrouped.sort(sortByOrder);\n\tfor (const items of Object.values(grouped)) {\n\t\titems.sort(sortByOrder);\n\t}\n\n\tconst sections: ServerSidebarSection[] = [];\n\n\t// Content section: ungrouped collections\n\tif (ungrouped.length > 0) {\n\t\tsections.push({\n\t\t\tid: \"content\",\n\t\t\ttitle: { en: \"Content\" },\n\t\t\titems: ungrouped.map(({ name, meta }) => ({\n\t\t\t\ttype: \"collection\" as const,\n\t\t\t\tcollection: name,\n\t\t\t\tlabel: meta.label as any,\n\t\t\t\ticon: meta.icon,\n\t\t\t})),\n\t\t});\n\t}\n\n\t// Named sections for grouped collections\n\tconst sortedGroupNames = Object.keys(grouped).sort();\n\tfor (const groupName of sortedGroupNames) {\n\t\tconst items = grouped[groupName];\n\t\tsections.push({\n\t\t\tid: `group:${groupName}`,\n\t\t\ttitle: { en: groupName.charAt(0).toUpperCase() + groupName.slice(1) },\n\t\t\titems: items.map(({ name, meta }) => ({\n\t\t\t\ttype: \"collection\" as const,\n\t\t\t\tcollection: name,\n\t\t\t\tlabel: meta.label as any,\n\t\t\t\ticon: meta.icon,\n\t\t\t})),\n\t\t});\n\t}\n\n\t// Globals section\n\tconst visibleGlobals = Object.entries(globalsMeta).filter(\n\t\t([, meta]) => !meta.hidden,\n\t);\n\tif (visibleGlobals.length > 0) {\n\t\tvisibleGlobals.sort(([, a], [, b]) => (a.order ?? 0) - (b.order ?? 0));\n\t\tsections.push({\n\t\t\tid: \"globals\",\n\t\t\ttitle: { en: \"Globals\" },\n\t\t\titems: visibleGlobals.map(([name, meta]) => ({\n\t\t\t\ttype: \"global\" as const,\n\t\t\t\tglobal: name,\n\t\t\t\tlabel: meta.label as any,\n\t\t\t\ticon: meta.icon,\n\t\t\t})),\n\t\t});\n\t}\n\n\treturn { sections };\n}\n\n// ============================================================================\n// Sidebar Filtering (explicit sidebar config)\n// ============================================================================\n\n/**\n * Filter an explicit sidebar config by accessible collections and globals.\n * Removes items referencing inaccessible collections/globals.\n * Removes empty sections after filtering.\n */\nfunction filterSidebarConfig(\n\tconfig: ServerSidebarConfig,\n\taccessibleCollections: Set<string>,\n\taccessibleGlobals: Set<string>,\n): ServerSidebarConfig {\n\treturn {\n\t\tsections: config.sections\n\t\t\t.map((s) => ({\n\t\t\t\t...s,\n\t\t\t\titems: (s.items ?? []).filter((item) => {\n\t\t\t\t\tif (item.type === \"collection\")\n\t\t\t\t\t\treturn accessibleCollections.has((item as any).collection);\n\t\t\t\t\tif (item.type === \"global\")\n\t\t\t\t\t\treturn accessibleGlobals.has((item as any).global);\n\t\t\t\t\treturn true; // pages, links, dividers always pass\n\t\t\t\t}),\n\t\t\t}))\n\t\t\t.filter(\n\t\t\t\t(s) => (s.items?.length ?? 0) > 0 || (s.sections?.length ?? 0) > 0,\n\t\t\t),\n\t};\n}\n\n/**\n * Collect all collection and global names referenced in a sidebar config.\n */\nfunction collectSidebarReferences(config: ServerSidebarConfig): {\n\tcollections: Set<string>;\n\tglobals: Set<string>;\n} {\n\tconst collections = new Set<string>();\n\tconst globals = new Set<string>();\n\n\tfunction collectFromSection(section: ServerSidebarSection): void {\n\t\tfor (const item of section.items ?? []) {\n\t\t\tif (item.type === \"collection\") collections.add((item as any).collection);\n\t\t\telse if (item.type === \"global\") globals.add((item as any).global);\n\t\t}\n\t\tfor (const subSection of section.sections ?? []) {\n\t\t\tcollectFromSection(subSection);\n\t\t}\n\t}\n\n\tfor (const section of config.sections) {\n\t\tcollectFromSection(section);\n\t}\n\treturn { collections, globals };\n}\n\n// ============================================================================\n// Dashboard Processing (access + serialization + ID assignment)\n// ============================================================================\n\n/**\n * Auto-assign IDs to widgets that don't have one.\n * Needed for fetchWidgetData lookup by widget ID.\n */\nfunction assignWidgetIds(items: ServerDashboardItem[]): void {\n\tlet counter = 0;\n\tfunction walk(items: ServerDashboardItem[]) {\n\t\tfor (const item of items) {\n\t\t\tif (item.type === \"section\") {\n\t\t\t\twalk((item as any).items || []);\n\t\t\t} else if (item.type === \"tabs\") {\n\t\t\t\tfor (const tab of (item as any).tabs || []) {\n\t\t\t\t\twalk(tab.items || []);\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\t// Widget — assign ID if missing\n\t\t\t\tif (!(item as any).id) {\n\t\t\t\t\t(item as any).id = `__auto_${item.type}_${counter++}`;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\twalk(items);\n}\n\n/**\n * Process dashboard items: evaluate access, strip non-serializable props,\n * mark hasFetchFn, and filter by collection access.\n */\nasync function processDashboardItems(\n\titems: ServerDashboardItem[],\n\taccessibleCollections: Set<string>,\n\taccessCtx: { app: unknown; session?: any; db: any; locale?: string },\n): Promise<ServerDashboardItem[]> {\n\tconst result: ServerDashboardItem[] = [];\n\n\tfor (const item of items) {\n\t\t// Recurse into sections\n\t\tif (item.type === \"section\") {\n\t\t\tconst filtered = await processDashboardItems(\n\t\t\t\t(item as any).items || [],\n\t\t\t\taccessibleCollections,\n\t\t\t\taccessCtx,\n\t\t\t);\n\t\t\tif (filtered.length > 0) {\n\t\t\t\tresult.push({ ...item, items: filtered } as any);\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Recurse into tabs\n\t\tif (item.type === \"tabs\") {\n\t\t\tconst tabs = [];\n\t\t\tfor (const tab of (item as any).tabs || []) {\n\t\t\t\tconst filtered = await processDashboardItems(\n\t\t\t\t\ttab.items || [],\n\t\t\t\t\taccessibleCollections,\n\t\t\t\t\taccessCtx,\n\t\t\t\t);\n\t\t\t\ttabs.push({ ...tab, items: filtered });\n\t\t\t}\n\t\t\tresult.push({ ...item, tabs } as any);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Widget processing\n\t\tconst widget = item as any;\n\n\t\t// 1. Check per-widget access\n\t\tif (widget.access !== undefined) {\n\t\t\tconst widgetAccessResult =\n\t\t\t\ttypeof widget.access === \"function\"\n\t\t\t\t\t? await widget.access({\n\t\t\t\t\t\t\tcms: accessCtx.app,\n\t\t\t\t\t\t\tdb: accessCtx.db,\n\t\t\t\t\t\t\tsession: accessCtx.session,\n\t\t\t\t\t\t\tlocale: accessCtx.locale,\n\t\t\t\t\t\t})\n\t\t\t\t\t: widget.access;\n\t\t\tif (widgetAccessResult === false) continue;\n\t\t}\n\n\t\t// 2. Check collection access for collection-bound widgets\n\t\tif (widget.collection && !accessibleCollections.has(widget.collection)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\t// 3. Filter quickActions' individual actions by collection access\n\t\tif (widget.type === \"quickActions\") {\n\t\t\tconst actions = (widget.actions || []).filter((action: any) => {\n\t\t\t\tif (action.action?.type === \"create\") {\n\t\t\t\t\treturn accessibleCollections.has(action.action.collection);\n\t\t\t\t}\n\t\t\t\treturn true;\n\t\t\t});\n\t\t\tconst { fetchFn, access, ...serializable } = widget;\n\t\t\tresult.push({ ...serializable, actions } as any);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// 4. Strip non-serializable props, mark hasFetchFn\n\t\tconst { fetchFn, access, filterFn, ...serializable } = widget;\n\t\tif (fetchFn) {\n\t\t\tserializable.hasFetchFn = true;\n\t\t}\n\t\tresult.push(serializable);\n\t}\n\n\treturn result;\n}\n\n// ============================================================================\n// Schema Definitions\n// ============================================================================\n\nconst getAdminConfigSchema = z.object({}).optional();\n\n// Output schema is flexible since dashboard/sidebar configs are complex\nconst getAdminConfigOutputSchema = z.object({\n\tdashboard: z.unknown().optional(),\n\tsidebar: z.unknown().optional(),\n\tbranding: z.unknown().optional(),\n\tblocks: z.record(z.string(), z.unknown()).optional(),\n\tcollections: z.record(z.string(), z.unknown()).optional(),\n\tglobals: z.record(z.string(), z.unknown()).optional(),\n\tuploads: z\n\t\t.object({\n\t\t\tcollections: z.array(z.string()),\n\t\t\tdefaultCollection: z.string().optional(),\n\t\t})\n\t\t.optional(),\n});\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Get admin configuration including dashboard, sidebar, blocks,\n * and collection/global metadata.\n *\n * Filters all results by the current user's read access rules.\n *\n * @example\n * ```ts\n * // In your CMS\n * const cms = q({ name: \"my-app\" })\n *   .use(adminModule)\n *   .dashboard(({ d }) => d.dashboard({\n *     title: { en: \"Dashboard\" },\n *     items: [...],\n *   }))\n *   .sidebar(({ s }) => s.sidebar({\n *     sections: [...],\n *   }))\n *   .build({ ... });\n *\n * // Client fetches config\n * const config = await cms.api.functions.getAdminConfig();\n * ```\n */\nexport const getAdminConfig = fn({\n\ttype: \"query\",\n\tschema: getAdminConfigSchema,\n\toutputSchema: getAdminConfigOutputSchema,\n\thandler: async (ctx) => {\n\t\tconst cms = getApp(ctx);\n\t\tconst state = (cms as any).state || {};\n\n\t\t// 1. Compute accessible collections and globals\n\t\tconst collections = cms.getCollections();\n\t\tconst globals = cms.getGlobals();\n\t\tconst accessCtx = {\n\t\t\tapp: cms,\n\t\t\tsession: (ctx as any).session,\n\t\t\tdb: (ctx as any).db,\n\t\t\tlocale: (ctx as any).locale,\n\t\t};\n\n\t\tconst accessibleCollections = new Set<string>();\n\t\tfor (const [name, col] of Object.entries(collections)) {\n\t\t\tif (await hasReadAccess((col as any).state?.access?.read, accessCtx)) {\n\t\t\t\taccessibleCollections.add(name);\n\t\t\t}\n\t\t}\n\n\t\tconst accessibleGlobals = new Set<string>();\n\t\tfor (const [name, g] of Object.entries(globals)) {\n\t\t\tif (await hasReadAccess((g as any).state?.access?.read, accessCtx)) {\n\t\t\t\taccessibleGlobals.add(name);\n\t\t\t}\n\t\t}\n\n\t\t// 2. Extract and filter metadata\n\t\tconst allCollectionsMeta = extractCollectionsMeta(cms);\n\t\tconst allGlobalsMeta = extractGlobalsMeta(cms);\n\n\t\tconst filteredCollectionsMeta = Object.fromEntries(\n\t\t\tObject.entries(allCollectionsMeta).filter(([n]) =>\n\t\t\t\taccessibleCollections.has(n),\n\t\t\t),\n\t\t);\n\t\tconst filteredGlobalsMeta = Object.fromEntries(\n\t\t\tObject.entries(allGlobalsMeta).filter(([n]) => accessibleGlobals.has(n)),\n\t\t);\n\n\t\tconst response: {\n\t\t\tdashboard?: unknown;\n\t\t\tsidebar?: unknown;\n\t\t\tbranding?: { name?: unknown; logo?: unknown };\n\t\t\tblocks?: Record<string, unknown>;\n\t\t\tcollections?: Record<string, unknown>;\n\t\t\tglobals?: Record<string, unknown>;\n\t\t\tuploads?: { collections: string[]; defaultCollection?: string };\n\t\t} = {};\n\n\t\tconst uploadCollections = Object.entries(collections)\n\t\t\t.filter(\n\t\t\t\t([name, collection]) =>\n\t\t\t\t\taccessibleCollections.has(name) &&\n\t\t\t\t\tBoolean((collection as any)?.state?.upload),\n\t\t\t)\n\t\t\t.map(([name]) => name);\n\n\t\tresponse.uploads = {\n\t\t\tcollections: uploadCollections,\n\t\t\tdefaultCollection:\n\t\t\t\tuploadCollections.length === 1 ? uploadCollections[0] : undefined,\n\t\t};\n\n\t\t// Branding config\n\t\tif (state.branding) {\n\t\t\tresponse.branding = state.branding;\n\t\t}\n\n\t\t// 3. Dashboard: assign IDs, process access, strip non-serializable\n\t\tif (state.dashboard) {\n\t\t\tconst dashboard = state.dashboard as ServerDashboardConfig;\n\t\t\tif (dashboard.items) {\n\t\t\t\tassignWidgetIds(dashboard.items);\n\t\t\t}\n\t\t\tresponse.dashboard = {\n\t\t\t\t...dashboard,\n\t\t\t\titems: dashboard.items\n\t\t\t\t\t? await processDashboardItems(\n\t\t\t\t\t\t\tdashboard.items,\n\t\t\t\t\t\t\taccessibleCollections,\n\t\t\t\t\t\t\taccessCtx,\n\t\t\t\t\t\t)\n\t\t\t\t\t: undefined,\n\t\t\t};\n\t\t}\n\n\t\t// 4. Sidebar: explicit → filter + auto-append unlisted; auto → build from filtered meta\n\t\tif (state.sidebar) {\n\t\t\tconst filteredSidebar = filterSidebarConfig(\n\t\t\t\tstate.sidebar,\n\t\t\t\taccessibleCollections,\n\t\t\t\taccessibleGlobals,\n\t\t\t);\n\n\t\t\t// Find collections/globals the user explicitly listed\n\t\t\tconst referenced = collectSidebarReferences(state.sidebar);\n\n\t\t\t// Find non-hidden accessible items NOT referenced in the explicit sidebar\n\t\t\tconst unlistedCollectionsMeta = Object.fromEntries(\n\t\t\t\tObject.entries(filteredCollectionsMeta).filter(\n\t\t\t\t\t([name, meta]) => !referenced.collections.has(name) && !meta.hidden,\n\t\t\t\t),\n\t\t\t);\n\t\t\tconst unlistedGlobalsMeta = Object.fromEntries(\n\t\t\t\tObject.entries(filteredGlobalsMeta).filter(\n\t\t\t\t\t([name, meta]) => !referenced.globals.has(name) && !meta.hidden,\n\t\t\t\t),\n\t\t\t);\n\n\t\t\t// Auto-generate sections for unlisted items, append after explicit sections\n\t\t\tconst unlistedSidebar = buildAutoSidebar(\n\t\t\t\tunlistedCollectionsMeta,\n\t\t\t\tunlistedGlobalsMeta,\n\t\t\t);\n\n\t\t\tresponse.sidebar = {\n\t\t\t\tsections: [...filteredSidebar.sections, ...unlistedSidebar.sections],\n\t\t\t};\n\t\t} else {\n\t\t\tresponse.sidebar = buildAutoSidebar(\n\t\t\t\tfilteredCollectionsMeta,\n\t\t\t\tfilteredGlobalsMeta,\n\t\t\t);\n\t\t}\n\n\t\t// 5. Blocks: unchanged (not access-controlled)\n\t\tif (state.blocks && Object.keys(state.blocks).length > 0) {\n\t\t\tresponse.blocks = introspectBlocks(state.blocks);\n\t\t}\n\n\t\t// 6. Return filtered metadata\n\t\tresponse.collections = filteredCollectionsMeta;\n\t\tresponse.globals = filteredGlobalsMeta;\n\n\t\treturn response;\n\t},\n});\n\n// ============================================================================\n// Export Bundle\n// ============================================================================\n\n/**\n * Admin config functions group.\n * Add to your CMS via `.functions(adminConfigFunctions)`.\n */\nexport const adminConfigFunctions = {\n\tgetAdminConfig,\n} as const;\n"],"mappings":"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"}

package/dist/server/modules/admin/functions/execute-action.d.mts

@@ -0,0 +1,107 @@
+import { ServerActionDefinition, ServerActionResult } from "../../../augmentation.mjs";
+import * as questpie18976 from "questpie";
+import { Questpie } from "questpie";
+
+//#region src/server/modules/admin/functions/execute-action.d.ts
+
+type App = Questpie<any>;
+/**
+ * Request to execute an action
+ */
+interface ExecuteActionRequest {
+  /** Collection slug */
+  collection: string;
+  /** Action ID (builtin: "create", "delete", etc. or custom id) */
+  actionId: string;
+  /** Single item ID (for single-item actions) */
+  itemId?: string;
+  /** Multiple item IDs (for bulk actions) */
+  itemIds?: string[];
+  /** Form data (for actions with forms) */
+  data?: Record<string, unknown>;
+  /** Current locale */
+  locale?: string;
+}
+/**
+ * Response from action execution
+ */
+interface ExecuteActionResponse {
+  success: boolean;
+  result?: ServerActionResult;
+  error?: string;
+}
+/**
+ * Get action configuration for introspection.
+ * Returns action definitions without handlers (for client-side rendering).
+ */
+declare function getActionsConfig(app: App, collectionSlug: string): {
+  builtin: string[];
+  custom: Array<Omit<ServerActionDefinition, "handler">>;
+} | null;
+/**
+ * Execute a collection action.
+ * Handles both built-in actions and custom actions.
+ */
+declare function executeAction(app: App, request: ExecuteActionRequest, session?: unknown): Promise<ExecuteActionResponse>;
+/**
+ * Execute a collection action.
+ *
+ * @example
+ * ```ts
+ * // From client
+ * const result = await cms.api.functions.executeAction({
+ *   collection: "posts",
+ *   actionId: "publish",
+ *   itemId: "123",
+ * });
+ * ```
+ */
+declare const executeActionFn: questpie18976.JsonFunctionDefinition<{
+  collection: string;
+  actionId: string;
+  itemId?: string | undefined;
+  itemIds?: string[] | undefined;
+  data?: Record<string, unknown> | undefined;
+  locale?: string | undefined;
+}, {
+  success: boolean;
+  result?: unknown;
+  error?: string | undefined;
+}>;
+/**
+ * Get actions configuration for a collection.
+ * Returns action definitions without handlers for client rendering.
+ */
+declare const getActionsConfigFn: questpie18976.JsonFunctionDefinition<{
+  collection: string;
+}, {
+  builtin: string[];
+  custom: unknown[];
+} | null>;
+/**
+ * CMS functions for action execution.
+ * These are registered on the adminModule.
+ */
+declare const actionFunctions: {
+  executeAction: questpie18976.JsonFunctionDefinition<{
+    collection: string;
+    actionId: string;
+    itemId?: string | undefined;
+    itemIds?: string[] | undefined;
+    data?: Record<string, unknown> | undefined;
+    locale?: string | undefined;
+  }, {
+    success: boolean;
+    result?: unknown;
+    error?: string | undefined;
+  }>;
+  getActionsConfig: questpie18976.JsonFunctionDefinition<{
+    collection: string;
+  }, {
+    builtin: string[];
+    custom: unknown[];
+  } | null>;
+};
+//#endregion
+export { ExecuteActionRequest, ExecuteActionResponse, actionFunctions, executeAction, executeActionFn, getActionsConfig, getActionsConfigFn };
+//# sourceMappingURL=execute-action.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute-action.d.mts","names":[],"sources":["../../../../../src/server/modules/admin/functions/execute-action.ts"],"sourcesContent":[],"mappings":";;;;;;KA6BK,GAAA,GAAM,QAoFD,CAAA,GAAA,CAAA;AAmWV;AAeA;AAcA;UA/ciB,oBAAA;;;;;;;;;;SAUR;;;;;;;UAQQ,qBAAA;;WAEN;;;;;;;iBAQK,gBAAA,MACT;;UAIG,MAAM,KAAK;;;;;;iBA0CC,aAAA,MACf,cACI,0CAER,QAAQ;;;;;;;;;;;;;;cAmWE,iBASX,aAAA,CAT0B;;;;;SAS1B;;;;;;;;;;;cAMW,oBAQX,aAAA,CAR6B;;;;;;;;;;cAclB"}