@happyvertical/smrt-comments 0.0.0-stage → 0.55.11

package/AGENTS.md

@@ -0,0 +1,17 @@
+# @happyvertical/smrt-comments
+
+Record discussions attach to arbitrary records through `Comment`'s inherited
+`metaType` and `metaId`; preserve these as a qualified polymorphic pair and
+never replace them with a text foreign key. `CommentService` owns persistence
+and invokes the optional mention adapter only after the comment is saved.
+
+The package must not depend on `smrt-messages`: hosts compose
+`CommentMentionNotificationAdapter` with `UserNotificationService` and retain
+their own notification delivery policy. The Svelte surface receives authorized
+comment projections and callbacks; it does not fetch or authorize records.
+`CommentService` requires a trusted actor and host record authorization callback.
+`RecordComments.contextKey` includes tenant, actor and record identity.
+See [test design](agents/test-design.md) for the behavior matrix.
+
+Run `pnpm --filter @happyvertical/smrt-comments test`, `test:postgres`, `typecheck`, `check`, and
+`npx --yes @biomejs/biome@2.5.2 check packages/comments` after changes.

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# @happyvertical/smrt-comments
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Tenant-scoped polymorphic record comments, mention notification composition,
+and a browser-safe `RecordComments` Svelte component.
+
+Use `CommentService` on the server with a trusted `{ tenantId, userId }` actor
+from the authenticated session and an `authorizeRecord` callback. The callback
+must verify that the record belongs to that tenant and that the actor may read
+or comment on it. Both `create` and `listForRecord` require that decision; request
+bodies cannot override the actor. Direct model/collection APIs are persistence
+primitives for trusted code, not authorization boundaries. Generated API, MCP,
+and CLI access is disabled.
+
+```ts
+const comments = new CommentService({
+  db,
+  actor: { tenantId: session.tenantId, userId: session.userId },
+  authorizeRecord: access => records.authorize(access),
+  mentionNotifications: createCommentMentionNotifications({
+    notifications: new UserNotificationService({ db }), // smrt-messages
+    canNotify: mention => records.recipientMayRead(mention),
+  }),
+});
+```
+
+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
+source reference so adapter replays deduplicate. Mentions are UUIDs, deduplicated,
+and limited to 50; self-mentions do not notify. No adapter means no notifications.
+Mention validation finishes before the single comment insert; invalid or over-limit
+mentions leave no saved row. The comment is saved before notification delivery. A delivery rejection leaves
+the comment saved: reload it and retry delivery, not `create`, which creates a
+new comment. The component warns users to refresh and check the discussion before
+posting again when submission rejects. Delivery and persistence are deliberately not one transaction.
+
+Import `RecordComments` from `@happyvertical/smrt-comments/svelte`. Pass authorized
+comment projections, an `onsubmit(body)` callback, and a `contextKey` containing
+the current tenant, actor and record identity. Change that key whenever any of
+those identities changes: it clears drafts/errors and ignores stale submission
+completion. The host owns loading, authentication, mention selection and refresh.
+The component renders plain text. `RecordCommentsRecipe` declares the
+`comments.records` model recipe in the stable `comments` catalog group. It
+intentionally has no global navigation or section: a discussion needs an
+already-authorized parent record, and a generic comment list would lose that
+context. Hosts embed it on a record detail page. Catalog help explains posting
+and mentions without promising a mention picker or delivery configuration.
+The recipe declares `runtime: both`: the record component runs in the browser,
+while persistence and authorization run on the server. Its playground surface
+exports `RecordCommentsPlayground`, a standalone sample-record preview with
+local-only posting. `recordCommentsDemo` supplies the same sample projections
+through `demoSeed`; remounting resets the preview. No notifications are sent.
+There is no route, settings panel or shell widget: none can supply the authorized
+parent-record context. No provider is declared because the host's record access
+and mention policies are callbacks, not a selectable external provider.
+
+Validation: `pnpm --filter @happyvertical/smrt-comments test` covers SQLite and
+DuckDB. `pnpm --filter @happyvertical/smrt-comments test:postgres` adds PostgreSQL
+using the repository's disposable-database wrapper and ordinary CI role.

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/collections/CommentCollection.d.ts

