@actuate-media/cms-core 0.20.0 → 0.22.0

package/dist/realtime/comments.js

@@ -0,0 +1,282 @@
+/**
+ * Document comments — anchored, threaded discussion attached to documents.
+ *
+ * This module owns the *pure* comment logic: validation, normalization, and
+ * the storage-agnostic CRUD entry points. The HTTP layer in `api/handlers.ts`
+ * is a thin wrapper that handles auth + JSON envelope; everything else lives
+ * here so the unit tests don't need a Request loop.
+ *
+ * Storage shape — see `packages/cms-core/prisma/cms-schema.prisma`,
+ * model `DocumentComment`. We require only a minimal Prisma surface so the
+ * helpers can be tested against an in-memory fake.
+ *
+ * Anchors are Yjs *relative positions* serialised as Base64. Storing them in
+ * a JSON column (rather than Bytes) keeps the REST contract trivial: the
+ * client posts `{ from: "AQ...", to: "AQ..." }`, we round-trip the strings.
+ * Slice 5 reconstitutes them with `Y.createAbsolutePositionFromRelativePosition`
+ * to paint anchored highlights in the editor; nothing in the API layer needs
+ * to interpret the bytes.
+ */
+/** Maximum length we accept for a comment body (markdown source). */
+export const MAX_COMMENT_BODY_LENGTH = 10_000;
+/** Cap on returned comments per `listComments` call. */
+export const MAX_COMMENT_LIST_PAGE_SIZE = 200;
+/** Default page size when the caller does not request one. */
+export const DEFAULT_COMMENT_LIST_PAGE_SIZE = 100;
+const MAX_ANCHOR_FIELD_LENGTH = 4_096;
+function err(code, message) {
+    return { code, message };
+}
+function toIso(value) {
+    if (value === null)
+        return null;
+    if (value instanceof Date)
+        return value.toISOString();
+    // Tolerate fakes that already store ISO strings.
+    return value;
+}
+function toIsoRequired(value) {
+    return value instanceof Date ? value.toISOString() : value;
+}
+/**
+ * Strip a comment row down to the public DTO. Centralised so the response
+ * shape stays consistent between create / list / update / resolve.
+ */
+export function toCommentDTO(row) {
+    return {
+        id: row.id,
+        documentId: row.documentId,
+        parentId: row.parentId,
+        userId: row.userId,
+        body: row.body,
+        anchor: row.anchor,
+        resolvedAt: toIso(row.resolvedAt),
+        resolvedById: row.resolvedById,
+        deletedAt: toIso(row.deletedAt),
+        createdAt: toIsoRequired(row.createdAt),
+        updatedAt: toIsoRequired(row.updatedAt),
+        isResolved: row.resolvedAt !== null,
+    };
+}
+/**
+ * Parse + validate an anchor blob coming from an untrusted client. Returns
+ * `null` when the caller did not provide one (document-level comments).
+ */
+export function parseAnchor(input) {
+    if (input === undefined || input === null) {
+        return { ok: true, value: null };
+    }
+    if (typeof input !== 'object' || Array.isArray(input)) {
+        return { ok: false, error: err('validation', 'anchor must be an object with `from` and `to`') };
+    }
+    const obj = input;
+    if (typeof obj.from !== 'string' || typeof obj.to !== 'string') {
+        return { ok: false, error: err('validation', 'anchor.from and anchor.to must be strings') };
+    }
+    if (obj.from.length === 0 ||
+        obj.from.length > MAX_ANCHOR_FIELD_LENGTH ||
+        obj.to.length === 0 ||
+        obj.to.length > MAX_ANCHOR_FIELD_LENGTH) {
+        return {
+            ok: false,
+            error: err('validation', `anchor fields must be 1..${MAX_ANCHOR_FIELD_LENGTH} chars`),
+        };
+    }
+    return { ok: true, value: { from: obj.from, to: obj.to } };
+}
+/** Normalize whitespace + enforce length limits on a posted body. */
+export function normaliseBody(input) {
+    if (typeof input !== 'string') {
+        return { ok: false, error: err('validation', 'body must be a string') };
+    }
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        return { ok: false, error: err('validation', 'body cannot be empty') };
+    }
+    if (trimmed.length > MAX_COMMENT_BODY_LENGTH) {
+        return {
+            ok: false,
+            error: err('validation', `body cannot exceed ${MAX_COMMENT_BODY_LENGTH} characters`),
+        };
+    }
+    return { ok: true, value: trimmed };
+}
+/**
+ * Create a comment. Enforces:
+ *   - body validation (non-empty, length-capped)
+ *   - anchor shape validation
+ *   - single-level threading: a `parentId` must reference an existing,
+ *     non-deleted, non-reply comment under the same document.
+ *
+ * The caller (HTTP handler) is responsible for auth — once we reach here we
+ * trust the supplied `userId`.
+ */
+export async function createComment(db, input) {
+    if (typeof input.documentId !== 'string' || input.documentId.length === 0) {
+        return { ok: false, error: err('validation', 'documentId is required') };
+    }
+    if (typeof input.userId !== 'string' || input.userId.length === 0) {
+        return { ok: false, error: err('validation', 'userId is required') };
+    }
+    const body = normaliseBody(input.body);
+    if (!body.ok)
+        return body;
+    const anchor = parseAnchor(input.anchor);
+    if (!anchor.ok)
+        return anchor;
+    let parentId = null;
+    if (input.parentId != null && input.parentId !== '') {
+        if (typeof input.parentId !== 'string') {
+            return { ok: false, error: err('validation', 'parentId must be a string') };
+        }
+        const parent = await db.documentComment.findUnique({ where: { id: input.parentId } });
+        if (!parent) {
+            return { ok: false, error: err('not_found', 'parent comment not found') };
+        }
+        if (parent.documentId !== input.documentId) {
+            return { ok: false, error: err('validation', 'parent comment is on a different document') };
+        }
+        if (parent.parentId !== null) {
+            return {
+                ok: false,
+                error: err('validation', 'replies cannot themselves be replied to (one level only)'),
+            };
+        }
+        if (parent.deletedAt !== null) {
+            return { ok: false, error: err('not_found', 'parent comment has been deleted') };
+        }
+        parentId = parent.id;
+    }
+    const row = await db.documentComment.create({
+        data: {
+            documentId: input.documentId,
+            userId: input.userId,
+            body: body.value,
+            anchor: anchor.value,
+            parentId,
+        },
+    });
+    return { ok: true, value: toCommentDTO(row) };
+}
+/**
+ * List comments for a document. Returns the rows ordered oldest-first so a
+ * naive client can render threads top-down. Pagination is "show the first
+ * N"; the higher-level UI in slice 5 will switch to cursor pagination once
+ * volume justifies it.
+ */
+export async function listComments(db, filter) {
+    if (typeof filter.documentId !== 'string' || filter.documentId.length === 0) {
+        return { ok: false, error: err('validation', 'documentId is required') };
+    }
+    const where = { documentId: filter.documentId };
+    if (!filter.includeResolved)
+        where.resolvedAt = null;
+    if (!filter.includeDeleted)
+        where.deletedAt = null;
+    const pageSize = clampPageSize(filter.pageSize);
+    const rows = await db.documentComment.findMany({
+        where,
+        orderBy: { createdAt: 'asc' },
+        take: pageSize,
+    });
+    return { ok: true, value: rows.map(toCommentDTO) };
+}
+function clampPageSize(n) {
+    if (n === undefined || Number.isNaN(n))
+        return DEFAULT_COMMENT_LIST_PAGE_SIZE;
+    if (n < 1)
+        return 1;
+    if (n > MAX_COMMENT_LIST_PAGE_SIZE)
+        return MAX_COMMENT_LIST_PAGE_SIZE;
+    return Math.floor(n);
+}
+/**
+ * Edit a comment body. Only the author can edit, and only if the comment is
+ * not soft-deleted. Resolved threads remain editable so a moderator can
+ * append context.
+ */
+export async function updateComment(db, id, input, actor) {
+    const existing = await db.documentComment.findUnique({ where: { id } });
+    if (!existing || existing.deletedAt !== null) {
+        return { ok: false, error: err('not_found', 'comment not found') };
+    }
+    if (!actor.isAdmin && existing.userId !== actor.userId) {
+        return { ok: false, error: err('forbidden', 'only the author can edit this comment') };
+    }
+    const body = normaliseBody(input.body);
+    if (!body.ok)
+        return body;
+    const row = await db.documentComment.update({
+        where: { id },
+        data: { body: body.value },
+    });
+    return { ok: true, value: toCommentDTO(row) };
+}
+/**
+ * Mark a comment thread as resolved. Either the comment's author or any
+ * admin / write-role caller can resolve. Resolving an already-resolved
+ * comment is a no-op (returns the existing row) so a duplicate click in the
+ * UI does not surface as an error.
+ */
+export async function resolveComment(db, id, actor) {
+    const existing = await db.documentComment.findUnique({ where: { id } });
+    if (!existing || existing.deletedAt !== null) {
+        return { ok: false, error: err('not_found', 'comment not found') };
+    }
+    if (!actor.canResolve && existing.userId !== actor.userId) {
+        return { ok: false, error: err('forbidden', 'not allowed to resolve this comment') };
+    }
+    if (existing.resolvedAt !== null) {
+        return { ok: true, value: toCommentDTO(existing) };
+    }
+    const row = await db.documentComment.update({
+        where: { id },
+        data: { resolvedAt: new Date(), resolvedById: actor.userId },
+    });
+    return { ok: true, value: toCommentDTO(row) };
+}
+/**
+ * Re-open a resolved thread. Same permission as `resolveComment`.
+ */
+export async function reopenComment(db, id, actor) {
+    const existing = await db.documentComment.findUnique({ where: { id } });
+    if (!existing || existing.deletedAt !== null) {
+        return { ok: false, error: err('not_found', 'comment not found') };
+    }
+    if (!actor.canResolve && existing.userId !== actor.userId) {
+        return { ok: false, error: err('forbidden', 'not allowed to re-open this comment') };
+    }
+    if (existing.resolvedAt === null) {
+        return { ok: true, value: toCommentDTO(existing) };
+    }
+    const row = await db.documentComment.update({
+        where: { id },
+        data: { resolvedAt: null, resolvedById: null },
+    });
+    return { ok: true, value: toCommentDTO(row) };
+}
+/**
+ * Soft-delete a comment. The row is preserved (so replies don't lose their
+ * thread root) but stops being returned by `listComments` unless explicitly
+ * requested with `includeDeleted: true`.
+ *
+ * Only the author or an admin may delete.
+ */
+export async function deleteComment(db, id, actor) {
+    const existing = await db.documentComment.findUnique({ where: { id } });
+    if (!existing) {
+        return { ok: false, error: err('not_found', 'comment not found') };
+    }
+    if (!actor.isAdmin && existing.userId !== actor.userId) {
+        return { ok: false, error: err('forbidden', 'only the author can delete this comment') };
+    }
+    if (existing.deletedAt !== null) {
+        return { ok: true, value: toCommentDTO(existing) };
+    }
+    const row = await db.documentComment.update({
+        where: { id },
+        data: { deletedAt: new Date() },
+    });
+    return { ok: true, value: toCommentDTO(row) };
+}
+//# sourceMappingURL=comments.js.map

package/dist/realtime/comments.js.map

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

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"}