@actuate-media/cms-core 0.23.0 → 0.24.0

package/dist/preview/sse-stream.d.ts

@@ -1,4 +1,6 @@
 import type { PreviewSession } from './index.js';
+import { encodeSseEvent } from '../realtime/sse.js';
+export { encodeSseEvent };
 /**
  * Default keepalive interval. 25 s sits safely under the most aggressive
  * proxy/idle timeouts we've encountered in production (Cloudflare 30 s,
@@ -18,11 +20,6 @@ export interface PreviewStreamOptions {
     /** Override for tests so we don't tie up the suite for 4 minutes. */
     maxLifetimeMs?: number;
 }
-/**
- * Encode a single SSE message. `event` is optional; when omitted the
- * default `message` event is used.
- */
-export declare function encodeSseEvent(data: unknown, event?: string): string;
 /**
  * Build a `ReadableStream` of Server-Sent Events for the given preview
  * session. The stream:

package/dist/preview/sse-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse-stream.d.ts","sourceRoot":"","sources":["../../src/preview/sse-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAUhD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAgB,CAAA;AAExD,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,YAAY,CAAC,EAC1D,IAAI,GAAE,oBAAyB,GAC9B,cAAc,CAAC,UAAU,CAAC,CAwD5B;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAA;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,YAAY,CAAC,EAC1D,IAAI,CAAC,EAAE,oBAAoB,GAC1B,QAAQ,CAKV"}
+{"version":3,"file":"sse-stream.d.ts","sourceRoot":"","sources":["../../src/preview/sse-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD,OAAO,EAAE,cAAc,EAAE,CAAA;AAezB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAgB,CAAA;AAExD,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,YAAY,CAAC,EAC1D,IAAI,GAAE,oBAAyB,GAC9B,cAAc,CAAC,UAAU,CAAC,CAwD5B;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAA;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,YAAY,CAAC,EAC1D,IAAI,CAAC,EAAE,oBAAoB,GAC1B,QAAQ,CAKV"}

package/dist/preview/sse-stream.js

@@ -1,8 +1,15 @@
 import { subscribePreviewUpdates } from './event-bus.js';
+import { encodeSseEvent } from '../realtime/sse.js';
+export { encodeSseEvent };
 /**
  * SSE wire format helpers. We keep them small and pure so the route handler
  * can build a `ReadableStream<Uint8Array>` without pulling in any extra
  * dependencies (this also keeps the file edge-compatible).
+ *
+ * The encoder itself lives in `../realtime/sse.ts` — a single source of
+ * truth across every SSE channel in cms-core (preview + notifications,
+ * today). Re-exported here so existing callers (and tests) that import
+ * it from this module keep working.
  */
 const encoder = new TextEncoder();
 /**
@@ -18,22 +25,6 @@ export const PREVIEW_SSE_HEARTBEAT_MS = 25_000;
  * few minutes regardless of activity.
  */
 export const PREVIEW_SSE_MAX_LIFETIME_MS = 4 * 60 * 1000;
