@headless-lms/core 0.4.0 → 0.5.0

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  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"}
+{"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  ChatLiveEvent,\n  ChatUnreadSummary,\n  ChatUser,\n  DigestRun,\n  FlaggedComment,\n  FlaggedCommentView,\n  JsonValue,\n  LiveMessage,\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, DmSettings, SpaceDetail } from '../content/index.js';\nimport type { OutboxAppender, UnitOfWork } from '../shared/ports.js';\nimport type { Actor, EffectivePermissions } from '../shared/actor.js';\nimport type { Comment, CommentAuthor, 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  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 moderation list. */\nexport interface AuthorRecord {\n  id: string;\n  firstName: string | null;\n  lastName: string | null;\n  email: string;\n  image: string | null;\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(refs: SubjectRef[], actor: Actor): Promise<Record<string, ItemTitle>>;\n}\n\nexport interface AuthorProfileReader {\n  authorsOf(orgId: string, orgUserIds: string[]): Promise<Record<string, AuthorRecord>>;\n}\n\n/** Where a comment must be for a moderation call: in one community, on a\n *  lesson, or anywhere the actor can reach. */\nexport type CommentWithin = { communityId: string } | 'lesson' | 'any';\n\nexport interface DiscussionService {\n  /** Post a root comment or a reply. Lands pending where review is required and\n   *  the poster does not skip review. */\n  postComment(input: PostCommentInput, actor: Actor): Promise<CommentView>;\n  /** Reply to a lesson comment as a moderator of its course; a reply to a reply\n   *  attaches to its root. */\n  replyToComment(commentId: string, body: string, actor: Actor): Promise<CommentView>;\n  /** Author-only. Throws ForbiddenError for anyone else, moderators included. */\n  edit(commentId: string, body: string, actor: Actor): Promise<CommentView>;\n  /** The author, or a moderator of where the comment is. */\n  remove(commentId: string, within: CommentWithin, actor: Actor): Promise<CommentView>;\n  /** A moderator of where the comment is. Returns the comment to published. */\n  restore(commentId: string, within: CommentWithin, actor: Actor): Promise<CommentView>;\n  /** A moderator of where the comment is. Publishes a pending comment. */\n  approve(commentId: string, actor: Actor): Promise<Comment>;\n  /** Make a comment published, whichever state it is in. A moderator of where\n   *  the comment is. */\n  publish(commentId: string, within: CommentWithin, actor: Actor): Promise<Comment>;\n\n  /** The activity's comments as this reader may see them. */\n  activityComments(activityId: string, actor: Actor): Promise<ActivityComments>;\n\n  /** One page of top-level comments, oldest first, each with its replies. */\n  postComments(postId: string, query: PageQuery, actor: Actor): Promise<Page<CommentView>>;\n\n  /** The lesson comments of the courses the actor moderates, filtered. Rows\n   *  carry the author's email and a removed comment's body. */\n  listComments(query: ListCommentsQuery, actor: Actor): Promise<Page<CommentListItem>>;\n\n  setReaction(\n    commentId: string,\n    emoji: ReactionEmoji | null,\n    actor: Actor,\n  ): Promise<CommentReactions>;\n\n  resolveReports(commentId: string, within: CommentWithin, actor: Actor): Promise<void>;\n\n  /** Accepted even on locked comments — a locked activity can still hold\n   *  something a moderator needs to see. */\n  reportComment(commentId: string, reason: string, actor: Actor): 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(activityId: string, actor: Actor): Promise<Activity | null>;\n}\n\nexport interface SpaceReader {\n  getSpace(spaceId: string, actor: Actor): Promise<SpaceDetail | null>;\n  getDmSettings(communityId: string, actor: Actor): Promise<DmSettings | null>;\n}\n\nexport interface OpenableSpace {\n  id: string;\n  communityId: string;\n  accessRule: SpaceDetail['accessRule'];\n}\n\nexport interface CommunityAccess {\n  isCommunityMember(communityId: string, actor: Actor): Promise<boolean>;\n  canOpenSpace(spaceId: string, actor: Actor): Promise<boolean>;\n  canOpen(space: OpenableSpace, actor: Actor): Promise<boolean>;\n  openSpaceIds(communityId: string, actor: Actor): Promise<string[]>;\n  communityMembersAmong(\n    orgId: string,\n    communityId: string,\n    orgUserIds: string[],\n  ): Promise<string[]>;\n  spaceOpenersAmong(orgId: string, spaceId: string, orgUserIds: string[]): Promise<string[]>;\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  /** `courseIds` limits the rows to those courses; undefined means every course. */\n  listComments(\n    orgId: string,\n    query: ListCommentsQuery,\n    courseIds?: string[],\n  ): 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 AuthorPermissionReader {\n  permissionsOfMany(\n    orgId: string,\n    orgUserIds: string[],\n  ): Promise<Map<string, EffectivePermissions>>;\n  actorFor(orgId: string, orgUserId: string): Promise<Actor | null>;\n  systemActor(orgId: string): Actor;\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: FlaggedCommentView[];\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(postIds: string[], actor: Actor): Promise<Record<string, string>>;\n  publishedBetween(\n    orgId: string,\n    communityId: string,\n    from: Date,\n    to: Date,\n  ): Promise<PublishedPost[]>;\n  create(input: CreatePostInput, actor: Actor): Promise<PostView>;\n  update(postId: string, patch: UpdatePostInput, actor: Actor): Promise<PostView>;\n  submit(postId: string, actor: Actor): Promise<PostView>;\n  schedule(postId: string, scheduledAt: Date, actor: Actor): Promise<PostView>;\n  unschedule(postId: string, actor: Actor): Promise<PostView>;\n  publishScheduled(orgId: string, postId: string, now: Date): Promise<void>;\n  approve(postId: string, communityId: string | null, actor: Actor): Promise<PostView>;\n  remove(postId: string, communityId: string | null, actor: Actor): Promise<PostView>;\n  restore(postId: string, communityId: string | null, actor: Actor): Promise<PostView>;\n  pin(postId: string, actor: Actor): Promise<PostView>;\n  unpin(postId: string, actor: Actor): Promise<PostView>;\n  closeComments(postId: string, actor: Actor): Promise<PostView>;\n  openComments(postId: string, actor: Actor): Promise<PostView>;\n  setReactions(postId: string, enabled: boolean, actor: Actor): Promise<PostView>;\n  setReaction(postId: string, emoji: ReactionEmoji | null, actor: Actor): Promise<PostReactions>;\n  bookmark(postId: string, actor: Actor): Promise<void>;\n  unbookmark(postId: string, actor: Actor): Promise<void>;\n  flag(postId: string, reason: string, actor: Actor): Promise<PostFlag>;\n  resolveFlags(\n    postId: string,\n    resolution: Extract<PostFlagResolution, 'dismissed'>,\n    communityId: string | null,\n    actor: Actor,\n  ): Promise<void>;\n  spaceFeed(\n    communityId: string,\n    spaceId: string,\n    query: FeedQuery,\n    actor: Actor,\n  ): Promise<Page<PostView>>;\n  memberFeed(\n    communityId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n    actor: Actor,\n  ): Promise<Page<PostView>>;\n  listOwn(communityId: string, query: PageQuery, actor: Actor): Promise<Page<PostView>>;\n  listBookmarked(communityId: string, query: PageQuery, actor: Actor): Promise<Page<PostView>>;\n  /** Signed URL of the post's cover, for whoever can read the post. */\n  coverFile(postId: string, actor: Actor): Promise<string>;\n  assetFile(postId: string, assetId: string, actor: Actor): Promise<string>;\n  getPost(postId: string, actor: Actor): Promise<PostView>;\n  visible(postId: string, actor: Actor): Promise<{ post: Post; space: SpaceDetail }>;\n  find(orgId: string, postId: string): Promise<Post | null>;\n  moderationQueue(\n    communityId: string,\n    spaceId: string,\n    actor: Actor,\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  clientId?: string;\n}\n\nexport interface ChatListItem {\n  chat: Chat;\n  participantIds: string[];\n  participants: CommentAuthor[];\n  lastReadMessageId: string | null;\n  subscription: SubscriptionView | null;\n  unread: number;\n  lastMessage: ChatLastMessage | null;\n}\n\nexport type ChatInboxRow = Omit<ChatListItem, 'subscription' | 'participants'>;\n\n/** `requests`: true for only the pending requests to the member, false for\n *  everything else, omitted for every chat. */\nexport interface ChatListQuery extends PageQuery {\n  requests?: boolean;\n}\n\nexport interface ReactionChange {\n  inserted: boolean;\n  changed: boolean;\n}\n\nexport interface ChatMemberState {\n  chatId: string;\n  unread: number;\n  lastReadMessageId: string | null;\n  subscription: SubscriptionView | null;\n}\n\n/** A member's state in each chat they are in in one community, with their\n *  unread total there. */\nexport interface ChatMemberStates {\n  orgUserId: string;\n  unread: ChatUnreadSummary;\n  chats: ChatMemberState[];\n}\n\nexport interface LiveChat {\n  chat: Chat;\n  participantIds: string[];\n  participants: CommentAuthor[];\n}\n\n/** What the chat hub reads for each change, as current state. */\nexport interface ChatLiveReads {\n  activeParticipants(orgId: string, chatId: string): Promise<string[]>;\n  messageViews(orgId: string, messageIds: string[]): Promise<LiveMessage[]>;\n  messageReactions(orgId: string, messageId: string): Promise<ReactionCounts>;\n  /** The chat with its active participants and their profiles. */\n  liveChat(orgId: string, chatId: string): Promise<LiveChat | null>;\n  memberStates(\n    orgId: string,\n    communityId: string,\n    orgUserIds: string[],\n  ): Promise<ChatMemberStates[]>;\n}\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 extends ChatLiveReads {\n  startDirect(input: StartDirectInput, actor: Actor): Promise<Chat>;\n  startGroup(input: StartGroupInput, actor: Actor): Promise<Chat>;\n  addParticipant(chatId: string, orgUserId: string, actor: Actor): Promise<Chat>;\n  leave(chatId: string, actor: Actor): Promise<Chat>;\n  accept(chatId: string, actor: Actor): Promise<Chat>;\n  send(chatId: string, input: SendMessageInput, actor: Actor): Promise<MessageView>;\n  editMessage(messageId: string, body: string, actor: Actor): Promise<MessageView>;\n  deleteMessage(messageId: string, actor: Actor): Promise<MessageView>;\n  setReaction(\n    messageId: string,\n    emoji: ReactionEmoji | null,\n    actor: Actor,\n  ): Promise<MessageReactions>;\n  markRead(chatId: string, messageId: string, actor: Actor): Promise<void>;\n  block(communityId: string, orgUserId: string, actor: Actor): Promise<void>;\n  unblock(communityId: string, orgUserId: string, actor: Actor): Promise<void>;\n  flagMessage(messageId: string, reason: string, actor: Actor): Promise<MessageFlag>;\n  resolveMessageFlags(\n    messageId: string,\n    resolution: Extract<MessageFlagResolution, 'dismissed'>,\n    communityId: string | null,\n    actor: Actor,\n  ): Promise<void>;\n  lock(chatId: string, communityId: string | null, actor: Actor): Promise<Chat>;\n  unlock(chatId: string, communityId: string | null, actor: Actor): Promise<Chat>;\n  listChats(communityId: string, query: ChatListQuery, actor: Actor): Promise<Page<ChatListItem>>;\n  /** One live stream of the member's chat events in the community. */\n  watch(communityId: string, actor: Actor): Promise<AsyncIterable<ChatLiveEvent>>;\n  chat(chatId: string, actor: Actor): Promise<ChatListItem>;\n  directChat(communityId: string, orgUserId: string, actor: Actor): Promise<ChatListItem>;\n  unreadSummary(communityId: string, actor: Actor): Promise<ChatUnreadSummary>;\n  typing(chatId: string, actor: Actor): Promise<void>;\n  /** The messages as every participant sees them: a deleted message without\n   *  its body, attachments or mentions, and no viewer reaction. */\n  messageViews(orgId: string, messageIds: string[]): Promise<LiveMessage[]>;\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(chatIds: string[], actor: Actor): Promise<Record<string, string>>;\n  messages(\n    chatId: string,\n    query: Pick<FeedQuery, 'page' | 'pageSize'>,\n    actor: Actor,\n  ): Promise<Page<MessageView>>;\n  /** Signed URL of a message attachment: for the chat's participants while the\n   *  message stands (moderators also after deletion), and for moderators while\n   *  it is flagged. */\n  attachmentFile(chatId: string, messageId: string, assetId: string, actor: Actor): Promise<string>;\n  messageQueue(communityId: string, actor: Actor): 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: ChatListQuery,\n  ): Promise<Page<ChatInboxRow>>;\n  /** The member's inbox row for one chat they are in, or null. */\n  inboxRow(orgId: string, chatId: string, orgUserId: string): Promise<ChatInboxRow | null>;\n  participants(orgId: string, chatId: string): Promise<ChatUser[]>;\n  activeParticipants(orgId: string, chatId: string): Promise<string[]>;\n  join(orgId: string, user: ChatUser): Promise<void>;\n  markLeft(orgId: string, chatId: string, orgUserId: string, leftAt: Date): Promise<void>;\n  /** Moves the read mark to the message only when it is newer (by created\n   *  time, then id) than the current one. True when it moved. */\n  setRead(orgId: string, chatId: string, orgUserId: string, messageId: string): Promise<boolean>;\n  unreadFor(orgId: string, chatId: string, orgUserId: string): Promise<ChatUnread>;\n  /** Unread messages across the member's chats in the community that are\n   *  neither muted at `at` nor pending requests to them, plus those requests. */\n  unreadSummary(\n    orgId: string,\n    communityId: string,\n    orgUserId: string,\n    at: Date,\n  ): Promise<ChatUnreadSummary>;\n  memberStates(\n    orgId: string,\n    communityId: string,\n    orgUserIds: string[],\n    at: Date,\n  ): Promise<ChatMemberStates[]>;\n  findByClientId(\n    orgId: string,\n    chatId: string,\n    orgUserId: string,\n    clientId: string,\n  ): Promise<Message | null>;\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<ReactionChange>;\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 SubscriptionWriteScope {\n  subscriptions: SubscriptionsRepository;\n  outbox: OutboxAppender;\n}\nexport type SubscriptionUnitOfWork = UnitOfWork<SubscriptionWriteScope>;\n\nexport interface SubscriptionService {\n  setPost(postId: string, input: SubscriptionInput, actor: Actor): Promise<void>;\n  setSpace(spaceId: string, input: MuteInput, actor: Actor): Promise<void>;\n  setChat(chatId: string, input: MuteInput, actor: Actor): 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":";AAuTA,MAAa,yBAAyB"}

