@voltro/plugin-comments 0.54.0 → 0.56.0

package/dist/index.js

@@ -1,52 +1,52 @@
 import { CommentAccessRefused as e, CommentNotFound as t, CommentNotYours as n } from "./errors.js";
-import { commentsFeed as r, commentsRpcClientImports as i, createDescriptor as a, deleteDescriptor as o, editDescriptor as s, listDescriptor as c, markReadDescriptor as l, mentionSearchDescriptor as u, reactDescriptor as d, resolveDescriptor as f } from "./rpc.js";
-import { Effect as p, Option as m } from "effect";
-import { and as h, eq as g, generateId as _, id as v, json as y, table as b, text as x, timestamp as S } from "@voltro/database";
-import { definePlugin as C, pluginInstanceName as w, publishReactivity as T } from "@voltro/protocol";
-import { NotificationService as E } from "@voltro/plugin-notifications";
+import { BASE_NAME as r, commentsFeed as i, commentsRpcClientImports as a, createDescriptor as o, deleteDescriptor as s, editDescriptor as c, listDescriptor as l, markReadDescriptor as u, mentionSearchDescriptor as d, reactDescriptor as f, resolveDescriptor as p } from "./rpc.js";
+import { Effect as m, Option as h } from "effect";
+import { and as g, eq as _, generateId as v, id as y, json as b, table as x, text as S, timestamp as C } from "@voltro/database";
+import { definePlugin as w, pluginInstanceName as T, publishReactivity as E } from "@voltro/protocol";
+import { NotificationService as D } from "@voltro/plugin-notifications";
 //#region src/index.ts