-/**
- * Encode a single SSE message. `event` is optional; when omitted the
- * default `message` event is used.
- */
-export function encodeSseEvent(data, event) {
-    const lines = [];
-    if (event)
-        lines.push(`event: ${event}`);
-    const serialized = typeof data === 'string' ? data : JSON.stringify(data);
-    for (const line of serialized.split('\n')) {
-        lines.push(`data: ${line}`);
-    }
-    lines.push('');
-    lines.push('');
-    return lines.join('\n');
-}
 /**
  * Build a `ReadableStream` of Server-Sent Events for the given preview
  * session. The stream:

package/dist/preview/sse-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse-stream.js","sourceRoot":"","sources":["../../src/preview/sse-stream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sse-stream.js","sourceRoot":"","sources":["../../src/preview/sse-stream.ts"],"names":[],"mappings":"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"}

package/dist/realtime/index.d.ts

@@ -15,4 +15,7 @@ export { createRealtimeGateway, type AttachRealtimeGatewayOptions, type Authenti
 export { createPrismaDocumentPersistence, type PrismaDocumentCRDTClient, type PrismaDocumentPersistenceOptions, } from './persistence.js';
 export { createComment, deleteComment, listComments, normaliseBody, parseAnchor, reopenComment, resolveComment, toCommentDTO, updateComment, DEFAULT_COMMENT_LIST_PAGE_SIZE, MAX_COMMENT_BODY_LENGTH, MAX_COMMENT_LIST_PAGE_SIZE, type CommentAnchor, type CommentDTO, type CommentsDB, type CommentsError, type CommentsResult, type CreateCommentInput, type DocumentCommentRow, type ListCommentsFilter, type UpdateCommentInput, } from './comments.js';
 export { createNotification, excerptForNotification, extractMentionedUserIds, isNotificationKind, listForUser as listNotificationsForUser, markAllRead as markAllNotificationsRead, markRead as markNotificationRead, toNotificationDTO, unreadCount as notificationsUnreadCount, DEFAULT_NOTIFICATION_LIST_PAGE_SIZE, MAX_NOTIFICATION_LIST_PAGE_SIZE, type CreateNotificationInput, type DocumentNotificationRow, type ListNotificationsFilter, type NotificationDTO, type NotificationKind, type NotificationPayload, type NotificationsDB, type NotificationsError, type NotificationsResult, } from './notifications.js';
+export { publishNotification, subscribeUserNotifications, notificationSubscriberCount, type NotificationListener, } from './notification-bus.js';
+export { createNotificationStream, createNotificationStreamResponse, NOTIFICATION_SSE_HEADERS, NOTIFICATION_SSE_HEARTBEAT_MS, NOTIFICATION_SSE_MAX_LIFETIME_MS, type NotificationStreamOptions, } from './notification-stream.js';
+export { encodeSseEvent } from './sse.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,GACtC,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,IAAI,wBAAwB,EACvC,WAAW,IAAI,wBAAwB,EACvC,QAAQ,IAAI,oBAAoB,EAChC,iBAAiB,EACjB,WAAW,IAAI,wBAAwB,EACvC,mCAAmC,EACnC,+BAA+B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,GACtC,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,IAAI,wBAAwB,EACvC,WAAW,IAAI,wBAAwB,EACvC,QAAQ,IAAI,oBAAoB,EAChC,iBAAiB,EACjB,WAAW,IAAI,wBAAwB,EACvC,mCAAmC,EACnC,+BAA+B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAA;AAM9B,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,6BAA6B,EAC7B,gCAAgC,EAChC,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAA;AAIjC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}

package/dist/realtime/index.js

@@ -15,4 +15,13 @@ export { createRealtimeGateway, } from './gateway.js';
 export { createPrismaDocumentPersistence, } from './persistence.js';
 export { createComment, deleteComment, listComments, normaliseBody, parseAnchor, reopenComment, resolveComment, toCommentDTO, updateComment, DEFAULT_COMMENT_LIST_PAGE_SIZE, MAX_COMMENT_BODY_LENGTH, MAX_COMMENT_LIST_PAGE_SIZE, } from './comments.js';
 export { createNotification, excerptForNotification, extractMentionedUserIds, isNotificationKind, listForUser as listNotificationsForUser, markAllRead as markAllNotificationsRead, markRead as markNotificationRead, toNotificationDTO, unreadCount as notificationsUnreadCount, DEFAULT_NOTIFICATION_LIST_PAGE_SIZE, MAX_NOTIFICATION_LIST_PAGE_SIZE, } from './notifications.js';
+export { publishNotification, subscribeUserNotifications, notificationSubscriberCount, } from './notification-bus.js';
+// `__resetNotificationBus` is intentionally NOT re-exported here. It
+// is a test helper — tests import it directly from
+// `./notification-bus.js` so production consumers can't reach it via
+// the package's public realtime surface.
+export { createNotificationStream, createNotificationStreamResponse, NOTIFICATION_SSE_HEADERS, NOTIFICATION_SSE_HEARTBEAT_MS, NOTIFICATION_SSE_MAX_LIFETIME_MS, } from './notification-stream.js';
+// Shared SSE encoder. Single source of truth across every Server-Sent
+// Events stream in cms-core (preview + notifications).
+export { encodeSseEvent } from './sse.js';
 //# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,qBAAqB,GAMtB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,+BAA+B,GAGhC,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,GAU3B,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,IAAI,wBAAwB,EACvC,WAAW,IAAI,wBAAwB,EACvC,QAAQ,IAAI,oBAAoB,EAChC,iBAAiB,EACjB,WAAW,IAAI,wBAAwB,EACvC,mCAAmC,EACnC,+BAA+B,GAUhC,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,qBAAqB,GAMtB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,+BAA+B,GAGhC,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,GAU3B,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,IAAI,wBAAwB,EACvC,WAAW,IAAI,wBAAwB,EACvC,QAAQ,IAAI,oBAAoB,EAChC,iBAAiB,EACjB,WAAW,IAAI,wBAAwB,EACvC,mCAAmC,EACnC,+BAA+B,GAUhC,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,GAE5B,MAAM,uBAAuB,CAAA;AAC9B,qEAAqE;AACrE,mDAAmD;AACnD,qEAAqE;AACrE,yCAAyC;AAEzC,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,6BAA6B,EAC7B,gCAAgC,GAEjC,MAAM,0BAA0B,CAAA;AAEjC,sEAAsE;AACtE,uDAAuD;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}

package/dist/realtime/notification-bus.d.ts

@@ -0,0 +1,60 @@
+/**
+ * In-process pub/sub for per-user notification events.
+ *
+ * Mirrors the design of `preview/event-bus.ts` but keys subscriptions
+ * by `userId` instead of `(collection, documentId)`. When the comments
+ * hook layer persists a new `DocumentNotification`, it also calls
+ * `publishNotification(userId, dto)` so any active SSE stream for that
+ * user receives the row in real time. The HTTP layer still works for
+ * clients that don't subscribe — the bus is strictly additive.
+ *
+ * Why in-process:
+ *
+ *   - Single-node deployments get push-to-bell delivery "for free" with
+ *     zero infrastructure dependency. This is the dominant deployment
+ *     shape for self-hosted Actuate today.
+ *   - Multi-node deployments lose cross-node delivery — node A only
+ *     pushes to its own subscribers. The poll fallback in the admin UI
+ *     keeps the bell correct on those nodes; SSE is treated as a
+ *     latency-win optimisation, not a correctness primitive. A future
+ *     slice can swap this for a Redis/Postgres-listen-backed bus
+ *     without changing the public contract (`publishNotification` /
+ *     `subscribeUserNotifications`).
+ *
+ * Memory safety: the per-user `Set<Listener>` is dropped from the map
+ * when the last subscriber unsubscribes, so an idle process holding
+ * thousands of users does not pay any storage cost.
+ */
+import type { NotificationDTO } from './notifications.js';
+export type NotificationListener = (notification: NotificationDTO) => void;
+/**
+ * Register a listener for `userId`'s notifications. Returns an
+ * unsubscribe function — callers MUST invoke it on disconnect, or the
+ * bus will leak listener references indefinitely (each listener pins
+ * its enclosing closure).
+ */
+export declare function subscribeUserNotifications(userId: string, listener: NotificationListener): () => void;
+/**
+ * Publish `notification` to every listener registered for its
+ * `userId`. Listener exceptions are isolated — one buggy stream must
+ * not take down every other subscriber for the same user (and never
+ * the calling write path).
+ *
+ * Returns `true` when at least one listener was reachable, `false`
+ * otherwise (useful in tests to assert SSE wiring; production code can
+ * ignore the return value).
+ */
+export declare function publishNotification(notification: NotificationDTO): boolean;
+/**
+ * How many active subscribers does this user have? Useful for tests
+ * and operator dashboards ("is anyone listening?"). Not part of the
+ * write-path contract.
+ */
+export declare function notificationSubscriberCount(userId: string): number;
+/**
+ * Test helper. Drops every subscription. Production code never calls
+ * this — listener leaks should be visible in the test suite, not
+ * papered over in production.
+ */
+export declare function __resetNotificationBus(): void;
+//# sourceMappingURL=notification-bus.d.ts.map

