npm - @actuate-media/cms-core - Versions diffs - 0.22.0 → 0.24.0 - Mend

@actuate-media/cms-core 0.22.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/dist/__tests__/api/collections-discovery.test.d.ts +2 -0
package/dist/__tests__/api/collections-discovery.test.d.ts.map +1 -0
package/dist/__tests__/api/collections-discovery.test.js +129 -0
package/dist/__tests__/api/collections-discovery.test.js.map +1 -0
package/dist/__tests__/api/notifications-routes.test.js +45 -0
package/dist/__tests__/api/notifications-routes.test.js.map +1 -1
package/dist/__tests__/realtime/notification-bus.test.d.ts +2 -0
package/dist/__tests__/realtime/notification-bus.test.d.ts.map +1 -0
package/dist/__tests__/realtime/notification-bus.test.js +79 -0
package/dist/__tests__/realtime/notification-bus.test.js.map +1 -0
package/dist/__tests__/realtime/notification-stream.test.d.ts +2 -0
package/dist/__tests__/realtime/notification-stream.test.d.ts.map +1 -0
package/dist/__tests__/realtime/notification-stream.test.js +157 -0
package/dist/__tests__/realtime/notification-stream.test.js.map +1 -0
package/dist/api/handlers.d.ts.map +1 -1
package/dist/api/handlers.js +79 -3
package/dist/api/handlers.js.map +1 -1
package/dist/preview/sse-stream.d.ts +2 -5
package/dist/preview/sse-stream.d.ts.map +1 -1
package/dist/preview/sse-stream.js +7 -16
package/dist/preview/sse-stream.js.map +1 -1
package/dist/realtime/index.d.ts +3 -0
package/dist/realtime/index.d.ts.map +1 -1
package/dist/realtime/index.js +9 -0
package/dist/realtime/index.js.map +1 -1
package/dist/realtime/notification-bus.d.ts +60 -0
package/dist/realtime/notification-bus.d.ts.map +1 -0
package/dist/realtime/notification-bus.js +77 -0
package/dist/realtime/notification-bus.js.map +1 -0
package/dist/realtime/notification-stream.d.ts +50 -0
package/dist/realtime/notification-stream.d.ts.map +1 -0
package/dist/realtime/notification-stream.js +148 -0
package/dist/realtime/notification-stream.js.map +1 -0
package/dist/realtime/sse.d.ts +20 -0
package/dist/realtime/sse.d.ts.map +1 -0
package/dist/realtime/sse.js +31 -0
package/dist/realtime/sse.js.map +1 -0
package/package.json +1 -1

package/dist/api/handlers.js CHANGED Viewed

@@ -17,6 +17,8 @@ import { createPreviewStreamResponse } from '../preview/sse-stream.js';
 import { notifyPreviewUpdate } from '../preview/event-bus.js';
 import { createComment as createCommentService, deleteComment as deleteCommentService, listComments as listCommentsService, reopenComment as reopenCommentService, resolveComment as resolveCommentService, updateComment as updateCommentService, } from '../realtime/comments.js';
 import { createNotification, excerptForNotification, extractMentionedUserIds, listForUser as listNotificationsForUser, markAllRead as markAllNotificationsRead, markRead as markNotificationRead, unreadCount as notificationsUnreadCount, } from '../realtime/notifications.js';
+import { publishNotification } from '../realtime/notification-bus.js';
+import { createNotificationStreamResponse } from '../realtime/notification-stream.js';
 import { schedulingCronHandler } from '../scheduling/index.js';
 import { isAuthorizedCronRequest, processCleanup, processSeoScan } from '../cron/index.js';
 import { verifyCaptcha, getCaptchaConfig } from '../security/captcha.js';
@@ -776,6 +778,44 @@ export function registerCMSRoutes(router) {
             headers: { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' },
         });
     });