-var D = b("_voltro_comment_threads", {
-	id: v({ prefix: "cmtthr" }),
-	anchor: x(),
-	status: x().default("open"),
-	createdBy: x(),
-	createdAt: S().default("now"),
-	tenantId: x().nullable()
-}).index("byThreadAnchor", ["anchor", "tenantId"]), O = b("_voltro_comments", {
-	id: v({ prefix: "cmt" }),
-	threadId: x(),
-	body: x(),
-	authorSubjectId: x(),
-	mentions: y(),
-	editedAt: S().nullable(),
-	createdAt: S().default("now"),
-	tenantId: x().nullable()
-}).index("byCommentThread", ["threadId"]), k = b("_voltro_comment_reactions", {
-	id: v({ prefix: "cmtrx" }),
-	commentId: x(),
-	subjectId: x(),
-	emoji: x()
+var O = x("_voltro_comment_threads", {
+	id: y({ prefix: "cmtthr" }),
+	anchor: S(),
+	status: S().default("open"),
+	createdBy: S(),
+	createdAt: C().default("now"),
+	tenantId: S().nullable()
+}).index("byThreadAnchor", ["anchor", "tenantId"]), k = x("_voltro_comments", {
+	id: y({ prefix: "cmt" }),
+	threadId: S(),
+	body: S(),
+	authorSubjectId: S(),
+	mentions: b(),
+	editedAt: C().nullable(),
+	createdAt: C().default("now"),
+	tenantId: S().nullable()
+}).index("byCommentThread", ["threadId"]), A = x("_voltro_comment_reactions", {
+	id: y({ prefix: "cmtrx" }),
+	commentId: S(),
+	subjectId: S(),
+	emoji: S()
 }).unique("byReactionIdentity", [
 	"commentId",
 	"subjectId",
 	"emoji"
-]).index("byReactionComment", ["commentId"]), A = b("_voltro_comment_reads", {
-	id: v({ prefix: "cmtread" }),
-	threadId: x(),
-	subjectId: x(),
-	lastReadAt: S()
-}).unique("byReadThreadSubject", ["threadId", "subjectId"]), j = "@voltro/plugin-comments", M = (e) => {
+]).index("byReactionComment", ["commentId"]), j = x("_voltro_comment_reads", {
+	id: y({ prefix: "cmtread" }),
+	threadId: S(),
+	subjectId: S(),
+	lastReadAt: C()
+}).unique("byReadThreadSubject", ["threadId", "subjectId"]), M = r, N = (e) => {
 	let t = e.request.subject ?? {};
 	return {
 		id: t.id ?? null,
 		tenantId: t.tenantId ?? null,
 		scopes: t.scopes ?? []
 	};
-}, N = (v = {}) => {
-	let y = w({
-		base: j,
-		alias: v.alias,
-		instance: v.name
+}, P = (r = {}) => {
+	let y = T({
+		base: M,
+		alias: r.alias,
+		instance: r.name
 	}), b, x, S = async (e, t, n) => b === void 0 ? [] : b.query({
 		table: e,
 		predicate: t,
@@ -54,40 +54,40 @@ var D = b("_voltro_comment_threads", {
 		take: n,
 		skip: void 0,
 		projection: void 0
-	}), N = () => {
-		T(x, r);
-	}, P = (t, n) => p.gen(function* () {
-		let r = M(n);
-		return v.access?.viaEntity === void 0 ? v.access?.scope === void 0 ? yield* p.fail(new e({
+	}), C = () => {
+		E(x, i);
+	}, P = (t, n) => m.gen(function* () {
+		let i = N(n);
+		return r.access?.viaEntity === void 0 ? r.access?.scope === void 0 ? yield* m.fail(new e({
 			anchor: t,
 			reason: "no access rule declared — set commentsPlugin({ access: { viaEntity } }) or { access: { scope } }"
-		})) : r.scopes.includes(v.access.scope) ? void 0 : yield* p.fail(new e({
+		})) : i.scopes.includes(r.access.scope) ? void 0 : yield* m.fail(new e({
 			anchor: t,
-			reason: `missing scope '${v.access.scope}'`
-		})) : (yield* p.promise(async () => {
+			reason: `missing scope '${r.access.scope}'`
+		})) : (yield* m.promise(async () => {
 			try {
-				return await v.access.viaEntity({
+				return await r.access.viaEntity({
 					anchor: t,
-					subject: r,
+					subject: i,
 					store: b
 				});
 			} catch {
 				return !1;
 			}
-		})) ? void 0 : yield* p.fail(new e({
+		})) ? void 0 : yield* m.fail(new e({
 			anchor: t,
 			reason: "the anchored entity is not readable by this caller (or no longer available)"
 		}));
-	}), F = async (e) => (await S("_voltro_comment_threads", g("id", e), 1))[0], I = (e) => e instanceof Date ? e.toISOString() : typeof e == "string" ? e : "", L = (e) => p.gen(function* () {
+	}), F = async (e) => (await S("_voltro_comment_threads", _("id", e), 1))[0], I = (e) => e instanceof Date ? e.toISOString() : typeof e == "string" ? e : "", L = (e) => m.gen(function* () {
 		if (e.mentions.length === 0) return;
-		let t = yield* p.serviceOption(E);
-		if (m.isNone(t)) {
-			yield* p.logInfo("comments: mention recorded without notification — @voltro/plugin-notifications is not configured");
+		let t = yield* m.serviceOption(D);
+		if (h.isNone(t)) {
+			yield* m.logInfo("comments: mention recorded without notification — @voltro/plugin-notifications is not configured");
 			return;
 		}
-		for (let n of e.mentions) n !== e.author && (yield* p.promise(() => t.value.send({
+		for (let n of e.mentions) n !== e.author && (yield* m.promise(() => t.value.send({
 			to: n,
-			category: v.mentionCategory ?? "mention",
+			category: r.mentionCategory ?? "mention",
 			title: "You were mentioned",
 			body: e.body.length > 200 ? `${e.body.slice(0, 200)}…` : e.body,
 			data: {
@@ -97,24 +97,24 @@ var D = b("_voltro_comment_threads", {
 			tenantId: e.tenantId
 		}).then(() => void 0).catch(() => void 0)));
 	}), R = async (e, t) => {
-		if (e.length === 0 || v.resolveMentions === void 0) return [];
+		if (e.length === 0 || r.resolveMentions === void 0) return [];
 		let n = [];
-		for (let r of [...new Set(e)].slice(0, 20)) {
-			let e = (await v.resolveMentions({
-				query: r,
+		for (let i of [...new Set(e)].slice(0, 20)) {
+			let e = (await r.resolveMentions({
+				query: i,
 				subject: t
-			}).catch(() => [])).find((e) => e.subjectId === r);
-			e !== void 0 && (v.crossTenant === !0 || e.tenantId === void 0 || e.tenantId === null || e.tenantId === t.tenantId) && n.push(r);
+			}).catch(() => [])).find((e) => e.subjectId === i);
+			e !== void 0 && (r.crossTenant === !0 || e.tenantId === void 0 || e.tenantId === null || e.tenantId === t.tenantId) && n.push(i);
 		}
 		return n;
 	}, z = async (e, t, n) => {
-		let r = await S("_voltro_comment_threads", h(g("anchor", e), g("tenantId", t))), i = [];
+		let r = await S("_voltro_comment_threads", g(_("anchor", e), _("tenantId", t))), i = [];
 		for (let e of r) {
-			let t = [...await S("_voltro_comments", g("threadId", String(e.id)))];
+			let t = [...await S("_voltro_comments", _("threadId", String(e.id)))];
 			t.sort((e, t) => I(e.createdAt) < I(t.createdAt) ? -1 : 1);
-			let r = n === null ? [] : await S("_voltro_comment_reads", h(g("threadId", String(e.id)), g("subjectId", n)), 1), a = r[0] ? I(r[0].lastReadAt) : "", o = [];
+			let r = n === null ? [] : await S("_voltro_comment_reads", g(_("threadId", String(e.id)), _("subjectId", n)), 1), a = r[0] ? I(r[0].lastReadAt) : "", o = [];
 			for (let e of t) {
-				let t = await S("_voltro_comment_reactions", g("commentId", String(e.id))), r = /* @__PURE__ */ new Map();
+				let t = await S("_voltro_comment_reactions", _("commentId", String(e.id))), r = /* @__PURE__ */ new Map();
 				for (let e of t) {
 					let t = r.get(String(e.emoji)) ?? {
 						count: 0,
@@ -150,31 +150,31 @@ var D = b("_voltro_comment_threads", {
 		return i.sort((e, t) => String(e.createdAt) < String(t.createdAt) ? -1 : 1), i;
 	}, B = "comments:moderate", V = [
 		{
-			...c,
+			...l,
 			description: "Threads + comments + reactions + unread for one anchor, live.",
-			execute: (e, t) => p.gen(function* () {
+			execute: (e, t) => m.gen(function* () {
 				let { anchor: n } = e;
 				yield* P(n, t);
-				let r = M(t);
-				return yield* p.promise(() => z(n, r.tenantId, r.id));
+				let r = N(t);
+				return yield* m.promise(() => z(n, r.tenantId, r.id));
 			})
 		},
 		{
-			...a,
+			...o,
 			description: "Comment on an anchor — a reply into a thread, or a new thread.",
-			execute: (e, n) => p.gen(function* () {
+			execute: (e, n) => m.gen(function* () {
 				let r = e;
 				yield* P(r.anchor, n);
-				let i = M(n), a = i.id ?? "anonymous", o = b;
-				if (o === void 0) return yield* p.fail(new t({ id: r.anchor }));
+				let i = N(n), a = i.id ?? "anonymous", o = b;
+				if (o === void 0) return yield* m.fail(new t({ id: r.anchor }));
 				let s = r.threadId;
 				if (s !== void 0) {
-					let e = yield* p.promise(() => F(s));
-					if (e === void 0 || String(e.anchor) !== r.anchor) return yield* p.fail(new t({ id: s }));
-				} else s = _({
+					let e = yield* m.promise(() => F(s));
+					if (e === void 0 || String(e.anchor) !== r.anchor) return yield* m.fail(new t({ id: s }));
+				} else s = v({
 					kind: "typeid",
 					prefix: "cmtthr"
-				}, "_voltro_comment_threads"), yield* p.promise(() => o.insert("_voltro_comment_threads", {
+				}, "_voltro_comment_threads"), yield* m.promise(() => o.insert("_voltro_comment_threads", {
 					id: s,
 					anchor: r.anchor,
 					status: "open",
@@ -182,11 +182,11 @@ var D = b("_voltro_comment_threads", {
 					createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 					tenantId: i.tenantId
 				}));
-				let c = yield* p.promise(() => R(r.mentions ?? [], i)), l = _({
+				let c = yield* m.promise(() => R(r.mentions ?? [], i)), l = v({
 					kind: "typeid",
 					prefix: "cmt"
 				}, "_voltro_comments");
-				return yield* p.promise(() => o.insert("_voltro_comments", {
+				return yield* m.promise(() => o.insert("_voltro_comments", {
 					id: l,
 					threadId: s,
 					body: r.body,
@@ -195,7 +195,7 @@ var D = b("_voltro_comment_threads", {
 					editedAt: null,
 					createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 					tenantId: i.tenantId
-				})), N(), yield* L({
+				})), C(), yield* L({
 					mentions: c,
 					author: a,
 					anchor: r.anchor,
@@ -209,76 +209,76 @@ var D = b("_voltro_comment_threads", {
 			})
 		},
 		{
-			...s,
+			...c,
 			description: "Edit your own comment.",
-			execute: (e, r) => p.gen(function* () {
-				let i = e, a = (yield* p.promise(() => S("_voltro_comments", g("id", i.commentId), 1)))[0];
-				if (a === void 0) return yield* p.fail(new t({ id: i.commentId }));
-				let o = yield* p.promise(() => F(String(a.threadId)));
-				return o === void 0 ? yield* p.fail(new t({ id: i.commentId })) : (yield* P(String(o.anchor), r), String(a.authorSubjectId) === (M(r).id ?? "anonymous") ? (yield* p.promise(() => b.update("_voltro_comments", i.commentId, {
+			execute: (e, r) => m.gen(function* () {
+				let i = e, a = (yield* m.promise(() => S("_voltro_comments", _("id", i.commentId), 1)))[0];
+				if (a === void 0) return yield* m.fail(new t({ id: i.commentId }));
+				let o = yield* m.promise(() => F(String(a.threadId)));
+				return o === void 0 ? yield* m.fail(new t({ id: i.commentId })) : (yield* P(String(o.anchor), r), String(a.authorSubjectId) === (N(r).id ?? "anonymous") ? (yield* m.promise(() => b.update("_voltro_comments", i.commentId, {
 					body: i.body,
 					editedAt: (/* @__PURE__ */ new Date()).toISOString()
-				})), N(), { ok: !0 }) : yield* p.fail(new n({ id: i.commentId })));
+				})), C(), { ok: !0 }) : yield* m.fail(new n({ id: i.commentId })));
 			})
 		},
 		{
-			...f,
+			...p,
 			description: "Resolve or reopen a thread.",
-			execute: (e, n) => p.gen(function* () {
-				let r = e, i = yield* p.promise(() => F(r.threadId));
-				return i === void 0 ? yield* p.fail(new t({ id: r.threadId })) : (yield* P(String(i.anchor), n), yield* p.promise(() => b.update("_voltro_comment_threads", r.threadId, { status: r.resolved ? "resolved" : "open" })), N(), { ok: !0 });
+			execute: (e, n) => m.gen(function* () {
+				let r = e, i = yield* m.promise(() => F(r.threadId));
+				return i === void 0 ? yield* m.fail(new t({ id: r.threadId })) : (yield* P(String(i.anchor), n), yield* m.promise(() => b.update("_voltro_comment_threads", r.threadId, { status: r.resolved ? "resolved" : "open" })), C(), { ok: !0 });
 			})
 		},
 		{
-			...o,
+			...s,
 			description: "Delete your own comment (comments:moderate deletes any).",
-			execute: (e, r) => p.gen(function* () {
-				let i = e, a = (yield* p.promise(() => S("_voltro_comments", g("id", i.commentId), 1)))[0];
-				if (a === void 0) return yield* p.fail(new t({ id: i.commentId }));
-				let o = yield* p.promise(() => F(String(a.threadId)));
-				if (o === void 0) return yield* p.fail(new t({ id: i.commentId }));
+			execute: (e, r) => m.gen(function* () {
+				let i = e, a = (yield* m.promise(() => S("_voltro_comments", _("id", i.commentId), 1)))[0];
+				if (a === void 0) return yield* m.fail(new t({ id: i.commentId }));
+				let o = yield* m.promise(() => F(String(a.threadId)));
+				if (o === void 0) return yield* m.fail(new t({ id: i.commentId }));
 				yield* P(String(o.anchor), r);
-				let s = M(r);
-				return String(a.authorSubjectId) !== (s.id ?? "anonymous") && !s.scopes.includes(B) ? yield* p.fail(new n({ id: i.commentId })) : (yield* p.promise(async () => {
-					for (let e of await S("_voltro_comment_reactions", g("commentId", i.commentId))) await b.delete("_voltro_comment_reactions", String(e.id));
+				let s = N(r);
+				return String(a.authorSubjectId) !== (s.id ?? "anonymous") && !s.scopes.includes(B) ? yield* m.fail(new n({ id: i.commentId })) : (yield* m.promise(async () => {
+					for (let e of await S("_voltro_comment_reactions", _("commentId", i.commentId))) await b.delete("_voltro_comment_reactions", String(e.id));
 					await b.delete("_voltro_comments", i.commentId);
-				}), N(), { ok: !0 });
+				}), C(), { ok: !0 });
 			})
 		},
 		{
-			...d,
+			...f,
 			description: "Toggle an emoji reaction on a comment.",
-			execute: (e, n) => p.gen(function* () {
-				let r = e, i = (yield* p.promise(() => S("_voltro_comments", g("id", r.commentId), 1)))[0];
-				if (i === void 0) return yield* p.fail(new t({ id: r.commentId }));
-				let a = yield* p.promise(() => F(String(i.threadId)));
-				if (a === void 0) return yield* p.fail(new t({ id: r.commentId }));
+			execute: (e, n) => m.gen(function* () {
+				let r = e, i = (yield* m.promise(() => S("_voltro_comments", _("id", r.commentId), 1)))[0];
+				if (i === void 0) return yield* m.fail(new t({ id: r.commentId }));
+				let a = yield* m.promise(() => F(String(i.threadId)));
+				if (a === void 0) return yield* m.fail(new t({ id: r.commentId }));
 				yield* P(String(a.anchor), n);
-				let o = M(n).id ?? "anonymous", s = (yield* p.promise(() => S("_voltro_comment_reactions", h(g("commentId", r.commentId), h(g("subjectId", o), g("emoji", r.emoji))), 1)))[0];
-				if (s !== void 0) return yield* p.promise(() => b.delete("_voltro_comment_reactions", String(s.id))), N(), { reacted: !1 };
-				let c = _({
+				let o = N(n).id ?? "anonymous", s = (yield* m.promise(() => S("_voltro_comment_reactions", g(_("commentId", r.commentId), g(_("subjectId", o), _("emoji", r.emoji))), 1)))[0];
+				if (s !== void 0) return yield* m.promise(() => b.delete("_voltro_comment_reactions", String(s.id))), C(), { reacted: !1 };
+				let c = v({
 					kind: "typeid",
 					prefix: "cmtrx"
 				}, "_voltro_comment_reactions");
-				return yield* p.promise(() => b.insert("_voltro_comment_reactions", {
+				return yield* m.promise(() => b.insert("_voltro_comment_reactions", {
 					id: c,
 					commentId: r.commentId,
 					subjectId: o,
 					emoji: r.emoji
-				})), N(), { reacted: !0 };
+				})), C(), { reacted: !0 };
 			})
 		},
 		{
-			...l,
+			...u,
 			description: "Stamp the caller's read marker for a thread.",
-			execute: (e, n) => p.gen(function* () {
+			execute: (e, n) => m.gen(function* () {
 				let r = e;
-				if ((yield* p.promise(() => F(r.threadId))) === void 0) return yield* p.fail(new t({ id: r.threadId }));
-				let i = M(n).id ?? "anonymous", a = _({
+				if ((yield* m.promise(() => F(r.threadId))) === void 0) return yield* m.fail(new t({ id: r.threadId }));
+				let i = N(n).id ?? "anonymous", a = v({
 					kind: "typeid",
 					prefix: "cmtread"
 				}, "_voltro_comment_reads");
-				return yield* p.promise(() => b.upsert("_voltro_comment_reads", {
+				return yield* m.promise(() => b.upsert("_voltro_comment_reads", {
 					id: a,
 					threadId: r.threadId,
 					subjectId: i,
@@ -290,19 +290,19 @@ var D = b("_voltro_comment_threads", {
 			})
 		},
 		{
-			...u,
+			...d,
 			description: "@-mention autocomplete over the app-declared directory, tenant-filtered.",
-			execute: (e, t) => p.promise(async () => {
+			execute: (e, t) => m.promise(async () => {
 				let { query: n } = e;
-				if (v.resolveMentions === void 0) return [];
-				let r = M(t);
-				return (await v.resolveMentions({
+				if (r.resolveMentions === void 0) return [];
+				let i = N(t);
+				return (await r.resolveMentions({
 					query: n,
 					subject: {
-						id: r.id,
-						tenantId: r.tenantId
+						id: i.id,
+						tenantId: i.tenantId
 					}
-				}).catch(() => [])).filter((e) => v.crossTenant === !0 || e.tenantId === void 0 || e.tenantId === null || e.tenantId === r.tenantId).map((e) => ({
+				}).catch(() => [])).filter((e) => r.crossTenant === !0 || e.tenantId === void 0 || e.tenantId === null || e.tenantId === i.tenantId).map((e) => ({
 					subjectId: e.subjectId,
 					label: e.label
 				}));
@@ -312,25 +312,25 @@ var D = b("_voltro_comment_threads", {
 		kind: "json",
 		data: e
 	});
-	return C({
+	return w({
 		name: y,
-		baseName: j,
+		baseName: M,
 		description: "Comment threads on any app entity — replies, resolve/reopen, @-mentions with notifications, reactions, unread — live over the reactive engine.",
 		permissions: ["inspect:read", "store:write"],
 		declaredScopes: [B],
 		extendSchema: { tables: [
-			D,
 			O,
 			k,
-			A
+			A,
+			j
 		] },
 		routes: V,
-		rpcClientDescriptors: i,
+		rpcClientDescriptors: a,
 		inspectEndpoints: [{
 			method: "GET",
 			path: "/threads",
 			description: "Thread volume + the most recent threads (operator surface).",
-			handler: () => p.promise(async () => {
+			handler: () => m.promise(async () => {
 				let e = await S("_voltro_comment_threads", void 0), t = await S("_voltro_comments", void 0), n = [...e].sort((e, t) => I(e.createdAt) > I(t.createdAt) ? -1 : 1).slice(0, 50).map((e) => ({
 					id: String(e.id),
 					anchor: String(e.anchor),
@@ -352,13 +352,13 @@ var D = b("_voltro_comment_threads", {
 		bindDataStore: (e) => {
 			b = e, x = e;
 		},
-		onActivate: (e) => p.sync(() => {
-			v.access?.viaEntity === void 0 && v.access?.scope === void 0 && e.logger.warn("comments: no access rule declared — EVERY read and write will be refused (fail-closed). Set commentsPlugin({ access: { viaEntity } }) or { access: { scope } }."), e.logger.info("comments active", { mentions: v.resolveMentions !== void 0 });
+		onActivate: (e) => m.sync(() => {
+			r.access?.viaEntity === void 0 && r.access?.scope === void 0 && e.logger.warn("comments: no access rule declared — EVERY read and write will be refused (fail-closed). Set commentsPlugin({ access: { viaEntity } }) or { access: { scope } }."), e.logger.info("comments active", { mentions: r.resolveMentions !== void 0 });
 		}),
-		onDeactivate: () => p.sync(() => {
+		onDeactivate: () => m.sync(() => {
 			b = void 0, x = void 0;
 		})
 	});
-}, P = () => "plugin-comments";
+}, F = () => "plugin-comments";
 //#endregion
-export { e as CommentAccessRefused, t as CommentNotFound, n as CommentNotYours, k as commentReactionsTable, A as commentReadsTable, D as commentThreadsTable, r as commentsFeed, N as commentsPlugin, O as commentsTable, P as pluginComments };
+export { e as CommentAccessRefused, t as CommentNotFound, n as CommentNotYours, A as commentReactionsTable, j as commentReadsTable, O as commentThreadsTable, i as commentsFeed, P as commentsPlugin, k as commentsTable, F as pluginComments };

package/dist/rpc.d.ts

@@ -4,6 +4,18 @@ import { QueryProcedureDescriptor } from '@voltro/protocol';
 import { ReactivityChannel } from '@voltro/protocol';
 import { Schema } from 'effect';
 
+/**
+ * The plugin's canonical package name — the key an app's `alias` is recorded
+ * under, and what `./web`'s hooks resolve their tags through.
+ *
+ * It lives in this BROWSER-SAFE module rather than in `index.ts` because both
+ * halves need it and only one of them may reach the server graph: `index.ts`
+ * passes it to `pluginInstanceName` / `baseName`, and `web.ts` passes it to
+ * `pluginTag`. A second copy in `web.ts` would be a second definition of the
+ * plugin's identity with nothing comparing them.
+ */
+export declare const BASE_NAME = "@voltro/plugin-comments";
+
 /** The anchor's access check refused the caller — or no access rule is
  *  declared at all (fail-closed: undeclared access is a refusal, not a pass).
  *  Also the answer for a thread whose anchor row no longer resolves (a

package/dist/rpc.js

@@ -2,7 +2,7 @@ import { CommentAccessRefused as e, CommentNotFound as t, CommentNotYours as n }
 import { Schema as r } from "effect";
 import { defineMutation as i, defineQuery as a, reactivityChannel as o } from "@voltro/protocol";
 //#region src/rpc.ts
-var s = o("comments"), c = r.Struct({
+var s = "@voltro/plugin-comments", c = o("comments"), l = r.Struct({
 	id: r.String,
 	threadId: r.String,
 	body: r.String,
@@ -15,22 +15,22 @@ var s = o("comments"), c = r.Struct({
 		count: r.Number,
 		mine: r.Boolean
 	}))
-}), l = r.Struct({
+}), u = r.Struct({
 	id: r.String,
 	anchor: r.String,
 	status: r.Literal("open", "resolved"),
 	createdBy: r.String,
 	createdAt: r.String,
-	comments: r.Array(c),
+	comments: r.Array(l),
 	unreadCount: r.Number
-}), u = a({
+}), d = a({
 	name: "comments.list",
-	source: s,
+	source: c,
 	input: r.Struct({ anchor: r.String }),
-	output: r.Array(l),
+	output: r.Array(u),
 	error: e,
 	openAccess: "delegated: the executor runs the app-declared anchor access rule (viaEntity guard or scope) and is fail-closed — an undeclared rule refuses every read"
-}), d = i({
+}), f = i({
 	name: "comments.create",
 	input: r.Struct({
 		anchor: r.String,
@@ -44,7 +44,7 @@ var s = o("comments"), c = r.Struct({
 	}),
 	error: r.Union(e, t),
 	openAccess: "delegated: the executor runs the app-declared anchor access rule before any write; the author is always the calling subject"
-}), f = i({
+}), p = i({
 	name: "comments.edit",
 	input: r.Struct({
 		commentId: r.String,
@@ -53,7 +53,7 @@ var s = o("comments"), c = r.Struct({
 	output: r.Struct({ ok: r.Boolean }),
 	error: r.Union(e, t, n),
 	openAccess: "author-scoped: only the comment's own author may edit, checked in the executor on top of the anchor access rule"
-}), p = i({
+}), m = i({
 	name: "comments.resolve",
 	input: r.Struct({
 		threadId: r.String,
@@ -62,13 +62,13 @@ var s = o("comments"), c = r.Struct({
 	output: r.Struct({ ok: r.Boolean }),
 	error: r.Union(e, t),
 	openAccess: "delegated: anchor access rule in the executor — anyone who may read the anchor may resolve/reopen (the Liveblocks semantic)"
-}), m = i({
+}), h = i({
 	name: "comments.delete",
 	input: r.Struct({ commentId: r.String }),
 	output: r.Struct({ ok: r.Boolean }),
 	error: r.Union(e, t, n),
 	openAccess: "author-scoped, with a comments:moderate scope override — both checked in the executor on top of the anchor access rule"
-}), h = i({
+}), g = i({
 	name: "comments.react",
 	input: r.Struct({
 		commentId: r.String,
@@ -77,13 +77,13 @@ var s = o("comments"), c = r.Struct({
 	output: r.Struct({ reacted: r.Boolean }),
 	error: r.Union(e, t),
 	openAccess: "delegated: anchor access rule in the executor; the toggle writes only the calling subject's own reaction row"
-}), g = i({
+}), _ = i({
 	name: "comments.markRead",
 	input: r.Struct({ threadId: r.String }),
 	output: r.Struct({ ok: r.Boolean }),
 	error: t,
 	openAccess: "self-scoped write: stamps only the calling subject's own read marker for the thread"
-}), _ = a({
+}), v = a({
 	name: "comments.mentionSearch",
 	input: r.Struct({ query: r.String }),
 	output: r.Array(r.Struct({
@@ -91,7 +91,7 @@ var s = o("comments"), c = r.Struct({
 		label: r.String
 	})),
 	openAccess: "delegated: the app-declared mention resolver receives the CALLING subject and its default filters to the caller's tenant — cross-tenant subjects are structurally unreachable"
-}), v = [
+}), y = [
 	{
 		tag: "comments.list",
 		kind: "query",
@@ -158,4 +158,4 @@ var s = o("comments"), c = r.Struct({
 	}
 ];
 //#endregion
-export { s as commentsFeed, v as commentsRpcClientImports, d as createDescriptor, m as deleteDescriptor, f as editDescriptor, u as listDescriptor, g as markReadDescriptor, _ as mentionSearchDescriptor, h as reactDescriptor, p as resolveDescriptor };
+export { s as BASE_NAME, c as commentsFeed, y as commentsRpcClientImports, f as createDescriptor, h as deleteDescriptor, p as editDescriptor, d as listDescriptor, _ as markReadDescriptor, v as mentionSearchDescriptor, g as reactDescriptor, m as resolveDescriptor };

package/dist/web.js

@@ -1,35 +1,37 @@
-import { useMutation as e, useSubscription as t } from "@voltro/client";
+import { BASE_NAME as e } from "./rpc.js";
+import { pluginTag as t } from "@voltro/protocol";
+import { useMutation as n, useSubscription as r } from "@voltro/client";
 //#region src/web.ts
-var n = (n, r = "app") => {
-	let { data: i, loading: a } = t(r, "comments.list", { anchor: n }), o = e(r, "comments.create"), s = e(r, "comments.edit"), c = e(r, "comments.resolve"), l = e(r, "comments.delete"), u = e(r, "comments.react"), d = e(r, "comments.markRead"), f = i ?? [];
+var i = (n) => t(e, n), a = (e, t = "app") => {
+	let { data: a, loading: o } = r(t, i("list"), { anchor: e }), s = n(t, i("create")), c = n(t, i("edit")), l = n(t, i("resolve")), u = n(t, i("delete")), d = n(t, i("react")), f = n(t, i("markRead")), p = a ?? [];
 	return {
-		threads: f,
-		pending: a,
-		unreadCount: f.reduce((e, t) => e + t.unreadCount, 0),
-		create: (e, t) => o.mutate({
-			anchor: n,
-			body: e,
-			...t?.threadId === void 0 ? {} : { threadId: t.threadId },
-			...t?.mentions === void 0 ? {} : { mentions: t.mentions }
+		threads: p,
+		pending: o,
+		unreadCount: p.reduce((e, t) => e + t.unreadCount, 0),
+		create: (t, n) => s.mutate({
+			anchor: e,
+			body: t,
+			...n?.threadId === void 0 ? {} : { threadId: n.threadId },
+			...n?.mentions === void 0 ? {} : { mentions: n.mentions }
 		}),
-		edit: (e, t) => s.mutate({
+		edit: (e, t) => c.mutate({
 			commentId: e,
 			body: t
 		}),
-		resolve: (e, t = !0) => c.mutate({
+		resolve: (e, t = !0) => l.mutate({
 			threadId: e,
 			resolved: t
 		}),
-		remove: (e) => l.mutate({ commentId: e }),
-		react: (e, t) => u.mutate({
+		remove: (e) => u.mutate({ commentId: e }),
+		react: (e, t) => d.mutate({
 			commentId: e,
 			emoji: t
 		}),
-		markRead: (e) => d.mutate({ threadId: e })
+		markRead: (e) => f.mutate({ threadId: e })
 	};
-}, r = (e, t, r = "app") => n(e, r).threads.find((e) => e.id === t), i = (e, n = "app") => {
-	let { data: r } = t(n, "comments.mentionSearch", { query: e });
-	return r ?? [];
+}, o = (e, t, n = "app") => a(e, n).threads.find((e) => e.id === t), s = (e, t = "app") => {
+	let { data: n } = r(t, i("mentionSearch"), { query: e });
+	return n ?? [];
 };
 //#endregion
-export { n as useComments, i as useMentionSearch, r as useThread };
+export { a as useComments, s as useMentionSearch, o as useThread };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-comments",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "description": "Comment threads on any anchor your app can name — replies, resolve/reopen, reactions, per-subject unread — live over the existing reactivity channel, with no second push mechanism. Access delegates to your app's own guard (access.viaEntity) or a scope and fails closed when neither is declared; @-mentions are re-filtered to the caller's tenant on search and re-validated at create, then delivered through plugin-notifications when it is installed. useComments / useThread / useMentionSearch in /web, an ejectable <CommentsThread> in @voltro/ui, plus inspect endpoints and a dashboard panel.",
   "keywords": [
     "voltro",
@@ -48,9 +48,9 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.54.0",
-    "@voltro/protocol": "0.54.0",
-    "@voltro/plugin-notifications": "0.54.0",
+    "@voltro/database": "0.56.0",
+    "@voltro/protocol": "0.56.0",
+    "@voltro/plugin-notifications": "0.56.0",
     "effect": "^3.22.0"
   },
   "peerDependencies": {