@actuate-media/cms-admin 0.12.0 → 0.13.0

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,121 @@
+/**
+ * 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>>;
+/**
+ * Subscribe to the per-user SSE push channel that ships notifications
+ * the instant they're persisted server-side. Replaces the 30-second
+ * poll loop in the notification bell.
+ *
+ * The browser's native `EventSource` handles reconnection for us — on
+ * a server-initiated close (the stream caps at ~4 minutes by design),
+ * the connection re-opens automatically. We DO NOT abort the poll
+ * fallback in callers: SSE is a latency-win, the poll is what keeps
+ * multi-node deployments correct (each node only pushes to its own
+ * subscribers).
+ *
+ * Returns a `close()` function that callers MUST invoke on unmount —
+ * otherwise the browser keeps the connection open and we leak event
+ * listeners.
+ *
+ * `EventSource` itself isn't available in the JSDOM test environment;
+ * callers can inject a `factory` to substitute a test double. In
+ * production we fall back to the global `EventSource` when no factory
+ * is supplied.
+ */
+export interface NotificationStreamOptions {
+    /** Called for every `event: notification` frame. */
+    onNotification: (n: Notification) => void;
+    /** Called once on the `event: ready` frame. */
+    onReady?: (payload: {
+        userId: string;
+    }) => void;
+    /** Called on connection errors. Useful for falling back to the poll loop. */
+    onError?: (event: Event) => void;
+    /**
+     * Optional factory so unit tests can inject a fake `EventSource`,
+     * or a null sentinel when the environment lacks one (SSR, JSDOM
+     * without a polyfill). Production code can rely on the default
+     * (global `EventSource`).
+     */
+    factory?: (url: string) => EventSourceLike | null;
+}
+/**
+ * Minimal subset of the `EventSource` interface our subscriber relies
+ * on. Browsers ship the full DOM type; the admin only needs add/remove
+ * event listeners plus `close()`.
+ */
+export interface EventSourceLike {
+    addEventListener: (type: string, listener: (event: MessageEvent | Event) => void) => void;
+    removeEventListener?: (type: string, listener: (event: MessageEvent | Event) => void) => void;
+    close: () => void;
+}
+export interface NotificationStreamHandle {
+    /** Tear down the EventSource and stop receiving events. Idempotent. */
+    close: () => void;
+}
+export declare function subscribeNotificationStream(opts: NotificationStreamOptions): NotificationStreamHandle;
+/**
+ * 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":"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"}

package/dist/lib/notifications-client.js

@@ -0,0 +1,173 @@
+/**
+ * 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, getApiBase } 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 };
+}
+export function subscribeNotificationStream(opts) {
+    // The `cmsApi()` helper handles base-path / origin resolution for
+    // fetch calls, but EventSource takes a raw URL. We mirror its
+    // logic locally — `/api/cms/notifications/stream` is correct for
+    // both the local dev server and any production deploy that mounts
+    // the CMS API at the default prefix. Custom prefixes are handled by
+    // the consumer override (factory).
+    // Resolve against `setApiBase()` so a consumer mounting the CMS at
+    // a non-default prefix (e.g. `/cms-api`) still hits the right SSE
+    // endpoint — `EventSource` doesn't go through `cmsApi()`, so we
+    // can't rely on its url-construction logic.
+    const url = `${getApiBase()}/notifications/stream`;
+    const make = opts.factory ?? defaultEventSourceFactory;
+    const source = make(url);
+    if (!source) {
+        // No EventSource available (SSR? JSDOM without polyfill? Or the
+        // injected factory deliberately returns null in tests). Return a
+        // no-op handle so callers can compose without conditional logic.
+        return { close: () => { } };
+    }
+    let closed = false;
+    const onReady = (event) => {
+        if (!opts.onReady)
+            return;
+        const data = parseEventData(event);
+        if (data && typeof data.userId === 'string') {
+            opts.onReady({ userId: data.userId });
+        }
+    };
+    const onNotification = (event) => {
+        const data = parseEventData(event);
+        if (data && isNotification(data)) {
+            opts.onNotification(data);
+        }
+    };
+    const onError = (event) => {
+        opts.onError?.(event);
+    };
+    source.addEventListener('ready', onReady);
+    source.addEventListener('notification', onNotification);
+    source.addEventListener('error', onError);
+    return {
+        close: () => {
+            if (closed)
+                return;
+            closed = true;
+            source.removeEventListener?.('ready', onReady);
+            source.removeEventListener?.('notification', onNotification);
+            source.removeEventListener?.('error', onError);
+            source.close();
+        },
+    };
+}
+function defaultEventSourceFactory(url) {
+    if (typeof EventSource === 'undefined')
+        return null;
+    // `withCredentials: true` so the admin session cookie travels with
+    // the connection upgrade — every notification stream requires auth
+    // and the same-origin cookie is the only credential we trust here.
+    return new EventSource(url, { withCredentials: true });
+}
+function parseEventData(event) {
+    // EventSource emits MessageEvents with `data: string`. Plain
+    // `Event` (e.g. the `error` event) has no payload; ignore.
+    const data = event.data;
+    if (typeof data !== 'string')
+        return null;
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+function isNotification(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    // Defensive: don't trust the wire blindly — verify the discriminant
+    // properties our consumers will read. A drift in the server-side
+    // wire format must surface as "missing fields" in the test suite,
+    // not as runtime errors deep in the bell's render path.
+    return (typeof v.id === 'string' &&
+        typeof v.userId === 'string' &&
+        typeof v.createdAt === 'string' &&
+        !!v.payload &&
+        typeof v.payload.kind === 'string');
+}
+/**
+ * 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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"}

package/dist/lib/slash-command.d.ts

@@ -0,0 +1,39 @@
+import { type CoauthorAction } from './coauthor-client.js';
+/**
+ * Cmd+K slash-command parsing for the AI co-author.
+ *
+ * Recognized syntax (case-insensitive, leading whitespace tolerated):
+ *
+ *     /ai <action> [text...]
+ *
+ * `<action>` is one of `COAUTHOR_ACTIONS`. `text` is the payload handed to
+ * `/ai/coauthor`; it may be empty while the user is still typing.
+ *
+ * The parser is pure so we can unit-test every edge case (case folding,
+ * trailing whitespace, partial input, unknown actions) without spinning up
+ * `cmdk` or the rest of the palette.
+ */
+export interface AiSlashCommand {
+    action: CoauthorAction;
+    text: string;
+}
+/**
+ * Returns the matched `{ action, text }` when `input` is a complete
+ * slash command (`/ai rewrite ...`), or `null` otherwise. `text` may be
+ * empty when the user has typed `/ai rewrite` with no payload yet.
+ */
+export declare function parseAiSlashCommand(input: string): AiSlashCommand | null;
+/**
+ * Returns true when `input` looks like the start of an AI slash command
+ * — even when the action isn't typed yet (`/`, `/a`, `/ai`, `/ai re`).
+ * The palette uses this to switch into "AI mode" (hide nav results,
+ * show the four action suggestions).
+ */
+export declare function isAiSlashCommandInput(input: string): boolean;
+/**
+ * Ordered list of actions to show in AI mode. When the user has typed a
+ * valid command, that command's action is hoisted to the top so it gets
+ * the default keyboard focus (and Enter runs it).
+ */
+export declare function orderedAiActions(input: string): CoauthorAction[];
+//# sourceMappingURL=slash-command.d.ts.map