package/dist/realtime/notification-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-bus.d.ts","sourceRoot":"","sources":["../../src/realtime/notification-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,eAAe,KAAK,IAAI,CAAA;AAI1E;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,IAAI,CAmBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,eAAe,GAAG,OAAO,CAkB1E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/realtime/notification-bus.js

@@ -0,0 +1,77 @@
+const listenersByUser = new Map();
+/**
+ * Register a listener for `userId`'s notifications. Returns an
+ * unsubscribe function — callers MUST invoke it on disconnect, or the
+ * bus will leak listener references indefinitely (each listener pins
+ * its enclosing closure).
+ */
+export function subscribeUserNotifications(userId, listener) {
+    if (!userId) {
+        // Defensive: an empty userId would silently bucket every "unknown"
+        // subscriber into the same set, leaking notifications across
+        // sessions. Reject at the entry point.
+        throw new Error('subscribeUserNotifications requires a non-empty userId');
+    }
+    let set = listenersByUser.get(userId);
+    if (!set) {
+        set = new Set();
+        listenersByUser.set(userId, set);
+    }
+    set.add(listener);
+    return () => {
+        const current = listenersByUser.get(userId);
+        if (!current)
+            return;
+        current.delete(listener);
+        if (current.size === 0)
+            listenersByUser.delete(userId);
+    };
+}
+/**
+ * Publish `notification` to every listener registered for its
+ * `userId`. Listener exceptions are isolated — one buggy stream must
+ * not take down every other subscriber for the same user (and never
+ * the calling write path).
+ *
+ * Returns `true` when at least one listener was reachable, `false`
+ * otherwise (useful in tests to assert SSE wiring; production code can
+ * ignore the return value).
+ */
+export function publishNotification(notification) {
+    // The DTO's `userId` is the source of truth; we deliberately don't
+    // accept a separate userId arg so callers can't accidentally publish
+    // to the wrong channel (e.g. publishing reply notifications to the
+    // actor instead of the recipient).
+    const set = listenersByUser.get(notification.userId);
+    if (!set || set.size === 0)
+        return false;
+    // Snapshot the listener set before iteration — a listener may
+    // synchronously unsubscribe (e.g. close its stream on the first
+    // event), and mutating the Set during forEach would skip neighbours.
+    for (const listener of [...set]) {
+        try {
+            listener(notification);
+        }
+        catch {
+            /* isolated; see contract above */
+        }
+    }
+    return true;
+}
+/**
+ * How many active subscribers does this user have? Useful for tests
+ * and operator dashboards ("is anyone listening?"). Not part of the
+ * write-path contract.
+ */
+export function notificationSubscriberCount(userId) {
+    return listenersByUser.get(userId)?.size ?? 0;
+}
+/**
+ * Test helper. Drops every subscription. Production code never calls
+ * this — listener leaks should be visible in the test suite, not
+ * papered over in production.
+ */
+export function __resetNotificationBus() {
+    listenersByUser.clear();
+}
+//# sourceMappingURL=notification-bus.js.map

