@headless-lms/core 0.1.0 → 0.3.0

package/dist/discussion/events.js

@@ -1,26 +1,155 @@
-import { commentReportSchema, commentSchema } from "../types/schemas/discussion.js";
+import { idSchema } from "../types/schemas/shared.js";
+import { chatSchema, commentReportSchema, commentSchema, messageFlagSchema, messageSchema, postFlagSchema, postSchema } from "../types/schemas/discussion.js";
 import { defineEvent } from "../shared/events.js";
+import { z } from "zod";
 //#region src/discussion/events.ts
+const publicComment = commentSchema.pick({
+	id: true,
+	orgId: true,
+	activityId: true,
+	postId: true,
+	communityId: true,
+	parentId: true,
+	orgUserId: true,
+	body: true,
+	status: true,
+	removedBy: true,
+	createdAt: true,
+	updatedAt: true
+}).strip();
+const reportedComment = commentReportSchema.extend({ communityId: idSchema.nullable() });
+const publicCommentReport = reportedComment.pick({
+	id: true,
+	orgId: true,
+	communityId: true,
+	commentId: true,
+	orgUserId: true,
+	reason: true,
+	resolvedAt: true,
+	createdAt: true,
+	updatedAt: true
+}).strip();
+const reportedPost = postFlagSchema.extend({ communityId: idSchema });
+const chatEventSchema = chatSchema.extend({ participantIds: z.array(idSchema) });
+const publicChat = chatEventSchema.pick({
+	id: true,
+	orgId: true,
+	communityId: true,
+	kind: true,
+	status: true,
+	createdBy: true,
+	participantIds: true
+}).strip();
+const participantAddedSchema = z.object({
+	chatId: idSchema,
+	communityId: idSchema,
+	orgUserId: idSchema,
+	addedBy: idSchema
+}).strict();
+const publicMessage = messageSchema.omit({ body: true }).strip();
+const publicMessageFlag = messageFlagSchema.omit({ reason: true }).strip();
 const discussionEvents = {
 	commentCreated: defineEvent({
 		type: "discussion.comment.created",
 		version: 1,
-		data: commentSchema
+		data: commentSchema,
+		publicData: publicComment
 	}),
 	commentPublished: defineEvent({
 		type: "discussion.comment.published",
 		version: 1,
-		data: commentSchema
+		data: commentSchema,
+		publicData: publicComment
 	}),
 	commentRemoved: defineEvent({
 		type: "discussion.comment.removed",
 		version: 1,
-		data: commentSchema
+		data: commentSchema,
+		publicData: publicComment
 	}),
 	commentReported: defineEvent({
 		type: "discussion.comment.reported",
 		version: 1,
-		data: commentReportSchema
+		data: reportedComment,
+		publicData: publicCommentReport
+	}),
+	postCreated: defineEvent({
+		type: "discussion.post.created",
+		version: 1,
+		data: postSchema,
+		publicData: postSchema
+	}),
+	postUpdated: defineEvent({
+		type: "discussion.post.updated",
+		version: 1,
+		data: postSchema,
+		publicData: postSchema
+	}),
+	postPublished: defineEvent({
+		type: "discussion.post.published",
+		version: 1,
+		data: postSchema,
+		publicData: postSchema
+	}),
+	postRemoved: defineEvent({
+		type: "discussion.post.removed",
+		version: 1,
+		data: postSchema,
+		publicData: postSchema
+	}),
+	postReported: defineEvent({
+		type: "discussion.post.reported",
+		version: 1,
+		data: reportedPost,
+		publicData: reportedPost
+	}),
+	chatCreated: defineEvent({
+		type: "discussion.chat.created",
+		version: 1,
+		data: chatEventSchema,
+		publicData: publicChat
+	}),
+	chatUpdated: defineEvent({
+		type: "discussion.chat.updated",
+		version: 1,
+		data: chatEventSchema,
+		publicData: publicChat
+	}),
+	chatParticipantAdded: defineEvent({
+		type: "discussion.chat.participant.added",
+		version: 1,
+		data: participantAddedSchema,
+		publicData: participantAddedSchema
+	}),
+	messageSent: defineEvent({
+		type: "discussion.message.sent",
+		version: 1,
+		data: messageSchema,
+		publicData: publicMessage
+	}),
+	messageDeleted: defineEvent({
+		type: "discussion.message.deleted",
+		version: 1,
+		data: messageSchema,
+		publicData: publicMessage
+	}),
+	messageReported: defineEvent({
+		type: "discussion.message.reported",
+		version: 1,
+		data: messageFlagSchema,
+		publicData: publicMessageFlag
+	}),
+	digestDue: defineEvent({
+		type: "discussion.digest.due",
+		version: 1,
+		data: z.object({
+			communityId: idSchema,
+			period: z.string().min(1)
+		}).strict(),
+		publicData: z.object({
+			communityId: idSchema,
+			period: z.string().min(1)
+		}).strict()
 	})
 };
 //#endregion

