@voltro/plugin-moderation 0.85.0 → 0.87.0

package/dist/index.js

@@ -1,99 +1,54 @@
 import { ContentRejected as e } from "./errors.js";
-import { Context as t, Effect as n, Layer as r } from "effect";
-import { definePlugin as i, pluginInstanceName as a } from "@voltro/protocol";
-import { createLogger as o } from "@voltro/logger";
-//#region src/providers.ts
-var s = o({ scope: "@voltro/plugin-moderation" }), c = { flagged: !1 }, l = /[.*+?^${}()|[\]\\]/g, u = (e) => {
-	let t = (e) => e !== void 0 && /[\p{L}\p{N}_]/u.test(e), n = t(e[0]) ? "\\b" : "", r = t(e[e.length - 1]) ? "\\b" : "";
-	return RegExp(`${n}${e.replace(l, "\\$&")}${r}`, "u");
-}, d = (e) => {
-	let t = e.filter((e) => e.length > 0).map((e) => ({
-		term: e.toLowerCase(),
-		re: u(e.toLowerCase())
-	}));
-	return (e) => n.sync(() => {
-		let n = e.toLowerCase(), r = t.filter((e) => e.re.test(n)).map((e) => e.term);
-		return r.length > 0 ? {
-			flagged: !0,
-			categories: r,
-			reason: `matched denied term(s): ${r.join(", ")}`
-		} : c;
-	});
-}, f = (e = {}) => {
-	let t = e.threshold ?? .7, r = e.categories ?? [
-		"hate",
-		"harassment",
-		"sexual",
-		"violence",
-		"self-harm",
-		"illicit"
-	], i = e.load ?? (() => import("@voltro/ai")), a = !1;
-	return (e) => n.gen(function* () {
-		let o = yield* n.tryPromise(i).pipe(n.catch(() => n.succeed(null)));
-		return o === null ? (a || (a = !0, s.warn("aiProvider configured but @voltro/ai could not be loaded — content is NOT being moderated; install @voltro/ai")), c) : yield* n.tryPromise(async () => {
-			let { Schema: i } = await import("effect"), a = i.Struct({
-				flagged: i.Boolean,
-				topCategory: i.NullOr(i.String),
-				score: i.Number
-			}), { object: s } = await n.runPromise(o.generateObject({
-				schema: a,
-				system: `You are a content moderator. Categories: ${r.join(", ")}. Return whether the content violates policy, the worst category, and a 0..1 severity score.`,
-				prompt: e
-			})), c = s.flagged || s.score >= t;
-			return {
-				flagged: c,
-				score: s.score,
-				...s.topCategory ? { categories: [s.topCategory] } : {},
-				...c ? { reason: `ai moderation: ${s.topCategory ?? "policy"} (${s.score.toFixed(2)})` } : {}
-			};
-		}).pipe(n.catch(() => n.succeed(c)));
-	});
-}, p = class extends t.Service()("@voltro/plugin-moderation/ModerationService") {}, m = (e) => n.flatMap(p, (t) => t.moderate(e)), h = (e, t) => {
+import { aiProvider as t, keywordProvider as n } from "./providers.js";
+import { Context as r, Effect as i, Layer as a } from "effect";
+import { definePlugin as o, pluginInstanceName as s } from "@voltro/protocol";
+//#region src/index.ts
+var c = class extends r.Service()("@voltro/plugin-moderation/ModerationService") {}, l = (e) => i.flatMap(c, (t) => t.moderate(e)), u = (e, t) => {
 	if (typeof e != "object" || !e) return "";
 	let n = e;
 	return t.map((e) => n[e]).filter((e) => typeof e == "string").join("\n");
-}, g = "@voltro/plugin-moderation", _ = (t) => {
-	let o = a({
-		base: g,
+}, d = "@voltro/plugin-moderation", f = (t) => {
+	let n = s({
+		base: d,
 		alias: t.alias,
 		instance: t.name
-	}), s = t.rules.map((e) => {
+	}), r = t.rules.map((e) => {
 		let t = e.match;
 		if (typeof t == "string") return (e) => t === e;
 		let n = t.global || t.sticky ? new RegExp(t.source, t.flags.replace(/[gy]/g, "")) : t;
 		return (e) => n.test(e);
-	}), c = (e) => t.rules.filter((t, n) => s[n](e)), l = t.onFlag, u = () => void 0, d = [], f = 0, m = 0, _ = 0, v = (e, t, n) => {
-		d.unshift({
-			id: `mod_${Date.now().toString(36)}_${f++}`,
+	}), l = (e) => t.rules.filter((t, n) => r[n](e)), f = t.onFlag, p = () => void 0, m = [], h = 0, g = 0, _ = 0, v = (e, t, n) => {
+		m.unshift({
+			id: `mod_${Date.now().toString(36)}_${h++}`,
 			tag: e,
 			categories: n.categories ?? [],
 			reason: n.reason ?? "content policy violation",
 			subjectId: t,
 			at: (/* @__PURE__ */ new Date()).toISOString(),
 			status: "pending"
-		}), d.length > 200 && (d.length = 200);
-	}, y = (r, i) => {
-		let a = c(i.tag);
-		if (a.length === 0) return r;
-		let o = i.subject?.id ?? null;
-		return n.gen(function* () {
-			for (let r of a) {
-				let a = h(i.input, r.fields);
+		}), m.length > 200 && (m.length = 200);
+	}, y = (n, r) => {
+		let a = l(r.tag);
+		if (a.length === 0) return n;
+		let o = r.subject?.id ?? null;
+		return i.gen(function* () {
+			for (let n of a) {
+				let a = u(r.input, n.fields);
 				if (a.length === 0) continue;
 				let s = yield* t.provider(a);
 				if (!s.flagged) continue;
-				let c = s.categories ?? [], d = s.reason ?? "content policy violation";
-				if ((r.action ?? "block") === "block") return m++, v(i.tag, o, s), yield* n.fail(new e({
-					tag: i.tag,
+				let c = s.categories ?? [], l = s.reason ?? "content policy violation";
+				if ((n.action ?? "block") === "block") return g++, v(r.tag, o, s), yield* i.fail(new e({
+					tag: r.tag,
 					categories: c,
-					reason: d
+					reason: l
 				}));
-				_++, v(i.tag, o, s), u(i.tag, s), l?.({
-					tag: i.tag,
+				_++, v(r.tag, o, s), p(r.tag, s), f?.({
+					tag: r.tag,
 					verdict: s
 				});
 			}
-			return yield* r;
+			return yield* n;
 		});
 	}, b = (e) => ({
 		kind: "json",
@@ -107,19 +62,19 @@ var s = o({ scope: "@voltro/plugin-moderation" }), c = { flagged: !1 }, l = /[.*
 		path: "/flagged",
 		scope: "process",
 		description: "The content-moderation review queue (newest first).",
-		handler: () => n.succeed(b({
-			items: d.slice(),
+		handler: () => i.succeed(b({
+			items: m.slice(),
 			stats: {
-				blocked: m,
+				blocked: g,
 				flagged: _,
-				pending: d.filter((e) => e.status === "pending").length
+				pending: m.filter((e) => e.status === "pending").length
 			}
 		}))
 	}, {
 		method: "POST",
 		path: "/resolve",
 		description: "Resolve a flagged item — confirm (real violation) or dismiss (false positive).",
-		handler: (e) => n.sync(() => {
+		handler: (e) => i.sync(() => {
 			let t;
 			try {
 				t = JSON.parse(e.body || "{}");
@@ -128,7 +83,7 @@ var s = o({ scope: "@voltro/plugin-moderation" }), c = { flagged: !1 }, l = /[.*
 			}
 			if (typeof t != "object" || !t || Array.isArray(t)) return x(400, "expected a JSON object");
 			if (!("id" in t) || typeof t.id != "string" || !t.id.trim() || !("action" in t) || t.action !== "confirm" && t.action !== "dismiss") return x(400, "id + action (confirm|dismiss) required");
-			let n = d.find((e) => e.id === t.id);
+			let n = m.find((e) => e.id === t.id);
 			return n ? n.status === "pending" ? (n.status = t.action === "confirm" ? "confirmed" : "dismissed", b({
 				ok: !0,
 				item: n
@@ -140,10 +95,10 @@ var s = o({ scope: "@voltro/plugin-moderation" }), c = { flagged: !1 }, l = /[.*
 		"rpc:intercept:workflow",
 		"inspect:read",
 		"inspect:write"
-	], w = r.succeed(p, { moderate: (e) => t.provider(e) });
-	return i({
-		name: o,
-		baseName: g,
+	], w = a.succeed(c, { moderate: (e) => t.provider(e) });
+	return o({
+		name: n,
+		baseName: d,
 		description: "Content moderation — block or flag user-content writes via an AI / keyword / custom check.",
 		permissions: C,
 		errorSchemas: [{
@@ -158,14 +113,14 @@ var s = o({ scope: "@voltro/plugin-moderation" }), c = { flagged: !1 }, l = /[.*
 		interceptWorkflow: y,
 		inspectEndpoints: S,
 		services: w,
-		onActivate: (e) => n.sync(() => {
-			u = (t, n) => e.logger.warn("content flagged", {
+		onActivate: (e) => i.sync(() => {
+			p = (t, n) => e.logger.warn("content flagged", {
 				tag: t,
 				categories: n.categories,
 				score: n.score
-			}), l = t.onFlag, e.logger.info("moderation active", { rules: t.rules.length });
+			}), f = t.onFlag, e.logger.info("moderation active", { rules: t.rules.length });
 		})
 	});
 };
 //#endregion
-export { e as ContentRejected, p as ModerationService, f as aiProvider, d as keywordProvider, m as moderate, _ as moderationPlugin };
+export { e as ContentRejected, c as ModerationService, t as aiProvider, n as keywordProvider, l as moderate, f as moderationPlugin };

package/dist/providers.js

@@ -0,0 +1,51 @@
+import { Effect as e } from "effect";
+import { createLogger as t } from "@voltro/logger";
+//#region src/providers.ts
+var n = t({ scope: "@voltro/plugin-moderation" }), r = { flagged: !1 }, i = /[.*+?^${}()|[\]\\]/g, a = (e) => {
+	let t = (e) => e !== void 0 && /[\p{L}\p{N}_]/u.test(e), n = t(e[0]) ? "\\b" : "", r = t(e[e.length - 1]) ? "\\b" : "";
+	return RegExp(`${n}${e.replace(i, "\\$&")}${r}`, "u");
+}, o = (t) => {
+	let n = t.filter((e) => e.length > 0).map((e) => ({
+		term: e.toLowerCase(),
+		re: a(e.toLowerCase())
+	}));
+	return (t) => e.sync(() => {
+		let e = t.toLowerCase(), i = n.filter((t) => t.re.test(e)).map((e) => e.term);
+		return i.length > 0 ? {
+			flagged: !0,
+			categories: i,
+			reason: `matched denied term(s): ${i.join(", ")}`
+		} : r;
+	});
+}, s = (t = {}) => {
+	let i = t.threshold ?? .7, a = t.categories ?? [
+		"hate",
+		"harassment",
+		"sexual",
+		"violence",
+		"self-harm",
+		"illicit"
+	], o = t.load ?? (() => import("@voltro/ai")), s = !1;
+	return (t) => e.gen(function* () {
+		let c = yield* e.tryPromise(o).pipe(e.catch(() => e.succeed(null)));
+		return c === null ? (s || (s = !0, n.warn("aiProvider configured but @voltro/ai could not be loaded — content is NOT being moderated; install @voltro/ai")), r) : yield* e.tryPromise(async () => {
+			let { Schema: n } = await import("effect"), r = n.Struct({
+				flagged: n.Boolean,
+				topCategory: n.NullOr(n.String),
+				score: n.Number
+			}), { object: o } = await e.runPromise(c.generateObject({
+				schema: r,
+				system: `You are a content moderator. Categories: ${a.join(", ")}. Return whether the content violates policy, the worst category, and a 0..1 severity score.`,
+				prompt: t
+			})), s = o.flagged || o.score >= i;
+			return {
+				flagged: s,
+				score: o.score,
+				...o.topCategory ? { categories: [o.topCategory] } : {},
+				...s ? { reason: `ai moderation: ${o.topCategory ?? "policy"} (${o.score.toFixed(2)})` } : {}
+			};
+		}).pipe(e.catch(() => e.succeed(r)));
+	});
+};
+//#endregion
+export { s as aiProvider, o as keywordProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-moderation",
-  "version": "0.85.0",
+  "version": "0.87.0",
   "description": "Content moderation — run an AI / keyword / custom check on user-content fields and block or flag a write before it commits. Declarative per-rpc rules + an in-handler moderate() helper for redact/inline control.",
   "keywords": [
     "voltro",
@@ -38,11 +38,11 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/logger": "0.85.0",
-    "@voltro/protocol": "0.85.0"
+    "@voltro/logger": "0.87.0",
+    "@voltro/protocol": "0.87.0"
   },
   "optionalDependencies": {
-    "@voltro/ai": "0.85.0"
+    "@voltro/ai": "0.87.0"
   },
   "peerDependencies": {
     "effect": "4.0.1"