@actuate-media/cms-admin 0.12.0 → 0.12.1

package/dist/lib/comment-anchor.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Comment anchor helpers — convert between Yjs **relative positions** and
+ * the Base64 wire format the comments REST API speaks.
+ *
+ * Why relative positions: storing absolute offsets (e.g. char 42–58) is
+ * fatal under concurrent editing because someone inserting text before
+ * char 42 silently shifts the meaning of every saved anchor. Yjs ships
+ * `createRelativePositionFromTypeIndex` /
+ * `createAbsolutePositionFromRelativePosition` for exactly this case —
+ * they identify a slot in the CRDT graph that survives concurrent edits.
+ *
+ * The wire shape is `{ from: string; to: string }` where each end is the
+ * Base64 of `Y.encodeRelativePosition(rel)`. The slice 4 server treats
+ * the field as opaque; this module is the only place in the workspace
+ * that interprets it.
+ *
+ * ## Choosing the right Yjs type to anchor against
+ *
+ * `createRelativePositionFromTypeIndex(type, index)` interprets `index`
+ * differently depending on the type:
+ *
+ * - `Y.XmlText` / `Y.Text` — index is the character offset within the
+ *   text. **This is what comment anchors use** because character offsets
+ *   are the natural unit for a text selection.
+ * - `Y.XmlFragment` / `Y.XmlElement` — index counts *children*. Useful
+ *   for "before/after this child" anchors but not what we want here.
+ *
+ * Slice 5's TipTap binding maps a PM selection to the underlying
+ * `Y.XmlText` instance + character offset before calling `encodeAnchor`,
+ * and inverts that mapping after `decodeAnchor` returns. The y-prosemirror
+ * plugin keeps a `mapping` for this conversion; consumers that aren't
+ * using y-prosemirror can talk to the Y types directly.
+ */
+import * as Y from 'yjs';
+import type { CommentAnchor } from './comments-client.js';
+export interface CreateAnchorInput {
+    /** Live Yjs document the editor is bound to. */
+    doc: Y.Doc;
+    /**
+     * Yjs text type the selection lives in. Almost always a `Y.XmlText`
+     * for TipTap; we keep the bound a little loose so plain `Y.Text` works
+     * for non-rich-text editors.
+     */
+    yType: Y.XmlText | Y.Text;
+    /** Character offset (inclusive) of the selection start within `yType`. */
+    from: number;
+    /** Character offset (exclusive) of the selection end within `yType`. */
+    to: number;
+}
+/**
+ * Build a comment anchor from an editor selection. Returns `null` when
+ * the range is empty or inverted — the caller should not save anchors
+ * that would resolve to nothing.
+ */
+export declare function encodeAnchor(input: CreateAnchorInput): CommentAnchor | null;
+export interface ResolveAnchorInput {
+    doc: Y.Doc;
+    anchor: CommentAnchor;
+}
+export interface ResolvedAnchor {
+    /**
+     * The text type the relative position landed on. Comparing identity
+     * (`resolved.yType === editorBoundText`) lets the caller decide
+     * whether a comment is still attached to the expected text node.
+     */
+    yType: Y.AbstractType<unknown>;
+    /** Character offset of the saved selection start, after concurrent edits. */
+    from: number;
+    /** Character offset of the saved selection end. */
+    to: number;
+}
+/**
+ * Resolve a stored anchor back to live editor positions. Returns `null`
+ * when:
+ *
+ * - the anchor bytes are not valid base64 / not a Yjs relative position,
+ * - the relative position cannot be mapped (the anchored content was
+ *   deleted entirely), or
+ * - the two ends collapse to the same offset (text between them was
+ *   deleted, effectively detaching the comment).
+ *
+ * Slice 5 surfaces detached comments in the side panel with a small
+ * "anchor lost" badge so editors can still resolve / discuss them.
+ */
+export declare function decodeAnchor(input: ResolveAnchorInput): ResolvedAnchor | null;
+//# sourceMappingURL=comment-anchor.d.ts.map

