@actuate-media/cms-core 0.20.0 → 0.22.0

package/dist/index.js

@@ -16,6 +16,7 @@ export { dispatch as dispatchWebhook, createEndpoint as createWebhookEndpoint, l
 export { buildLocaleFilter, buildLocaleFallbackQuery, getLocales, resolveLocale, } from './i18n/index.js';
 // Cache
 export { cached, revalidateTag, buildCacheKey, getDocumentCacheTags } from './cache/index.js';
+export { ACTUATE_TAG_ROOT, actuateTag, invalidationTagsForDocumentWrite, invalidationTagsForGlobalWrite, publicReadCacheControl, } from './cache/http.js';
 // Content
 export { extractPlainText, extractExcerpt, hashContent, registerSchemaType, getSchemaType, generateJsonLd, renderJsonLdScript, buildContentGraph, serializeGraph, findIncomingReferences, handleContentApiRequest, sanitizeForPublicApi, } from './content/index.js';
 // Codegen
@@ -50,6 +51,7 @@ export { advanceWorkflow, rejectWorkflowStep, getWorkflowState } from './workflo
 export { canTransition, getAvailableTransitions, transitionDocument } from './workflow/index.js';
 // Presence
 export { createSSEPresenceAdapter } from './presence/index.js';
+export { createPrismaDocumentPersistence, createRealtimeGateway } from './realtime/index.js';
 // Scheduling
 export { getScheduleCalendar, processScheduledPublish, processScheduledUnpublish, schedulingCronHandler, } from './scheduling/index.js';
 // Templates

package/dist/index.js.map

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

package/dist/page-builder/schema.d.ts

@@ -26,8 +26,8 @@ export declare const blockNodeSchema: z.ZodObject<{
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     type: "block";
-    data: Record<string, unknown>;
     id: string;
+    data: Record<string, unknown>;
     settings: {
         blockType: string;
         variant?: string | undefined;
@@ -40,8 +40,8 @@ export declare const blockNodeSchema: z.ZodObject<{
     } | undefined;
 }, {
     type: "block";
-    data: Record<string, unknown>;
     id: string;
+    data: Record<string, unknown>;
     settings: {
         blockType: string;
         variant?: string | undefined;

package/dist/preview/event-bus.d.ts

@@ -0,0 +1,39 @@
+/**
+ * In-process pub/sub for live-preview update events.
+ *
+ * The admin emits `notifyPreviewUpdate(collection, id, payload)` whenever a
+ * draft document changes (today: the `PUT /collections/:slug/:id` route).
+ * Active SSE streams subscribe via `subscribePreviewUpdates(collection, id, listener)`
+ * and forward every payload through to their connected `EventSource`
+ * clients.
+ *
+ * The bus is intentionally single-instance and in-memory:
+ *
+ *   - Self-hosted single-node deployments get push-to-iframe updates
+ *     "for free" with zero extra infrastructure.
+ *   - Multi-node deployments will see each node deliver only its own
+ *     update events — fine for the Phase 2 finish-line. A future Slice
+ *     can swap this for a Redis/postgres-listen backed bus without
+ *     changing the public contract (`notifyPreviewUpdate` /
+ *     `subscribePreviewUpdates`).
+ *
+ * The bus is keyed by `${collection}:${documentId}` so two simultaneously
+ * open previews for different docs don't see each other's traffic.
+ */
+export interface PreviewUpdateEvent {
+    collection: string;
+    documentId: string;
+    /** Free-form payload — the SSE handler stringifies it as the event data. */
+    payload: Record<string, unknown>;
+    /** Server-side emission timestamp; useful for clients to detect skew. */
+    at: number;
+}
+export type PreviewUpdateListener = (event: PreviewUpdateEvent) => void;
+export declare function subscribePreviewUpdates(collection: string, documentId: string, listener: PreviewUpdateListener): () => void;
+export declare function notifyPreviewUpdate(collection: string, documentId: string, payload: Record<string, unknown>): void;
+export declare function previewSubscriberCount(collection: string, documentId: string): number;
+/**
+ * Test helper. Drops every subscription. Production code never calls this.
+ */
+export declare function __resetPreviewEventBus(): void;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/preview/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/preview/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAA;AAQvE,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CAcZ;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAiBN;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/preview/event-bus.js

@@ -0,0 +1,73 @@
+/**
+ * In-process pub/sub for live-preview update events.
+ *
+ * The admin emits `notifyPreviewUpdate(collection, id, payload)` whenever a
+ * draft document changes (today: the `PUT /collections/:slug/:id` route).
+ * Active SSE streams subscribe via `subscribePreviewUpdates(collection, id, listener)`
+ * and forward every payload through to their connected `EventSource`
+ * clients.
+ *
+ * The bus is intentionally single-instance and in-memory:
+ *
+ *   - Self-hosted single-node deployments get push-to-iframe updates
+ *     "for free" with zero extra infrastructure.
+ *   - Multi-node deployments will see each node deliver only its own
+ *     update events — fine for the Phase 2 finish-line. A future Slice
+ *     can swap this for a Redis/postgres-listen backed bus without
+ *     changing the public contract (`notifyPreviewUpdate` /
+ *     `subscribePreviewUpdates`).
+ *
+ * The bus is keyed by `${collection}:${documentId}` so two simultaneously
+ * open previews for different docs don't see each other's traffic.
+ */
+const listenersByKey = new Map();
+function keyOf(collection, documentId) {
+    return `${collection}:${documentId}`;
+}
+export function subscribePreviewUpdates(collection, documentId, listener) {
+    const key = keyOf(collection, documentId);
+    let set = listenersByKey.get(key);
+    if (!set) {
+        set = new Set();
+        listenersByKey.set(key, set);
+    }
+    set.add(listener);
+    return () => {
+        const current = listenersByKey.get(key);
+        if (!current)
+            return;
+        current.delete(listener);
+        if (current.size === 0)
+            listenersByKey.delete(key);
+    };
+}
+export function notifyPreviewUpdate(collection, documentId, payload) {
+    const set = listenersByKey.get(keyOf(collection, documentId));
+    if (!set || set.size === 0)
+        return;
+    const event = {
+        collection,
+        documentId,
+        payload,
+        at: Date.now(),
+    };
+    for (const listener of [...set]) {
+        try {
+            listener(event);
+        }
+        catch {
+            // listener throws are isolated — one buggy stream must not take down
+            // every other subscriber for the same doc.
+        }
+    }
+}
+export function previewSubscriberCount(collection, documentId) {
+    return listenersByKey.get(keyOf(collection, documentId))?.size ?? 0;
+}
+/**
+ * Test helper. Drops every subscription. Production code never calls this.
+ */
+export function __resetPreviewEventBus() {
+    listenersByKey.clear();
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/preview/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/preview/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAaH,MAAM,cAAc,GAAG,IAAI,GAAG,EAAsC,CAAA;AAEpE,SAAS,KAAK,CAAC,UAAkB,EAAE,UAAkB;IACnD,OAAO,GAAG,UAAU,IAAI,UAAU,EAAE,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,UAAkB,EAClB,QAA+B;IAE/B,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;IACzC,IAAI,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;QACf,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC9B,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,GAAG,EAAE;QACV,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACxB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACpD,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,UAAkB,EAClB,OAAgC;IAEhC,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAA;IAC7D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;QAAE,OAAM;IAClC,MAAM,KAAK,GAAuB;QAChC,UAAU;QACV,UAAU;QACV,OAAO;QACP,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;KACf,CAAA;IACD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,CAAC,CAAA;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,2CAA2C;QAC7C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,UAAkB;IAC3E,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAA;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,cAAc,CAAC,KAAK,EAAE,CAAA;AACxB,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { PreviewSession } from './index.js';
+/**
+ * Default keepalive 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).
+ */
+export declare const PREVIEW_SSE_HEARTBEAT_MS = 25000;
+/**
+ * Maximum stream lifetime in ms. After this, the server closes the stream
+ * cleanly so EventSource will reconnect — important because some platforms
+ * (Vercel Fluid Compute, Cloudflare Workers) cap any single response at a
+ * few minutes regardless of activity.
+ */
+export declare const PREVIEW_SSE_MAX_LIFETIME_MS: number;
+export interface PreviewStreamOptions {
+    /** 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;
+}
+/**
+ * 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:
+ *
+ *   1. Emits an `event: ready` frame with the session's collection/id.
+ *      Lets the client confirm the server-side subscription is wired up
+ *      before it starts treating the absence of events as "stale".
+ *   2. Forwards every `notifyPreviewUpdate(collection, id, payload)` to
+ *      the client as `event: update` with `payload` as JSON data.
+ *   3. Sends `: heartbeat\n\n` keepalive comments on
+ *      `PREVIEW_SSE_HEARTBEAT_MS` intervals.
+ *   4. Cleanly closes after `PREVIEW_SSE_MAX_LIFETIME_MS` and lets the
+ *      browser reconnect, sidestepping platform idle/max-duration caps.
+ *
+ * The returned stream MUST be wrapped in a `Response` with the SSE
+ * headers — `createPreviewStreamResponse` does this for typical callers.
+ */
+export declare function createPreviewStream(session: Pick<PreviewSession, 'collection' | 'documentId'>, opts?: PreviewStreamOptions): ReadableStream<Uint8Array>;
+/**
+ * Standard SSE response headers. Exposed for callers (and tests) that want
+ * to wrap the stream themselves.
+ */
+export declare const PREVIEW_SSE_HEADERS: Record<string, string>;
+export declare function createPreviewStreamResponse(session: Pick<PreviewSession, 'collection' | 'documentId'>, opts?: PreviewStreamOptions): Response;
+//# sourceMappingURL=sse-stream.d.ts.map

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

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

package/dist/preview/sse-stream.js

@@ -0,0 +1,120 @@
+import { subscribePreviewUpdates } from './event-bus.js';
+/**
+ * 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).
+ */
+const encoder = new TextEncoder();
+/**
+ * Default keepalive 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).
+ */
+export const PREVIEW_SSE_HEARTBEAT_MS = 25_000;
+/**
+ * Maximum stream lifetime in ms. After this, the server closes the stream
+ * cleanly so EventSource will reconnect — important because some platforms
+ * (Vercel Fluid Compute, Cloudflare Workers) cap any single response at a
+ * 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:
+ *
+ *   1. Emits an `event: ready` frame with the session's collection/id.
+ *      Lets the client confirm the server-side subscription is wired up
+ *      before it starts treating the absence of events as "stale".
+ *   2. Forwards every `notifyPreviewUpdate(collection, id, payload)` to
+ *      the client as `event: update` with `payload` as JSON data.
+ *   3. Sends `: heartbeat\n\n` keepalive comments on
+ *      `PREVIEW_SSE_HEARTBEAT_MS` intervals.
+ *   4. Cleanly closes after `PREVIEW_SSE_MAX_LIFETIME_MS` and lets the
+ *      browser reconnect, sidestepping platform idle/max-duration caps.
+ *
+ * The returned stream MUST be wrapped in a `Response` with the SSE
+ * headers — `createPreviewStreamResponse` does this for typical callers.
+ */
+export function createPreviewStream(session, opts = {}) {
+    const heartbeatMs = opts.heartbeatMs ?? PREVIEW_SSE_HEARTBEAT_MS;
+    const maxLifetimeMs = opts.maxLifetimeMs ?? PREVIEW_SSE_MAX_LIFETIME_MS;
+    let heartbeat;
+    let lifetime;
+    let 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 `notifyPreviewUpdate` call and the enqueue. Swallow.
+                }
+            };
+            enqueue(encodeSseEvent({ collection: session.collection, documentId: session.documentId }, 'ready'));
+            unsubscribe = subscribePreviewUpdates(session.collection, session.documentId, (event) => {
+                enqueue(encodeSseEvent({
+                    collection: event.collection,
+                    documentId: event.documentId,
+                    at: event.at,
+                    ...event.payload,
+                }, 'update'));
+            });
+            heartbeat = setInterval(() => {
+                enqueue(`: heartbeat\n\n`);
+            }, heartbeatMs);
+            lifetime = setTimeout(() => {
+                try {
+                    controller.close();
+                }
+                catch {
+                    // Already closed; nothing to do.
+                }
+            }, maxLifetimeMs);
+        },
+        cancel() {
+            if (heartbeat)
+                clearInterval(heartbeat);
+            if (lifetime)
+                clearTimeout(lifetime);
+            if (unsubscribe)
+                unsubscribe();
+        },
+    });
+}
+/**
+ * Standard SSE response headers. Exposed for callers (and tests) that want
+ * to wrap the stream themselves.
+ */
+export const PREVIEW_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 createPreviewStreamResponse(session, opts) {
+    return new Response(createPreviewStream(session, opts), {
+        status: 200,
+        headers: PREVIEW_SSE_HEADERS,
+    });
+}
+//# sourceMappingURL=sse-stream.js.map

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

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

package/dist/realtime/comments.d.ts

@@ -0,0 +1,217 @@
+/**
+ * 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 declare const MAX_COMMENT_BODY_LENGTH = 10000;
+/** Cap on returned comments per `listComments` call. */
+export declare const MAX_COMMENT_LIST_PAGE_SIZE = 200;
+/** Default page size when the caller does not request one. */
+export declare const DEFAULT_COMMENT_LIST_PAGE_SIZE = 100;
+/**
+ * Yjs relative-position anchor. The two ends are Base64-encoded
+ * `Y.encodeRelativePosition` bytes; slice 5 turns them back into absolute
+ * positions for rendering.
+ *
+ * Slice 4 (this module) treats the anchor as opaque: we only validate that
+ * each side is a reasonably short string so we don't store arbitrary blobs.
+ */
+export interface CommentAnchor {
+    from: string;
+    to: string;
+}
+/**
+ * Public REST shape of a comment. Mirrors the Prisma row plus a derived
+ * `isResolved` flag so the client doesn't have to repeat the null check.
+ */
+export interface CommentDTO {
+    id: string;
+    documentId: string;
+    parentId: string | null;
+    userId: string | null;
+    body: string;
+    anchor: CommentAnchor | null;
+    resolvedAt: string | null;
+    resolvedById: string | null;
+    deletedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    isResolved: boolean;
+}
+/** Input for creating a new comment. */
+export interface CreateCommentInput {
+    documentId: string;
+    userId: string;
+    body: string;
+    anchor?: CommentAnchor | null;
+    parentId?: string | null;
+}
+/** Input for updating an existing comment. Only the body is editable. */
+export interface UpdateCommentInput {
+    body: string;
+}
+/** Filter passed to `listComments`. */
+export interface ListCommentsFilter {
+    documentId: string;
+    /** Include resolved threads. Default: `false`. */
+    includeResolved?: boolean;
+    /** Include soft-deleted comments. Default: `false`. */
+    includeDeleted?: boolean;
+    /** Page size (1..`MAX_COMMENT_LIST_PAGE_SIZE`). */
+    pageSize?: number;
+}
+/**
+ * Minimal Prisma surface we depend on. The real `PrismaClient` satisfies it,
+ * but tests inject a small in-memory fake.
+ */
+export interface CommentsDB {
+    documentComment: {
+        findUnique: (args: {
+            where: {
+                id: string;
+            };
+            [key: string]: unknown;
+        }) => Promise<DocumentCommentRow | null>;
+        findMany: (args: {
+            where: Record<string, unknown>;
+            orderBy?: Record<string, 'asc' | 'desc'>;
+            take?: number;
+        }) => Promise<DocumentCommentRow[]>;
+        create: (args: {
+            data: {
+                documentId: string;
+                userId: string | null;
+                body: string;
+                anchor: CommentAnchor | null;
+                parentId: string | null;
+            };
+        }) => Promise<DocumentCommentRow>;
+        update: (args: {
+            where: {
+                id: string;
+            };
+            data: Partial<{
+                body: string;
+                resolvedAt: Date | null;
+                resolvedById: string | null;
+                deletedAt: Date | null;
+            }>;
+        }) => Promise<DocumentCommentRow>;
+    };
+}
+/** Row shape returned by Prisma. We accept Date or ISO strings so fakes are cheap. */
+export interface DocumentCommentRow {
+    id: string;
+    documentId: string;
+    parentId: string | null;
+    userId: string | null;
+    body: string;
+    anchor: CommentAnchor | null;
+    resolvedAt: Date | string | null;
+    resolvedById: string | null;
+    deletedAt: Date | string | null;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+}
+/** Discriminated result type used by the service entry points. */
+export type CommentsResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: CommentsError;
+};
+export interface CommentsError {
+    /**
+     * Stable machine-readable code. The HTTP layer maps each to a status:
+     * - validation → 400
+     * - not_found  → 404
+     * - forbidden  → 403
+     * - conflict   → 409 (e.g. resolving an already-resolved thread)
+     */
+    code: 'validation' | 'not_found' | 'forbidden' | 'conflict';
+    message: string;
+}
+/**
+ * Strip a comment row down to the public DTO. Centralised so the response
+ * shape stays consistent between create / list / update / resolve.
+ */
+export declare function toCommentDTO(row: DocumentCommentRow): CommentDTO;
+/**
+ * Parse + validate an anchor blob coming from an untrusted client. Returns
+ * `null` when the caller did not provide one (document-level comments).
+ */
+export declare function parseAnchor(input: unknown): CommentsResult<CommentAnchor | null>;
+/** Normalize whitespace + enforce length limits on a posted body. */
+export declare function normaliseBody(input: unknown): CommentsResult<string>;
+/**
+ * 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 declare function createComment(db: CommentsDB, input: CreateCommentInput): Promise<CommentsResult<CommentDTO>>;
+/**
+ * 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 declare function listComments(db: CommentsDB, filter: ListCommentsFilter): Promise<CommentsResult<CommentDTO[]>>;
+/**
+ * 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 declare function updateComment(db: CommentsDB, id: string, input: UpdateCommentInput, actor: {
+    userId: string;
+    isAdmin: boolean;
+}): Promise<CommentsResult<CommentDTO>>;
+/**
+ * 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 declare function resolveComment(db: CommentsDB, id: string, actor: {
+    userId: string;
+    canResolve: boolean;
+}): Promise<CommentsResult<CommentDTO>>;
+/**
+ * Re-open a resolved thread. Same permission as `resolveComment`.
+ */
+export declare function reopenComment(db: CommentsDB, id: string, actor: {
+    userId: string;
+    canResolve: boolean;
+}): Promise<CommentsResult<CommentDTO>>;
+/**
+ * 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 declare function deleteComment(db: CommentsDB, id: string, actor: {
+    userId: string;
+    isAdmin: boolean;
+}): Promise<CommentsResult<CommentDTO>>;
+//# sourceMappingURL=comments.d.ts.map

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

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