package/dist/discussion/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../src/discussion/events.ts"],"sourcesContent":["import { commentReportSchema, commentSchema } from '../types/schemas/index.js';\nimport {\n  defineEvent,\n  type EventOf,\n  type EventOfValues,\n  type NewDomainEvent,\n} from '../shared/ports.js';\n\nexport const discussionEvents = {\n  commentCreated: defineEvent({\n    type: 'discussion.comment.created',\n    version: 1,\n    data: commentSchema,\n  }),\n  commentPublished: defineEvent({\n    type: 'discussion.comment.published',\n    version: 1,\n    data: commentSchema,\n  }),\n  commentRemoved: defineEvent({\n    type: 'discussion.comment.removed',\n    version: 1,\n    data: commentSchema,\n  }),\n  commentReported: defineEvent({\n    type: 'discussion.comment.reported',\n    version: 1,\n    data: commentReportSchema,\n  }),\n};\n\nexport type CommentCreated = EventOf<typeof discussionEvents.commentCreated>;\nexport type CommentPublished = EventOf<typeof discussionEvents.commentPublished>;\nexport type CommentRemoved = EventOf<typeof discussionEvents.commentRemoved>;\nexport type CommentReported = EventOf<typeof discussionEvents.commentReported>;\nexport type CommentEvent = EventOfValues<typeof discussionEvents>;\nexport type NewDiscussionEvent = NewDomainEvent<CommentEvent>;\n"],"mappings":";;;AAQA,MAAa,mBAAmB;CAC9B,gBAAgB,YAAY;EAC1B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,kBAAkB,YAAY;EAC5B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,gBAAgB,YAAY;EAC1B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,iBAAiB,YAAY;EAC3B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;AACH"}
+{"version":3,"file":"events.js","names":[],"sources":["../../src/discussion/events.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  chatSchema,\n  commentReportSchema,\n  commentSchema,\n  idSchema,\n  messageFlagSchema,\n  messageSchema,\n  postFlagSchema,\n  postSchema,\n} from '../types/schemas/index.js';\nimport {\n  defineEvent,\n  type EventOf,\n  type EventOfValues,\n  type NewDomainEvent,\n} from '../shared/ports.js';\n\nconst publicComment = commentSchema\n  .pick({\n    id: true,\n    orgId: true,\n    activityId: true,\n    postId: true,\n    communityId: true,\n    parentId: true,\n    orgUserId: true,\n    body: true,\n    status: true,\n    removedBy: true,\n    createdAt: true,\n    updatedAt: true,\n  })\n  .strip();\n\nconst reportedComment = commentReportSchema.extend({ communityId: idSchema.nullable() });\nconst publicCommentReport = reportedComment\n  .pick({\n    id: true,\n    orgId: true,\n    communityId: true,\n    commentId: true,\n    orgUserId: true,\n    reason: true,\n    resolvedAt: true,\n    createdAt: true,\n    updatedAt: true,\n  })\n  .strip();\nconst reportedPost = postFlagSchema.extend({ communityId: idSchema });\n\nconst chatEventSchema = chatSchema.extend({\n  participantIds: z.array(idSchema),\n});\n\nconst publicChat = chatEventSchema\n  .pick({\n    id: true,\n    orgId: true,\n    communityId: true,\n    kind: true,\n    status: true,\n    createdBy: true,\n    participantIds: true,\n  })\n  .strip();\n\nconst participantAddedSchema = z\n  .object({\n    chatId: idSchema,\n    communityId: idSchema,\n    orgUserId: idSchema,\n    addedBy: idSchema,\n  })\n  .strict();\n\nconst publicMessage = messageSchema.omit({ body: true }).strip();\nconst publicMessageFlag = messageFlagSchema.omit({ reason: true }).strip();\n\nexport const discussionEvents = {\n  commentCreated: defineEvent({\n    type: 'discussion.comment.created',\n    version: 1,\n    data: commentSchema,\n    publicData: publicComment,\n  }),\n  commentPublished: defineEvent({\n    type: 'discussion.comment.published',\n    version: 1,\n    data: commentSchema,\n    publicData: publicComment,\n  }),\n  commentRemoved: defineEvent({\n    type: 'discussion.comment.removed',\n    version: 1,\n    data: commentSchema,\n    publicData: publicComment,\n  }),\n  commentReported: defineEvent({\n    type: 'discussion.comment.reported',\n    version: 1,\n    data: reportedComment,\n    publicData: publicCommentReport,\n  }),\n  postCreated: defineEvent({\n    type: 'discussion.post.created',\n    version: 1,\n    data: postSchema,\n    publicData: postSchema,\n  }),\n  postUpdated: defineEvent({\n    type: 'discussion.post.updated',\n    version: 1,\n    data: postSchema,\n    publicData: postSchema,\n  }),\n  postPublished: defineEvent({\n    type: 'discussion.post.published',\n    version: 1,\n    data: postSchema,\n    publicData: postSchema,\n  }),\n  postRemoved: defineEvent({\n    type: 'discussion.post.removed',\n    version: 1,\n    data: postSchema,\n    publicData: postSchema,\n  }),\n  postReported: defineEvent({\n    type: 'discussion.post.reported',\n    version: 1,\n    data: reportedPost,\n    publicData: reportedPost,\n  }),\n  chatCreated: defineEvent({\n    type: 'discussion.chat.created',\n    version: 1,\n    data: chatEventSchema,\n    publicData: publicChat,\n  }),\n  chatUpdated: defineEvent({\n    type: 'discussion.chat.updated',\n    version: 1,\n    data: chatEventSchema,\n    publicData: publicChat,\n  }),\n  chatParticipantAdded: defineEvent({\n    type: 'discussion.chat.participant.added',\n    version: 1,\n    data: participantAddedSchema,\n    publicData: participantAddedSchema,\n  }),\n  messageSent: defineEvent({\n    type: 'discussion.message.sent',\n    version: 1,\n    data: messageSchema,\n    publicData: publicMessage,\n  }),\n  messageDeleted: defineEvent({\n    type: 'discussion.message.deleted',\n    version: 1,\n    data: messageSchema,\n    publicData: publicMessage,\n  }),\n  messageReported: defineEvent({\n    type: 'discussion.message.reported',\n    version: 1,\n    data: messageFlagSchema,\n    publicData: publicMessageFlag,\n  }),\n  digestDue: defineEvent({\n    type: 'discussion.digest.due',\n    version: 1,\n    data: z.object({ communityId: idSchema, period: z.string().min(1) }).strict(),\n    publicData: z.object({ communityId: idSchema, period: z.string().min(1) }).strict(),\n  }),\n};\n\nexport type CommentCreated = EventOf<typeof discussionEvents.commentCreated>;\nexport type CommentPublished = EventOf<typeof discussionEvents.commentPublished>;\nexport type CommentRemoved = EventOf<typeof discussionEvents.commentRemoved>;\nexport type CommentReported = EventOf<typeof discussionEvents.commentReported>;\nexport type DiscussionEvent = EventOfValues<typeof discussionEvents>;\nexport type PostCreated = EventOf<typeof discussionEvents.postCreated>;\nexport type PostUpdated = EventOf<typeof discussionEvents.postUpdated>;\nexport type PostPublished = EventOf<typeof discussionEvents.postPublished>;\nexport type PostRemoved = EventOf<typeof discussionEvents.postRemoved>;\nexport type PostReported = EventOf<typeof discussionEvents.postReported>;\nexport type ChatCreated = EventOf<typeof discussionEvents.chatCreated>;\nexport type ChatUpdated = EventOf<typeof discussionEvents.chatUpdated>;\nexport type ChatParticipantAdded = EventOf<typeof discussionEvents.chatParticipantAdded>;\nexport type MessageSent = EventOf<typeof discussionEvents.messageSent>;\nexport type MessageDeleted = EventOf<typeof discussionEvents.messageDeleted>;\nexport type MessageReported = EventOf<typeof discussionEvents.messageReported>;\nexport type NewDiscussionEvent = NewDomainEvent<DiscussionEvent>;\n"],"mappings":"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"}