package/dist/lib/comment-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-anchor.d.ts","sourceRoot":"","sources":["../../src/lib/comment-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACV;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAA;IACzB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAe3E;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACV,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAC9B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,GAAG,IAAI,CAmC7E"}

package/dist/lib/comment-anchor.js

@@ -0,0 +1,139 @@
+/**
+ * Comment anchor helpers — convert between Yjs **relative positions** and
+ * the Base64 wire format the comments REST API speaks.
+ *
+ * Why relative positions: storing absolute offsets (e.g. char 42–58) is
+ * fatal under concurrent editing because someone inserting text before
+ * char 42 silently shifts the meaning of every saved anchor. Yjs ships
+ * `createRelativePositionFromTypeIndex` /
+ * `createAbsolutePositionFromRelativePosition` for exactly this case —
+ * they identify a slot in the CRDT graph that survives concurrent edits.
+ *
+ * The wire shape is `{ from: string; to: string }` where each end is the
+ * Base64 of `Y.encodeRelativePosition(rel)`. The slice 4 server treats
+ * the field as opaque; this module is the only place in the workspace
+ * that interprets it.
+ *
+ * ## Choosing the right Yjs type to anchor against
+ *
+ * `createRelativePositionFromTypeIndex(type, index)` interprets `index`
+ * differently depending on the type:
+ *
+ * - `Y.XmlText` / `Y.Text` — index is the character offset within the
+ *   text. **This is what comment anchors use** because character offsets
+ *   are the natural unit for a text selection.
+ * - `Y.XmlFragment` / `Y.XmlElement` — index counts *children*. Useful
+ *   for "before/after this child" anchors but not what we want here.
+ *
+ * Slice 5's TipTap binding maps a PM selection to the underlying
+ * `Y.XmlText` instance + character offset before calling `encodeAnchor`,
+ * and inverts that mapping after `decodeAnchor` returns. The y-prosemirror
+ * plugin keeps a `mapping` for this conversion; consumers that aren't
+ * using y-prosemirror can talk to the Y types directly.
+ */
+import * as Y from 'yjs';
+/**
+ * Build a comment anchor from an editor selection. Returns `null` when
+ * the range is empty or inverted — the caller should not save anchors
+ * that would resolve to nothing.
+ */
+export function encodeAnchor(input) {
+    if (input.from >= input.to)
+        return null;
+    if (input.from < 0)
+        return null;
+    // `createRelativePositionFromTypeIndex` clamps `index` to `[0, type.length]`
+    // internally, but we surface an explicit failure when the *intent* is
+    // out of bounds so the caller can flag a stale selection.
+    if (input.to > input.yType.length)
+        return null;
+    const relFrom = Y.createRelativePositionFromTypeIndex(input.yType, input.from);
+    const relTo = Y.createRelativePositionFromTypeIndex(input.yType, input.to);
+    return {
+        from: encodeBase64(Y.encodeRelativePosition(relFrom)),
+        to: encodeBase64(Y.encodeRelativePosition(relTo)),
+    };
+}
+/**
+ * Resolve a stored anchor back to live editor positions. Returns `null`
+ * when:
+ *
+ * - the anchor bytes are not valid base64 / not a Yjs relative position,
+ * - the relative position cannot be mapped (the anchored content was
+ *   deleted entirely), or
+ * - the two ends collapse to the same offset (text between them was
+ *   deleted, effectively detaching the comment).
+ *
+ * Slice 5 surfaces detached comments in the side panel with a small
+ * "anchor lost" badge so editors can still resolve / discuss them.
+ */
+export function decodeAnchor(input) {
+    let relFromBytes;
+    let relToBytes;
+    try {
+        relFromBytes = decodeBase64(input.anchor.from);
+        relToBytes = decodeBase64(input.anchor.to);
+    }
+    catch {
+        return null;
+    }
+    let relFrom;
+    let relTo;
+    try {
+        relFrom = Y.decodeRelativePosition(relFromBytes);
+        relTo = Y.decodeRelativePosition(relToBytes);
+    }
+    catch {
+        return null;
+    }
+    const absFrom = Y.createAbsolutePositionFromRelativePosition(relFrom, input.doc);
+    const absTo = Y.createAbsolutePositionFromRelativePosition(relTo, input.doc);
+    if (absFrom === null || absTo === null)
+        return null;
+    // Both ends must land on the same text node — otherwise the user's
+    // original selection has been split across nodes and we cannot paint
+    // a clean highlight without further work in slice 5.
+    if (absFrom.type !== absTo.type)
+        return null;
+    if (absFrom.index >= absTo.index)
+        return null;
+    return {
+        yType: absFrom.type,
+        from: absFrom.index,
+        to: absTo.index,
+    };
+}
+/**
+ * Base64 encode without depending on Node's `Buffer` (the admin bundle
+ * is browser-first). We hand-roll the encode because both `btoa` and
+ * `Buffer` have ergonomic mis-fits for `Uint8Array` payloads.
+ */
+function encodeBase64(bytes) {
+    if (typeof btoa === 'function') {
+        let binary = '';
+        for (let i = 0; i < bytes.byteLength; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return btoa(binary);
+    }
+    const BufferCtor = globalThis.Buffer;
+    if (BufferCtor)
+        return BufferCtor.from(bytes).toString('base64');
+    throw new Error('No base64 encoder available');
+}
+function decodeBase64(s) {
+    if (typeof atob === 'function') {
+        const binary = atob(s);
+        const out = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            out[i] = binary.charCodeAt(i);
+        }
+        return out;
+    }
+    const BufferCtor = globalThis
+        .Buffer;
+    if (BufferCtor)
+        return new Uint8Array(BufferCtor.from(s, 'base64'));
+    throw new Error('No base64 decoder available');
+}
+//# sourceMappingURL=comment-anchor.js.map

