@headless-lms/core 0.1.0

package/dist/discussion/service.js

@@ -0,0 +1,343 @@
+import { genId } from "../shared/id.js";
+import { noopLogger } from "../shared/logger.js";
+import "../shared/settings.js";
+import { ForbiddenError, NotFoundError } from "../shared/errors.js";
+import { discussionEvents } from "./events.js";
+//#region src/discussion/service.ts
+/** A course with no stored settings. Discussion is opt-in, so the common case
+*  persists no row at all and every existing course stays silent. */
+const DEFAULT_SETTINGS = {
+	enabled: false,
+	threaded: true,
+	requireReview: false,
+	reactions: true
+};
+const EMPTY_REACTIONS = { reactions: {} };
+var DiscussionServiceImpl = class {
+	repo;
+	access;
+	content;
+	uow;
+	settings;
+	logger;
+	constructor(params) {
+		this.repo = params.repo;
+		this.access = params.access;
+		this.content = params.content;
+		this.uow = params.uow;
+		this.settings = params.settings;
+		this.logger = params.logger ?? noopLogger;
+	}
+	async resolveConfig(orgId, activityId) {
+		const activity = await this.content.getActivity(orgId, activityId);
+		if (!activity) throw new NotFoundError("Activity", activityId);
+		const stored = await this.settings.get(orgId, "content", activity.courseId);
+		const settings = {
+			...DEFAULT_SETTINGS,
+			...stored?.comments
+		};
+		const rule = (activity?.settings ?? {}).comments ?? "inherit";
+		return {
+			enabled: settings.enabled && rule !== "never",
+			threaded: settings.threaded,
+			requireReview: settings.requireReview,
+			reactions: settings.reactions
+		};
+	}
+	/** Any org user that is not a learner moderates. The role arrives from
+	*  the edge already resolved; core never looks one up to authorise. */
+	isStaff(actor) {
+		return actor.role !== "student";
+	}
+	toAuthor(record) {
+		return {
+			id: record.id,
+			firstName: record.firstName,
+			lastName: record.lastName,
+			image: record.image,
+			role: record.role
+		};
+	}
+	toView(comment, authors, reactions) {
+		const author = authors[comment.orgUserId];
+		if (!author) throw new NotFoundError("OrgUser", comment.orgUserId);
+		if (comment.removedBy && !authors[comment.removedBy]) throw new NotFoundError("OrgUser", comment.removedBy);
+		const remover = comment.removedBy ? authors[comment.removedBy] : void 0;
+		return {
+			id: comment.id,
+			activityId: comment.activityId,
+			parentId: comment.parentId,
+			author: this.toAuthor(author),
+			body: comment.status === "removed" ? null : comment.body,
+			status: comment.status,
+			removedBy: remover ? this.toAuthor(remover) : null,
+			reactions: reactions.reactions,
+			viewerReaction: reactions.viewerReaction,
+			createdAt: comment.createdAt,
+			updatedAt: comment.updatedAt
+		};
+	}
+	peopleIn(comments) {
+		const ids = /* @__PURE__ */ new Set();
+		for (const c of comments) {
+			ids.add(c.orgUserId);
+			if (c.removedBy) ids.add(c.removedBy);
+		}
+		return [...ids];
+	}
+	async renderOne(orgId, comment, actor) {
+		const authors = await this.repo.authorsOf(orgId, this.peopleIn([comment]));
+		const stored = comment.status === "removed" ? EMPTY_REACTIONS : (await this.repo.reactionsOf(orgId, [comment.id], actor.id))[comment.id] ?? EMPTY_REACTIONS;
+		return this.toView(comment, authors, stored);
+	}
+	async hasAccess(orgId, activityId, actor) {
+		return this.isStaff(actor) || await (async () => {
+			const activity = await this.content.getActivity(orgId, activityId);
+			return activity ? this.access.hasCourseAccess(orgId, actor.id, activity.courseId) : false;
+		})();
+	}
+	async postComment(orgId, { activityId, actor, parentId, body }) {
+		await this.hasAccess(orgId, activityId, actor);
+		const config = await this.resolveConfig(orgId, activityId);
+		if (!config.enabled) throw new ForbiddenError("discussion is not open on this activity");
+		if (parentId !== null) {
+			if (!config.threaded) throw new ForbiddenError("replies are disabled on this course");
+			const parent = await this.repo.findComment(orgId, parentId);
+			if (!parent || parent.activityId !== activityId) throw new NotFoundError("Comment", parentId);
+			if (parent.parentId !== null) throw new ForbiddenError("replies nest one level");
+			if (parent.status !== "published") throw new ForbiddenError("cannot reply to a comment that is not published");
+		}
+		const status = config.requireReview && !this.isStaff(actor) ? "pending" : "published";
+		const comment = {
+			id: genId("comment"),
+			orgId,
+			activityId,
+			parentId,
+			orgUserId: actor.id,
+			body,
+			status,
+			removedBy: null,
+			createdAt: /* @__PURE__ */ new Date(),
+			updatedAt: /* @__PURE__ */ new Date()
+		};
+		const saved = await this.uow.run(async (scope) => {
+			const row = await scope.discussion.insertComment(orgId, comment);
+			await scope.outbox.append([discussionEvents.commentCreated.make({
+				orgId,
+				data: row
+			})]);
+			this.logger.info("comment created", {
+				orgId,
+				commentId: row.id,
+				status
+			});
+			return row;
+		});
+		return this.renderOne(orgId, saved, actor);
+	}
+	async activityComments(orgId, activityId, actor) {
+		const config = await this.resolveConfig(orgId, activityId);
+		if (!config.enabled) return {
+			config,
+			comments: []
+		};
+		const readable = (await this.repo.listByActivity(orgId, activityId)).filter((c) => {
+			if (c.status === "published" || c.status === "removed") return true;
+			return this.isStaff(actor) || c.orgUserId === actor.id;
+		});
+		const replies = readable.filter((c) => c.parentId !== null && c.status !== "removed");
+		const heldOpen = new Set(replies.map((r) => r.parentId));
+		const roots = readable.filter((c) => c.parentId === null && (c.status !== "removed" || heldOpen.has(c.id)));
+		const rootIds = new Set(roots.map((r) => r.id));
+		const served = [...roots, ...replies.filter((r) => rootIds.has(r.parentId))].sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+		const [authors, reactions] = await Promise.all([this.repo.authorsOf(orgId, this.peopleIn(served)), config.reactions ? this.repo.reactionsOf(orgId, served.map((c) => c.id), actor.id) : Promise.resolve({})]);
+		return {
+			config,
+			comments: served.map((c) => this.toView(c, authors, reactions[c.id] ?? EMPTY_REACTIONS))
+		};
+	}
+	async edit(orgId, commentId, actor, body) {
+		const { comment, config } = await this.loadWithConfig(orgId, commentId, actor);
+		if (!config.enabled) throw new ForbiddenError("discussion is not open on this activity");
+		if (comment.orgUserId !== actor.id) throw new ForbiddenError("only the author may edit a comment");
+		if (comment.status === "removed") throw new ForbiddenError("a removed comment cannot be edited");
+		const updated = await this.repo.updateComment(orgId, commentId, { body });
+		if (!updated) throw new NotFoundError("Comment", commentId);
+		return this.renderOne(orgId, updated, actor);
+	}
+	async remove(orgId, commentId, actor) {
+		const comment = await this.getComment(orgId, commentId);
+		if (!comment) throw new NotFoundError("Comment", commentId);
+		await this.hasAccess(orgId, comment.activityId, actor);
+		if (comment.orgUserId !== actor.id && !this.isStaff(actor)) throw new ForbiddenError("only the author or a moderator may remove a comment");
+		if (comment.status === "removed") return comment;
+		return this.uow.run(async (scope) => {
+			const updated = await scope.discussion.updateComment(orgId, commentId, {
+				status: "removed",
+				removedBy: actor.id
+			});
+			if (!updated) throw new NotFoundError("Comment", commentId);
+			await scope.outbox.append([discussionEvents.commentRemoved.make({
+				orgId,
+				data: updated
+			})]);
+			this.logger.info("comment removed", {
+				orgId,
+				commentId,
+				by: actor.id
+			});
+			return updated;
+		});
+	}
+	async restore(orgId, commentId, actor) {
+		if (!this.isStaff(actor)) throw new ForbiddenError("only a moderator may restore a comment");
+		const comment = await this.getComment(orgId, commentId);
+		if (!comment) throw new NotFoundError("Comment", commentId);
+		if (comment.status !== "removed") return comment;
+		const updated = await this.repo.updateComment(orgId, commentId, {
+			status: "published",
+			removedBy: null
+		});
+		if (!updated) throw new NotFoundError("Comment", commentId);
+		return updated;
+	}
+	/** Load a comment together with its activity's resolved comments config,
+	*  having proved the actor may reach that activity at all. Every path that
+	*  acts on one comment needs the pair, and none should read the row twice. */
+	async loadWithConfig(orgId, commentId, actor) {
+		const comment = await this.getComment(orgId, commentId);
+		if (!comment) throw new NotFoundError("Comment", commentId);
+		await this.hasAccess(orgId, comment.activityId, actor);
+		return {
+			comment,
+			config: await this.resolveConfig(orgId, comment.activityId)
+		};
+	}
+	async setReaction(orgId, commentId, actor, emoji) {
+		const { comment, config } = await this.loadWithConfig(orgId, commentId, actor);
+		if (!config.enabled) throw new ForbiddenError("discussion is not open on this activity");
+		if (!config.reactions && emoji !== null) throw new ForbiddenError("reactions are disabled on this course");
+		if (comment.status === "removed") throw new ForbiddenError("a removed comment cannot be reacted to");
+		await this.repo.setReaction(orgId, commentId, actor.id, emoji);
+		return (await this.repo.reactionsOf(orgId, [commentId], actor.id))[commentId] ?? EMPTY_REACTIONS;
+	}
+	async approve(orgId, commentId, actor) {
+		if (!this.isStaff(actor)) throw new ForbiddenError("only a moderator may approve a comment");
+		const comment = await this.getComment(orgId, commentId);
+		if (!comment) throw new NotFoundError("Comment", commentId);
+		if (comment.status !== "pending") throw new ForbiddenError("only a pending comment can be approved");
+		return this.uow.run(async (scope) => {
+			const updated = await scope.discussion.updateComment(orgId, commentId, { status: "published" });
+			if (!updated) throw new NotFoundError("Comment", commentId);
+			await scope.outbox.append([discussionEvents.commentPublished.make({
+				orgId,
+				data: updated
+			})]);
+			this.logger.info("comment published", {
+				orgId,
+				commentId
+			});
+			return updated;
+		});
+	}
+	/** Loads the comment and dispatches to whichever transition applies — the
+	*  caller must not decide that itself. `approve` and `restore` still enforce
+	*  their own staff check; the check here covers the third path, where a
+	*  comment is already published and neither of them would run. */
+	async publish(orgId, commentId, actor) {
+		if (!this.isStaff(actor)) throw new ForbiddenError("only a moderator may publish a comment");
+		const comment = await this.getComment(orgId, commentId);
+		if (!comment) throw new NotFoundError("Comment", commentId);
+		if (comment.status === "pending") return this.approve(orgId, commentId, actor);
+		if (comment.status === "removed") return this.restore(orgId, commentId, actor);
+		return comment;
+	}
+	async resolveReports(orgId, commentId, actor) {
+		if (!this.isStaff(actor)) throw new ForbiddenError("only a moderator may resolve a report");
+		if (!await this.getComment(orgId, commentId)) throw new NotFoundError("Comment", commentId);
+		await this.repo.resolveReportsFor(orgId, commentId, /* @__PURE__ */ new Date());
+		this.logger.info("comment reports resolved", {
+			orgId,
+			commentId
+		});
+	}
+	async reportComment(orgId, commentId, actor, reason) {
+		const { config } = await this.loadWithConfig(orgId, commentId, actor);
+		if (!config.enabled) throw new ForbiddenError("discussion is not open on this activity");
+		const report = {
+			id: genId("commentReport"),
+			orgId,
+			commentId,
+			orgUserId: actor.id,
+			reason,
+			resolvedAt: null,
+			createdAt: /* @__PURE__ */ new Date()
+		};
+		return this.uow.run(async (scope) => {
+			const saved = await scope.discussion.insertReport(orgId, report);
+			if (!saved) {
+				const mine = (await scope.discussion.listOpenReports(orgId, [commentId])).find((r) => r.orgUserId === actor.id);
+				if (mine) return mine;
+				return report;
+			}
+			await scope.outbox.append([discussionEvents.commentReported.make({
+				orgId,
+				data: saved
+			})]);
+			this.logger.info("comment reported", {
+				orgId,
+				commentId
+			});
+			return saved;
+		});
+	}
+	async listComments(orgId, query) {
+		const page = await this.repo.listComments(orgId, query);
+		const rows = page.rows.map((r) => r.comment);
+		if (rows.length === 0) return {
+			...page,
+			rows: []
+		};
+		const reports = await this.repo.listOpenReports(orgId, rows.map((c) => c.id));
+		const authors = await this.repo.authorsOf(orgId, [.../* @__PURE__ */ new Set([...this.peopleIn(rows), ...reports.map((r) => r.orgUserId)])]);
+		const byComment = /* @__PURE__ */ new Map();
+		for (const report of reports) byComment.set(report.commentId, [...byComment.get(report.commentId) ?? [], report]);
+		return {
+			...page,
+			rows: page.rows.map(({ comment, courseId, activityTitle }) => {
+				const author = authors[comment.orgUserId];
+				if (!author) throw new NotFoundError("OrgUser", comment.orgUserId);
+				return {
+					id: comment.id,
+					parentId: comment.parentId,
+					activityId: comment.activityId,
+					activityTitle,
+					courseId,
+					body: comment.body,
+					status: comment.status,
+					author: this.toAuthor(author),
+					authorEmail: author.email,
+					removedBy: comment.removedBy,
+					reports: (byComment.get(comment.id) ?? []).map((r) => {
+						const reporter = authors[r.orgUserId];
+						if (!reporter) throw new NotFoundError("OrgUser", r.orgUserId);
+						return {
+							reporter: this.toAuthor(reporter),
+							reason: r.reason,
+							createdAt: r.createdAt
+						};
+					}),
+					createdAt: comment.createdAt,
+					updatedAt: comment.updatedAt
+				};
+			})
+		};
+	}
+	getComment(orgId, commentId) {
+		return this.repo.findComment(orgId, commentId);
+	}
+};
+//#endregion
+export { DEFAULT_SETTINGS, DiscussionServiceImpl };
+
+//# sourceMappingURL=service.js.map