package/dist/discussion/index.d.ts

@@ -1,8 +1,12 @@
 import { CommentListItem, CommentReaction, CommentReportSummary, CommentSettings, CommentStatus, CommentView, CommentsConfig, ListCommentsQuery, ReactionCounts, ReactionEmoji } from "../types/schemas/discussion.js";
 import { Comment, CommentAuthor, CommentReport } from "../types/discussion.js";
-import { CommentEvent, discussionEvents } from "./events.js";
+import { Actor } from "../shared/actor.js";
 import "./model.js";
 import "./types.js";
-import { ActivityComments, Actor, AuthorRecord, CommentReactions, CommentWithContext, CourseAccessReader, DiscussionRepository, DiscussionService, DiscussionUnitOfWork, DiscussionWriteScope, PostCommentInput } from "./ports.js";
+import { ActivityComments, AuthorProfileReader, AuthorRecord, AuthorRoleReader, BookmarkQuery, ChatListItem, ChatRepository, ChatService, ChatUnitOfWork, ChatWriteScope, CommentReactions, CommentWithContext, ContentAccessReader, CreatePostInput, DiscussionRepository, DiscussionService, DiscussionUnitOfWork, DiscussionWriteScope, FeedQuery, MessageQueue, MessageReactions, PageQuery, PostCommentInput, PostCommentReader, PostPatch, PostReactions, PostRepository, PostService, PostThreadsQuery, PostUnitOfWork, PostWriteScope, SendMessageInput, SpaceModerationQueue, StartDirectInput, StartGroupInput, UpdatePostInput } from "./ports.js";
+import { authorView } from "./authors.js";
+import { ChatServiceImpl } from "./chats.js";
+import { DiscussionEvent, discussionEvents } from "./events.js";
 import { DEFAULT_SETTINGS, DiscussionServiceImpl } from "./service.js";
