@headless-lms/server 0.1.0

package/dist/http/routes/discussion.js

@@ -0,0 +1,122 @@
+import { ErrorBody } from "../schemas/shared.js";
+import { Comment, CommentIdParam, CommentView, CommentsPage, CommentsQuery, PatchComment, ReplyToComment } from "../schemas/discussion.js";
+import "../schemas/index.js";
+import { NotFoundError } from "@headless-lms/core/shared/errors";
+import { z } from "zod";
+//#region src/http/routes/discussion.ts
+async function discussionRoutes(app, container) {
+	const r = app.withTypeProvider();
+	const discussion = container.discussion;
+	r.route({
+		method: "GET",
+		url: "/api/comments",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listComments",
+			tags: ["Discussion"],
+			summary: "List comments, filtered by course, activity, author, status or reports",
+			querystring: CommentsQuery,
+			response: { 200: CommentsPage }
+		},
+		handler: async (req) => {
+			return discussion.listComments(req.orgId, req.query);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/comments/:commentId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "moderateRemoveComment",
+			tags: ["Discussion"],
+			summary: "Remove a comment as a moderator",
+			params: CommentIdParam,
+			response: {
+				200: Comment,
+				403: ErrorBody,
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);
+			return discussion.remove(req.orgId, req.params.commentId, orgUser);
+		}
+	});
+	r.route({
+		method: "PATCH",
+		url: "/api/comments/:commentId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "editComment",
+			tags: ["Discussion"],
+			summary: "Publish a comment: approves a pending one, restores a removed one",
+			params: CommentIdParam,
+			body: PatchComment,
+			response: {
+				200: Comment,
+				403: ErrorBody,
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);
+			if (!orgUser) throw new NotFoundError("OrgUser", req.userId);
+			return discussion.publish(req.orgId, req.params.commentId, orgUser);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/comments/:commentId/reports",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "dismissCommentReports",
+			tags: ["Discussion"],
+			summary: "Dismiss every open report on a comment",
+			params: CommentIdParam,
+			response: {
+				204: z.void(),
+				403: ErrorBody,
+				404: ErrorBody
+			}
+		},
+		handler: async (req, reply) => {
+			const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);
+			if (!orgUser) throw new NotFoundError("OrgUser", req.userId);
+			await discussion.resolveReports(req.orgId, req.params.commentId, orgUser);
+			return reply.code(204).send();
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/comments/:commentId/replies",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "replyToComment",
+			tags: ["Discussion"],
+			summary: "Reply to a comment from the moderation queue",
+			params: CommentIdParam,
+			body: ReplyToComment,
+			response: {
+				200: CommentView,
+				403: ErrorBody,
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);
+			if (!orgUser) throw new NotFoundError("OrgUser", req.userId);
+			const parent = await discussion.getComment(req.orgId, req.params.commentId);
+			if (!parent) throw new NotFoundError("Comment", req.params.commentId);
+			return discussion.postComment(req.orgId, {
+				actor: orgUser,
+				activityId: parent.activityId,
+				parentId: parent.parentId ?? parent.id,
+				body: req.body.body
+			});
+		}
+	});
+}
+//#endregion
+export { discussionRoutes };
+
+//# sourceMappingURL=discussion.js.map