+    // ---------------------------------------------------------------------------
+    // Collection discovery (Phase 7 PR F)
+    //
+    // Lightweight enumeration sourced directly from `getActuateConfig()` so
+    // agents and the MCP server's `list_collections` tool don't depend on
+    // OpenAPI spec generation succeeding. OpenAPI is still the source of
+    // truth for full per-field JSON Schemas; this endpoint trades depth
+    // for reliability and surfaces just enough metadata for the agent to
+    // plan a follow-up call (create_document, list_documents, etc.).
+    //
+    // Auth: unauthenticated, like /openapi.json — the response contains
+    // only schema-shape metadata that is already public via OpenAPI.
+    // ---------------------------------------------------------------------------
+    router.get('/collections', async () => {
+        const config = getActuateConfig();
+        if (!config)
+            return errorResponse('CMS not configured', 500);
+        const collections = Object.entries(config.collections ?? {}).map(([slug, def]) => {
+            const fields = (def?.fields ?? {});
+            // Reduce each field to `{ name, type, required }` — enough for the
+            // agent to plan a create/update without sending the full validator.
+            const fieldSummary = Object.entries(fields).map(([name, fieldDef]) => ({
+                name,
+                type: typeof fieldDef?.type === 'string' ? fieldDef.type : 'unknown',
+                required: fieldDef?.required === true,
+            }));
+            return {
+                slug,
+                labels: def?.labels ?? { singular: slug, plural: slug },
+                type: def?.type ?? 'page',
+                urlPrefix: def?.urlPrefix ?? slug,
+                hidden: def?.admin?.hidden === true,
+                fieldCount: fieldSummary.length,
+                fields: fieldSummary,
+            };
+        });
+        return json({ data: collections });
+    });
     router.get('/docs', async () => {
         const html = `<!DOCTYPE html>
 <html>
@@ -4672,7 +4712,7 @@ export function registerCMSRoutes(router) {
         if (opts.parentId) {
             const root = await findCommentRecipient(opts.parentId);
             if (root && root.userId && root.userId !== opts.actorId) {
-                await createNotification(ndb, {
+                const result = await createNotification(ndb, {
                     userId: root.userId,
                     documentId: opts.documentId,
                     commentId: opts.commentId,
@@ -4683,12 +4723,21 @@ export function registerCMSRoutes(router) {
                         excerpt: excerptForNotification(opts.body),
                     },
                 });
+                // Push the new DTO to any active SSE subscribers for this user
+                // so the bell badge bumps in real time. We only publish AFTER
+                // the DB insert succeeds — otherwise an SSE client would see a
+                // ghost notification that doesn't exist on a subsequent
+                // refresh. Failure to publish (no subscribers, or bus error)
+                // is non-fatal: the poll fallback in the admin UI still
+                // converges.
+                if (result.ok)
+                    publishNotification(result.value);
             }
         }
         for (const userId of extractMentionedUserIds(opts.body)) {
             if (userId === opts.actorId)
                 continue;
-            await createNotification(ndb, {
+            const result = await createNotification(ndb, {
                 userId,
                 documentId: opts.documentId,
                 commentId: opts.commentId,
@@ -4699,6 +4748,8 @@ export function registerCMSRoutes(router) {
                     excerpt: excerptForNotification(opts.body),
                 },
             });
+            if (result.ok)
+                publishNotification(result.value);
         }
     }
     /** Notify the comment's author when someone else resolves their thread. */
@@ -4706,7 +4757,7 @@ export function registerCMSRoutes(router) {
         const comment = await findCommentRecipient(opts.commentId);
         if (!comment || !comment.userId || comment.userId === opts.actorId)
             return;
-        await createNotification(notificationsDb(), {
+        const result = await createNotification(notificationsDb(), {
             userId: comment.userId,
             commentId: opts.commentId,
             payload: {
@@ -4716,6 +4767,8 @@ export function registerCMSRoutes(router) {
                 rootExcerpt: excerptForNotification(comment.body),
             },
         });
+        if (result.ok)
+            publishNotification(result.value);
     }
     router.post('/documents/:documentId/comments', async (request, params) => {
         try {
@@ -4967,6 +5020,29 @@ export function registerCMSRoutes(router) {
             return internalError(err, 'mark all notifications read');
         }
     });
+    // Per-user notification SSE push channel (Phase 7 carry-over). The
+    // admin's NotificationBell subscribes via EventSource for real-time
+    // delivery of comment_reply / comment_mention / comment_resolved
+    // events. The existing GET /notifications and
+    // /notifications/unread-count REST endpoints are kept as a
+    // poll-fallback path for multi-node deployments where a write on
+    // node A doesn't reach SSE subscribers on node B (the in-process
+    // bus is single-instance by design — see notification-bus.ts).
+    //
+    // Auth: same scope as every other /notifications route — the
+    // session userId determines which channel the stream subscribes to;
+    // there is no admin override.
+    router.get('/notifications/stream', async (request) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            return createNotificationStreamResponse(auth.session.userId);
+        }
+        catch (err) {
+            return internalError(err, 'notifications stream');
+        }
+    });
     // ---------------------------------------------------------------------------
     // Workflow routes
     // ---------------------------------------------------------------------------