@headless-lms/server 0.2.0 → 0.3.0

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

@@ -49,6 +49,7 @@ declare const Course: z.ZodObject<{
   }, 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<{
@@ -59,8 +60,8 @@ 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";
@@ -105,6 +106,7 @@ declare const CoursesPage: z.ZodObject<{
     }, 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,24 +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()
+	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 { courseSchema, courseSettingsSchema, courseStatusSchema } 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});\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":";;;;AAOA,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;AACnD,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/discussion.d.ts

@@ -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,17 +32,24 @@ 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>;
@@ -51,11 +63,16 @@ declare const CommentView: 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,17 +115,24 @@ 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>;
@@ -122,11 +146,16 @@ declare const ActivityComments: 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,12 +200,14 @@ 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;
@@ -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>;
@@ -230,11 +272,16 @@ declare const CommentListItem: 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>;
@@ -245,11 +292,16 @@ declare const CommentListItem: 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>;
@@ -293,11 +345,16 @@ declare const CommentsPage: 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>;
@@ -308,11 +365,16 @@ declare const CommentsPage: 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"],"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"}

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

@@ -20,9 +20,10 @@ declare const Download: z.ZodObject<{
   thumbnailAssetId: z.ZodNullable<z.ZodString>;
   createdAt: z.ZodCoercedDate<unknown>;
   updatedAt: z.ZodCoercedDate<unknown>;
+  thumbnailUrl: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 type Download = z.infer<typeof Download>;
-declare const DownloadAsset: z.ZodObject<{
+declare const DownloadFile: z.ZodObject<{
   orgId: z.ZodString;
   id: z.ZodString;
   downloadId: z.ZodString;
@@ -31,8 +32,12 @@ declare const DownloadAsset: z.ZodObject<{
   displayName: z.ZodNullable<z.ZodString>;
   createdAt: z.ZodCoercedDate<unknown>;
   updatedAt: z.ZodCoercedDate<unknown>;
+  filename: z.ZodString;
+  contentType: z.ZodString;
+  size: z.ZodNumber;
+  url: z.ZodString;
 }, z.core.$strict>;
-type DownloadAsset = z.infer<typeof DownloadAsset>;
+type DownloadFile = z.infer<typeof DownloadFile>;
 declare const CreateDownload: z.ZodObject<{
   title: z.ZodString;
   description: z.ZodDefault<z.ZodString>;
@@ -41,8 +46,8 @@ declare const CreateDownload: z.ZodObject<{
 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>>;
+  description: z.ZodOptional<z.ZodString>;
+  category: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
     draft: "draft";
     published: "published";
@@ -78,6 +83,7 @@ declare const DownloadsPage: z.ZodObject<{
     thumbnailAssetId: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodCoercedDate<unknown>;
     updatedAt: z.ZodCoercedDate<unknown>;
+    thumbnailUrl: z.ZodNullable<z.ZodString>;
   }, z.core.$strict>>;
   total: z.ZodNumber;
   page: z.ZodNumber;
@@ -108,5 +114,5 @@ declare const DownloadAssetParams: z.ZodObject<{
 }, z.core.$strip>;
 type DownloadAssetParams = z.infer<typeof DownloadAssetParams>;
 //#endregion
-export { AddDownloadAsset, CreateDownload, Download, DownloadAsset, DownloadAssetParams, DownloadIdParam, DownloadStatus, DownloadsPage, DownloadsQuery, RenameDownloadAsset, ReorderDownloadAssets, UpdateDownload };
+export { AddDownloadAsset, CreateDownload, Download, DownloadAssetParams, DownloadFile, DownloadIdParam, DownloadStatus, DownloadsPage, DownloadsQuery, RenameDownloadAsset, ReorderDownloadAssets, UpdateDownload };
 //# sourceMappingURL=downloads.d.ts.map

package/dist/http/schemas/downloads.js

@@ -1,27 +1,30 @@
 import { ListQuery, paginated } from "./shared.js";
 import { z } from "zod";
-import { addDownloadAssetInputSchema, downloadAssetSchema, downloadSchema, downloadStatusSchema, reorderDownloadAssetsInputSchema } from "@headless-lms/core/schemas";
+import { addDownloadAssetInputSchema, downloadFileSchema, downloadStatusSchema, downloadViewSchema, idSchema, reorderDownloadAssetsInputSchema } from "@headless-lms/core/schemas";
 //#region src/http/schemas/downloads.ts
 const DownloadStatus = downloadStatusSchema;
-const Download = downloadSchema;
-const DownloadAsset = downloadAssetSchema;
+const Download = downloadViewSchema;
+const DownloadFile = downloadFileSchema;
 const CreateDownload = 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 UpdateDownload = CreateDownload.partial().extend({
+const UpdateDownload = 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: DownloadStatus.optional(),
-	thumbnailAssetId: z.string().nullable().optional()
+	thumbnailAssetId: idSchema.nullable().optional()
 });
 const DownloadsQuery = ListQuery.extend({
 	status: DownloadStatus.optional(),
-	category: z.string().optional()
+	category: z.string().trim().max(100).optional()
 });
 const DownloadsPage = paginated(Download);
 const AddDownloadAsset = addDownloadAssetInputSchema;
 /** `null` restores the `filename` fallback. */
-const RenameDownloadAsset = z.object({ displayName: z.string().nullable() });
+const RenameDownloadAsset = z.object({ displayName: z.string().trim().min(1).max(255).nullable() });
 const ReorderDownloadAssets = reorderDownloadAssetsInputSchema;
 const DownloadIdParam = z.object({ downloadId: z.string() });
 const DownloadAssetParams = z.object({
@@ -29,6 +32,6 @@ const DownloadAssetParams = z.object({
 	assetId: z.string()
 });
 //#endregion
-export { AddDownloadAsset, CreateDownload, Download, DownloadAsset, DownloadAssetParams, DownloadIdParam, DownloadStatus, DownloadsPage, DownloadsQuery, RenameDownloadAsset, ReorderDownloadAssets, UpdateDownload };
+export { AddDownloadAsset, CreateDownload, Download, DownloadAssetParams, DownloadFile, DownloadIdParam, DownloadStatus, DownloadsPage, DownloadsQuery, RenameDownloadAsset, ReorderDownloadAssets, UpdateDownload };
 
 //# sourceMappingURL=downloads.js.map

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

@@ -1 +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"}
+{"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  downloadFileSchema,\n  downloadStatusSchema,\n  downloadViewSchema,\n  reorderDownloadAssetsInputSchema,\n  idSchema,\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 = downloadViewSchema;\nexport type Download = z.infer<typeof Download>;\n\nexport const DownloadFile = downloadFileSchema;\nexport type DownloadFile = z.infer<typeof DownloadFile>;\n\nexport const CreateDownload = 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 CreateDownload = z.infer<typeof CreateDownload>;\n\nexport const UpdateDownload = 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: DownloadStatus.optional(),\n  thumbnailAssetId: idSchema.nullable().optional(),\n});\nexport type UpdateDownload = z.infer<typeof UpdateDownload>;\n\nexport const DownloadsQuery = ListQuery.extend({\n  status: DownloadStatus.optional(),\n  category: z.string().trim().max(100).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().trim().min(1).max(255).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":";;;;AAeA,MAAa,iBAAiB;AAG9B,MAAa,WAAW;AAGxB,MAAa,eAAe;AAG5B,MAAa,iBAAiB,EAAE,OAAO;CACrC,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,iBAAiB,EAAE,OAAO;CACrC,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,eAAe,SAAS;CAChC,kBAAkB,SAAS,SAAS,CAAC,CAAC,SAAS;AACjD,CAAC;AAGD,MAAa,iBAAiB,UAAU,OAAO;CAC7C,QAAQ,eAAe,SAAS;CAChC,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS;AAChD,CAAC;AAGD,MAAa,gBAAgB,UAAU,QAAQ;AAG/C,MAAa,mBAAmB;;AAIhC,MAAa,sBAAsB,EAAE,OAAO,EAC1C,aAAa,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,EAC1D,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"}

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

@@ -2,13 +2,13 @@ import { z } from "zod";
 //#region src/http/schemas/entitlements.d.ts
 declare const EntitlementStatus: z.ZodEnum<{
   active: "active";
-  expired: "expired";
   revoked: "revoked";
+  expired: "expired";
 }>;
 type EntitlementStatus = z.infer<typeof EntitlementStatus>;
 declare const ContentType: z.ZodEnum<{
-  download: "download";
   course: "course";
+  download: "download";
 }>;
 type ContentType = z.infer<typeof ContentType>;
 /** Reference to the granted content: identity + display name (join-derived).
@@ -16,8 +16,8 @@ type ContentType = z.infer<typeof ContentType>;
 declare const ContentRef: z.ZodObject<{
   id: z.ZodString;
   type: z.ZodEnum<{
-    download: "download";
     course: "course";
+    download: "download";
   }>;
   title: z.ZodString;
 }, z.core.$strip>;
@@ -46,15 +46,15 @@ declare const EntitlementsQuery: z.ZodObject<{
   sort: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
     active: "active";
-    expired: "expired";
     revoked: "revoked";
+    expired: "expired";
   }>>;
   source: z.ZodOptional<z.ZodString>;
   orgUserId: z.ZodOptional<z.ZodString>;
   contentId: z.ZodOptional<z.ZodString>;
   type: z.ZodOptional<z.ZodEnum<{
-    download: "download";
     course: "course";
+    download: "download";
   }>>;
 }, z.core.$strip>;
 type EntitlementsQuery = z.infer<typeof EntitlementsQuery>;
@@ -85,7 +85,7 @@ declare const GrantEntitlement: z.ZodObject<{
   orgUserId: z.ZodString;
   contentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   bundleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  expiresAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+  expiresAt: z.ZodNullable<z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>>;
 }, z.core.$strip>;
 type GrantEntitlement = z.infer<typeof GrantEntitlement>;
 /** Revoke/reinstate access by setting the active|revoked status. */

package/dist/http/schemas/entitlements.js

@@ -1,6 +1,6 @@
-import { ListQuery, paginated } from "./shared.js";
+import { DateTimeInput, ListQuery, paginated } from "./shared.js";
 import { z } from "zod";
-import { entitlementSchema } from "@headless-lms/core/schemas";
+import { entitlementSchema, idSchema } from "@headless-lms/core/schemas";
 //#region src/http/schemas/entitlements.ts
 const EntitlementStatus = z.enum([
 	"active",
@@ -29,10 +29,10 @@ const EntitlementsQuery = ListQuery.extend({
 const EntitlementsPage = paginated(Entitlement);
 /** A grant targets exactly one of: a single content item or a bundle. */
 const GrantEntitlement = z.object({
-	orgUserId: z.string(),
-	contentId: z.string().nullish(),
-	bundleId: z.string().nullish(),
-	expiresAt: z.coerce.date().nullable()
+	orgUserId: idSchema,
+	contentId: idSchema.nullish(),
+	bundleId: idSchema.nullish(),
+	expiresAt: DateTimeInput.nullable().describe("When access ends; null never expires")
 }).refine((v) => v.contentId != null !== (v.bundleId != null), { message: "Provide exactly one of contentId or bundleId" });
 /** Revoke/reinstate access by setting the active|revoked status. */
 const SetEntitlementStatus = z.object({ status: z.enum(["active", "revoked"]) });