@happyvertical/smrt-comments 0.57.1 → 0.57.3

package/dist/index.js

@@ -1,24 +1,22 @@
-import { ObjectRegistry, SmrtCollection, SmrtPolymorphicAssociation, SmrtRecipe, crossPackageRef, digestRunOnceContent, field, runOnce, smrt } from "@happyvertical/smrt-core";
+import { a as ParticipationRateBucketCollection, c as ParticipationBan, i as ParticipationPolicyCollection, n as ParticipationDeniedError, o as ParticipationRateBucket, r as ParticipationBanCollection, s as ParticipationPolicy, t as ParticipationService } from "./chunks/participation-LA_cfrM2.js";
+import { SmrtCollection, SmrtObject, SmrtPolymorphicAssociation, SmrtRecipe, crossPackageRef, digestRunOnceContent, field, foreignKey, runOnce, smrt } from "@happyvertical/smrt-core";
 import { TenantIsolationError, TenantScoped, getCurrentTenant, tenantId, withTenant } from "@happyvertical/smrt-tenancy";
-//#region src/__smrt-register__.ts
-ObjectRegistry.registerPackageManifest(JSON.parse(`{"version":"1.0.0","timestamp":0,"packageName":"@happyvertical/smrt-comments","packageVersion":"0.57.1","objects":{"@happyvertical/smrt-comments:CommentCollection":{"name":"commentcollection","className":"CommentCollection","qualifiedName":"@happyvertical/smrt-comments:CommentCollection","collection":"comments","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/collections/CommentCollection.ts","packageName":"@happyvertical/smrt-comments","fields":{},"methods":{"listForRecord":{"name":"listForRecord","async":true,"parameters":[{"name":"recordType","type":"string","optional":false},{"name":"recordId","type":"string","optional":false}],"returnType":"Promise<Comment[]>","isStatic":false,"isPublic":true}},"decoratorConfig":{"tableName":"record_comments","api":false,"mcp":false,"cli":false},"extends":"SmrtCollection","extendsTypeArg":"Comment","exportName":"CommentCollection","collectionExportName":"CommentCollectionCollection","schema":{"tableName":"record_comments","ddl":"CREATE TABLE IF NOT EXISTS \\"record_comments\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"meta_type\\" TEXT NOT NULL,\\n  \\"meta_id\\" TEXT NOT NULL,\\n  \\"role\\" TEXT NOT NULL,\\n  \\"sort_order\\" INTEGER DEFAULT 0,\\n  \\"tenant_id\\" UUID NOT NULL,\\n  \\"author_user_id\\" UUID NOT NULL,\\n  \\"body\\" TEXT NOT NULL,\\n  \\"mentions\\" TEXT,\\n  \\"idempotency_key\\" TEXT,\\n  \\"retry_tenant_id\\" TEXT,\\n  \\"request_digest\\" TEXT\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"meta_type":{"type":"TEXT","notNull":true,"unique":false},"meta_id":{"type":"TEXT","notNull":true,"unique":false},"role":{"type":"TEXT","notNull":true,"unique":false},"sort_order":{"type":"INTEGER","notNull":false,"unique":false,"default":0},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"author_user_id":{"type":"UUID","referenceKind":"crossPackageRef","notNull":true,"unique":false},"body":{"type":"TEXT","notNull":true,"unique":false},"mentions":{"type":"TEXT","notNull":false,"unique":false},"idempotency_key":{"type":"TEXT","notNull":false,"unique":false},"retry_tenant_id":{"type":"TEXT","notNull":false,"unique":false},"request_digest":{"type":"TEXT","notNull":false,"unique":false}},"indexes":[{"name":"record_comments_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"record_comments_tenant_request_key","columns":["retry_tenant_id","idempotency_key"],"unique":true},{"name":"record_comments_record_created_idx","columns":["tenant_id","meta_type","meta_id","created_at"]},{"name":"record_comments_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"record_comments_meta_type_meta_id_idx","columns":["meta_type","meta_id"]},{"name":"record_comments_author_user_id_idx","columns":["author_user_id"]}],"version":"5095dfc9"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:Comment":{"name":"comment","className":"Comment","qualifiedName":"@happyvertical/smrt-comments:Comment","collection":"comments","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/models/Comment.ts","packageName":"@happyvertical/smrt-comments","fields":{"metaType":{"type":"text","required":true,"_meta":{"required":true}},"metaId":{"type":"text","required":true,"_meta":{"required":true}},"role":{"type":"text","required":true,"_meta":{"required":true}},"sortOrder":{"type":"integer","required":false,"default":0},"tenantId":{"type":"text","required":true,"_meta":{"sqlType":"UUID","__tenancy":{"isTenantIdField":true,"autoFilter":true,"required":true,"autoPopulate":true,"nullable":false,"mode":"required","field":"tenantId","allowSuperAdminBypass":false}}},"authorUserId":{"type":"crossPackageRef","required":true,"related":"@happyvertical/smrt-users:User"},"body":{"type":"text","required":true,"_meta":{"required":true}},"mentions":{"type":"text","required":false},"idempotencyKey":{"type":"text","required":false,"_meta":{"nullable":true,"readonly":true},"readonly":true},"retryTenantId":{"type":"text","required":false,"_meta":{"nullable":true,"readonly":true},"readonly":true},"requestDigest":{"type":"text","required":false,"_meta":{"nullable":true,"readonly":true},"readonly":true}},"methods":{"hydrate":{"name":"hydrate","async":true,"parameters":[],"returnType":"Promise<T | null>","isStatic":false,"isPublic":true}},"decoratorConfig":{"tableName":"record_comments","api":false,"mcp":false,"cli":false,"indexes":[{"name":"record_comments_tenant_request_key","columns":["retryTenantId","idempotencyKey"],"unique":true},{"name":"record_comments_record_created_idx","columns":["tenantId","metaType","metaId","createdAt"]}],"tenantScoped":{"mode":"required"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtPolymorphicAssociation","exportName":"Comment","collectionExportName":"CommentCollection","validationRules":[{"field":"metaType","rule":"required","fieldType":"text"},{"field":"metaId","rule":"required","fieldType":"text"},{"field":"role","rule":"required","fieldType":"text"},{"field":"authorUserId","rule":"required","fieldType":"crossPackageRef"},{"field":"body","rule":"required","fieldType":"text"}],"schema":{"tableName":"record_comments","ddl":"CREATE TABLE IF NOT EXISTS \\"record_comments\\" (\\n  \\"id\\" UUID PRIMARY KEY NOT NULL,\\n  \\"slug\\" TEXT NOT NULL,\\n  \\"context\\" TEXT NOT NULL DEFAULT '',\\n  \\"created_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"updated_at\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\"meta_type\\" TEXT NOT NULL,\\n  \\"meta_id\\" TEXT NOT NULL,\\n  \\"role\\" TEXT NOT NULL,\\n  \\"sort_order\\" INTEGER DEFAULT 0,\\n  \\"tenant_id\\" UUID NOT NULL,\\n  \\"author_user_id\\" UUID NOT NULL,\\n  \\"body\\" TEXT NOT NULL,\\n  \\"mentions\\" TEXT,\\n  \\"idempotency_key\\" TEXT,\\n  \\"retry_tenant_id\\" TEXT,\\n  \\"request_digest\\" TEXT\\n);","columns":{"id":{"type":"UUID","primaryKey":true,"referenceKind":"id","notNull":true},"slug":{"type":"TEXT","notNull":true},"context":{"type":"TEXT","notNull":true,"default":""},"created_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"updated_at":{"type":"TIMESTAMP","notNull":true,"default":"current_timestamp"},"meta_type":{"type":"TEXT","notNull":true,"unique":false},"meta_id":{"type":"TEXT","notNull":true,"unique":false},"role":{"type":"TEXT","notNull":true,"unique":false},"sort_order":{"type":"INTEGER","notNull":false,"unique":false,"default":0},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"author_user_id":{"type":"UUID","referenceKind":"crossPackageRef","notNull":true,"unique":false},"body":{"type":"TEXT","notNull":true,"unique":false},"mentions":{"type":"TEXT","notNull":false,"unique":false},"idempotency_key":{"type":"TEXT","notNull":false,"unique":false},"retry_tenant_id":{"type":"TEXT","notNull":false,"unique":false},"request_digest":{"type":"TEXT","notNull":false,"unique":false}},"indexes":[{"name":"record_comments_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"record_comments_tenant_request_key","columns":["retry_tenant_id","idempotency_key"],"unique":true},{"name":"record_comments_record_created_idx","columns":["tenant_id","meta_type","meta_id","created_at"]},{"name":"record_comments_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"record_comments_meta_type_meta_id_idx","columns":["meta_type","meta_id"]},{"name":"record_comments_author_user_id_idx","columns":["author_user_id"]}],"version":"5095dfc9"},"importPath":"@happyvertical/smrt-comments"}},"moduleType":"smrt","recipes":[{"id":"comments.records","className":"RecordCommentsRecipe","label":"Record comments","summary":"Discuss work directly on the records it concerns.","synonyms":["comments","mentions","discussion"],"models":["@happyvertical/smrt-comments:Comment"],"nav":[],"requires":[],"group":{"id":"comments","label":"Comments","summary":"Keep discussions alongside the records your team works on."},"help":{"markdown":"## Overview\\n\\nRecord comments keep a discussion next to the work it concerns. Open a record\\nyou can access to read its discussion or add a comment. Comments are part of\\nthe record page, rather than a separate list of every discussion.\\n\\n## Tasks\\n\\n### Add a comment\\n\\nOpen the record, find Comments, write your message and choose Post comment.\\nYour app controls who can read the record and who can contribute to its discussion.\\n\\n### Mention someone\\n\\nIf your app provides mention selection, choose a teammate who can access the\\nrecord. When mention notifications are connected, that person receives a\\nnotification. Typing a name alone does not select a recipient.\\n\\n### Check a failed post\\n\\nIf posting reports an error, refresh the discussion before trying again. A\\ncomment may have been saved even when its mention notification could not be\\ndelivered. If it appears in the discussion, do not post it a second time.\\n","fieldRefs":[]},"surfaces":[{"kind":"playground","export":"@happyvertical/smrt-comments/svelte#RecordCommentsPlayground","label":"Record discussion preview"}],"runtime":"both","demoSeed":{"export":"@happyvertical/smrt-comments/svelte#recordCommentsDemo"},"demo":{"mode":"server","reasons":["Needs a server because its package depends on @happyvertical/smrt-tenancy, which do not build for a browser (#3624)."]}}],"smrtDependencies":["@happyvertical/smrt-core","@happyvertical/smrt-messages","@happyvertical/smrt-tenancy"],"browser":{"status":"server-only","issues":["#3624"],"via":["@happyvertical/smrt-tenancy"]},"stampsConstructors":true}`));
-//#endregion
 //#region src/models/Comment.ts
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+var __defProp$2 = Object.defineProperty;
+var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, {
 	enumerable: true,
 	configurable: true,
 	writable: true,
 	value
 }) : obj[key] = value;
