@headless-lms/core 0.3.0 → 0.4.0

package/dist/discussion/jobs.js

@@ -0,0 +1,40 @@
+import { idSchema } from "../types/schemas/shared.js";
+import { noopLogger } from "../shared/logger.js";
+import { z } from "zod";
+//#region src/discussion/jobs.ts
+const POST_PUBLISH_JOB = "discussion.post.publish";
+const DIGEST_OPEN_JOB = "discussion.digest.open";
+const postPublishPayload = z.object({
+	orgId: idSchema,
+	postId: idSchema
+}).strict();
+function discussionJobs(deps) {
+	const logger = deps.logger ?? noopLogger;
+	return [{
+		job: POST_PUBLISH_JOB,
+		async run(payload, fire) {
+			const parsed = postPublishPayload.safeParse(payload);
+			if (!parsed.success) {
+				logger.error("scheduled post payload refused", {
+					job: POST_PUBLISH_JOB,
+					fireId: fire.id
+				});
+				return;
+			}
+			await deps.posts.publishScheduled(parsed.data.orgId, parsed.data.postId, fire.startedAt);
+		}
+	}, {
+		job: DIGEST_OPEN_JOB,
+		async run(_payload, fire) {
+			await deps.digests.openDue(fire.startedAt);
+		}
+	}];
+}
+const discussionRecurringJobs = [{
+	job: DIGEST_OPEN_JOB,
+	cron: "0 * * * *"
+}];
+//#endregion
+export { DIGEST_OPEN_JOB, POST_PUBLISH_JOB, discussionJobs, discussionRecurringJobs };
+
+//# sourceMappingURL=jobs.js.map

package/dist/discussion/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","names":[],"sources":["../../src/discussion/jobs.ts"],"sourcesContent":["import { z } from 'zod';\nimport { idSchema } from '../types/schemas/index.js';\nimport type { Logger, RecurringJob, ScheduledJob } from '../shared/ports.js';\nimport { noopLogger } from '../shared/logger.js';\nimport type { DigestService, PostService } from './ports.js';\n\nexport const POST_PUBLISH_JOB = 'discussion.post.publish';\nexport const DIGEST_OPEN_JOB = 'discussion.digest.open';\n\nconst postPublishPayload = z.object({ orgId: idSchema, postId: idSchema }).strict();\n\nexport interface DiscussionJobDeps {\n  posts: Pick<PostService, 'publishScheduled'>;\n  digests: Pick<DigestService, 'openDue'>;\n  logger?: Logger;\n}\n\nexport function discussionJobs(deps: DiscussionJobDeps): ScheduledJob[] {\n  const logger = deps.logger ?? noopLogger;\n  return [\n    {\n      job: POST_PUBLISH_JOB,\n      async run(payload, fire) {\n        const parsed = postPublishPayload.safeParse(payload);\n        if (!parsed.success) {\n          logger.error('scheduled post payload refused', {\n            job: POST_PUBLISH_JOB,\n            fireId: fire.id,\n          });\n          return;\n        }\n        await deps.posts.publishScheduled(parsed.data.orgId, parsed.data.postId, fire.startedAt);\n      },\n    },\n    {\n      job: DIGEST_OPEN_JOB,\n      async run(_payload, fire) {\n        await deps.digests.openDue(fire.startedAt);\n      },\n    },\n  ];\n}\n\nexport const discussionRecurringJobs: RecurringJob[] = [\n  { job: DIGEST_OPEN_JOB, cron: '0 * * * *' },\n];\n"],"mappings":";;;;AAMA,MAAa,mBAAmB;AAChC,MAAa,kBAAkB;AAE/B,MAAM,qBAAqB,EAAE,OAAO;CAAE,OAAO;CAAU,QAAQ;AAAS,CAAC,CAAC,CAAC,OAAO;AAQlF,SAAgB,eAAe,MAAyC;CACtE,MAAM,SAAS,KAAK,UAAU;CAC9B,OAAO,CACL;EACE,KAAK;EACL,MAAM,IAAI,SAAS,MAAM;GACvB,MAAM,SAAS,mBAAmB,UAAU,OAAO;GACnD,IAAI,CAAC,OAAO,SAAS;IACnB,OAAO,MAAM,kCAAkC;KAC7C,KAAK;KACL,QAAQ,KAAK;IACf,CAAC;IACD;GACF;GACA,MAAM,KAAK,MAAM,iBAAiB,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,KAAK,SAAS;EACzF;CACF,GACA;EACE,KAAK;EACL,MAAM,IAAI,UAAU,MAAM;GACxB,MAAM,KAAK,QAAQ,QAAQ,KAAK,SAAS;EAC3C;CACF,CACF;AACF;AAEA,MAAa,0BAA0C,CACrD;CAAE,KAAK;CAAiB,MAAM;AAAY,CAC5C"}

package/dist/discussion/mentions.d.ts

@@ -0,0 +1,11 @@
+import { MentionItemType, MentionView } from "../types/schemas/discussion.js";
+import "../types/index.js";
+import { AuthorProfileReader, MentionsRepository } from "./ports.js";
+//#region src/discussion/mentions.d.ts
+declare function mentionTokens(...texts: string[]): string[];
+declare function nameMentions(text: string, nameOf: (orgUserId: string) => Promise<string>): Promise<string>;
+declare function keepAllowed(tokens: string[], allowed: string[]): string[];
+declare function mentionViews(mentions: Pick<MentionsRepository, 'forItems'>, profiles: AuthorProfileReader, orgId: string, itemType: MentionItemType, itemIds: string[]): Promise<Record<string, MentionView[]>>;
+//#endregion
+export { keepAllowed, mentionTokens, mentionViews, nameMentions };
+//# sourceMappingURL=mentions.d.ts.map

package/dist/discussion/mentions.js

@@ -0,0 +1,35 @@
+import { authorView } from "./authors.js";
+//#region src/discussion/mentions.ts
+const TOKEN = /<@([A-Za-z0-9_-]+)>/g;
+const UNNAMED = "A member";
+function mentionTokens(...texts) {
+	const found = /* @__PURE__ */ new Set();
+	for (const text of texts) for (const match of text.matchAll(TOKEN)) found.add(match[1]);
+	return [...found];
+}
+async function nameMentions(text, nameOf) {
+	const names = /* @__PURE__ */ new Map();
+	for (const orgUserId of mentionTokens(text)) names.set(orgUserId, await nameOf(orgUserId));
+	return text.replace(TOKEN, (_token, orgUserId) => names.get(orgUserId) ?? UNNAMED);
+}
+function keepAllowed(tokens, allowed) {
+	const kept = new Set(allowed);
+	return tokens.filter((token) => kept.has(token));
+}
+async function mentionViews(mentions, profiles, orgId, itemType, itemIds) {
+	if (itemIds.length === 0) return {};
+	const byItem = await mentions.forItems(orgId, itemType, [...new Set(itemIds)]);
+	const people = [...new Set(Object.values(byItem).flat())];
+	const records = people.length > 0 ? await profiles.authorsOf(orgId, people) : {};
+	return Object.fromEntries(Object.entries(byItem).map(([itemId, orgUserIds]) => [itemId, orgUserIds.flatMap((orgUserId) => {
+		const record = records[orgUserId];
+		return record ? [{
+			orgUserId,
+			name: authorView(orgId, record, null).displayName || UNNAMED
+		}] : [];
+	})]));
+}
+//#endregion
+export { keepAllowed, mentionTokens, mentionViews, nameMentions };
+
+//# sourceMappingURL=mentions.js.map

package/dist/discussion/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","names":[],"sources":["../../src/discussion/mentions.ts"],"sourcesContent":["import type { MentionItemType, MentionView } from '../types/index.js';\nimport { authorView } from './authors.js';\nimport type { AuthorProfileReader, MentionsRepository } from './ports.js';\n\nconst TOKEN = /<@([A-Za-z0-9_-]+)>/g;\nconst UNNAMED = 'A member';\n\nexport function mentionTokens(...texts: string[]): string[] {\n  const found = new Set<string>();\n  for (const text of texts) {\n    for (const match of text.matchAll(TOKEN)) {\n      found.add(match[1]!);\n    }\n  }\n  return [...found];\n}\n\nexport async function nameMentions(\n  text: string,\n  nameOf: (orgUserId: string) => Promise<string>,\n): Promise<string> {\n  const names = new Map<string, string>();\n  for (const orgUserId of mentionTokens(text)) {\n    names.set(orgUserId, await nameOf(orgUserId));\n  }\n  return text.replace(TOKEN, (_token, orgUserId: string) => names.get(orgUserId) ?? UNNAMED);\n}\n\nexport function keepAllowed(tokens: string[], allowed: string[]): string[] {\n  const kept = new Set(allowed);\n  return tokens.filter((token) => kept.has(token));\n}\n\nexport async function mentionViews(\n  mentions: Pick<MentionsRepository, 'forItems'>,\n  profiles: AuthorProfileReader,\n  orgId: string,\n  itemType: MentionItemType,\n  itemIds: string[],\n): Promise<Record<string, MentionView[]>> {\n  if (itemIds.length === 0) {\n    return {};\n  }\n  const byItem = await mentions.forItems(orgId, itemType, [...new Set(itemIds)]);\n  const people = [...new Set(Object.values(byItem).flat())];\n  const records = people.length > 0 ? await profiles.authorsOf(orgId, people) : {};\n  return Object.fromEntries(\n    Object.entries(byItem).map(([itemId, orgUserIds]) => [\n      itemId,\n      orgUserIds.flatMap((orgUserId) => {\n        const record = records[orgUserId];\n        return record\n          ? [{ orgUserId, name: authorView(orgId, record, null).displayName || UNNAMED }]\n          : [];\n      }),\n    ]),\n  );\n}\n"],"mappings":";;AAIA,MAAM,QAAQ;AACd,MAAM,UAAU;AAEhB,SAAgB,cAAc,GAAG,OAA2B;CAC1D,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,QAAQ,OACjB,KAAK,MAAM,SAAS,KAAK,SAAS,KAAK,GACrC,MAAM,IAAI,MAAM,EAAG;CAGvB,OAAO,CAAC,GAAG,KAAK;AAClB;AAEA,eAAsB,aACpB,MACA,QACiB;CACjB,MAAM,wBAAQ,IAAI,IAAoB;CACtC,KAAK,MAAM,aAAa,cAAc,IAAI,GACxC,MAAM,IAAI,WAAW,MAAM,OAAO,SAAS,CAAC;CAE9C,OAAO,KAAK,QAAQ,QAAQ,QAAQ,cAAsB,MAAM,IAAI,SAAS,KAAK,OAAO;AAC3F;AAEA,SAAgB,YAAY,QAAkB,SAA6B;CACzE,MAAM,OAAO,IAAI,IAAI,OAAO;CAC5B,OAAO,OAAO,QAAQ,UAAU,KAAK,IAAI,KAAK,CAAC;AACjD;AAEA,eAAsB,aACpB,UACA,UACA,OACA,UACA,SACwC;CACxC,IAAI,QAAQ,WAAW,GACrB,OAAO,CAAC;CAEV,MAAM,SAAS,MAAM,SAAS,SAAS,OAAO,UAAU,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC;CAC7E,MAAM,SAAS,CAAC,GAAG,IAAI,IAAI,OAAO,OAAO,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;CACxD,MAAM,UAAU,OAAO,SAAS,IAAI,MAAM,SAAS,UAAU,OAAO,MAAM,IAAI,CAAC;CAC/E,OAAO,OAAO,YACZ,OAAO,QAAQ,MAAM,CAAC,CAAC,KAAK,CAAC,QAAQ,gBAAgB,CACnD,QACA,WAAW,SAAS,cAAc;EAChC,MAAM,SAAS,QAAQ;EACvB,OAAO,SACH,CAAC;GAAE;GAAW,MAAM,WAAW,OAAO,QAAQ,IAAI,CAAC,CAAC,eAAe;EAAQ,CAAC,IAC5E,CAAC;CACP,CAAC,CACH,CAAC,CACH;AACF"}