@@ -0,0 +1,7 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Comment } from '../models/Comment.js';
+export declare class CommentCollection extends SmrtCollection<Comment> {
+    static readonly _itemClass: typeof Comment;
+    listForRecord(recordType: string, recordId: string): Promise<Comment[]>;
+}
+//# sourceMappingURL=CommentCollection.d.ts.map

package/dist/collections/CommentCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentCollection.d.ts","sourceRoot":"","sources":["../../src/collections/CommentCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK1D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAE/B,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,EAAE,CAAC;CAYtB"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import './__smrt-register__.js';
+export { CommentCollection } from './collections/CommentCollection.js';
+export { Comment } from './models/Comment.js';
+export { RecordCommentsRecipe } from './recipes.js';
+export { CommentService } from './services/CommentService.js';
+export { type CommentNotificationService, createCommentMentionNotifications, } from './services/mentionNotifications.js';
+export type { CommentActorContext, CommentMention, CommentMentionNotificationAdapter, CommentOptions, CommentRecordAccess, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EACL,KAAK,0BAA0B,EAC/B,iCAAiC,GAClC,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,iCAAiC,EACjC,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,184 @@
+import { ObjectRegistry, SmrtCollection, SmrtPolymorphicAssociation, SmrtRecipe, crossPackageRef, field, 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.55.11","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);","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}},"indexes":[{"name":"record_comments_slug_context_idx","columns":["tenant_id","slug","context"],"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":"78644ad4"},"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}},"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_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);","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}},"indexes":[{"name":"record_comments_slug_context_idx","columns":["tenant_id","slug","context"],"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":"78644ad4"},"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, {
+	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 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 {
+	tenantId = "";
+	authorUserId = "";
+	body = "";
+	/** JSON array of referenced User UUIDs; use mentionUserIds for validation. */
+	mentions = "[]";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.authorUserId !== void 0) this.authorUserId = options.authorUserId;
+		if (options.body !== void 0) this.body = options.body;
+		const mentions = options.mentions;
+		if (Array.isArray(mentions)) this.mentionUserIds = mentions;
+		else if (typeof mentions === "string") this.mentions = mentions;
+	}
+	get mentionUserIds() {
+		try {
+			const parsed = JSON.parse(this.mentions);
+			return Array.isArray(parsed) && parsed.every((value) => typeof value === "string") ? parsed : [];
+		} catch {
+			return [];
+		}
+	}
+	set mentionUserIds(value) {
+		const unique = [...new Set(value.map((id) => id.trim()).filter(Boolean))];
+		if (unique.length > MAX_MENTIONS || unique.some((id) => !UUID.test(id))) throw new TypeError("Comment mentions must contain at most 50 user UUIDs.");
+		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);
+Comment = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	tableName: "record_comments",
+	api: false,
+	mcp: false,
+	cli: false,
+	indexes: [{
+		name: "record_comments_record_created_idx",
+		columns: [
+			"tenantId",
+			"metaType",
+			"metaId",
+			"createdAt"
+		]
+	}]
+})], Comment);
+//#endregion
+//#region src/collections/CommentCollection.ts
+var CommentCollection = class extends SmrtCollection {
+	static _itemClass = Comment;
+	async listForRecord(recordType, recordId) {
+		const tenantId = getCurrentTenant()?.tenantId;
+		if (!tenantId) throw new TenantIsolationError("Record comments require a tenant context.");
+		return this.list({
+			where: {
+				tenantId,
+				metaType: recordType,
+				metaId: recordId
+			},
+			orderBy: ["createdAt ASC"]
+		});
+	}
+};
+//#endregion
+//#region src/recipes.ts
+var RecordCommentsRecipe = class extends SmrtRecipe {
+	static id = "comments.records";
+	static label = "Record comments";
+	static summary = "Discuss work directly on the records it concerns.";
+	static synonyms = [
+		"comments",
+		"mentions",
+		"discussion"
+	];
+	static group = {
+		id: "comments",
+		label: "Comments",
+		summary: "Keep discussions alongside the records your team works on."
+	};
+	static models = [Comment];
+	static nav = [];
+	static runtime = "both";
+	static surfaces = [{
+		kind: "playground",
+		export: "@happyvertical/smrt-comments/svelte#RecordCommentsPlayground",
+		label: "Record discussion preview"
+	}];
+	static demoSeed = { export: "@happyvertical/smrt-comments/svelte#recordCommentsDemo" };
+	static help = "./comments.records.recipe.md";
+};
+//#endregion
+//#region src/services/CommentService.ts
+var CommentService = class {
+	constructor(options) {
+		this.options = options;
+	}
+	options;
+	async authorize(recordType, recordId, action) {
+		const { actor } = this.options;
+		if (!actor.tenantId || !actor.userId || !recordType || !recordId || !await this.options.authorizeRecord({
+			...actor,
+			recordType,
+			recordId,
+			action
+		})) throw new Error("Comment record access denied.");
+	}
+	async listForRecord(recordType, recordId) {
+		await this.authorize(recordType, recordId, "read");
+		return withTenant({ tenantId: this.options.actor.tenantId }, async () => (await CommentCollection.create({ db: this.options.db })).listForRecord(recordType, recordId));
+	}
+	async create(commentOptions) {
+		if (!commentOptions.tenantId || !commentOptions.authorUserId) throw new TypeError("Comments require a tenant and author.");
+		if (commentOptions.tenantId !== this.options.actor.tenantId || commentOptions.authorUserId !== this.options.actor.userId) throw new Error("Comment actor context mismatch.");
+		await this.authorize(commentOptions.metaType ?? "", commentOptions.metaId ?? "", "comment");
+		if (!commentOptions.body?.trim()) throw new TypeError("Comment body is required.");
+		const { mentions, ...input } = commentOptions;
+		const prepared = new Comment();
+		if (mentions !== void 0) prepared.mentionUserIds = mentions;
+		const comment = await withTenant({ tenantId: commentOptions.tenantId }, async () => {
+			return (await CommentCollection.create({ db: this.options.db })).create({
+				...input,
+				mentions: prepared.mentions
+			});
+		});
+		if (!this.options.mentionNotifications || !comment.id) return comment;
+		for (const recipientUserId of comment.mentionUserIds) {
+			if (recipientUserId === comment.authorUserId) continue;
+			await this.options.mentionNotifications.notifyMention({
+				commentId: comment.id,
+				tenantId: comment.tenantId,
+				authorUserId: comment.authorUserId,
+				recipientUserId,
+				recordType: comment.metaType,
+				recordId: comment.metaId,
+				body: comment.body
+			});
+		}
+		return comment;
+	}
+};
+//#endregion
+//#region src/services/mentionNotifications.ts
+function createCommentMentionNotifications(options) {
+	return { async notifyMention(mention) {
+		if (!await options.canNotify(mention)) return;
+		await options.notifications.notify({
+			tenantId: mention.tenantId,
+			recipientUserId: mention.recipientUserId,
+			kind: "comments.mention",
+			title: "You were mentioned in a comment",
+			body: mention.body,
+			sourceRef: `comments.mention:${mention.commentId}`
+		});
+	} };
+}
+//#endregion
+export { Comment, CommentCollection, CommentService, RecordCommentsRecipe, createCommentMentionNotifications };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/__smrt-register__.ts","../src/models/Comment.ts","../src/collections/CommentCollection.ts","../src/recipes.ts","../src/services/CommentService.ts","../src/services/mentionNotifications.ts"],"sourcesContent":["// Generated by @happyvertical/smrt-core smrtPlugin at library build time.\n// The package manifest is inlined so self-registration cannot miss when a\n// downstream bundler relocates this module away from dist/manifest.json\n// (https://github.com/happyvertical/smrt/issues/1506,\n//  https://github.com/happyvertical/smrt/issues/1507).\nimport { ObjectRegistry } from '@happyvertical/smrt-core';\n\nObjectRegistry.registerPackageManifest(JSON.parse(\"{\\\"version\\\":\\\"1.0.0\\\",\\\"timestamp\\\":0,\\\"packageName\\\":\\\"@happyvertical/smrt-comments\\\",\\\"packageVersion\\\":\\\"0.55.11\\\",\\\"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);\\\",\\\"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}},\\\"indexes\\\":[{\\\"name\\\":\\\"record_comments_slug_context_idx\\\",\\\"columns\\\":[\\\"tenant_id\\\",\\\"slug\\\",\\\"context\\\"],\\\"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\\\":\\\"78644ad4\\\"},\\\"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}},\\\"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_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);\\\",\\\"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}},\\\"indexes\\\":[{\\\"name\\\":\\\"record_comments_slug_context_idx\\\",\\\"columns\\\":[\\\"tenant_id\\\",\\\"slug\\\",\\\"context\\\"],\\\"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\\\":\\\"78644ad4\\\"},\\\"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}\"));\n","import {\n  crossPackageRef,\n  field,\n  SmrtPolymorphicAssociation,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport type { CommentOptions } from '../types.js';\n\nconst MAX_MENTIONS = 50;\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n@TenantScoped({ mode: 'required' })\n@smrt({\n  tableName: 'record_comments',\n  api: false,\n  mcp: false,\n  cli: false,\n  indexes: [\n    {\n      name: 'record_comments_record_created_idx',\n      columns: ['tenantId', 'metaType', 'metaId', 'createdAt'],\n    },\n  ],\n})\nexport class Comment extends SmrtPolymorphicAssociation { static __smrtPackage__ = \"@happyvertical/smrt-comments\";\n  @tenantId()\n  tenantId = '';\n\n  @crossPackageRef('@happyvertical/smrt-users:User', { required: true })\n  authorUserId = '';\n\n  @field({ required: true })\n  body = '';\n\n  /** JSON array of referenced User UUIDs; use mentionUserIds for validation. */\n  mentions = '[]';\n\n  constructor(options: CommentOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.authorUserId !== undefined)\n      this.authorUserId = options.authorUserId;\n    if (options.body !== undefined) this.body = options.body;\n    const mentions = options.mentions as unknown;\n    if (Array.isArray(mentions)) this.mentionUserIds = mentions;\n    else if (typeof mentions === 'string') this.mentions = mentions;\n  }\n\n  get mentionUserIds(): string[] {\n    try {\n      const parsed: unknown = JSON.parse(this.mentions);\n      return Array.isArray(parsed) &&\n        parsed.every((value) => typeof value === 'string')\n        ? parsed\n        : [];\n    } catch {\n      return [];\n    }\n  }\n\n  set mentionUserIds(value: readonly string[]) {\n    const unique = [...new Set(value.map((id) => id.trim()).filter(Boolean))];\n    if (unique.length > MAX_MENTIONS || unique.some((id) => !UUID.test(id))) {\n      throw new TypeError(\n        'Comment mentions must contain at most 50 user UUIDs.',\n      );\n    }\n    this.mentions = JSON.stringify(unique);\n  }\n}\n","import { SmrtCollection } from '@happyvertical/smrt-core';\nimport {\n  getCurrentTenant,\n  TenantIsolationError,\n} from '@happyvertical/smrt-tenancy';\nimport { Comment } from '../models/Comment.js';\n\nexport class CommentCollection extends SmrtCollection<Comment> {\n  static readonly _itemClass = Comment;\n\n  async listForRecord(\n    recordType: string,\n    recordId: string,\n  ): Promise<Comment[]> {\n    const tenantId = getCurrentTenant()?.tenantId;\n    if (!tenantId) {\n      throw new TenantIsolationError(\n        'Record comments require a tenant context.',\n      );\n    }\n    return this.list({\n      where: { tenantId, metaType: recordType, metaId: recordId },\n      orderBy: ['createdAt ASC'],\n    });\n  }\n}\n","import { SmrtRecipe } from '@happyvertical/smrt-core';\nimport { Comment } from './models/Comment.js';\n\n/** Discussion attached to any authorized business record. */\nexport class RecordCommentsRecipe extends SmrtRecipe {\n  static id = 'comments.records';\n  static label = 'Record comments';\n  static summary = 'Discuss work directly on the records it concerns.';\n  static synonyms = ['comments', 'mentions', 'discussion'];\n  static group = {\n    id: 'comments',\n    label: 'Comments',\n    summary: 'Keep discussions alongside the records your team works on.',\n  };\n  static models = [Comment];\n  // Record discussions need an authorized parent record, not a global list.\n  static nav = [];\n  static runtime = 'both' as const;\n  static surfaces = [\n    {\n      kind: 'playground',\n      export: '@happyvertical/smrt-comments/svelte#RecordCommentsPlayground',\n      label: 'Record discussion preview',\n    },\n  ] as const;\n  static demoSeed = {\n    export: '@happyvertical/smrt-comments/svelte#recordCommentsDemo',\n  } as const;\n  static help = './comments.records.recipe.md';\n}\n","import type { SmrtClassOptions } from '@happyvertical/smrt-core';\nimport { withTenant } from '@happyvertical/smrt-tenancy';\nimport { CommentCollection } from '../collections/CommentCollection.js';\nimport { Comment } from '../models/Comment.js';\nimport type {\n  CommentActorContext,\n  CommentMentionNotificationAdapter,\n  CommentOptions,\n  CommentRecordAccess,\n} from '../types.js';\n\nexport class CommentService {\n  constructor(\n    private readonly options: {\n      db: SmrtClassOptions['db'];\n      actor: CommentActorContext;\n      authorizeRecord: (access: CommentRecordAccess) => Promise<boolean>;\n      mentionNotifications?: CommentMentionNotificationAdapter;\n    },\n  ) {}\n\n  private async authorize(\n    recordType: string,\n    recordId: string,\n    action: 'read' | 'comment',\n  ) {\n    const { actor } = this.options;\n    if (\n      !actor.tenantId ||\n      !actor.userId ||\n      !recordType ||\n      !recordId ||\n      !(await this.options.authorizeRecord({\n        ...actor,\n        recordType,\n        recordId,\n        action,\n      }))\n    ) {\n      throw new Error('Comment record access denied.');\n    }\n  }\n\n  async listForRecord(\n    recordType: string,\n    recordId: string,\n  ): Promise<Comment[]> {\n    await this.authorize(recordType, recordId, 'read');\n    return withTenant({ tenantId: this.options.actor.tenantId }, async () =>\n      (await CommentCollection.create({ db: this.options.db })).listForRecord(\n        recordType,\n        recordId,\n      ),\n    );\n  }\n\n  async create(commentOptions: CommentOptions): Promise<Comment> {\n    if (!commentOptions.tenantId || !commentOptions.authorUserId) {\n      throw new TypeError('Comments require a tenant and author.');\n    }\n    if (\n      commentOptions.tenantId !== this.options.actor.tenantId ||\n      commentOptions.authorUserId !== this.options.actor.userId\n    ) {\n      throw new Error('Comment actor context mismatch.');\n    }\n    await this.authorize(\n      commentOptions.metaType ?? '',\n      commentOptions.metaId ?? '',\n      'comment',\n    );\n    if (!commentOptions.body?.trim())\n      throw new TypeError('Comment body is required.');\n    const { mentions, ...input } = commentOptions;\n    // Validate through the model's public setter before collection.create()\n    // persists. Supply its normalized JSON in that single insert.\n    const prepared = new Comment();\n    if (mentions !== undefined) prepared.mentionUserIds = mentions;\n    const comment = await withTenant(\n      { tenantId: commentOptions.tenantId },\n      async () => {\n        return (await CommentCollection.create({ db: this.options.db })).create(\n          {\n            ...input,\n            mentions: prepared.mentions,\n          },\n        );\n      },\n    );\n    if (!this.options.mentionNotifications || !comment.id) return comment;\n    for (const recipientUserId of comment.mentionUserIds) {\n      if (recipientUserId === comment.authorUserId) continue;\n      await this.options.mentionNotifications.notifyMention({\n        commentId: comment.id,\n        tenantId: comment.tenantId,\n        authorUserId: comment.authorUserId,\n        recipientUserId,\n        recordType: comment.metaType,\n        recordId: comment.metaId,\n        body: comment.body,\n      });\n    }\n    return comment;\n  }\n}\n","import type {\n  CommentMention,\n  CommentMentionNotificationAdapter,\n} from '../types.js';\n\n/** Structural subset implemented by smrt-messages UserNotificationService. */\nexport interface CommentNotificationService {\n  notify(input: {\n    tenantId: string;\n    recipientUserId: string;\n    kind: string;\n    title: string;\n    body: string;\n    sourceRef: string;\n  }): Promise<unknown>;\n}\n\n/** Hosts must check recipient membership AND access to the referenced record. */\nexport function createCommentMentionNotifications(options: {\n  notifications: CommentNotificationService;\n  canNotify: (mention: CommentMention) => Promise<boolean>;\n}): CommentMentionNotificationAdapter {\n  return {\n    async notifyMention(mention) {\n      if (!(await options.canNotify(mention))) return;\n      await options.notifications.notify({\n        tenantId: mention.tenantId,\n        recipientUserId: mention.recipientUserId,\n        kind: 'comments.mention',\n        title: 'You were mentioned in a comment',\n        body: mention.body,\n        sourceRef: `comments.mention:${mention.commentId}`,\n      });\n    },\n  };\n}\n"],"mappings":"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"}