package/dist/lib/comment-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-anchor.js","sourceRoot":"","sources":["../../src/lib/comment-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAmBxB;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/B,6EAA6E;IAC7E,sEAAsE;IACtE,0DAA0D;IAC1D,IAAI,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAE9C,MAAM,OAAO,GAAG,CAAC,CAAC,mCAAmC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9E,MAAM,KAAK,GAAG,CAAC,CAAC,mCAAmC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IAE1E,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACrD,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;KAClD,CAAA;AACH,CAAC;AAoBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,IAAI,YAAwB,CAAA;IAC5B,IAAI,UAAsB,CAAA;IAC1B,IAAI,CAAC;QACH,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9C,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAA2B,CAAA;IAC/B,IAAI,KAAyB,CAAA;IAC7B,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAA;QAChD,KAAK,GAAG,CAAC,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,CAAC,0CAA0C,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAChF,MAAM,KAAK,GAAG,CAAC,CAAC,0CAA0C,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5E,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEnD,mEAAmE;IACnE,qEAAqE;IACrE,qDAAqD;IACrD,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAE5C,IAAI,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAE7C,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,IAAI;QACnB,IAAI,EAAE,OAAO,CAAC,KAAK;QACnB,EAAE,EAAE,KAAK,CAAC,KAAK;KAChB,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAiB;IACrC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;IACrB,CAAC;IACD,MAAM,UAAU,GACd,UAGD,CAAC,MAAM,CAAA;IACR,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACtB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC/B,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,MAAM,UAAU,GAAI,UAAwE;SACzF,MAAM,CAAA;IACT,IAAI,UAAU;QAAE,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;AAChD,CAAC"}