-var __decorateClass = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+var __decorateClass$2 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp(target, key, result);
+	if (kind && result) __defProp$2(target, key, result);
 	return result;
 };
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
 var MAX_MENTIONS = 50;
 var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var Comment = class extends SmrtPolymorphicAssociation {
@@ -30,6 +28,10 @@ var Comment = class extends SmrtPolymorphicAssociation {
 	idempotencyKey = null;
 	retryTenantId = null;
 	requestDigest = null;
+	parentCommentId = null;
+	status = "visible";
+	participationSnapshot = null;
+	editedAt = null;
 	constructor(options = {}) {
 		super(options);
 		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
@@ -38,6 +40,9 @@ var Comment = class extends SmrtPolymorphicAssociation {
 		if (options.idempotencyKey !== void 0) this.idempotencyKey = options.idempotencyKey;
 		if (options.retryTenantId !== void 0) this.retryTenantId = options.retryTenantId;
 		if (options.requestDigest !== void 0) this.requestDigest = options.requestDigest;
+		if (options.parentCommentId !== void 0) this.parentCommentId = options.parentCommentId;
+		if (options.status !== void 0) this.status = options.status;
+		if (options.participationSnapshot !== void 0) this.participationSnapshot = options.participationSnapshot;
 		const mentions = options.mentions;
 		if (Array.isArray(mentions)) this.mentionUserIds = mentions;
 		else if (typeof mentions === "string") this.mentions = mentions;
@@ -56,43 +61,77 @@ var Comment = class extends SmrtPolymorphicAssociation {
 		this.mentions = JSON.stringify(unique);
 	}
 };
-__publicField(Comment, "__smrtPackage__", "@happyvertical/smrt-comments");
-__decorateClass([tenantId()], Comment.prototype, "tenantId", 2);
-__decorateClass([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], Comment.prototype, "authorUserId", 2);
-__decorateClass([field({ required: true })], Comment.prototype, "body", 2);
-__decorateClass([field({
+__publicField$2(Comment, "__smrtPackage__", "@happyvertical/smrt-comments");
+__decorateClass$2([tenantId()], Comment.prototype, "tenantId", 2);
+__decorateClass$2([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], Comment.prototype, "authorUserId", 2);
+__decorateClass$2([field({ required: true })], Comment.prototype, "body", 2);
+__decorateClass$2([field({
 	type: "text",
 	nullable: true,
 	readonly: true
 })], Comment.prototype, "idempotencyKey", 2);
-__decorateClass([field({
+__decorateClass$2([field({
 	type: "text",
 	nullable: true,
 	readonly: true
 })], Comment.prototype, "retryTenantId", 2);
-__decorateClass([field({
+__decorateClass$2([field({
 	type: "text",
 	nullable: true,
 	readonly: true
 })], Comment.prototype, "requestDigest", 2);
-Comment = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+__decorateClass$2([foreignKey("Comment", {
+	nullable: true,
+	constraint: false
+})], Comment.prototype, "parentCommentId", 2);
+__decorateClass$2([field({ required: true })], Comment.prototype, "status", 2);
+__decorateClass$2([field({
+	type: "text",
+	nullable: true,
+	readonly: true
+})], Comment.prototype, "participationSnapshot", 2);
+__decorateClass$2([field({
+	type: "datetime",
+	nullable: true,
+	readonly: true
+})], Comment.prototype, "editedAt", 2);
+Comment = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
 	tableName: "record_comments",
 	api: false,
 	mcp: false,
 	cli: false,
-	indexes: [{
-		name: "record_comments_tenant_request_key",
-		columns: ["retryTenantId", "idempotencyKey"],
-		unique: true
-	}, {
-		name: "record_comments_record_created_idx",
-		columns: [
-			"tenantId",
-			"metaType",
-			"metaId",
-			"createdAt"
-		]
-	}]
+	indexes: [
+		{
+			name: "record_comments_tenant_request_key",
+			columns: ["retryTenantId", "idempotencyKey"],
+			unique: true
+		},
+		{
+			name: "record_comments_record_created_idx",
+			columns: [
+				"tenantId",
+				"metaType",
+				"metaId",
+				"createdAt"
+			]
+		},
+		{
+			name: "record_comments_parent_created_idx",
+			columns: [
+				"tenantId",
+				"parentCommentId",
+				"createdAt"
+			]
+		},
+		{
+			name: "record_comments_moderation_idx",
+			columns: [
+				"tenantId",
+				"status",
+				"createdAt"
+			]
+		}
+	]
 })], Comment);
 //#endregion
 //#region src/collections/CommentCollection.ts
@@ -112,6 +151,108 @@ var CommentCollection = class extends SmrtCollection {
 	}
 };
 //#endregion
+//#region src/models/CommentReport.ts
+var __defProp$1 = Object.defineProperty;
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$1(target, key, result);
+	return result;
+};
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var CommentReport = class extends SmrtObject {
+	tenantId = "";
+	commentId = "";
+	reporterUserId = "";
+	reason = "";
+	status = "open";
+};
+__publicField$1(CommentReport, "__smrtPackage__", "@happyvertical/smrt-comments");
+__decorateClass$1([tenantId()], CommentReport.prototype, "tenantId", 2);
+__decorateClass$1([foreignKey("Comment", {
+	required: true,
+	constraint: false
+})], CommentReport.prototype, "commentId", 2);
+__decorateClass$1([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], CommentReport.prototype, "reporterUserId", 2);
+__decorateClass$1([field({ required: true })], CommentReport.prototype, "reason", 2);
+__decorateClass$1([field({ required: true })], CommentReport.prototype, "status", 2);
+CommentReport = __decorateClass$1([TenantScoped({ mode: "required" }), smrt({
+	tableName: "comment_reports",
+	api: false,
+	mcp: false,
+	cli: false,
+	indexes: [{
+		name: "comment_reports_actor_target_unique",
+		columns: [
+			"tenantId",
+			"reporterUserId",
+			"commentId"
+		],
+		unique: true
+	}, {
+		name: "comment_reports_queue_idx",
+		columns: [
+			"tenantId",
+			"status",
+			"createdAt"
+		]
+	}]
+})], CommentReport);
+//#endregion
+//#region src/collections/CommentReportCollection.ts
+var CommentReportCollection = class extends SmrtCollection {
+	static _itemClass = CommentReport;
+};
+//#endregion
+//#region src/models/CommentRevision.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var CommentRevision = class extends SmrtObject {
+	tenantId = "";
+	commentId = "";
+	editorUserId = "";
+	body = "";
+};
+__publicField(CommentRevision, "__smrtPackage__", "@happyvertical/smrt-comments");
+__decorateClass([tenantId()], CommentRevision.prototype, "tenantId", 2);
+__decorateClass([foreignKey("Comment", {
+	required: true,
+	constraint: false
+})], CommentRevision.prototype, "commentId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], CommentRevision.prototype, "editorUserId", 2);
+__decorateClass([field({ required: true })], CommentRevision.prototype, "body", 2);
+CommentRevision = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	tableName: "comment_revisions",
+	api: false,
+	mcp: false,
+	cli: false
+})], CommentRevision);
+//#endregion
+//#region src/collections/CommentRevisionCollection.ts
+var CommentRevisionCollection = class extends SmrtCollection {
+	static _itemClass = CommentRevision;
+};
+//#endregion
 //#region src/recipes.ts
 var RecordCommentsRecipe = class extends SmrtRecipe {
 	static id = "comments.records";
@@ -127,7 +268,14 @@ var RecordCommentsRecipe = class extends SmrtRecipe {
 		label: "Comments",
 		summary: "Keep discussions alongside the records your team works on."
 	};
-	static models = [Comment];
+	static models = [
+		Comment,
+		CommentRevision,
+		CommentReport,
+		ParticipationPolicy,
+		ParticipationBan,
+		ParticipationRateBucket
+	];
 	static nav = [];
 	static runtime = "both";
 	static surfaces = [{
@@ -143,7 +291,7 @@ var RecordCommentsRecipe = class extends SmrtRecipe {
 var canonicalUuid = (value) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value) ? value.toLowerCase() : value;
 var CommentIdempotencyError = class extends Error {
 	constructor(code) {
-		super(code === "COMMENT_REQUEST_CONFLICT" ? "Comment request key already used with different content." : "Comment request no longer has an unchanged comment.");
+		super(code === "COMMENT_REQUEST_CONFLICT" ? "Comment request key already used with different content." : "Comment request no longer has a valid retained creation binding.");
 		this.code = code;
 		this.name = "CommentIdempotencyError";
 	}
@@ -163,6 +311,130 @@ var CommentService = class {
 			action
 		})) throw new Error("Comment record access denied.");
 	}
+	async getAuthorizedComment(commentId, action) {
+		const tenantId = this.options.actor.tenantId;
+		const comment = await withTenant({ tenantId }, async () => (await CommentCollection.create({ db: this.options.db })).get(commentId));
+		if (!comment || canonicalUuid(comment.tenantId) !== canonicalUuid(tenantId)) throw new Error("Comment not found.");
+		await this.authorize(comment.metaType, comment.metaId, action);
+		return comment;
+	}
+	/** Edits retain the exact former body before changing the visible comment. */
+	async edit(commentId, body) {
+		if (!body.trim()) throw new TypeError("Comment body is required.");
+		const comment = await this.getAuthorizedComment(commentId, "read");
+		if (canonicalUuid(comment.authorUserId) !== canonicalUuid(this.options.actor.userId)) throw new Error("Comment edit denied.");
+		await this.authorize(comment.metaType, comment.metaId, "comment");
+		const tenantId = this.options.actor.tenantId;
+		return withTenant({ tenantId }, async () => {
+			const collection = await CommentCollection.create({ db: this.options.db });
+			if (!collection.db.transaction) throw new Error("Comment edits require transactions.");
+			return collection.db.transaction(async (tx) => {
+				const scoped = await CommentCollection.create({ db: tx });
+				const table = `"${scoped.tableName.replace(/"/g, "\"\"")}"`;
+				await tx.query(`UPDATE ${table} SET body = body WHERE id = ? AND tenant_id = ?`, commentId, tenantId);
+				const current = await scoped.get(commentId);
+				if (!current || canonicalUuid(current.authorUserId) !== canonicalUuid(this.options.actor.userId)) throw new Error("Comment edit denied.");
+				return new ParticipationService({
+					db: tx,
+					entitlement: this.options.participation
+				}).executeInTransaction(tx, {
+					tenantId,
+					actorUserId: this.options.actor.userId,
+					action: "comment",
+					recordType: current.metaType,
+					recordId: current.metaId
+				}, async (guardedTx, decision) => withTenant({ tenantId: current.tenantId }, async () => {
+					await (await CommentRevisionCollection.create({ db: guardedTx })).create({
+						tenantId: current.tenantId,
+						commentId,
+						editorUserId: this.options.actor.userId,
+						body: current.body
+					});
+					if (current.status === "visible" && decision.initialCommentStatus === "pending") current.status = "pending";
+					current.body = body;
+					current.editedAt = /* @__PURE__ */ new Date();
+					await current.save();
+					return current;
+				}));
+			});
+		});
+	}
+	/** A moderator may make a row visible, hidden, pending, or deleted. */
+	async moderate(commentId, status) {
+		const comment = await this.getAuthorizedComment(commentId, "moderate");
+		if (![
+			"visible",
+			"hidden",
+			"pending",
+			"deleted"
+		].includes(status)) throw new TypeError("Invalid comment moderation status.");
+		return withTenant({ tenantId: comment.tenantId }, async () => {
+			const collection = await CommentCollection.create({ db: this.options.db });
+			if (!collection.db.transaction) throw new Error("Comment moderation requires transactions.");
+			return collection.db.transaction(async (tx) => {
+				const scoped = await CommentCollection.create({ db: tx });
+				const table = `"${scoped.tableName.replace(/"/g, "\"\"")}"`;
+				await tx.query(`UPDATE ${table} SET body = body WHERE id = ? AND tenant_id = ?`, commentId, comment.tenantId);
+				const current = await scoped.get(commentId);
+				if (!current) throw new Error("Comment not found.");
+				current.status = status;
+				await current.save();
+				return current;
+			});
+		});
+	}
+	/** One retained report per actor/comment; new reports consume shared report quota. */
+	async report(commentId, reason) {
+		if (!reason.trim()) throw new TypeError("Comment report reason is required.");
+		const comment = await this.getAuthorizedComment(commentId, "read");
+		if (comment.status !== "visible") throw new Error("Comment is not reportable.");
+		commentId = canonicalUuid(comment.id ?? commentId);
+		const tenantId = canonicalUuid(this.options.actor.tenantId);
+		const reporterUserId = canonicalUuid(this.options.actor.userId);
+		const request = {
+			tenantId,
+			actorUserId: reporterUserId,
+			action: "report",
+			recordType: comment.metaType,
+			recordId: comment.metaId
+		};
+		const guard = new ParticipationService({
+			db: this.options.db,
+			entitlement: this.options.participation
+		});
+		await guard.authorize(request);
+		return withTenant({ tenantId }, async () => {
+			const reports = await CommentReportCollection.create({ db: this.options.db });
+			const id = await runOnce({
+				db: reports.db,
+				tenantId,
+				actor: "smrt-comments.report:v1",
+				token: `${reporterUserId}:${canonicalUuid(commentId)}`,
+				content: "retained-report:v1"
+			}, async (tx) => {
+				const existing = await (await CommentReportCollection.create({ db: tx })).list({ where: {
+					tenantId,
+					reporterUserId,
+					commentId
+				} });
+				if (existing[0]) return existing[0].id;
+				return guard.executeInTransaction(tx, request, async (guardedTx) => {
+					const current = await withTenant({ tenantId: comment.tenantId }, async () => (await CommentCollection.create({ db: guardedTx })).get(commentId));
+					if (!current || current.status !== "visible") throw new Error("Comment is not reportable.");
+					return (await (await CommentReportCollection.create({ db: guardedTx })).create({
+						tenantId,
+						commentId,
+						reporterUserId,
+						reason: reason.trim(),
+						status: "open"
+					})).id;
+				});
+			});
+			const report = id ? await reports.get(id) : null;
+			if (!report || report.commentId !== canonicalUuid(commentId) || report.reporterUserId !== reporterUserId) throw new Error("Retained report unavailable.");
+			return report;
+		});
+	}
 	async listForRecord(recordType, recordId) {
 		await this.authorize(recordType, recordId, "read");
 		const tenantId = this.options.actor.tenantId;
@@ -187,12 +459,24 @@ var CommentService = class {
 		return row;
 	}
 	async create(commentOptions) {
-		const { tenantId: inputTenantId, authorUserId: inputAuthorUserId, metaType, metaId, body, mentions, idempotencyKey } = commentOptions;
+		const { tenantId: inputTenantId, authorUserId: inputAuthorUserId, metaType, metaId, body, mentions, idempotencyKey, parentCommentId: inputParentCommentId } = commentOptions;
+		const parentCommentId = inputParentCommentId ? canonicalUuid(inputParentCommentId) : inputParentCommentId;
 		if (!inputTenantId || !inputAuthorUserId) throw new TypeError("Comments require a tenant and author.");
 		if (canonicalUuid(inputTenantId) !== canonicalUuid(this.options.actor.tenantId) || canonicalUuid(inputAuthorUserId) !== canonicalUuid(this.options.actor.userId)) throw new Error("Comment actor context mismatch.");
 		const tenantId = this.options.actor.tenantId;
 		const authorUserId = this.options.actor.userId;
 		await this.authorize(metaType ?? "", metaId ?? "", "comment");
+		const participationRequest = {
+			tenantId,
+			actorUserId: authorUserId,
+			action: "comment",
+			recordType: metaType ?? "",
+			recordId: metaId ?? ""
+		};
+		await new ParticipationService({
+			db: this.options.db,
+			entitlement: this.options.participation
+		}).authorize(participationRequest);
 		if (!body?.trim()) throw new TypeError("Comment body is required.");
 		const prepared = new Comment();
 		if (mentions !== void 0) prepared.mentionUserIds = mentions;
@@ -204,27 +488,43 @@ var CommentService = class {
 			metaType,
 			metaId,
 			body,
-			mentions: normalizedMentions
+			mentions: normalizedMentions,
+			...parentCommentId ? { parentCommentId } : {}
 		});
 		const comment = await withTenant({ tenantId }, async () => {
 			const collection = await CommentCollection.create({ db: this.options.db });
-			const insert = async (target) => {
-				const id = crypto.randomUUID();
-				return target.create({
-					tenantId,
-					authorUserId,
-					metaType,
-					metaId,
-					body,
-					id,
-					slug: id,
-					context: "",
-					_insertOnly: true,
-					mentions: prepared.mentions,
-					idempotencyKey: idempotencyKey ?? null,
-					requestDigest: idempotencyKey === void 0 ? null : requestDigest,
-					retryTenantId: idempotencyKey === void 0 ? null : canonicalUuid(tenantId)
+			const insert = async (target, inTransaction = false) => {
+				const guard = new ParticipationService({
+					db: target.db,
+					entitlement: this.options.participation
+				});
+				const work = async (tx, participation) => withTenant({ tenantId }, async () => {
+					target = await CommentCollection.create({ db: tx });
+					if (parentCommentId) {
+						const parent = await target.get(parentCommentId);
+						if (!parent || canonicalUuid(parent.tenantId) !== canonicalUuid(tenantId) || parent.metaType !== metaType || parent.metaId !== metaId) throw new Error("Comment parent does not belong to this record.");
+					}
+					const id = crypto.randomUUID();
+					return target.create({
+						tenantId,
+						authorUserId,
+						metaType,
+						metaId,
+						body,
+						id,
+						slug: id,
+						context: "",
+						_insertOnly: true,
+						mentions: prepared.mentions,
+						idempotencyKey: idempotencyKey ?? null,
+						requestDigest: idempotencyKey === void 0 ? null : requestDigest,
+						retryTenantId: idempotencyKey === void 0 ? null : canonicalUuid(tenantId),
+						parentCommentId: parentCommentId ?? null,
+						status: participation.initialCommentStatus ?? "visible",
+						participationSnapshot: participation.snapshot ? JSON.stringify(participation.snapshot) : null
+					});
 				});
+				return inTransaction ? guard.executeInTransaction(target.db, participationRequest, work) : guard.execute(participationRequest, work);
 			};
 			if (idempotencyKey === void 0) return insert(collection);
 			const receipt = await runOnce({
@@ -237,7 +537,7 @@ var CommentService = class {
 				const scoped = await CommentCollection.create({ db: tx });
 				const matches = await tx.query(`SELECT CAST(id AS TEXT) AS id, CAST(tenant_id AS TEXT) AS tenant_id FROM "${scoped.tableName.replace(/"/g, "\"\"")}" WHERE retry_tenant_id = ? AND idempotency_key = ?`, canonicalUuid(tenantId), idempotencyKey);
 				if (matches.rows.length > 1) throw new CommentIdempotencyError("COMMENT_REQUEST_UNAVAILABLE");
-				const row2 = matches.rows[0] ? await this.loadBoundComment(tx, matches.rows[0], canonicalUuid(tenantId)) : await insert(scoped);
+				const row2 = matches.rows[0] ? await this.loadBoundComment(tx, matches.rows[0], canonicalUuid(tenantId)) : await insert(scoped, true);
 				return {
 					id: row2.id,
 					digest: row2.requestDigest,
@@ -246,17 +546,22 @@ var CommentService = class {
 			});
 			if (receipt.digest !== requestDigest) throw new CommentIdempotencyError("COMMENT_REQUEST_CONFLICT");
 			const row = await this.loadBoundComment(collection.db, receipt, canonicalUuid(tenantId));
-			if (!row || canonicalUuid(row.tenantId) !== canonicalUuid(tenantId) || row.idempotencyKey !== idempotencyKey || row.requestDigest !== requestDigest || digestRunOnceContent({
+			const retainedBodies = row.editedAt ? await withTenant({ tenantId: row.tenantId }, async () => (await (await CommentRevisionCollection.create({ db: collection.db })).list({ where: {
+				commentId: row.id,
+				tenantId: row.tenantId
+			} })).map((revision) => revision.body)) : [row.body];
+			if (canonicalUuid(row.tenantId) !== canonicalUuid(tenantId) || row.idempotencyKey !== idempotencyKey || row.requestDigest !== requestDigest || !retainedBodies.some((retainedBody) => digestRunOnceContent({
 				tenantId: canonicalUuid(row.tenantId),
 				authorUserId: canonicalUuid(row.authorUserId),
 				metaType: row.metaType,
 				metaId: row.metaId,
-				body: row.body,
-				mentions: [...row.mentionUserIds].sort()
-			}) !== requestDigest) throw new CommentIdempotencyError("COMMENT_REQUEST_UNAVAILABLE");
+				body: retainedBody,
+				mentions: [...row.mentionUserIds].sort(),
+				...row.parentCommentId ? { parentCommentId: canonicalUuid(row.parentCommentId) } : {}
+			}) === requestDigest)) throw new CommentIdempotencyError("COMMENT_REQUEST_UNAVAILABLE");
 			return row;
 		});
-		if (!this.options.mentionNotifications || !comment.id) return comment;
+		if (!this.options.mentionNotifications || !comment.id || comment.status !== "visible") return comment;
 		for (const recipientUserId of comment.mentionUserIds) {
 			if (canonicalUuid(recipientUserId) === canonicalUuid(comment.authorUserId)) continue;
 			await this.options.mentionNotifications.notifyMention({
@@ -288,6 +593,6 @@ function createCommentMentionNotifications(options) {
 	} };
 }
 //#endregion
-export { Comment, CommentCollection, CommentIdempotencyError, CommentService, RecordCommentsRecipe, createCommentMentionNotifications };
+export { Comment, CommentCollection, CommentIdempotencyError, CommentReport, CommentReportCollection, CommentRevision, CommentRevisionCollection, CommentService, ParticipationBan, ParticipationBanCollection, ParticipationDeniedError, ParticipationPolicy, ParticipationPolicyCollection, ParticipationRateBucket, ParticipationRateBucketCollection, ParticipationService, RecordCommentsRecipe, createCommentMentionNotifications };
 
 //# sourceMappingURL=index.js.map