package/dist/discussion/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../src/discussion/service.ts"],"sourcesContent":["import { genId } from '../shared/id.js';\nimport { ForbiddenError, NotFoundError } from '../shared/errors.js';\nimport type { Logger } from '../shared/ports.js';\nimport { noopLogger } from '../shared/logger.js';\nimport type {\n  ActivityCommentsRule,\n  Comment,\n  CommentAuthor,\n  CommentReport,\n  CommentSettings,\n} from './model.js';\nimport type {\n  CommentListItem,\n  CommentsConfig,\n  CommentView,\n  ListCommentsQuery,\n  Page,\n  ReactionEmoji,\n} from './types.js';\nimport { SettingsNamespace, type SettingsService } from '../shared/settings.js';\nimport type {\n  ActivityComments,\n  ActivityGetter,\n  Actor,\n  AuthorRecord,\n  CommentReactions,\n  CourseAccessReader,\n  DiscussionRepository,\n  DiscussionService,\n  DiscussionUnitOfWork,\n  PostCommentInput,\n} from './ports.js';\nimport { discussionEvents } from './events.js';\n\n/** A course with no stored settings. Discussion is opt-in, so the common case\n *  persists no row at all and every existing course stays silent. */\nexport const DEFAULT_SETTINGS = {\n  enabled: false,\n  threaded: true,\n  requireReview: false,\n  reactions: true,\n} as const;\n\n/** The slice of the course's stored settings this context reads. Absent for a\n *  course that has never been configured, so the defaults apply. */\ninterface StoredCourseSettings {\n  comments?: Partial<CommentSettings>;\n}\n\n/** The slice of an activity's opaque settings blob this context reads. Absent\n *  or \"inherit\" = no override, so the course setting stands. */\ninterface StoredActivitySettings {\n  comments?: ActivityCommentsRule;\n}\n\nconst EMPTY_REACTIONS: CommentReactions = { reactions: {} };\n\nexport type DiscussionServiceParams = {\n  repo: DiscussionRepository;\n  access: CourseAccessReader;\n  content: ActivityGetter;\n  uow: DiscussionUnitOfWork;\n  settings: SettingsService;\n  logger?: Logger;\n};\n\nexport class DiscussionServiceImpl implements DiscussionService {\n  private readonly repo: DiscussionRepository;\n  private readonly access: CourseAccessReader;\n  private readonly content: ActivityGetter;\n  private readonly uow: DiscussionUnitOfWork;\n  private readonly settings: SettingsService;\n  private readonly logger: Logger;\n\n  constructor(params: DiscussionServiceParams) {\n    this.repo = params.repo;\n    this.access = params.access;\n    this.content = params.content;\n    this.uow = params.uow;\n    this.settings = params.settings;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  async resolveConfig(orgId: string, activityId: string): Promise<CommentsConfig> {\n    const activity = await this.content.getActivity(orgId, activityId);\n    if (!activity) {\n      throw new NotFoundError('Activity', activityId);\n    }\n\n    // The `content` namespace row is the whole CourseSettings; comment settings\n    // are one key inside it, written there by content.patchSettings.\n    const stored = await this.settings.get<StoredCourseSettings>(\n      orgId,\n      SettingsNamespace.content,\n      activity.courseId,\n    );\n    const settings = { ...DEFAULT_SETTINGS, ...stored?.comments };\n    // Comments off for the course cannot be overridden back on by an activity:\n    // the course switch is the master.\n    const rule = ((activity?.settings ?? {}) as StoredActivitySettings).comments ?? 'inherit';\n    return {\n      enabled: settings.enabled && rule !== 'never',\n      threaded: settings.threaded,\n      requireReview: settings.requireReview,\n      reactions: settings.reactions,\n    };\n  }\n\n  /** Any org user that is not a learner moderates. The role arrives from\n   *  the edge already resolved; core never looks one up to authorise. */\n  private isStaff(actor: Actor): boolean {\n    return actor.role !== 'student';\n  }\n\n  private toAuthor(record: AuthorRecord): CommentAuthor {\n    return {\n      id: record.id,\n      firstName: record.firstName,\n      lastName: record.lastName,\n      image: record.image,\n      role: record.role,\n    };\n  }\n\n  private toView(\n    comment: Comment,\n    authors: Record<string, AuthorRecord>,\n    reactions: CommentReactions,\n  ): CommentView {\n    const author = authors[comment.orgUserId];\n    if (!author) {\n      throw new NotFoundError('OrgUser', comment.orgUserId);\n    }\n    if (comment.removedBy && !authors[comment.removedBy]) {\n      throw new NotFoundError('OrgUser', comment.removedBy);\n    }\n    const remover = comment.removedBy ? authors[comment.removedBy] : undefined;\n    return {\n      id: comment.id,\n      activityId: comment.activityId,\n      parentId: comment.parentId,\n      author: this.toAuthor(author),\n      body: comment.status === 'removed' ? null : comment.body,\n      status: comment.status,\n      removedBy: remover ? this.toAuthor(remover) : null,\n      reactions: reactions.reactions,\n      viewerReaction: reactions.viewerReaction,\n      createdAt: comment.createdAt,\n      updatedAt: comment.updatedAt,\n    };\n  }\n\n  private peopleIn(comments: Comment[]): string[] {\n    const ids = new Set<string>();\n    for (const c of comments) {\n      ids.add(c.orgUserId);\n      if (c.removedBy) {\n        ids.add(c.removedBy);\n      }\n    }\n    return [...ids];\n  }\n\n  private async renderOne(orgId: string, comment: Comment, actor: Actor): Promise<CommentView> {\n    const authors = await this.repo.authorsOf(orgId, this.peopleIn([comment]));\n    const stored =\n      comment.status === 'removed'\n        ? EMPTY_REACTIONS\n        : ((await this.repo.reactionsOf(orgId, [comment.id], actor.id))[comment.id] ??\n          EMPTY_REACTIONS);\n    return this.toView(comment, authors, stored);\n  }\n\n  private async hasAccess(orgId: string, activityId: string, actor: Actor): Promise<boolean> {\n    return (\n      this.isStaff(actor) ||\n      (await (async () => {\n        const activity = await this.content.getActivity(orgId, activityId);\n        return activity ? this.access.hasCourseAccess(orgId, actor.id, activity.courseId) : false;\n      })())\n    );\n  }\n\n  async postComment(\n    orgId: string,\n    { activityId, actor, parentId, body }: PostCommentInput,\n  ): Promise<CommentView> {\n    await this.hasAccess(orgId, activityId, actor);\n    const config = await this.resolveConfig(orgId, activityId);\n\n    if (!config.enabled) {\n      throw new ForbiddenError('discussion is not open on this activity');\n    }\n\n    if (parentId !== null) {\n      if (!config.threaded) {\n        throw new ForbiddenError('replies are disabled on this course');\n      }\n      const parent = await this.repo.findComment(orgId, parentId);\n      if (!parent || parent.activityId !== activityId) {\n        throw new NotFoundError('Comment', parentId);\n      }\n\n      if (parent.parentId !== null) {\n        throw new ForbiddenError('replies nest one level');\n      }\n\n      if (parent.status !== 'published') {\n        throw new ForbiddenError('cannot reply to a comment that is not published');\n      }\n    }\n\n    const status: Comment['status'] =\n      config.requireReview && !this.isStaff(actor) ? 'pending' : 'published';\n\n    const comment: Comment = {\n      id: genId('comment'),\n      orgId,\n      activityId: activityId,\n      parentId: parentId,\n      orgUserId: actor.id,\n      body: body,\n      status,\n      removedBy: null,\n      createdAt: new Date(),\n      updatedAt: new Date(),\n    };\n    const saved = await this.uow.run(async (scope) => {\n      const row = await scope.discussion.insertComment(orgId, comment);\n      await scope.outbox.append([\n        discussionEvents.commentCreated.make({ orgId, data: row }),\n      ]);\n      this.logger.info('comment created', { orgId, commentId: row.id, status });\n      return row;\n    });\n    return this.renderOne(orgId, saved, actor);\n  }\n\n  async activityComments(\n    orgId: string,\n    activityId: string,\n    actor: Actor,\n  ): Promise<ActivityComments> {\n    const config = await this.resolveConfig(orgId, activityId);\n    if (!config.enabled) {\n      return { config, comments: [] };\n    }\n    const rows = await this.repo.listByActivity(orgId, activityId);\n    // A pending comment is visible to its own author and to staff, nobody else.\n    const readable = rows.filter((c) => {\n      if (c.status === 'published' || c.status === 'removed') {\n        return true;\n      }\n      return this.isStaff(actor) || c.orgUserId === actor.id;\n    });\n    // Replies nest one level, so a reply has nothing hanging off it — a removed\n    // reply is simply dropped rather than held open as a placeholder.\n    const replies = readable.filter((c) => c.parentId !== null && c.status !== 'removed');\n    const heldOpen = new Set(replies.map((r) => r.parentId));\n    // A removed root survives only to hold replies THIS reader can see. Judging\n    // it against every reply would show a marker with nothing beneath it.\n    const roots = readable.filter(\n      (c) => c.parentId === null && (c.status !== 'removed' || heldOpen.has(c.id)),\n    );\n    const rootIds = new Set(roots.map((r) => r.id));\n    const served = [...roots, ...replies.filter((r) => rootIds.has(r.parentId!))].sort(\n      (a, b) => a.createdAt.getTime() - b.createdAt.getTime(),\n    );\n\n    const [authors, reactions] = await Promise.all([\n      this.repo.authorsOf(orgId, this.peopleIn(served)),\n      config.reactions\n        ? this.repo.reactionsOf(\n            orgId,\n            served.map((c) => c.id),\n            actor.id,\n          )\n        : Promise.resolve<Record<string, CommentReactions>>({}),\n    ]);\n\n    return {\n      config,\n      comments: served.map((c) => this.toView(c, authors, reactions[c.id] ?? EMPTY_REACTIONS)),\n    };\n  }\n\n  async edit(orgId: string, commentId: string, actor: Actor, body: string): Promise<CommentView> {\n    const { comment, config } = await this.loadWithConfig(orgId, commentId, actor);\n    if (!config.enabled) {\n      throw new ForbiddenError('discussion is not open on this activity');\n    }\n    // Editing is the author's alone — moderators remove, they do not rewrite.\n    if (comment.orgUserId !== actor.id) {\n      throw new ForbiddenError('only the author may edit a comment');\n    }\n    if (comment.status === 'removed') {\n      throw new ForbiddenError('a removed comment cannot be edited');\n    }\n    const updated = await this.repo.updateComment(orgId, commentId, {\n      body,\n    });\n    if (!updated) {\n      // getComment() proved it existed; a null here means it vanished mid-write.\n      // Returning the pre-edit comment would report success and hand back\n      // the old body.\n      throw new NotFoundError('Comment', commentId);\n    }\n    return this.renderOne(orgId, updated, actor);\n  }\n\n  async remove(orgId: string, commentId: string, actor: Actor): Promise<Comment> {\n    const comment = await this.getComment(orgId, commentId);\n    if (!comment) {\n      throw new NotFoundError('Comment', commentId);\n    }\n\n    await this.hasAccess(orgId, comment.activityId, actor);\n    if (comment.orgUserId !== actor.id && !this.isStaff(actor)) {\n      throw new ForbiddenError('only the author or a moderator may remove a comment');\n    }\n\n    if (comment.status === 'removed') {\n      return comment;\n    }\n\n    return this.uow.run(async (scope) => {\n      const updated = await scope.discussion.updateComment(orgId, commentId, {\n        status: 'removed',\n        removedBy: actor.id,\n      });\n      if (!updated) {\n        // getComment() proved it existed; a null here means it vanished mid-operation.\n        // Roll back rather than emit an event for a transition that didn't happen.\n        throw new NotFoundError('Comment', commentId);\n      }\n      await scope.outbox.append([\n        discussionEvents.commentRemoved.make({ orgId, data: updated }),\n      ]);\n      this.logger.info('comment removed', { orgId, commentId, by: actor.id });\n      return updated;\n    });\n  }\n\n  async restore(orgId: string, commentId: string, actor: Actor): Promise<Comment> {\n    if (!this.isStaff(actor)) {\n      throw new ForbiddenError('only a moderator may restore a comment');\n    }\n    const comment = await this.getComment(orgId, commentId);\n    if (!comment) {\n      throw new NotFoundError('Comment', commentId);\n    }\n    if (comment.status !== 'removed') {\n      return comment;\n    }\n    const updated = await this.repo.updateComment(orgId, commentId, {\n      status: 'published',\n      removedBy: null,\n    });\n    if (!updated) {\n      // getComment() proved it existed; a null here means it vanished mid-write.\n      // Returning the still-removed comment would report success while\n      // handing back the removed row.\n      throw new NotFoundError('Comment', commentId);\n    }\n    return updated;\n  }\n\n  /** Load a comment together with its activity's resolved comments config,\n   *  having proved the actor may reach that activity at all. Every path that\n   *  acts on one comment needs the pair, and none should read the row twice. */\n  private async loadWithConfig(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n  ): Promise<{ comment: Comment; config: CommentsConfig }> {\n    const comment = await this.getComment(orgId, commentId);\n    if (!comment) {\n      throw new NotFoundError('Comment', commentId);\n    }\n    await this.hasAccess(orgId, comment.activityId, actor);\n    const config = await this.resolveConfig(orgId, comment.activityId);\n    return { comment, config };\n  }\n\n  async setReaction(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    emoji: ReactionEmoji | null,\n  ): Promise<CommentReactions> {\n    const { comment, config } = await this.loadWithConfig(orgId, commentId, actor);\n    // Writing to comments — locked and hidden both refuse.\n    if (!config.enabled) {\n      throw new ForbiddenError('discussion is not open on this activity');\n    }\n    if (!config.reactions && emoji !== null) {\n      throw new ForbiddenError('reactions are disabled on this course');\n    }\n    if (comment.status === 'removed') {\n      throw new ForbiddenError('a removed comment cannot be reacted to');\n    }\n    await this.repo.setReaction(orgId, commentId, actor.id, emoji);\n    const stored = await this.repo.reactionsOf(orgId, [commentId], actor.id);\n    return stored[commentId] ?? EMPTY_REACTIONS;\n  }\n\n  async approve(orgId: string, commentId: string, actor: Actor): Promise<Comment> {\n    if (!this.isStaff(actor)) {\n      throw new ForbiddenError('only a moderator may approve a comment');\n    }\n    const comment = await this.getComment(orgId, commentId);\n    if (!comment) {\n      throw new NotFoundError('Comment', commentId);\n    }\n    if (comment.status !== 'pending') {\n      throw new ForbiddenError('only a pending comment can be approved');\n    }\n    return this.uow.run(async (scope) => {\n      const updated = await scope.discussion.updateComment(orgId, commentId, {\n        status: 'published',\n      });\n      if (!updated) {\n        // getComment() proved it existed; a null here means it vanished mid-operation.\n        // Roll back rather than emit an event for a transition that didn't happen.\n        throw new NotFoundError('Comment', commentId);\n      }\n      await scope.outbox.append([\n        discussionEvents.commentPublished.make({ orgId, data: updated }),\n      ]);\n      this.logger.info('comment published', { orgId, commentId });\n      return updated;\n    });\n  }\n\n  /** Loads the comment and dispatches to whichever transition applies — the\n   *  caller must not decide that itself. `approve` and `restore` still enforce\n   *  their own staff check; the check here covers the third path, where a\n   *  comment is already published and neither of them would run. */\n  async publish(orgId: string, commentId: string, actor: Actor): Promise<Comment> {\n    if (!this.isStaff(actor)) {\n      throw new ForbiddenError('only a moderator may publish a comment');\n    }\n    const comment = await this.getComment(orgId, commentId);\n    if (!comment) {\n      throw new NotFoundError('Comment', commentId);\n    }\n    if (comment.status === 'pending') {\n      return this.approve(orgId, commentId, actor);\n    }\n    if (comment.status === 'removed') {\n      return this.restore(orgId, commentId, actor);\n    }\n    return comment;\n  }\n\n  async resolveReports(orgId: string, commentId: string, actor: Actor): Promise<void> {\n    if (!this.isStaff(actor)) {\n      throw new ForbiddenError('only a moderator may resolve a report');\n    }\n    const comment = await this.getComment(orgId, commentId);\n    if (!comment) {\n      throw new NotFoundError('Comment', commentId);\n    }\n    await this.repo.resolveReportsFor(orgId, commentId, new Date());\n    this.logger.info('comment reports resolved', { orgId, commentId });\n  }\n\n  async reportComment(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    reason: string,\n  ): Promise<CommentReport> {\n    const { config } = await this.loadWithConfig(orgId, commentId, actor);\n    // Locked accepts reports — a locked activity can still hold something a\n    // moderator needs to see. Hidden does not: nothing in it is being served,\n    // so nobody is looking at a comment to flag.\n    if (!config.enabled) {\n      throw new ForbiddenError('discussion is not open on this activity');\n    }\n    const report: CommentReport = {\n      id: genId('commentReport'),\n      orgId,\n      commentId,\n      orgUserId: actor.id,\n      reason,\n      resolvedAt: null,\n      createdAt: new Date(),\n    };\n    return this.uow.run(async (scope) => {\n      const saved = await scope.discussion.insertReport(orgId, report);\n      if (!saved) {\n        // Already reported by this person. Return the report that actually\n        // exists — a fabricated id resolves to nothing — and emit no second\n        // event, which would double-count any threshold automation.\n        const open = await scope.discussion.listOpenReports(orgId, [commentId]);\n        const mine = open.find((r) => r.orgUserId === actor.id);\n        if (mine) {\n          return mine;\n        }\n        return report;\n      }\n      await scope.outbox.append([\n        discussionEvents.commentReported.make({ orgId, data: saved }),\n      ]);\n      this.logger.info('comment reported', { orgId, commentId });\n      return saved;\n    });\n  }\n\n  async listComments(orgId: string, query: ListCommentsQuery): Promise<Page<CommentListItem>> {\n    const page = await this.repo.listComments(orgId, query);\n    const rows = page.rows.map((r) => r.comment);\n    if (rows.length === 0) {\n      return { ...page, rows: [] };\n    }\n    const reports = await this.repo.listOpenReports(\n      orgId,\n      rows.map((c) => c.id),\n    );\n    const authors = await this.repo.authorsOf(orgId, [\n      ...new Set([...this.peopleIn(rows), ...reports.map((r) => r.orgUserId)]),\n    ]);\n\n    const byComment = new Map<string, CommentReport[]>();\n    for (const report of reports) {\n      byComment.set(report.commentId, [...(byComment.get(report.commentId) ?? []), report]);\n    }\n\n    return {\n      ...page,\n      rows: page.rows.map(({ comment, courseId, activityTitle }) => {\n        const author = authors[comment.orgUserId];\n        if (!author) {\n          throw new NotFoundError('OrgUser', comment.orgUserId);\n        }\n        return {\n          id: comment.id,\n          parentId: comment.parentId,\n          activityId: comment.activityId,\n          activityTitle,\n          courseId,\n          body: comment.body,\n          status: comment.status,\n          author: this.toAuthor(author),\n          authorEmail: author.email,\n          removedBy: comment.removedBy,\n          reports: (byComment.get(comment.id) ?? []).map((r) => {\n            const reporter = authors[r.orgUserId];\n            if (!reporter) {\n              throw new NotFoundError('OrgUser', r.orgUserId);\n            }\n            return {\n              reporter: this.toAuthor(reporter),\n              reason: r.reason,\n              createdAt: r.createdAt,\n            };\n          }),\n          createdAt: comment.createdAt,\n          updatedAt: comment.updatedAt,\n        };\n      }),\n    };\n  }\n\n  getComment(orgId: string, commentId: string): Promise<Comment | null> {\n    return this.repo.findComment(orgId, commentId);\n  }\n}\n"],"mappings":"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"}

package/dist/discussion/types.d.ts

@@ -0,0 +1,4 @@
+import { Page } from "../types/shared.js";
+import { CommentListItem, CommentReportSummary, CommentView, CommentsConfig, ListCommentsQuery, ReactionCounts, ReactionEmoji } from "../types/schemas/discussion.js";
+import "../types/index.js";
+export type { CommentListItem, CommentReportSummary, CommentView, CommentsConfig, ListCommentsQuery, Page, ReactionCounts, ReactionEmoji };

package/dist/discussion/types.js

@@ -0,0 +1 @@
+export {};

package/dist/entitlements/events.d.ts

@@ -0,0 +1,89 @@
+import { EventOf, EventOfValues, RuntimeEventDefinition, VersionedDomainEvent } from "../shared/events.js";
+import "../shared/ports.js";
+//#region src/entitlements/events.d.ts
+declare const entitlementEvents: {
+  entitlementCreated: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: Date;
+    expiresAt: Date | null;
+  }, "entitlement.created", 1>, {
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: unknown;
+    expiresAt: unknown;
+  }>;
+  entitlementUpdated: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: Date;
+    expiresAt: Date | null;
+  }, "entitlement.updated", 1>, {
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: unknown;
+    expiresAt: unknown;
+  }>;
+  entitlementDeleted: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: Date;
+    expiresAt: Date | null;
+  }, "entitlement.deleted", 1>, {
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: unknown;
+    expiresAt: unknown;
+  }>;
+  entitlementExpired: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: Date;
+    expiresAt: Date | null;
+  }, "entitlement.expired", 1>, {
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    contentId: string;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: unknown;
+    expiresAt: unknown;
+  }>;
+};
+type EntitlementCreated = EventOf<typeof entitlementEvents.entitlementCreated>;
+type EntitlementUpdated = EventOf<typeof entitlementEvents.entitlementUpdated>;
+type EntitlementDeleted = EventOf<typeof entitlementEvents.entitlementDeleted>;
+type EntitlementExpired = EventOf<typeof entitlementEvents.entitlementExpired>;
+type EntitlementEvent = EventOfValues<typeof entitlementEvents>;
+//#endregion
+export { EntitlementCreated, EntitlementDeleted, EntitlementEvent, EntitlementExpired, EntitlementUpdated, entitlementEvents };
+//# sourceMappingURL=events.d.ts.map