package/dist/discussion/posts.d.ts

@@ -3,29 +3,27 @@ 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 { Actor } from "../shared/actor.js";
+import { BodyParser, Scheduler } from "../shared/ports.js";
 import { FileUrls } from "../assets/file-urls.js";
-import { AssetFiles, MemberImageReader } from "../assets/ports.js";
+import { AssetFiles, MemberImageReader, MemberUploadReader } 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";
+import { AuthorPermissionReader, AuthorProfileReader, CommunityAccess, CreatePostInput, FeedQuery, MentionsRepository, PageQuery, PostCommentReader, PostReactions, PostRepository, PostService, PostUnitOfWork, PublishedPost, SpaceModerationQueue, SpaceReader, SubscriptionsRepository, UpdatePostInput } from "./ports.js";
 //#region src/discussion/posts.d.ts
 type PostServiceParams = {
   repo: PostRepository;
-  access: CommunityAccessReader;
-  content: CommunityReader;
-  authors: AuthorRoleReader;
+  access: CommunityAccess;
+  content: Pick<SpaceReader, 'getSpace'>;
+  authors: AuthorPermissionReader;
   profiles: AuthorProfileReader;
   comments: PostCommentReader;
   subscriptions: SubscriptionsRepository;
   mentions: MentionsRepository;
-  images: MemberImageReader & Pick<AssetFiles, 'signFile'>;
+  images: MemberImageReader & MemberUploadReader & Pick<AssetFiles, 'signFile' | 'syncPublicImage'>;
   fileUrls: FileUrls;
+  bodies: BodyParser;
   uow: PostUnitOfWork;
   scheduler: Pick<Scheduler, 'at' | 'cancel'>;
   logger?: Logger;
@@ -41,42 +39,47 @@ declare class PostServiceImpl implements PostService {
   private readonly mentions;
   private readonly images;
   private readonly fileUrls;
+  private readonly bodies;
   private readonly uow;
   private readonly scheduler;
   private readonly logger;
   constructor(params: PostServiceParams);
-  visibleTitles(orgId: string, actor: Actor, postIds: string[]): Promise<Record<string, string>>;
+  visibleTitles(postIds: string[], actor: Actor): 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>;
+  create(input: CreatePostInput, actor: Actor): Promise<PostView>;
+  update(postId: string, patch: UpdatePostInput, actor: Actor): Promise<PostView>;
+  submit(postId: string, actor: Actor): Promise<PostView>;
+  schedule(postId: string, scheduledAt: Date, actor: Actor): Promise<PostView>;
+  unschedule(postId: string, actor: Actor): Promise<PostView>;
   publishScheduled(orgId: string, postId: string, now: Date): Promise<void>;
   private arm;
+  private syncCover;
   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>>;
+  approve(postId: string, communityId: string | null, actor: Actor): Promise<PostView>;
+  remove(postId: string, communityId: string | null, actor: Actor): Promise<PostView>;
+  restore(postId: string, communityId: string | null, actor: Actor): Promise<PostView>;
+  pin(postId: string, actor: Actor): Promise<PostView>;
+  unpin(postId: string, actor: Actor): Promise<PostView>;
+  closeComments(postId: string, actor: Actor): Promise<PostView>;
+  openComments(postId: string, actor: Actor): Promise<PostView>;
+  setReactions(postId: string, enabled: boolean, actor: Actor): Promise<PostView>;
+  setReaction(postId: string, emoji: ReactionEmoji | null, actor: Actor): Promise<PostReactions>;
+  bookmark(postId: string, actor: Actor): Promise<void>;
+  unbookmark(postId: string, actor: Actor): Promise<void>;
+  flag(postId: string, reason: string, actor: Actor): Promise<PostFlag>;
+  resolveFlags(postId: string, resolution: Extract<PostFlagResolution, 'dismissed'>, communityId: string | null, actor: Actor): Promise<void>;
+  spaceFeed(communityId: string, spaceId: string, query: FeedQuery, actor: Actor): Promise<Page<PostView>>;
+  memberFeed(communityId: string, query: Pick<FeedQuery, 'page' | 'pageSize'>, actor: Actor): 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<{
+  listOwn(communityId: string, query: PageQuery, actor: Actor): Promise<Page<PostView>>;
+  listBookmarked(communityId: string, query: PageQuery, actor: Actor): Promise<Page<PostView>>;
+  coverFile(postId: string, actor: Actor): Promise<string>;
+  assetFile(postId: string, assetId: string, actor: Actor): Promise<string>;
+  private signShown;
+  getPost(postId: string, actor: Actor): Promise<PostView>;
+  moderationQueue(communityId: string, spaceId: string, actor: Actor): Promise<SpaceModerationQueue>;
+  private flaggedCommentViews;
+  visible(postId: string, actor: Actor): Promise<{
     post: Post;
     space: SpaceDetail;
   }>;
@@ -91,18 +94,21 @@ declare class PostServiceImpl implements PostService {
   private initial;
   private submissionOf;
   private requireOwnedImage;
+  private requireBodyAssets;
   private openSpace;
   private requireOpen;
   private loadVisible;
   private canSee;
   private visibleStatuses;
-  private canModerate;
+  private moderates;
+  private requireModerator;
   private assertAuthor;
   private topicFits;
   private assertTopic;
   private patchChanges;
   private mentionable;
   private openersOf;
+  private mentionedOpeners;
   private landed;
   private published;
   private updated;