@pageloop/client 0.5.0

package/dist/ApiClient.js

@@ -0,0 +1,512 @@
+import { RpcError } from '@pageloop/shared';
+import { EventBus } from './EventBus.js';
+/**
+ * Every server-event name, as a runtime array. The SSE transport must
+ * register one `addEventListener` per named event (EventSource has no
+ * generic catch-all for named events), so it needs the names at runtime
+ * — whereas `ServerEvent['name']` is a type that's erased at compile.
+ *
+ * `satisfies readonly ServerEvent['name'][]` makes this list authoritative:
+ * adding a new event to the `ServerEvent` union without listing it here is
+ * still allowed (the array stays a valid subset), but the exhaustiveness
+ * guard below turns a *missing* name into a compile error, so SSE can't
+ * silently drop a freshly-added server event (CW-8). Done entirely
+ * client-side; no server change required.
+ */
+const SERVER_EVENT_NAMES = [
+    'projects.updated',
+    'memberships.updated',
+    'comments.created',
+    'comments.updated',
+    'comments.deleted',
+    'comments.bulkDeleted',
+    'replies.created',
+    'replies.updated',
+    'replies.deleted',
+    'reactions.changed',
+    'versions.refreshed',
+    'repo.sync.started',
+    'repo.sync.finished',
+    'repo.sync.failed',
+    'integration.sync.started',
+    'integration.sync.finished',
+    'integration.sync.failed',
+    'notifications.new',
+    'media.processed',
+    'pages.changed',
+    'pageGroups.changed',
+    'managedDocs.changed',
+    'chat.message',
+    'chat.presence',
+    'chat.read',
+    'chat.typing',
+    'notification.show',
+    // Server-internal admin signals — never broadcast to clients (the
+    // server's topicsForEvent returns [] for them). Listed only to satisfy
+    // the exhaustiveness guard below.
+    'user.registered',
+    'org.member.joined',
+];
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const _assertNoMissingServerEventName = true;
+/**
+ * Single point of network IO for the SDK. Tries WebSocket first, falls back
+ * to SSE for events + REST for commands. The same `call()` API works
+ * regardless of transport — callers don't know whether their command went
+ * over a WS frame or a fetch.
+ */
+export class ApiClient {
+    config;
+    bus;
+    socket = null;
+    sse = null;
+    nextId = 1;
+    pending = new Map();
+    connected = false;
+    currentTransport = null;
+    /** Topics this client wants to be on. Re-sent on every WS reconnect
+     *  so a transport bounce doesn't silently drop the user out of
+     *  chat rooms / other topic streams. */
+    desiredTopics = new Set();
+    /** Resolver bookkeeping for `subscribeTopic` calls awaiting an
+     *  `{type:'subscribed', topic, ok, error?}` ack. Keyed by topic. */
+    pendingTopicAcks = new Map();
+    /** Extra context to send with each subscribe frame (e.g. guestName
+     *  for anonymous chat presence). Keyed by topic; re-sent on every
+     *  reconnect via the same desiredTopics flush. */
+    topicExtras = new Map();
+    /** Set by `disconnect()` so a deliberate teardown (logout, token swap)
+     *  does NOT trigger the auto-reconnect loop. Cleared on the next
+     *  `connect()`. */
+    intentionalClose = false;
+    /** Current backoff attempt count for the WS auto-reconnect loop.
+     *  Reset to 0 on a clean open. */
+    reconnectAttempts = 0;
+    /** Pending reconnect timer handle so we never stack two loops. */
+    reconnectTimer = null;
+    /** Base + cap for the exponential backoff (with jitter). */
+    static RECONNECT_BASE_MS = 1000;
+    static RECONNECT_MAX_MS = 30_000;
+    constructor(config, bus) {
+        this.config = config;
+        this.bus = bus;
+    }
+    /** The base URL the API client talks to. Renderers read this to build
+     *  out-of-band URLs (e.g. the OAuth `/auth/:provider/start` redirect). */
+    getEndpoint() {
+        return this.config.endpoint;
+    }
+    /**
+     * Re-emit the current connection state on the bus. Used after the renderer
+     * mounts (and therefore registers its connection-state listener) to make
+     * sure it sees connections that completed during pre-mount bootstrap.
+     */
+    replayConnectionState() {
+        if (this.connected && this.currentTransport) {
+            this.bus.emit('connection:open', { transport: this.currentTransport });
+        }
+        else {
+            this.bus.emit('connection:closed', {});
+        }
+    }
+    setToken(token) {
+        this.config.token = token;
+        // Force a reconnect so the new token is used in the WS query string.
+        this.disconnect();
+        void this.connect();
+    }
+    /** Currently-attached bearer token, or null when anonymous. */
+    getToken() {
+        return this.config.token;
+    }
+    async connect() {
+        // A fresh connect cancels any in-flight backoff loop and re-opens
+        // the auto-reconnect gate that `disconnect()` may have closed.
+        this.intentionalClose = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        const kind = this.config.transport ?? 'auto';
+        if (kind === 'ws' || kind === 'auto') {
+            try {
+                await this.connectWs();
+                return;
+            }
+            catch {
+                if (kind === 'ws')
+                    throw new Error('WebSocket connect failed');
+                // fall through to SSE
+            }
+        }
+        if (kind === 'sse' || kind === 'auto') {
+            try {
+                this.connectSse();
+                return;
+            }
+            catch {
+                // fall through to REST-only
+            }
+        }
+        // REST-only mode: no persistent connection. We're effectively done.
+        this.connected = true;
+        this.currentTransport = 'rest';
+        this.bus.emit('connection:open', { transport: 'rest' });
+    }
+    disconnect() {
+        // Deliberate teardown: suppress the auto-reconnect loop and cancel
+        // any pending backoff timer so a logout / token swap doesn't
+        // immediately re-dial the old session.
+        this.intentionalClose = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.socket) {
+            this.socket.close();
+            this.socket = null;
+        }
+        if (this.sse) {
+            this.sse.close();
+            this.sse = null;
+        }
+        this.connected = false;
+    }
+    /**
+     * Force an immediate reconnect attempt, bypassing the backoff delay.
+     * Used by the connection pill's click-to-retry while offline (CR-8).
+     * No-op when a healthy socket is already open or a deliberate
+     * teardown is in effect.
+     */
+    retryNow() {
+        if (this.intentionalClose)
+            return;
+        if (this.socket && this.socket.readyState === this.socket.OPEN)
+            return;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.reconnectAttempts = 0;
+        void this.connect();
+    }
+    /**
+     * Schedule a WebSocket re-dial with exponential backoff + jitter
+     * (1s → 2s → 4s … capped at 30s). Gated on `intentionalClose` so a
+     * deliberate teardown never reconnects. Emits `connection:reconnecting`
+     * before each attempt so the connection pill can show the
+     * reconnecting state. On a successful re-open the existing
+     * `desiredTopics` flush (in `connectWs`'s onopen) re-subscribes every
+     * topic, and `reconnectAttempts` resets to 0.
+     */
+    scheduleReconnect() {
+        if (this.intentionalClose)
+            return;
+        // Only the WS transport auto-reconnects; SSE has its own browser-
+        // managed retry, and REST has no persistent connection.
+        if (this.config.transport && this.config.transport !== 'auto' && this.config.transport !== 'ws') {
+            return;
+        }
+        if (this.reconnectTimer)
+            return; // a loop is already armed
+        const attempt = this.reconnectAttempts + 1;
+        const expo = ApiClient.RECONNECT_BASE_MS * 2 ** (attempt - 1);
+        const capped = Math.min(expo, ApiClient.RECONNECT_MAX_MS);
+        // Full jitter on the upper half of the window keeps a fleet of
+        // widgets from reconnecting in lockstep after a server restart.
+        const delayMs = Math.round(capped / 2 + Math.random() * (capped / 2));
+        this.bus.emit('connection:reconnecting', { attempt, delayMs });
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.reconnectAttempts = attempt;
+            this.connect().catch(() => {
+                // connect() already falls WS→SSE→REST internally; if it
+                // still rejected, arm the next backoff step.
+                this.scheduleReconnect();
+            });
+        }, delayMs);
+    }
+    /**
+     * Send a typed command/query. Goes over WS when available, otherwise REST.
+     * Always returns a Promise; subscriptions are managed separately.
+     */
+    async call(method, params) {
+        if (this.socket && this.socket.readyState === this.socket.OPEN) {
+            return this.callWs(method, params);
+        }
+        return this.callRest(method, params);
+    }
+    /**
+     * Subscribe this socket to a server-side broadcast topic (e.g.
+     * `chat:page:<pageId>`). Returns when the server acks the
+     * subscribe; rejects on FORBIDDEN.
+     *
+     * The topic is remembered in `desiredTopics` so a transport bounce
+     * automatically re-subscribes after reconnect — callers don't have
+     * to re-arm anything on `connection:open`. Likewise, calling
+     * subscribeTopic BEFORE the initial WS handshake completes is
+     * fine: the topic queues here and the on-open handler flushes it
+     * once the socket is up. The returned Promise resolves whenever
+     * the eventual ack lands (or times out after ~30s).
+     *
+     * Events still arrive via the `EventBus`; callers filter by event
+     * name + scope/id. This method only handles the server-side
+     * permission handshake.
+     */
+    async subscribeTopic(topic, extras) {
+        if (!topic)
+            throw new Error('subscribeTopic: empty topic');
+        this.desiredTopics.add(topic);
+        if (extras)
+            this.topicExtras.set(topic, extras);
+        else
+            this.topicExtras.delete(topic);
+        if (this.socket && this.socket.readyState === this.socket.OPEN) {
+            return this.sendSubscribeFrame(topic);
+        }
+        // WS not connected yet (or has dropped). Register an ack waiter;
+        // the on-open handler will send the subscribe frame and the
+        // `subscribed` reply will resolve us. Use a longer timeout than
+        // the per-frame one since we're also waiting for the initial
+        // transport handshake.
+        return this.queueTopicAck(topic, 30_000);
+    }
+    /** Drop this socket from a topic. Idempotent. */
+    unsubscribeTopic(topic) {
+        this.desiredTopics.delete(topic);
+        if (this.socket && this.socket.readyState === this.socket.OPEN) {
+            this.socket.send(JSON.stringify({ type: 'unsubscribe', topic }));
+        }
+        // Reject any still-pending ack waiters for this topic — they'll
+        // never receive a subscribed ack after an unsubscribe.
+        const waiters = this.pendingTopicAcks.get(topic);
+        if (waiters) {
+            this.pendingTopicAcks.delete(topic);
+            for (const w of waiters) {
+                clearTimeout(w.timer);
+                w.reject(new Error(`unsubscribed before ack: ${topic}`));
+            }
+        }
+    }
+    // --- WS ---
+    connectWs() {
+        return new Promise((resolve, reject) => {
+            const wsUrl = this.config.endpoint.replace(/^http/, 'ws') +
+                '/ws' +
+                `?projectId=${encodeURIComponent(this.config.projectId)}` +
+                (this.config.token ? `&token=${encodeURIComponent(this.config.token)}` : '');
+            const sock = new WebSocket(wsUrl);
+            const t = setTimeout(() => {
+                sock.close();
+                reject(new Error('WS connect timeout'));
+            }, 4000);
+            sock.onopen = () => {
+                clearTimeout(t);
+                this.socket = sock;
+                this.connected = true;
+                this.currentTransport = 'ws';
+                // Clean open — reset the backoff ladder so the *next* drop
+                // starts again at the 1s base rather than wherever the last
+                // reconnect storm left off.
+                this.reconnectAttempts = 0;
+                this.bus.emit('connection:open', { transport: 'ws' });
+                // Re-arm topic subscriptions across reconnects. We swallow
+                // per-topic failures (server may legitimately deny after a
+                // permission change) — the topic will simply drop out.
+                for (const topic of this.desiredTopics) {
+                    void this.sendSubscribeFrame(topic).catch(() => undefined);
+                }
+                resolve();
+            };
+            sock.onerror = () => {
+                clearTimeout(t);
+                reject(new Error('WS connect error'));
+            };
+            sock.onclose = () => {
+                this.connected = false;
+                // Drop the dead socket reference so `call()` routes over REST
+                // (and a stale `this.socket` can't be re-used) until the
+                // reconnect loop installs a fresh one.
+                if (this.socket === sock)
+                    this.socket = null;
+                this.bus.emit('connection:closed', { transport: 'ws' });
+                // Re-arm pending topic-ack timers with a generous reconnect
+                // window. Their original 8s per-frame timers were anchored
+                // to a now-dead socket; without this they'd fire mid-
+                // reconnect and reject as "subscribe timeout" — which
+                // surfaces in the chat panel as "Could not reach the chat
+                // server" even though the next WS open would have flushed
+                // the subscribe cleanly.
+                for (const [topic, waiters] of this.pendingTopicAcks) {
+                    for (const w of waiters) {
+                        clearTimeout(w.timer);
+                        w.timer = this.armAckTimer(topic, 60_000, w.reject);
+                    }
+                }
+                // Auto-reconnect with exponential backoff unless this was a
+                // deliberate teardown. The reconnected socket's onopen
+                // flushes desiredTopics so chat rooms / topic streams
+                // resume without any caller re-arming anything.
+                this.scheduleReconnect();
+            };
+            sock.onmessage = (e) => this.handleWsMessage(e.data);
+        });
+    }
+    callWs(method, params) {
+        return new Promise((resolve, reject) => {
+            const id = String(this.nextId++);
+            this.pending.set(id, { resolve, reject });
+            this.socket.send(JSON.stringify({ type: 'request', id, method, params }));
+            // 30s timeout — tunable later.
+            setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error(`Request timeout: ${method}`));
+                }
+            }, 30_000);
+        });
+    }
+    sendSubscribeFrame(topic) {
+        return new Promise((resolve, reject) => {
+            const timer = this.armAckTimer(topic, 8000, reject);
+            const waiters = this.pendingTopicAcks.get(topic) ?? [];
+            waiters.push({ resolve, reject, timer });
+            this.pendingTopicAcks.set(topic, waiters);
+            const extras = this.topicExtras.get(topic);
+            this.socket.send(JSON.stringify({ type: 'subscribe', topic, ...(extras ?? {}) }));
+        });
+    }
+    /** Park a topic-subscribe in the pending map without sending a
+     *  frame yet — the next `connection:open` handler will send the
+     *  subscribe and the `subscribed` ack resolves us. */
+    queueTopicAck(topic, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = this.armAckTimer(topic, timeoutMs, reject);
+            const waiters = this.pendingTopicAcks.get(topic) ?? [];
+            waiters.push({ resolve, reject, timer });
+            this.pendingTopicAcks.set(topic, waiters);
+        });
+    }
+    /** Shared timer-cleanup for both immediate-send and queued
+     *  subscribe paths. */
+    armAckTimer(topic, timeoutMs, reject) {
+        const timer = setTimeout(() => {
+            const list = this.pendingTopicAcks.get(topic);
+            if (!list)
+                return;
+            const idx = list.findIndex((w) => w.timer === timer);
+            if (idx >= 0) {
+                list.splice(idx, 1);
+                if (list.length === 0)
+                    this.pendingTopicAcks.delete(topic);
+            }
+            reject(new Error(`subscribe timeout: ${topic}`));
+        }, timeoutMs);
+        return timer;
+    }
+    resolveTopicAck(topic, ok, error) {
+        const waiters = this.pendingTopicAcks.get(topic);
+        if (!waiters)
+            return;
+        this.pendingTopicAcks.delete(topic);
+        for (const w of waiters) {
+            clearTimeout(w.timer);
+            if (ok)
+                w.resolve();
+            else
+                w.reject(new RpcError(error?.code ?? 'FORBIDDEN', error?.message ?? 'subscribe denied'));
+        }
+    }
+    handleWsMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(typeof raw === 'string' ? raw : raw.toString());
+        }
+        catch {
+            return;
+        }
+        if (msg.type === 'response') {
+            const pending = this.pending.get(msg.id);
+            if (!pending)
+                return;
+            this.pending.delete(msg.id);
+            if (msg.error)
+                pending.reject(new RpcError(msg.error.code, msg.error.message));
+            else
+                pending.resolve(msg.result);
+            return;
+        }
+        if (msg.type === 'subscribed') {
+            this.resolveTopicAck(msg.topic, !!msg.ok, msg.error);
+            // On a denied subscribe, drop the topic from desiredTopics so
+            // we don't keep re-trying after every reconnect.
+            if (!msg.ok)
+                this.desiredTopics.delete(msg.topic);
+            return;
+        }
+        if (msg.type === 'unsubscribed') {
+            // Silent — desiredTopics already updated client-side.
+            return;
+        }
+        if (msg.type === 'event') {
+            const event = msg.event;
+            this.bus.emit(event.name, event);
+        }
+    }
+    // --- SSE ---
+    connectSse() {
+        const url = `${this.config.endpoint}/api/v1/events?projectId=${encodeURIComponent(this.config.projectId)}`;
+        this.sse = new EventSource(url, { withCredentials: true });
+        this.sse.onopen = () => {
+            this.connected = true;
+            this.currentTransport = 'sse';
+            this.bus.emit('connection:open', { transport: 'sse' });
+        };
+        this.sse.onerror = () => {
+            this.connected = false;
+            this.bus.emit('connection:closed', { transport: 'sse' });
+        };
+        // Each named server event arrives as its own SSE `event:` line, so
+        // we register one listener per name. The list is derived from the
+        // shared `ServerEvent['name']` union (SERVER_EVENT_NAMES, guarded
+        // for exhaustiveness at compile time) — the WS path re-emits any
+        // event generically, and this keeps SSE-only clients (WS-blocking
+        // proxies, some mobile webviews) at parity without a server change.
+        const reemit = (e) => {
+            try {
+                const event = JSON.parse(e.data);
+                this.bus.emit(event.name, event);
+            }
+            catch {
+                // bad frame — ignore
+            }
+        };
+        for (const name of SERVER_EVENT_NAMES) {
+            this.sse.addEventListener(name, (e) => reemit(e));
+        }
+        // Belt-and-suspenders: if the server ever emits a bare `data:` frame
+        // (no `event:` line) or a name we haven't listed, the default
+        // `message` handler still re-emits by the payload's own `name`.
+        this.sse.onmessage = (e) => reemit(e);
+    }
+    // --- REST ---
+    async callRest(method, params) {
+        const headers = {
+            'content-type': 'application/json',
+            'x-pageloop-project': this.config.projectId,
+        };
+        if (this.config.token)
+            headers.authorization = `Bearer ${this.config.token}`;
+        const res = await fetch(`${this.config.endpoint}/api/v1/rpc`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ method, params, projectId: this.config.projectId }),
+        });
+        const json = await res.json();
+        if (!res.ok || json.error) {
+            throw new RpcError(json.error?.code ?? 'HTTP', json.error?.message ?? res.statusText, res.status);
+        }
+        return json.result;
+    }
+}
+//# sourceMappingURL=ApiClient.js.map

