@headless-lms/server 0.2.0 → 0.3.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","names":[],"sources":["../../../../src/http/routes/member/comments.ts"],"sourcesContent":["import type { FastifyInstance } from 'fastify';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\nimport {\n  ActivityComments,\n  CommentIdParam,\n  CommentReport,\n  CommentView,\n  DiscussionActivityParam,\n  EditComment,\n  PostComment,\n  Reactions,\n  ReportComment,\n  ResolveCommentFlags,\n  SetReaction,\n  refusals,\n} from '../../schemas/index.js';\nimport type { Container } from '../../../app/container.js';\nimport { actorOf } from './actor.js';\n\nexport async function memberCommentsRoutes(\n  app: FastifyInstance,\n  container: Container,\n): Promise<void> {\n  const r = app.withTypeProvider<ZodTypeProvider>();\n  const discussion = container.discussion;\n  const tags = ['Discussion'];\n\n  r.route({\n    method: 'GET',\n    url: '/api/member/activities/:activityId/comments',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listActivityComments',\n      tags,\n      summary: \"Read an activity's comments\",\n      description:\n        \"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.\",\n      params: DiscussionActivityParam,\n      response: { 200: ActivityComments, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      return discussion.activityComments(req.orgId, req.params.activityId, orgUser);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/activities/:activityId/comments',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'postComment',\n      tags,\n      summary: 'Post a comment or reply on an activity',\n      description:\n        '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.',\n      params: DiscussionActivityParam,\n      body: PostComment,\n      response: { 201: CommentView, ...refusals(403, 404) },\n    },\n    handler: async (req, reply) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      const comment = await discussion.postComment(req.orgId, {\n        actor: orgUser,\n        activityId: req.params.activityId,\n        parentId: req.body.parentId,\n        body: req.body.body,\n      });\n      return reply.code(201).send(comment);\n    },\n  });\n\n  r.route({\n    method: 'PATCH',\n    url: '/api/member/comments/:commentId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'editComment',\n      tags,\n      summary: 'Revise your own comment',\n      description:\n        'Author only; not even staff may revise it. Discussion must be open where the comment is, and a removed comment cannot be revised.',\n      params: CommentIdParam,\n      body: EditComment,\n      response: { 200: CommentView, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      return discussion.edit(req.orgId, req.params.commentId, orgUser, req.body.body);\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/member/comments/:commentId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'deleteComment',\n      tags,\n      summary: 'Delete your comment, or one you moderate',\n      description:\n        '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.',\n      params: CommentIdParam,\n      response: { 200: CommentView, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      return discussion.remove(req.orgId, req.params.commentId, orgUser);\n    },\n  });\n\n  r.route({\n    method: 'PUT',\n    url: '/api/member/comments/:commentId/reaction',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'setCommentReaction',\n      tags,\n      summary: 'Set your reaction on a comment',\n      description:\n        '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.',\n      params: CommentIdParam,\n      body: SetReaction,\n      response: { 200: Reactions, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      return discussion.setReaction(req.orgId, req.params.commentId, orgUser, req.body.emoji);\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/member/comments/:commentId/reaction',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'clearCommentReaction',\n      tags,\n      summary: 'Withdraw your reaction from a comment',\n      description: 'For anyone who can read the comment. Returns the new counts.',\n      params: CommentIdParam,\n      response: { 200: Reactions, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      return discussion.setReaction(req.orgId, req.params.commentId, orgUser, null);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/comments/:commentId/reports',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'reportComment',\n      tags,\n      summary: 'Flag a comment for the moderators',\n      description:\n        'For anyone who can read the comment. Flagging it again while your flag is open returns that flag.',\n      params: CommentIdParam,\n      body: ReportComment,\n      response: { 200: CommentReport, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      return discussion.reportComment(req.orgId, req.params.commentId, orgUser, req.body.reason);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/comments/:commentId/flags/resolution',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'resolveCommentFlags',\n      tags,\n      summary: 'Dismiss the open flags on a comment in a space you moderate',\n      description:\n        'For a moderator of a post comment, or staff for an activity comment. Closes every open flag and leaves the comment up.',\n      params: CommentIdParam,\n      body: ResolveCommentFlags,\n      response: { 204: z.void(), ...refusals(403, 404) },\n    },\n    handler: async (req, reply) => {\n      const orgUser = await actorOf(container, req.orgId, req.userId);\n      await discussion.resolveReports(req.orgId, req.params.commentId, orgUser);\n      return reply.code(204).send();\n    },\n  });\n}\n"],"mappings":"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"}

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

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

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

@@ -0,0 +1,288 @@
+import { PageQuery, refusals } from "../../schemas/shared.js";
+import { CommunityHome, CommunityHomeSpace, CommunitySpaceParam, DirectoryPage, DirectoryQuery, SpaceMember, SpaceMemberParam, SpaceMembersPage } from "../../schemas/community.js";
+import { CommunityParam, OrgUserBody } from "../../schemas/chats.js";
+import "../../schemas/index.js";
+import { actorOf } from "./actor.js";
+import { NotFoundError } from "@headless-lms/core/shared/errors";
+//#region src/http/routes/member/community.ts
+async function memberCommunityRoutes(app, container) {
+	const r = app.withTypeProvider();
+	const tags = ["Communities"];
+	r.route({
+		method: "GET",
+		url: "/api/member/communities/:communityId/home",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "getMemberCommunityHome",
+			tags,
+			summary: "The spaces a member can see in a community",
+			description: "For a member of the community. Lists its spaces in order. Spaces the viewer can open come back in full; spaces they can see but not open come back locked, with only their name, count, rule and the viewer's standing. A by-invite space the viewer is not invited to or a member of is left out. 404 when the viewer is not a member.",
+			params: CommunityParam,
+			response: {
+				200: CommunityHome,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const home = await container.reporting.member.communityHome(req.orgId, actor, req.params.communityId);
+			if (!home) throw new NotFoundError("Community", req.params.communityId);
+			return home;
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/member/communities/:communityId/spaces/:spaceId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "getMemberSpace",
+			tags,
+			summary: "One space as a member sees it",
+			description: "For a member of the community: the space with its topics, links, settings and where the viewer stands. A space the viewer cannot open comes back locked, without its content. 404 when the viewer is not a member, the space is not in the community, or it is a by-invite space the viewer is not invited to or a member of.",
+			params: CommunitySpaceParam,
+			response: {
+				200: CommunityHomeSpace,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const space = await container.reporting.member.communitySpace(req.orgId, actor, req.params.communityId, req.params.spaceId);
+			if (!space) throw new NotFoundError("Space", req.params.spaceId);
+			return space;
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/member/communities/:communityId/directory",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "getMemberCommunityDirectory",
+			tags,
+			summary: "People in a community",
+			description: "For a member of the community: everyone who holds it, with their public profile. 404 when the viewer is not a member.",
+			params: CommunityParam,
+			querystring: DirectoryQuery,
+			response: {
+				200: DirectoryPage,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const page = await container.reporting.member.directory(req.orgId, actor, req.params.communityId, req.query);
+			if (!page) throw new NotFoundError("Community", req.params.communityId);
+			return page;
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/members",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listSpaceMembers",
+			tags,
+			summary: "List the members of a space",
+			description: "For anyone who can open the space. Members see the active members; moderators also see open requests and invitations.",
+			params: CommunitySpaceParam,
+			querystring: PageQuery,
+			response: {
+				200: SpaceMembersPage,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return container.entitlements.listSpaceMembers(req.orgId, actor, req.params.communityId, req.params.spaceId, req.query);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/requests",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "requestSpaceMembership",
+			tags,
+			summary: "Ask to join a space",
+			description: "For a member of the community who is not staff. Opens a request on a `by_request` space for a moderator to approve. 409 when the space is not `by_request` or you are already placed in it.",
+			params: CommunitySpaceParam,
+			response: {
+				201: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const member = await container.entitlements.requestJoin(req.orgId, actor, req.params.communityId, req.params.spaceId);
+			return reply.code(201).send(member);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/invites",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "inviteSpaceMember",
+			tags,
+			summary: "Invite a person into a space you moderate",
+			description: "For a moderator who is a member of the community. Invites another member into a `by_invite` space; they join when they accept. 403 when the person is staff or does not hold the community; 409 when the space is not invite-only or the person is already placed.",
+			params: CommunitySpaceParam,
+			body: OrgUserBody,
+			response: {
+				201: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const member = await container.entitlements.invite(req.orgId, actor, req.params.communityId, req.params.spaceId, req.body.orgUserId);
+			return reply.code(201).send(member);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/members",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "addSpaceMember",
+			tags,
+			summary: "Add a person to a space you moderate",
+			description: "For a moderator who is a member of the community. Places another member straight into the space, with no request or invitation. 409 when the space is open to all members, the person is already placed, or the space is full.",
+			params: CommunitySpaceParam,
+			body: OrgUserBody,
+			response: {
+				201: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req, reply) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			const member = await container.entitlements.addSpaceMember(req.orgId, actor, req.params.communityId, req.params.spaceId, req.body.orgUserId);
+			return reply.code(201).send(member);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/acceptance",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "acceptSpaceInvite",
+			tags,
+			summary: "Accept your invitation to a space",
+			description: "For a member of the community who is not staff. Makes you an active member. 409 when you have no open invitation, are already a member, or the space is full.",
+			params: CommunitySpaceParam,
+			response: {
+				200: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return container.entitlements.accept(req.orgId, actor, req.params.communityId, req.params.spaceId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/members/:orgUserId/approval",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "approveSpaceRequest",
+			tags,
+			summary: "Approve a person's request to join a space you moderate",
+			description: "For a moderator who is a member of the community. Makes the requester an active member. 404 when the person has no open request; 409 when the space is full or they are already a member.",
+			params: SpaceMemberParam,
+			response: {
+				200: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return container.entitlements.approve(req.orgId, actor, req.params.communityId, req.params.spaceId, req.params.orgUserId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/members/:orgUserId/decline",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "declineSpaceRequest",
+			tags,
+			summary: "Decline a person's request to join a space you moderate",
+			description: "For a moderator who is a member of the community. Closes the open request. 404 when the person has no open request; 409 when they are already a member.",
+			params: SpaceMemberParam,
+			response: {
+				200: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return container.entitlements.decline(req.orgId, actor, req.params.communityId, req.params.spaceId, req.params.orgUserId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/refusal",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "refuseSpaceInvite",
+			tags,
+			summary: "Refuse your invitation to a space",
+			description: "For a member of the community who is not staff. 409 when you have no open invitation or are already a member.",
+			params: CommunitySpaceParam,
+			response: {
+				200: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return container.entitlements.refuse(req.orgId, actor, req.params.communityId, req.params.spaceId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/departure",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "leaveSpace",
+			tags,
+			summary: "Leave a space",
+			description: "For a member of the community who is not staff. 409 when you are not a member of the space.",
+			params: CommunitySpaceParam,
+			response: {
+				200: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return container.entitlements.leave(req.orgId, actor, req.params.communityId, req.params.spaceId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/member/communities/:communityId/spaces/:spaceId/members/:orgUserId/removal",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "removeSpaceMember",
+			tags,
+			summary: "Remove a person from a space you moderate",
+			description: "For a moderator who is a member of the community. Revokes the placement, whether it is a membership, a request or an invitation. 409 when the space is open to all members or the placement is already revoked.",
+			params: SpaceMemberParam,
+			response: {
+				200: SpaceMember,
+				...refusals(403, 404, 409)
+			}
+		},
+		handler: async (req) => {
+			const actor = await actorOf(container, req.orgId, req.userId);
+			return container.entitlements.remove(req.orgId, actor, req.params.communityId, req.params.spaceId, req.params.orgUserId);
+		}
+	});
+}
+//#endregion
+export { memberCommunityRoutes };
+
+//# sourceMappingURL=community.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"community.js","names":[],"sources":["../../../../src/http/routes/member/community.ts"],"sourcesContent":["import type { FastifyInstance } from 'fastify';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport type { Container } from '../../../app/container.js';\nimport { NotFoundError } from '@headless-lms/core/shared/errors';\nimport { actorOf } from './actor.js';\nimport {\n  CommunityHome,\n  CommunityHomeSpace,\n  CommunityParam,\n  CommunitySpaceParam,\n  DirectoryPage,\n  DirectoryQuery,\n  OrgUserBody,\n  PageQuery,\n  SpaceMember,\n  SpaceMemberParam,\n  SpaceMembersPage,\n  refusals,\n} from '../../schemas/index.js';\n\nexport async function memberCommunityRoutes(\n  app: FastifyInstance,\n  container: Container,\n): Promise<void> {\n  const r = app.withTypeProvider<ZodTypeProvider>();\n  const tags = ['Communities'];\n\n  r.route({\n    method: 'GET',\n    url: '/api/member/communities/:communityId/home',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'getMemberCommunityHome',\n      tags,\n      summary: 'The spaces a member can see in a community',\n      description:\n        \"For a member of the community. Lists its spaces in order. Spaces the viewer can open come back in full; spaces they can see but not open come back locked, with only their name, count, rule and the viewer's standing. A by-invite space the viewer is not invited to or a member of is left out. 404 when the viewer is not a member.\",\n      params: CommunityParam,\n      response: { 200: CommunityHome, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const home = await container.reporting.member.communityHome(\n        req.orgId,\n        actor,\n        req.params.communityId,\n      );\n      if (!home) {\n        throw new NotFoundError('Community', req.params.communityId);\n      }\n      return home;\n    },\n  });\n\n  r.route({\n    method: 'GET',\n    url: '/api/member/communities/:communityId/spaces/:spaceId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'getMemberSpace',\n      tags,\n      summary: 'One space as a member sees it',\n      description:\n        'For a member of the community: the space with its topics, links, settings and where the viewer stands. A space the viewer cannot open comes back locked, without its content. 404 when the viewer is not a member, the space is not in the community, or it is a by-invite space the viewer is not invited to or a member of.',\n      params: CommunitySpaceParam,\n      response: { 200: CommunityHomeSpace, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const space = await container.reporting.member.communitySpace(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n      );\n      if (!space) {\n        throw new NotFoundError('Space', req.params.spaceId);\n      }\n      return space;\n    },\n  });\n\n  r.route({\n    method: 'GET',\n    url: '/api/member/communities/:communityId/directory',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'getMemberCommunityDirectory',\n      tags,\n      summary: 'People in a community',\n      description:\n        'For a member of the community: everyone who holds it, with their public profile. 404 when the viewer is not a member.',\n      params: CommunityParam,\n      querystring: DirectoryQuery,\n      response: { 200: DirectoryPage, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const page = await container.reporting.member.directory(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.query,\n      );\n      if (!page) {\n        throw new NotFoundError('Community', req.params.communityId);\n      }\n      return page;\n    },\n  });\n\n  r.route({\n    method: 'GET',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/members',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listSpaceMembers',\n      tags,\n      summary: 'List the members of a space',\n      description:\n        'For anyone who can open the space. Members see the active members; moderators also see open requests and invitations.',\n      params: CommunitySpaceParam,\n      querystring: PageQuery,\n      response: { 200: SpaceMembersPage, ...refusals(403, 404) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return container.entitlements.listSpaceMembers(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n        req.query,\n      );\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/requests',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'requestSpaceMembership',\n      tags,\n      summary: 'Ask to join a space',\n      description:\n        'For a member of the community who is not staff. Opens a request on a `by_request` space for a moderator to approve. 409 when the space is not `by_request` or you are already placed in it.',\n      params: CommunitySpaceParam,\n      response: { 201: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const member = await container.entitlements.requestJoin(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n      );\n      return reply.code(201).send(member);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/invites',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'inviteSpaceMember',\n      tags,\n      summary: 'Invite a person into a space you moderate',\n      description:\n        'For a moderator who is a member of the community. Invites another member into a `by_invite` space; they join when they accept. 403 when the person is staff or does not hold the community; 409 when the space is not invite-only or the person is already placed.',\n      params: CommunitySpaceParam,\n      body: OrgUserBody,\n      response: { 201: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const member = await container.entitlements.invite(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n        req.body.orgUserId,\n      );\n      return reply.code(201).send(member);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/members',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'addSpaceMember',\n      tags,\n      summary: 'Add a person to a space you moderate',\n      description:\n        'For a moderator who is a member of the community. Places another member straight into the space, with no request or invitation. 409 when the space is open to all members, the person is already placed, or the space is full.',\n      params: CommunitySpaceParam,\n      body: OrgUserBody,\n      response: { 201: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req, reply) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      const member = await container.entitlements.addSpaceMember(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n        req.body.orgUserId,\n      );\n      return reply.code(201).send(member);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/acceptance',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'acceptSpaceInvite',\n      tags,\n      summary: 'Accept your invitation to a space',\n      description:\n        'For a member of the community who is not staff. Makes you an active member. 409 when you have no open invitation, are already a member, or the space is full.',\n      params: CommunitySpaceParam,\n      response: { 200: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return container.entitlements.accept(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n      );\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/members/:orgUserId/approval',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'approveSpaceRequest',\n      tags,\n      summary: \"Approve a person's request to join a space you moderate\",\n      description:\n        'For a moderator who is a member of the community. Makes the requester an active member. 404 when the person has no open request; 409 when the space is full or they are already a member.',\n      params: SpaceMemberParam,\n      response: { 200: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return container.entitlements.approve(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n        req.params.orgUserId,\n      );\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/members/:orgUserId/decline',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'declineSpaceRequest',\n      tags,\n      summary: \"Decline a person's request to join a space you moderate\",\n      description:\n        'For a moderator who is a member of the community. Closes the open request. 404 when the person has no open request; 409 when they are already a member.',\n      params: SpaceMemberParam,\n      response: { 200: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return container.entitlements.decline(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n        req.params.orgUserId,\n      );\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/refusal',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'refuseSpaceInvite',\n      tags,\n      summary: 'Refuse your invitation to a space',\n      description:\n        'For a member of the community who is not staff. 409 when you have no open invitation or are already a member.',\n      params: CommunitySpaceParam,\n      response: { 200: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return container.entitlements.refuse(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n      );\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/departure',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'leaveSpace',\n      tags,\n      summary: 'Leave a space',\n      description:\n        'For a member of the community who is not staff. 409 when you are not a member of the space.',\n      params: CommunitySpaceParam,\n      response: { 200: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return container.entitlements.leave(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n      );\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/member/communities/:communityId/spaces/:spaceId/members/:orgUserId/removal',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'removeSpaceMember',\n      tags,\n      summary: 'Remove a person from a space you moderate',\n      description:\n        'For a moderator who is a member of the community. Revokes the placement, whether it is a membership, a request or an invitation. 409 when the space is open to all members or the placement is already revoked.',\n      params: SpaceMemberParam,\n      response: { 200: SpaceMember, ...refusals(403, 404, 409) },\n    },\n    handler: async (req) => {\n      const actor = await actorOf(container, req.orgId, req.userId);\n      return container.entitlements.remove(\n        req.orgId,\n        actor,\n        req.params.communityId,\n        req.params.spaceId,\n        req.params.orgUserId,\n      );\n    },\n  });\n}\n"],"mappings":"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"}

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

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

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

@@ -0,0 +1,101 @@
+import { refusals } from "../../schemas/shared.js";
+import { Course } from "../../schemas/content.js";
+import { ActivityList } from "../../schemas/activities.js";
+import { MemberCourseIdParam, MemberCourses, MemberModules } from "../../schemas/member.js";
+import "../../schemas/index.js";
+import { actorOf } from "./actor.js";
+import { NotFoundError } from "@headless-lms/core/shared/errors";
+//#region src/http/routes/member/courses.ts
+async function memberCoursesRoutes(app, container) {
+	const r = app.withTypeProvider();
+	const member = container.reporting.member;
+	r.route({
+		method: "GET",
+		url: "/api/member/courses",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listMemberCourses",
+			tags: ["Content"],
+			summary: "List the courses you can open",
+			description: "For a member of the organization. Published courses you hold, directly or through a bundle.",
+			response: {
+				200: MemberCourses,
+				...refusals(403)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			return member.listCourses(req.orgId, orgUser.id);
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/member/courses/:courseId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "getMemberCourse",
+			tags: ["Content"],
+			summary: "Get one course you can open",
+			description: "For a member of the organization. 404 when the course is not published or you do not hold it.",
+			params: MemberCourseIdParam,
+			response: {
+				200: Course,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			const course = await member.getCourse(req.orgId, orgUser.id, req.params.courseId);
+			if (!course) throw new NotFoundError("Course", req.params.courseId);
+			return course;
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/member/courses/:courseId/modules",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listMemberModules",
+			tags: ["Content"],
+			summary: "List the modules and activities of a course you can open",
+			description: "For a member of the organization. Published activities only. 404 when the course is not published or you do not hold it.",
+			params: MemberCourseIdParam,
+			response: {
+				200: MemberModules,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			const modules = await member.listModules(req.orgId, orgUser.id, req.params.courseId);
+			if (!modules) throw new NotFoundError("Course", req.params.courseId);
+			return modules;
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/member/courses/:courseId/activities",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listMemberActivities",
+			tags: ["Content"],
+			summary: "List the published activities of a course you can open",
+			description: "For a member of the organization. 404 when the course is not published or you do not hold it.",
+			params: MemberCourseIdParam,
+			response: {
+				200: ActivityList,
+				...refusals(403, 404)
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await actorOf(container, req.orgId, req.userId);
+			const activities = await member.listActivities(req.orgId, orgUser.id, req.params.courseId);
+			if (!activities) throw new NotFoundError("Course", req.params.courseId);
+			return activities;
+		}
+	});
+}
+//#endregion
+export { memberCoursesRoutes };
+
+//# sourceMappingURL=courses.js.map