package/dist/entitlements/events.js

@@ -0,0 +1,29 @@
+import { entitlementSchema } from "../types/schemas/entitlements.js";
+import { defineEvent } from "../shared/events.js";
+//#region src/entitlements/events.ts
+const entitlementEvents = {
+	entitlementCreated: defineEvent({
+		type: "entitlement.created",
+		version: 1,
+		data: entitlementSchema
+	}),
+	entitlementUpdated: defineEvent({
+		type: "entitlement.updated",
+		version: 1,
+		data: entitlementSchema
+	}),
+	entitlementDeleted: defineEvent({
+		type: "entitlement.deleted",
+		version: 1,
+		data: entitlementSchema
+	}),
+	entitlementExpired: defineEvent({
+		type: "entitlement.expired",
+		version: 1,
+		data: entitlementSchema
+	})
+};
+//#endregion
+export { entitlementEvents };
+
+//# sourceMappingURL=events.js.map

package/dist/entitlements/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../src/entitlements/events.ts"],"sourcesContent":["import { entitlementSchema } from '../types/schemas/index.js';\nimport { defineEvent, type EventOf, type EventOfValues } from '../shared/ports.js';\n\nexport const entitlementEvents = {\n  entitlementCreated: defineEvent({\n    type: 'entitlement.created',\n    version: 1,\n    data: entitlementSchema,\n  }),\n  entitlementUpdated: defineEvent({\n    type: 'entitlement.updated',\n    version: 1,\n    data: entitlementSchema,\n  }),\n  entitlementDeleted: defineEvent({\n    type: 'entitlement.deleted',\n    version: 1,\n    data: entitlementSchema,\n  }),\n  entitlementExpired: defineEvent({\n    type: 'entitlement.expired',\n    version: 1,\n    data: entitlementSchema,\n  }),\n};\n\nexport type EntitlementCreated = EventOf<typeof entitlementEvents.entitlementCreated>;\nexport type EntitlementUpdated = EventOf<typeof entitlementEvents.entitlementUpdated>;\nexport type EntitlementDeleted = EventOf<typeof entitlementEvents.entitlementDeleted>;\nexport type EntitlementExpired = EventOf<typeof entitlementEvents.entitlementExpired>;\nexport type EntitlementEvent = EventOfValues<typeof entitlementEvents>;\n"],"mappings":";;;AAGA,MAAa,oBAAoB;CAC/B,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;AACH"}