package/dist/http/routes/discussion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussion.js","names":[],"sources":["../../../src/http/routes/discussion.ts"],"sourcesContent":["// Moderator-facing discussion routes. The learner surface (everything under\n// `/api/learn`) lives in routes/learn/comments.ts.\nimport type { FastifyInstance } from 'fastify';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport { z } from 'zod';\nimport {\n  Comment,\n  CommentIdParam,\n  CommentsPage,\n  CommentsQuery,\n  CommentView,\n  ErrorBody,\n  PatchComment,\n  ReplyToComment,\n} from '../schemas/index.js';\nimport { NotFoundError } from '@headless-lms/core/shared/errors';\nimport type { Container } from '../../app/container.js';\n\nexport async function discussionRoutes(app: FastifyInstance, container: Container): Promise<void> {\n  const r = app.withTypeProvider<ZodTypeProvider>();\n  const discussion = container.discussion;\n\n  r.route({\n    method: 'GET',\n    url: '/api/comments',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listComments',\n      tags: ['Discussion'],\n      summary: 'List comments, filtered by course, activity, author, status or reports',\n      querystring: CommentsQuery,\n      response: { 200: CommentsPage },\n    },\n    handler: async (req) => {\n      return discussion.listComments(req.orgId, req.query);\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/comments/:commentId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'moderateRemoveComment',\n      tags: ['Discussion'],\n      summary: 'Remove a comment as a moderator',\n      params: CommentIdParam,\n      response: { 200: Comment, 403: ErrorBody, 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);\n      return discussion.remove(req.orgId, req.params.commentId, orgUser!);\n    },\n  });\n\n  r.route({\n    method: 'PATCH',\n    url: '/api/comments/:commentId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'editComment',\n      tags: ['Discussion'],\n      summary: 'Publish a comment: approves a pending one, restores a removed one',\n      params: CommentIdParam,\n      body: PatchComment,\n      response: { 200: Comment, 403: ErrorBody, 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);\n      if (!orgUser) {\n        throw new NotFoundError('OrgUser', req.userId);\n      }\n      return discussion.publish(req.orgId, req.params.commentId, orgUser);\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/comments/:commentId/reports',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'dismissCommentReports',\n      tags: ['Discussion'],\n      summary: 'Dismiss every open report on a comment',\n      params: CommentIdParam,\n      response: { 204: z.void(), 403: ErrorBody, 404: ErrorBody },\n    },\n    handler: async (req, reply) => {\n      const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);\n      if (!orgUser) {\n        throw new NotFoundError('OrgUser', req.userId);\n      }\n      await discussion.resolveReports(req.orgId, req.params.commentId, orgUser);\n      return reply.code(204).send();\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/comments/:commentId/replies',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'replyToComment',\n      tags: ['Discussion'],\n      summary: 'Reply to a comment from the moderation queue',\n      params: CommentIdParam,\n      body: ReplyToComment,\n      response: { 200: CommentView, 403: ErrorBody, 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const orgUser = await container.organizations.getOrgUser(req.orgId, req.userId);\n      if (!orgUser) {\n        throw new NotFoundError('OrgUser', req.userId);\n      }\n      const parent = await discussion.getComment(req.orgId, req.params.commentId);\n      if (!parent) {\n        throw new NotFoundError('Comment', req.params.commentId);\n      }\n      // Replies nest one level: answering a reply attaches to its root.\n      return discussion.postComment(req.orgId, {\n        actor: orgUser,\n        activityId: parent.activityId,\n        parentId: parent.parentId ?? parent.id,\n        body: req.body.body,\n      });\n    },\n  });\n}\n"],"mappings":";;;;;;AAkBA,eAAsB,iBAAiB,KAAsB,WAAqC;CAChG,MAAM,IAAI,IAAI,iBAAkC;CAChD,MAAM,aAAa,UAAU;CAE7B,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,YAAY;GACnB,SAAS;GACT,aAAa;GACb,UAAU,EAAE,KAAK,aAAa;EAChC;EACA,SAAS,OAAO,QAAQ;GACtB,OAAO,WAAW,aAAa,IAAI,OAAO,IAAI,KAAK;EACrD;CACF,CAAC;CAED,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,YAAY;GACnB,SAAS;GACT,QAAQ;GACR,UAAU;IAAE,KAAK;IAAS,KAAK;IAAW,KAAK;GAAU;EAC3D;EACA,SAAS,OAAO,QAAQ;GACtB,MAAM,UAAU,MAAM,UAAU,cAAc,WAAW,IAAI,OAAO,IAAI,MAAM;GAC9E,OAAO,WAAW,OAAO,IAAI,OAAO,IAAI,OAAO,WAAW,OAAQ;EACpE;CACF,CAAC;CAED,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,YAAY;GACnB,SAAS;GACT,QAAQ;GACR,MAAM;GACN,UAAU;IAAE,KAAK;IAAS,KAAK;IAAW,KAAK;GAAU;EAC3D;EACA,SAAS,OAAO,QAAQ;GACtB,MAAM,UAAU,MAAM,UAAU,cAAc,WAAW,IAAI,OAAO,IAAI,MAAM;GAC9E,IAAI,CAAC,SACH,MAAM,IAAI,cAAc,WAAW,IAAI,MAAM;GAE/C,OAAO,WAAW,QAAQ,IAAI,OAAO,IAAI,OAAO,WAAW,OAAO;EACpE;CACF,CAAC;CAED,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,YAAY;GACnB,SAAS;GACT,QAAQ;GACR,UAAU;IAAE,KAAK,EAAE,KAAK;IAAG,KAAK;IAAW,KAAK;GAAU;EAC5D;EACA,SAAS,OAAO,KAAK,UAAU;GAC7B,MAAM,UAAU,MAAM,UAAU,cAAc,WAAW,IAAI,OAAO,IAAI,MAAM;GAC9E,IAAI,CAAC,SACH,MAAM,IAAI,cAAc,WAAW,IAAI,MAAM;GAE/C,MAAM,WAAW,eAAe,IAAI,OAAO,IAAI,OAAO,WAAW,OAAO;GACxE,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK;EAC9B;CACF,CAAC;CAED,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,YAAY;GACnB,SAAS;GACT,QAAQ;GACR,MAAM;GACN,UAAU;IAAE,KAAK;IAAa,KAAK;IAAW,KAAK;GAAU;EAC/D;EACA,SAAS,OAAO,QAAQ;GACtB,MAAM,UAAU,MAAM,UAAU,cAAc,WAAW,IAAI,OAAO,IAAI,MAAM;GAC9E,IAAI,CAAC,SACH,MAAM,IAAI,cAAc,WAAW,IAAI,MAAM;GAE/C,MAAM,SAAS,MAAM,WAAW,WAAW,IAAI,OAAO,IAAI,OAAO,SAAS;GAC1E,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,WAAW,IAAI,OAAO,SAAS;GAGzD,OAAO,WAAW,YAAY,IAAI,OAAO;IACvC,OAAO;IACP,YAAY,OAAO;IACnB,UAAU,OAAO,YAAY,OAAO;IACpC,MAAM,IAAI,KAAK;GACjB,CAAC;EACH;CACF,CAAC;AACH"}

