domma-cms 0.74.0 → 0.75.0

package/server/routes/api/views.js

@@ -2,7 +2,8 @@
  * Views API
  *
  * Admin endpoints (authenticated + views permission):
- * GET    /views                     - List all view configs
+ * GET    /views                     - List all view configs (?sources=1 adds `sourceInfo` per view)
+ * GET    /views/_count              - The sidebar badge (the underscore is outside the slug alphabet)
  * POST   /views                     - Create view config
  * GET    /views/:slug               - Get view config
  * PUT    /views/:slug               - Update view config
@@ -13,11 +14,17 @@
  * Public endpoint (role-checked per view access config):
  * GET    /views/:slug/public        - Execute view publicly
  */
-import {createView, deleteView, executeView, getView, listViews, updateView} from '../../services/views.js';
+import {createView, deleteView, executeView, getView, listViews, updateView, viewsBadge} from '../../services/views.js';
 import {authenticate, requirePermission} from '../../middleware/auth.js';
 import {getRoleLevel} from '../../services/roles.js';
 import {getEffectiveLevel} from '../../services/userRoles.js';
 
+/** Every collection by slug - a missing one is a view whose source was deleted. */
+async function collectionsBySlug() {
+    const {listCollections} = await import('../../services/collections.js');
+    return new Map((await listCollections().catch(() => [])).map(c => [c.slug, c]));
+}
+
 export async function viewsRoutes(fastify) {
     const canRead = {preHandler: [authenticate, requirePermission('views', 'read')]};
     const canCreate = {preHandler: [authenticate, requirePermission('views', 'create')]};
@@ -33,7 +40,18 @@ export async function viewsRoutes(fastify) {
             const {canSeeArtefact} = await import('../../services/projects.js');
             const all = await listViews();
             // listViews returns full records with meta inline - filter directly
-            return all.filter(v => canSeeArtefact(request.user, v));
+            const visible = all.filter(v => canSeeArtefact(request.user, v));
+            if (request.query?.sources !== '1') return visible;
+            // The Views screen: what each view reads from - whether that collection still
+            // exists, its title and its storage (MongoDB runs native aggregation, file
+            // collections the JS pipeline). A views user need not hold collections.read.
+            const bySlug = await collectionsBySlug();
+            return visible.map(v => {
+                const c = bySlug.get(v.pipeline?.source);
+                return {...v, sourceInfo: c
+                    ? {exists: true, title: c.title || c.slug, adapter: c.storage?.adapter || 'file'}
+                    : {exists: false}};
+            });
         } catch (err) {
             return reply.status(503).send({ error: err.message });
         }
@@ -49,6 +67,12 @@ export async function viewsRoutes(fastify) {
         }
     });
 
