@actuate-media/cms-core 0.21.0 → 0.22.0

package/dist/realtime/gateway.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Realtime gateway for `@actuate-media/realtime` rooms.
+ *
+ * The gateway is **transport-agnostic by design**: it does not depend on
+ * `ws`, `uWebSockets.js`, Cloudflare Workers, or any specific framework.
+ * Consumers create a `WebSocketLike` adapter around their server's socket
+ * primitive and pass it to `gateway.handleConnection(socket, req)`.
+ *
+ * Responsibilities:
+ *   1. Authenticate the connection (delegated to `options.authenticate`).
+ *   2. Look up (or lazily create) the `Room` for the document.
+ *   3. Pump bytes between the socket and the room.
+ *   4. Persist edits via the configured `DocumentPersistence`.
+ *   5. Reap idle rooms (no connections + no pending writes) to bound memory.
+ *
+ * The companion file `persistence.ts` provides
+ * `createPrismaDocumentPersistence(db)` which the gateway uses by default
+ * when callers don't supply their own.
+ */
+import { type DocumentPersistence } from '@actuate-media/realtime';
+/**
+ * Minimal contract the gateway needs from a real WebSocket implementation.
+ * Compatible with `ws.WebSocket`, browser-native `WebSocket`, the
+ * Cloudflare Workers `WebSocket` Hibernation API, and Bun's WebSocket.
+ *
+ * Adapter authors typically just wrap their library's socket in a thin
+ * shim that conforms to this shape.
+ */
+export interface WebSocketLike {
+    /** Send a binary frame. */
+    send(data: Uint8Array): void;
+    /** Close the socket. Idempotent. */
+    close(code?: number, reason?: string): void;
+    /** Subscribe to inbound binary frames. */
+    on(event: 'message', handler: (data: Uint8Array) => void): void;
+    /** Subscribe to close events. */
+    on(event: 'close', handler: () => void): void;
+    /** Subscribe to error events. */
+    on(event: 'error', handler: (err: Error) => void): void;
+}
+/** Information about the inbound HTTP upgrade request. */
+export interface UpgradeRequestInfo {
+    /** Path + query, e.g. `/api/cms/realtime/sync?documentId=doc_1`. */
+    url: string;
+    /** Lowercased header bag. Authentication usually reads `cookie` or `authorization`. */
+    headers: Readonly<Record<string, string | undefined>>;
+}
+/**
+ * Outcome of the authentication / routing decision. Return `null` to reject
+ * the connection (the gateway will close it with code 4401).
+ *
+ * `connectionId` should be globally unique within the gateway instance —
+ * usually a `crypto.randomUUID()` or `req.headers['sec-websocket-key']`.
+ */
+export interface AuthenticatedConnection {
+    documentId: string;
+    connectionId: string;
+    /** Tag returned via `room.onUpdate` so applications can audit edits. */
+    userId?: string;
+}
+export interface AttachRealtimeGatewayOptions {
+    /**
+     * Validate the upgrade request and map it to a documentId. Return `null`
+     * to reject. Throws are treated as 401 and the connection is closed.
+     */
+    authenticate: (req: UpgradeRequestInfo) => Promise<AuthenticatedConnection | null>;
+    /** Storage adapter. Defaults to a noop in-memory persistence (rooms are not durable). */
+    persistence?: DocumentPersistence;
+    /**
+     * Reap a room after it has had zero connections for this many ms. Default 60000.
+     * Set to `Infinity` to disable reaping.
+     */
+    idleTimeoutMs?: number;
+    /** Debounce window for persistence writes (ms). Forwarded to `bindPersistence`. */
+    persistenceDebounceMs?: number;
+    /** Maximum time between writes (ms). Forwarded to `bindPersistence`. */
+    persistenceMaxIdleMs?: number;
+    /** Called whenever a room is created. Useful for metrics. */
+    onRoomOpen?: (documentId: string) => void;
+    /** Called whenever a room is destroyed. Useful for metrics. */
+    onRoomClose?: (documentId: string) => void;
+    /** Called when a persistence save fails. Defaults to console.error. */
+    onPersistenceError?: (documentId: string, err: unknown) => void;
+}
+export interface RealtimeGateway {
+    /** Number of currently active rooms. Useful for /health endpoints. */
+    readonly roomCount: number;
+    /** Number of currently connected sockets across all rooms. */
+    readonly connectionCount: number;
+    /**
+     * Bind an authenticated socket to its room. Call this from your HTTP
+     * upgrade handler after `wss.handleUpgrade(...)` has produced a socket.
+     */
+    handleConnection(socket: WebSocketLike, req: UpgradeRequestInfo): Promise<void>;
+    /**
+     * Force-close every connection, flush every room, and tear everything
+     * down. Call from your process's SIGTERM handler.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a realtime gateway. The returned object is intended to live for the
+ * lifetime of the server process — one per node. Calling
+ * `shutdown()` is mandatory for graceful exit (it flushes pending writes).
+ */
+export declare function createRealtimeGateway(opts: AttachRealtimeGatewayOptions): RealtimeGateway;
+//# sourceMappingURL=gateway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/realtime/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAIL,KAAK,mBAAmB,EAEzB,MAAM,yBAAyB,CAAA;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IAC5B,oCAAoC;IACpC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,0CAA0C;IAC1C,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAA;IAC/D,iCAAiC;IACjC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;IAC7C,iCAAiC;IACjC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;CACxD;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAA;IACX,uFAAuF;IACvF,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAA;IAClF,yFAAyF;IACzF,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CAChE;AAED,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/E;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,4BAA4B,GAAG,eAAe,CAuLzF"}

package/dist/realtime/gateway.js

@@ -0,0 +1,215 @@
+/**
+ * Realtime gateway for `@actuate-media/realtime` rooms.
+ *
+ * The gateway is **transport-agnostic by design**: it does not depend on
+ * `ws`, `uWebSockets.js`, Cloudflare Workers, or any specific framework.
+ * Consumers create a `WebSocketLike` adapter around their server's socket
+ * primitive and pass it to `gateway.handleConnection(socket, req)`.
+ *
+ * Responsibilities:
+ *   1. Authenticate the connection (delegated to `options.authenticate`).
+ *   2. Look up (or lazily create) the `Room` for the document.
+ *   3. Pump bytes between the socket and the room.
+ *   4. Persist edits via the configured `DocumentPersistence`.
+ *   5. Reap idle rooms (no connections + no pending writes) to bound memory.
+ *
+ * The companion file `persistence.ts` provides
+ * `createPrismaDocumentPersistence(db)` which the gateway uses by default
+ * when callers don't supply their own.
+ */
+import { bindPersistence, createRoom, } from '@actuate-media/realtime';
+/**
+ * Create a realtime gateway. The returned object is intended to live for the
+ * lifetime of the server process — one per node. Calling
+ * `shutdown()` is mandatory for graceful exit (it flushes pending writes).
+ */
+export function createRealtimeGateway(opts) {
+    const persistence = opts.persistence ?? createNoopPersistence();
+    const idleTimeoutMs = opts.idleTimeoutMs ?? 60_000;
+    const onError = opts.onPersistenceError ??
+        ((documentId, err) => {
+            // eslint-disable-next-line no-console
+            console.error(`[cms-core realtime] save failed for ${documentId}:`, err);
+        });
+    const rooms = new Map();
+    let connectionCount = 0;
+    let shuttingDown = false;
+    async function getOrCreateRoom(documentId) {
+        const existing = rooms.get(documentId);
+        if (existing) {
+            if (existing.reapTimer) {
+                clearTimeout(existing.reapTimer);
+                existing.reapTimer = null;
+            }
+            return existing;
+        }
+        const initial = (await persistence.load(documentId)) ?? undefined;
+        const room = createRoom({ documentId, initialState: initial });
+        const binding = bindPersistence(room, persistence, {
+            debounceMs: opts.persistenceDebounceMs,
+            maxIdleMs: opts.persistenceMaxIdleMs,
+            onError: (err) => onError(documentId, err),
+        });
+        const entry = { room, binding, connections: 0, reapTimer: null };
+        rooms.set(documentId, entry);
+        opts.onRoomOpen?.(documentId);
+        return entry;
+    }
+    function scheduleReap(documentId) {
+        const entry = rooms.get(documentId);
+        if (!entry)
+            return;
+        if (entry.connections > 0)
+            return;
+        if (entry.reapTimer)
+            return;
+        if (!Number.isFinite(idleTimeoutMs))
+            return;
+        entry.reapTimer = setTimeout(() => {
+            void destroyRoom(documentId);
+        }, idleTimeoutMs);
+    }
+    async function destroyRoom(documentId) {
+        const entry = rooms.get(documentId);
+        if (!entry)
+            return;
+        rooms.delete(documentId);
+        if (entry.reapTimer) {
+            clearTimeout(entry.reapTimer);
+            entry.reapTimer = null;
+        }
+        try {
+            await entry.binding.flush();
+        }
+        catch (err) {
+            onError(documentId, err);
+        }
+        entry.binding.unbind();
+        entry.room.destroy();
+        opts.onRoomClose?.(documentId);
+    }
+    async function handleConnection(socket, req) {
+        if (shuttingDown) {
+            try {
+                socket.close(1001, 'server shutting down');
+            }
+            catch {
+                /* ignore */
+            }
+            return;
+        }
+        let auth;
+        try {
+            auth = await opts.authenticate(req);
+        }
+        catch {
+            auth = null;
+        }
+        if (!auth) {
+            try {
+                socket.close(4401, 'unauthorized');
+            }
+            catch {
+                /* ignore */
+            }
+            return;
+        }
+        const entry = await getOrCreateRoom(auth.documentId);
+        if (entry.reapTimer) {
+            clearTimeout(entry.reapTimer);
+            entry.reapTimer = null;
+        }
+        const conn = {
+            id: auth.connectionId,
+            send: (bytes) => {
+                try {
+                    socket.send(bytes);
+                }
+                catch {
+                    /* surfaced via close handler */
+                }
+            },
+            close: (reason) => {
+                try {
+                    socket.close(1000, reason ?? 'closed');
+                }
+                catch {
+                    /* ignore */
+                }
+            },
+        };
+        try {
+            entry.room.addConnection(conn);
+        }
+        catch {
+            // duplicate connection id — close and bail out.
+            try {
+                socket.close(4409, 'duplicate connection id');
+            }
+            catch {
+                /* ignore */
+            }
+            return;
+        }
+        entry.connections += 1;
+        connectionCount += 1;
+        socket.on('message', (data) => {
+            try {
+                entry.room.handleMessage(auth.connectionId, data);
+            }
+            catch {
+                // Malformed frame — close the offending peer; other connections continue.
+                try {
+                    socket.close(1003, 'malformed frame');
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        });
+        socket.on('error', () => {
+            try {
+                socket.close(1011, 'socket error');
+            }
+            catch {
+                /* ignore */
+            }
+        });
+        socket.on('close', () => {
+            entry.room.removeConnection(auth.connectionId);
+            entry.connections = Math.max(0, entry.connections - 1);
+            connectionCount = Math.max(0, connectionCount - 1);
+            if (entry.connections === 0) {
+                scheduleReap(auth.documentId);
+            }
+        });
+    }
+    async function shutdown() {
+        shuttingDown = true;
+        const docIds = Array.from(rooms.keys());
+        await Promise.all(docIds.map((id) => destroyRoom(id)));
+        connectionCount = 0;
+    }
+    return {
+        get roomCount() {
+            return rooms.size;
+        },
+        get connectionCount() {
+            return connectionCount;
+        },
+        handleConnection,
+        shutdown,
+    };
+}
+/** Persistence that swallows writes — used when consumers don't pass one. */
+function createNoopPersistence() {
+    return {
+        async load() {
+            return null;
+        },
+        async save() {
+            /* discard */
+        },
+    };
+}
+//# sourceMappingURL=gateway.js.map

package/dist/realtime/gateway.js.map

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

package/dist/realtime/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Realtime collaboration surface for `@actuate-media/cms-core`.
+ *
+ * - `createRealtimeGateway` — transport-agnostic gateway that owns rooms,
+ *   debounces persistence, and reaps idle documents. Consumers wrap their
+ *   server's socket primitive in a `WebSocketLike` adapter and feed it via
+ *   `gateway.handleConnection(socket, req)`.
+ * - `createPrismaDocumentPersistence` — Prisma-backed implementation of
+ *   `DocumentPersistence` against the `DocumentCRDT` table.
+ *
+ * See `packages/realtime/README.md` for the protocol details and
+ * `docs/roadmap-status.md` for the Phase 3 slice plan.
+ */
+export { createRealtimeGateway, type AttachRealtimeGatewayOptions, type AuthenticatedConnection, type RealtimeGateway, type UpgradeRequestInfo, type WebSocketLike, } from './gateway.js';
+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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/realtime/index.js

@@ -0,0 +1,18 @@
+/**
+ * Realtime collaboration surface for `@actuate-media/cms-core`.
+ *
+ * - `createRealtimeGateway` — transport-agnostic gateway that owns rooms,
+ *   debounces persistence, and reaps idle documents. Consumers wrap their
+ *   server's socket primitive in a `WebSocketLike` adapter and feed it via
+ *   `gateway.handleConnection(socket, req)`.
+ * - `createPrismaDocumentPersistence` — Prisma-backed implementation of
+ *   `DocumentPersistence` against the `DocumentCRDT` table.
+ *
+ * See `packages/realtime/README.md` for the protocol details and
+ * `docs/roadmap-status.md` for the Phase 3 slice plan.
+ */
+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';
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +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"}

package/dist/realtime/notifications.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Per-user notifications driven by collaboration events.
+ *
+ * Owns the pure notification logic: kind discriminator, payload validation,
+ * permission gates, and a storage-agnostic CRUD surface. The HTTP layer
+ * (in `api/handlers.ts`) is a thin wrapper that handles auth + JSON
+ * envelope; the comments hook layer (slice 6, `notification-triggers.ts`)
+ * calls these helpers when a comment lifecycle event fires.
+ *
+ * Storage shape — see `packages/cms-core/prisma/cms-schema.prisma`, model
+ * `DocumentNotification`. We require only a minimal Prisma surface so the
+ * helpers can be tested against an in-memory fake.
+ *
+ * ## Discriminated payloads
+ *
+ * The `payload` Json column varies by `kind`. The TypeScript types here
+ * are the source of truth for each variant; the service helpers narrow
+ * by `kind` so callers can't accidentally insert a malformed payload.
+ *
+ * ## Mentions
+ *
+ * Slice 6 ships a deliberately simple mention parser: `@<userId>` tokens
+ * in a comment body trigger a `comment_mention` notification. A richer
+ * `@username` parser that resolves against the user table is a Phase 4
+ * follow-up — the storage shape already supports it.
+ */
+/** Hard cap on returned notifications per `listForUser` call. */
+export declare const MAX_NOTIFICATION_LIST_PAGE_SIZE = 200;
+/** Default page size when the caller does not request one. */
+export declare const DEFAULT_NOTIFICATION_LIST_PAGE_SIZE = 50;
+/**
+ * Notification kind discriminator. New variants extend the `Payload`
+ * union — never replace existing kinds, because old rows live forever
+ * in the table.
+ */
+export type NotificationKind = 'comment_reply' | 'comment_resolved' | 'comment_mention';
+export interface CommentReplyPayload {
+    /** User who replied. */
+    actorId: string | null;
+    actorName: string | null;
+    /** First 120 chars of the reply body, for the bell preview. */
+    excerpt: string;
+}
+export interface CommentResolvedPayload {
+    actorId: string | null;
+    actorName: string | null;
+    /** Excerpt of the resolved root comment, so the bell can show context. */
+    rootExcerpt: string;
+}
+export interface CommentMentionPayload {
+    actorId: string | null;
+    actorName: string | null;
+    /** Excerpt of the body that mentioned the recipient. */
+    excerpt: string;
+}
+export type NotificationPayload = ({
+    kind: 'comment_reply';
+} & CommentReplyPayload) | ({
+    kind: 'comment_resolved';
+} & CommentResolvedPayload) | ({
+    kind: 'comment_mention';
+} & CommentMentionPayload);
+/** Public REST shape. Mirrors the row plus the discriminated payload. */
+export interface NotificationDTO {
+    id: string;
+    userId: string;
+    kind: NotificationKind;
+    documentId: string | null;
+    commentId: string | null;
+    payload: NotificationPayload;
+    readAt: string | null;
+    createdAt: string;
+}
+export interface CreateNotificationInput {
+    userId: string;
+    documentId?: string | null;
+    commentId?: string | null;
+    payload: NotificationPayload;
+}
+export interface ListNotificationsFilter {
+    userId: string;
+    /** Default: false. When true, returns read + unread notifications. */
+    includeRead?: boolean;
+    /** Default: DEFAULT_NOTIFICATION_LIST_PAGE_SIZE. Hard upper bound applied. */
+    pageSize?: number;
+}
+export type NotificationsError = {
+    code: 'validation';
+    message: string;
+} | {
+    code: 'forbidden';
+    message: string;
+} | {
+    code: 'not_found';
+    message: string;
+};
+export type NotificationsResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: NotificationsError;
+};
+/**
+ * Minimal subset of Prisma's notification delegate we depend on. Keeping
+ * this narrow lets the unit tests use a fake implementation that holds
+ * rows in an array — no schema generation required.
+ */
+export interface DocumentNotificationRow {
+    id: string;
+    userId: string;
+    kind: string;
+    documentId: string | null;
+    commentId: string | null;
+    payload: unknown;
+    readAt: Date | null;
+    createdAt: Date;
+}
+export interface NotificationsDB {
+    documentNotification: {
+        create(args: {
+            data: Omit<DocumentNotificationRow, 'id' | 'createdAt' | 'readAt'> & {
+                readAt?: Date | null;
+            };
+        }): Promise<DocumentNotificationRow>;
+        findUnique(args: {
+            where: {
+                id: string;
+            };
+        }): Promise<DocumentNotificationRow | null>;
+        findMany(args: {
+            where: {
+                userId: string;
+                readAt?: null | {
+                    not: null;
+                };
+            };
+            orderBy?: {
+                createdAt: 'desc' | 'asc';
+            };
+            take?: number;
+        }): Promise<DocumentNotificationRow[]>;
+        update(args: {
+            where: {
+                id: string;
+            };
+            data: {
+                readAt?: Date | null;
+            };
+        }): Promise<DocumentNotificationRow>;
+        updateMany(args: {
+            where: {
+                userId: string;
+                readAt?: null;
+            };
+            data: {
+                readAt: Date;
+            };
+        }): Promise<{
+            count: number;
+        }>;
+        count(args: {
+            where: {
+                userId: string;
+                readAt: null;
+            };
+        }): Promise<number>;
+    };
+}
+export declare function toNotificationDTO(row: DocumentNotificationRow): NotificationDTO;
+export declare function isNotificationKind(value: unknown): value is NotificationKind;
+/**
+ * Insert a new notification. The payload's `kind` field is the source
+ * of truth; `kind` on the DB row is derived from it so callers can't
+ * drift them apart.
+ */
+export declare function createNotification(db: NotificationsDB, input: CreateNotificationInput): Promise<NotificationsResult<NotificationDTO>>;
+/**
+ * List notifications for a user, newest first. By default returns only
+ * unread; pass `includeRead: true` for the full feed (the bell dropdown
+ * uses both depending on the tab the user is on).
+ */
+export declare function listForUser(db: NotificationsDB, filter: ListNotificationsFilter): Promise<NotificationsResult<NotificationDTO[]>>;
+/** Count unread notifications for the bell badge. */
+export declare function unreadCount(db: NotificationsDB, userId: string): Promise<NotificationsResult<number>>;
+/** Mark a single notification read (idempotent). */
+export declare function markRead(db: NotificationsDB, id: string, actor: {
+    userId: string;
+}): Promise<NotificationsResult<NotificationDTO>>;
+/** Mark every unread notification for the user as read. */
+export declare function markAllRead(db: NotificationsDB, userId: string): Promise<NotificationsResult<{
+    count: number;
+}>>;
+/**
+ * Cheap excerpt builder for notification payloads. Markdown is kept as-is;
+ * we just trim whitespace and clip to 120 chars so the bell can render
+ * a single-line preview.
+ */
+export declare function excerptForNotification(body: string, max?: number): string;
+/**
+ * Extract `@<userId>` mentions from a comment body. We intentionally
+ * match the *user id* form here (`@user_abc123`) — a slice-7 follow-up
+ * can wire up `@username` resolution against the User table.
+ *
+ * Returns a deduplicated array of mentioned user ids; the caller filters
+ * out the actor before issuing notifications.
+ */
+export declare function extractMentionedUserIds(body: string): string[];
+//# sourceMappingURL=notifications.d.ts.map

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

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