package/dist/lib/comments-client.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Comments REST client — thin, typed wrapper around the
+ * `/documents/:id/comments` + `/comments/:id` endpoints shipped in slice 4
+ * of Phase 3 (see `packages/cms-core/src/realtime/comments.ts`).
+ *
+ * The client lives in `cms-admin` so the side panel, the bubble-menu
+ * "comment on selection" action, and any future MCP/AI hooks all share one
+ * request path, error model, and DTO shape.
+ *
+ * Mirrors the server contract:
+ *   POST   /documents/:documentId/comments     -> { body, anchor?, parentId? }
+ *   GET    /documents/:documentId/comments?…   -> { data: CommentDTO[] }
+ *   PATCH  /comments/:id                       -> { body }
+ *   POST   /comments/:id/resolve               -> 200 with updated DTO
+ *   POST   /comments/:id/reopen                -> 200 with updated DTO
+ *   DELETE /comments/:id                       -> 200 with soft-deleted DTO
+ */
+/**
+ * Yjs relative-position anchor returned by the server. The encoding is
+ * intentionally opaque on the wire (Base64 of `Y.encodeRelativePosition`);
+ * `lib/comment-anchor.ts` handles the round-trip when slice 5 paints a
+ * highlight in the editor.
+ */
+export interface CommentAnchor {
+    from: string;
+    to: string;
+}
+/**
+ * Public DTO returned by every comments endpoint. Mirrors `CommentDTO` in
+ * `@actuate-media/cms-core/realtime`; we duplicate the shape here so
+ * `cms-admin` doesn't take a hard dependency on the server-side service
+ * layer (which carries Prisma types we don't want pulled into the bundle).
+ */
+export interface Comment {
+    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;
+}
+export type CommentOutcome<T> = {
+    ok: true;
+    result: T;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+};
+export interface CreateCommentInput {
+    documentId: string;
+    body: string;
+    anchor?: CommentAnchor | null;
+    parentId?: string | null;
+}
+export interface ListCommentsOptions {
+    /** Default: false. Resolved threads are filtered out unless requested. */
+    includeResolved?: boolean;
+    /** Default: false. Admin-only; the server rejects non-admin callers. */
+    includeDeleted?: boolean;
+    /** Default: server-side cap (100). Hard upper bound is 200. */
+    pageSize?: number;
+}
+/**
+ * Create a top-level comment or a reply. Pass `parentId` to thread the
+ * comment under an existing one — the server enforces single-level
+ * threading (replies cannot themselves be parents).
+ */
+export declare function createComment(input: CreateCommentInput): Promise<CommentOutcome<Comment>>;
+/**
+ * List comments for a document. Active comments (not resolved, not deleted)
+ * are returned by default; pass `includeResolved` to keep resolved threads
+ * in the response. The server rejects `includeDeleted` for non-admins.
+ */
+export declare function listComments(documentId: string, opts?: ListCommentsOptions): Promise<CommentOutcome<Comment[]>>;
+/** Edit a comment body. Only the author or an admin is permitted. */
+export declare function updateComment(id: string, body: string): Promise<CommentOutcome<Comment>>;
+/** Resolve a thread. Write-role or the author may resolve. */
+export declare function resolveComment(id: string): Promise<CommentOutcome<Comment>>;
+/** Re-open a resolved thread. Same permission as resolve. */
+export declare function reopenComment(id: string): Promise<CommentOutcome<Comment>>;
+/**
+ * Soft-delete a comment. The row is preserved so its replies don't lose
+ * their thread root — the server simply stops returning it from the list
+ * endpoint unless an admin asks for `includeDeleted`.
+ */
+export declare function deleteComment(id: string): Promise<CommentOutcome<Comment>>;
+/**
+ * Sort comments into thread groups suitable for rendering. Roots are
+ * returned in chronological order; replies are ordered the same way and
+ * attached to their root. Replies whose root is missing (e.g. the root was
+ * filtered out by `includeResolved=false`) are dropped — the UI can fetch
+ * them explicitly if it needs to render orphaned replies.
+ */
+export interface CommentThread {
+    root: Comment;
+    replies: Comment[];
+}
+export declare function groupCommentsIntoThreads(comments: readonly Comment[]): CommentThread[];
+//# sourceMappingURL=comments-client.d.ts.map

