@pageloop/client 0.5.0

package/dist/CommentEngine.js

@@ -0,0 +1,277 @@
+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 class CommentEngine {
+    api;
+    bus;
+    byPage = new Map();
+    /** commentId → replies. Populated on demand by loadReplies. */
+    repliesByComment = new Map();
+    /** "${kind}:${id}" → reactions. Populated on demand or via the reactions.changed event. */
+    reactionsByTarget = new Map();
+    constructor(api, bus) {
+        this.api = api;
+        this.bus = bus;
+        bus.on('comments.created', (event) => {
+            const c = event.comment;
+            const list = this.byPage.get(c.trackedPageId) ?? [];
+            if (!list.find((x) => x.id === c.id))
+                list.push(c);
+            this.byPage.set(c.trackedPageId, list);
+            this.bus.emit('comment:created', c);
+        });
+        bus.on('comments.updated', (event) => {
+            const c = event.comment;
+            const list = this.byPage.get(c.trackedPageId) ?? [];
+            const idx = list.findIndex((x) => x.id === c.id);
+            if (idx >= 0)
+                list[idx] = c;
+            this.byPage.set(c.trackedPageId, list);
+            this.bus.emit('comment:updated', c);
+        });
+        bus.on('comments.deleted', (event) => {
+            const list = this.byPage.get(event.trackedPageId) ?? [];
+            const next = list.filter((x) => x.id !== event.commentId);
+            this.byPage.set(event.trackedPageId, next);
+            this.repliesByComment.delete(event.commentId);
+            this.reactionsByTarget.delete(`comment:${event.commentId}`);
+            this.bus.emit('comment:deleted', { id: event.commentId });
+        });
+        bus.on('comments.bulkDeleted', (event) => {
+            this.byPage.set(event.trackedPageId, []);
+            this.bus.emit('comment:bulkDeleted', event);
+        });
+        bus.on('replies.created', (event) => {
+            const reply = event.reply;
+            const existing = this.repliesByComment.get(reply.commentId) ?? [];
+            if (!existing.find((r) => r.id === reply.id))
+                existing.push(reply);
+            this.repliesByComment.set(reply.commentId, existing);
+            this.bus.emit('reply:created', reply);
+        });
+        bus.on('replies.updated', (event) => {
+            const reply = event.reply;
+            const existing = this.repliesByComment.get(reply.commentId);
+            if (existing) {
+                const idx = existing.findIndex((r) => r.id === reply.id);
+                if (idx >= 0)
+                    existing[idx] = reply;
+                this.repliesByComment.set(reply.commentId, existing);
+            }
+            this.bus.emit('reply:updated', reply);
+        });
+        bus.on('replies.deleted', (event) => {
+            const list = this.repliesByComment.get(event.commentId);
+            if (list) {
+                this.repliesByComment.set(event.commentId, list.filter((r) => r.id !== event.replyId));
+            }
+            this.bus.emit('reply:deleted', { id: event.replyId, commentId: event.commentId });
+        });
+        bus.on('reactions.changed', (event) => {
+            this.reactionsByTarget.set(`${event.targetKind}:${event.targetId}`, event.reactions);
+            this.bus.emit('reaction:changed', event);
+        });
+    }
+    load(pageId) {
+        return this.byPage.get(pageId) ?? [];
+    }
+    async loadFromServer(pageId) {
+        const comments = await this.api.call('comments.list', { trackedPageId: pageId });
+        this.byPage.set(pageId, comments);
+        this.bus.emit('comments:loaded', { pageId, comments });
+        return comments;
+    }
+    /** 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). */
+    async create(input) {
+        const created = await this.api.call('comments.create', input);
+        this.applyLocalCreate(created);
+        return created;
+    }
+    /** 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. */
+    applyLocalCreate(c) {
+        const list = this.byPage.get(c.trackedPageId) ?? [];
+        if (!list.find((x) => x.id === c.id)) {
+            list.push(c);
+            this.byPage.set(c.trackedPageId, list);
+        }
+        this.bus.emit('comment:created', c);
+    }
+    /** 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. */
+    async update(input) {
+        const updated = await this.api.call('comments.update', input);
+        this.applyLocalUpdate(updated);
+        return updated;
+    }
+    /** 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. */
+    async setTask(input) {
+        const updated = await this.api.call('comments.setTask', input);
+        this.applyLocalUpdate(updated);
+        return updated;
+    }
+    /** 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. */
+    applyLocalUpdate(c) {
+        const list = this.byPage.get(c.trackedPageId) ?? [];
+        const idx = list.findIndex((x) => x.id === c.id);
+        if (idx >= 0)
+            list[idx] = c;
+        else
+            list.push(c);
+        this.byPage.set(c.trackedPageId, list);
+        this.bus.emit('comment:updated', c);
+    }
+    async delete(commentId) {
+        await this.api.call('comments.delete', { commentId });
+        this.applyLocalDelete(commentId);
+    }
+    /** 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. */
+    applyLocalDelete(commentId) {
+        let trackedPageId = null;
+        for (const [pageId, list] of this.byPage) {
+            if (list.some((c) => c.id === commentId)) {
+                trackedPageId = pageId;
+                this.byPage.set(pageId, list.filter((c) => c.id !== commentId));
+                break;
+            }
+        }
+        this.repliesByComment.delete(commentId);
+        this.reactionsByTarget.delete(`comment:${commentId}`);
+        this.bus.emit('comment:deleted', { id: commentId, trackedPageId });
+    }
+    /** 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. */
+    async reply(commentId, bodyMd, guestName) {
+        const created = await this.api.call('replies.create', { commentId, bodyMd, guestName });
+        this.applyLocalReplyCreate(created);
+        return created;
+    }
+    /** Edit a reply + repaint locally. */
+    async updateReply(replyId, bodyMd) {
+        const updated = await this.api.call('replies.update', { replyId, bodyMd });
+        this.applyLocalReplyUpdate(updated);
+        return updated;
+    }
+    /** 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. */
+    async deleteReply(replyId) {
+        await this.api.call('replies.delete', { replyId });
+        this.applyLocalReplyDelete(replyId);
+    }
+    /** 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. */
+    applyLocalReplyCreate(reply) {
+        const existing = this.repliesByComment.get(reply.commentId);
+        if (existing) {
+            if (!existing.find((r) => r.id === reply.id))
+                existing.push(reply);
+            this.repliesByComment.set(reply.commentId, existing);
+        }
+        this.bus.emit('reply:created', reply);
+    }
+    /** Replace a reply in place within its comment's cached list + emit
+     *  `reply:updated`. */
+    applyLocalReplyUpdate(reply) {
+        const existing = this.repliesByComment.get(reply.commentId);
+        if (existing) {
+            const idx = existing.findIndex((r) => r.id === reply.id);
+            if (idx >= 0)
+                existing[idx] = reply;
+            this.repliesByComment.set(reply.commentId, existing);
+        }
+        this.bus.emit('reply:updated', reply);
+    }
+    /** Remove a reply from whichever comment bucket holds it + emit
+     *  `reply:deleted` with the owning commentId so the sidebar can target
+     *  the right thread. */
+    applyLocalReplyDelete(replyId) {
+        let commentId = null;
+        for (const [cid, list] of this.repliesByComment) {
+            if (list.some((r) => r.id === replyId)) {
+                commentId = cid;
+                this.repliesByComment.set(cid, list.filter((r) => r.id !== replyId));
+                break;
+            }
+        }
+        this.bus.emit('reply:deleted', { id: replyId, commentId });
+    }
+    /** Cached replies for a comment (or `null` if never loaded). */
+    loadedReplies(commentId) {
+        return this.repliesByComment.get(commentId) ?? null;
+    }
+    /** Force-fetch replies for a comment from the server. */
+    async fetchReplies(commentId) {
+        const replies = await this.api.call('replies.list', { commentId });
+        this.repliesByComment.set(commentId, replies);
+        return replies;
+    }
+    /** Cached reactions for a comment or reply (may be stale; use `fetchReactions` to refresh). */
+    loadedReactions(targetKind, targetId) {
+        return this.reactionsByTarget.get(`${targetKind}:${targetId}`) ?? [];
+    }
+    async fetchReactions(targetKind, targetId) {
+        const reactions = await this.api.call('reactions.list', { targetKind, targetId });
+        this.reactionsByTarget.set(`${targetKind}:${targetId}`, reactions);
+        return reactions;
+    }
+    /**
+     * 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).
+     */
+    async toggleReaction(targetKind, targetId, kind) {
+        const result = await this.api.call('reactions.toggle', { targetKind, targetId, kind });
+        this.reactionsByTarget.set(`${targetKind}:${targetId}`, result.reactions);
+        // Immediately notify listeners (renderer / chat panel) so the
+        // local tab repaints without waiting for the WS broadcast echo.
+        // The WS path also feeds this same channel — duplicate events
+        // are cheap (listeners just re-render with the same cached
+        // data) and the local emit guarantees the user who toggled
+        // sees their pill update.
+        this.bus.emit('reaction:changed', {
+            targetKind,
+            targetId,
+            reactions: result.reactions,
+        });
+        return result.reactions;
+    }
+    /** 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. */
+    async bulkDeleteForPage(trackedPageId) {
+        const result = await this.api.call('comments.bulkDelete', { trackedPageId });
+        this.byPage.set(trackedPageId, []);
+        this.bus.emit('comment:bulkDeleted', { trackedPageId, deleted: result.deleted });
+        return result;
+    }
+    /** Replace the cached list (used from bootstrap). */
+    prime(pageId, comments) {
+        this.byPage.set(pageId, comments);
+    }
+}
+//# sourceMappingURL=CommentEngine.js.map