package/dist/http/routes/downloads.d.ts

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

package/dist/http/routes/downloads.js

@@ -0,0 +1,208 @@
+import { resolveScope } from "../scope.js";
+import { ErrorBody } from "../schemas/shared.js";
+import { AddDownloadAsset, CreateDownload, Download, DownloadAsset, DownloadAssetParams, DownloadIdParam, DownloadsPage, DownloadsQuery, RenameDownloadAsset, ReorderDownloadAssets, UpdateDownload } from "../schemas/downloads.js";
+import "../schemas/index.js";
+import { NotFoundError } from "@headless-lms/core/shared/errors";
+import { z } from "zod";
+//#region src/http/routes/downloads.ts
+async function downloadsRoutes(app, container) {
+	const r = app.withTypeProvider();
+	const content = container.content;
+	r.route({
+		method: "GET",
+		url: "/api/downloads",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listDownloads",
+			tags: ["Downloads"],
+			summary: "List downloads",
+			querystring: DownloadsQuery,
+			response: { 200: DownloadsPage }
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return content.listDownloads(scope.orgId, req.query);
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/downloads/:downloadId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "getDownload",
+			tags: ["Downloads"],
+			summary: "Get a download by id",
+			params: DownloadIdParam,
+			response: {
+				200: Download,
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			const download = await content.getDownload(scope.orgId, req.params.downloadId);
+			if (!download) throw new NotFoundError("Download", req.params.downloadId);
+			return download;
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/downloads",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "createDownload",
+			tags: ["Downloads"],
+			summary: "Create a download",
+			body: CreateDownload,
+			response: { 201: Download }
+		},
+		handler: async (req, reply) => {
+			const scope = await resolveScope(container, req);
+			const download = await content.createDownload(scope.orgId, req.body);
+			return reply.code(201).send(download);
+		}
+	});
+	r.route({
+		method: "PATCH",
+		url: "/api/downloads/:downloadId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "updateDownload",
+			tags: ["Downloads"],
+			summary: "Update a download",
+			params: DownloadIdParam,
+			body: UpdateDownload,
+			response: {
+				200: Download,
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return content.updateDownload(scope.orgId, req.params.downloadId, req.body);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/downloads/:downloadId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "deleteDownload",
+			tags: ["Downloads"],
+			summary: "Delete a download",
+			params: DownloadIdParam,
+			response: {
+				204: z.void(),
+				404: ErrorBody
+			}
+		},
+		handler: async (req, reply) => {
+			const scope = await resolveScope(container, req);
+			await content.removeDownload(scope.orgId, req.params.downloadId);
+			return reply.code(204).send();
+		}
+	});
+	r.route({
+		method: "GET",
+		url: "/api/downloads/:downloadId/assets",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listDownloadAssets",
+			tags: ["Downloads"],
+			summary: "List a download's assets in order",
+			params: DownloadIdParam,
+			response: {
+				200: z.array(DownloadAsset),
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return content.listDownloadAssets(scope.orgId, req.params.downloadId);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/downloads/:downloadId/assets",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "addDownloadAsset",
+			tags: ["Downloads"],
+			summary: "Link a media-library asset to a download",
+			params: DownloadIdParam,
+			body: AddDownloadAsset,
+			response: {
+				200: z.array(DownloadAsset),
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return content.addDownloadAsset(scope.orgId, req.params.downloadId, req.body);
+		}
+	});
+	r.route({
+		method: "PUT",
+		url: "/api/downloads/:downloadId/assets/order",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "reorderDownloadAssets",
+			tags: ["Downloads"],
+			summary: "Reorder a download's assets (send the complete set)",
+			params: DownloadIdParam,
+			body: ReorderDownloadAssets,
+			response: {
+				200: z.array(DownloadAsset),
+				404: ErrorBody,
+				409: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return content.reorderDownloadAssets(scope.orgId, req.params.downloadId, req.body.assetIds);
+		}
+	});
+	r.route({
+		method: "PATCH",
+		url: "/api/downloads/:downloadId/assets/:assetId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "renameDownloadAsset",
+			tags: ["Downloads"],
+			summary: "Set an asset's display name within a download",
+			params: DownloadAssetParams,
+			body: RenameDownloadAsset,
+			response: {
+				200: z.array(DownloadAsset),
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return content.renameDownloadAsset(scope.orgId, req.params.downloadId, req.params.assetId, req.body.displayName);
+		}
+	});
+	r.route({
+		method: "DELETE",
+		url: "/api/downloads/:downloadId/assets/:assetId",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "removeDownloadAsset",
+			tags: ["Downloads"],
+			summary: "Unlink an asset from a download (the asset itself survives)",
+			params: DownloadAssetParams,
+			response: {
+				200: z.array(DownloadAsset),
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return content.removeDownloadAsset(scope.orgId, req.params.downloadId, req.params.assetId);
+		}
+	});
+}
+//#endregion
+export { downloadsRoutes };
+
+//# sourceMappingURL=downloads.js.map

package/dist/http/routes/downloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.js","names":[],"sources":["../../../src/http/routes/downloads.ts"],"sourcesContent":["// HTTP routes for the download content type. Request + response are validated\n// against the shared contract schemas by the Zod type provider, and\n// @fastify/swagger reads the same schemas to build the OpenAPI spec.\nimport type { FastifyInstance } from 'fastify';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport {\n  AddDownloadAsset,\n  Download,\n  DownloadAsset,\n  DownloadAssetParams,\n  DownloadIdParam,\n  DownloadsPage,\n  DownloadsQuery,\n  CreateDownload,\n  ErrorBody,\n  RenameDownloadAsset,\n  ReorderDownloadAssets,\n  UpdateDownload,\n} from '../schemas/index.js';\nimport { z } from 'zod';\nimport type { Container } from '../../app/container.js';\nimport { NotFoundError } from '@headless-lms/core/shared/errors';\nimport { resolveScope } from '../scope.js';\n\nexport async function downloadsRoutes(app: FastifyInstance, container: Container): Promise<void> {\n  const r = app.withTypeProvider<ZodTypeProvider>();\n  const content = container.content;\n\n  r.route({\n    method: 'GET',\n    url: '/api/downloads',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listDownloads',\n      tags: ['Downloads'],\n      summary: 'List downloads',\n      querystring: DownloadsQuery,\n      response: { 200: DownloadsPage },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return content.listDownloads(scope.orgId, req.query);\n    },\n  });\n\n  r.route({\n    method: 'GET',\n    url: '/api/downloads/:downloadId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'getDownload',\n      tags: ['Downloads'],\n      summary: 'Get a download by id',\n      params: DownloadIdParam,\n      response: { 200: Download, 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      const download = await content.getDownload(scope.orgId, req.params.downloadId);\n      if (!download) {\n        throw new NotFoundError('Download', req.params.downloadId);\n      }\n      return download;\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/downloads',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'createDownload',\n      tags: ['Downloads'],\n      summary: 'Create a download',\n      body: CreateDownload,\n      response: { 201: Download },\n    },\n    handler: async (req, reply) => {\n      const scope = await resolveScope(container, req);\n      const download = await content.createDownload(scope.orgId, req.body);\n      return reply.code(201).send(download);\n    },\n  });\n\n  r.route({\n    method: 'PATCH',\n    url: '/api/downloads/:downloadId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'updateDownload',\n      tags: ['Downloads'],\n      summary: 'Update a download',\n      params: DownloadIdParam,\n      body: UpdateDownload,\n      response: { 200: Download, 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return content.updateDownload(scope.orgId, req.params.downloadId, req.body);\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/downloads/:downloadId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'deleteDownload',\n      tags: ['Downloads'],\n      summary: 'Delete a download',\n      params: DownloadIdParam,\n      response: { 204: z.void(), 404: ErrorBody },\n    },\n    handler: async (req, reply) => {\n      const scope = await resolveScope(container, req);\n      await content.removeDownload(scope.orgId, req.params.downloadId);\n      return reply.code(204).send();\n    },\n  });\n\n  r.route({\n    method: 'GET',\n    url: '/api/downloads/:downloadId/assets',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listDownloadAssets',\n      tags: ['Downloads'],\n      summary: \"List a download's assets in order\",\n      params: DownloadIdParam,\n      response: { 200: z.array(DownloadAsset), 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return content.listDownloadAssets(scope.orgId, req.params.downloadId);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/downloads/:downloadId/assets',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'addDownloadAsset',\n      tags: ['Downloads'],\n      summary: 'Link a media-library asset to a download',\n      params: DownloadIdParam,\n      body: AddDownloadAsset,\n      response: { 200: z.array(DownloadAsset), 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return content.addDownloadAsset(scope.orgId, req.params.downloadId, req.body);\n    },\n  });\n\n  // Static segment before the parameterised sibling. Fastify's radix router\n  // prefers static either way; the ordering documents the intent.\n  r.route({\n    method: 'PUT',\n    url: '/api/downloads/:downloadId/assets/order',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'reorderDownloadAssets',\n      tags: ['Downloads'],\n      summary: \"Reorder a download's assets (send the complete set)\",\n      params: DownloadIdParam,\n      body: ReorderDownloadAssets,\n      response: { 200: z.array(DownloadAsset), 404: ErrorBody, 409: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return content.reorderDownloadAssets(\n        scope.orgId,\n        req.params.downloadId,\n        req.body.assetIds,\n      );\n    },\n  });\n\n  r.route({\n    method: 'PATCH',\n    url: '/api/downloads/:downloadId/assets/:assetId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'renameDownloadAsset',\n      tags: ['Downloads'],\n      summary: \"Set an asset's display name within a download\",\n      params: DownloadAssetParams,\n      body: RenameDownloadAsset,\n      response: { 200: z.array(DownloadAsset), 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return content.renameDownloadAsset(\n        scope.orgId,\n        req.params.downloadId,\n        req.params.assetId,\n        req.body.displayName,\n      );\n    },\n  });\n\n  r.route({\n    method: 'DELETE',\n    url: '/api/downloads/:downloadId/assets/:assetId',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'removeDownloadAsset',\n      tags: ['Downloads'],\n      summary: 'Unlink an asset from a download (the asset itself survives)',\n      params: DownloadAssetParams,\n      response: { 200: z.array(DownloadAsset), 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return content.removeDownloadAsset(\n        scope.orgId,\n        req.params.downloadId,\n        req.params.assetId,\n      );\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/http/routes/entitlements.d.ts

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

package/dist/http/routes/entitlements.js

@@ -0,0 +1,69 @@
+import { resolveScope } from "../scope.js";
+import { ErrorBody } from "../schemas/shared.js";
+import { Entitlement, EntitlementIdParam, EntitlementsPage, EntitlementsQuery, GrantEntitlement, SetEntitlementStatus } from "../schemas/entitlements.js";
+import "../schemas/index.js";
+import { NotFoundError } from "@headless-lms/core/shared/errors";
+//#region src/http/routes/entitlements.ts
+async function entitlementsRoutes(app, container) {
+	const r = app.withTypeProvider();
+	const entitlements = container.entitlements;
+	r.route({
+		method: "GET",
+		url: "/api/entitlements",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "listEntitlements",
+			tags: ["Entitlements"],
+			summary: "List entitlements",
+			querystring: EntitlementsQuery,
+			response: { 200: EntitlementsPage }
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			return entitlements.list(scope.orgId, req.query);
+		}
+	});
+	r.route({
+		method: "POST",
+		url: "/api/entitlements",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "grantEntitlement",
+			tags: ["Entitlements"],
+			summary: "Grant a student access to a piece of content",
+			body: GrantEntitlement,
+			response: { 201: Entitlement }
+		},
+		handler: async (req, reply) => {
+			const scope = await resolveScope(container, req);
+			const entitlement = await entitlements.grant(scope.orgId, req.body);
+			return reply.code(201).send(entitlement);
+		}
+	});
+	r.route({
+		method: "PATCH",
+		url: "/api/entitlements/:id",
+		preHandler: app.requireOrgSession,
+		schema: {
+			operationId: "setEntitlementStatus",
+			tags: ["Entitlements"],
+			summary: "Revoke or reinstate an entitlement",
+			params: EntitlementIdParam,
+			body: SetEntitlementStatus,
+			response: {
+				200: Entitlement,
+				404: ErrorBody
+			}
+		},
+		handler: async (req) => {
+			const scope = await resolveScope(container, req);
+			const entitlement = await entitlements.setStatus(scope.orgId, req.params.id, req.body.status);
+			if (!entitlement) throw new NotFoundError("Entitlement", req.params.id);
+			return entitlement;
+		}
+	});
+}
+//#endregion
+export { entitlementsRoutes };
+
+//# sourceMappingURL=entitlements.js.map