package/dist/lib/comments-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments-client.d.ts","sourceRoot":"","sources":["../../src/lib/comments-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACvB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAsBD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAiB/F;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAOpC;AAED,qEAAqE;AACrE,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAU9F;AAED,8DAA8D;AAC9D,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAOjF;AAED,6DAA6D;AAC7D,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAOhF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAMhF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,EAAE,CAAA;CACnB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,aAAa,EAAE,CAgBtF"}

package/dist/lib/comments-client.js

@@ -0,0 +1,138 @@
+/**
+ * Comments REST client — thin, typed wrapper around the
+ * `/documents/:id/comments` + `/comments/:id` endpoints shipped in slice 4
+ * of Phase 3 (see `packages/cms-core/src/realtime/comments.ts`).
+ *
+ * The client lives in `cms-admin` so the side panel, the bubble-menu
+ * "comment on selection" action, and any future MCP/AI hooks all share one
+ * request path, error model, and DTO shape.
+ *
+ * Mirrors the server contract:
+ *   POST   /documents/:documentId/comments     -> { body, anchor?, parentId? }
+ *   GET    /documents/:documentId/comments?…   -> { data: CommentDTO[] }
+ *   PATCH  /comments/:id                       -> { body }
+ *   POST   /comments/:id/resolve               -> 200 with updated DTO
+ *   POST   /comments/:id/reopen                -> 200 with updated DTO
+ *   DELETE /comments/:id                       -> 200 with soft-deleted DTO
+ */
+import { cmsApi } from './api.js';
+function encodeOptions(opts = {}) {
+    const params = new URLSearchParams();
+    if (opts.includeResolved)
+        params.set('includeResolved', 'true');
+    if (opts.includeDeleted)
+        params.set('includeDeleted', 'true');
+    if (opts.pageSize !== undefined)
+        params.set('pageSize', String(opts.pageSize));
+    const qs = params.toString();
+    return qs ? `?${qs}` : '';
+}
+function failure(error, status) {
+    return { ok: false, error, status };
+}
+function envelope(res) {
+    if (res.error || res.data === undefined) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data };
+}
+/**
+ * Create a top-level comment or a reply. Pass `parentId` to thread the
+ * comment under an existing one — the server enforces single-level
+ * threading (replies cannot themselves be parents).
+ */
+export async function createComment(input) {
+    if (typeof input.documentId !== 'string' || input.documentId.length === 0) {
+        return failure('documentId is required', 0);
+    }
+    if (typeof input.body !== 'string' || input.body.trim().length === 0) {
+        return failure('Comment cannot be empty', 0);
+    }
+    const body = { body: input.body.trim() };
+    if (input.anchor)
+        body.anchor = input.anchor;
+    if (input.parentId)
+        body.parentId = input.parentId;
+    const res = await cmsApi(`/documents/${encodeURIComponent(input.documentId)}/comments`, {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+    return envelope(res);
+}
+/**
+ * List comments for a document. Active comments (not resolved, not deleted)
+ * are returned by default; pass `includeResolved` to keep resolved threads
+ * in the response. The server rejects `includeDeleted` for non-admins.
+ */
+export async function listComments(documentId, opts = {}) {
+    if (typeof documentId !== 'string' || documentId.length === 0) {
+        return failure('documentId is required', 0);
+    }
+    const path = `/documents/${encodeURIComponent(documentId)}/comments${encodeOptions(opts)}`;
+    const res = await cmsApi(path, { method: 'GET' });
+    return envelope(res);
+}
+/** Edit a comment body. Only the author or an admin is permitted. */
+export async function updateComment(id, body) {
+    if (!id)
+        return failure('comment id is required', 0);
+    if (typeof body !== 'string' || body.trim().length === 0) {
+        return failure('Comment cannot be empty', 0);
+    }
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ body: body.trim() }),
+    });
+    return envelope(res);
+}
+/** Resolve a thread. Write-role or the author may resolve. */
+export async function resolveComment(id) {
+    if (!id)
+        return failure('comment id is required', 0);
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}/resolve`, {
+        method: 'POST',
+        body: '{}',
+    });
+    return envelope(res);
+}
+/** Re-open a resolved thread. Same permission as resolve. */
+export async function reopenComment(id) {
+    if (!id)
+        return failure('comment id is required', 0);
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}/reopen`, {
+        method: 'POST',
+        body: '{}',
+    });
+    return envelope(res);
+}
+/**
+ * Soft-delete a comment. The row is preserved so its replies don't lose
+ * their thread root — the server simply stops returning it from the list
+ * endpoint unless an admin asks for `includeDeleted`.
+ */
+export async function deleteComment(id) {
+    if (!id)
+        return failure('comment id is required', 0);
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}`, {
+        method: 'DELETE',
+    });
+    return envelope(res);
+}
+export function groupCommentsIntoThreads(comments) {
+    const roots = new Map();
+    const sorted = [...comments].sort((a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt));
+    for (const c of sorted) {
+        if (c.parentId === null) {
+            roots.set(c.id, { root: c, replies: [] });
+        }
+    }
+    for (const c of sorted) {
+        if (c.parentId !== null) {
+            const root = roots.get(c.parentId);
+            if (root)
+                root.replies.push(c);
+        }
+    }
+    return Array.from(roots.values());
+}
+//# sourceMappingURL=comments-client.js.map

package/dist/lib/comments-client.js.map

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

package/dist/lib/notifications-client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Notifications REST client — typed wrapper around the slice-6 endpoints
+ * (`/notifications`, `/notifications/unread-count`,
+ * `/notifications/:id/read`, `/notifications/read-all`).
+ *
+ * Lives in `cms-admin` so the bell, the toast layer, and any future
+ * background sync agent share one request path, error model, and DTO
+ * shape. The wire format mirrors `NotificationDTO` in
+ * `@actuate-media/cms-core/realtime/notifications.ts`; we duplicate the
+ * shape here to avoid taking a hard dependency on the server module
+ * (which carries Prisma types that don't belong in the admin bundle).
+ */
+export type NotificationKind = 'comment_reply' | 'comment_resolved' | 'comment_mention';
+export interface CommentReplyPayload {
+    kind: 'comment_reply';
+    actorId: string | null;
+    actorName: string | null;
+    excerpt: string;
+}
+export interface CommentResolvedPayload {
+    kind: 'comment_resolved';
+    actorId: string | null;
+    actorName: string | null;
+    rootExcerpt: string;
+}
+export interface CommentMentionPayload {
+    kind: 'comment_mention';
+    actorId: string | null;
+    actorName: string | null;
+    excerpt: string;
+}
+export type NotificationPayload = CommentReplyPayload | CommentResolvedPayload | CommentMentionPayload;
+export interface Notification {
+    id: string;
+    userId: string;
+    kind: NotificationKind;
+    documentId: string | null;
+    commentId: string | null;
+    payload: NotificationPayload;
+    readAt: string | null;
+    createdAt: string;
+}
+export type NotificationOutcome<T> = {
+    ok: true;
+    result: T;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+};
+export interface ListNotificationsOptions {
+    /** Default: false. When true the response includes already-read rows. */
+    includeRead?: boolean;
+    /** Default: server-side cap. Hard upper bound is 200. */
+    pageSize?: number;
+}
+export declare function listNotifications(opts?: ListNotificationsOptions): Promise<NotificationOutcome<Notification[]>>;
+export declare function unreadCount(): Promise<NotificationOutcome<number>>;
+export declare function markNotificationRead(id: string): Promise<NotificationOutcome<Notification>>;
+export declare function markAllNotificationsRead(): Promise<NotificationOutcome<number>>;
+/**
+ * Cheap single-line summary for the bell list — the server gives us a
+ * structured payload, but the dropdown wants one human-readable string
+ * per row. Falls back to `Notification` when an unknown kind sneaks in
+ * (defensive against future server-side additions).
+ */
+export declare function notificationSummary(notification: Notification): string;
+//# sourceMappingURL=notifications-client.d.ts.map

package/dist/lib/notifications-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-client.d.ts","sourceRoot":"","sources":["../../src/lib/notifications-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,kBAAkB,GAAG,iBAAiB,CAAA;AAEvF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,mBAAmB,GAC3B,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,CAAA;AAEzB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,gBAAgB,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACvB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhD,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAyBD,wBAAsB,iBAAiB,CACrC,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,CAAC,CAAC,CAK9C;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAQxE;AAED,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAOjG;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CASrF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAYtE"}

package/dist/lib/notifications-client.js

@@ -0,0 +1,85 @@
+/**
+ * Notifications REST client — typed wrapper around the slice-6 endpoints
+ * (`/notifications`, `/notifications/unread-count`,
+ * `/notifications/:id/read`, `/notifications/read-all`).
+ *
+ * Lives in `cms-admin` so the bell, the toast layer, and any future
+ * background sync agent share one request path, error model, and DTO
+ * shape. The wire format mirrors `NotificationDTO` in
+ * `@actuate-media/cms-core/realtime/notifications.ts`; we duplicate the
+ * shape here to avoid taking a hard dependency on the server module
+ * (which carries Prisma types that don't belong in the admin bundle).
+ */
+import { cmsApi } from './api.js';
+function failure(error, status) {
+    return { ok: false, error, status };
+}
+function envelope(res) {
+    if (res.error || res.data === undefined) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data };
+}
+function buildQuery(opts = {}) {
+    const params = new URLSearchParams();
+    if (opts.includeRead)
+        params.set('includeRead', 'true');
+    if (opts.pageSize !== undefined)
+        params.set('pageSize', String(opts.pageSize));
+    const qs = params.toString();
+    return qs ? `?${qs}` : '';
+}
+export async function listNotifications(opts = {}) {
+    const res = await cmsApi(`/notifications${buildQuery(opts)}`, {
+        method: 'GET',
+    });
+    return envelope(res);
+}
+export async function unreadCount() {
+    const res = await cmsApi(`/notifications/unread-count`, {
+        method: 'GET',
+    });
+    if (res.error || !res.data) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data.count };
+}
+export async function markNotificationRead(id) {
+    if (!id)
+        return failure('notification id is required', 0);
+    const res = await cmsApi(`/notifications/${encodeURIComponent(id)}/read`, {
+        method: 'POST',
+        body: '{}',
+    });
+    return envelope(res);
+}
+export async function markAllNotificationsRead() {
+    const res = await cmsApi(`/notifications/read-all`, {
+        method: 'POST',
+        body: '{}',
+    });
+    if (res.error || !res.data) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data.count };
+}
+/**
+ * Cheap single-line summary for the bell list — the server gives us a
+ * structured payload, but the dropdown wants one human-readable string
+ * per row. Falls back to `Notification` when an unknown kind sneaks in
+ * (defensive against future server-side additions).
+ */
+export function notificationSummary(notification) {
+    const actor = notification.payload.actorName ?? 'Someone';
+    switch (notification.payload.kind) {
+        case 'comment_reply':
+            return `${actor} replied: "${notification.payload.excerpt}"`;
+        case 'comment_resolved':
+            return `${actor} resolved your thread: "${notification.payload.rootExcerpt}"`;
+        case 'comment_mention':
+            return `${actor} mentioned you: "${notification.payload.excerpt}"`;
+        default:
+            return 'Notification';
+    }
+}
+//# sourceMappingURL=notifications-client.js.map

package/dist/lib/notifications-client.js.map

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