package/dist/entitlements/index.d.ts

@@ -0,0 +1,7 @@
+import { Page } from "../types/shared.js";
+import { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput } from "../types/schemas/entitlements.js";
+import { EntitlementCreated, EntitlementDeleted, EntitlementEvent, EntitlementExpired, EntitlementUpdated, entitlementEvents } from "./events.js";
+import "./model.js";
+import { EntitlementsRepository, EntitlementsService } from "./ports.js";
+import { EntitlementsServiceImpl } from "./service.js";
+export { type Entitlement, type EntitlementCreated, type EntitlementDeleted, type EntitlementEvent, type EntitlementExpired, type EntitlementStatus, type EntitlementUpdated, type EntitlementsQuery, type EntitlementsRepository, type EntitlementsService, EntitlementsServiceImpl, type GrantEntitlementInput, type Page, entitlementEvents };

package/dist/entitlements/index.js

@@ -0,0 +1,3 @@
+import { entitlementEvents } from "./events.js";
+import { EntitlementsServiceImpl } from "./service.js";
+export { EntitlementsServiceImpl, entitlementEvents };

package/dist/entitlements/model.d.ts

@@ -0,0 +1,4 @@
+import { Page } from "../types/shared.js";
+import { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput } from "../types/schemas/entitlements.js";
+import "../types/index.js";
+export type { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput, Page };