package/dist/CommentEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentEngine.js","sourceRoot":"","sources":["../src/CommentEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IAQP;IACA;IARD,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IACvD,+DAA+D;IAC9C,gBAAgB,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC/D,2FAA2F;IAC1E,iBAAiB,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEnE,YACkB,GAAc,EACd,GAAa;QADb,QAAG,GAAH,GAAG,CAAW;QACd,QAAG,GAAH,GAAG,CAAU;QAE9B,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,KAAU,EAAE,EAAE;YACzC,MAAM,CAAC,GAAY,KAAK,CAAC,OAAO,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,KAAU,EAAE,EAAE;YACzC,MAAM,CAAC,GAAY,KAAK,CAAC,OAAO,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACjD,IAAI,GAAG,IAAI,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,KAAU,EAAE,EAAE;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;YAC1D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC9C,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,KAAU,EAAE,EAAE;YAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,KAAU,EAAE,EAAE;YACxC,MAAM,KAAK,GAAU,KAAK,CAAC,KAAK,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAClE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,KAAU,EAAE,EAAE;YACxC,MAAM,KAAK,GAAU,KAAK,CAAC,KAAK,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC5D,IAAI,QAAQ,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzD,IAAI,GAAG,IAAI,CAAC;oBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACpC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACtD,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,KAAU,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,gBAAgB,CAAC,GAAG,CACxB,KAAK,CAAC,SAAS,EACf,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,CAC1C,CAAC;YACH,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAU,EAAE,EAAE;YAC1C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACrF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAc;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;;;iCAI6B;IAC7B,KAAK,CAAC,MAAM,CAAC,KAOZ;QACA,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;sDAEkD;IAC1C,gBAAgB,CAAC,CAAU;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAED;;;;6DAIyD;IACzD,KAAK,CAAC,MAAM,CAAC,KAIZ;QACA,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;+EAE2E;IAC3E,KAAK,CAAC,OAAO,CAAC,KAIb;QACA,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;+EAE2E;IACnE,gBAAgB,CAAC,CAAU;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,GAAG,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;YACvB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC7B,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;yEAIqE;IAC7D,gBAAgB,CAAC,SAAiB;QACzC,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC;gBAC1C,aAAa,GAAG,MAAM,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC;gBAChE,MAAM;YACP,CAAC;QACF,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;+DAE2D;IAC3D,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,MAAc,EAAE,SAAkB;QAChE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAAc;QAChD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;6EACyE;IACzE,KAAK,CAAC,WAAW,CAAC,OAAe;QAChC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;yDAEqD;IAC7C,qBAAqB,CAAC,KAAY;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;2BACuB;IACf,qBAAqB,CAAC,KAAY;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,GAAG,IAAI,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACpC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;4BAEwB;IAChB,qBAAqB,CAAC,OAAe;QAC5C,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;gBACxC,SAAS,GAAG,GAAG,CAAC;gBAChB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC;gBACrE,MAAM;YACP,CAAC;QACF,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,gEAAgE;IAChE,aAAa,CAAC,SAAiB;QAC9B,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IACrD,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,YAAY,CAAC,SAAiB;QACnC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,+FAA+F;IAC/F,eAAe,CAAC,UAA8B,EAAE,QAAgB;QAC/D,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAA8B,EAAE,QAAgB;QACpE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC;QACnE,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CACnB,UAA8B,EAC9B,QAAgB,EAChB,IAAsB;QAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,QAAQ,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1E,8DAA8D;QAC9D,gEAAgE;QAChE,8DAA8D;QAC9D,2DAA2D;QAC3D,2DAA2D;QAC3D,0BAA0B;QAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;YACjC,UAAU;YACV,QAAQ;YACR,SAAS,EAAE,MAAM,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,SAAS,CAAC;IACzB,CAAC;IAED;;uEAEmE;IACnE,KAAK,CAAC,iBAAiB,CAAC,aAAqB;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,OAAO,MAAM,CAAC;IACf,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,MAAc,EAAE,QAAmB;QACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;CACD"}

