@headless-lms/core 0.2.0 → 0.4.0

package/dist/discussion/ports.d.ts

@@ -1,10 +1,15 @@
-import { Page } from "../types/shared.js";
-import { Activity } from "../types/schemas/content.js";
+import { JsonValue, Page } from "../types/shared.js";
+import { Activity, SpaceDetail } from "../types/schemas/content.js";
 import { Role } from "../types/schemas/organizations.js";
-import { CommentListItem, CommentView, CommentsConfig, ListCommentsQuery, ReactionCounts, ReactionEmoji } from "../types/schemas/discussion.js";
-import { Comment, CommentAuthor, CommentReport } from "../types/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";
 import "./types.js";
 //#region src/discussion/ports.d.ts
@@ -23,27 +28,40 @@ interface CommentWithContext {
   courseId: string;
   activityTitle: string;
 }
-/**
- * Who is acting, and the role they hold in this org right now.
- *
- * The role is resolved at the HTTP edge from the session's active-org
- * org user and handed in — read fresh on every request, never stored on a
- * comment. Core does not look a role up to authorise.
- */
-interface Actor {
-  id: string;
-  role: Role;
-}
 type PostCommentInput = {
   actor: Actor;
-  activityId: string;
   parentId: string | null;
   body: string;
-};
+} & ({
+  activityId: string;
+  postId?: undefined;
+} | {
+  postId: string;
+  activityId?: undefined;
+});
 /** A profile row as the repository loads it, keyed by `org_users.id`. `email`
  *  is stripped before comments are served and kept only for the staff list. */
