@headless-lms/server 0.1.0

package/dist/http/schemas/dashboard.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+//#region src/http/schemas/dashboard.d.ts
+declare const OverviewStats: z.ZodObject<{
+  publishedCourses: z.ZodNumber;
+  draftCourses: z.ZodNumber;
+  activeStudents: z.ZodNumber;
+  expiringSoon: z.ZodNumber;
+}, z.core.$strip>;
+type OverviewStats = z.infer<typeof OverviewStats>;
+declare const EnrollmentPoint: z.ZodObject<{
+  date: z.ZodString;
+  count: z.ZodNumber;
+}, z.core.$strip>;
+type EnrollmentPoint = z.infer<typeof EnrollmentPoint>;
+declare const EnrollmentSeries: z.ZodArray<z.ZodObject<{
+  date: z.ZodString;
+  count: z.ZodNumber;
+}, z.core.$strip>>;
+type EnrollmentSeries = z.infer<typeof EnrollmentSeries>;
+declare const EnrollmentSeriesQuery: z.ZodObject<{
+  days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+type EnrollmentSeriesQuery = z.infer<typeof EnrollmentSeriesQuery>;
+//#endregion
+export { EnrollmentPoint, EnrollmentSeries, EnrollmentSeriesQuery, OverviewStats };
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/http/schemas/dashboard.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+//#region src/http/schemas/dashboard.ts
+const OverviewStats = z.object({
+	publishedCourses: z.number().int(),
+	draftCourses: z.number().int(),
+	activeStudents: z.number().int(),
+	expiringSoon: z.number().int()
+});
+const EnrollmentPoint = z.object({
+	date: z.string(),
+	count: z.number().int()
+});
+const EnrollmentSeries = z.array(EnrollmentPoint);
+const EnrollmentSeriesQuery = z.object({ days: z.coerce.number().int().min(1).max(365).default(30) });
+//#endregion
+export { EnrollmentPoint, EnrollmentSeries, EnrollmentSeriesQuery, OverviewStats };
+
+//# sourceMappingURL=dashboard.js.map

package/dist/http/schemas/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","names":[],"sources":["../../../src/http/schemas/dashboard.ts"],"sourcesContent":["// Dashboard / overview resource schemas.\nimport { z } from \"zod\";\n\nexport const OverviewStats = z.object({\n  publishedCourses: z.number().int(),\n  draftCourses: z.number().int(),\n  activeStudents: z.number().int(),\n  expiringSoon: z.number().int(),\n});\nexport type OverviewStats = z.infer<typeof OverviewStats>;\n\nexport const EnrollmentPoint = z.object({\n  date: z.string(),\n  count: z.number().int(),\n});\nexport type EnrollmentPoint = z.infer<typeof EnrollmentPoint>;\n\nexport const EnrollmentSeries = z.array(EnrollmentPoint);\nexport type EnrollmentSeries = z.infer<typeof EnrollmentSeries>;\n\nexport const EnrollmentSeriesQuery = z.object({\n  days: z.coerce.number().int().min(1).max(365).default(30),\n});\nexport type EnrollmentSeriesQuery = z.infer<typeof EnrollmentSeriesQuery>;\n"],"mappings":";;AAGA,MAAa,gBAAgB,EAAE,OAAO;CACpC,kBAAkB,EAAE,OAAO,CAAC,CAAC,IAAI;CACjC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI;CAC7B,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI;CAC/B,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI;AAC/B,CAAC;AAGD,MAAa,kBAAkB,EAAE,OAAO;CACtC,MAAM,EAAE,OAAO;CACf,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI;AACxB,CAAC;AAGD,MAAa,mBAAmB,EAAE,MAAM,eAAe;AAGvD,MAAa,wBAAwB,EAAE,OAAO,EAC5C,MAAM,EAAE,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,EAC1D,CAAC"}

package/dist/http/schemas/discussion.d.ts

@@ -0,0 +1,340 @@
+import { z } from "zod";
+//#region src/http/schemas/discussion.d.ts
+declare const CommentStatus: z.ZodEnum<{
+  published: "published";
+  pending: "pending";
+  removed: "removed";
+}>;
+type CommentStatus = z.infer<typeof CommentStatus>;
+declare const CommentAuthor: z.ZodObject<{
+  id: z.ZodString;
+  firstName: z.ZodNullable<z.ZodString>;
+  lastName: z.ZodNullable<z.ZodString>;
+  image: z.ZodNullable<z.ZodString>;
+  role: z.ZodEnum<{
+    owner: "owner";
+    admin: "admin";
+    instructor: "instructor";
+    student: "student";
+  }>;
+}, z.core.$strict>;
+type CommentAuthor = z.infer<typeof CommentAuthor>;
+/** Any single emoji. Open, so widening the picker needs no schema change. */
+declare const ReactionEmoji: z.ZodString;
+type ReactionEmoji = z.infer<typeof ReactionEmoji>;
+/** Counts by emoji; unused ones are absent, so no reactions serves `{}`. */
+declare const ReactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+type ReactionCounts = z.infer<typeof ReactionCounts>;
+declare const CommentView: z.ZodObject<{
+  id: z.ZodString;
+  activityId: z.ZodString;
+  parentId: z.ZodNullable<z.ZodString>;
+  author: z.ZodObject<{
+    id: z.ZodString;
+    firstName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodNullable<z.ZodString>;
+    image: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+      owner: "owner";
+      admin: "admin";
+      instructor: "instructor";
+      student: "student";
+    }>;
+  }, z.core.$strict>;
+  body: z.ZodNullable<z.ZodString>;
+  status: z.ZodEnum<{
+    published: "published";
+    pending: "pending";
+    removed: "removed";
+  }>;
+  removedBy: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    firstName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodNullable<z.ZodString>;
+    image: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+      owner: "owner";
+      admin: "admin";
+      instructor: "instructor";
+      student: "student";
+    }>;
+  }, z.core.$strict>>;
+  reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
+  viewerReaction: z.ZodOptional<z.ZodString>;
+  createdAt: z.ZodCoercedDate<unknown>;
+  updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>;
+type CommentView = z.infer<typeof CommentView>;
+/** What the reaction write returns, so the client never recomputes a count. */
+declare const CommentReactions: z.ZodObject<{
+  reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
+  viewerReaction: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CommentReactions = z.infer<typeof CommentReactions>;
+/** A course's comment settings. Stored under the course, carried on the course
+ *  payload as `settings.comments`. */
+declare const CommentSettings: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  threaded: z.ZodBoolean;
+  requireReview: z.ZodBoolean;
+  reactions: z.ZodBoolean;
+}, z.core.$strip>;
+type CommentSettings = z.infer<typeof CommentSettings>;
+/** The course settings with the activity's override applied: `enabled` is the
+ *  resolved answer for this activity, not the course switch. */
+declare const CommentsConfig: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  threaded: z.ZodBoolean;
+  requireReview: z.ZodBoolean;
+  reactions: z.ZodBoolean;
+}, z.core.$strip>;
+type CommentsConfig = z.infer<typeof CommentsConfig>;
+declare const ActivityComments: z.ZodObject<{
+  config: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    threaded: z.ZodBoolean;
+    requireReview: z.ZodBoolean;
+    reactions: z.ZodBoolean;
+  }, z.core.$strip>;
+  comments: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    activityId: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    author: z.ZodObject<{
+      id: z.ZodString;
+      firstName: z.ZodNullable<z.ZodString>;
+      lastName: z.ZodNullable<z.ZodString>;
+      image: z.ZodNullable<z.ZodString>;
+      role: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        instructor: "instructor";
+        student: "student";
+      }>;
+    }, z.core.$strict>;
+    body: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+      published: "published";
+      pending: "pending";
+      removed: "removed";
+    }>;
+    removedBy: z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      firstName: z.ZodNullable<z.ZodString>;
+      lastName: z.ZodNullable<z.ZodString>;
+      image: z.ZodNullable<z.ZodString>;
+      role: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        instructor: "instructor";
+        student: "student";
+      }>;
+    }, z.core.$strict>>;
+    reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    viewerReaction: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+  }, z.core.$strict>>;
+}, z.core.$strip>;
+type ActivityComments = z.infer<typeof ActivityComments>;
+declare const PostComment: z.ZodObject<{
+  body: z.ZodString;
+  parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type PostComment = z.infer<typeof PostComment>;
+declare const EditComment: z.ZodObject<{
+  body: z.ZodString;
+}, z.core.$strip>;
+type EditComment = z.infer<typeof EditComment>;
+/** The staff PATCH writes status and nothing else: publishing covers approving
+ *  a pending comment and restoring a removed one. Revising the text is the
+ *  author's own edit, under /api/learn. */
+declare const PatchComment: z.ZodObject<{
+  status: z.ZodLiteral<"published">;
+}, z.core.$strip>;
+type PatchComment = z.infer<typeof PatchComment>;
+/** Replaces whatever the reader had. Clearing is DELETE, which carries no body. */
+declare const SetCommentReaction: z.ZodObject<{
+  emoji: z.ZodString;
+}, z.core.$strip>;
+type SetCommentReaction = z.infer<typeof SetCommentReaction>;
+/** A moderator's reply, posted from the queue against the comment it answers. */
+declare const ReplyToComment: z.ZodObject<{
+  body: z.ZodString;
+}, z.core.$strip>;
+type ReplyToComment = z.infer<typeof ReplyToComment>;
+declare const ReportComment: z.ZodObject<{
+  reason: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type ReportComment = z.infer<typeof ReportComment>;
+declare const Comment: z.ZodObject<{
+  id: z.ZodString;
+  orgId: z.ZodString;
+  activityId: z.ZodString;
+  parentId: z.ZodNullable<z.ZodString>;
+  orgUserId: z.ZodString;
+  body: z.ZodString;
+  status: z.ZodEnum<{
+    published: "published";
+    pending: "pending";
+    removed: "removed";
+  }>;
+  removedBy: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodCoercedDate<unknown>;
+  updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>;
+type Comment = z.infer<typeof Comment>;
+declare const CommentReport: z.ZodObject<{
+  id: z.ZodString;
+  commentId: z.ZodString;
+  orgUserId: z.ZodString;
+  reason: z.ZodString;
+  resolvedAt: z.ZodNullable<z.ZodDate>;
+  createdAt: z.ZodDate;
+}, z.core.$strip>;
+type CommentReport = z.infer<typeof CommentReport>;
+/** An unresolved report on a listed comment. Resolved ones are history and are
+ *  never served here. */
+declare const CommentReportSummary: z.ZodObject<{
+  reporter: z.ZodObject<{
+    id: z.ZodString;
+    firstName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodNullable<z.ZodString>;
+    image: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+      owner: "owner";
+      admin: "admin";
+      instructor: "instructor";
+      student: "student";
+    }>;
+  }, z.core.$strict>;
+  reason: z.ZodString;
+  createdAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>;
+type CommentReportSummary = z.infer<typeof CommentReportSummary>;
+/** One row of the staff comment list: the comment plus the context a
+ *  moderation decision needs, so the list needs no follow-up request. */
+declare const CommentListItem: z.ZodObject<{
+  id: z.ZodString;
+  parentId: z.ZodNullable<z.ZodString>;
+  activityId: z.ZodString;
+  activityTitle: z.ZodString;
+  courseId: z.ZodString;
+  body: z.ZodString;
+  status: z.ZodEnum<{
+    published: "published";
+    pending: "pending";
+    removed: "removed";
+  }>;
+  author: z.ZodObject<{
+    id: z.ZodString;
+    firstName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodNullable<z.ZodString>;
+    image: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+      owner: "owner";
+      admin: "admin";
+      instructor: "instructor";
+      student: "student";
+    }>;
+  }, z.core.$strict>;
+  authorEmail: z.ZodString;
+  removedBy: z.ZodNullable<z.ZodString>;
+  reports: z.ZodArray<z.ZodObject<{
+    reporter: z.ZodObject<{
+      id: z.ZodString;
+      firstName: z.ZodNullable<z.ZodString>;
+      lastName: z.ZodNullable<z.ZodString>;
+      image: z.ZodNullable<z.ZodString>;
+      role: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        instructor: "instructor";
+        student: "student";
+      }>;
+    }, z.core.$strict>;
+    reason: z.ZodString;
+    createdAt: z.ZodCoercedDate<unknown>;
+  }, z.core.$strict>>;
+  createdAt: z.ZodCoercedDate<unknown>;
+  updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>;
+type CommentListItem = z.infer<typeof CommentListItem>;
+declare const CommentsQuery: z.ZodObject<{
+  page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  search: z.ZodOptional<z.ZodString>;
+  sort: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    published: "published";
+    pending: "pending";
+    removed: "removed";
+  }>>;
+  reported: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
+  courseId: z.ZodOptional<z.ZodString>;
+  activityId: z.ZodOptional<z.ZodString>;
+  orgUserId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CommentsQuery = z.infer<typeof CommentsQuery>;
+declare const CommentsPage: z.ZodObject<{
+  rows: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    activityId: z.ZodString;
+    activityTitle: z.ZodString;
+    courseId: z.ZodString;
+    body: z.ZodString;
+    status: z.ZodEnum<{
+      published: "published";
+      pending: "pending";
+      removed: "removed";
+    }>;
+    author: z.ZodObject<{
+      id: z.ZodString;
+      firstName: z.ZodNullable<z.ZodString>;
+      lastName: z.ZodNullable<z.ZodString>;
+      image: z.ZodNullable<z.ZodString>;
+      role: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        instructor: "instructor";
+        student: "student";
+      }>;
+    }, z.core.$strict>;
+    authorEmail: z.ZodString;
+    removedBy: z.ZodNullable<z.ZodString>;
+    reports: z.ZodArray<z.ZodObject<{
+      reporter: z.ZodObject<{
+        id: z.ZodString;
+        firstName: z.ZodNullable<z.ZodString>;
+        lastName: z.ZodNullable<z.ZodString>;
+        image: z.ZodNullable<z.ZodString>;
+        role: z.ZodEnum<{
+          owner: "owner";
+          admin: "admin";
+          instructor: "instructor";
+          student: "student";
+        }>;
+      }, z.core.$strict>;
+      reason: z.ZodString;
+      createdAt: z.ZodCoercedDate<unknown>;
+    }, z.core.$strict>>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+  }, z.core.$strict>>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+}, z.core.$strip>;
+type CommentsPage = z.infer<typeof CommentsPage>;
+declare const DiscussionActivityParam: z.ZodObject<{
+  activityId: z.ZodString;
+}, z.core.$strip>;
+type DiscussionActivityParam = z.infer<typeof DiscussionActivityParam>;
+declare const CommentIdParam: z.ZodObject<{
+  commentId: z.ZodString;
+}, z.core.$strip>;
+type CommentIdParam = z.infer<typeof CommentIdParam>;
+//#endregion
+export { ActivityComments, Comment, CommentAuthor, CommentIdParam, CommentListItem, CommentReactions, CommentReport, CommentReportSummary, CommentSettings, CommentStatus, CommentView, CommentsConfig, CommentsPage, CommentsQuery, DiscussionActivityParam, EditComment, PatchComment, PostComment, ReactionCounts, ReactionEmoji, ReplyToComment, ReportComment, SetCommentReaction };
+//# sourceMappingURL=discussion.d.ts.map

