@headless-lms/server 0.2.0 → 0.4.0

package/dist/http/routes/member/chats.js

@@ -0,0 +1,435 @@
+import { PageQuery, refusals } from "../../schemas/shared.js";
+import { Reactions, SetMute, SetReaction } from "../../schemas/discussion.js";
+import { FlagReason } from "../../schemas/posts.js";
+import { BlockParam, Chat, ChatIdParam, ChatsPage, CommunityParam, EditMessage, MarkRead, MessageFlag, MessageIdParam, MessageView, MessagesPage, OrgUserBody, ResolveMessageFlags, SendMessage, StartDirectChat, StartGroupChat } from "../../schemas/chats.js";
+import "../../schemas/index.js";
+import { actorOf } from "./actor.js";
+import { z } from "zod";
+//#region src/http/routes/member/chats.ts
+async function memberChatRoutes(app, container) {
+	const r = app.withTypeProvider();
+	const chats = container.chats;
+	const tags = ["Chats"];
+	r.route({
+		method: "GET",
+		url: "/api/member/communities/:communityId/chats",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listMemberChats",
+			tags,
+			summary: "List your chats in a community",
+			description: "For a member of the community. Every chat you are in, with your unread count and its last message.",
+			params: CommunityParam,
+			querystring: PageQuery,
+			response: {
+				200: ChatsPage,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.listChats(req.orgId, actor, req.params.communityId, req.query);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/direct",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "startDirectChat",
+			tags,
+			summary: "Start a direct chat, or return the one that already exists",
+			description: "For a member of the community, within its direct-message settings (403 otherwise). With the community set so a first message is a request, a new chat starts `pending` until the other person accepts it. 409 when you message yourself, send attachments without a body, or start a request without a message.",
+			body: StartDirectChat,
+			response: {
+				200: Chat,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.startDirect(req.orgId, actor, req.body);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/group",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "startGroupChat",
+			tags,
+			summary: "Start a group chat",
+			description: "For a member of the community while group chats are on (403 otherwise). Everyone named must hold the community and be someone you may message. 409 when fewer than two others are named or the group would exceed the community's group size.",
+			body: StartGroupChat,
+			response: {
+				201: Chat,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const chat = await chats.startGroup(req.orgId, actor, req.body);
+			return reply.code(201).send(chat);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/:chatId/participants",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "addChatParticipant",
+			tags,
+			summary: "Add a person to a group chat you are in",
+			description: "For a participant of a group chat. 409 when the chat is direct, the person is already in it, or it is full.",
+			params: ChatIdParam,
+			body: OrgUserBody,
+			response: {
+				200: Chat,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.addParticipant(req.orgId, actor, req.params.chatId, req.body.orgUserId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/:chatId/leave",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "leaveChat",
+			tags,
+			summary: "Leave a chat",
+			description: "For a participant. The chat stays for the others.",
+			params: ChatIdParam,
+			response: {
+				200: Chat,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.leave(req.orgId, actor, req.params.chatId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/:chatId/acceptance",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "acceptChat",
+			tags,
+			summary: "Accept a message request",
+			description: "For the person the request was sent to. The chat opens for both sides. 409 when the chat is not a pending request.",
+			params: ChatIdParam,
+			response: {
+				200: Chat,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.accept(req.orgId, actor, req.params.chatId);
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/member/chats/:chatId/messages",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listChatMessages",
+			tags,
+			summary: "Read the messages in a chat, newest first",
+			description: "For a participant of the chat.",
+			params: ChatIdParam,
+			querystring: PageQuery,
+			response: {
+				200: MessagesPage,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.messages(req.orgId, actor, req.params.chatId, req.query);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/:chatId/messages",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "sendChatMessage",
+			tags,
+			summary: "Send a message",
+			description: "For a participant while the chat is open and not locked, and nobody in it has blocked the other (403 otherwise). A request's sender cannot send more until it is accepted.",
+			params: ChatIdParam,
+			body: SendMessage,
+			response: {
+				201: MessageView,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const message = await chats.send(req.orgId, actor, req.params.chatId, req.body);
+			return reply.code(201).send(message);
+		}
+	});
+	r.route({
+		method: "PATCH",
+		url: "/api/member/messages/:messageId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "editChatMessage",
+			tags,
+			summary: "Edit your own message",
+			description: "Sender only, while the chat is open and not locked. 409 when the message is deleted.",
+			params: MessageIdParam,
+			body: EditMessage,
+			response: {
+				200: MessageView,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.editMessage(req.orgId, actor, req.params.messageId, req.body.body);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/member/messages/:messageId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "deleteChatMessage",
+			tags,
+			summary: "Delete your message, or one in a community you moderate",
+			description: "For the sender, or a moderator of the community. The message stays in the history, marked deleted. 409 when it is already deleted.",
+			params: MessageIdParam,
+			response: {
+				200: MessageView,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.deleteMessage(req.orgId, actor, req.params.messageId);
+		}
+	});
+	r.route({
+		method: "PUT",
+		url: "/api/member/messages/:messageId/reaction",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "setMessageReaction",
+			tags,
+			summary: "Set your reaction on a message",
+			description: "For a participant of the chat. Replaces any reaction you already had and returns the new counts.",
+			params: MessageIdParam,
+			body: SetReaction,
+			response: {
+				200: Reactions,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.setReaction(req.orgId, actor, req.params.messageId, req.body.emoji);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/member/messages/:messageId/reaction",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "clearMessageReaction",
+			tags,
+			summary: "Withdraw your reaction from a message",
+			description: "For a participant of the chat. Returns the new counts.",
+			params: MessageIdParam,
+			response: {
+				200: Reactions,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.setReaction(req.orgId, actor, req.params.messageId, null);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/messages/:messageId/flags",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "flagMessage",
+			tags,
+			summary: "Flag a message for the moderators",
+			description: "For a participant of the chat. Flagging it again while your flag is open returns that flag.",
+			params: MessageIdParam,
+			body: FlagReason,
+			response: {
+				201: MessageFlag,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const flag = await chats.flagMessage(req.orgId, actor, req.params.messageId, req.body.reason);
+			return reply.code(201).send(flag);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/messages/:messageId/flags/resolution",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "resolveMessageFlags",
+			tags,
+			summary: "Dismiss the open flags on a message in a community you moderate",
+			description: "For a moderator who is a member of the community. Closes every open flag and leaves the message up.",
+			params: MessageIdParam,
+			body: ResolveMessageFlags,
+			response: {
+				204: z.void(),
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			await chats.resolveMessageFlags(req.orgId, actor, req.params.messageId, req.body.resolution);
+			return reply.code(204).send();
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/:chatId/read",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "markChatRead",
+			tags,
+			summary: "Mark a chat read up to a message",
+			description: "For a participant. The message must be in the chat (404 otherwise).",
+			params: ChatIdParam,
+			body: MarkRead,
+			response: {
+				204: z.void(),
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			await chats.markRead(req.orgId, actor, req.params.chatId, req.body.messageId);
+			return reply.code(204).send();
+		}
+	});
+	r.route({
+		method: "PUT",
+		url: "/api/member/chats/:chatId/subscription",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "setChatSubscription",
+			tags,
+			summary: "Mute a chat, or clear your mute",
+			description: "For a participant. `muted` stops its messages notifying you, until `mutedUntil` when given; a mention still notifies you. `none` clears the mute.",
+			params: ChatIdParam,
+			body: SetMute,
+			response: {
+				204: z.void(),
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			await container.subscriptions.setChat(req.orgId, actor, req.params.chatId, req.body);
+			return reply.code(204).send();
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/:chatId/lock",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "lockChat",
+			tags,
+			summary: "Lock a chat in a community you moderate",
+			description: "For a moderator who is a member of the community. Nobody can send or edit messages until it is unlocked; its open message flags are resolved as `locked`. Locking a locked chat returns it unchanged.",
+			params: ChatIdParam,
+			response: {
+				200: Chat,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.lock(req.orgId, actor, req.params.chatId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/chats/:chatId/unlock",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "unlockChat",
+			tags,
+			summary: "Unlock a chat in a community you moderate",
+			description: "For a moderator who is a member of the community. Unlocking an unlocked chat returns it unchanged.",
+			params: ChatIdParam,
+			response: {
+				200: Chat,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return chats.unlock(req.orgId, actor, req.params.chatId);
+		}
+	});
+	r.route({
+		method: "PUT",
+		url: "/api/member/communities/:communityId/blocks/:orgUserId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "blockMember",
+			tags,
+			summary: "Block a person in a community",
+			description: "For a member of the community. Neither of you can message the other there; a direct chat between you closes. Blocking twice is harmless. 409 when you block yourself.",
+			params: BlockParam,
+			response: {
+				204: z.void(),
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			await chats.block(req.orgId, actor, req.params.communityId, req.params.orgUserId);
+			return reply.code(204).send();
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/member/communities/:communityId/blocks/:orgUserId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "unblockMember",
+			tags,
+			summary: "Unblock a person in a community",
+			description: "For a member of the community. A direct chat closed by the block reopens unless a moderator locked it. 409 when you unblock yourself.",
+			params: BlockParam,
+			response: {
+				204: z.void(),
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			await chats.unblock(req.orgId, actor, req.params.communityId, req.params.orgUserId);
+			return reply.code(204).send();
+		}
+	});
+}
+//#endregion
+export { memberChatRoutes };
+
+//# sourceMappingURL=chats.js.map

package/dist/http/routes/member/chats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chats.js","names":[],"sources":["../../../../src/http/routes/member/chats.ts"],"sourcesContent":["import type { FastifyInstance } from 'fastify';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\nimport type { Container } from '../../../app/container.js';\nimport { actorOf } from './actor.js';\nimport {\n  BlockParam,\n  Chat,\n  ChatIdParam,\n  ChatsPage,\n  CommunityParam,\n  EditMessage,\n  FlagReason,\n  PageQuery,\n  MarkRead,\n  MessageFlag,\n  MessageIdParam,\n  MessagesPage,\n  MessageView,\n  OrgUserBody,\n  Reactions,\n  ResolveMessageFlags,\n  SendMessage,\n  SetMute,\n  SetReaction,\n  StartDirectChat,\n  StartGroupChat,\n  refusals,\n} from '../../schemas/index.js';\n\nexport async function memberChatRoutes(app: FastifyInstance, container: Container): Promise<void> {\n  const r = app.withTypeProvider<ZodTypeProvider>();\n  const chats = container.chats;\n  const tags = ['Chats'];\n\n  r.route({\n    method: 'GET',\n    url: '/api/member/communities/:communityId/chats',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listMemberChats',\n      tags,\n      summary: 'List your chats in a community',\n      description:\n        'For a member of the community. Every chat you are in, with your unread count and its last message.',\n      params: CommunityParam,\n      querystring: PageQuery,\n      response: { 200: ChatsPage, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.listChats(req.orgId, actor, req.params.communityId, req.query);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/direct',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'startDirectChat',\n      tags,\n      summary: 'Start a direct chat, or return the one that already exists',\n      description:\n        'For a member of the community, within its direct-message settings (403 otherwise). With the community set so a first message is a request, a new chat starts `pending` until the other person accepts it. 409 when you message yourself, send attachments without a body, or start a request without a message.',\n      body: StartDirectChat,\n      response: { 200: Chat, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.startDirect(req.orgId, actor, req.body);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/group',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'startGroupChat',\n      tags,\n      summary: 'Start a group chat',\n      description:\n        \"For a member of the community while group chats are on (403 otherwise). Everyone named must hold the community and be someone you may message. 409 when fewer than two others are named or the group would exceed the community's group size.\",\n      body: StartGroupChat,\n      response: { 201: Chat, ...refusals(403, 404, 409) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const chat = await chats.startGroup(req.orgId, actor, req.body);\n      return reply.code(201).send(chat);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/:chatId/participants',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'addChatParticipant',\n      tags,\n      summary: 'Add a person to a group chat you are in',\n      description:\n        'For a participant of a group chat. 409 when the chat is direct, the person is already in it, or it is full.',\n      params: ChatIdParam,\n      body: OrgUserBody,\n      response: { 200: Chat, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.addParticipant(req.orgId, actor, req.params.chatId, req.body.orgUserId);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/:chatId/leave',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'leaveChat',\n      tags,\n      summary: 'Leave a chat',\n      description: 'For a participant. The chat stays for the others.',\n      params: ChatIdParam,\n      response: { 200: Chat, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.leave(req.orgId, actor, req.params.chatId);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/:chatId/acceptance',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'acceptChat',\n      tags,\n      summary: 'Accept a message request',\n      description:\n        'For the person the request was sent to. The chat opens for both sides. 409 when the chat is not a pending request.',\n      params: ChatIdParam,\n      response: { 200: Chat, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.accept(req.orgId, actor, req.params.chatId);\n    },\n  });\n\n  r.route({\n    method: 'GET',\n    url: '/api/member/chats/:chatId/messages',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listChatMessages',\n      tags,\n      summary: 'Read the messages in a chat, newest first',\n      description: 'For a participant of the chat.',\n      params: ChatIdParam,\n      querystring: PageQuery,\n      response: { 200: MessagesPage, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.messages(req.orgId, actor, req.params.chatId, req.query);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/:chatId/messages',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'sendChatMessage',\n      tags,\n      summary: 'Send a message',\n      description:\n        \"For a participant while the chat is open and not locked, and nobody in it has blocked the other (403 otherwise). A request's sender cannot send more until it is accepted.\",\n      params: ChatIdParam,\n      body: SendMessage,\n      response: { 201: MessageView, ...refusals(403, 404) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const message = await chats.send(req.orgId, actor, req.params.chatId, req.body);\n      return reply.code(201).send(message);\n    },\n  });\n\n  r.route({\n    method: 'PATCH',\n    url: '/api/member/messages/:messageId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'editChatMessage',\n      tags,\n      summary: 'Edit your own message',\n      description:\n        'Sender only, while the chat is open and not locked. 409 when the message is deleted.',\n      params: MessageIdParam,\n      body: EditMessage,\n      response: { 200: MessageView, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.editMessage(req.orgId, actor, req.params.messageId, req.body.body);\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/member/messages/:messageId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'deleteChatMessage',\n      tags,\n      summary: 'Delete your message, or one in a community you moderate',\n      description:\n        'For the sender, or a moderator of the community. The message stays in the history, marked deleted. 409 when it is already deleted.',\n      params: MessageIdParam,\n      response: { 200: MessageView, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.deleteMessage(req.orgId, actor, req.params.messageId);\n    },\n  });\n\n  r.route({\n    method: 'PUT',\n    url: '/api/member/messages/:messageId/reaction',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'setMessageReaction',\n      tags,\n      summary: 'Set your reaction on a message',\n      description:\n        'For a participant of the chat. Replaces any reaction you already had and returns the new counts.',\n      params: MessageIdParam,\n      body: SetReaction,\n      response: { 200: Reactions, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.setReaction(req.orgId, actor, req.params.messageId, req.body.emoji);\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/member/messages/:messageId/reaction',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'clearMessageReaction',\n      tags,\n      summary: 'Withdraw your reaction from a message',\n      description: 'For a participant of the chat. Returns the new counts.',\n      params: MessageIdParam,\n      response: { 200: Reactions, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.setReaction(req.orgId, actor, req.params.messageId, null);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/messages/:messageId/flags',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'flagMessage',\n      tags,\n      summary: 'Flag a message for the moderators',\n      description:\n        'For a participant of the chat. Flagging it again while your flag is open returns that flag.',\n      params: MessageIdParam,\n      body: FlagReason,\n      response: { 201: MessageFlag, ...refusals(403, 404) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const flag = await chats.flagMessage(req.orgId, actor, req.params.messageId, req.body.reason);\n      return reply.code(201).send(flag);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/messages/:messageId/flags/resolution',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'resolveMessageFlags',\n      tags,\n      summary: 'Dismiss the open flags on a message in a community you moderate',\n      description:\n        'For a moderator who is a member of the community. Closes every open flag and leaves the message up.',\n      params: MessageIdParam,\n      body: ResolveMessageFlags,\n      response: { 204: z.void(), ...refusals(403, 404) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      await chats.resolveMessageFlags(req.orgId, actor, req.params.messageId, req.body.resolution);\n      return reply.code(204).send();\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/:chatId/read',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'markChatRead',\n      tags,\n      summary: 'Mark a chat read up to a message',\n      description: 'For a participant. The message must be in the chat (404 otherwise).',\n      params: ChatIdParam,\n      body: MarkRead,\n      response: { 204: z.void(), ...refusals(403, 404) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      await chats.markRead(req.orgId, actor, req.params.chatId, req.body.messageId);\n      return reply.code(204).send();\n    },\n  });\n\n  r.route({\n    method: 'PUT',\n    url: '/api/member/chats/:chatId/subscription',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'setChatSubscription',\n      tags,\n      summary: 'Mute a chat, or clear your mute',\n      description:\n        'For a participant. `muted` stops its messages notifying you, until `mutedUntil` when given; a mention still notifies you. `none` clears the mute.',\n      params: ChatIdParam,\n      body: SetMute,\n      response: { 204: z.void(), ...refusals(403, 404) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      await container.subscriptions.setChat(req.orgId, actor, req.params.chatId, req.body);\n      return reply.code(204).send();\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/:chatId/lock',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'lockChat',\n      tags,\n      summary: 'Lock a chat in a community you moderate',\n      description:\n        'For a moderator who is a member of the community. Nobody can send or edit messages until it is unlocked; its open message flags are resolved as `locked`. Locking a locked chat returns it unchanged.',\n      params: ChatIdParam,\n      response: { 200: Chat, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.lock(req.orgId, actor, req.params.chatId);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/chats/:chatId/unlock',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'unlockChat',\n      tags,\n      summary: 'Unlock a chat in a community you moderate',\n      description:\n        'For a moderator who is a member of the community. Unlocking an unlocked chat returns it unchanged.',\n      params: ChatIdParam,\n      response: { 200: Chat, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return chats.unlock(req.orgId, actor, req.params.chatId);\n    },\n  });\n\n  r.route({\n    method: 'PUT',\n    url: '/api/member/communities/:communityId/blocks/:orgUserId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'blockMember',\n      tags,\n      summary: 'Block a person in a community',\n      description:\n        'For a member of the community. Neither of you can message the other there; a direct chat between you closes. Blocking twice is harmless. 409 when you block yourself.',\n      params: BlockParam,\n      response: { 204: z.void(), ...refusals(403, 404, 409) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      await chats.block(req.orgId, actor, req.params.communityId, req.params.orgUserId);\n      return reply.code(204).send();\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/member/communities/:communityId/blocks/:orgUserId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'unblockMember',\n      tags,\n      summary: 'Unblock a person in a community',\n      description:\n        'For a member of the community. A direct chat closed by the block reopens unless a moderator locked it. 409 when you unblock yourself.',\n      params: BlockParam,\n      response: { 204: z.void(), ...refusals(403, 404, 409) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      await chats.unblock(req.orgId, actor, req.params.communityId, req.params.orgUserId);\n      return reply.code(204).send();\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/http/routes/member/comments.d.ts

@@ -0,0 +1,7 @@
+import { Container } from "../../../app/container.js";
+import { FastifyInstance } from "fastify";
+//#region src/http/routes/member/comments.d.ts
+declare function memberCommentsRoutes(app: FastifyInstance, container: Container): Promise<void>;
+//#endregion
+export { memberCommentsRoutes };
+//# sourceMappingURL=comments.d.ts.map

package/dist/http/routes/member/comments.js

@@ -0,0 +1,187 @@
+import { refusals } from "../../schemas/shared.js";
+import { ActivityComments, CommentIdParam, CommentReport, CommentView, DiscussionActivityParam, EditComment, PostComment, Reactions, ReportComment, ResolveCommentFlags, SetReaction } from "../../schemas/discussion.js";
+import "../../schemas/index.js";
+import { actorOf } from "./actor.js";
+import { z } from "zod";
+//#region src/http/routes/member/comments.ts
+async function memberCommentsRoutes(app, container) {
+	const r = app.withTypeProvider();
+	const discussion = container.discussion;
+	const tags = ["Discussion"];
+	r.route({
+		method: "GET",
+		url: "/api/member/activities/:activityId/comments",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listActivityComments",
+			tags,
+			summary: "Read an activity's comments",
+			description: "For a student who can open the course, and staff. Returns the activity's resolved comment settings with the comments; removed comments keep their place without their body.",
+			params: DiscussionActivityParam,
+			response: {
+				200: ActivityComments,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			return discussion.activityComments(req.orgId, req.params.activityId, orgUser);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/activities/:activityId/comments",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "postComment",
+			tags,
+			summary: "Post a comment or reply on an activity",
+			description: "For a student who can open the course, and staff, while discussion is on for the activity (403 otherwise). Lands pending when the course requires review and you are not staff. Replies nest one level and need threading on.",
+			params: DiscussionActivityParam,
+			body: PostComment,
+			response: {
+				201: CommentView,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req, reply) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			const comment = await discussion.postComment(req.orgId, {
+				actor: orgUser,
+				activityId: req.params.activityId,
+				parentId: req.body.parentId,
+				body: req.body.body
+			});
+			return reply.code(201).send(comment);
+		}
+	});
+	r.route({
+		method: "PATCH",
+		url: "/api/member/comments/:commentId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "editComment",
+			tags,
+			summary: "Revise your own comment",
+			description: "Author only; not even staff may revise it. Discussion must be open where the comment is, and a removed comment cannot be revised.",
+			params: CommentIdParam,
+			body: EditComment,
+			response: {
+				200: CommentView,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			return discussion.edit(req.orgId, req.params.commentId, orgUser, req.body.body);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/member/comments/:commentId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "deleteComment",
+			tags,
+			summary: "Delete your comment, or one you moderate",
+			description: "For the author, staff on an activity comment, or a moderator on a post comment. The comment is marked removed and keeps its place in the thread. Deleting a removed comment returns it unchanged.",
+			params: CommentIdParam,
+			response: {
+				200: CommentView,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			return discussion.remove(req.orgId, req.params.commentId, orgUser);
+		}
+	});
+	r.route({
+		method: "PUT",
+		url: "/api/member/comments/:commentId/reaction",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "setCommentReaction",
+			tags,
+			summary: "Set your reaction on a comment",
+			description: "For anyone who can read the comment, while reactions are on where it is (403 otherwise). Replaces any reaction you already had and returns the new counts.",
+			params: CommentIdParam,
+			body: SetReaction,
+			response: {
+				200: Reactions,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			return discussion.setReaction(req.orgId, req.params.commentId, orgUser, req.body.emoji);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/member/comments/:commentId/reaction",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "clearCommentReaction",
+			tags,
+			summary: "Withdraw your reaction from a comment",
+			description: "For anyone who can read the comment. Returns the new counts.",
+			params: CommentIdParam,
+			response: {
+				200: Reactions,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			return discussion.setReaction(req.orgId, req.params.commentId, orgUser, null);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/comments/:commentId/reports",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "reportComment",
+			tags,
+			summary: "Flag a comment for the moderators",
+			description: "For anyone who can read the comment. Flagging it again while your flag is open returns that flag.",
+			params: CommentIdParam,
+			body: ReportComment,
+			response: {
+				200: CommentReport,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			return discussion.reportComment(req.orgId, req.params.commentId, orgUser, req.body.reason);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/comments/:commentId/flags/resolution",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "resolveCommentFlags",
+			tags,
+			summary: "Dismiss the open flags on a comment in a space you moderate",
+			description: "For a moderator of a post comment, or staff for an activity comment. Closes every open flag and leaves the comment up.",
+			params: CommentIdParam,
+			body: ResolveCommentFlags,
+			response: {
+				204: z.void(),
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req, reply) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			await discussion.resolveReports(req.orgId, req.params.commentId, orgUser);
+			return reply.code(204).send();
+		}
+	});
+}
+//#endregion
+export { memberCommentsRoutes };
+
+//# sourceMappingURL=comments.js.map