package/dist/entitlements/model.js

@@ -0,0 +1 @@
+export {};

package/dist/entitlements/ports.d.ts

@@ -0,0 +1,34 @@
+import { Page } from "../types/shared.js";
+import { Entitlement, EntitlementsQuery, GrantEntitlementInput } from "../types/schemas/entitlements.js";
+import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
+import "./model.js";
+//#region src/entitlements/ports.d.ts
+interface EntitlementsService {
+  list(orgId: string, query: EntitlementsQuery): Promise<Page<Entitlement>>;
+  grant(orgId: string, input: GrantEntitlementInput): Promise<Entitlement>;
+  setStatus(orgId: string, id: string, status: 'active' | 'revoked'): Promise<Entitlement | null>;
+  /** Whether this org user currently holds active access to the course.
+   *  The authority for course access — a reporting read must never be used to
+   *  infer it. */
+  hasCourseAccess(orgId: string, orgUserId: string, courseId: string): Promise<boolean>;
+}
+interface EntitlementsRepository {
+  list(orgId: string, query: EntitlementsQuery): Promise<Page<Entitlement>>;
+  insert(orgId: string, input: GrantEntitlementInput): Promise<Entitlement>;
+  setStatus(orgId: string, id: string, status: 'active' | 'revoked'): Promise<Entitlement | null>;
+  /** Whether this org user currently holds active access to the course.
+   *  The authority for course access — a reporting read must never be used to
+   *  infer it. */
+  hasCourseAccess(orgId: string, orgUserId: string, courseId: string): Promise<boolean>;
+}
+/** Tx-scoped port bundle for this context's mutating use cases — every member
+ *  is bound to the UnitOfWork's transaction, so the write and the event append
+ *  commit or roll back as one. */
+interface EntitlementsTxScope {
+  entitlements: EntitlementsRepository;
+  outbox: OutboxAppender;
+}
+type EntitlementsUnitOfWork = UnitOfWork<EntitlementsTxScope>;
+//#endregion
+export { EntitlementsRepository, EntitlementsService, EntitlementsTxScope, EntitlementsUnitOfWork };
+//# sourceMappingURL=ports.d.ts.map