-export { type ActivityComments, type Actor, type AuthorRecord, type Comment, type CommentAuthor, type CommentEvent, type CommentListItem, type CommentReaction, type CommentReactions, type CommentReport, type CommentReportSummary, type CommentSettings, type CommentStatus, type CommentView, type CommentWithContext, type CommentsConfig, type CourseAccessReader, DEFAULT_SETTINGS, type DiscussionRepository, type DiscussionService, DiscussionServiceImpl, type DiscussionUnitOfWork, type DiscussionWriteScope, type ListCommentsQuery, type PostCommentInput, type ReactionCounts, type ReactionEmoji, discussionEvents };
+import { PostServiceImpl } from "./posts.js";
+export { type ActivityComments, type Actor, type AuthorProfileReader, type AuthorRecord, type AuthorRoleReader, type BookmarkQuery, type ChatListItem, type ChatRepository, type ChatService, ChatServiceImpl, type ChatUnitOfWork, type ChatWriteScope, type Comment, type CommentAuthor, type CommentListItem, type CommentReaction, type CommentReactions, type CommentReport, type CommentReportSummary, type CommentSettings, type CommentStatus, type CommentView, type CommentWithContext, type CommentsConfig, type ContentAccessReader, type CreatePostInput, DEFAULT_SETTINGS, type DiscussionEvent, type DiscussionRepository, type DiscussionService, DiscussionServiceImpl, type DiscussionUnitOfWork, type DiscussionWriteScope, type FeedQuery, type ListCommentsQuery, type MessageQueue, type MessageReactions, type PageQuery, type PostCommentInput, type PostCommentReader, type PostPatch, type PostReactions, type PostRepository, type PostService, PostServiceImpl, type PostThreadsQuery, type PostUnitOfWork, type PostWriteScope, type ReactionCounts, type ReactionEmoji, type SendMessageInput, type SpaceModerationQueue, type StartDirectInput, type StartGroupInput, type UpdatePostInput, authorView, discussionEvents };