package/dist/realtime/notification-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-bus.js","sourceRoot":"","sources":["../../src/realtime/notification-bus.ts"],"names":[],"mappings":"AA+BA,MAAM,eAAe,GAAG,IAAI,GAAG,EAAqC,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAc,EACd,QAA8B;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,mEAAmE;QACnE,6DAA6D;QAC7D,uCAAuC;QACvC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAC3E,CAAC;IACD,IAAI,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;QACf,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAClC,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,GAAG,EAAE;QACV,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACxB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACxD,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAA6B;IAC/D,mEAAmE;IACnE,qEAAqE;IACrE,mEAAmE;IACnE,mCAAmC;IACnC,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACpD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACxC,8DAA8D;IAC9D,gEAAgE;IAChE,qEAAqE;IACrE,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,QAAQ,CAAC,YAAY,CAAC,CAAA;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAc;IACxD,OAAO,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,eAAe,CAAC,KAAK,EAAE,CAAA;AACzB,CAAC"}

package/dist/realtime/notification-stream.d.ts

@@ -0,0 +1,50 @@
+import { encodeSseEvent } from './sse.js';
+export { encodeSseEvent };
+/**
+ * Heartbeat interval. 25 s sits safely under the most aggressive
+ * proxy/idle timeouts we've encountered in production (Cloudflare 30 s,
+ * Vercel Serverless 30 s, most reverse-proxies 60 s). Identical to the
+ * preview stream's value so both channels behave the same way under
+ * the same proxy fleet.
+ */
+export declare const NOTIFICATION_SSE_HEARTBEAT_MS = 25000;
+/**
+ * Maximum stream lifetime in ms. After this, the server closes the
+ * stream cleanly so `EventSource` reconnects — important because some
+ * platforms (Vercel Fluid Compute, Cloudflare Workers) cap any single
+ * response at a few minutes regardless of activity.
+ */
+export declare const NOTIFICATION_SSE_MAX_LIFETIME_MS: number;
+export interface NotificationStreamOptions {
+    /** Override for tests so we don't have to wait 25 seconds. */
+    heartbeatMs?: number;
+    /** Override for tests so we don't tie up the suite for 4 minutes. */
+    maxLifetimeMs?: number;
+}
+/**
+ * Build a `ReadableStream<Uint8Array>` of notification SSE events for
+ * the given userId. See the file header for the wire format.
+ *
+ * The stream:
+ *
+ *   1. Emits the `ready` frame.
+ *   2. Subscribes to the notification bus for `userId`.
+ *   3. Forwards every `publishNotification(...)` to the client.
+ *   4. Sends heartbeats every `heartbeatMs`.
+ *   5. Closes cleanly after `maxLifetimeMs`, letting `EventSource`
+ *      auto-reconnect (the browser does this for us at the HTTP/2
+ *      stream layer).
+ *
+ * On `cancel()` (client disconnect or `controller.close()`), every
+ * timer is cleared and the bus subscription is dropped — no leaked
+ * listener after a hang-up.
+ */
+export declare function createNotificationStream(userId: string, opts?: NotificationStreamOptions): ReadableStream<Uint8Array>;
+/**
+ * Standard SSE response headers. Identical to the preview stream's
+ * header set — same proxy fleet, same X-Accel-Buffering disable, same
+ * cache-control directives.
+ */
+export declare const NOTIFICATION_SSE_HEADERS: Record<string, string>;
+export declare function createNotificationStreamResponse(userId: string, opts?: NotificationStreamOptions): Response;
+//# sourceMappingURL=notification-stream.d.ts.map