package/dist/http/schemas/discussion.js

@@ -0,0 +1,78 @@
+import { ListQuery, paginated } from "./shared.js";
+import { z } from "zod";
+import { commentAuthorSchema, commentListItemSchema, commentReportSummarySchema, commentSchema, commentStatusSchema, commentViewSchema } from "@headless-lms/core/schemas";
+//#region src/http/schemas/discussion.ts
+const CommentStatus = commentStatusSchema;
+const CommentAuthor = commentAuthorSchema;
+/** Any single emoji. Open, so widening the picker needs no schema change. */
+const ReactionEmoji = z.string().min(1).max(16);
+/** Counts by emoji; unused ones are absent, so no reactions serves `{}`. */
+const ReactionCounts = z.record(z.string(), z.number().int());
+const CommentView = commentViewSchema;
+/** What the reaction write returns, so the client never recomputes a count. */
+const CommentReactions = z.object({
+	reactions: ReactionCounts,
+	viewerReaction: ReactionEmoji.optional()
+});
+/** A course's comment settings. Stored under the course, carried on the course
+*  payload as `settings.comments`. */
+const CommentSettings = z.object({
+	enabled: z.boolean(),
+	threaded: z.boolean(),
+	requireReview: z.boolean(),
+	reactions: z.boolean()
+});
+/** The course settings with the activity's override applied: `enabled` is the
+*  resolved answer for this activity, not the course switch. */
+const CommentsConfig = CommentSettings;
+const ActivityComments = z.object({
+	config: CommentsConfig,
+	comments: z.array(CommentView)
+});
+const PostComment = z.object({
+	body: z.string().min(1).max(1e4),
+	parentId: z.string().nullable().default(null)
+});
+const EditComment = z.object({ body: z.string().min(1).max(1e4) });
+/** The staff PATCH writes status and nothing else: publishing covers approving
+*  a pending comment and restoring a removed one. Revising the text is the
+*  author's own edit, under /api/learn. */
+const PatchComment = z.object({ status: z.literal("published") });
+/** Replaces whatever the reader had. Clearing is DELETE, which carries no body. */
+const SetCommentReaction = z.object({ emoji: ReactionEmoji });
+/** A moderator's reply, posted from the queue against the comment it answers. */
+const ReplyToComment = z.object({ body: z.string().min(1).max(1e4) });
+const ReportComment = z.object({ reason: z.string().max(1e3).default("") });
+const Comment = commentSchema;
+const CommentReport = z.object({
+	id: z.string(),
+	commentId: z.string(),
+	orgUserId: z.string(),
+	reason: z.string(),
+	resolvedAt: z.date().nullable(),
+	createdAt: z.date()
+});
+/** An unresolved report on a listed comment. Resolved ones are history and are
+*  never served here. */
+const CommentReportSummary = commentReportSummarySchema;
+/** One row of the staff comment list: the comment plus the context a
+*  moderation decision needs, so the list needs no follow-up request. */
+const CommentListItem = commentListItemSchema;
+const CommentsQuery = ListQuery.extend({
+	status: CommentStatus.optional(),
+	/** true = only comments carrying an unresolved report, false = only those
+	*  carrying none. `z.stringbool` because query values arrive as strings and
+	*  `z.coerce.boolean()` would read "false" as true. */
+	reported: z.stringbool().optional(),
+	courseId: z.string().optional(),
+	activityId: z.string().optional(),
+	/** Scope to one author (org_users.id). */
+	orgUserId: z.string().optional()
+});
+const CommentsPage = paginated(CommentListItem);
+const DiscussionActivityParam = z.object({ activityId: z.string() });
+const CommentIdParam = z.object({ commentId: z.string() });
+//#endregion
+export { ActivityComments, Comment, CommentAuthor, CommentIdParam, CommentListItem, CommentReactions, CommentReport, CommentReportSummary, CommentSettings, CommentStatus, CommentView, CommentsConfig, CommentsPage, CommentsQuery, DiscussionActivityParam, EditComment, PatchComment, PostComment, ReactionCounts, ReactionEmoji, ReplyToComment, ReportComment, SetCommentReaction };
+
+//# sourceMappingURL=discussion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discussion.js","names":[],"sources":["../../../src/http/schemas/discussion.ts"],"sourcesContent":["// Discussion resource schemas. Comments attach to an activity; settings are\n// per course, with a per-activity override carried on the activity's own\n// settings blob rather than a resource of its own.\n//\n// The author is the org user's profile minus its email — learners read each\n// other's comments and the list must not be a directory of the cohort's\n// addresses. The staff-facing comment list carries `authorEmail` separately.\nimport type { CommentSettings as DomainCommentSettings } from \"@headless-lms/core/types\";\nimport {\n  commentAuthorSchema,\n  commentListItemSchema,\n  commentReportSummarySchema,\n  commentSchema,\n  commentStatusSchema,\n  commentViewSchema,\n} from \"@headless-lms/core/schemas\";\nimport { z } from \"zod\";\nimport { ListQuery, type Matches, paginated } from \"./shared.js\";\n\nexport const CommentStatus = commentStatusSchema;\nexport type CommentStatus = z.infer<typeof CommentStatus>;\n\nexport const CommentAuthor = commentAuthorSchema;\nexport type CommentAuthor = z.infer<typeof CommentAuthor>;\n\n/** Any single emoji. Open, so widening the picker needs no schema change. */\nexport const ReactionEmoji = z.string().min(1).max(16);\nexport type ReactionEmoji = z.infer<typeof ReactionEmoji>;\n\n/** Counts by emoji; unused ones are absent, so no reactions serves `{}`. */\nexport const ReactionCounts = z.record(z.string(), z.number().int());\nexport type ReactionCounts = z.infer<typeof ReactionCounts>;\n\nexport const CommentView = commentViewSchema;\nexport type CommentView = z.infer<typeof CommentView>;\n\n/** What the reaction write returns, so the client never recomputes a count. */\nexport const CommentReactions = z.object({\n  reactions: ReactionCounts,\n  viewerReaction: ReactionEmoji.optional(),\n});\nexport type CommentReactions = z.infer<typeof CommentReactions>;\n\n/** A course's comment settings. Stored under the course, carried on the course\n *  payload as `settings.comments`. */\nexport const CommentSettings = z.object({\n  enabled: z.boolean(),\n  threaded: z.boolean(),\n  requireReview: z.boolean(),\n  reactions: z.boolean(),\n});\nexport type CommentSettings = z.infer<typeof CommentSettings>;\ntype _CommentSettingsMatchesDomain = Matches<DomainCommentSettings, CommentSettings> &\n  Matches<CommentSettings, DomainCommentSettings>;\n\n/** The course settings with the activity's override applied: `enabled` is the\n *  resolved answer for this activity, not the course switch. */\nexport const CommentsConfig = CommentSettings;\nexport type CommentsConfig = z.infer<typeof CommentsConfig>;\n\nexport const ActivityComments = z.object({\n  config: CommentsConfig,\n  comments: z.array(CommentView),\n});\nexport type ActivityComments = z.infer<typeof ActivityComments>;\n\nexport const PostComment = z.object({\n  body: z.string().min(1).max(10_000),\n  parentId: z.string().nullable().default(null),\n});\nexport type PostComment = z.infer<typeof PostComment>;\n\nexport const EditComment = z.object({\n  body: z.string().min(1).max(10_000),\n});\nexport type EditComment = z.infer<typeof EditComment>;\n\n/** The staff PATCH writes status and nothing else: publishing covers approving\n *  a pending comment and restoring a removed one. Revising the text is the\n *  author's own edit, under /api/learn. */\nexport const PatchComment = z.object({\n  status: z.literal(\"published\"),\n});\nexport type PatchComment = z.infer<typeof PatchComment>;\n\n/** Replaces whatever the reader had. Clearing is DELETE, which carries no body. */\nexport const SetCommentReaction = z.object({\n  emoji: ReactionEmoji,\n});\nexport type SetCommentReaction = z.infer<typeof SetCommentReaction>;\n\n/** A moderator's reply, posted from the queue against the comment it answers. */\nexport const ReplyToComment = z.object({\n  body: z.string().min(1).max(10_000),\n});\nexport type ReplyToComment = z.infer<typeof ReplyToComment>;\n\nexport const ReportComment = z.object({\n  reason: z.string().max(1_000).default(\"\"),\n});\nexport type ReportComment = z.infer<typeof ReportComment>;\n\nexport const Comment = commentSchema;\nexport type Comment = z.infer<typeof Comment>;\n\nexport const CommentReport = z.object({\n  id: z.string(),\n  commentId: z.string(),\n  orgUserId: z.string(),\n  reason: z.string(),\n  resolvedAt: z.date().nullable(),\n  createdAt: z.date(),\n});\nexport type CommentReport = z.infer<typeof CommentReport>;\n\n/** An unresolved report on a listed comment. Resolved ones are history and are\n *  never served here. */\nexport const CommentReportSummary = commentReportSummarySchema;\nexport type CommentReportSummary = z.infer<typeof CommentReportSummary>;\n\n/** One row of the staff comment list: the comment plus the context a\n *  moderation decision needs, so the list needs no follow-up request. */\nexport const CommentListItem = commentListItemSchema;\nexport type CommentListItem = z.infer<typeof CommentListItem>;\n\nexport const CommentsQuery = ListQuery.extend({\n  status: CommentStatus.optional(),\n  /** true = only comments carrying an unresolved report, false = only those\n   *  carrying none. `z.stringbool` because query values arrive as strings and\n   *  `z.coerce.boolean()` would read \"false\" as true. */\n  reported: z.stringbool().optional(),\n  courseId: z.string().optional(),\n  activityId: z.string().optional(),\n  /** Scope to one author (org_users.id). */\n  orgUserId: z.string().optional(),\n});\nexport type CommentsQuery = z.infer<typeof CommentsQuery>;\n\nexport const CommentsPage = paginated(CommentListItem);\nexport type CommentsPage = z.infer<typeof CommentsPage>;\n\nexport const DiscussionActivityParam = z.object({ activityId: z.string() });\nexport type DiscussionActivityParam = z.infer<typeof DiscussionActivityParam>;\n\nexport const CommentIdParam = z.object({ commentId: z.string() });\nexport type CommentIdParam = z.infer<typeof CommentIdParam>;\n\n"],"mappings":";;;;AAmBA,MAAa,gBAAgB;AAG7B,MAAa,gBAAgB;;AAI7B,MAAa,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;;AAIrD,MAAa,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AAGnE,MAAa,cAAc;;AAI3B,MAAa,mBAAmB,EAAE,OAAO;CACvC,WAAW;CACX,gBAAgB,cAAc,SAAS;AACzC,CAAC;;;AAKD,MAAa,kBAAkB,EAAE,OAAO;CACtC,SAAS,EAAE,QAAQ;CACnB,UAAU,EAAE,QAAQ;CACpB,eAAe,EAAE,QAAQ;CACzB,WAAW,EAAE,QAAQ;AACvB,CAAC;;;AAOD,MAAa,iBAAiB;AAG9B,MAAa,mBAAmB,EAAE,OAAO;CACvC,QAAQ;CACR,UAAU,EAAE,MAAM,WAAW;AAC/B,CAAC;AAGD,MAAa,cAAc,EAAE,OAAO;CAClC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM;CAClC,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,IAAI;AAC9C,CAAC;AAGD,MAAa,cAAc,EAAE,OAAO,EAClC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM,EACpC,CAAC;;;;AAMD,MAAa,eAAe,EAAE,OAAO,EACnC,QAAQ,EAAE,QAAQ,WAAW,EAC/B,CAAC;;AAID,MAAa,qBAAqB,EAAE,OAAO,EACzC,OAAO,cACT,CAAC;;AAID,MAAa,iBAAiB,EAAE,OAAO,EACrC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM,EACpC,CAAC;AAGD,MAAa,gBAAgB,EAAE,OAAO,EACpC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,GAAK,CAAC,CAAC,QAAQ,EAAE,EAC1C,CAAC;AAGD,MAAa,UAAU;AAGvB,MAAa,gBAAgB,EAAE,OAAO;CACpC,IAAI,EAAE,OAAO;CACb,WAAW,EAAE,OAAO;CACpB,WAAW,EAAE,OAAO;CACpB,QAAQ,EAAE,OAAO;CACjB,YAAY,EAAE,KAAK,CAAC,CAAC,SAAS;CAC9B,WAAW,EAAE,KAAK;AACpB,CAAC;;;AAKD,MAAa,uBAAuB;;;AAKpC,MAAa,kBAAkB;AAG/B,MAAa,gBAAgB,UAAU,OAAO;CAC5C,QAAQ,cAAc,SAAS;;;;CAI/B,UAAU,EAAE,WAAW,CAAC,CAAC,SAAS;CAClC,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;CAC9B,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;;CAEhC,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;AACjC,CAAC;AAGD,MAAa,eAAe,UAAU,eAAe;AAGrD,MAAa,0BAA0B,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAG1E,MAAa,iBAAiB,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC"}

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