package/dist/discussion/index.js

@@ -1,3 +1,6 @@
 import { discussionEvents } from "./events.js";
+import { authorView } from "./authors.js";
 import { DEFAULT_SETTINGS, DiscussionServiceImpl } from "./service.js";
-export { DEFAULT_SETTINGS, DiscussionServiceImpl, discussionEvents };
+import { PostServiceImpl } from "./posts.js";
+import { ChatServiceImpl } from "./chats.js";
+export { ChatServiceImpl, DEFAULT_SETTINGS, DiscussionServiceImpl, PostServiceImpl, authorView, discussionEvents };

package/dist/discussion/model.d.ts

@@ -1,5 +1,4 @@
-import { ActivityCommentsRule } from "../types/schemas/content.js";
-import { CommentReaction, CommentSettings, CommentStatus } from "../types/schemas/discussion.js";
+import { ActivityCommentsRule, CommentReaction, CommentSettings, CommentStatus } from "../types/schemas/discussion.js";
 import { Comment, CommentAuthor, CommentReport } from "../types/discussion.js";
 import "../types/index.js";
 export type { ActivityCommentsRule, Comment, CommentAuthor, CommentReaction, CommentReport, CommentSettings, CommentStatus };

package/dist/discussion/ports.d.ts

@@ -1,10 +1,13 @@
-import { Page } from "../types/shared.js";
+import { JsonValue, Page } from "../types/shared.js";
+import { Activity, SpaceDetail } from "../types/schemas/content.js";
 import { Role } from "../types/schemas/organizations.js";
-import { Activity } from "../types/schemas/content.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, FlaggedComment, ListCommentsQuery, Message, MessageFlag, MessageFlagResolution, MessageView, Post, PostFlag, PostFlagResolution, PostStatus, PostView, ReactionCounts, ReactionEmoji } from "../types/schemas/discussion.js";
+import { Comment, CommentReport } from "../types/discussion.js";
 import "../types/index.js";
 import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
+import { Actor } from "../shared/actor.js";
+import "../content/index.js";
+import "../organizations/index.js";
 import "./model.js";
 import "./types.js";
 //#region src/discussion/ports.d.ts
@@ -23,27 +26,33 @@ 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 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 +61,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,33 +82,39 @@ 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>;
+  sendDigest(orgId: string, now: Date): Promise<void>;
 }