package/dist/ApiClient.js.map

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

package/dist/CommentEngine.d.ts

@@ -0,0 +1,111 @@
+import type { Comment, Reply, Reaction, ReactionTargetKind, Anchor } from '@pageloop/shared';
+import { ApiClient } from './ApiClient.js';
+import { EventBus } from './EventBus.js';
+/**
+ * Local comment store + CRUD API. Keeps in-memory maps keyed by ids, listens
+ * to server events to stay in sync, and emits client-side `comment:*` /
+ * `reply:*` / `reaction:*` events for UI modules.
+ *
+ * Replies and reactions are loaded lazily — most comments don't have either,
+ * and pre-fetching them all on bootstrap would inflate the payload.
+ */
+export declare class CommentEngine {
+    private readonly api;
+    private readonly bus;
+    private readonly byPage;
+    /** commentId → replies. Populated on demand by loadReplies. */
+    private readonly repliesByComment;
+    /** "${kind}:${id}" → reactions. Populated on demand or via the reactions.changed event. */
+    private readonly reactionsByTarget;
+    constructor(api: ApiClient, bus: EventBus);
+    load(pageId: string): Comment[];
+    loadFromServer(pageId: string): Promise<Comment[]>;
+    /** Create a comment + immediately fold the response into the local
+     *  cache so the sidebar / bubble layer paint without waiting for
+     *  a WS broadcast echo (comments.* events currently route to no
+     *  topic, so the echo never arrives — the local-emit closes the
+     *  refresh-required gap). */
+    create(input: {
+        trackedPageId: string;
+        /** Null/omitted for a "general" (non-anchored, page-level) comment. */
+        anchor?: Anchor | null;
+        bodyMd: string;
+        /** Required when the user is anonymous and the project allows public comments. */
+        guestName?: string;
+    }): Promise<Comment>;
+    /** Append a new comment to the per-page cache + fire the derived
+     *  `comment:created` event. De-dupes against the WS-arrival path
+     *  so a future fan-out wouldn't double-render. */
+    private applyLocalCreate;
+    /** Edit a comment + fold the updated row into the local cache so the
+     *  editor's own change repaints immediately. Same rationale as
+     *  `create`/`delete`: `comments.updated` doesn't route back to the
+     *  editing connection today, so without this local-emit the edited
+     *  body/status sits stale until an unrelated refresh. */
+    update(input: {
+        commentId: string;
+        bodyMd?: string;
+        status?: Comment['status'];
+    }): Promise<Comment>;
+    /** Promote/demote a comment to/from a task, or toggle its completion.
+     *  Gated server-side on write access to the page (any commenter). Folds
+     *  the result into the local cache so the sidebar repaints immediately. */
+    setTask(input: {
+        commentId: string;
+        isTask?: boolean;
+        resolved?: boolean;
+    }): Promise<Comment>;
+    /** Replace a cached comment in place + fire `comment:updated`. Locates
+     *  the page bucket by the comment's own `trackedPageId`; de-dupes so a
+     *  later WS echo re-renders with identical data instead of duplicating. */
+    private applyLocalUpdate;
+    delete(commentId: string): Promise<void>;
+    /** Mirror of `applyLocalCreate` for deletes. The WS `comments.deleted`
+     *  fan-out doesn't route to the deleter's connection right now, so
+     *  without this local-emit the sidebar + bubble layer hold the
+     *  stale row until a page reload. Walks every cached page bucket
+     *  to find the comment because `delete()` doesn't take a page id. */
+    private applyLocalDelete;
+    /** Post a reply + fold it into the cached reply list so the thread
+     *  paints without waiting for a (currently-unrouted) `replies.created`
+     *  echo. Mirrors the comment-create local-emit pattern. */
+    reply(commentId: string, bodyMd: string, guestName?: string): Promise<Reply>;
+    /** Edit a reply + repaint locally. */
+    updateReply(replyId: string, bodyMd: string): Promise<Reply>;
+    /** Delete a reply + drop it from the cached list locally. `replyId` is
+     *  all we have, so walk every cached comment's reply list to find it. */
+    deleteReply(replyId: string): Promise<void>;
+    /** Append a reply to its comment's cached list (de-duped) + emit
+     *  `reply:created`. Only mutates if the list was already loaded; an
+     *  unloaded thread will fetch fresh on next open. */
+    private applyLocalReplyCreate;
+    /** Replace a reply in place within its comment's cached list + emit
+     *  `reply:updated`. */
+    private applyLocalReplyUpdate;
+    /** Remove a reply from whichever comment bucket holds it + emit
+     *  `reply:deleted` with the owning commentId so the sidebar can target
+     *  the right thread. */
+    private applyLocalReplyDelete;
+    /** Cached replies for a comment (or `null` if never loaded). */
+    loadedReplies(commentId: string): Reply[] | null;
+    /** Force-fetch replies for a comment from the server. */
+    fetchReplies(commentId: string): Promise<Reply[]>;
+    /** Cached reactions for a comment or reply (may be stale; use `fetchReactions` to refresh). */
+    loadedReactions(targetKind: ReactionTargetKind, targetId: string): Reaction[];
+    fetchReactions(targetKind: ReactionTargetKind, targetId: string): Promise<Reaction[]>;
+    /**
+     * Toggle a reaction on a comment or reply. Returns the new reaction list
+     * so callers can update UI without waiting for the WS broadcast (the
+     * event also fires asynchronously).
+     */
+    toggleReaction(targetKind: ReactionTargetKind, targetId: string, kind: Reaction['kind']): Promise<Reaction[]>;
+    /** Bulk-clear all comments on a page (editor+ only). Locally drops
+     *  the cached list + fires `comment:bulkDeleted` so the renderer
+     *  repaints without waiting for a (currently-unrouted) WS echo. */
+    bulkDeleteForPage(trackedPageId: string): Promise<{
+        deleted: number;
+    }>;
+    /** Replace the cached list (used from bootstrap). */
+    prime(pageId: string, comments: Comment[]): void;
+}
+//# sourceMappingURL=CommentEngine.d.ts.map

package/dist/CommentEngine.d.ts.map

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