package/dist/http/routes/entitlements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.js","names":[],"sources":["../../../src/http/routes/entitlements.ts"],"sourcesContent":["// HTTP routes for the entitlements context (a student's access grant to a piece of content).\nimport type { FastifyInstance } from 'fastify';\nimport type { ZodTypeProvider } from 'fastify-type-provider-zod';\nimport {\n  Entitlement,\n  EntitlementIdParam,\n  EntitlementsPage,\n  EntitlementsQuery,\n  ErrorBody,\n  GrantEntitlement,\n  SetEntitlementStatus,\n} from '../schemas/index.js';\nimport { NotFoundError } from '@headless-lms/core/shared/errors';\nimport type { Container } from '../../app/container.js';\nimport { resolveScope } from '../scope.js';\n\nexport async function entitlementsRoutes(\n  app: FastifyInstance,\n  container: Container,\n): Promise<void> {\n  const r = app.withTypeProvider<ZodTypeProvider>();\n  const entitlements = container.entitlements;\n\n  r.route({\n    method: 'GET',\n    url: '/api/entitlements',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'listEntitlements',\n      tags: ['Entitlements'],\n      summary: 'List entitlements',\n      querystring: EntitlementsQuery,\n      response: { 200: EntitlementsPage },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      return entitlements.list(scope.orgId, req.query);\n    },\n  });\n\n  r.route({\n    method: 'POST',\n    url: '/api/entitlements',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'grantEntitlement',\n      tags: ['Entitlements'],\n      summary: 'Grant a student access to a piece of content',\n      body: GrantEntitlement,\n      response: { 201: Entitlement },\n    },\n    handler: async (req, reply) => {\n      const scope = await resolveScope(container, req);\n      const entitlement = await entitlements.grant(scope.orgId, req.body);\n      return reply.code(201).send(entitlement);\n    },\n  });\n\n  r.route({\n    method: 'PATCH',\n    url: '/api/entitlements/:id',\n    preHandler: app.requireOrgSession,\n    schema: {\n      operationId: 'setEntitlementStatus',\n      tags: ['Entitlements'],\n      summary: 'Revoke or reinstate an entitlement',\n      params: EntitlementIdParam,\n      body: SetEntitlementStatus,\n      response: { 200: Entitlement, 404: ErrorBody },\n    },\n    handler: async (req) => {\n      const scope = await resolveScope(container, req);\n      const entitlement = await entitlements.setStatus(scope.orgId, req.params.id, req.body.status);\n      if (!entitlement) {\n        throw new NotFoundError('Entitlement', req.params.id);\n      }\n      return entitlement;\n    },\n  });\n}\n"],"mappings":";;;;;;AAgBA,eAAsB,mBACpB,KACA,WACe;CACf,MAAM,IAAI,IAAI,iBAAkC;CAChD,MAAM,eAAe,UAAU;CAE/B,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,cAAc;GACrB,SAAS;GACT,aAAa;GACb,UAAU,EAAE,KAAK,iBAAiB;EACpC;EACA,SAAS,OAAO,QAAQ;GACtB,MAAM,QAAQ,MAAM,aAAa,WAAW,GAAG;GAC/C,OAAO,aAAa,KAAK,MAAM,OAAO,IAAI,KAAK;EACjD;CACF,CAAC;CAED,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,cAAc;GACrB,SAAS;GACT,MAAM;GACN,UAAU,EAAE,KAAK,YAAY;EAC/B;EACA,SAAS,OAAO,KAAK,UAAU;GAC7B,MAAM,QAAQ,MAAM,aAAa,WAAW,GAAG;GAC/C,MAAM,cAAc,MAAM,aAAa,MAAM,MAAM,OAAO,IAAI,IAAI;GAClE,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,WAAW;EACzC;CACF,CAAC;CAED,EAAE,MAAM;EACN,QAAQ;EACR,KAAK;EACL,YAAY,IAAI;EAChB,QAAQ;GACN,aAAa;GACb,MAAM,CAAC,cAAc;GACrB,SAAS;GACT,QAAQ;GACR,MAAM;GACN,UAAU;IAAE,KAAK;IAAa,KAAK;GAAU;EAC/C;EACA,SAAS,OAAO,QAAQ;GACtB,MAAM,QAAQ,MAAM,aAAa,WAAW,GAAG;GAC/C,MAAM,cAAc,MAAM,aAAa,UAAU,MAAM,OAAO,IAAI,OAAO,IAAI,IAAI,KAAK,MAAM;GAC5F,IAAI,CAAC,aACH,MAAM,IAAI,cAAc,eAAe,IAAI,OAAO,EAAE;GAEtD,OAAO;EACT;CACF,CAAC;AACH"}

package/dist/http/routes/identity.d.ts

@@ -0,0 +1,6 @@
+import { FastifyInstance } from "fastify";
+//#region src/http/routes/identity.d.ts
+declare function identityRoutes(_app: FastifyInstance): Promise<void>;
+//#endregion
+export { identityRoutes };
+//# sourceMappingURL=identity.d.ts.map

package/dist/http/routes/identity.js

@@ -0,0 +1,6 @@
+//#region src/http/routes/identity.ts
+async function identityRoutes(_app) {}
+//#endregion
+export { identityRoutes };
+
+//# sourceMappingURL=identity.js.map

package/dist/http/routes/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","names":[],"sources":["../../../src/http/routes/identity.ts"],"sourcesContent":["// HTTP routes for the identity context. Stub.\nimport type { FastifyInstance } from 'fastify';\n\nexport async function identityRoutes(_app: FastifyInstance): Promise<void> {\n  // register identity routes here\n}\n"],"mappings":";AAGA,eAAsB,eAAe,MAAsC,CAE3E"}

package/dist/http/routes/integrations.d.ts

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