@actuate-media/cms-admin 0.12.0 → 0.13.0

package/dist/lib/coauthor-client.js

@@ -0,0 +1,98 @@
+import { cmsApi } from './api.js';
+/**
+ * Frozen tuple of every action the server accepts. Used both as a type-safe
+ * iteration source (bubble menu pills, slash-command registration) and by
+ * the runtime `isCoauthorAction` guard so callers don't drift from the
+ * server's allowlist.
+ */
+export const COAUTHOR_ACTIONS = ['rewrite', 'expand', 'compress', 'proofread'];
+const ACTION_LABELS = {
+    rewrite: 'Rewrite',
+    expand: 'Expand',
+    compress: 'Compress',
+    proofread: 'Proofread',
+};
+const ACTION_DESCRIPTIONS = {
+    rewrite: 'Rewrite the selection in a new tone or style',
+    expand: 'Expand the selection with more detail',
+    compress: 'Shorten the selection while preserving meaning',
+    proofread: 'Correct grammar, spelling, and punctuation',
+};
+/**
+ * Hard client-side ceiling that matches `AI_CONTEXT_MAX_CHARS` in cms-core.
+ * Catching this here avoids a round-trip just to get a 400 back when a user
+ * pastes a giant block into the bubble menu.
+ */
+export const COAUTHOR_TEXT_MAX_CHARS = 50_000;
+export function coauthorActionLabel(action) {
+    return ACTION_LABELS[action];
+}
+export function coauthorActionDescription(action) {
+    return ACTION_DESCRIPTIONS[action];
+}
+export function isCoauthorAction(value) {
+    return typeof value === 'string' && COAUTHOR_ACTIONS.includes(value);
+}
+/**
+ * Run a text-transformation micro-action against `/ai/coauthor`.
+ *
+ * Returns a discriminated outcome so callers can switch on `outcome.ok`
+ * without a try/catch — the underlying `cmsApi` already turns every
+ * non-2xx and every network failure into a structured error envelope.
+ *
+ * Pre-flight validation is intentionally cheap (whitespace + length) so the
+ * server stays the single source of truth for richer auth/rate-limit logic.
+ */
+export async function coauthorText(action, text, opts = {}) {
+    if (!isCoauthorAction(action)) {
+        return { ok: false, error: `Unknown action "${String(action)}"`, status: 0 };
+    }
+    if (typeof text !== 'string' || text.trim().length === 0) {
+        return { ok: false, error: 'No text provided', status: 0 };
+    }
+    if (text.length > COAUTHOR_TEXT_MAX_CHARS) {
+        return {
+            ok: false,
+            error: `Text exceeds ${COAUTHOR_TEXT_MAX_CHARS.toLocaleString()} character limit`,
+            status: 0,
+        };
+    }
+    const body = { action, text };
+    if (opts.style !== undefined)
+        body.style = opts.style;
+    if (opts.tone !== undefined)
+        body.tone = opts.tone;
+    if (opts.instructions !== undefined)
+        body.instructions = opts.instructions;
+    if (opts.targetLength !== undefined)
+        body.targetLength = opts.targetLength;
+    const res = await cmsApi('/ai/coauthor', {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+    if (res.error || !res.data) {
+        return {
+            ok: false,
+            error: res.error ?? `Request failed (${res.status})`,
+            status: res.status,
+        };
+    }
+    if (typeof res.data.text !== 'string') {
+        return {
+            ok: false,
+            error: 'Malformed response from /ai/coauthor (missing text)',
+            status: res.status,
+        };
+    }
+    return {
+        ok: true,
+        result: {
+            action: res.data.action ?? action,
+            text: res.data.text,
+            changes: action === 'proofread' && Array.isArray(res.data.changes)
+                ? res.data.changes
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=coauthor-client.js.map

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

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

package/dist/lib/collaboration-provider.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Browser-side Yjs collaboration provider for the TipTap editor.
+ *
+ * Wraps `y-websocket`'s `WebsocketProvider` with sensible defaults and a
+ * narrow public API. The wire protocol is byte-compatible with the
+ * cms-core realtime gateway shipped in PR #106, so the standard
+ * `WebsocketProvider` connects without any custom client code.
+ *
+ * Auth flows through the browser's cookie jar — `cms-admin` already uses
+ * cookie-based sessions, and the WebSocket upgrade request carries those
+ * cookies automatically against same-origin gateways. For cross-origin
+ * deployments, attach a query-string token via the `params` option.
+ */
+import { Awareness } from 'y-protocols/awareness';
+import { WebsocketProvider } from 'y-websocket';
+import { IndexeddbPersistence } from 'y-indexeddb';
+import * as Y from 'yjs';
+/** Connection status reported via `onStatus` and surfaced in the editor UI. */
+export type CollaborationStatus = 'connecting' | 'connected' | 'disconnected';
+/**
+ * Offline-draft persistence status. Slice 6 layers a local IndexedDB
+ * mirror on top of the y-websocket transport so edits made while
+ * disconnected aren't lost. The lifecycle is:
+ *
+ * - `unsupported` — `indexedDB` is unavailable (Safari private mode,
+ *   SSR, jsdom-without-fake-indexeddb).
+ * - `pending` — provider is being constructed; no local state yet.
+ * - `loading` — IndexedDB is replaying the last saved snapshot into
+ *   the Y.Doc.
+ * - `ready` — the local store is initialised and every change is
+ *   persisted locally before the WebSocket pushes it upstream.
+ * - `error` — IndexedDB threw; the editor still works in-memory but
+ *   refresh will lose pending edits.
+ */
+export type OfflinePersistenceStatus = 'unsupported' | 'pending' | 'loading' | 'ready' | 'error';
+/** Per-user presence info that becomes the local awareness state. */
+export interface CollaborationUser {
+    /** Display name (used for cursor labels and the presence chip strip). */
+    name: string;
+    /** CSS color value for the user's cursor / chip background. */
+    color: string;
+    /** Optional avatar URL (32-square recommended). Rendered if present. */
+    avatarUrl?: string;
+    /** Stable user id from the cms-core session (used as a dedup key). */
+    userId?: string;
+}
+export interface CollaborationOptions {
+    /** Logical document id (becomes the y-websocket "room name"). */
+    documentId: string;
+    /**
+     * Base URL of the realtime gateway, e.g. `wss://your.app/api/cms/realtime/sync`.
+     * The provider appends `/${documentId}` automatically (y-websocket convention).
+     * Use `ws://` for local dev.
+     */
+    url: string;
+    /** Presence info for the local user. */
+    user: CollaborationUser;
+    /**
+     * Extra query-string parameters (e.g. an auth token for cross-origin
+     * deployments). Forwarded to `WebsocketProvider`'s `params` option.
+     */
+    params?: Record<string, string>;
+    /** Called on every connection-state transition. */
+    onStatus?: (status: CollaborationStatus) => void;
+    /** Called on connection-level errors (e.g. 4401 auth rejection). */
+    onError?: (err: Error) => void;
+    /**
+     * If `false`, the helper does not connect on construction. Useful for
+     * tests and for editors that want a `Y.Doc` without network traffic.
+     * Defaults to `true`.
+     */
+    connect?: boolean;
+    /**
+     * Offline-draft persistence. When `true` (default), the provider
+     * mounts a `y-indexeddb` mirror so edits made while the WebSocket is
+     * disconnected survive a refresh. Pass `false` to skip the mirror
+     * (e.g. on shared kiosk machines where you don't want drafts in
+     * IndexedDB).
+     */
+    offline?: boolean;
+    /** Called on every offline-persistence status transition. */
+    onOfflineStatus?: (status: OfflinePersistenceStatus) => void;
+}
+export interface CollaborationContext {
+    /** Shared Y.Doc — bind this to the TipTap `Collaboration` extension. */
+    ydoc: Y.Doc;
+    /** The underlying y-websocket provider. */
+    provider: WebsocketProvider;
+    /** Awareness instance — bind to `CollaborationCursor` and the presence strip. */
+    awareness: Awareness;
+    /**
+     * Local IndexedDB mirror, when `offline` is enabled and the runtime
+     * supports it. `null` when persistence is disabled or unsupported
+     * (e.g. SSR / Safari private browsing).
+     */
+    offlinePersistence: IndexeddbPersistence | null;
+    /** Latest offline-persistence status. Mirrors `onOfflineStatus`. */
+    offlineStatus: OfflinePersistenceStatus;
+    /** Stop the provider, evict awareness, and destroy the Y.Doc. */
+    destroy: () => void;
+}
+/** Optional dependency-injection seam used by tests to avoid real WebSockets. */
+export interface CollaborationDeps {
+    WebsocketProviderCtor?: typeof WebsocketProvider;
+    /**
+     * Override the IndexedDB persistence constructor (test seam). The
+     * default uses `y-indexeddb` which requires a browser-like
+     * `indexedDB` global; tests inject a no-op stub.
+     */
+    IndexeddbPersistenceCtor?: typeof IndexeddbPersistence;
+    /**
+     * Override the IndexedDB feature check. Defaults to inspecting
+     * `globalThis.indexedDB`. Tests inject `() => true` to exercise the
+     * persistence path under happy-dom.
+     */
+    isIndexedDbSupported?: () => boolean;
+}
+/**
+ * Open a collaboration session for `documentId`. Must be called in a browser
+ * context (jsdom is fine for tests when a fake provider is injected).
+ *
+ * The returned `ydoc` is the document the editor binds to via TipTap's
+ * `Collaboration` extension; `awareness` carries cursor + presence state.
+ * Always call `destroy()` on unmount to evict the local awareness state and
+ * close the socket.
+ */
+export declare function createCollaborationProvider(opts: CollaborationOptions, deps?: CollaborationDeps): CollaborationContext;
+/**
+ * Reduce an Awareness map into a deduplicated array of `CollaborationUser`s.
+ * Used by `PresenceChips` and any other UI that visualises co-editors.
+ */
+export interface PresenceSnapshot {
+    /** Local user's client id (so UIs can omit themselves from the strip). */
+    selfClientId: number;
+    /** Connected users, deduplicated by `userId` when present, otherwise by clientId. */
+    users: Array<{
+        clientId: number;
+        user: CollaborationUser;
+    }>;
+}
+export declare function summarisePresence(awareness: Awareness): PresenceSnapshot;
+//# sourceMappingURL=collaboration-provider.d.ts.map

package/dist/lib/collaboration-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-provider.d.ts","sourceRoot":"","sources":["../../src/lib/collaboration-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAA;AAE7E;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAEhG,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,wCAAwC;IACxC,IAAI,EAAE,iBAAiB,CAAA;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA;IAChD,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAA;CAC7D;AAED,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAA;IACX,2CAA2C;IAC3C,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,iFAAiF;IACjF,SAAS,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,kBAAkB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAC/C,oEAAoE;IACpE,aAAa,EAAE,wBAAwB,CAAA;IACvC,iEAAiE;IACjE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAA;IAChD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,oBAAoB,CAAA;IACtD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAA;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,GAAE,iBAAsB,GAC3B,oBAAoB,CAiItB;AAgBD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,CAAC,CAAA;CAC5D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAaxE"}

package/dist/lib/collaboration-provider.js

@@ -0,0 +1,168 @@
+import { WebsocketProvider } from 'y-websocket';
+import { IndexeddbPersistence } from 'y-indexeddb';
+import * as Y from 'yjs';
+/**
+ * Open a collaboration session for `documentId`. Must be called in a browser
+ * context (jsdom is fine for tests when a fake provider is injected).
+ *
+ * The returned `ydoc` is the document the editor binds to via TipTap's
+ * `Collaboration` extension; `awareness` carries cursor + presence state.
+ * Always call `destroy()` on unmount to evict the local awareness state and
+ * close the socket.
+ */
+export function createCollaborationProvider(opts, deps = {}) {
+    if (typeof globalThis === 'undefined' ||
+        typeof globalThis.window === 'undefined') {
+        // Note: jsdom defines `window`, so this only trips on bare-Node SSR.
+        throw new Error('createCollaborationProvider can only be called in a browser context (window is undefined)');
+    }
+    if (!opts.documentId || !opts.url) {
+        throw new Error('createCollaborationProvider requires both documentId and url');
+    }
+    const Ctor = deps.WebsocketProviderCtor ?? WebsocketProvider;
+    const ydoc = new Y.Doc();
+    const provider = new Ctor(opts.url, opts.documentId, ydoc, {
+        connect: opts.connect ?? true,
+        params: opts.params,
+    });
+    // Layer y-indexeddb on top of the y-websocket transport for offline
+    // drafts. Both providers share the same Y.Doc, so they automatically
+    // converge: IndexedDB hydrates the doc on load, the websocket pushes
+    // pending updates to the gateway on reconnect.
+    const offlineEnabled = opts.offline !== false;
+    const offlineCheck = deps.isIndexedDbSupported ?? defaultIndexedDbSupportCheck;
+    let offlineStatus = 'pending';
+    const setOfflineStatus = (next) => {
+        offlineStatus = next;
+        opts.onOfflineStatus?.(next);
+    };
+    let offlinePersistence = null;
+    if (!offlineEnabled) {
+        setOfflineStatus('unsupported');
+    }
+    else if (!offlineCheck()) {
+        setOfflineStatus('unsupported');
+    }
+    else {
+        setOfflineStatus('loading');
+        const PersistenceCtor = deps.IndexeddbPersistenceCtor ?? IndexeddbPersistence;
+        try {
+            offlinePersistence = new PersistenceCtor(
+            // Namespace the IndexedDB key by documentId so multiple docs in
+            // the same admin session don't collide.
+            `actuate-cms:${opts.documentId}`, ydoc);
+            // `whenSynced` is the canonical "snapshot replay finished" hook
+            // from y-indexeddb (https://github.com/yjs/y-indexeddb).
+            offlinePersistence.whenSynced
+                .then(() => setOfflineStatus('ready'))
+                .catch((err) => {
+                opts.onError?.(err instanceof Error ? err : new Error('Offline persistence failed'));
+                setOfflineStatus('error');
+            });
+        }
+        catch (err) {
+            opts.onError?.(err instanceof Error ? err : new Error('Offline persistence failed'));
+            setOfflineStatus('error');
+            offlinePersistence = null;
+        }
+    }
+    // Seed local awareness with the user's presence info. The
+    // `CollaborationCursor` TipTap extension reads `user.name` + `user.color`
+    // out of awareness state and renders cursors accordingly.
+    provider.awareness.setLocalState({
+        user: {
+            name: opts.user.name,
+            color: opts.user.color,
+            avatarUrl: opts.user.avatarUrl,
+            userId: opts.user.userId,
+        },
+    });
+    if (opts.onStatus) {
+        const handler = (event) => {
+            const status = normaliseStatus(event.status);
+            if (status)
+                opts.onStatus(status);
+        };
+        provider.on('status', handler);
+    }
+    if (opts.onError) {
+        const handler = () => {
+            // y-websocket emits this on socket close + on protocol errors. We
+            // surface a generic Error so callers can render a toast without
+            // sniffing y-websocket internals.
+            opts.onError(new Error('Realtime connection error'));
+        };
+        provider.on('connection-error', handler);
+    }
+    const destroy = () => {
+        try {
+            provider.awareness.setLocalState(null);
+        }
+        catch {
+            /* awareness may already be torn down */
+        }
+        try {
+            provider.destroy();
+        }
+        catch {
+            /* idempotent */
+        }
+        if (offlinePersistence) {
+            try {
+                // y-indexeddb keeps the IDB connection open until `destroy()`;
+                // we don't drop the stored data (that's the point of offline
+                // drafts), but we close the handle so the runtime can GC.
+                offlinePersistence.destroy();
+            }
+            catch {
+                /* idempotent */
+            }
+        }
+        try {
+            ydoc.destroy();
+        }
+        catch {
+            /* idempotent */
+        }
+    };
+    return {
+        ydoc,
+        provider,
+        awareness: provider.awareness,
+        offlinePersistence,
+        get offlineStatus() {
+            return offlineStatus;
+        },
+        destroy,
+    };
+}
+function defaultIndexedDbSupportCheck() {
+    return (typeof globalThis !== 'undefined' &&
+        typeof globalThis.indexedDB !== 'undefined');
+}
+function normaliseStatus(value) {
+    if (value === 'connected')
+        return 'connected';
+    if (value === 'connecting')
+        return 'connecting';
+    if (value === 'disconnected')
+        return 'disconnected';
+    return null;
+}
+export function summarisePresence(awareness) {
+    const seenUserIds = new Set();
+    const users = [];
+    for (const [clientId, state] of awareness.getStates()) {
+        const user = state?.user;
+        if (!user || typeof user.name !== 'string')
+            continue;
+        if (user.userId) {
+            if (seenUserIds.has(user.userId))
+                continue;
+            seenUserIds.add(user.userId);
+        }
+        users.push({ clientId, user });
+    }
+    return { selfClientId: awareness.clientID, users };
+}
+//# sourceMappingURL=collaboration-provider.js.map

package/dist/lib/collaboration-provider.js.map

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

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