@headless-lms/server 0.1.0 → 0.3.0

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

@@ -38,9 +38,18 @@ declare const Course: z.ZodObject<{
   }>;
   category: z.ZodString;
   thumbnailAssetId: z.ZodNullable<z.ZodString>;
-  settings: z.ZodType<import("@headless-lms/core/types").JsonValue, unknown, z.core.$ZodTypeInternals<import("@headless-lms/core/types").JsonValue, unknown>>;
+  settings: z.ZodObject<{
+    transcriptDownloads: z.ZodBoolean;
+    comments: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodBoolean;
+      threaded: z.ZodBoolean;
+      requireReview: z.ZodBoolean;
+      reactions: z.ZodBoolean;
+    }, z.core.$strict>>;
+  }, z.core.$strict>;
   createdAt: z.ZodCoercedDate<unknown>;
   updatedAt: z.ZodCoercedDate<unknown>;
+  thumbnailUrl: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 type Course = z.infer<typeof Course>;
 declare const CreateCourse: z.ZodObject<{
@@ -51,22 +60,13 @@ declare const CreateCourse: z.ZodObject<{
 type CreateCourse = z.infer<typeof CreateCourse>;
 declare const UpdateCourse: z.ZodObject<{
   title: z.ZodOptional<z.ZodString>;
-  description: z.ZodOptional<z.ZodDefault<z.ZodString>>;
-  category: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  description: z.ZodOptional<z.ZodString>;
+  category: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
     draft: "draft";
     published: "published";
   }>>;
   thumbnailAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  settings: z.ZodOptional<z.ZodObject<{
-    transcriptDownloads: z.ZodOptional<z.ZodBoolean>;
-    comments: z.ZodOptional<z.ZodOptional<z.ZodObject<{
-      enabled: z.ZodBoolean;
-      threaded: z.ZodBoolean;
-      requireReview: z.ZodBoolean;
-      reactions: z.ZodBoolean;
-    }, z.core.$strict>>>;
-  }, z.core.$strict>>;
 }, z.core.$strip>;
 type UpdateCourse = z.infer<typeof UpdateCourse>;
 declare const CoursesQuery: z.ZodObject<{
@@ -95,9 +95,18 @@ declare const CoursesPage: z.ZodObject<{
     }>;
     category: z.ZodString;
     thumbnailAssetId: z.ZodNullable<z.ZodString>;
-    settings: z.ZodType<import("@headless-lms/core/types").JsonValue, unknown, z.core.$ZodTypeInternals<import("@headless-lms/core/types").JsonValue, unknown>>;
+    settings: z.ZodObject<{
+      transcriptDownloads: z.ZodBoolean;
+      comments: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        threaded: z.ZodBoolean;
+        requireReview: z.ZodBoolean;
+        reactions: z.ZodBoolean;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
     createdAt: z.ZodCoercedDate<unknown>;
     updatedAt: z.ZodCoercedDate<unknown>;
+    thumbnailUrl: z.ZodNullable<z.ZodString>;
   }, z.core.$strict>>;
   total: z.ZodNumber;
   page: z.ZodNumber;

package/dist/http/schemas/content.js

@@ -1,25 +1,27 @@
 import { ListQuery, paginated } from "./shared.js";
 import { z } from "zod";
-import { courseSchema, courseSettingsSchema, courseStatusSchema } from "@headless-lms/core/schemas";
+import { courseSettingsSchema, courseStatusSchema, courseViewSchema, idSchema } from "@headless-lms/core/schemas";
 //#region src/http/schemas/content.ts
 const CourseStatus = courseStatusSchema;
 const CourseSettings = courseSettingsSchema;
 const PatchCourseSettings = CourseSettings.partial();
-const Course = courseSchema;
+const Course = courseViewSchema;
 const CreateCourse = z.object({
-	title: z.string().min(1),
-	description: z.string().default(""),
-	category: z.string().default("")
+	title: z.string().trim().min(1).max(200),
+	description: z.string().max(5e3).default(""),
+	category: z.string().trim().max(100).default("")
 });
-const UpdateCourse = CreateCourse.partial().extend({
+const UpdateCourse = z.object({
+	title: z.string().trim().min(1).max(200).optional(),
+	description: z.string().max(5e3).optional(),
+	category: z.string().trim().max(100).optional(),
 	status: CourseStatus.optional(),
 	/** null clears the cover. */
-	thumbnailAssetId: z.string().nullable().optional(),
-	settings: CourseSettings.partial().optional()
+	thumbnailAssetId: idSchema.nullable().optional()
 });
 const CoursesQuery = ListQuery.extend({
 	status: CourseStatus.optional(),
-	category: z.string().optional()
+	category: z.string().trim().max(100).optional()
 });
 const CoursesPage = paginated(Course);
 const CourseIdParam = z.object({ id: z.string() });

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

@@ -1 +1 @@
-{"version":3,"file":"content.js","names":[],"sources":["../../../src/http/schemas/content.ts"],"sourcesContent":["// Content resource schemas (courses). The Course payload shape is owned by\n// @headless-lms/core/schemas; route-local schemas define endpoint-only\n// concerns such as defaults, params, and pagination envelopes.\nimport { z } from \"zod\";\nimport {\n  courseSchema,\n  courseSettingsSchema,\n  courseStatusSchema,\n} from \"@headless-lms/core/schemas\";\nimport { ListQuery, paginated } from \"./shared.js\";\n\nexport const CourseStatus = courseStatusSchema;\nexport type CourseStatus = z.infer<typeof CourseStatus>;\n\nexport const CourseSettings = courseSettingsSchema;\nexport type CourseSettings = z.infer<typeof CourseSettings>;\n\nexport const PatchCourseSettings = CourseSettings.partial();\nexport type PatchCourseSettings = z.infer<typeof PatchCourseSettings>;\n\nexport const Course = courseSchema;\nexport type Course = z.infer<typeof Course>;\n\nexport const CreateCourse = z.object({\n  title: z.string().min(1),\n  description: z.string().default(\"\"),\n  category: z.string().default(\"\"),\n});\nexport type CreateCourse = z.infer<typeof CreateCourse>;\n\nexport const UpdateCourse = CreateCourse.partial().extend({\n  status: CourseStatus.optional(),\n  /** null clears the cover. */\n  thumbnailAssetId: z.string().nullable().optional(),\n  settings: CourseSettings.partial().optional(),\n});\nexport type UpdateCourse = z.infer<typeof UpdateCourse>;\n\nexport const CoursesQuery = ListQuery.extend({\n  status: CourseStatus.optional(),\n  category: z.string().optional(),\n});\nexport type CoursesQuery = z.infer<typeof CoursesQuery>;\n\nexport const CoursesPage = paginated(Course);\nexport type CoursesPage = z.infer<typeof CoursesPage>;\n\nexport const CourseIdParam = z.object({ id: z.string() });\nexport type CourseIdParam = z.infer<typeof CourseIdParam>;\n"],"mappings":";;;;AAWA,MAAa,eAAe;AAG5B,MAAa,iBAAiB;AAG9B,MAAa,sBAAsB,eAAe,QAAQ;AAG1D,MAAa,SAAS;AAGtB,MAAa,eAAe,EAAE,OAAO;CACnC,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,eAAe,aAAa,QAAQ,CAAC,CAAC,OAAO;CACxD,QAAQ,aAAa,SAAS;;CAE9B,kBAAkB,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACjD,UAAU,eAAe,QAAQ,CAAC,CAAC,SAAS;AAC9C,CAAC;AAGD,MAAa,eAAe,UAAU,OAAO;CAC3C,QAAQ,aAAa,SAAS;CAC9B,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;AAChC,CAAC;AAGD,MAAa,cAAc,UAAU,MAAM;AAG3C,MAAa,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"content.js","names":[],"sources":["../../../src/http/schemas/content.ts"],"sourcesContent":["// Content resource schemas (courses). The Course payload shape is owned by\n// @headless-lms/core/schemas; route-local schemas define endpoint-only\n// concerns such as defaults, params, and pagination envelopes.\nimport { z } from 'zod';\nimport {\n  courseSettingsSchema,\n  courseStatusSchema,\n  courseViewSchema,\n  idSchema,\n} from '@headless-lms/core/schemas';\nimport { ListQuery, paginated } from './shared.js';\n\nexport const CourseStatus = courseStatusSchema;\nexport type CourseStatus = z.infer<typeof CourseStatus>;\n\nexport const CourseSettings = courseSettingsSchema;\nexport type CourseSettings = z.infer<typeof CourseSettings>;\n\nexport const PatchCourseSettings = CourseSettings.partial();\nexport type PatchCourseSettings = z.infer<typeof PatchCourseSettings>;\n\nexport const Course = courseViewSchema;\nexport type Course = z.infer<typeof Course>;\n\nexport const CreateCourse = z.object({\n  title: z.string().trim().min(1).max(200),\n  description: z.string().max(5_000).default(''),\n  category: z.string().trim().max(100).default(''),\n});\nexport type CreateCourse = z.infer<typeof CreateCourse>;\n\nexport const UpdateCourse = z.object({\n  title: z.string().trim().min(1).max(200).optional(),\n  description: z.string().max(5_000).optional(),\n  category: z.string().trim().max(100).optional(),\n  status: CourseStatus.optional(),\n  /** null clears the cover. */\n  thumbnailAssetId: idSchema.nullable().optional(),\n});\nexport type UpdateCourse = z.infer<typeof UpdateCourse>;\n\nexport const CoursesQuery = ListQuery.extend({\n  status: CourseStatus.optional(),\n  category: z.string().trim().max(100).optional(),\n});\nexport type CoursesQuery = z.infer<typeof CoursesQuery>;\n\nexport const CoursesPage = paginated(Course);\nexport type CoursesPage = z.infer<typeof CoursesPage>;\n\nexport const CourseIdParam = z.object({ id: z.string() });\nexport type CourseIdParam = z.infer<typeof CourseIdParam>;\n"],"mappings":";;;;AAYA,MAAa,eAAe;AAG5B,MAAa,iBAAiB;AAG9B,MAAa,sBAAsB,eAAe,QAAQ;AAG1D,MAAa,SAAS;AAGtB,MAAa,eAAe,EAAE,OAAO;CACnC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;CACvC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,GAAK,CAAC,CAAC,QAAQ,EAAE;CAC7C,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE;AACjD,CAAC;AAGD,MAAa,eAAe,EAAE,OAAO;CACnC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS;CAClD,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,GAAK,CAAC,CAAC,SAAS;CAC5C,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS;CAC9C,QAAQ,aAAa,SAAS;;CAE9B,kBAAkB,SAAS,SAAS,CAAC,CAAC,SAAS;AACjD,CAAC;AAGD,MAAa,eAAe,UAAU,OAAO;CAC3C,QAAQ,aAAa,SAAS;CAC9B,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS;AAChD,CAAC;AAGD,MAAa,cAAc,UAAU,MAAM;AAG3C,MAAa,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/dist/http/schemas/course-analytics.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+//#region src/http/schemas/course-analytics.d.ts
+declare const CourseActivityEngagement: z.ZodObject<{
+  activityId: z.ZodString;
+  title: z.ZodString;
+  moduleId: z.ZodString;
+  moduleTitle: z.ZodString;
+  started: z.ZodNumber;
+  completed: z.ZodNumber;
+}, z.core.$strip>;
+type CourseActivityEngagement = z.infer<typeof CourseActivityEngagement>;
+declare const CourseAnalytics: z.ZodObject<{
+  enrolled: z.ZodNumber;
+  started: z.ZodNumber;
+  completed: z.ZodNumber;
+  avgProgress: z.ZodNumber;
+  activities: z.ZodArray<z.ZodObject<{
+    activityId: z.ZodString;
+    title: z.ZodString;
+    moduleId: z.ZodString;
+    moduleTitle: z.ZodString;
+    started: z.ZodNumber;
+    completed: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type CourseAnalytics = z.infer<typeof CourseAnalytics>;
+//#endregion
+export { CourseActivityEngagement, CourseAnalytics };
+//# sourceMappingURL=course-analytics.d.ts.map

package/dist/http/schemas/course-analytics.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+//#region src/http/schemas/course-analytics.ts
+const CourseActivityEngagement = z.object({
+	activityId: z.string(),
+	title: z.string(),
+	moduleId: z.string(),
+	moduleTitle: z.string(),
+	started: z.number().int(),
+	completed: z.number().int()
+});
+const CourseAnalytics = z.object({
+	enrolled: z.number().int(),
+	started: z.number().int(),
+	completed: z.number().int(),
+	avgProgress: z.number().int(),
+	activities: z.array(CourseActivityEngagement)
+});
+//#endregion
+export { CourseActivityEngagement, CourseAnalytics };
+
+//# sourceMappingURL=course-analytics.js.map

package/dist/http/schemas/course-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-analytics.js","names":[],"sources":["../../../src/http/schemas/course-analytics.ts"],"sourcesContent":["// Per-course analytics resource schemas.\nimport { z } from 'zod';\n\nexport const CourseActivityEngagement = z.object({\n  activityId: z.string(),\n  title: z.string(),\n  moduleId: z.string(),\n  moduleTitle: z.string(),\n  started: z.number().int(),\n  completed: z.number().int(),\n});\nexport type CourseActivityEngagement = z.infer<typeof CourseActivityEngagement>;\n\nexport const CourseAnalytics = z.object({\n  enrolled: z.number().int(),\n  started: z.number().int(),\n  completed: z.number().int(),\n  avgProgress: z.number().int(),\n  activities: z.array(CourseActivityEngagement),\n});\nexport type CourseAnalytics = z.infer<typeof CourseAnalytics>;\n"],"mappings":";;AAGA,MAAa,2BAA2B,EAAE,OAAO;CAC/C,YAAY,EAAE,OAAO;CACrB,OAAO,EAAE,OAAO;CAChB,UAAU,EAAE,OAAO;CACnB,aAAa,EAAE,OAAO;CACtB,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI;CACxB,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI;AAC5B,CAAC;AAGD,MAAa,kBAAkB,EAAE,OAAO;CACtC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI;CACzB,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI;CACxB,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI;CAC1B,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI;CAC5B,YAAY,EAAE,MAAM,wBAAwB;AAC9C,CAAC"}

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

@@ -1 +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"}
+{"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

@@ -1,8 +1,8 @@
 import { z } from "zod";
 //#region src/http/schemas/discussion.d.ts
 declare const CommentStatus: z.ZodEnum<{
-  published: "published";
   pending: "pending";
+  published: "published";
   removed: "removed";
 }>;
 type CommentStatus = z.infer<typeof CommentStatus>;
@@ -10,11 +10,16 @@ declare const CommentAuthor: z.ZodObject<{
   id: z.ZodString;
   firstName: z.ZodNullable<z.ZodString>;
   lastName: z.ZodNullable<z.ZodString>;
+  displayName: z.ZodNullable<z.ZodString>;
+  headline: z.ZodNullable<z.ZodString>;
   image: z.ZodNullable<z.ZodString>;
+  imageAssetId: z.ZodNullable<z.ZodString>;
+  imageUrl: z.ZodNullable<z.ZodString>;
   role: z.ZodEnum<{
     owner: "owner";
     admin: "admin";
     instructor: "instructor";
+    moderator: "moderator";
     student: "student";
   }>;
 }, z.core.$strict>;
@@ -27,35 +32,47 @@ 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;
+  activityId: z.ZodNullable<z.ZodString>;
+  postId: z.ZodNullable<z.ZodString>;
+  communityId: z.ZodNullable<z.ZodString>;
   parentId: z.ZodNullable<z.ZodString>;
   author: z.ZodObject<{
     id: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
     lastName: z.ZodNullable<z.ZodString>;
+    displayName: z.ZodNullable<z.ZodString>;
+    headline: z.ZodNullable<z.ZodString>;
     image: z.ZodNullable<z.ZodString>;
+    imageAssetId: z.ZodNullable<z.ZodString>;
+    imageUrl: z.ZodNullable<z.ZodString>;
     role: z.ZodEnum<{
       owner: "owner";
       admin: "admin";
       instructor: "instructor";
+      moderator: "moderator";
       student: "student";
     }>;
   }, z.core.$strict>;
   body: z.ZodNullable<z.ZodString>;
   status: z.ZodEnum<{
-    published: "published";
     pending: "pending";
+    published: "published";
     removed: "removed";
   }>;
   removedBy: z.ZodNullable<z.ZodObject<{
     id: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
     lastName: z.ZodNullable<z.ZodString>;
+    displayName: z.ZodNullable<z.ZodString>;
+    headline: z.ZodNullable<z.ZodString>;
     image: z.ZodNullable<z.ZodString>;
+    imageAssetId: z.ZodNullable<z.ZodString>;
+    imageUrl: z.ZodNullable<z.ZodString>;
     role: z.ZodEnum<{
       owner: "owner";
       admin: "admin";
       instructor: "instructor";
+      moderator: "moderator";
       student: "student";
     }>;
   }, z.core.$strict>>;
@@ -65,12 +82,12 @@ declare const CommentView: z.ZodObject<{
   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<{
+/** What a reaction write on a post, message or comment returns, so the client never recomputes a count. */
+declare const Reactions: z.ZodObject<{
   reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
   viewerReaction: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-type CommentReactions = z.infer<typeof CommentReactions>;
+type Reactions = z.infer<typeof Reactions>;
 /** A course's comment settings. Stored under the course, carried on the course
  *  payload as `settings.comments`. */
 declare const CommentSettings: z.ZodObject<{
@@ -98,35 +115,47 @@ declare const ActivityComments: z.ZodObject<{
   }, z.core.$strip>;
   comments: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
-    activityId: z.ZodString;
+    activityId: z.ZodNullable<z.ZodString>;
+    postId: z.ZodNullable<z.ZodString>;
+    communityId: z.ZodNullable<z.ZodString>;
     parentId: z.ZodNullable<z.ZodString>;
     author: z.ZodObject<{
       id: z.ZodString;
       firstName: z.ZodNullable<z.ZodString>;
       lastName: z.ZodNullable<z.ZodString>;
+      displayName: z.ZodNullable<z.ZodString>;
+      headline: z.ZodNullable<z.ZodString>;
       image: z.ZodNullable<z.ZodString>;
+      imageAssetId: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
       role: z.ZodEnum<{
         owner: "owner";
         admin: "admin";
         instructor: "instructor";
+        moderator: "moderator";
         student: "student";
       }>;
     }, z.core.$strict>;
     body: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
-      published: "published";
       pending: "pending";
+      published: "published";
       removed: "removed";
     }>;
     removedBy: z.ZodNullable<z.ZodObject<{
       id: z.ZodString;
       firstName: z.ZodNullable<z.ZodString>;
       lastName: z.ZodNullable<z.ZodString>;
+      displayName: z.ZodNullable<z.ZodString>;
+      headline: z.ZodNullable<z.ZodString>;
       image: z.ZodNullable<z.ZodString>;
+      imageAssetId: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
       role: z.ZodEnum<{
         owner: "owner";
         admin: "admin";
         instructor: "instructor";
+        moderator: "moderator";
         student: "student";
       }>;
     }, z.core.$strict>>;
@@ -140,24 +169,30 @@ type ActivityComments = z.infer<typeof ActivityComments>;
 declare const PostComment: z.ZodObject<{
   body: z.ZodString;
   parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 type PostComment = z.infer<typeof PostComment>;
 declare const EditComment: z.ZodObject<{
   body: z.ZodString;
-}, z.core.$strip>;
+}, z.core.$strict>;
 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. */
+ *  author's own edit, under /api/member. */
 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<{
+declare const SetReaction: z.ZodObject<{
   emoji: z.ZodString;
-}, z.core.$strip>;
-type SetCommentReaction = z.infer<typeof SetCommentReaction>;
+}, z.core.$strict>;
+type SetReaction = z.infer<typeof SetReaction>;
+declare const ResolveCommentFlags: z.ZodObject<{
+  resolution: z.ZodEnum<{
+    dismissed: "dismissed";
+  }>;
+}, z.core.$strict>;
+type ResolveCommentFlags = z.infer<typeof ResolveCommentFlags>;
 /** A moderator's reply, posted from the queue against the comment it answers. */
 declare const ReplyToComment: z.ZodObject<{
   body: z.ZodString;
@@ -165,18 +200,20 @@ declare const ReplyToComment: z.ZodObject<{
 type ReplyToComment = z.infer<typeof ReplyToComment>;
 declare const ReportComment: z.ZodObject<{
   reason: z.ZodDefault<z.ZodString>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 type ReportComment = z.infer<typeof ReportComment>;
 declare const Comment: z.ZodObject<{
   id: z.ZodString;
   orgId: z.ZodString;
-  activityId: z.ZodString;
+  activityId: z.ZodNullable<z.ZodString>;
+  postId: z.ZodNullable<z.ZodString>;
+  communityId: z.ZodNullable<z.ZodString>;
   parentId: z.ZodNullable<z.ZodString>;
   orgUserId: z.ZodString;
   body: z.ZodString;
   status: z.ZodEnum<{
-    published: "published";
     pending: "pending";
+    published: "published";
     removed: "removed";
   }>;
   removedBy: z.ZodNullable<z.ZodString>;
@@ -200,11 +237,16 @@ declare const CommentReportSummary: z.ZodObject<{
     id: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
     lastName: z.ZodNullable<z.ZodString>;
+    displayName: z.ZodNullable<z.ZodString>;
+    headline: z.ZodNullable<z.ZodString>;
     image: z.ZodNullable<z.ZodString>;
+    imageAssetId: z.ZodNullable<z.ZodString>;
+    imageUrl: z.ZodNullable<z.ZodString>;
     role: z.ZodEnum<{
       owner: "owner";
       admin: "admin";
       instructor: "instructor";
+      moderator: "moderator";
       student: "student";
     }>;
   }, z.core.$strict>;
@@ -222,34 +264,44 @@ declare const CommentListItem: z.ZodObject<{
   courseId: z.ZodString;
   body: z.ZodString;
   status: z.ZodEnum<{
-    published: "published";
     pending: "pending";
+    published: "published";
     removed: "removed";
   }>;
   author: z.ZodObject<{
     id: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
     lastName: z.ZodNullable<z.ZodString>;
+    displayName: z.ZodNullable<z.ZodString>;
+    headline: z.ZodNullable<z.ZodString>;
     image: z.ZodNullable<z.ZodString>;
+    imageAssetId: z.ZodNullable<z.ZodString>;
+    imageUrl: z.ZodNullable<z.ZodString>;
     role: z.ZodEnum<{
       owner: "owner";
       admin: "admin";
       instructor: "instructor";
+      moderator: "moderator";
       student: "student";
     }>;
   }, z.core.$strict>;
-  authorEmail: z.ZodString;
+  authorEmail: z.ZodEmail;
   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>;
+      displayName: z.ZodNullable<z.ZodString>;
+      headline: z.ZodNullable<z.ZodString>;
       image: z.ZodNullable<z.ZodString>;
+      imageAssetId: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
       role: z.ZodEnum<{
         owner: "owner";
         admin: "admin";
         instructor: "instructor";
+        moderator: "moderator";
         student: "student";
       }>;
     }, z.core.$strict>;
@@ -266,8 +318,8 @@ declare const CommentsQuery: z.ZodObject<{
   search: z.ZodOptional<z.ZodString>;
   sort: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
-    published: "published";
     pending: "pending";
+    published: "published";
     removed: "removed";
   }>>;
   reported: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
@@ -285,34 +337,44 @@ declare const CommentsPage: z.ZodObject<{
     courseId: z.ZodString;
     body: z.ZodString;
     status: z.ZodEnum<{
-      published: "published";
       pending: "pending";
+      published: "published";
       removed: "removed";
     }>;
     author: z.ZodObject<{
       id: z.ZodString;
       firstName: z.ZodNullable<z.ZodString>;
       lastName: z.ZodNullable<z.ZodString>;
+      displayName: z.ZodNullable<z.ZodString>;
+      headline: z.ZodNullable<z.ZodString>;
       image: z.ZodNullable<z.ZodString>;
+      imageAssetId: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
       role: z.ZodEnum<{
         owner: "owner";
         admin: "admin";
         instructor: "instructor";
+        moderator: "moderator";
         student: "student";
       }>;
     }, z.core.$strict>;
-    authorEmail: z.ZodString;
+    authorEmail: z.ZodEmail;
     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>;
+        displayName: z.ZodNullable<z.ZodString>;
+        headline: z.ZodNullable<z.ZodString>;
         image: z.ZodNullable<z.ZodString>;
+        imageAssetId: z.ZodNullable<z.ZodString>;
+        imageUrl: z.ZodNullable<z.ZodString>;
         role: z.ZodEnum<{
           owner: "owner";
           admin: "admin";
           instructor: "instructor";
+          moderator: "moderator";
           student: "student";
         }>;
       }, z.core.$strict>;
@@ -336,5 +398,5 @@ declare const CommentIdParam: z.ZodObject<{
 }, 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 };
+export { ActivityComments, Comment, CommentAuthor, CommentIdParam, CommentListItem, CommentReport, CommentReportSummary, CommentSettings, CommentStatus, CommentView, CommentsConfig, CommentsPage, CommentsQuery, DiscussionActivityParam, EditComment, PatchComment, PostComment, ReactionCounts, ReactionEmoji, Reactions, ReplyToComment, ReportComment, ResolveCommentFlags, SetReaction };
 //# sourceMappingURL=discussion.d.ts.map

package/dist/http/schemas/discussion.js

@@ -1,6 +1,6 @@
 import { ListQuery, paginated } from "./shared.js";
 import { z } from "zod";
-import { commentAuthorSchema, commentListItemSchema, commentReportSummarySchema, commentSchema, commentStatusSchema, commentViewSchema } from "@headless-lms/core/schemas";
+import { commentAuthorSchema, commentFlagResolutionSchema, commentListItemSchema, commentReportSummarySchema, commentSchema, commentStatusSchema, commentViewSchema, idSchema } from "@headless-lms/core/schemas";
 //#region src/http/schemas/discussion.ts
 const CommentStatus = commentStatusSchema;
 const CommentAuthor = commentAuthorSchema;
@@ -9,10 +9,10 @@ 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({
+/** What a reaction write on a post, message or comment returns, so the client never recomputes a count. */
+const Reactions = z.object({
 	reactions: ReactionCounts,
-	viewerReaction: ReactionEmoji.optional()
+	viewerReaction: ReactionEmoji.optional().describe("Absent when you have no reaction")
 });
 /** A course's comment settings. Stored under the course, carried on the course
 *  payload as `settings.comments`. */
@@ -31,18 +31,19 @@ const ActivityComments = z.object({
 });
 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) });
+	parentId: idSchema.nullable().default(null).describe("The comment this replies to. Replies nest one level, under a root comment")
+}).strict();
+const EditComment = z.object({ body: z.string().min(1).max(1e4) }).strict();
 /** 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. */
+*  author's own edit, under /api/member. */
 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 });
+const SetReaction = z.object({ emoji: ReactionEmoji.describe("Replaces any reaction you already had") }).strict();
+const ResolveCommentFlags = z.object({ resolution: commentFlagResolutionSchema.extract(["dismissed"]).describe("`dismissed` closes the open flags and leaves the comment up. Removing the comment resolves its flags as `removed` instead.") }).strict();
 /** 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 ReportComment = z.object({ reason: z.string().max(1e3).default("") }).strict();
 const Comment = commentSchema;
 const CommentReport = z.object({
 	id: z.string(),
@@ -73,6 +74,6 @@ 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 };
+export { ActivityComments, Comment, CommentAuthor, CommentIdParam, CommentListItem, CommentReport, CommentReportSummary, CommentSettings, CommentStatus, CommentView, CommentsConfig, CommentsPage, CommentsQuery, DiscussionActivityParam, EditComment, PatchComment, PostComment, ReactionCounts, ReactionEmoji, Reactions, ReplyToComment, ReportComment, ResolveCommentFlags, SetReaction };
 
 //# sourceMappingURL=discussion.js.map

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

@@ -1 +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"}
+{"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  commentFlagResolutionSchema,\n  commentStatusSchema,\n  commentViewSchema,\n  idSchema,\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 a reaction write on a post, message or comment returns, so the client never recomputes a count. */\nexport const Reactions = z.object({\n  reactions: ReactionCounts,\n  viewerReaction: ReactionEmoji.optional().describe('Absent when you have no reaction'),\n});\nexport type Reactions = z.infer<typeof Reactions>;\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\n  .object({\n    body: z.string().min(1).max(10_000),\n    parentId: idSchema\n      .nullable()\n      .default(null)\n      .describe('The comment this replies to. Replies nest one level, under a root comment'),\n  })\n  .strict();\nexport type PostComment = z.infer<typeof PostComment>;\n\nexport const EditComment = z.object({ body: z.string().min(1).max(10_000) }).strict();\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/member. */\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 SetReaction = z\n  .object({ emoji: ReactionEmoji.describe('Replaces any reaction you already had') })\n  .strict();\nexport type SetReaction = z.infer<typeof SetReaction>;\n\nexport const ResolveCommentFlags = z\n  .object({\n    resolution: commentFlagResolutionSchema\n      .extract(['dismissed'])\n      .describe(\n        '`dismissed` closes the open flags and leaves the comment up. Removing the comment resolves its flags as `removed` instead.',\n      ),\n  })\n  .strict();\nexport type ResolveCommentFlags = z.infer<typeof ResolveCommentFlags>;\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({ reason: z.string().max(1_000).default('') }).strict();\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"],"mappings":";;;;AAqBA,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,YAAY,EAAE,OAAO;CAChC,WAAW;CACX,gBAAgB,cAAc,SAAS,CAAC,CAAC,SAAS,kCAAkC;AACtF,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,EACxB,OAAO;CACN,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM;CAClC,UAAU,SACP,SAAS,CAAC,CACV,QAAQ,IAAI,CAAC,CACb,SAAS,2EAA2E;AACzF,CAAC,CAAC,CACD,OAAO;AAGV,MAAa,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM,EAAE,CAAC,CAAC,CAAC,OAAO;;;;AAMpF,MAAa,eAAe,EAAE,OAAO,EACnC,QAAQ,EAAE,QAAQ,WAAW,EAC/B,CAAC;;AAID,MAAa,cAAc,EACxB,OAAO,EAAE,OAAO,cAAc,SAAS,uCAAuC,EAAE,CAAC,CAAC,CAClF,OAAO;AAGV,MAAa,sBAAsB,EAChC,OAAO,EACN,YAAY,4BACT,QAAQ,CAAC,WAAW,CAAC,CAAC,CACtB,SACC,4HACF,EACJ,CAAC,CAAC,CACD,OAAO;;AAIV,MAAa,iBAAiB,EAAE,OAAO,EACrC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM,EACpC,CAAC;AAGD,MAAa,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,GAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO;AAG5F,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"}