package/dist/lib/slash-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../../src/lib/slash-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE9F;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAYxE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAIhE"}

package/dist/lib/slash-command.js

@@ -0,0 +1,50 @@
+import { COAUTHOR_ACTIONS, isCoauthorAction } from './coauthor-client.js';
+const SLASH_HEAD = /^\s*\/\s*ai(?:\s+|$)/i;
+/**
+ * Returns the matched `{ action, text }` when `input` is a complete
+ * slash command (`/ai rewrite ...`), or `null` otherwise. `text` may be
+ * empty when the user has typed `/ai rewrite` with no payload yet.
+ */
+export function parseAiSlashCommand(input) {
+    if (typeof input !== 'string')
+        return null;
+    if (!SLASH_HEAD.test(input))
+        return null;
+    const after = input.replace(SLASH_HEAD, '');
+    if (after.length === 0)
+        return null;
+    const firstWhitespace = after.search(/\s/);
+    const head = (firstWhitespace === -1 ? after : after.slice(0, firstWhitespace)).toLowerCase();
+    if (!isCoauthorAction(head))
+        return null;
+    const tail = firstWhitespace === -1 ? '' : after.slice(firstWhitespace + 1);
+    return { action: head, text: tail.trim() };
+}
+/**
+ * Returns true when `input` looks like the start of an AI slash command
+ * — even when the action isn't typed yet (`/`, `/a`, `/ai`, `/ai re`).
+ * The palette uses this to switch into "AI mode" (hide nav results,
+ * show the four action suggestions).
+ */
+export function isAiSlashCommandInput(input) {
+    if (typeof input !== 'string')
+        return false;
+    const trimmed = input.trim();
+    if (trimmed.length === 0)
+        return false;
+    if (trimmed === '/')
+        return true;
+    return /^\/\s*a(i\b|i?[a-z]*|)?(\s.*)?$/i.test(trimmed);
+}
+/**
+ * Ordered list of actions to show in AI mode. When the user has typed a
+ * valid command, that command's action is hoisted to the top so it gets
+ * the default keyboard focus (and Enter runs it).
+ */
+export function orderedAiActions(input) {
+    const parsed = parseAiSlashCommand(input);
+    if (!parsed)
+        return [...COAUTHOR_ACTIONS];
+    return [parsed.action, ...COAUTHOR_ACTIONS.filter((a) => a !== parsed.action)];
+}
+//# sourceMappingURL=slash-command.js.map