@happyvertical/smrt-comments 0.57.1 → 0.57.3

package/README.md

@@ -21,6 +21,10 @@ const comments = new CommentService({
   db,
   actor: { tenantId: session.tenantId, userId: session.userId },
   authorizeRecord: access => records.authorize(access),
+  participation: {
+    // Supplies trusted membership and entitlement facts.
+    authorize: request => entitlements.authorize(request),
+  },
   mentionNotifications: createCommentMentionNotifications({
     notifications: new UserNotificationService({ db }), // smrt-messages
     canNotify: mention => records.recipientMayRead(mention),
@@ -28,6 +32,47 @@ const comments = new CommentService({
 });
 ```
 
+`participation` is an optional server-side entitlement adapter. It receives trusted
+identity and record/action inputs and returns `{ allowed, member?, snapshot? }`.
+Only literal `allowed: true` permits participation; `members_only` also requires
+`member: true`. The immutable JSON snapshot is retained on each new comment.
+
+`ParticipationService` owns reusable tenant/target policy selection, bans and
+atomic fixed-window rate reservations. All CommentService creates invoke it,
+even without an entitlement adapter. Configure `ParticipationPolicyCollection`
+and `ParticipationBanCollection` on trusted administrative server paths under
+`withTenant`; these models expose no automatic API/CLI/MCP operations. Migrate
+all comments package models before deploying. A missing policy defaults to open;
+an exact `(recordType, recordId, action)` policy replaces the tenant default
+(blank record pair). Modes are `open`, `pre_moderated`, `members_only`, `closed`.
+A duplicate applicable policy fails closed. Ban targets may be blank (tenant-wide)
+or exact; a null expiry means indefinite. Ban decisions do not expose reasons.
+
+`maxActions: 0` disables quota; otherwise set a positive integer `windowSeconds`.
+Quota is per tenant, actor, action and selected policy scope in fixed UTC epoch
+windows. A tenant policy shares quota across records. The persisted counter uses
+one bounded atomic upsert; reservation and protected mutation commit or roll back
+together. Never delete active rate buckets. Policy edits affect subsequent
+checks, not transactions already authorized; changing a window length starts a
+new quota namespace. Trusted administrators own policy and bucket retention.
+
+Reactions/polls import `ParticipationService` and neutral types from
+`@happyvertical/smrt-comments/participation`. Use `execute(request, (tx, decision)
+=> mutationUsing(tx))` for a new mutation. Within an existing transaction use
+`executeInTransaction(tx, request, callback)` and propagate errors so the owner
+rolls back. `authorize` checks current permission without spending quota. The
+consumer owns its durable idempotency binding: replay retained mutations after
+reauthorization, and call `execute` only for a genuinely new mutation. Comments
+already implement this composition. No subscription or journalism rules live here.
+
+`CommentService.edit` retains prior bodies and rechecks record/participation permission,
+bans and the comment-action quota in the same transaction. Edits spend quota and
+retain the original post-time snapshot. `report` appends a moderation report,
+and `moderate` checks the host's record-level moderation permission before changing
+visibility. Readers receive authorized projections; hosts filter non-visible rows
+for their audience. `ModerationQueue` accepts pending/reported projections and an
+`onmoderate` callback; the browser cannot grant moderation authority.
+
 The messages service is composed through a structural interface; there is no
 runtime dependency on messages. `canNotify` must check recipient membership and
 record access before exposing the comment. Notifications use a stable per-comment
@@ -71,3 +116,30 @@ tenant and author references. UUID casing changes across trusted actor contexts
 reuse the same comment, including after generic receipt retention. Unkeyed legacy SQLite
 listing remains scoped to its original tenant spelling; keyed rows are merged
 by equivalent UUID tenant without folding arbitrary textual tenant IDs.
+
+Use lowercase UUIDs for administrative policy/ban tenant, actor and target identities;
+request UUIDs are canonicalized before enforcement. Text identifiers retain case.
+Thread projections may include `parentCommentId`; supply `onreply(parentId, body)`
+to enable the reply composer. Host callbacks persist replies with that parent ID.
+
+Edits to visible comments return to pending when current policy or entitlement
+requires pre-moderation; edits never restore hidden or deleted comments.
+
+Reports use the separate `report` participation action, so hosts can configure
+report-specific limits without coupling them to comment quotas. Bans and entitlement
+checks apply to every report attempt. Only visible comments are reportable. Each
+actor/comment pair retains one report, including after generic receipt cleanup;
+retries return that report without consuming quota or replacing its original reason.
+
+Parentless keyed-create digests preserve the original v1 shape across upgrades.
+After an authorized edit, replay verifies the original creation body against retained
+revision history and returns the current comment; edited content is not a new create
+payload. Revision history must be retained while the keyed comment is retained.
+
+Mention delivery is limited to visible comments, including keyed retries. Pending,
+hidden and deleted bodies never reach the mention adapter. Approval does not
+send notifications automatically; hosts may explicitly retry the original keyed
+create after approval to recover delivery. Moderation uses the save lifecycle on
+a locked and freshly reloaded row, preserving change-feed and cache invalidation.
+Parent comment UUIDs are canonicalized before lookup, persistence and retry hashing.
+Reply-only embeds show a composer only while a reply target is selected.

package/dist/chunks/participation-LA_cfrM2.js

@@ -0,0 +1,276 @@
+import { ObjectRegistry, SmrtCollection, SmrtObject, digestRunOnceContent, field, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, 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.3","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  \\"parent_comment_id\\" UUID,\\n  \\"status\\" TEXT NOT NULL DEFAULT 'visible',\\n  \\"participation_snapshot\\" TEXT,\\n  \\"edited_at\\" TIMESTAMP\\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},"parent_comment_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false},"status":{"type":"TEXT","notNull":true,"unique":false,"default":"visible"},"participation_snapshot":{"type":"TEXT","notNull":false,"unique":false},"edited_at":{"type":"TIMESTAMP","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_parent_created_idx","columns":["tenant_id","parent_comment_id","created_at"]},{"name":"record_comments_moderation_idx","columns":["tenant_id","status","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"]},{"name":"record_comments_parent_comment_id_idx","columns":["parent_comment_id"]}],"version":"35c502ab"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:CommentReportCollection":{"name":"commentreportcollection","className":"CommentReportCollection","qualifiedName":"@happyvertical/smrt-comments:CommentReportCollection","collection":"commentreports","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/collections/CommentReportCollection.ts","packageName":"@happyvertical/smrt-comments","fields":{},"methods":{},"decoratorConfig":{"tableName":"comment_reports","api":false,"mcp":false,"cli":false},"extends":"SmrtCollection","extendsTypeArg":"CommentReport","exportName":"CommentReportCollection","collectionExportName":"CommentReportCollectionCollection","schema":{"tableName":"comment_reports","ddl":"CREATE TABLE IF NOT EXISTS \\"comment_reports\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"comment_id\\" UUID NOT NULL,\\n  \\"reporter_user_id\\" UUID NOT NULL,\\n  \\"reason\\" TEXT NOT NULL,\\n  \\"status\\" TEXT NOT NULL DEFAULT 'open'\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"comment_id":{"type":"UUID","referenceKind":"foreignKey","notNull":true,"unique":false},"reporter_user_id":{"type":"UUID","referenceKind":"crossPackageRef","notNull":true,"unique":false},"reason":{"type":"TEXT","notNull":true,"unique":false},"status":{"type":"TEXT","notNull":true,"unique":false,"default":"open"}},"indexes":[{"name":"comment_reports_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"comment_reports_actor_target_unique","columns":["tenant_id","reporter_user_id","comment_id"],"unique":true},{"name":"comment_reports_queue_idx","columns":["tenant_id","status","created_at"]},{"name":"comment_reports_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"comment_reports_comment_id_idx","columns":["comment_id"]},{"name":"comment_reports_reporter_user_id_idx","columns":["reporter_user_id"]}],"version":"001951c2"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:CommentRevisionCollection":{"name":"commentrevisioncollection","className":"CommentRevisionCollection","qualifiedName":"@happyvertical/smrt-comments:CommentRevisionCollection","collection":"commentrevisions","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/collections/CommentRevisionCollection.ts","packageName":"@happyvertical/smrt-comments","fields":{},"methods":{},"decoratorConfig":{"tableName":"comment_revisions","api":false,"mcp":false,"cli":false},"extends":"SmrtCollection","extendsTypeArg":"CommentRevision","exportName":"CommentRevisionCollection","collectionExportName":"CommentRevisionCollectionCollection","schema":{"tableName":"comment_revisions","ddl":"CREATE TABLE IF NOT EXISTS \\"comment_revisions\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"comment_id\\" UUID NOT NULL,\\n  \\"editor_user_id\\" UUID NOT NULL,\\n  \\"body\\" TEXT NOT NULL\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"comment_id":{"type":"UUID","referenceKind":"foreignKey","notNull":true,"unique":false},"editor_user_id":{"type":"UUID","referenceKind":"crossPackageRef","notNull":true,"unique":false},"body":{"type":"TEXT","notNull":true,"unique":false}},"indexes":[{"name":"comment_revisions_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"comment_revisions_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"comment_revisions_comment_id_idx","columns":["comment_id"]},{"name":"comment_revisions_editor_user_id_idx","columns":["editor_user_id"]}],"version":"69ea301e"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:ParticipationPolicyCollection":{"name":"participationpolicycollection","className":"ParticipationPolicyCollection","qualifiedName":"@happyvertical/smrt-comments:ParticipationPolicyCollection","collection":"participationpolicies","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/collections/ParticipationCollection.ts","packageName":"@happyvertical/smrt-comments","fields":{},"methods":{},"decoratorConfig":{"tableName":"participation_policies","api":false,"mcp":false,"cli":false},"extends":"SmrtCollection","extendsTypeArg":"ParticipationPolicy","exportName":"ParticipationPolicyCollection","collectionExportName":"ParticipationPolicyCollectionCollection","schema":{"tableName":"participation_policies","ddl":"CREATE TABLE IF NOT EXISTS \\"participation_policies\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"record_type\\" TEXT,\\n  \\"record_id\\" TEXT,\\n  \\"action\\" TEXT NOT NULL,\\n  \\"moderation_mode\\" TEXT NOT NULL DEFAULT 'open',\\n  \\"max_actions\\" INTEGER NOT NULL DEFAULT 0,\\n  \\"window_seconds\\" INTEGER NOT NULL DEFAULT 0\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"record_type":{"type":"TEXT","notNull":false,"unique":false},"record_id":{"type":"TEXT","notNull":false,"unique":false},"action":{"type":"TEXT","notNull":true,"unique":false},"moderation_mode":{"type":"TEXT","notNull":true,"unique":false,"default":"open"},"max_actions":{"type":"INTEGER","notNull":true,"unique":false,"default":0},"window_seconds":{"type":"INTEGER","notNull":true,"unique":false,"default":0}},"indexes":[{"name":"participation_policies_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"participation_policies_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"7f2fdd9d"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:ParticipationBanCollection":{"name":"participationbancollection","className":"ParticipationBanCollection","qualifiedName":"@happyvertical/smrt-comments:ParticipationBanCollection","collection":"participationbans","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/collections/ParticipationCollection.ts","packageName":"@happyvertical/smrt-comments","fields":{},"methods":{},"decoratorConfig":{"tableName":"participation_bans","api":false,"mcp":false,"cli":false},"extends":"SmrtCollection","extendsTypeArg":"ParticipationBan","exportName":"ParticipationBanCollection","collectionExportName":"ParticipationBanCollectionCollection","schema":{"tableName":"participation_bans","ddl":"CREATE TABLE IF NOT EXISTS \\"participation_bans\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"actor_user_id\\" TEXT NOT NULL,\\n  \\"record_type\\" TEXT,\\n  \\"record_id\\" TEXT,\\n  \\"reason\\" TEXT NOT NULL,\\n  \\"expires_at\\" TIMESTAMP\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"actor_user_id":{"type":"TEXT","notNull":true,"unique":false},"record_type":{"type":"TEXT","notNull":false,"unique":false},"record_id":{"type":"TEXT","notNull":false,"unique":false},"reason":{"type":"TEXT","notNull":true,"unique":false},"expires_at":{"type":"TIMESTAMP","notNull":false,"unique":false}},"indexes":[{"name":"participation_bans_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"participation_bans_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"27bbfb94"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:ParticipationRateBucketCollection":{"name":"participationratebucketcollection","className":"ParticipationRateBucketCollection","qualifiedName":"@happyvertical/smrt-comments:ParticipationRateBucketCollection","collection":"participationratebuckets","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/collections/ParticipationCollection.ts","packageName":"@happyvertical/smrt-comments","fields":{},"methods":{},"decoratorConfig":{"tableName":"participation_rate_buckets","api":false,"mcp":false,"cli":false},"extends":"SmrtCollection","extendsTypeArg":"ParticipationRateBucket","exportName":"ParticipationRateBucketCollection","collectionExportName":"ParticipationRateBucketCollectionCollection","schema":{"tableName":"participation_rate_buckets","ddl":"CREATE TABLE IF NOT EXISTS \\"participation_rate_buckets\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"bucket_key\\" TEXT NOT NULL,\\n  \\"action_count\\" INTEGER NOT NULL DEFAULT 0\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"bucket_key":{"type":"TEXT","notNull":true,"unique":false},"action_count":{"type":"INTEGER","notNull":true,"unique":false,"default":0}},"indexes":[{"name":"participation_rate_buckets_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"participation_rate_bucket_unique","columns":["tenant_id","bucket_key"],"unique":true},{"name":"participation_rate_buckets_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"9f3707e0"},"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},"parentCommentId":{"type":"foreignKey","required":false,"related":"Comment","_meta":{"nullable":true,"constraint":false}},"status":{"type":"text","required":true,"default":"visible","_meta":{"required":true},"enum":["visible","hidden","pending","deleted"]},"participationSnapshot":{"type":"text","required":false,"_meta":{"nullable":true,"readonly":true},"readonly":true},"editedAt":{"type":"datetime","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"]},{"name":"record_comments_parent_created_idx","columns":["tenantId","parentCommentId","createdAt"]},{"name":"record_comments_moderation_idx","columns":["tenantId","status","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"},{"field":"status","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  \\"parent_comment_id\\" UUID,\\n  \\"status\\" TEXT NOT NULL DEFAULT 'visible',\\n  \\"participation_snapshot\\" TEXT,\\n  \\"edited_at\\" TIMESTAMP\\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},"parent_comment_id":{"type":"UUID","referenceKind":"foreignKey","notNull":false,"unique":false},"status":{"type":"TEXT","notNull":true,"unique":false,"default":"visible"},"participation_snapshot":{"type":"TEXT","notNull":false,"unique":false},"edited_at":{"type":"TIMESTAMP","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_parent_created_idx","columns":["tenant_id","parent_comment_id","created_at"]},{"name":"record_comments_moderation_idx","columns":["tenant_id","status","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"]},{"name":"record_comments_parent_comment_id_idx","columns":["parent_comment_id"]}],"version":"35c502ab"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:CommentReport":{"name":"commentreport","className":"CommentReport","qualifiedName":"@happyvertical/smrt-comments:CommentReport","collection":"commentreports","description":"A tenant-local report; moderation resolution never deletes the report.","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/models/CommentReport.ts","packageName":"@happyvertical/smrt-comments","fields":{"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}}},"commentId":{"type":"foreignKey","required":true,"related":"Comment","_meta":{"required":true,"constraint":false}},"reporterUserId":{"type":"crossPackageRef","required":true,"related":"@happyvertical/smrt-users:User"},"reason":{"type":"text","required":true,"_meta":{"required":true}},"status":{"type":"text","required":true,"default":"open","_meta":{"required":true},"enum":["open","resolved","dismissed"]}},"methods":{},"decoratorConfig":{"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"]}],"tenantScoped":{"mode":"required"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"CommentReport","collectionExportName":"CommentReportCollection","validationRules":[{"field":"commentId","rule":"required","fieldType":"foreignKey"},{"field":"reporterUserId","rule":"required","fieldType":"crossPackageRef"},{"field":"reason","rule":"required","fieldType":"text"},{"field":"status","rule":"required","fieldType":"text"}],"schema":{"tableName":"comment_reports","ddl":"CREATE TABLE IF NOT EXISTS \\"comment_reports\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"comment_id\\" UUID NOT NULL,\\n  \\"reporter_user_id\\" UUID NOT NULL,\\n  \\"reason\\" TEXT NOT NULL,\\n  \\"status\\" TEXT NOT NULL DEFAULT 'open'\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"comment_id":{"type":"UUID","referenceKind":"foreignKey","notNull":true,"unique":false},"reporter_user_id":{"type":"UUID","referenceKind":"crossPackageRef","notNull":true,"unique":false},"reason":{"type":"TEXT","notNull":true,"unique":false},"status":{"type":"TEXT","notNull":true,"unique":false,"default":"open"}},"indexes":[{"name":"comment_reports_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"comment_reports_actor_target_unique","columns":["tenant_id","reporter_user_id","comment_id"],"unique":true},{"name":"comment_reports_queue_idx","columns":["tenant_id","status","created_at"]},{"name":"comment_reports_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"comment_reports_comment_id_idx","columns":["comment_id"]},{"name":"comment_reports_reporter_user_id_idx","columns":["reporter_user_id"]}],"version":"001951c2"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:CommentRevision":{"name":"commentrevision","className":"CommentRevision","qualifiedName":"@happyvertical/smrt-comments:CommentRevision","collection":"commentrevisions","description":"Immutable prior body retained whenever an author edits a comment.","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/models/CommentRevision.ts","packageName":"@happyvertical/smrt-comments","fields":{"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}}},"commentId":{"type":"foreignKey","required":true,"related":"Comment","_meta":{"required":true,"constraint":false}},"editorUserId":{"type":"crossPackageRef","required":true,"related":"@happyvertical/smrt-users:User"},"body":{"type":"text","required":true,"_meta":{"required":true}}},"methods":{},"decoratorConfig":{"tableName":"comment_revisions","api":false,"mcp":false,"cli":false,"tenantScoped":{"mode":"required"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"CommentRevision","collectionExportName":"CommentRevisionCollection","validationRules":[{"field":"commentId","rule":"required","fieldType":"foreignKey"},{"field":"editorUserId","rule":"required","fieldType":"crossPackageRef"},{"field":"body","rule":"required","fieldType":"text"}],"schema":{"tableName":"comment_revisions","ddl":"CREATE TABLE IF NOT EXISTS \\"comment_revisions\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"comment_id\\" UUID NOT NULL,\\n  \\"editor_user_id\\" UUID NOT NULL,\\n  \\"body\\" TEXT NOT NULL\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"comment_id":{"type":"UUID","referenceKind":"foreignKey","notNull":true,"unique":false},"editor_user_id":{"type":"UUID","referenceKind":"crossPackageRef","notNull":true,"unique":false},"body":{"type":"TEXT","notNull":true,"unique":false}},"indexes":[{"name":"comment_revisions_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"comment_revisions_tenant_id_created_at_idx","columns":["tenant_id","created_at"]},{"name":"comment_revisions_comment_id_idx","columns":["comment_id"]},{"name":"comment_revisions_editor_user_id_idx","columns":["editor_user_id"]}],"version":"69ea301e"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:ParticipationBan":{"name":"participationban","className":"ParticipationBan","qualifiedName":"@happyvertical/smrt-comments:ParticipationBan","collection":"participationbans","description":"Tenant-local, reusable participation ban; a blank target applies tenant-wide.","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/models/ParticipationBan.ts","packageName":"@happyvertical/smrt-comments","fields":{"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}}},"actorUserId":{"type":"text","required":true,"_meta":{"required":true}},"recordType":{"type":"text","required":false},"recordId":{"type":"text","required":false},"reason":{"type":"text","required":true,"_meta":{"required":true}},"expiresAt":{"type":"datetime","required":false,"_meta":{"nullable":true}}},"methods":{},"decoratorConfig":{"tableName":"participation_bans","api":false,"mcp":false,"cli":false,"tenantScoped":{"mode":"required"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"ParticipationBan","collectionExportName":"ParticipationBanCollection","validationRules":[{"field":"actorUserId","rule":"required","fieldType":"text"},{"field":"reason","rule":"required","fieldType":"text"}],"schema":{"tableName":"participation_bans","ddl":"CREATE TABLE IF NOT EXISTS \\"participation_bans\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"actor_user_id\\" TEXT NOT NULL,\\n  \\"record_type\\" TEXT,\\n  \\"record_id\\" TEXT,\\n  \\"reason\\" TEXT NOT NULL,\\n  \\"expires_at\\" TIMESTAMP\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"actor_user_id":{"type":"TEXT","notNull":true,"unique":false},"record_type":{"type":"TEXT","notNull":false,"unique":false},"record_id":{"type":"TEXT","notNull":false,"unique":false},"reason":{"type":"TEXT","notNull":true,"unique":false},"expires_at":{"type":"TIMESTAMP","notNull":false,"unique":false}},"indexes":[{"name":"participation_bans_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"participation_bans_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"27bbfb94"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:ParticipationPolicy":{"name":"participationpolicy","className":"ParticipationPolicy","qualifiedName":"@happyvertical/smrt-comments:ParticipationPolicy","collection":"participationpolicies","description":"A generic tenant default or exact-record override for participation actions.","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/models/ParticipationPolicy.ts","packageName":"@happyvertical/smrt-comments","fields":{"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}}},"recordType":{"type":"text","required":false},"recordId":{"type":"text","required":false},"action":{"type":"text","required":true,"_meta":{"required":true}},"moderationMode":{"type":"text","required":true,"default":"open","_meta":{"required":true},"enum":["open","pre_moderated","members_only","closed"]},"maxActions":{"type":"integer","required":true,"default":0,"_meta":{"required":true}},"windowSeconds":{"type":"integer","required":true,"default":0,"_meta":{"required":true}}},"methods":{},"decoratorConfig":{"tableName":"participation_policies","api":false,"mcp":false,"cli":false,"tenantScoped":{"mode":"required"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"ParticipationPolicy","collectionExportName":"ParticipationPolicyCollection","validationRules":[{"field":"action","rule":"required","fieldType":"text"},{"field":"moderationMode","rule":"required","fieldType":"text"},{"field":"maxActions","rule":"required","fieldType":"integer"},{"field":"windowSeconds","rule":"required","fieldType":"integer"}],"schema":{"tableName":"participation_policies","ddl":"CREATE TABLE IF NOT EXISTS \\"participation_policies\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"record_type\\" TEXT,\\n  \\"record_id\\" TEXT,\\n  \\"action\\" TEXT NOT NULL,\\n  \\"moderation_mode\\" TEXT NOT NULL DEFAULT 'open',\\n  \\"max_actions\\" INTEGER NOT NULL DEFAULT 0,\\n  \\"window_seconds\\" INTEGER NOT NULL DEFAULT 0\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"record_type":{"type":"TEXT","notNull":false,"unique":false},"record_id":{"type":"TEXT","notNull":false,"unique":false},"action":{"type":"TEXT","notNull":true,"unique":false},"moderation_mode":{"type":"TEXT","notNull":true,"unique":false,"default":"open"},"max_actions":{"type":"INTEGER","notNull":true,"unique":false,"default":0},"window_seconds":{"type":"INTEGER","notNull":true,"unique":false,"default":0}},"indexes":[{"name":"participation_policies_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"participation_policies_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"7f2fdd9d"},"importPath":"@happyvertical/smrt-comments"},"@happyvertical/smrt-comments:ParticipationRateBucket":{"name":"participationratebucket","className":"ParticipationRateBucket","qualifiedName":"@happyvertical/smrt-comments:ParticipationRateBucket","collection":"participationratebuckets","description":"Service-owned fixed-window counter. Never delete a currently active bucket.","filePath":"/home/runner/work/smrt/smrt/packages/comments/src/models/ParticipationRateBucket.ts","packageName":"@happyvertical/smrt-comments","fields":{"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}}},"bucketKey":{"type":"text","required":true,"_meta":{"required":true}},"actionCount":{"type":"integer","required":true,"default":0,"_meta":{"required":true}}},"methods":{},"decoratorConfig":{"tableName":"participation_rate_buckets","api":false,"mcp":false,"cli":false,"indexes":[{"name":"participation_rate_bucket_unique","columns":["tenantId","bucketKey"],"unique":true}],"tenantScoped":{"mode":"required"},"conflictColumns":["tenant_id","slug","context"]},"extends":"SmrtObject","exportName":"ParticipationRateBucket","collectionExportName":"ParticipationRateBucketCollection","validationRules":[{"field":"bucketKey","rule":"required","fieldType":"text"},{"field":"actionCount","rule":"required","fieldType":"integer"}],"schema":{"tableName":"participation_rate_buckets","ddl":"CREATE TABLE IF NOT EXISTS \\"participation_rate_buckets\\" (\\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  \\"tenant_id\\" UUID NOT NULL,\\n  \\"bucket_key\\" TEXT NOT NULL,\\n  \\"action_count\\" INTEGER NOT NULL DEFAULT 0\\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"},"tenant_id":{"type":"UUID","referenceKind":"tenantId","notNull":true,"unique":false},"bucket_key":{"type":"TEXT","notNull":true,"unique":false},"action_count":{"type":"INTEGER","notNull":true,"unique":false,"default":0}},"indexes":[{"name":"participation_rate_buckets_slug_context_idx","columns":["tenant_id","slug","context"],"unique":true},{"name":"participation_rate_bucket_unique","columns":["tenant_id","bucket_key"],"unique":true},{"name":"participation_rate_buckets_tenant_id_created_at_idx","columns":["tenant_id","created_at"]}],"version":"9f3707e0"},"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","@happyvertical/smrt-comments:CommentRevision","@happyvertical/smrt-comments:CommentReport","@happyvertical/smrt-comments:ParticipationPolicy","@happyvertical/smrt-comments:ParticipationBan","@happyvertical/smrt-comments:ParticipationRateBucket"],"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/ParticipationBan.ts
+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$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$2(target, key, result);
+	return result;
+};
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+var ParticipationBan = class extends SmrtObject {
+	tenantId = "";
+	actorUserId = "";
+	recordType = "";
+	recordId = "";
+	reason = "";
+	expiresAt = null;
+	async validateBeforeSave() {
+		for (const identity of [
+			this.tenantId,
+			this.actorUserId,
+			this.recordId
+		]) if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(identity) && identity !== identity.toLowerCase()) throw new TypeError("Participation administrative UUIDs must be lowercase.");
+		if (Boolean(this.recordType) !== Boolean(this.recordId)) throw new TypeError("Participation target requires both recordType and recordId.");
+		await super.validateBeforeSave();
+	}
+};
+__publicField$2(ParticipationBan, "__smrtPackage__", "@happyvertical/smrt-comments");
+__decorateClass$2([tenantId()], ParticipationBan.prototype, "tenantId", 2);
+__decorateClass$2([field({ required: true })], ParticipationBan.prototype, "actorUserId", 2);
+__decorateClass$2([field()], ParticipationBan.prototype, "recordType", 2);
+__decorateClass$2([field()], ParticipationBan.prototype, "recordId", 2);
+__decorateClass$2([field({ required: true })], ParticipationBan.prototype, "reason", 2);
+__decorateClass$2([field({
+	type: "datetime",
+	nullable: true
+})], ParticipationBan.prototype, "expiresAt", 2);
+ParticipationBan = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
+	tableName: "participation_bans",
+	api: false,
+	mcp: false,
+	cli: false
+})], ParticipationBan);
+//#endregion
+//#region src/models/ParticipationPolicy.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 ParticipationPolicy = class extends SmrtObject {
+	tenantId = "";
+	recordType = "";
+	recordId = "";
+	action = "comment";
+	moderationMode = "open";
+	maxActions = 0;
+	windowSeconds = 0;
+	async validateBeforeSave() {
+		for (const identity of [this.tenantId, this.recordId]) if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(identity) && identity !== identity.toLowerCase()) throw new TypeError("Participation administrative UUIDs must be lowercase.");
+		if (Boolean(this.recordType) !== Boolean(this.recordId)) throw new TypeError("Participation target requires both recordType and recordId.");
+		if (![
+			"comment",
+			"react",
+			"vote",
+			"report"
+		].includes(this.action) || ![
+			"open",
+			"pre_moderated",
+			"members_only",
+			"closed"
+		].includes(this.moderationMode) || !Number.isSafeInteger(this.maxActions) || this.maxActions < 0 || !Number.isSafeInteger(this.windowSeconds) || this.windowSeconds < 0 || this.maxActions > 0 && this.windowSeconds === 0) throw new TypeError("Invalid participation policy.");
+		await super.validateBeforeSave();
+	}
+};
+__publicField$1(ParticipationPolicy, "__smrtPackage__", "@happyvertical/smrt-comments");
+__decorateClass$1([tenantId()], ParticipationPolicy.prototype, "tenantId", 2);
+__decorateClass$1([field()], ParticipationPolicy.prototype, "recordType", 2);
+__decorateClass$1([field()], ParticipationPolicy.prototype, "recordId", 2);
+__decorateClass$1([field({ required: true })], ParticipationPolicy.prototype, "action", 2);
+__decorateClass$1([field({ required: true })], ParticipationPolicy.prototype, "moderationMode", 2);
+__decorateClass$1([field({ required: true })], ParticipationPolicy.prototype, "maxActions", 2);
+__decorateClass$1([field({ required: true })], ParticipationPolicy.prototype, "windowSeconds", 2);
+ParticipationPolicy = __decorateClass$1([TenantScoped({ mode: "required" }), smrt({
+	tableName: "participation_policies",
+	api: false,
+	mcp: false,
+	cli: false
+})], ParticipationPolicy);
+//#endregion
+//#region src/models/ParticipationRateBucket.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 ParticipationRateBucket = class extends SmrtObject {
+	tenantId = "";
+	bucketKey = "";
+	actionCount = 0;
+};
+__publicField(ParticipationRateBucket, "__smrtPackage__", "@happyvertical/smrt-comments");
+__decorateClass([tenantId()], ParticipationRateBucket.prototype, "tenantId", 2);
+__decorateClass([field({ required: true })], ParticipationRateBucket.prototype, "bucketKey", 2);
+__decorateClass([field({ required: true })], ParticipationRateBucket.prototype, "actionCount", 2);
+ParticipationRateBucket = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	tableName: "participation_rate_buckets",
+	api: false,
+	mcp: false,
+	cli: false,
+	indexes: [{
+		name: "participation_rate_bucket_unique",
+		columns: ["tenantId", "bucketKey"],
+		unique: true
+	}]
+})], ParticipationRateBucket);
+//#endregion
+//#region src/collections/ParticipationCollection.ts
+var ParticipationPolicyCollection = class extends SmrtCollection {
+	static _itemClass = ParticipationPolicy;
+};
+var ParticipationBanCollection = class extends SmrtCollection {
+	static _itemClass = ParticipationBan;
+};
+var ParticipationRateBucketCollection = class extends SmrtCollection {
+	static _itemClass = ParticipationRateBucket;
+};
+//#endregion
+//#region src/participation-contract.ts
+var ParticipationDeniedError = class extends Error {
+	constructor(reason) {
+		super(reason ? `Participation denied: ${reason}` : "Participation denied.");
+		this.reason = reason;
+		this.name = "ParticipationDeniedError";
+	}
+	reason;
+};
+//#endregion
+//#region src/services/ParticipationService.ts
+var canonical = (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 ParticipationService = class {
+	constructor(options) {
+		this.options = options;
+	}
+	options;
+	normalize(request) {
+		if (!request || ![
+			"comment",
+			"react",
+			"vote",
+			"report"
+		].includes(request.action) || [
+			request.tenantId,
+			request.actorUserId,
+			request.recordType,
+			request.recordId
+		].some((value) => typeof value !== "string" || !value.trim())) throw new TypeError("Invalid participation request.");
+		return {
+			...request,
+			tenantId: canonical(request.tenantId),
+			actorUserId: canonical(request.actorUserId),
+			recordId: canonical(request.recordId)
+		};
+	}
+	async evaluate(request, db) {
+		const now = (this.options.now?.() ?? /* @__PURE__ */ new Date()).getTime();
+		if (!Number.isFinite(now)) throw new TypeError("Invalid participation clock.");
+		const rows = await (await ParticipationPolicyCollection.create({ db })).list({ where: {
+			tenantId: request.tenantId,
+			action: request.action
+		} });
+		const exact = rows.filter((p) => p.recordType === request.recordType && p.recordId === request.recordId);
+		const defaults = rows.filter((p) => p.recordType === "" && p.recordId === "");
+		if (exact.length > 1 || defaults.length > 1) throw new ParticipationDeniedError("Ambiguous participation policy.");
+		const policy = exact[0] ?? defaults[0];
+		if (policy && (![
+			"open",
+			"pre_moderated",
+			"members_only",
+			"closed"
+		].includes(policy.moderationMode) || !Number.isSafeInteger(policy.maxActions) || policy.maxActions < 0 || !Number.isSafeInteger(policy.windowSeconds) || policy.windowSeconds < 0 || policy.maxActions > 0 && policy.windowSeconds < 1)) throw new ParticipationDeniedError("Invalid participation policy.");
+		if (policy?.moderationMode === "closed") throw new ParticipationDeniedError("Participation is closed.");
+		const bans = await ParticipationBanCollection.create({ db });
+		for (const ban of await bans.list({ where: {
+			tenantId: request.tenantId,
+			actorUserId: request.actorUserId
+		} })) if (ban.recordType === "" && ban.recordId === "" || ban.recordType === request.recordType && ban.recordId === request.recordId) {
+			const expiry = ban.expiresAt === null ? null : new Date(ban.expiresAt).getTime();
+			if (expiry === null || !Number.isFinite(expiry) || expiry > now) throw new ParticipationDeniedError("Actor is banned.");
+		}
+		const decision = this.options.entitlement ? await this.options.entitlement.authorize(request) : { allowed: true };
+		if (decision?.allowed !== true || policy?.moderationMode === "members_only" && decision.member !== true) throw new ParticipationDeniedError(decision?.reason ?? "Membership required.");
+		if (decision.initialCommentStatus !== void 0 && !["visible", "pending"].includes(decision.initialCommentStatus)) throw new ParticipationDeniedError("Invalid moderation decision.");
+		return {
+			policy,
+			now,
+			decision: {
+				...decision,
+				initialCommentStatus: policy?.moderationMode === "pre_moderated" ? "pending" : decision.initialCommentStatus
+			}
+		};
+	}
+	/** Checks current permission without consuming quota (including keyed replays). */
+	async authorize(input) {
+		const request = this.normalize(input);
+		return withTenant({ tenantId: request.tenantId }, async () => (await this.evaluate(request, this.options.db)).decision);
+	}
+	async reserve(db, request, policy, now) {
+		if (!policy?.maxActions) return;
+		const buckets = await ParticipationRateBucketCollection.create({ db });
+		const bucketKey = digestRunOnceContent({
+			actor: request.actorUserId,
+			action: request.action,
+			recordType: policy.recordType,
+			recordId: policy.recordId,
+			windowSeconds: policy.windowSeconds,
+			window: Math.floor(now / (policy.windowSeconds * 1e3))
+		});
+		const table = `"${buckets.tableName.replace(/"/g, "\"\"")}"`;
+		const id = crypto.randomUUID();
+		if ((await db.query(`INSERT INTO ${table} (id, slug, context, tenant_id, bucket_key, action_count) VALUES (?, ?, '', ?, ?, 1) ON CONFLICT (tenant_id, bucket_key) DO UPDATE SET action_count = ${table}.action_count + 1 WHERE ${table}.action_count < ? RETURNING action_count`, id, id, request.tenantId, bucketKey, policy.maxActions)).rows.length !== 1) throw new ParticipationDeniedError("Rate limit exceeded.");
+	}
+	/** Run one new mutation atomically with its reservation. Caller owns retry identity. */
+	async execute(input, work) {
+		const request = this.normalize(input);
+		return withTenant({ tenantId: request.tenantId }, async () => {
+			const collection = await ParticipationRateBucketCollection.create({ db: this.options.db });
+			if (!collection.db.transaction) throw new Error("Participation requires transactions.");
+			return collection.db.transaction((tx) => this.executeInTransaction(tx, request, work));
+		});
+	}
+	/** Compose with an existing caller-owned transaction; propagate failures to roll it back. */
+	async executeInTransaction(tx, input, work) {
+		const request = this.normalize(input);
+		return withTenant({ tenantId: request.tenantId }, async () => {
+			const { policy, now, decision } = await this.evaluate(request, tx);
+			await this.reserve(tx, request, policy, now);
+			return work(tx, decision);
+		});
+	}
+};
+//#endregion
+export { ParticipationRateBucketCollection as a, ParticipationBan as c, ParticipationPolicyCollection as i, ParticipationDeniedError as n, ParticipationRateBucket as o, ParticipationBanCollection as r, ParticipationPolicy as s, ParticipationService as t };
+
+//# sourceMappingURL=participation-LA_cfrM2.js.map