+    fastify.get('/views/_count', canRead, async (request) => {
+        const {canSeeArtefact} = await import('../../services/projects.js');
+        const visible = (await listViews()).filter(v => canSeeArtefact(request.user, v));
+        return viewsBadge(visible, new Set((await collectionsBySlug()).keys()));
+    });
+
     // Static sub-routes must be declared before the parameterised :slug route
     // so Fastify's radix router gives them priority.
     fastify.get('/views/collection/:collectionSlug', canRead, async (request, reply) => {

package/server/server.js

@@ -528,7 +528,22 @@ registerSidebarItem({item: {source: 'Built in', text: 'Contacts', url: '#/contac
 // Manage projects lives in the menu (the Projects folder, sidebar-migration.js);
 // registering it here only adds its badge - the renderer merges a registered
 // item into the menu node with the same url rather than adding a second one.
-registerSidebarItem({folder: 'projects', item: {source: 'Built in', text: 'Manage projects', url: '#/projects', icon: 'folder', permission: 'projects', countUrl: '/api/projects/_count'}});
+registerSidebarItem({folder: 'projects', item: {source: 'Built in', text: 'Manage projects', url: '#/projects', icon: 'folder', permission: 'projects', countUrl: '/api/projects/_count', inventory: true}});
+// Content and Data: the same - each merges into its menu entry and brings its badge
+// (which keeps the number the sidebar always showed there; the popover says more).
+// `inventory`: a how-many count, left out of a closed folder's total (sidebar-renderer).
+registerSidebarItem({folder: 'content', item: {source: 'Built in', text: 'Pages', url: '#/pages', icon: 'file-text', permission: 'pages', countUrl: '/api/pages/_count', inventory: true}});
+registerSidebarItem({folder: 'content', item: {source: 'Built in', text: 'Media', url: '#/media', icon: 'image', permission: 'media', countUrl: '/api/media/_count', inventory: true}});
+registerSidebarItem({folder: 'content', item: {source: 'Built in', text: 'Menus', url: '#/menus', icon: 'menu', permission: 'menus', countUrl: '/api/menus/_count', inventory: true}});
+registerSidebarItem({folder: 'content', item: {source: 'Built in', text: 'Context Menus', url: '#/context-menus', icon: 'menu', permission: 'context-menus', countUrl: '/api/context-menus/_count', inventory: true}});
+registerSidebarItem({folder: 'content', item: {source: 'Built in', text: 'Theme', url: '#/theme', icon: 'droplet', permission: 'theme', countUrl: '/api/theme/count', inventory: true}});
+registerSidebarItem({folder: 'data', item: {source: 'Built in', text: 'Collections', url: '#/collections', icon: 'database', permission: 'collections', countUrl: '/api/collections/_count', inventory: true}});
+registerSidebarItem({folder: 'data', item: {source: 'Built in', text: 'Forms', url: '#/forms', icon: 'layout', permission: 'collections', countUrl: '/api/forms/_count', inventory: true}});
+registerSidebarItem({folder: 'data', item: {source: 'Built in', text: 'Views', url: '#/views', icon: 'eye', permission: 'views', countUrl: '/api/views/_count', inventory: true}});
+registerSidebarItem({folder: 'data', item: {source: 'Built in', text: 'Actions', url: '#/actions', icon: 'zap', permission: 'actions', countUrl: '/api/actions/_count', inventory: true}});
+registerSidebarItem({folder: 'data', item: {source: 'Built in', text: 'API Builder', url: '#/api-endpoints', icon: 'code', permission: 'api-endpoints', countUrl: '/api/api-endpoints/_count', inventory: true}});
+registerSidebarItem({folder: 'data', item: {source: 'Built in', text: 'Blocks', url: '#/blocks', icon: 'box', permission: 'pages', countUrl: '/api/blocks/_count', inventory: true}});
+registerSidebarItem({folder: 'data', item: {source: 'Built in', text: 'Components', url: '#/components', icon: 'component', permission: 'components', countUrl: '/api/components/_count', inventory: true}});
 
 await registerPlugins(app);
 

package/server/services/contextMenus.js

@@ -475,3 +475,44 @@ export function toClientPayload(menu) {
         items: menu.items || []
     };
 }
+
+/**
+ * The sidebar badge on Context Menus (its countUrl, GET /api/context-menus/_count):
+ * how many menus there are, with the ones switched off and the ones whose
+ * binding matches nothing called out - an enabled menu that never appears is
+ * the one thing here worth a second look. Plain text throughout: the popover
+ * sets it with textContent.
+ *
+ * @param {object[]} menus - as listContextMenus returns them
+ * @returns {{count: number, label: string, tone: string, details: object}}
+ */
+export function contextMenusBadge(menus = []) {
+    const list = [...menus].sort((a, b) => String(a.name || a.slug).localeCompare(String(b.name || b.slug)));
+    const off = list.filter(m => m.enabled === false);
+    const never = list.filter(m => m.enabled !== false && m.binding
+        && !(m.binding.projects || []).length && !(m.binding.pages || []).length);
+    const siteWide = list.filter(m => m.enabled !== false && !m.binding).length;
+    const n = list.length;
+    const bits = [off.length && `${off.length} off`, never.length && `${never.length} never matching`].filter(Boolean);
+    return {
+        count: n,
+        label: `${n} context menu${n === 1 ? '' : 's'}${bits.length ? `, ${bits.join(', ')}` : ''}`,
+        tone: never.length ? 'attention' : 'info',
+        details: {
+            title: 'Context Menus',
+            rows: [
+                {label: 'On', value: String(n - off.length)},
+                {label: 'Off', value: String(off.length)},
+                {label: 'Site-wide', value: String(siteWide)},
+                {label: 'Never matching', value: String(never.length), ...(never.length && {tone: 'danger'})}
+            ],
+            items: list.slice(0, 8).map(m => ({
+                text: String(m.name || m.slug),
+                meta: [m.selector || 'no target', `${m.itemsCount ?? 0} item${m.itemsCount === 1 ? '' : 's'}`,
+                    m.enabled === false ? 'off' : '', never.includes(m) ? 'never matches' : ''].filter(Boolean).join(' · '),
+                ...(never.includes(m) && {tone: 'danger'})
+            })),
+            empty: 'No context menus yet.'
+        }
+    };
+}

package/server/services/views.js

@@ -475,3 +475,41 @@ export async function executeView(slug, {page = 1, limit = 25, user = null} = {}
         ? executeMongoView(view, { page, limit, user })
         : executeFileView(view, { page, limit, user });
 }
+
+/**
+ * The sidebar badge on Views (its countUrl, GET /api/views/_count): how many
+ * views, red when one reads from a collection that no longer exists - such a
+ * view errors on every page that shows it. Plain text: the popover sets it
+ * with textContent.
+ *
+ * @param {object[]} views
+ * @param {Set<string>} collectionSlugs - the collections that exist
+ * @returns {{count: number, label: string, tone: string, details: object}}
+ */
+export function viewsBadge(views = [], collectionSlugs = new Set()) {
+    const broken = views.filter(v => v.pipeline?.source && !collectionSlugs.has(v.pipeline.source));
+    const pub = views.filter(v => v.access?.public).length;
+    const n = views.length;
+    const ordered = [...broken, ...views.filter(v => !broken.includes(v))];
+    return {
+        count: n,
+        label: `${n} view${n === 1 ? '' : 's'}${broken.length ? `, ${broken.length} reading a missing collection` : ''}`,
+        tone: broken.length ? 'danger' : 'info',
+        details: {
+            title: 'Views',
+            rows: [
+                {label: 'Views', value: String(n)},
+                {label: 'Public', value: String(pub)},
+                {label: 'Missing source', value: String(broken.length), ...(broken.length && {tone: 'danger'})}
+            ],
+            items: ordered.slice(0, 8).map(v => ({
+                text: String(v.title || v.slug),
+                meta: broken.includes(v)
+                    ? `source "${v.pipeline.source}" is gone`
+                    : [v.pipeline?.source, v.display?.mode || 'table', v.access?.public ? 'public' : ''].filter(Boolean).join(' · '),
+                ...(broken.includes(v) && {tone: 'danger'})
+            })),
+            empty: 'No views yet.'
+        }
+    };
+}