-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>;
   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>;
   /** 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
@@ -107,6 +124,250 @@ interface DiscussionWriteScope {
   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 PostService {
+  visibleTitles(orgId: string, actor: Actor, postIds: string[]): Promise<Record<string, string>>;
+  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>;
+  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>;
+  follow(orgId: string, postId: string, actor: Actor): Promise<void>;
+  unfollow(orgId: string, postId: string, actor: Actor): Promise<void>;
+  bookmark(orgId: string, postId: string, actor: Actor): Promise<void>;
+  unbookmark(orgId: string, postId: string, actor: Actor): Promise<void>;
+  flag(orgId: string, postId: string, actor: Actor, reason: string): Promise<PostFlag>;
+  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>;
+  followerIds(orgId: string, postId: string): Promise<string[]>;
+  moderationQueue(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceModerationQueue>;
+  publishDue(orgId: string, now: Date): Promise<void>;
+  hasDue(orgId: string, now: Date): Promise<boolean>;
+}
+interface PostRepository {
+  insert(orgId: string, post: Post): Promise<Post>;
+  update(orgId: string, id: string, patch: PostPatch): Promise<Post | null>;
+  find(orgId: string, id: string): Promise<Post | null>;
+  findMany(orgId: string, ids: string[]): Promise<Post[]>;
+  listPublished(orgId: string, spaceIds: string[], query: FeedQuery): Promise<Page<Post>>;
+  listByAuthor(orgId: string, orgUserId: string, spaceIds: string[], query: PageQuery): Promise<Page<Post>>;
+  listBookmarked(orgId: string, orgUserId: string, spaceIds: string[], query: BookmarkQuery): Promise<Page<Post>>;
+  listPending(orgId: string, spaceId: string, limit: number): Promise<Post[]>;
+  /** Due scheduled posts in id order, after `afterId` when given. */
+  listDue(orgId: string, now: Date, limit: number, afterId?: string): Promise<Post[]>;
+  hasDue(orgId: string, now: Date): Promise<boolean>;
+  reactionsOf(orgId: string, postIds: string[], viewerId: string): Promise<Record<string, PostReactions>>;
+  setReaction(orgId: string, postId: string, orgUserId: string, emoji: ReactionEmoji | null): Promise<void>;
+  follow(orgId: string, postId: string, orgUserId: string): Promise<void>;
+  unfollow(orgId: string, postId: string, orgUserId: string): Promise<void>;
+  followerIds(orgId: string, postId: string): Promise<string[]>;
+  followedAmong(orgId: string, postIds: string[], orgUserId: string): Promise<string[]>;
+  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;
+  outbox: OutboxAppender;
+}
+type PostUnitOfWork = UnitOfWork<PostWriteScope>;
+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;
+  muted: boolean;
+  mutedUntil: Date | null;
+  unread: number;
+  lastMessage: ChatLastMessage | 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>;
+  mute(orgId: string, actor: Actor, chatId: string, until?: Date): Promise<void>;
+  unmute(orgId: string, actor: Actor, chatId: string): Promise<void>;
+  block(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;
+  unblock(orgId: string, actor: Actor, communityId: string, orgUserId: string): Promise<void>;
+  flagMessage(orgId: string, actor: Actor, messageId: string, reason: string): Promise<MessageFlag>;
+  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>;
+  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<ChatListItem>>;
+  participants(orgId: string, chatId: string): Promise<ChatUser[]>;
+  join(orgId: string, user: ChatUser): Promise<void>;
+  markLeft(orgId: string, chatId: string, orgUserId: string, leftAt: Date): Promise<void>;
+  setRead(orgId: string, chatId: string, orgUserId: string, messageId: string): Promise<void>;
+  setMuted(orgId: string, chatId: string, orgUserId: string, muted: boolean, mutedUntil: Date | null): Promise<void>;
+  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<void>;
+  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;
+  outbox: OutboxAppender;
+}
+type ChatUnitOfWork = UnitOfWork<ChatWriteScope>;
 //#endregion
-export { ActivityComments, ActivityGetter, Actor, AuthorRecord, CommentReactions, CommentWithContext, CourseAccessReader, DiscussionRepository, DiscussionService, DiscussionUnitOfWork, DiscussionWriteScope, PostCommentInput };
+export { ActivityComments, ActivityGetter, type Actor, AuthorProfileReader, AuthorRecord, AuthorRoleReader, BookmarkQuery, ChatListItem, ChatRepository, ChatService, ChatSummary, ChatUnitOfWork, ChatWriteScope, CommentReactions, CommentWithContext, ContentAccessReader, CreatePostInput, DiscussionRepository, DiscussionService, DiscussionUnitOfWork, DiscussionWriteScope, FeedQuery, MODERATION_QUEUE_LIMIT, MessageQueue, MessageQueueEntry, MessageReactions, PageQuery, PostCommentInput, PostCommentReader, PostMode, PostPatch, PostReactions, PostRepository, PostService, PostThreadsQuery, PostUnitOfWork, PostWriteScope, SendMessageInput, SpaceModerationQueue, StartDirectInput, StartGroupInput, UpdatePostInput };
 //# 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