package/dist/realtime/notification-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-stream.d.ts","sourceRoot":"","sources":["../../src/realtime/notification-stream.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEzC,OAAO,EAAE,cAAc,EAAE,CAAA;AAIzB;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,QAAS,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,QAAgB,CAAA;AAE7D,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,yBAA8B,GACnC,cAAc,CAAC,UAAU,CAAC,CAmE5B;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO3D,CAAA;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,yBAAyB,GAC/B,QAAQ,CAKV"}

package/dist/realtime/notification-stream.js

@@ -0,0 +1,148 @@
+/**
+ * Per-user notification SSE stream.
+ *
+ * Mirrors `preview/sse-stream.ts` for the notification bus: subscribe
+ * to the user's channel, forward every `NotificationDTO` to the
+ * connected `EventSource` client, emit periodic heartbeats so proxies
+ * don't kill the idle connection, and close cleanly after a bounded
+ * lifetime so the client reconnects before platform max-duration caps
+ * fire.
+ *
+ * Wire format:
+ *
+ *   event: ready                    (sent once on connect)
+ *   data: {"userId":"<uid>"}
+ *
+ *   event: notification             (sent for each published DTO)
+ *   data: <NotificationDTO JSON>
+ *
+ *   : heartbeat\n\n                 (every 25 s, no `event:` line)
+ *
+ * The `ready` frame is the client's signal that the server-side
+ * subscription is wired up. Until it arrives, the client must NOT
+ * stop polling — there's still a window where the open() handshake
+ * has fired but the bus subscription hasn't been attached yet.
+ */
+import { subscribeUserNotifications } from './notification-bus.js';
+import { encodeSseEvent } from './sse.js';
+export { encodeSseEvent };
+const encoder = new TextEncoder();
+/**
+ * Heartbeat interval. 25 s sits safely under the most aggressive
+ * proxy/idle timeouts we've encountered in production (Cloudflare 30 s,
+ * Vercel Serverless 30 s, most reverse-proxies 60 s). Identical to the
+ * preview stream's value so both channels behave the same way under
+ * the same proxy fleet.
+ */
+export const NOTIFICATION_SSE_HEARTBEAT_MS = 25_000;
+/**
+ * Maximum stream lifetime in ms. After this, the server closes the
+ * stream cleanly so `EventSource` reconnects — important because some
+ * platforms (Vercel Fluid Compute, Cloudflare Workers) cap any single
+ * response at a few minutes regardless of activity.
+ */
+export const NOTIFICATION_SSE_MAX_LIFETIME_MS = 4 * 60 * 1000;
+/**
+ * Build a `ReadableStream<Uint8Array>` of notification SSE events for
+ * the given userId. See the file header for the wire format.
+ *
+ * The stream:
+ *
+ *   1. Emits the `ready` frame.
+ *   2. Subscribes to the notification bus for `userId`.
+ *   3. Forwards every `publishNotification(...)` to the client.
+ *   4. Sends heartbeats every `heartbeatMs`.
+ *   5. Closes cleanly after `maxLifetimeMs`, letting `EventSource`
+ *      auto-reconnect (the browser does this for us at the HTTP/2
+ *      stream layer).
+ *
+ * On `cancel()` (client disconnect or `controller.close()`), every
+ * timer is cleared and the bus subscription is dropped — no leaked
+ * listener after a hang-up.
+ */
+export function createNotificationStream(userId, opts = {}) {
+    if (!userId) {
+        throw new Error('createNotificationStream requires a non-empty userId');
+    }
+    const heartbeatMs = opts.heartbeatMs ?? NOTIFICATION_SSE_HEARTBEAT_MS;
+    const maxLifetimeMs = opts.maxLifetimeMs ?? NOTIFICATION_SSE_MAX_LIFETIME_MS;
+    let heartbeat;
+    let lifetime;
+    let unsubscribe;
+    let torn = false;
+    // Single teardown path shared by:
+    //   - the lifetime timer (server-initiated close before the
+    //     platform's max-duration cap fires), and
+    //   - the consumer's reader.cancel() (client disconnect).
+    // `cancel()` is NOT invoked when the controller closes itself —
+    // only on consumer-initiated cancellation. Without this shared
+    // helper we'd leak the bus subscription whenever the lifetime
+    // timer fires.
+    const teardown = () => {
+        if (torn)
+            return;
+        torn = true;
+        if (heartbeat)
+            clearInterval(heartbeat);
+        if (lifetime)
+            clearTimeout(lifetime);
+        if (unsubscribe)
+            unsubscribe();
+    };
+    return new ReadableStream({
+        start(controller) {
+            const enqueue = (chunk) => {
+                try {
+                    controller.enqueue(encoder.encode(chunk));
+                }
+                catch {
+                    // Controller can be closed mid-emit if the client disconnected
+                    // between the publishNotification call and the enqueue.
+                    // Swallow — teardown() takes care of the rest.
+                }
+            };
+            enqueue(encodeSseEvent({ userId }, 'ready'));
+            unsubscribe = subscribeUserNotifications(userId, (notification) => {
+                enqueue(encodeSseEvent(notification, 'notification'));
+            });
+            heartbeat = setInterval(() => {
+                enqueue(`: heartbeat\n\n`);
+            }, heartbeatMs);
+            lifetime = setTimeout(() => {
+                // Drop the bus subscription BEFORE closing the controller —
+                // otherwise the listener would still be attached for the
+                // microtask between close() and the next event loop tick.
+                teardown();
+                try {
+                    controller.close();
+                }
+                catch {
+                    /* already closed */
+                }
+            }, maxLifetimeMs);
+        },
+        cancel() {
+            teardown();
+        },
+    });
+}
+/**
+ * Standard SSE response headers. Identical to the preview stream's
+ * header set — same proxy fleet, same X-Accel-Buffering disable, same
+ * cache-control directives.
+ */
+export const NOTIFICATION_SSE_HEADERS = {
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-transform',
+    Connection: 'keep-alive',
+    // Discourage proxies/CDNs from buffering — without this nginx will
+    // hold events back until 4 KB of payload accumulates.
+    'X-Accel-Buffering': 'no',
+};
+export function createNotificationStreamResponse(userId, opts) {
+    return new Response(createNotificationStream(userId, opts), {
+        status: 200,
+        headers: NOTIFICATION_SSE_HEADERS,
+    });
+}
+//# sourceMappingURL=notification-stream.js.map