-interface AuthorRecord extends CommentAuthor {
+interface AuthorRecord {
+  id: string;
+  firstName: string | null;
+  lastName: string | null;
   email: string;
+  image: string | null;
+  role: Role;
+  displayName: string | null;
+  headline: string | null;
+  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>>;
 }
 interface DiscussionService {
   /** Post a root comment or a reply. Lands pending where review is required and
@@ -52,15 +70,17 @@ interface DiscussionService {
   /** Author-only. Throws ForbiddenError for anyone else, staff included. */
   edit(orgId: string, commentId: string, actor: Actor, body: string): Promise<CommentView>;
   /** The author, or anyone whose role is staff. */
-  remove(orgId: string, commentId: string, actor: Actor): Promise<Comment>;
+  remove(orgId: string, commentId: string, actor: Actor, communityId?: string): Promise<CommentView>;
   /** Staff only. Returns the comment to published. */
-  restore(orgId: string, commentId: string, actor: Actor): Promise<Comment>;
+  restore(orgId: string, commentId: string, actor: Actor, communityId?: string): Promise<CommentView>;
   /** Staff only. Publishes a pending comment. */
   approve(orgId: string, commentId: string, actor: Actor): Promise<Comment>;
   /** Make a comment published, whichever state it is in. Staff only. */
   publish(orgId: string, commentId: string, actor: Actor): Promise<Comment>;
   /** The activity's comments as this reader may see them. */
   activityComments(orgId: string, activityId: string, actor: Actor): Promise<ActivityComments>;
+  /** One page of top-level comments, oldest first, each with its replies. */
+  postComments(orgId: string, postId: string, actor: Actor, query: PageQuery): Promise<Page<CommentView>>;
   /**
    * The org's comments, filtered. Staff-scoped: rows carry the author's email
    * and a removed comment's body, neither of which a learner may see, so the
@@ -71,42 +91,366 @@ interface DiscussionService {
    */
   listComments(orgId: string, query: ListCommentsQuery): Promise<Page<CommentListItem>>;
   setReaction(orgId: string, commentId: string, actor: Actor, emoji: ReactionEmoji | null): Promise<CommentReactions>;
-  resolveReports(orgId: string, commentId: string, actor: Actor): Promise<void>;
+  resolveReports(orgId: string, commentId: string, actor: Actor, communityId?: string): Promise<void>;
   /** Accepted even on locked comments — a locked activity can still hold
    *  something a moderator needs to see. */
   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>;
+  commenterIds(orgId: string, target: {
+    postId: string;
+  } | {
+    activityId: string;
+  }): Promise<string[]>;
 }
-interface CourseAccessReader {
-  hasCourseAccess(orgId: string, orgUserId: string, courseId: string): Promise<boolean>;
+interface ContentAccessReader {
+  hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;
 }
 interface ActivityGetter {
   getActivity(orgId: string, activityId: string): Promise<Activity | null>;
 }
-interface DiscussionRepository {
+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. */
   listOpenReports(orgId: string, commentIds: string[]): Promise<CommentReport[]>;
-  resolveReportsFor(orgId: string, commentId: string, resolvedAt: Date): Promise<void>;
-  authorsOf(orgId: string, orgUserIds: string[]): Promise<Record<string, AuthorRecord>>;
+  resolveReportsFor(orgId: string, commentId: string, resolved: {
+    resolvedAt: Date;
+    resolvedBy: string;
+    resolution: 'dismissed' | 'removed';
+  }): Promise<void>;
   listComments(orgId: string, query: ListCommentsQuery): Promise<Page<CommentWithContext>>;
 }
 /** Writes that emit events run through this scope so the row and the outbox
  *  entry commit in one transaction. */
 interface DiscussionWriteScope {
   discussion: DiscussionRepository;
+  mentions: MentionsRepository;
   outbox: OutboxAppender;
 }
 type DiscussionUnitOfWork = UnitOfWork<DiscussionWriteScope>;
+interface AuthorRoleReader {
+  roleOf(orgId: string, orgUserId: string): Promise<Role | null>;
+  rolesOf(orgId: string, orgUserIds: string[]): Promise<Record<string, Role>>;
+}
+type PostMode = 'draft' | 'submit' | 'schedule';
+interface CreatePostInput {
+  communityId: string;
+  spaceId: string;
+  title: string;
+  body: string;
+  topicId: string | null;
+  extra: JsonValue;
+  coverAssetId: string | null;
+  mode: PostMode;
+  scheduledAt: Date | null;
+}
+interface UpdatePostInput {
+  title?: string;
+  body?: string;
+  topicId?: string | null;
+  extra?: JsonValue;
+  coverAssetId?: string | null;
+}
+type PostPatch = Partial<Pick<Post, 'title' | 'body' | 'topicId' | 'extra' | 'coverAssetId' | 'status' | 'scheduledAt' | 'publishedAt' | 'removedBy' | 'pinned' | 'commentsClosed' | 'reactionsEnabled'>>;
+interface FeedQuery {
+  page: number;
+  pageSize: number;
+  topicId?: string;
+}
+interface PostReactions {
+  reactions: ReactionCounts;
+  viewerReaction?: ReactionEmoji;
+}
+type PageQuery = Pick<FeedQuery, 'page' | 'pageSize'>;
+interface PostThreadsQuery extends PageQuery {
+  viewerId: string;
+  seesHeld: boolean;
+}
+interface BookmarkQuery extends PageQuery {
+  visibleStatuses: PostStatus[];
+}
+declare const MODERATION_QUEUE_LIMIT = 100;
+interface SpaceModerationQueue {
+  pending: PostView[];
+  flags: PostFlag[];
+  commentFlags: FlaggedComment[];
+}
+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>;
+  pin(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  unpin(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  closeComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  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>;
+  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>;
+  resolveFlags(orgId: string, postId: string, actor: Actor, resolution: Extract<PostFlagResolution, 'dismissed'>, communityId?: string): Promise<void>;
+  spaceFeed(orgId: string, actor: Actor, communityId: string, spaceId: string, query: FeedQuery): Promise<Page<PostView>>;
+  memberFeed(orgId: string, actor: Actor, communityId: string, query: Pick<FeedQuery, 'page' | 'pageSize'>): Promise<Page<PostView>>;
+  listOwn(orgId: string, actor: Actor, communityId: string, query: PageQuery): Promise<Page<PostView>>;
+  listBookmarked(orgId: string, actor: Actor, communityId: string, query: PageQuery): Promise<Page<PostView>>;
+  /** Signed URL of the post's cover, for whoever can read the post. */
+  coverFile(orgId: string, actor: Actor, postId: string): Promise<string | null>;
+  getPost(orgId: string, actor: Actor, postId: string): Promise<PostView>;
+  visible(orgId: string, actor: Actor, postId: string): Promise<{
+    post: Post;
+    space: SpaceDetail;
+  }>;
+  find(orgId: string, postId: string): Promise<Post | null>;
+  moderationQueue(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceModerationQueue>;
+}
+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[]>;
+  reactionsOf(orgId: string, postIds: string[], viewerId: string): Promise<Record<string, PostReactions>>;
+  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[]>;
+  insertFlag(orgId: string, flag: PostFlag): Promise<PostFlag | null>;
+  findFlag(orgId: string, postId: string, orgUserId: string): Promise<PostFlag | null>;
+  listOpenFlags(orgId: string, spaceId: string, limit: number): Promise<PostFlag[]>;
+  resolveFlags(orgId: string, postId: string, resolved: {
+    resolvedAt: Date;
+    resolvedBy: string;
+    resolution: PostFlagResolution;
+  }): Promise<void>;
+}
+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;
+  body: string | null;
+  assetIds: string[];
+}
+interface StartGroupInput {
+  communityId: string;
+  orgUserIds: string[];
+}
+interface SendMessageInput {
+  body: string;
+  replyToId: string | null;
+  assetIds: string[];
+}
+interface ChatListItem {
+  chat: Chat;
+  participantIds: string[];
+  lastReadMessageId: string | 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;
+}
+interface ChatSummary {
+  chat: Chat;
+  participantIds: string[];
+}
+interface MessageQueueEntry {
+  message: MessageView;
+  flags: MessageFlag[];
+  chat: Chat;
+  participantIds: string[];
+}
+interface MessageQueue {
+  entries: MessageQueueEntry[];
+}
+interface ChatService {
+  startDirect(orgId: string, actor: Actor, input: StartDirectInput): Promise<Chat>;
+  startGroup(orgId: string, actor: Actor, input: StartGroupInput): Promise<Chat>;
+  addParticipant(orgId: string, actor: Actor, chatId: string, orgUserId: string): Promise<Chat>;
+  leave(orgId: string, actor: Actor, chatId: string): Promise<Chat>;
+  accept(orgId: string, actor: Actor, chatId: string): Promise<Chat>;
+  send(orgId: string, actor: Actor, chatId: string, input: SendMessageInput): Promise<MessageView>;
+  editMessage(orgId: string, actor: Actor, messageId: string, body: string): Promise<MessageView>;
+  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>;
+  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>;
+  resolveMessageFlags(orgId: string, actor: Actor, messageId: string, resolution: Extract<MessageFlagResolution, 'dismissed'>, communityId?: string): Promise<void>;
+  lock(orgId: string, actor: Actor, chatId: string, communityId?: string): Promise<Chat>;
+  unlock(orgId: string, actor: Actor, chatId: string, communityId?: string): Promise<Chat>;
+  listChats(orgId: string, actor: Actor, communityId: string, query: PageQuery): Promise<Page<ChatListItem>>;
+  chatSummary(orgId: string, chatId: string): Promise<{
+    chat: Chat;
+    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>>;
+  /** Signed URL of a message attachment: for the chat's participants while the
+   *  message stands (staff also after deletion), and for staff while it is flagged. */
+  attachmentFile(orgId: string, actor: Actor, chatId: string, messageId: string, assetId: string): Promise<string | null>;
+  messageQueue(orgId: string, actor: Actor, communityId: string): Promise<MessageQueue>;
+}
+interface ChatRepository {
+  lockDirectPair(orgId: string, communityId: string, orgUserId: string, otherOrgUserId: string): Promise<void>;
+  findDirect(orgId: string, communityId: string, orgUserId: string, otherOrgUserId: string): Promise<Chat | null>;
+  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<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>;
+  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>;
+  listMessages(orgId: string, chatId: string, query: Pick<FeedQuery, 'page' | 'pageSize'>): Promise<Page<Message>>;
+  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<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>;
+  isBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;
+  anyBlockedAmong(orgId: string, communityId: string, orgUserIds: string[]): Promise<boolean>;
+  insertFlag(orgId: string, flag: MessageFlag): Promise<MessageFlag | null>;
+  findFlag(orgId: string, messageId: string, orgUserId: string): Promise<MessageFlag | null>;
+  listOpenFlags(orgId: string, communityId: string, limit?: number): Promise<MessageFlag[]>;
+  messagesByIds(orgId: string, ids: string[]): Promise<Message[]>;
+  chatSummaries(orgId: string, chatIds: string[]): Promise<ChatSummary[]>;
+  resolveFlags(orgId: string, messageId: string, resolved: {
+    resolvedAt: Date;
+    resolvedBy: string;
+    resolution: MessageFlagResolution;
+  }): Promise<void>;
+  resolveOpenFlagsForChat(orgId: string, chatId: string, resolved: {
+    resolvedAt: Date;
+    resolvedBy: string;
+    resolution: MessageFlagResolution;
+  }): Promise<void>;
+}
+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, Actor, AuthorRecord, CommentReactions, CommentWithContext, CourseAccessReader, DiscussionRepository, DiscussionService, DiscussionUnitOfWork, DiscussionWriteScope, PostCommentInput };
+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

@@ -1 +1,6 @@
-export {};
+//#region src/discussion/ports.ts
+const MODERATION_QUEUE_LIMIT = 100;
+//#endregion
+export { MODERATION_QUEUE_LIMIT };
+
+//# sourceMappingURL=ports.js.map

package/dist/discussion/ports.js.map

@@ -0,0 +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  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

@@ -0,0 +1,113 @@
+import { Page } from "../types/shared.js";
+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 { Scheduler } from "../shared/ports.js";
+import { FileUrls } from "../assets/file-urls.js";
+import { AssetFiles, MemberImageReader } from "../assets/ports.js";
+import "../assets/index.js";
+import { Actor } from "../shared/actor.js";
+import { CommunityReader } from "../content/ports.js";
+import "../content/index.js";
+import { CommunityAccessReader } from "../entitlements/ports.js";
+import "../entitlements/index.js";
+import "./types.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;
+  access: CommunityAccessReader;
+  content: CommunityReader;
+  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 {
+  private readonly repo;
+  private readonly access;
+  private readonly content;
+  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>;
+  pin(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  unpin(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  closeComments(orgId: string, postId: string, actor: Actor): Promise<PostView>;
+  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>;
+  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>;
+  resolveFlags(orgId: string, postId: string, actor: Actor, resolution: Extract<PostFlagResolution, 'dismissed'>, communityId?: string): Promise<void>;
+  spaceFeed(orgId: string, actor: Actor, communityId: string, spaceId: string, query: FeedQuery): Promise<Page<PostView>>;
+  memberFeed(orgId: string, actor: Actor, communityId: string, query: Pick<FeedQuery, 'page' | 'pageSize'>): Promise<Page<PostView>>;
+  private openSpaceIdsIn;
+  listOwn(orgId: string, actor: Actor, communityId: string, query: PageQuery): Promise<Page<PostView>>;
+  listBookmarked(orgId: string, actor: Actor, communityId: string, query: PageQuery): Promise<Page<PostView>>;
+  coverFile(orgId: string, actor: Actor, postId: string): Promise<string | null>;
+  getPost(orgId: string, actor: Actor, postId: string): Promise<PostView>;
+  moderationQueue(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceModerationQueue>;
+  visible(orgId: string, actor: Actor, postId: string): Promise<{
+    post: Post;
+    space: SpaceDetail;
+  }>;
+  find(orgId: string, postId: string): Promise<Post | null>;
+  private submittable;
+  private feedPage;
+  private viewOf;
+  private viewsOf;
+  private commitSubmission;
+  private moderate;
+  private mustUpdate;
+  private initial;
+  private submissionOf;
+  private requireOwnedImage;
+  private openSpace;
+  private requireOpen;
+  private loadVisible;
+  private canSee;
+  private visibleStatuses;
+  private canModerate;
+  private assertAuthor;
+  private topicFits;
+  private assertTopic;
+  private patchChanges;
+  private mentionable;
+  private openersOf;
+  private landed;
+  private published;
+  private updated;
+  private meta;
+}
+//#endregion
+export { PostServiceImpl, PostServiceParams };
+//# sourceMappingURL=posts.d.ts.map