package/dist/discussion/ports.d.ts

@@ -1,11 +1,13 @@
 import { JsonValue, Page } from "../types/shared.js";
 import { Activity, SpaceDetail } from "../types/schemas/content.js";
 import { Role } from "../types/schemas/organizations.js";
-import { Chat, ChatLastMessage, ChatUser, CommentListItem, CommentView, CommentsConfig, FlaggedComment, ListCommentsQuery, Message, MessageFlag, MessageFlagResolution, MessageView, Post, PostFlag, PostFlagResolution, PostStatus, PostView, ReactionCounts, ReactionEmoji } from "../types/schemas/discussion.js";
+import { Chat, ChatLastMessage, ChatUser, CommentListItem, CommentView, CommentsConfig, DigestRun, FlaggedComment, ListCommentsQuery, MentionItemType, Message, MessageFlag, MessageFlagResolution, MessageView, Post, PostFlag, PostFlagResolution, PostStatus, PostView, ReactionCounts, ReactionEmoji, Subscription, SubscriptionItemType, SubscriptionView } from "../types/schemas/discussion.js";
 import { Comment, CommentReport } from "../types/discussion.js";
+import { SubjectRef } from "../types/notifications.js";
 import "../types/index.js";
 import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
 import { Actor } from "../shared/actor.js";
+import { CommunityDigest } from "../content/ports.js";
 import "../content/index.js";
 import "../organizations/index.js";
 import "./model.js";
@@ -51,6 +53,13 @@ interface AuthorRecord {
   imageAssetOrgId: string | null;
   imageAssetId: string | null;
 }
+interface ItemTitle {
+  title: string;
+  excerpt?: string;
+}
+interface ItemTitles {
+  titlesFor(orgId: string, actor: Actor, refs: SubjectRef[]): Promise<Record<string, ItemTitle>>;
+}
 interface AuthorProfileReader {
   authorsOf(orgId: string, orgUserIds: string[]): Promise<Record<string, AuthorRecord>>;
 }