package/dist/EventBus.d.ts

@@ -0,0 +1,122 @@
+import type { ServerEvent } from '@pageloop/shared';
+export type ClientEventName = 'page:change' | 'page:resolved' | 'comments:loaded' | 'comment:created' | 'comment:updated' | 'comment:deleted' | 'comment:bulkDeleted' | 'reply:created' | 'reply:updated' | 'reply:deleted' | 'reaction:changed' | 'auth:changed' | 'project:updated' | 'connection:open' | 'connection:closed'
+/** Emitted by ApiClient between a dropped WebSocket and the next dial
+ *  attempt while exponential-backoff reconnect is in flight. Drives the
+ *  3-state connection pill (CR-8): connected / reconnecting / offline. */
+ | 'connection:reconnecting' | 'sidebar:toggle'
+/** UI-only request from an empty-state CTA to start the element picker
+ *  (CR-6). Renderer listens + toggles its picker; keeps the sidebar
+ *  tab decoupled from the picker instance. */
+ | 'sidebar:request-pick' | 'bubbles:toggle'
+/** User changed their bubble colour from the widget settings panel.
+ *  Renderers re-tint the bubble CSS vars live; PageLoop updates its
+ *  cached `bubbleColor()` so reopening the panel shows the new value.
+ *  `color: null` clears back to the stylesheet default. */
+ | 'bubbles:recolor' | 'toast:show'
+/** Structured error channel — every catch site that surfaces a user-
+ *  visible failure should also emit this so embedders can wire it to
+ *  their own observability layer. The toast is the user-facing
+ *  artifact; `pl-error` is the machine-readable artifact. */
+ | 'pl-error'
+/** Server-driven config changed (bootstrap revalidate or live admin
+ *  edit). Renderers re-apply cheap knobs like theme; layout knobs
+ *  take effect on the next reload. */
+ | 'config:changed'
+/** Live-chat manager → renderer events. Payloads are intentionally
+ *  `unknown` at the bus level (rich types live on ChatManager); the
+ *  renderer casts at the listener site. */
+ | 'chat:room-changed' | 'chat:history-loaded' | 'chat:message-appended' | 'chat:presence-updated' | 'chat:settings-changed' | 'chat:known-rooms-changed' | 'chat:current-page-drift' | 'chat:typing-updated' | 'chat:older-loading' | 'chat:older-loaded' | 'chat:read-state-updated'
+/** Fired by the bubble layer at the end of every anchor-resolve
+ *  pass. Payload: `{ ids: Set<string> }` listing comments whose
+ *  anchor couldn't be matched against the current DOM. Sidebar
+ *  renderers subscribe to mark those comment rows as "no anchor". */
+ | 'bubbles:dangling' | ServerEvent['name'];
+/**
+ * Payload of the `pl-error` bus event. Mirrors a typical observability
+ * sink shape (a `captureException`-style report) so embedders don't
+ * need to translate.
+ */
+export interface PageLoopErrorPayload {
+    /** Where the error happened — short, stable identifier. Stable
+     *  enough to use as an error-grouping fingerprint (e.g. `comment.create`,
+     *  `reply.delete`, `versions.list`). */
+    operation: string;
+    /** Coarse classification — lets consumers route or filter. */
+    code?: 'network' | 'auth' | 'validation' | 'plan-limit' | 'rate-limit' | 'unknown';
+    /** Human-readable summary, safe to display to end users. */
+    message: string;
+    /** Underlying error object if available — preserved for stack
+     *  traces / native message. */
+    cause?: unknown;
+    /** Free-form metadata. Avoid stuffing PII; this WILL ship to
+     *  whatever sink the embedder configures. */
+    extra?: Record<string, unknown>;
+}
+export type ClientEventHandler = (payload: any) => void;
+/**
+ * Type-level map from event name → payload shape. Adding an entry here
+ * gives every `bus.on(name, ...)` / `bus.emit(name, ...)` callsite
+ * strong static typing on the payload. Events not listed default to
+ * `unknown` so the bus stays back-compatible with the existing
+ * dozens of ad-hoc emitters — new emitters get safety, old ones
+ * still compile.
+ *
+ * Goal is to migrate every entry in `ClientEventName` here over time;
+ * this map is the foundation for that.
+ */
+export interface EventMap {
+    'connection:open': {
+        transport: 'ws' | 'sse' | 'rest';
+    };
+    'connection:closed': {
+        transport?: 'ws' | 'sse' | 'rest';
+        reason?: string;
+    };
+    /** `attempt` is 1-based; `delayMs` is the backoff window before the
+     *  next dial. Lets a UI surface a "retrying in Ns" affordance. */
+    'connection:reconnecting': {
+        attempt: number;
+        delayMs: number;
+    };
+    'sidebar:toggle': {
+        visible: boolean;
+    };
+    'bubbles:toggle': {
+        visible: boolean;
+    };
+    'bubbles:recolor': {
+        color: string | null;
+    };
+    'toast:show': {
+        kind: 'success' | 'error' | 'info' | 'warn';
+        message: string;
+        title?: string;
+    };
+    'pl-error': PageLoopErrorPayload;
+    'page:change': {
+        url: string;
+        key: string;
+    };
+}
+/** Resolve a payload type for an event name — strict when known,
+ *  `unknown` for ad-hoc events. */
+export type PayloadOf<K extends string> = K extends keyof EventMap ? EventMap[K] : unknown;
+/**
+ * Tiny pub/sub for cross-module communication on the client. Server-emitted
+ * events arrive via the ApiClient and are re-emitted here so UI modules can
+ * subscribe without knowing about the transport.
+ *
+ * Two overloaded call signatures:
+ *   - Typed: `bus.on('connection:open', e => e.transport)` — `e` is
+ *     `EventMap['connection:open']`.
+ *   - Untyped: `bus.on('something:custom', e => ...)` — `e` is
+ *     `unknown`; cast at the use site or add the event to `EventMap`.
+ */
+export declare class EventBus {
+    private readonly listeners;
+    on<K extends keyof EventMap>(name: K, handler: (payload: EventMap[K]) => void): () => void;
+    on(name: ClientEventName, handler: ClientEventHandler): () => void;
+    emit<K extends keyof EventMap>(name: K, payload: EventMap[K]): void;
+    emit(name: ClientEventName, payload: unknown): void;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/EventBus.d.ts.map

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

package/dist/EventBus.js

@@ -0,0 +1,34 @@
+/**
+ * Tiny pub/sub for cross-module communication on the client. Server-emitted
+ * events arrive via the ApiClient and are re-emitted here so UI modules can
+ * subscribe without knowing about the transport.
+ *
+ * Two overloaded call signatures:
+ *   - Typed: `bus.on('connection:open', e => e.transport)` — `e` is
+ *     `EventMap['connection:open']`.
+ *   - Untyped: `bus.on('something:custom', e => ...)` — `e` is
+ *     `unknown`; cast at the use site or add the event to `EventMap`.
+ */
+export class EventBus {
+    listeners = new Map();
+    on(name, handler) {
+        const set = this.listeners.get(name) ?? new Set();
+        set.add(handler);
+        this.listeners.set(name, set);
+        return () => set.delete(handler);
+    }
+    emit(name, payload) {
+        const set = this.listeners.get(name);
+        if (!set)
+            return;
+        for (const fn of set) {
+            try {
+                fn(payload);
+            }
+            catch {
+                // listener errors must not break the bus
+            }
+        }
+    }
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../src/EventBus.ts"],"names":[],"mappings":"AA4HA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,QAAQ;IACH,SAAS,GAAG,IAAI,GAAG,EAAmC,CAAC;IAIxE,EAAE,CAAC,IAAY,EAAE,OAA2B;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAID,IAAI,CAAC,IAAY,EAAE,OAAgB;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC;gBACJ,EAAE,CAAC,OAAO,CAAC,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACR,yCAAyC;YAC1C,CAAC;QACF,CAAC;IACF,CAAC;CACD"}

package/dist/IdbCache.d.ts

@@ -0,0 +1,22 @@
+import type { Comment, TrackedPage } from '@pageloop/shared';
+/**
+ * IndexedDB-backed read-through cache for pages and comments. The SDK consults
+ * the cache before hitting the network so cold reloads of the same page show
+ * comments instantly while a fresh fetch reconciles in the background.
+ *
+ * Keys are namespaced by projectId so a single browser handling multiple
+ * PageLoop deployments stays isolated. Entries carry a `cachedAt` timestamp;
+ * the SDK doesn't TTL them — cache is invalidated by server events instead.
+ */
+export declare class IdbCache {
+    private dbPromise;
+    private dbName;
+    constructor(projectId: string);
+    private db;
+    getPage(key: string): Promise<TrackedPage | null>;
+    putPage(page: TrackedPage): Promise<void>;
+    getComments(pageId: string): Promise<Comment[] | null>;
+    putComments(pageId: string, comments: Comment[]): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=IdbCache.d.ts.map

package/dist/IdbCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdbCache.d.ts","sourceRoot":"","sources":["../src/IdbCache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,EAAE,MAAM;IAI7B,OAAO,CAAC,EAAE;IAcJ,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUjD,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAUtD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS5B"}

package/dist/IdbCache.js

@@ -0,0 +1,79 @@
+import { openDB } from 'idb';
+/**
+ * IndexedDB-backed read-through cache for pages and comments. The SDK consults
+ * the cache before hitting the network so cold reloads of the same page show
+ * comments instantly while a fresh fetch reconciles in the background.
+ *
+ * Keys are namespaced by projectId so a single browser handling multiple
+ * PageLoop deployments stays isolated. Entries carry a `cachedAt` timestamp;
+ * the SDK doesn't TTL them — cache is invalidated by server events instead.
+ */
+export class IdbCache {
+    dbPromise = null;
+    dbName;
+    constructor(projectId) {
+        this.dbName = `pageloop:${projectId}`;
+    }
+    db() {
+        if (!this.dbPromise) {
+            this.dbPromise = openDB(this.dbName, 1, {
+                upgrade(db) {
+                    if (!db.objectStoreNames.contains('pages'))
+                        db.createObjectStore('pages', { keyPath: 'key' });
+                    if (!db.objectStoreNames.contains('comments'))
+                        db.createObjectStore('comments', { keyPath: 'pageId' });
+                },
+            });
+        }
+        return this.dbPromise;
+    }
+    async getPage(key) {
+        try {
+            const db = await this.db();
+            const row = await db.get('pages', key);
+            return row?.page ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async putPage(page) {
+        try {
+            const db = await this.db();
+            await db.put('pages', { key: page.key, page, cachedAt: Date.now() });
+        }
+        catch {
+            // IDB unavailable (private mode, quota); silent fall-through.
+        }
+    }
+    async getComments(pageId) {
+        try {
+            const db = await this.db();
+            const row = await db.get('comments', pageId);
+            return row?.comments ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async putComments(pageId, comments) {
+        try {
+            const db = await this.db();
+            await db.put('comments', { pageId, comments, cachedAt: Date.now() });
+        }
+        catch {
+            // ignore
+        }
+    }
+    async clear() {
+        try {
+            const db = await this.db();
+            await db.clear('pages');
+            await db.clear('comments');
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=IdbCache.js.map

package/dist/IdbCache.js.map

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