package/dist/entitlements/ports.js

@@ -0,0 +1 @@
+export {};

package/dist/entitlements/service.d.ts

@@ -0,0 +1,27 @@
+import { Page } from "../types/shared.js";
+import { Logger } from "../types/ports.js";
+import { Entitlement, EntitlementsQuery, GrantEntitlementInput } from "../types/schemas/entitlements.js";
+import "../shared/ports.js";
+import "./model.js";
+import { EntitlementsRepository, EntitlementsService, EntitlementsUnitOfWork } from "./ports.js";
+//#region src/entitlements/service.d.ts
+type EntitlementsServiceParams = {
+  /** Read-only access (list) — runs outside any transaction. */
+  repo: EntitlementsRepository;
+  /** Atomic write scope: tx-bound repo + outbox appender. */
+  uow: EntitlementsUnitOfWork;
+  logger?: Logger;
+};
+declare class EntitlementsServiceImpl implements EntitlementsService {
+  private readonly repo;
+  private readonly uow;
+  private readonly logger;
+  constructor(params: EntitlementsServiceParams);
+  list(orgId: string, query: EntitlementsQuery): Promise<Page<Entitlement>>;
+  grant(orgId: string, input: GrantEntitlementInput): Promise<Entitlement>;
+  setStatus(orgId: string, id: string, status: 'active' | 'revoked'): Promise<Entitlement | null>;
+  hasCourseAccess(orgId: string, orgUserId: string, courseId: string): Promise<boolean>;
+}
+//#endregion
+export { EntitlementsServiceImpl, EntitlementsServiceParams };
+//# sourceMappingURL=service.d.ts.map