@@ -88,7 +97,11 @@ interface DiscussionService {
   reportComment(orgId: string, commentId: string, actor: Actor, reason: string): Promise<CommentReport>;
   /** Plain read of one comment — no rules applied. */
   getComment(orgId: string, commentId: string): Promise<Comment | null>;
-  sendDigest(orgId: string, now: Date): Promise<void>;
+  commenterIds(orgId: string, target: {
+    postId: string;
+  } | {
+    activityId: string;
+  }): Promise<string[]>;
 }
 interface ContentAccessReader {
   hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;
@@ -99,13 +112,18 @@ interface ActivityGetter {
 interface DiscussionRepository extends PostCommentReader, AuthorProfileReader {
   insertComment(orgId: string, comment: Comment): Promise<Comment>;
   findComment(orgId: string, id: string): Promise<Comment | null>;
+  commenterIds(orgId: string, target: {
+    postId: string;
+  } | {
+    activityId: string;
+  }): Promise<string[]>;
   updateComment(orgId: string, id: string, patch: Partial<Pick<Comment, 'body' | 'status' | 'removedBy' | 'updatedAt'>>): Promise<Comment | null>;
   /** Every comment on the activity, oldest first, including removed ones. */
   listByActivity(orgId: string, activityId: string): Promise<Comment[]>;
   /** A page of the post's top-level threads the viewer can see, oldest first, with their replies. `total` counts threads. */
   listThreadsByPost(orgId: string, postId: string, query: PostThreadsQuery): Promise<Page<Comment>>;
   reactionsOf(orgId: string, commentIds: string[], viewerId: string): Promise<Record<string, CommentReactions>>;
-  setReaction(orgId: string, commentId: string, orgUserId: string, emoji: ReactionEmoji | null): Promise<void>;
+  setReaction(orgId: string, commentId: string, orgUserId: string, emoji: ReactionEmoji | null): Promise<boolean>;
   /** Returns null when this person has already reported this comment. */
   insertReport(orgId: string, report: CommentReport): Promise<CommentReport | null>;
   /** Every unresolved report against the given comments. */
@@ -121,6 +139,7 @@ interface DiscussionRepository extends PostCommentReader, AuthorProfileReader {
  *  entry commit in one transaction. */
 interface DiscussionWriteScope {
   discussion: DiscussionRepository;
+  mentions: MentionsRepository;
   outbox: OutboxAppender;
 }
 type DiscussionUnitOfWork = UnitOfWork<DiscussionWriteScope>;
@@ -175,12 +194,22 @@ interface PostCommentReader {
   listOpenFlagsForSpace(orgId: string, spaceId: string, limit: number): Promise<FlaggedComment[]>;
   publishedCommentCounts(orgId: string, postIds: string[]): Promise<Record<string, number>>;
 }
+interface PublishedPost {
+  postId: string;
+  spaceId: string;
+  title: string;
+  orgUserId: string;
+  commentCount: number;
+}
 interface PostService {
   visibleTitles(orgId: string, actor: Actor, postIds: string[]): Promise<Record<string, string>>;
+  publishedBetween(orgId: string, communityId: string, from: Date, to: Date): Promise<PublishedPost[]>;
   create(orgId: string, actor: Actor, input: CreatePostInput): Promise<PostView>;
   update(orgId: string, postId: string, actor: Actor, patch: UpdatePostInput): Promise<PostView>;
   submit(orgId: string, postId: string, actor: Actor): Promise<PostView>;
   schedule(orgId: string, postId: string, actor: Actor, scheduledAt: Date): Promise<PostView>;
+  unschedule(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  publishScheduled(orgId: string, postId: string, now: Date): Promise<void>;
   approve(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;
   remove(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;
   restore(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;
@@ -190,8 +219,6 @@ interface PostService {
   openComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;
   setReactions(orgId: string, postId: string, actor: Actor, enabled: boolean): Promise<PostView>;
   setReaction(orgId: string, postId: string, actor: Actor, emoji: ReactionEmoji | null): Promise<PostReactions>;
-  follow(orgId: string, postId: string, actor: Actor): Promise<void>;
-  unfollow(orgId: string, postId: string, actor: Actor): Promise<void>;
   bookmark(orgId: string, postId: string, actor: Actor): Promise<void>;
   unbookmark(orgId: string, postId: string, actor: Actor): Promise<void>;
   flag(orgId: string, postId: string, actor: Actor, reason: string): Promise<PostFlag>;
@@ -208,29 +235,26 @@ interface PostService {
     space: SpaceDetail;
   }>;
   find(orgId: string, postId: string): Promise<Post | null>;
-  followerIds(orgId: string, postId: string): Promise<string[]>;
   moderationQueue(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceModerationQueue>;
-  publishDue(orgId: string, now: Date): Promise<void>;
-  hasDue(orgId: string, now: Date): Promise<boolean>;
+}
+interface PostGuard {
+  status: PostStatus;
+  scheduledAt?: Date;
+  dueBy?: Date;
 }
 interface PostRepository {
   insert(orgId: string, post: Post): Promise<Post>;
   update(orgId: string, id: string, patch: PostPatch): Promise<Post | null>;
+  updateIf(orgId: string, id: string, guard: PostGuard, patch: PostPatch): Promise<Post | null>;
   find(orgId: string, id: string): Promise<Post | null>;
   findMany(orgId: string, ids: string[]): Promise<Post[]>;
+  publishedBetween(orgId: string, communityId: string, from: Date, to: Date): Promise<PublishedPost[]>;
   listPublished(orgId: string, spaceIds: string[], query: FeedQuery): Promise<Page<Post>>;
   listByAuthor(orgId: string, orgUserId: string, spaceIds: string[], query: PageQuery): Promise<Page<Post>>;
   listBookmarked(orgId: string, orgUserId: string, spaceIds: string[], query: BookmarkQuery): Promise<Page<Post>>;
   listPending(orgId: string, spaceId: string, limit: number): Promise<Post[]>;
-  /** Due scheduled posts in id order, after `afterId` when given. */
-  listDue(orgId: string, now: Date, limit: number, afterId?: string): Promise<Post[]>;
-  hasDue(orgId: string, now: Date): Promise<boolean>;
   reactionsOf(orgId: string, postIds: string[], viewerId: string): Promise<Record<string, PostReactions>>;
-  setReaction(orgId: string, postId: string, orgUserId: string, emoji: ReactionEmoji | null): Promise<void>;
-  follow(orgId: string, postId: string, orgUserId: string): Promise<void>;
-  unfollow(orgId: string, postId: string, orgUserId: string): Promise<void>;
-  followerIds(orgId: string, postId: string): Promise<string[]>;
-  followedAmong(orgId: string, postIds: string[], orgUserId: string): Promise<string[]>;
+  setReaction(orgId: string, postId: string, orgUserId: string, emoji: ReactionEmoji | null): Promise<boolean>;
   bookmark(orgId: string, postId: string, orgUserId: string): Promise<void>;
   unbookmark(orgId: string, postId: string, orgUserId: string): Promise<void>;
   bookmarkedAmong(orgId: string, postIds: string[], orgUserId: string): Promise<string[]>;
@@ -245,9 +269,25 @@ interface PostRepository {
 }
 interface PostWriteScope {
   posts: PostRepository;
+  mentions: MentionsRepository;
   outbox: OutboxAppender;
 }
 type PostUnitOfWork = UnitOfWork<PostWriteScope>;
+interface DigestScheduleReader {
+  communitiesWithDigest(): Promise<CommunityDigest[]>;
+}
+interface DigestRunRepository {
+  listRuns(): Promise<DigestRun[]>;
+  advance(orgId: string, communityId: string, dueAt: Date): Promise<boolean>;
+}
+interface DigestWriteScope {
+  digests: DigestRunRepository;
+  outbox: OutboxAppender;
+}
+type DigestUnitOfWork = UnitOfWork<DigestWriteScope>;
+interface DigestService {
+  openDue(now: Date): Promise<void>;
+}
 interface StartDirectInput {
   communityId: string;
   orgUserId: string;
@@ -267,11 +307,19 @@ interface ChatListItem {
   chat: Chat;
   participantIds: string[];
   lastReadMessageId: string | null;
-  muted: boolean;
-  mutedUntil: Date | null;
+  subscription: SubscriptionView | null;
   unread: number;
   lastMessage: ChatLastMessage | null;
 }
+type ChatInboxRow = Omit<ChatListItem, 'subscription'>;
+interface ChatUnread {
+  count: number;
+  latest: {
+    messageId: string;
+    senderOrgUserId: string;
+    body: string;
+  } | null;
+}
 interface MessageReactions {
   reactions: ReactionCounts;
   viewerReaction?: ReactionEmoji;
@@ -300,8 +348,6 @@ interface ChatService {
   deleteMessage(orgId: string, actor: Actor, messageId: string): Promise<MessageView>;
   setReaction(orgId: string, actor: Actor, messageId: string, emoji: ReactionEmoji | null): Promise<MessageReactions>;
   markRead(orgId: string, actor: Actor, chatId: string, messageId: string): Promise<void>;
-  mute(orgId: string, actor: Actor, chatId: string, until?: Date): Promise<void>;
-  unmute(orgId: string, actor: Actor, chatId: string): Promise<void>;
   block(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;
   unblock(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;
   flagMessage(orgId: string, actor: Actor, messageId: string, reason: string): Promise<MessageFlag>;
@@ -314,6 +360,8 @@ interface ChatService {
     participants: ChatUser[];
   } | null>;
   latestMessageBody(orgId: string, chatId: string): Promise<string | null>;
+  unreadInChat(orgId: string, chatId: string, orgUserId: string): Promise<ChatUnread>;
+  findMessage(orgId: string, messageId: string): Promise<Message | null>;
   isBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;
   titlesFor(orgId: string, actor: Actor, chatIds: string[]): Promise<Record<string, string>>;
   messages(orgId: string, actor: Actor, chatId: string, query: Pick<FeedQuery, 'page' | 'pageSize'>): Promise<Page<MessageView>>;
@@ -328,12 +376,12 @@ interface ChatRepository {
   insertChat(orgId: string, chat: Chat): Promise<Chat>;
   updateChat(orgId: string, id: string, patch: Partial<Pick<Chat, 'status' | 'lockedAt' | 'lockedBy'>>): Promise<Chat | null>;
   findChat(orgId: string, id: string): Promise<Chat | null>;
-  listForUser(orgId: string, communityId: string, orgUserId: string, query: PageQuery): Promise<Page<ChatListItem>>;
+  listForUser(orgId: string, communityId: string, orgUserId: string, query: PageQuery): Promise<Page<ChatInboxRow>>;
   participants(orgId: string, chatId: string): Promise<ChatUser[]>;
   join(orgId: string, user: ChatUser): Promise<void>;
   markLeft(orgId: string, chatId: string, orgUserId: string, leftAt: Date): Promise<void>;
   setRead(orgId: string, chatId: string, orgUserId: string, messageId: string): Promise<void>;
-  setMuted(orgId: string, chatId: string, orgUserId: string, muted: boolean, mutedUntil: Date | null): Promise<void>;
+  unreadFor(orgId: string, chatId: string, orgUserId: string): Promise<ChatUnread>;
   insertMessage(orgId: string, message: Message): Promise<Message>;
   updateMessage(orgId: string, id: string, patch: Partial<Pick<Message, 'body' | 'editedAt' | 'deletedAt'>>): Promise<Message | null>;
   findMessage(orgId: string, id: string): Promise<Message | null>;
@@ -341,7 +389,7 @@ interface ChatRepository {
   attach(orgId: string, communityId: string, messageId: string, assetIds: string[]): Promise<void>;
   attachmentsOf(orgId: string, messageIds: string[]): Promise<Record<string, string[]>>;
   blockedWith(orgId: string, communityId: string, orgUserId: string, otherIds: string[]): Promise<string[]>;
-  setReaction(orgId: string, communityId: string, messageId: string, orgUserId: string, emoji: ReactionEmoji | null): Promise<void>;
+  setReaction(orgId: string, communityId: string, messageId: string, orgUserId: string, emoji: ReactionEmoji | null): Promise<boolean>;
   reactionsOf(orgId: string, messageIds: string[], viewerId: string): Promise<Record<string, MessageReactions>>;
   block(orgId: string, communityId: string, blockerOrgUserId: string, blockedOrgUserId: string): Promise<void>;
   unblock(orgId: string, communityId: string, blockerOrgUserId: string, blockedOrgUserId: string): Promise<void>;
@@ -365,9 +413,44 @@ interface ChatRepository {
 }
 interface ChatWriteScope {
   chats: ChatRepository;
+  mentions: MentionsRepository;
   outbox: OutboxAppender;
 }
 type ChatUnitOfWork = UnitOfWork<ChatWriteScope>;
+type SubscriptionInput = {
+  state: 'following';
+} | {
+  state: 'muted';
+  mutedUntil?: Date | null;
+} | {
+  state: 'none';
+};
+type MuteInput = Exclude<SubscriptionInput, {
+  state: 'following';
+}>;
+interface SubscriptionService {
+  setPost(orgId: string, actor: Actor, postId: string, input: SubscriptionInput): Promise<void>;
+  setSpace(orgId: string, actor: Actor, spaceId: string, input: MuteInput): Promise<void>;
+  setChat(orgId: string, actor: Actor, chatId: string, input: MuteInput): Promise<void>;
+  viewerSubscriptions(orgId: string, orgUserId: string, itemType: SubscriptionItemType, itemIds: string[], at: Date): Promise<Record<string, SubscriptionView>>;
+  followerIds(orgId: string, postId: string): Promise<string[]>;
+  mutedAmong(orgId: string, item: SubjectRef, orgUserIds: string[], at: Date): Promise<string[]>;
+  itemSubscriptions(orgId: string, item: SubjectRef): Promise<Subscription[]>;
+}
+interface SubscriptionsRepository {
+  upsert(orgId: string, subscription: Subscription): Promise<void>;
+  remove(orgId: string, orgUserId: string, itemType: SubscriptionItemType, itemId: string): Promise<void>;
+  forViewer(orgId: string, orgUserId: string, itemType: SubscriptionItemType, itemIds: string[]): Promise<Subscription[]>;
+  ofItem(orgId: string, itemType: SubscriptionItemType, itemId: string): Promise<Subscription[]>;
+  followerIds(orgId: string, postId: string): Promise<string[]>;
+  mutedAmong(orgId: string, itemType: SubscriptionItemType, itemId: string, orgUserIds: string[], at: Date): Promise<string[]>;
+}
+interface MentionsRepository {
+  ofItem(orgId: string, itemType: MentionItemType, itemId: string): Promise<string[]>;
+  forItems(orgId: string, itemType: MentionItemType, itemIds: string[]): Promise<Record<string, string[]>>;
+  sync(orgId: string, itemType: MentionItemType, itemId: string, orgUserIds: string[], at: Date): Promise<string[]>;
+  removeItem(orgId: string, itemType: MentionItemType, itemId: string): Promise<void>;
+}
 //#endregion
-export { ActivityComments, ActivityGetter, type Actor, AuthorProfileReader, AuthorRecord, AuthorRoleReader, BookmarkQuery, ChatListItem, ChatRepository, ChatService, ChatSummary, ChatUnitOfWork, ChatWriteScope, CommentReactions, CommentWithContext, ContentAccessReader, CreatePostInput, DiscussionRepository, DiscussionService, DiscussionUnitOfWork, DiscussionWriteScope, FeedQuery, MODERATION_QUEUE_LIMIT, MessageQueue, MessageQueueEntry, MessageReactions, PageQuery, PostCommentInput, PostCommentReader, PostMode, PostPatch, PostReactions, PostRepository, PostService, PostThreadsQuery, PostUnitOfWork, PostWriteScope, SendMessageInput, SpaceModerationQueue, StartDirectInput, StartGroupInput, UpdatePostInput };
+export { ActivityComments, ActivityGetter, type Actor, AuthorProfileReader, AuthorRecord, AuthorRoleReader, BookmarkQuery, ChatInboxRow, ChatListItem, ChatRepository, ChatService, ChatSummary, ChatUnitOfWork, ChatUnread, ChatWriteScope, CommentReactions, CommentWithContext, ContentAccessReader, CreatePostInput, DigestRunRepository, DigestScheduleReader, DigestService, DigestUnitOfWork, DigestWriteScope, DiscussionRepository, DiscussionService, DiscussionUnitOfWork, DiscussionWriteScope, FeedQuery, ItemTitle, ItemTitles, MODERATION_QUEUE_LIMIT, MentionsRepository, MessageQueue, MessageQueueEntry, MessageReactions, MuteInput, PageQuery, PostCommentInput, PostCommentReader, PostGuard, PostMode, PostPatch, PostReactions, PostRepository, PostService, PostThreadsQuery, PostUnitOfWork, PostWriteScope, PublishedPost, SendMessageInput, SpaceModerationQueue, StartDirectInput, StartGroupInput, SubscriptionInput, SubscriptionService, SubscriptionsRepository, UpdatePostInput };
 //# sourceMappingURL=ports.d.ts.map

package/dist/discussion/ports.js.map

@@ -1 +1 @@
-{"version":3,"file":"ports.js","names":[],"sources":["../../src/discussion/ports.ts"],"sourcesContent":["// discussion context — ports.\n// Inbound: the use cases the service implements.\n// Outbound: the persistence contract the repository fulfils.\nimport type {\n  Activity,\n  Chat,\n  ChatLastMessage,\n  ChatUser,\n  FlaggedComment,\n  JsonValue,\n  Message,\n  MessageFlag,\n  MessageFlagResolution,\n  MessageView,\n  Post,\n  PostFlag,\n  PostFlagResolution,\n  PostStatus,\n  PostView,\n} from '../types/index.js';\nimport type { SpaceDetail } from '../content/index.js';\nimport type { OutboxAppender, UnitOfWork } from '../shared/ports.js';\nimport type { Actor } from '../shared/actor.js';\nimport type { Role } from '../organizations/index.js';\nimport type { Comment, CommentReport } from './model.js';\nimport type {\n  CommentsConfig,\n  CommentListItem,\n  CommentView,\n  ListCommentsQuery,\n  Page,\n  ReactionCounts,\n  ReactionEmoji,\n} from './types.js';\n\n/** An activity's comments as this reader may see them, with the config that\n *  decided it. */\nexport interface ActivityComments {\n  config: CommentsConfig;\n  comments: CommentView[];\n}\n\nexport interface CommentReactions {\n  reactions: ReactionCounts;\n  viewerReaction?: ReactionEmoji;\n}\n\nexport interface CommentWithContext {\n  comment: Comment;\n  courseId: string;\n  activityTitle: string;\n}\n\nexport type { Actor } from '../shared/actor.js';\nexport type PostCommentInput = {\n  actor: Actor;\n  parentId: string | null;\n  body: string;\n} & ({ activityId: string; postId?: undefined } | { postId: string; activityId?: undefined });\n\n/** A profile row as the repository loads it, keyed by `org_users.id`. `email`\n *  is stripped before comments are served and kept only for the staff list. */\nexport interface AuthorRecord {\n  id: string;\n  firstName: string | null;\n  lastName: string | null;\n  email: string;\n  image: string | null;\n  role: Role;\n  displayName: string | null;\n  headline: string | null;\n  imageAssetOrgId: string | null;\n  imageAssetId: string | null;\n}\n\nexport interface AuthorProfileReader {\n  authorsOf(orgId: string, orgUserIds: string[]): Promise<Record<string, AuthorRecord>>;\n}\n\nexport interface DiscussionService {\n  /** Post a root comment or a reply. Lands pending where review is required and\n   *  the poster is not staff. */\n  postComment(orgId: string, input: PostCommentInput): Promise<CommentView>;\n  /** Author-only. Throws ForbiddenError for anyone else, staff included. */\n  edit(orgId: string, commentId: string, actor: Actor, body: string): Promise<CommentView>;\n  /** The author, or anyone whose role is staff. */\n  remove(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    communityId?: string,\n  ): Promise<CommentView>;\n  /** Staff only. Returns the comment to published. */\n  restore(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    communityId?: string,\n  ): Promise<CommentView>;\n  /** Staff only. Publishes a pending comment. */\n  approve(orgId: string, commentId: string, actor: Actor): Promise<Comment>;\n  /** Make a comment published, whichever state it is in. Staff only. */\n  publish(orgId: string, commentId: string, actor: Actor): Promise<Comment>;\n\n  /** The activity's comments as this reader may see them. */\n  activityComments(orgId: string, activityId: string, actor: Actor): Promise<ActivityComments>;\n\n  /** One page of top-level comments, oldest first, each with its replies. */\n  postComments(\n    orgId: string,\n    postId: string,\n    actor: Actor,\n    query: PageQuery,\n  ): Promise<Page<CommentView>>;\n\n  /**\n   * The org's comments, filtered. Staff-scoped: rows carry the author's email\n   * and a removed comment's body, neither of which a learner may see, so the\n   * edge admits only staff.\n   *\n   * No rule is applied beyond the filters — this is what exists, not what\n   * someone is allowed to read.\n   */\n  listComments(orgId: string, query: ListCommentsQuery): Promise<Page<CommentListItem>>;\n\n  setReaction(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    emoji: ReactionEmoji | null,\n  ): Promise<CommentReactions>;\n\n  resolveReports(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    communityId?: string,\n  ): Promise<void>;\n\n  /** Accepted even on locked comments — a locked activity can still hold\n   *  something a moderator needs to see. */\n  reportComment(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    reason: string,\n  ): Promise<CommentReport>;\n\n  /** Plain read of one comment — no rules applied. */\n  getComment(orgId: string, commentId: string): Promise<Comment | null>;\n\n  sendDigest(orgId: string, now: Date): Promise<void>;\n}\n\nexport interface ContentAccessReader {\n  hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;\n}\n\nexport interface ActivityGetter {\n  getActivity(orgId: string, activityId: string): Promise<Activity | null>;\n}\n\nexport interface DiscussionRepository extends PostCommentReader, AuthorProfileReader {\n  insertComment(orgId: string, comment: Comment): Promise<Comment>;\n  findComment(orgId: string, id: string): Promise<Comment | null>;\n  updateComment(\n    orgId: string,\n    id: string,\n    patch: Partial<Pick<Comment, 'body' | 'status' | 'removedBy' | 'updatedAt'>>,\n  ): Promise<Comment | null>;\n  /** Every comment on the activity, oldest first, including removed ones. */\n  listByActivity(orgId: string, activityId: string): Promise<Comment[]>;\n  /** A page of the post's top-level threads the viewer can see, oldest first, with their replies. `total` counts threads. */\n  listThreadsByPost(orgId: string, postId: string, query: PostThreadsQuery): Promise<Page<Comment>>;\n\n  reactionsOf(\n    orgId: string,\n    commentIds: string[],\n    viewerId: string,\n  ): Promise<Record<string, CommentReactions>>;\n  setReaction(\n    orgId: string,\n    commentId: string,\n    orgUserId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<void>;\n\n  /** Returns null when this person has already reported this comment. */\n  insertReport(orgId: string, report: CommentReport): Promise<CommentReport | null>;\n  /** Every unresolved report against the given comments. */\n  listOpenReports(orgId: string, commentIds: string[]): Promise<CommentReport[]>;\n  resolveReportsFor(\n    orgId: string,\n    commentId: string,\n    resolved: {\n      resolvedAt: Date;\n      resolvedBy: string;\n      resolution: 'dismissed' | 'removed';\n    },\n  ): Promise<void>;\n\n  listComments(orgId: string, query: ListCommentsQuery): Promise<Page<CommentWithContext>>;\n}\n\n/** Writes that emit events run through this scope so the row and the outbox\n *  entry commit in one transaction. */\nexport interface DiscussionWriteScope {\n  discussion: DiscussionRepository;\n  outbox: OutboxAppender;\n}\nexport type DiscussionUnitOfWork = UnitOfWork<DiscussionWriteScope>;\n\nexport interface AuthorRoleReader {\n  roleOf(orgId: string, orgUserId: string): Promise<Role | null>;\n  rolesOf(orgId: string, orgUserIds: string[]): Promise<Record<string, Role>>;\n}\n\nexport type PostMode = 'draft' | 'submit' | 'schedule';\n\nexport interface CreatePostInput {\n  communityId: string;\n  spaceId: string;\n  title: string;\n  body: string;\n  topicId: string | null;\n  extra: JsonValue;\n  coverAssetId: string | null;\n  mode: PostMode;\n  scheduledAt: Date | null;\n}\n\nexport interface UpdatePostInput {\n  title?: string;\n  body?: string;\n  topicId?: string | null;\n  extra?: JsonValue;\n  coverAssetId?: string | null;\n}\n\nexport type PostPatch = Partial<\n  Pick<\n    Post,\n    | 'title'\n    | 'body'\n    | 'topicId'\n    | 'extra'\n    | 'coverAssetId'\n    | 'status'\n    | 'scheduledAt'\n    | 'publishedAt'\n    | 'removedBy'\n    | 'pinned'\n    | 'commentsClosed'\n    | 'reactionsEnabled'\n  >\n>;\n\nexport interface FeedQuery {\n  page: number;\n  pageSize: number;\n  topicId?: string;\n}\n\nexport interface PostReactions {\n  reactions: ReactionCounts;\n  viewerReaction?: ReactionEmoji;\n}\n\nexport type PageQuery = Pick<FeedQuery, 'page' | 'pageSize'>;\n\nexport interface PostThreadsQuery extends PageQuery {\n  viewerId: string;\n  seesHeld: boolean;\n}\n\nexport interface BookmarkQuery extends PageQuery {\n  visibleStatuses: PostStatus[];\n}\n\nexport const MODERATION_QUEUE_LIMIT = 100;\n\nexport interface SpaceModerationQueue {\n  pending: PostView[];\n  flags: PostFlag[];\n  commentFlags: FlaggedComment[];\n}\n\nexport interface PostCommentReader {\n  listOpenFlagsForSpace(orgId: string, spaceId: string, limit: number): Promise<FlaggedComment[]>;\n  publishedCommentCounts(orgId: string, postIds: string[]): Promise<Record<string, number>>;\n}\n\nexport interface PostService {\n  visibleTitles(orgId: string, actor: Actor, postIds: string[]): Promise<Record<string, string>>;\n  create(orgId: string, actor: Actor, input: CreatePostInput): Promise<PostView>;\n  update(orgId: string, postId: string, actor: Actor, patch: UpdatePostInput): Promise<PostView>;\n  submit(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  schedule(orgId: string, postId: string, actor: Actor, scheduledAt: Date): Promise<PostView>;\n  approve(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;\n  remove(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;\n  restore(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;\n  pin(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  unpin(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  closeComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  openComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  setReactions(orgId: string, postId: string, actor: Actor, enabled: boolean): Promise<PostView>;\n  setReaction(\n    orgId: string,\n    postId: string,\n    actor: Actor,\n    emoji: ReactionEmoji | null,\n  ): Promise<PostReactions>;\n  follow(orgId: string, postId: string, actor: Actor): Promise<void>;\n  unfollow(orgId: string, postId: string, actor: Actor): Promise<void>;\n  bookmark(orgId: string, postId: string, actor: Actor): Promise<void>;\n  unbookmark(orgId: string, postId: string, actor: Actor): Promise<void>;\n  flag(orgId: string, postId: string, actor: Actor, reason: string): Promise<PostFlag>;\n  resolveFlags(\n    orgId: string,\n    postId: string,\n    actor: Actor,\n    resolution: Extract<PostFlagResolution, 'dismissed'>,\n    communityId?: string,\n  ): Promise<void>;\n  spaceFeed(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    spaceId: string,\n    query: FeedQuery,\n  ): Promise<Page<PostView>>;\n  memberFeed(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n  ): Promise<Page<PostView>>;\n  listOwn(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: PageQuery,\n  ): Promise<Page<PostView>>;\n  listBookmarked(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: PageQuery,\n  ): Promise<Page<PostView>>;\n  /** Signed URL of the post's cover, for whoever can read the post. */\n  coverFile(orgId: string, actor: Actor, postId: string): Promise<string | null>;\n  getPost(orgId: string, actor: Actor, postId: string): Promise<PostView>;\n  visible(orgId: string, actor: Actor, postId: string): Promise<{ post: Post; space: SpaceDetail }>;\n  find(orgId: string, postId: string): Promise<Post | null>;\n  followerIds(orgId: string, postId: string): Promise<string[]>;\n  moderationQueue(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    spaceId: string,\n  ): Promise<SpaceModerationQueue>;\n  publishDue(orgId: string, now: Date): Promise<void>;\n  hasDue(orgId: string, now: Date): Promise<boolean>;\n}\n\nexport interface PostRepository {\n  insert(orgId: string, post: Post): Promise<Post>;\n  update(orgId: string, id: string, patch: PostPatch): Promise<Post | null>;\n  find(orgId: string, id: string): Promise<Post | null>;\n  findMany(orgId: string, ids: string[]): Promise<Post[]>;\n  listPublished(orgId: string, spaceIds: string[], query: FeedQuery): Promise<Page<Post>>;\n  listByAuthor(\n    orgId: string,\n    orgUserId: string,\n    spaceIds: string[],\n    query: PageQuery,\n  ): Promise<Page<Post>>;\n  listBookmarked(\n    orgId: string,\n    orgUserId: string,\n    spaceIds: string[],\n    query: BookmarkQuery,\n  ): Promise<Page<Post>>;\n  listPending(orgId: string, spaceId: string, limit: number): Promise<Post[]>;\n  /** Due scheduled posts in id order, after `afterId` when given. */\n  listDue(orgId: string, now: Date, limit: number, afterId?: string): Promise<Post[]>;\n  hasDue(orgId: string, now: Date): Promise<boolean>;\n  reactionsOf(\n    orgId: string,\n    postIds: string[],\n    viewerId: string,\n  ): Promise<Record<string, PostReactions>>;\n  setReaction(\n    orgId: string,\n    postId: string,\n    orgUserId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<void>;\n  follow(orgId: string, postId: string, orgUserId: string): Promise<void>;\n  unfollow(orgId: string, postId: string, orgUserId: string): Promise<void>;\n  followerIds(orgId: string, postId: string): Promise<string[]>;\n  followedAmong(orgId: string, postIds: string[], orgUserId: string): Promise<string[]>;\n  bookmark(orgId: string, postId: string, orgUserId: string): Promise<void>;\n  unbookmark(orgId: string, postId: string, orgUserId: string): Promise<void>;\n  bookmarkedAmong(orgId: string, postIds: string[], orgUserId: string): Promise<string[]>;\n  insertFlag(orgId: string, flag: PostFlag): Promise<PostFlag | null>;\n  findFlag(orgId: string, postId: string, orgUserId: string): Promise<PostFlag | null>;\n  listOpenFlags(orgId: string, spaceId: string, limit: number): Promise<PostFlag[]>;\n  resolveFlags(\n    orgId: string,\n    postId: string,\n    resolved: { resolvedAt: Date; resolvedBy: string; resolution: PostFlagResolution },\n  ): Promise<void>;\n}\n\nexport interface PostWriteScope {\n  posts: PostRepository;\n  outbox: OutboxAppender;\n}\nexport type PostUnitOfWork = UnitOfWork<PostWriteScope>;\n\nexport interface StartDirectInput {\n  communityId: string;\n  orgUserId: string;\n  body: string | null;\n  assetIds: string[];\n}\n\nexport interface StartGroupInput {\n  communityId: string;\n  orgUserIds: string[];\n}\n\nexport interface SendMessageInput {\n  body: string;\n  replyToId: string | null;\n  assetIds: string[];\n}\n\nexport interface ChatListItem {\n  chat: Chat;\n  participantIds: string[];\n  lastReadMessageId: string | null;\n  muted: boolean;\n  mutedUntil: Date | null;\n  unread: number;\n  lastMessage: ChatLastMessage | null;\n}\n\nexport interface MessageReactions {\n  reactions: ReactionCounts;\n  viewerReaction?: ReactionEmoji;\n}\n\nexport interface ChatSummary {\n  chat: Chat;\n  participantIds: string[];\n}\n\nexport interface MessageQueueEntry {\n  message: MessageView;\n  flags: MessageFlag[];\n  chat: Chat;\n  participantIds: string[];\n}\n\nexport interface MessageQueue {\n  entries: MessageQueueEntry[];\n}\n\nexport interface ChatService {\n  startDirect(orgId: string, actor: Actor, input: StartDirectInput): Promise<Chat>;\n  startGroup(orgId: string, actor: Actor, input: StartGroupInput): Promise<Chat>;\n  addParticipant(orgId: string, actor: Actor, chatId: string, orgUserId: string): Promise<Chat>;\n  leave(orgId: string, actor: Actor, chatId: string): Promise<Chat>;\n  accept(orgId: string, actor: Actor, chatId: string): Promise<Chat>;\n  send(orgId: string, actor: Actor, chatId: string, input: SendMessageInput): Promise<MessageView>;\n  editMessage(orgId: string, actor: Actor, messageId: string, body: string): Promise<MessageView>;\n  deleteMessage(orgId: string, actor: Actor, messageId: string): Promise<MessageView>;\n  setReaction(\n    orgId: string,\n    actor: Actor,\n    messageId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<MessageReactions>;\n  markRead(orgId: string, actor: Actor, chatId: string, messageId: string): Promise<void>;\n  mute(orgId: string, actor: Actor, chatId: string, until?: Date): Promise<void>;\n  unmute(orgId: string, actor: Actor, chatId: string): Promise<void>;\n  block(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;\n  unblock(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;\n  flagMessage(orgId: string, actor: Actor, messageId: string, reason: string): Promise<MessageFlag>;\n  resolveMessageFlags(\n    orgId: string,\n    actor: Actor,\n    messageId: string,\n    resolution: Extract<MessageFlagResolution, 'dismissed'>,\n    communityId?: string,\n  ): Promise<void>;\n  lock(orgId: string, actor: Actor, chatId: string, communityId?: string): Promise<Chat>;\n  unlock(orgId: string, actor: Actor, chatId: string, communityId?: string): Promise<Chat>;\n  listChats(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: PageQuery,\n  ): Promise<Page<ChatListItem>>;\n  chatSummary(\n    orgId: string,\n    chatId: string,\n  ): Promise<{ chat: Chat; participants: ChatUser[] } | null>;\n  latestMessageBody(orgId: string, chatId: string): Promise<string | null>;\n  isBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;\n  titlesFor(orgId: string, actor: Actor, chatIds: string[]): Promise<Record<string, string>>;\n  messages(\n    orgId: string,\n    actor: Actor,\n    chatId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n  ): Promise<Page<MessageView>>;\n  /** Signed URL of a message attachment: for the chat's participants while the\n   *  message stands (staff also after deletion), and for staff while it is flagged. */\n  attachmentFile(\n    orgId: string,\n    actor: Actor,\n    chatId: string,\n    messageId: string,\n    assetId: string,\n  ): Promise<string | null>;\n  messageQueue(orgId: string, actor: Actor, communityId: string): Promise<MessageQueue>;\n}\n\nexport interface ChatRepository {\n  lockDirectPair(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    otherOrgUserId: string,\n  ): Promise<void>;\n  findDirect(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    otherOrgUserId: string,\n  ): Promise<Chat | null>;\n  insertChat(orgId: string, chat: Chat): Promise<Chat>;\n  updateChat(\n    orgId: string,\n    id: string,\n    patch: Partial<Pick<Chat, 'status' | 'lockedAt' | 'lockedBy'>>,\n  ): Promise<Chat | null>;\n  findChat(orgId: string, id: string): Promise<Chat | null>;\n  listForUser(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    query: PageQuery,\n  ): Promise<Page<ChatListItem>>;\n  participants(orgId: string, chatId: string): Promise<ChatUser[]>;\n  join(orgId: string, user: ChatUser): Promise<void>;\n  markLeft(orgId: string, chatId: string, orgUserId: string, leftAt: Date): Promise<void>;\n  setRead(orgId: string, chatId: string, orgUserId: string, messageId: string): Promise<void>;\n  setMuted(\n    orgId: string,\n    chatId: string,\n    orgUserId: string,\n    muted: boolean,\n    mutedUntil: Date | null,\n  ): Promise<void>;\n  insertMessage(orgId: string, message: Message): Promise<Message>;\n  updateMessage(\n    orgId: string,\n    id: string,\n    patch: Partial<Pick<Message, 'body' | 'editedAt' | 'deletedAt'>>,\n  ): Promise<Message | null>;\n  findMessage(orgId: string, id: string): Promise<Message | null>;\n  listMessages(\n    orgId: string,\n    chatId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n  ): Promise<Page<Message>>;\n  attach(orgId: string, communityId: string, messageId: string, assetIds: string[]): Promise<void>;\n  attachmentsOf(orgId: string, messageIds: string[]): Promise<Record<string, string[]>>;\n  blockedWith(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    otherIds: string[],\n  ): Promise<string[]>;\n  setReaction(\n    orgId: string,\n    communityId: string,\n    messageId: string,\n    orgUserId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<void>;\n  reactionsOf(\n    orgId: string,\n    messageIds: string[],\n    viewerId: string,\n  ): Promise<Record<string, MessageReactions>>;\n  block(\n    orgId: string,\n    communityId: string,\n    blockerOrgUserId: string,\n    blockedOrgUserId: string,\n  ): Promise<void>;\n  unblock(\n    orgId: string,\n    communityId: string,\n    blockerOrgUserId: string,\n    blockedOrgUserId: string,\n  ): Promise<void>;\n  isBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;\n  anyBlockedAmong(orgId: string, communityId: string, orgUserIds: string[]): Promise<boolean>;\n  insertFlag(orgId: string, flag: MessageFlag): Promise<MessageFlag | null>;\n  findFlag(orgId: string, messageId: string, orgUserId: string): Promise<MessageFlag | null>;\n  listOpenFlags(orgId: string, communityId: string, limit?: number): Promise<MessageFlag[]>;\n  messagesByIds(orgId: string, ids: string[]): Promise<Message[]>;\n  chatSummaries(orgId: string, chatIds: string[]): Promise<ChatSummary[]>;\n  resolveFlags(\n    orgId: string,\n    messageId: string,\n    resolved: { resolvedAt: Date; resolvedBy: string; resolution: MessageFlagResolution },\n  ): Promise<void>;\n  resolveOpenFlagsForChat(\n    orgId: string,\n    chatId: string,\n    resolved: { resolvedAt: Date; resolvedBy: string; resolution: MessageFlagResolution },\n  ): Promise<void>;\n}\n\nexport interface ChatWriteScope {\n  chats: ChatRepository;\n  outbox: OutboxAppender;\n}\nexport type ChatUnitOfWork = UnitOfWork<ChatWriteScope>;\n"],"mappings":";AAuRA,MAAa,yBAAyB"}
+{"version":3,"file":"ports.js","names":[],"sources":["../../src/discussion/ports.ts"],"sourcesContent":["// discussion context — ports.\n// Inbound: the use cases the service implements.\n// Outbound: the persistence contract the repository fulfils.\nimport type {\n  Activity,\n  Chat,\n  ChatLastMessage,\n  ChatUser,\n  DigestRun,\n  FlaggedComment,\n  JsonValue,\n  MentionItemType,\n  Message,\n  MessageFlag,\n  MessageFlagResolution,\n  MessageView,\n  Post,\n  PostFlag,\n  PostFlagResolution,\n  PostStatus,\n  PostView,\n  SubjectRef,\n  Subscription,\n  SubscriptionItemType,\n  SubscriptionView,\n} from '../types/index.js';\nimport type { CommunityDigest, SpaceDetail } from '../content/index.js';\nimport type { OutboxAppender, UnitOfWork } from '../shared/ports.js';\nimport type { Actor } from '../shared/actor.js';\nimport type { Role } from '../organizations/index.js';\nimport type { Comment, CommentReport } from './model.js';\nimport type {\n  CommentsConfig,\n  CommentListItem,\n  CommentView,\n  ListCommentsQuery,\n  Page,\n  ReactionCounts,\n  ReactionEmoji,\n} from './types.js';\n\n/** An activity's comments as this reader may see them, with the config that\n *  decided it. */\nexport interface ActivityComments {\n  config: CommentsConfig;\n  comments: CommentView[];\n}\n\nexport interface CommentReactions {\n  reactions: ReactionCounts;\n  viewerReaction?: ReactionEmoji;\n}\n\nexport interface CommentWithContext {\n  comment: Comment;\n  courseId: string;\n  activityTitle: string;\n}\n\nexport type { Actor } from '../shared/actor.js';\nexport type PostCommentInput = {\n  actor: Actor;\n  parentId: string | null;\n  body: string;\n} & ({ activityId: string; postId?: undefined } | { postId: string; activityId?: undefined });\n\n/** A profile row as the repository loads it, keyed by `org_users.id`. `email`\n *  is stripped before comments are served and kept only for the staff list. */\nexport interface AuthorRecord {\n  id: string;\n  firstName: string | null;\n  lastName: string | null;\n  email: string;\n  image: string | null;\n  role: Role;\n  displayName: string | null;\n  headline: string | null;\n  imageAssetOrgId: string | null;\n  imageAssetId: string | null;\n}\n\nexport interface ItemTitle {\n  title: string;\n  excerpt?: string;\n}\n\nexport interface ItemTitles {\n  titlesFor(orgId: string, actor: Actor, refs: SubjectRef[]): Promise<Record<string, ItemTitle>>;\n}\n\nexport interface AuthorProfileReader {\n  authorsOf(orgId: string, orgUserIds: string[]): Promise<Record<string, AuthorRecord>>;\n}\n\nexport interface DiscussionService {\n  /** Post a root comment or a reply. Lands pending where review is required and\n   *  the poster is not staff. */\n  postComment(orgId: string, input: PostCommentInput): Promise<CommentView>;\n  /** Author-only. Throws ForbiddenError for anyone else, staff included. */\n  edit(orgId: string, commentId: string, actor: Actor, body: string): Promise<CommentView>;\n  /** The author, or anyone whose role is staff. */\n  remove(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    communityId?: string,\n  ): Promise<CommentView>;\n  /** Staff only. Returns the comment to published. */\n  restore(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    communityId?: string,\n  ): Promise<CommentView>;\n  /** Staff only. Publishes a pending comment. */\n  approve(orgId: string, commentId: string, actor: Actor): Promise<Comment>;\n  /** Make a comment published, whichever state it is in. Staff only. */\n  publish(orgId: string, commentId: string, actor: Actor): Promise<Comment>;\n\n  /** The activity's comments as this reader may see them. */\n  activityComments(orgId: string, activityId: string, actor: Actor): Promise<ActivityComments>;\n\n  /** One page of top-level comments, oldest first, each with its replies. */\n  postComments(\n    orgId: string,\n    postId: string,\n    actor: Actor,\n    query: PageQuery,\n  ): Promise<Page<CommentView>>;\n\n  /**\n   * The org's comments, filtered. Staff-scoped: rows carry the author's email\n   * and a removed comment's body, neither of which a learner may see, so the\n   * edge admits only staff.\n   *\n   * No rule is applied beyond the filters — this is what exists, not what\n   * someone is allowed to read.\n   */\n  listComments(orgId: string, query: ListCommentsQuery): Promise<Page<CommentListItem>>;\n\n  setReaction(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    emoji: ReactionEmoji | null,\n  ): Promise<CommentReactions>;\n\n  resolveReports(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    communityId?: string,\n  ): Promise<void>;\n\n  /** Accepted even on locked comments — a locked activity can still hold\n   *  something a moderator needs to see. */\n  reportComment(\n    orgId: string,\n    commentId: string,\n    actor: Actor,\n    reason: string,\n  ): Promise<CommentReport>;\n\n  /** Plain read of one comment — no rules applied. */\n  getComment(orgId: string, commentId: string): Promise<Comment | null>;\n  commenterIds(\n    orgId: string,\n    target: { postId: string } | { activityId: string },\n  ): Promise<string[]>;\n}\n\nexport interface ContentAccessReader {\n  hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;\n}\n\nexport interface ActivityGetter {\n  getActivity(orgId: string, activityId: string): Promise<Activity | null>;\n}\n\nexport interface DiscussionRepository extends PostCommentReader, AuthorProfileReader {\n  insertComment(orgId: string, comment: Comment): Promise<Comment>;\n  findComment(orgId: string, id: string): Promise<Comment | null>;\n  commenterIds(\n    orgId: string,\n    target: { postId: string } | { activityId: string },\n  ): Promise<string[]>;\n  updateComment(\n    orgId: string,\n    id: string,\n    patch: Partial<Pick<Comment, 'body' | 'status' | 'removedBy' | 'updatedAt'>>,\n  ): Promise<Comment | null>;\n  /** Every comment on the activity, oldest first, including removed ones. */\n  listByActivity(orgId: string, activityId: string): Promise<Comment[]>;\n  /** A page of the post's top-level threads the viewer can see, oldest first, with their replies. `total` counts threads. */\n  listThreadsByPost(orgId: string, postId: string, query: PostThreadsQuery): Promise<Page<Comment>>;\n\n  reactionsOf(\n    orgId: string,\n    commentIds: string[],\n    viewerId: string,\n  ): Promise<Record<string, CommentReactions>>;\n  setReaction(\n    orgId: string,\n    commentId: string,\n    orgUserId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<boolean>;\n\n  /** Returns null when this person has already reported this comment. */\n  insertReport(orgId: string, report: CommentReport): Promise<CommentReport | null>;\n  /** Every unresolved report against the given comments. */\n  listOpenReports(orgId: string, commentIds: string[]): Promise<CommentReport[]>;\n  resolveReportsFor(\n    orgId: string,\n    commentId: string,\n    resolved: {\n      resolvedAt: Date;\n      resolvedBy: string;\n      resolution: 'dismissed' | 'removed';\n    },\n  ): Promise<void>;\n\n  listComments(orgId: string, query: ListCommentsQuery): Promise<Page<CommentWithContext>>;\n}\n\n/** Writes that emit events run through this scope so the row and the outbox\n *  entry commit in one transaction. */\nexport interface DiscussionWriteScope {\n  discussion: DiscussionRepository;\n  mentions: MentionsRepository;\n  outbox: OutboxAppender;\n}\nexport type DiscussionUnitOfWork = UnitOfWork<DiscussionWriteScope>;\n\nexport interface AuthorRoleReader {\n  roleOf(orgId: string, orgUserId: string): Promise<Role | null>;\n  rolesOf(orgId: string, orgUserIds: string[]): Promise<Record<string, Role>>;\n}\n\nexport type PostMode = 'draft' | 'submit' | 'schedule';\n\nexport interface CreatePostInput {\n  communityId: string;\n  spaceId: string;\n  title: string;\n  body: string;\n  topicId: string | null;\n  extra: JsonValue;\n  coverAssetId: string | null;\n  mode: PostMode;\n  scheduledAt: Date | null;\n}\n\nexport interface UpdatePostInput {\n  title?: string;\n  body?: string;\n  topicId?: string | null;\n  extra?: JsonValue;\n  coverAssetId?: string | null;\n}\n\nexport type PostPatch = Partial<\n  Pick<\n    Post,\n    | 'title'\n    | 'body'\n    | 'topicId'\n    | 'extra'\n    | 'coverAssetId'\n    | 'status'\n    | 'scheduledAt'\n    | 'publishedAt'\n    | 'removedBy'\n    | 'pinned'\n    | 'commentsClosed'\n    | 'reactionsEnabled'\n  >\n>;\n\nexport interface FeedQuery {\n  page: number;\n  pageSize: number;\n  topicId?: string;\n}\n\nexport interface PostReactions {\n  reactions: ReactionCounts;\n  viewerReaction?: ReactionEmoji;\n}\n\nexport type PageQuery = Pick<FeedQuery, 'page' | 'pageSize'>;\n\nexport interface PostThreadsQuery extends PageQuery {\n  viewerId: string;\n  seesHeld: boolean;\n}\n\nexport interface BookmarkQuery extends PageQuery {\n  visibleStatuses: PostStatus[];\n}\n\nexport const MODERATION_QUEUE_LIMIT = 100;\n\nexport interface SpaceModerationQueue {\n  pending: PostView[];\n  flags: PostFlag[];\n  commentFlags: FlaggedComment[];\n}\n\nexport interface PostCommentReader {\n  listOpenFlagsForSpace(orgId: string, spaceId: string, limit: number): Promise<FlaggedComment[]>;\n  publishedCommentCounts(orgId: string, postIds: string[]): Promise<Record<string, number>>;\n}\n\nexport interface PublishedPost {\n  postId: string;\n  spaceId: string;\n  title: string;\n  orgUserId: string;\n  commentCount: number;\n}\n\nexport interface PostService {\n  visibleTitles(orgId: string, actor: Actor, postIds: string[]): Promise<Record<string, string>>;\n  publishedBetween(\n    orgId: string,\n    communityId: string,\n    from: Date,\n    to: Date,\n  ): Promise<PublishedPost[]>;\n  create(orgId: string, actor: Actor, input: CreatePostInput): Promise<PostView>;\n  update(orgId: string, postId: string, actor: Actor, patch: UpdatePostInput): Promise<PostView>;\n  submit(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  schedule(orgId: string, postId: string, actor: Actor, scheduledAt: Date): Promise<PostView>;\n  unschedule(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  publishScheduled(orgId: string, postId: string, now: Date): Promise<void>;\n  approve(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;\n  remove(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;\n  restore(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;\n  pin(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  unpin(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  closeComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  openComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;\n  setReactions(orgId: string, postId: string, actor: Actor, enabled: boolean): Promise<PostView>;\n  setReaction(\n    orgId: string,\n    postId: string,\n    actor: Actor,\n    emoji: ReactionEmoji | null,\n  ): Promise<PostReactions>;\n  bookmark(orgId: string, postId: string, actor: Actor): Promise<void>;\n  unbookmark(orgId: string, postId: string, actor: Actor): Promise<void>;\n  flag(orgId: string, postId: string, actor: Actor, reason: string): Promise<PostFlag>;\n  resolveFlags(\n    orgId: string,\n    postId: string,\n    actor: Actor,\n    resolution: Extract<PostFlagResolution, 'dismissed'>,\n    communityId?: string,\n  ): Promise<void>;\n  spaceFeed(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    spaceId: string,\n    query: FeedQuery,\n  ): Promise<Page<PostView>>;\n  memberFeed(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n  ): Promise<Page<PostView>>;\n  listOwn(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: PageQuery,\n  ): Promise<Page<PostView>>;\n  listBookmarked(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: PageQuery,\n  ): Promise<Page<PostView>>;\n  /** Signed URL of the post's cover, for whoever can read the post. */\n  coverFile(orgId: string, actor: Actor, postId: string): Promise<string | null>;\n  getPost(orgId: string, actor: Actor, postId: string): Promise<PostView>;\n  visible(orgId: string, actor: Actor, postId: string): Promise<{ post: Post; space: SpaceDetail }>;\n  find(orgId: string, postId: string): Promise<Post | null>;\n  moderationQueue(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    spaceId: string,\n  ): Promise<SpaceModerationQueue>;\n}\n\nexport interface PostGuard {\n  status: PostStatus;\n  scheduledAt?: Date;\n  dueBy?: Date;\n}\n\nexport interface PostRepository {\n  insert(orgId: string, post: Post): Promise<Post>;\n  update(orgId: string, id: string, patch: PostPatch): Promise<Post | null>;\n  updateIf(orgId: string, id: string, guard: PostGuard, patch: PostPatch): Promise<Post | null>;\n  find(orgId: string, id: string): Promise<Post | null>;\n  findMany(orgId: string, ids: string[]): Promise<Post[]>;\n  publishedBetween(\n    orgId: string,\n    communityId: string,\n    from: Date,\n    to: Date,\n  ): Promise<PublishedPost[]>;\n  listPublished(orgId: string, spaceIds: string[], query: FeedQuery): Promise<Page<Post>>;\n  listByAuthor(\n    orgId: string,\n    orgUserId: string,\n    spaceIds: string[],\n    query: PageQuery,\n  ): Promise<Page<Post>>;\n  listBookmarked(\n    orgId: string,\n    orgUserId: string,\n    spaceIds: string[],\n    query: BookmarkQuery,\n  ): Promise<Page<Post>>;\n  listPending(orgId: string, spaceId: string, limit: number): Promise<Post[]>;\n  reactionsOf(\n    orgId: string,\n    postIds: string[],\n    viewerId: string,\n  ): Promise<Record<string, PostReactions>>;\n  setReaction(\n    orgId: string,\n    postId: string,\n    orgUserId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<boolean>;\n  bookmark(orgId: string, postId: string, orgUserId: string): Promise<void>;\n  unbookmark(orgId: string, postId: string, orgUserId: string): Promise<void>;\n  bookmarkedAmong(orgId: string, postIds: string[], orgUserId: string): Promise<string[]>;\n  insertFlag(orgId: string, flag: PostFlag): Promise<PostFlag | null>;\n  findFlag(orgId: string, postId: string, orgUserId: string): Promise<PostFlag | null>;\n  listOpenFlags(orgId: string, spaceId: string, limit: number): Promise<PostFlag[]>;\n  resolveFlags(\n    orgId: string,\n    postId: string,\n    resolved: { resolvedAt: Date; resolvedBy: string; resolution: PostFlagResolution },\n  ): Promise<void>;\n}\n\nexport interface PostWriteScope {\n  posts: PostRepository;\n  mentions: MentionsRepository;\n  outbox: OutboxAppender;\n}\nexport type PostUnitOfWork = UnitOfWork<PostWriteScope>;\n\nexport interface DigestScheduleReader {\n  communitiesWithDigest(): Promise<CommunityDigest[]>;\n}\n\nexport interface DigestRunRepository {\n  listRuns(): Promise<DigestRun[]>;\n  advance(orgId: string, communityId: string, dueAt: Date): Promise<boolean>;\n}\n\nexport interface DigestWriteScope {\n  digests: DigestRunRepository;\n  outbox: OutboxAppender;\n}\nexport type DigestUnitOfWork = UnitOfWork<DigestWriteScope>;\n\nexport interface DigestService {\n  openDue(now: Date): Promise<void>;\n}\n\nexport interface StartDirectInput {\n  communityId: string;\n  orgUserId: string;\n  body: string | null;\n  assetIds: string[];\n}\n\nexport interface StartGroupInput {\n  communityId: string;\n  orgUserIds: string[];\n}\n\nexport interface SendMessageInput {\n  body: string;\n  replyToId: string | null;\n  assetIds: string[];\n}\n\nexport interface ChatListItem {\n  chat: Chat;\n  participantIds: string[];\n  lastReadMessageId: string | null;\n  subscription: SubscriptionView | null;\n  unread: number;\n  lastMessage: ChatLastMessage | null;\n}\n\nexport type ChatInboxRow = Omit<ChatListItem, 'subscription'>;\n\nexport interface ChatUnread {\n  count: number;\n  latest: { messageId: string; senderOrgUserId: string; body: string } | null;\n}\n\nexport interface MessageReactions {\n  reactions: ReactionCounts;\n  viewerReaction?: ReactionEmoji;\n}\n\nexport interface ChatSummary {\n  chat: Chat;\n  participantIds: string[];\n}\n\nexport interface MessageQueueEntry {\n  message: MessageView;\n  flags: MessageFlag[];\n  chat: Chat;\n  participantIds: string[];\n}\n\nexport interface MessageQueue {\n  entries: MessageQueueEntry[];\n}\n\nexport interface ChatService {\n  startDirect(orgId: string, actor: Actor, input: StartDirectInput): Promise<Chat>;\n  startGroup(orgId: string, actor: Actor, input: StartGroupInput): Promise<Chat>;\n  addParticipant(orgId: string, actor: Actor, chatId: string, orgUserId: string): Promise<Chat>;\n  leave(orgId: string, actor: Actor, chatId: string): Promise<Chat>;\n  accept(orgId: string, actor: Actor, chatId: string): Promise<Chat>;\n  send(orgId: string, actor: Actor, chatId: string, input: SendMessageInput): Promise<MessageView>;\n  editMessage(orgId: string, actor: Actor, messageId: string, body: string): Promise<MessageView>;\n  deleteMessage(orgId: string, actor: Actor, messageId: string): Promise<MessageView>;\n  setReaction(\n    orgId: string,\n    actor: Actor,\n    messageId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<MessageReactions>;\n  markRead(orgId: string, actor: Actor, chatId: string, messageId: string): Promise<void>;\n  block(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;\n  unblock(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;\n  flagMessage(orgId: string, actor: Actor, messageId: string, reason: string): Promise<MessageFlag>;\n  resolveMessageFlags(\n    orgId: string,\n    actor: Actor,\n    messageId: string,\n    resolution: Extract<MessageFlagResolution, 'dismissed'>,\n    communityId?: string,\n  ): Promise<void>;\n  lock(orgId: string, actor: Actor, chatId: string, communityId?: string): Promise<Chat>;\n  unlock(orgId: string, actor: Actor, chatId: string, communityId?: string): Promise<Chat>;\n  listChats(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: PageQuery,\n  ): Promise<Page<ChatListItem>>;\n  chatSummary(\n    orgId: string,\n    chatId: string,\n  ): Promise<{ chat: Chat; participants: ChatUser[] } | null>;\n  latestMessageBody(orgId: string, chatId: string): Promise<string | null>;\n  unreadInChat(orgId: string, chatId: string, orgUserId: string): Promise<ChatUnread>;\n  findMessage(orgId: string, messageId: string): Promise<Message | null>;\n  isBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;\n  titlesFor(orgId: string, actor: Actor, chatIds: string[]): Promise<Record<string, string>>;\n  messages(\n    orgId: string,\n    actor: Actor,\n    chatId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n  ): Promise<Page<MessageView>>;\n  /** Signed URL of a message attachment: for the chat's participants while the\n   *  message stands (staff also after deletion), and for staff while it is flagged. */\n  attachmentFile(\n    orgId: string,\n    actor: Actor,\n    chatId: string,\n    messageId: string,\n    assetId: string,\n  ): Promise<string | null>;\n  messageQueue(orgId: string, actor: Actor, communityId: string): Promise<MessageQueue>;\n}\n\nexport interface ChatRepository {\n  lockDirectPair(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    otherOrgUserId: string,\n  ): Promise<void>;\n  findDirect(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    otherOrgUserId: string,\n  ): Promise<Chat | null>;\n  insertChat(orgId: string, chat: Chat): Promise<Chat>;\n  updateChat(\n    orgId: string,\n    id: string,\n    patch: Partial<Pick<Chat, 'status' | 'lockedAt' | 'lockedBy'>>,\n  ): Promise<Chat | null>;\n  findChat(orgId: string, id: string): Promise<Chat | null>;\n  listForUser(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    query: PageQuery,\n  ): Promise<Page<ChatInboxRow>>;\n  participants(orgId: string, chatId: string): Promise<ChatUser[]>;\n  join(orgId: string, user: ChatUser): Promise<void>;\n  markLeft(orgId: string, chatId: string, orgUserId: string, leftAt: Date): Promise<void>;\n  setRead(orgId: string, chatId: string, orgUserId: string, messageId: string): Promise<void>;\n  unreadFor(orgId: string, chatId: string, orgUserId: string): Promise<ChatUnread>;\n  insertMessage(orgId: string, message: Message): Promise<Message>;\n  updateMessage(\n    orgId: string,\n    id: string,\n    patch: Partial<Pick<Message, 'body' | 'editedAt' | 'deletedAt'>>,\n  ): Promise<Message | null>;\n  findMessage(orgId: string, id: string): Promise<Message | null>;\n  listMessages(\n    orgId: string,\n    chatId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n  ): Promise<Page<Message>>;\n  attach(orgId: string, communityId: string, messageId: string, assetIds: string[]): Promise<void>;\n  attachmentsOf(orgId: string, messageIds: string[]): Promise<Record<string, string[]>>;\n  blockedWith(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    otherIds: string[],\n  ): Promise<string[]>;\n  setReaction(\n    orgId: string,\n    communityId: string,\n    messageId: string,\n    orgUserId: string,\n    emoji: ReactionEmoji | null,\n  ): Promise<boolean>;\n  reactionsOf(\n    orgId: string,\n    messageIds: string[],\n    viewerId: string,\n  ): Promise<Record<string, MessageReactions>>;\n  block(\n    orgId: string,\n    communityId: string,\n    blockerOrgUserId: string,\n    blockedOrgUserId: string,\n  ): Promise<void>;\n  unblock(\n    orgId: string,\n    communityId: string,\n    blockerOrgUserId: string,\n    blockedOrgUserId: string,\n  ): Promise<void>;\n  isBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;\n  anyBlockedAmong(orgId: string, communityId: string, orgUserIds: string[]): Promise<boolean>;\n  insertFlag(orgId: string, flag: MessageFlag): Promise<MessageFlag | null>;\n  findFlag(orgId: string, messageId: string, orgUserId: string): Promise<MessageFlag | null>;\n  listOpenFlags(orgId: string, communityId: string, limit?: number): Promise<MessageFlag[]>;\n  messagesByIds(orgId: string, ids: string[]): Promise<Message[]>;\n  chatSummaries(orgId: string, chatIds: string[]): Promise<ChatSummary[]>;\n  resolveFlags(\n    orgId: string,\n    messageId: string,\n    resolved: { resolvedAt: Date; resolvedBy: string; resolution: MessageFlagResolution },\n  ): Promise<void>;\n  resolveOpenFlagsForChat(\n    orgId: string,\n    chatId: string,\n    resolved: { resolvedAt: Date; resolvedBy: string; resolution: MessageFlagResolution },\n  ): Promise<void>;\n}\n\nexport interface ChatWriteScope {\n  chats: ChatRepository;\n  mentions: MentionsRepository;\n  outbox: OutboxAppender;\n}\nexport type ChatUnitOfWork = UnitOfWork<ChatWriteScope>;\n\nexport type SubscriptionInput =\n  { state: 'following' } | { state: 'muted'; mutedUntil?: Date | null } | { state: 'none' };\n\nexport type MuteInput = Exclude<SubscriptionInput, { state: 'following' }>;\n\nexport interface SubscriptionService {\n  setPost(orgId: string, actor: Actor, postId: string, input: SubscriptionInput): Promise<void>;\n  setSpace(orgId: string, actor: Actor, spaceId: string, input: MuteInput): Promise<void>;\n  setChat(orgId: string, actor: Actor, chatId: string, input: MuteInput): Promise<void>;\n  viewerSubscriptions(\n    orgId: string,\n    orgUserId: string,\n    itemType: SubscriptionItemType,\n    itemIds: string[],\n    at: Date,\n  ): Promise<Record<string, SubscriptionView>>;\n  followerIds(orgId: string, postId: string): Promise<string[]>;\n  mutedAmong(orgId: string, item: SubjectRef, orgUserIds: string[], at: Date): Promise<string[]>;\n  itemSubscriptions(orgId: string, item: SubjectRef): Promise<Subscription[]>;\n}\n\nexport interface SubscriptionsRepository {\n  upsert(orgId: string, subscription: Subscription): Promise<void>;\n  remove(\n    orgId: string,\n    orgUserId: string,\n    itemType: SubscriptionItemType,\n    itemId: string,\n  ): Promise<void>;\n  forViewer(\n    orgId: string,\n    orgUserId: string,\n    itemType: SubscriptionItemType,\n    itemIds: string[],\n  ): Promise<Subscription[]>;\n  ofItem(orgId: string, itemType: SubscriptionItemType, itemId: string): Promise<Subscription[]>;\n  followerIds(orgId: string, postId: string): Promise<string[]>;\n  mutedAmong(\n    orgId: string,\n    itemType: SubscriptionItemType,\n    itemId: string,\n    orgUserIds: string[],\n    at: Date,\n  ): Promise<string[]>;\n}\n\nexport interface MentionsRepository {\n  ofItem(orgId: string, itemType: MentionItemType, itemId: string): Promise<string[]>;\n  forItems(\n    orgId: string,\n    itemType: MentionItemType,\n    itemIds: string[],\n  ): Promise<Record<string, string[]>>;\n  sync(\n    orgId: string,\n    itemType: MentionItemType,\n    itemId: string,\n    orgUserIds: string[],\n    at: Date,\n  ): Promise<string[]>;\n  removeItem(orgId: string, itemType: MentionItemType, itemId: string): Promise<void>;\n}\n"],"mappings":";AA6SA,MAAa,yBAAyB"}

package/dist/discussion/posts.d.ts

@@ -3,7 +3,7 @@ import { Logger } from "../types/ports.js";
 import { SpaceDetail } from "../types/schemas/content.js";
 import { Post, PostFlag, PostFlagResolution, PostView, ReactionEmoji } from "../types/schemas/discussion.js";
 import "../types/index.js";
-import "../shared/ports.js";
+import { Scheduler } from "../shared/ports.js";
 import { FileUrls } from "../assets/file-urls.js";
 import { AssetFiles, MemberImageReader } from "../assets/ports.js";
 import "../assets/index.js";
@@ -13,7 +13,7 @@ import "../content/index.js";
 import { CommunityAccessReader } from "../entitlements/ports.js";
 import "../entitlements/index.js";
 import "./types.js";
-import { AuthorProfileReader, AuthorRoleReader, CreatePostInput, FeedQuery, PageQuery, PostCommentReader, PostReactions, PostRepository, PostService, PostUnitOfWork, SpaceModerationQueue, UpdatePostInput } from "./ports.js";
+import { AuthorProfileReader, AuthorRoleReader, CreatePostInput, FeedQuery, MentionsRepository, PageQuery, PostCommentReader, PostReactions, PostRepository, PostService, PostUnitOfWork, PublishedPost, SpaceModerationQueue, SubscriptionsRepository, UpdatePostInput } from "./ports.js";
 //#region src/discussion/posts.d.ts
 type PostServiceParams = {
   repo: PostRepository;
@@ -22,9 +22,12 @@ type PostServiceParams = {
   authors: AuthorRoleReader;
   profiles: AuthorProfileReader;
   comments: PostCommentReader;
+  subscriptions: SubscriptionsRepository;
+  mentions: MentionsRepository;
   images: MemberImageReader & Pick<AssetFiles, 'signFile'>;
   fileUrls: FileUrls;
   uow: PostUnitOfWork;
+  scheduler: Pick<Scheduler, 'at' | 'cancel'>;
   logger?: Logger;
 };
 declare class PostServiceImpl implements PostService {
@@ -34,16 +37,24 @@ declare class PostServiceImpl implements PostService {
   private readonly authors;
   private readonly profiles;
   private readonly comments;
+  private readonly subscriptions;
+  private readonly mentions;
   private readonly images;
   private readonly fileUrls;
   private readonly uow;
+  private readonly scheduler;
   private readonly logger;
   constructor(params: PostServiceParams);
   visibleTitles(orgId: string, actor: Actor, postIds: string[]): Promise<Record<string, string>>;
+  publishedBetween(orgId: string, communityId: string, from: Date, to: Date): Promise<PublishedPost[]>;
   create(orgId: string, actor: Actor, input: CreatePostInput): Promise<PostView>;
   update(orgId: string, postId: string, actor: Actor, patch: UpdatePostInput): Promise<PostView>;
   submit(orgId: string, postId: string, actor: Actor): Promise<PostView>;
   schedule(orgId: string, postId: string, actor: Actor, scheduledAt: Date): Promise<PostView>;
+  unschedule(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  publishScheduled(orgId: string, postId: string, now: Date): Promise<void>;
+  private arm;
+  private disarm;
   approve(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;
   remove(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;
   restore(orgId: string, postId: string, actor: Actor, communityId?: string): Promise<PostView>;
@@ -53,8 +64,6 @@ declare class PostServiceImpl implements PostService {
   openComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;
   setReactions(orgId: string, postId: string, actor: Actor, enabled: boolean): Promise<PostView>;
   setReaction(orgId: string, postId: string, actor: Actor, emoji: ReactionEmoji | null): Promise<PostReactions>;
-  follow(orgId: string, postId: string, actor: Actor): Promise<void>;
-  unfollow(orgId: string, postId: string, actor: Actor): Promise<void>;
   bookmark(orgId: string, postId: string, actor: Actor): Promise<void>;
   unbookmark(orgId: string, postId: string, actor: Actor): Promise<void>;
   flag(orgId: string, postId: string, actor: Actor, reason: string): Promise<PostFlag>;
@@ -72,10 +81,6 @@ declare class PostServiceImpl implements PostService {
     space: SpaceDetail;
   }>;
   find(orgId: string, postId: string): Promise<Post | null>;
-  followerIds(orgId: string, postId: string): Promise<string[]>;
-  hasDue(orgId: string, now: Date): Promise<boolean>;
-  publishDue(orgId: string, now: Date): Promise<void>;
-  private submitDue;
   private submittable;
   private feedPage;
   private viewOf;
@@ -96,6 +101,11 @@ declare class PostServiceImpl implements PostService {
   private topicFits;
   private assertTopic;
   private patchChanges;
+  private mentionable;
+  private openersOf;
+  private landed;
+  private published;
+  private updated;
   private meta;
 }
 //#endregion