@@ -0,0 +1,110 @@
+import { z } from "zod";
+//#region src/http/schemas/downloads.d.ts
+declare const DownloadStatus: z.ZodEnum<{
+  draft: "draft";
+  published: "published";
+}>;
+type DownloadStatus = z.infer<typeof DownloadStatus>;
+declare const Download: z.ZodObject<{
+  orgId: z.ZodString;
+  id: z.ZodString;
+  type: z.ZodLiteral<"download">;
+  title: z.ZodString;
+  slug: z.ZodString;
+  description: z.ZodString;
+  status: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+  }>;
+  category: z.ZodString;
+  thumbnailAssetId: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodCoercedDate<unknown>;
+  updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>;
+type Download = z.infer<typeof Download>;
+declare const DownloadAsset: z.ZodObject<{
+  orgId: z.ZodString;
+  id: z.ZodString;
+  downloadId: z.ZodString;
+  assetId: z.ZodString;
+  seq: z.ZodNumber;
+  displayName: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type DownloadAsset = z.infer<typeof DownloadAsset>;
+declare const CreateDownload: z.ZodObject<{
+  title: z.ZodString;
+  description: z.ZodDefault<z.ZodString>;
+  category: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type CreateDownload = z.infer<typeof CreateDownload>;
+declare const UpdateDownload: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  category: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  status: z.ZodOptional<z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+  }>>;
+  thumbnailAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type UpdateDownload = z.infer<typeof UpdateDownload>;
+declare const DownloadsQuery: z.ZodObject<{
+  page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  search: z.ZodOptional<z.ZodString>;
+  sort: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+  }>>;
+  category: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DownloadsQuery = z.infer<typeof DownloadsQuery>;
+declare const DownloadsPage: z.ZodObject<{
+  rows: z.ZodArray<z.ZodObject<{
+    orgId: z.ZodString;
+    id: z.ZodString;
+    type: z.ZodLiteral<"download">;
+    title: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<{
+      draft: "draft";
+      published: "published";
+    }>;
+    category: z.ZodString;
+    thumbnailAssetId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+  }, z.core.$strict>>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+}, z.core.$strip>;
+type DownloadsPage = z.infer<typeof DownloadsPage>;
+declare const AddDownloadAsset: z.ZodObject<{
+  assetId: z.ZodString;
+  displayName: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type AddDownloadAsset = z.infer<typeof AddDownloadAsset>;
+/** `null` restores the `filename` fallback. */
+declare const RenameDownloadAsset: z.ZodObject<{
+  displayName: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type RenameDownloadAsset = z.infer<typeof RenameDownloadAsset>;
+declare const ReorderDownloadAssets: z.ZodObject<{
+  assetIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+type ReorderDownloadAssets = z.infer<typeof ReorderDownloadAssets>;
+declare const DownloadIdParam: z.ZodObject<{
+  downloadId: z.ZodString;
+}, z.core.$strip>;
+type DownloadIdParam = z.infer<typeof DownloadIdParam>;
+declare const DownloadAssetParams: z.ZodObject<{
+  downloadId: z.ZodString;
+  assetId: z.ZodString;
+}, z.core.$strip>;
+type DownloadAssetParams = z.infer<typeof DownloadAssetParams>;
+//#endregion
+export { AddDownloadAsset, CreateDownload, Download, DownloadAsset, DownloadAssetParams, DownloadIdParam, DownloadStatus, DownloadsPage, DownloadsQuery, RenameDownloadAsset, ReorderDownloadAssets, UpdateDownload };
+//# sourceMappingURL=downloads.d.ts.map

package/dist/http/schemas/downloads.js

@@ -0,0 +1,34 @@
+import { ListQuery, paginated } from "./shared.js";
+import { z } from "zod";
+import { addDownloadAssetInputSchema, downloadAssetSchema, downloadSchema, downloadStatusSchema, reorderDownloadAssetsInputSchema } from "@headless-lms/core/schemas";
+//#region src/http/schemas/downloads.ts
+const DownloadStatus = downloadStatusSchema;
+const Download = downloadSchema;
+const DownloadAsset = downloadAssetSchema;
+const CreateDownload = z.object({
+	title: z.string().min(1),
+	description: z.string().default(""),
+	category: z.string().default("")
+});
+const UpdateDownload = CreateDownload.partial().extend({
+	status: DownloadStatus.optional(),
+	thumbnailAssetId: z.string().nullable().optional()
+});
+const DownloadsQuery = ListQuery.extend({
+	status: DownloadStatus.optional(),
+	category: z.string().optional()
+});
+const DownloadsPage = paginated(Download);
+const AddDownloadAsset = addDownloadAssetInputSchema;
+/** `null` restores the `filename` fallback. */
+const RenameDownloadAsset = z.object({ displayName: z.string().nullable() });
+const ReorderDownloadAssets = reorderDownloadAssetsInputSchema;
+const DownloadIdParam = z.object({ downloadId: z.string() });
+const DownloadAssetParams = z.object({
+	downloadId: z.string(),
+	assetId: z.string()
+});
+//#endregion
+export { AddDownloadAsset, CreateDownload, Download, DownloadAsset, DownloadAssetParams, DownloadIdParam, DownloadStatus, DownloadsPage, DownloadsQuery, RenameDownloadAsset, ReorderDownloadAssets, UpdateDownload };
+
+//# sourceMappingURL=downloads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.js","names":[],"sources":["../../../src/http/schemas/downloads.ts"],"sourcesContent":["// Downloads resource schemas — a content type whose whole structure is an\n// ordered set of media-library assets. The Fastify routes validate\n// requests/responses against these, the OpenAPI spec is built from them, and\n// the frontend SDK is generated off that spec.\nimport { z } from \"zod\";\nimport {\n  addDownloadAssetInputSchema,\n  downloadAssetSchema,\n  downloadSchema,\n  downloadStatusSchema,\n  reorderDownloadAssetsInputSchema,\n} from \"@headless-lms/core/schemas\";\nimport { ListQuery, paginated } from \"./shared.js\";\n\nexport const DownloadStatus = downloadStatusSchema;\nexport type DownloadStatus = z.infer<typeof DownloadStatus>;\n\nexport const Download = downloadSchema;\nexport type Download = z.infer<typeof Download>;\n\nexport const DownloadAsset = downloadAssetSchema;\nexport type DownloadAsset = z.infer<typeof DownloadAsset>;\n\nexport const CreateDownload = z.object({\n  title: z.string().min(1),\n  description: z.string().default(\"\"),\n  category: z.string().default(\"\"),\n});\nexport type CreateDownload = z.infer<typeof CreateDownload>;\n\nexport const UpdateDownload = CreateDownload.partial().extend({\n  status: DownloadStatus.optional(),\n  thumbnailAssetId: z.string().nullable().optional(),\n});\nexport type UpdateDownload = z.infer<typeof UpdateDownload>;\n\nexport const DownloadsQuery = ListQuery.extend({\n  status: DownloadStatus.optional(),\n  category: z.string().optional(),\n});\nexport type DownloadsQuery = z.infer<typeof DownloadsQuery>;\n\nexport const DownloadsPage = paginated(Download);\nexport type DownloadsPage = z.infer<typeof DownloadsPage>;\n\nexport const AddDownloadAsset = addDownloadAssetInputSchema;\nexport type AddDownloadAsset = z.infer<typeof AddDownloadAsset>;\n\n/** `null` restores the `filename` fallback. */\nexport const RenameDownloadAsset = z.object({\n  displayName: z.string().nullable(),\n});\nexport type RenameDownloadAsset = z.infer<typeof RenameDownloadAsset>;\n\nexport const ReorderDownloadAssets = reorderDownloadAssetsInputSchema;\nexport type ReorderDownloadAssets = z.infer<typeof ReorderDownloadAssets>;\n\nexport const DownloadIdParam = z.object({ downloadId: z.string() });\nexport type DownloadIdParam = z.infer<typeof DownloadIdParam>;\n\nexport const DownloadAssetParams = z.object({\n  downloadId: z.string(),\n  assetId: z.string(),\n});\nexport type DownloadAssetParams = z.infer<typeof DownloadAssetParams>;\n"],"mappings":";;;;AAcA,MAAa,iBAAiB;AAG9B,MAAa,WAAW;AAGxB,MAAa,gBAAgB;AAG7B,MAAa,iBAAiB,EAAE,OAAO;CACrC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACvB,aAAa,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE;CAClC,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE;AACjC,CAAC;AAGD,MAAa,iBAAiB,eAAe,QAAQ,CAAC,CAAC,OAAO;CAC5D,QAAQ,eAAe,SAAS;CAChC,kBAAkB,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACnD,CAAC;AAGD,MAAa,iBAAiB,UAAU,OAAO;CAC7C,QAAQ,eAAe,SAAS;CAChC,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;AAChC,CAAC;AAGD,MAAa,gBAAgB,UAAU,QAAQ;AAG/C,MAAa,mBAAmB;;AAIhC,MAAa,sBAAsB,EAAE,OAAO,EAC1C,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,EACnC,CAAC;AAGD,MAAa,wBAAwB;AAGrC,MAAa,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAGlE,MAAa,sBAAsB,EAAE,OAAO;CAC1C,YAAY,EAAE,OAAO;CACrB,SAAS,EAAE,OAAO;AACpB,CAAC"}