package/dist/realtime/notification-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-stream.js","sourceRoot":"","sources":["../../src/realtime/notification-stream.ts"],"names":[],"mappings":"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"}

package/dist/realtime/sse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Minimal SSE wire-format helpers shared by every Server-Sent Events
+ * stream in `cms-core` (preview updates and per-user notifications,
+ * today). Kept dependency-free so any future stream can `import` it
+ * without dragging in module state from sibling channels.
+ *
+ * A single source of truth here means a bug in the encoder is fixed
+ * once, not in N parallel copies.
+ */
+/**
+ * Encode a single SSE message. `event` is optional; when omitted the
+ * default `message` event name is used (per the SSE spec). Multi-line
+ * payloads are split across multiple `data:` lines so the receiving
+ * `EventSource` reassembles them.
+ *
+ * The trailing blank line is the SSE event delimiter — DO NOT drop
+ * it. Browsers will hold the event in their buffer until they see it.
+ */
+export declare function encodeSseEvent(data: unknown, event?: string): string;
+//# sourceMappingURL=sse.d.ts.map

package/dist/realtime/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/realtime/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUpE"}

package/dist/realtime/sse.js

@@ -0,0 +1,31 @@
+/**
+ * Minimal SSE wire-format helpers shared by every Server-Sent Events
+ * stream in `cms-core` (preview updates and per-user notifications,
+ * today). Kept dependency-free so any future stream can `import` it
+ * without dragging in module state from sibling channels.
+ *
+ * A single source of truth here means a bug in the encoder is fixed
+ * once, not in N parallel copies.
+ */
+/**
+ * Encode a single SSE message. `event` is optional; when omitted the
+ * default `message` event name is used (per the SSE spec). Multi-line
+ * payloads are split across multiple `data:` lines so the receiving
+ * `EventSource` reassembles them.
+ *
+ * The trailing blank line is the SSE event delimiter — DO NOT drop
+ * it. Browsers will hold the event in their buffer until they see it.
+ */
+export function encodeSseEvent(data, event) {
+    const lines = [];
+    if (event)
+        lines.push(`event: ${event}`);
+    const serialized = typeof data === 'string' ? data : JSON.stringify(data);
+    for (const line of serialized.split('\n')) {
+        lines.push(`data: ${line}`);
+    }
+    lines.push('');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=sse.js.map

package/dist/realtime/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/realtime/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,KAAc;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACzE,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;IAC7B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actuate-media/cms-core",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/actuate-media/actuatecms.git",