@anantagnanam/lms 0.1.0 → 0.3.0

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { cohortDataSchema, courseDataSchema, lessonSchema, moduleSchema, questionSchema, quizSchema, settingsSchema } from "./schemas.js";
+import { cohortDataSchema, courseDataSchema, lessonSchema, moduleSchema, pathDataSchema, preferencesSchema, questionSchema, quizSchema, rubricCriterionSchema, rubricScoreSchema, settingsSchema } from "./schemas.js";
 import { z } from "zod";
 
 //#region src/types.d.ts
@@ -7,6 +7,8 @@ type CourseModule = z.infer<typeof moduleSchema>;
 type Lesson = z.infer<typeof lessonSchema>;
 type QuizQuestion = z.infer<typeof questionSchema>;
 type Quiz = z.infer<typeof quizSchema>;
+type RubricCriterion = z.infer<typeof rubricCriterionSchema>;
+type RubricScore = z.infer<typeof rubricScoreSchema>;
 type LmsSettings = z.infer<typeof settingsSchema>;
 interface Course extends CourseData {
   id: string;
@@ -14,7 +16,39 @@ interface Course extends CourseData {
   createdBy: string;
   createdAt: string;
   updatedAt: string;
-  schemaVersion: 1;
+  schemaVersion: 1 | 2;
+  draftRevisionId?: string;
+  publishedEditionId?: string;
+  publishedDraftRevisionId?: string;
+  legacyEditionId?: string;
+}
+interface CourseRevision {
+  id: string;
+  courseId: string;
+  parentId: string | null;
+  data: CourseData;
+  kind: "migration" | "draft" | "publish" | "restore" | "archive";
+  createdBy: string;
+  createdAt: string;
+  editionId?: string;
+  restoredFrom?: string;
+}
+type RevisionSummary = Omit<CourseRevision, "data"> & {
+  title: string;
+};
+interface CourseEdition {
+  id: string;
+  courseId: string;
+  data: CourseData;
+  createdAt: string;
+}
+interface MigrationState {
+  phase: "courses" | "enrollments" | "complete";
+  cursor?: string;
+  coursesProcessed: number;
+  enrollmentsProcessed: number;
+  updatedAt: string;
+  lastError: string | null;
 }
 interface Actor {
   id: string;
@@ -49,8 +83,12 @@ interface QuizAttempt {
   passed: boolean;
   feedback: QuestionResult[];
   answers: Answers;
+  /** Records created before draft fencing have revision zero. */
+  draftRevision?: number;
 }
-type PublicQuizAttempt = Omit<QuizAttempt, "quiz">;
+type PublicQuizAttempt = Omit<QuizAttempt, "quiz" | "draftRevision"> & {
+  draftRevision: number;
+};
 interface AssignmentSubmission {
   id: string;
   body: string;
@@ -63,13 +101,132 @@ interface AssignmentSubmission {
   feedback: string;
   gradedAt: string | null;
   gradedBy: string | null;
+  /** Criteria are frozen from the learner's course edition at submission. */
+  rubric?: RubricCriterion[];
+  rubricScores?: RubricScore[];
+}
+interface AssignmentDraft {
+  body: string;
+  attachmentUrl: string | null;
+  revision: number;
+  updatedAt: string | null;
+}
+interface AssignmentState {
+  draft: AssignmentDraft;
+  submission: AssignmentSubmission | null;
+  canSubmit: boolean;
+  closedReason: string | null;
 }
 interface LessonProgress {
   startedAt: string | null;
   completedAt: string | null;
   note: string;
+  noteRevision?: number;
   quizAttempts: QuizAttempt[];
   assignments: AssignmentSubmission[];
+  assignmentDraft?: AssignmentDraft;
+  playback?: Playback;
+}
+interface Playback {
+  positionSeconds: number;
+  playbackRate: number;
+  revision: number;
+  updatedAt: string;
+}
+interface StudyNote {
+  id: string;
+  lessonId: string;
+  lessonTitle: string;
+  body: string;
+  positionSeconds: number | null;
+  starred: boolean;
+  archived: boolean;
+  revision: number;
+  createdAt: string;
+  updatedAt: string;
+}
+interface Notebook {
+  course: {
+    id: string;
+    title: string;
+    slug: string;
+  };
+  notes: StudyNote[];
+  summaries: {
+    lessonId: string;
+    lessonTitle: string;
+    body: string;
+  }[];
+  availableLessonIds: string[];
+}
+interface CourseAgenda {
+  course: {
+    id: string;
+    title: string;
+    slug: string;
+  };
+  generatedAt: string;
+  events: {
+    id: string;
+    kind: "assignment" | "live" | "release";
+    lessonId: string;
+    title: string;
+    startsAt: string;
+    endsAt: string | null;
+    available: boolean;
+    reason: string | null;
+    status: "upcoming" | "overdue" | "submitted" | "completed" | "past";
+  }[];
+}
+type LearnerPreferences = z.infer<typeof preferencesSchema>;
+interface SavedCourse {
+  userId: string;
+  courseId: string;
+  saved: boolean;
+  updatedAt: string;
+}
+interface LearningPath extends z.infer<typeof pathDataSchema> {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+}
+interface PathEnrollment {
+  pathId: string;
+  userId: string;
+  title: string;
+  courseIds: string[];
+  joinedAt: string;
+}
+interface PublicPath {
+  id: string;
+  title: string;
+  description: string;
+  courses: (CourseCard | null)[];
+}
+interface LearnerPath {
+  pathId: string;
+  title: string;
+  joinedAt: string;
+  completed: number;
+  total: number;
+  courses: {
+    course: CourseCard | null;
+    completed: boolean;
+  }[];
+}
+interface LmsHealth {
+  version: string;
+  maintenance: {
+    startedAt: string;
+    completedAt: string | null;
+    failed: boolean;
+  } | null;
+  maintenanceStale: boolean;
+  pendingEmails: number;
+  failedEmails: number;
+  oldestPendingAt: string | null;
+  emailEnabled: boolean;
+  migration: MigrationState | null;
 }
 interface Certificate {
   id: string;
@@ -86,6 +243,8 @@ interface Certificate {
 interface Enrollment {
   id: string;
   courseId: string;
+  /** Immutable curriculum selected at enrollment; v1 records use the course's legacy edition. */
+  courseEditionId?: string;
   userId: string;
   learnerName: string;
   learnerEmail: string;
@@ -105,6 +264,7 @@ interface Enrollment {
   accessExpiresAt: string | null;
   cohortId: string | null;
   progress: Record<string, LessonProgress>;
+  studyNotes?: StudyNote[];
   certificate: Certificate | null;
   completionLessonIds: string[];
   lastActivityAt: string;
@@ -265,6 +425,14 @@ interface ProgressSummary {
   total: number;
   percent: number;
   nextLessonId: string | null;
+  blockedLessonId: string | null;
+  availability: Record<string, LessonAvailability>;
+}
+interface LessonAvailability {
+  available: boolean;
+  code: string | null;
+  reason: string | null;
+  releaseAt: string | null;
 }
 interface LmsOptions {
   basePath?: string;
@@ -280,5 +448,5 @@ interface RouteEnvelope<T> {
   };
 }
 //#endregion
-export { AccessGrant, Acquisition, Actor, Answers, AssignmentSubmission, AuditRecord, Certificate, CertificateIndex, Cohort, CohortMembership, Course, CourseCard, CourseData, CourseDetail, CourseModule, CurriculumLesson, CurriculumModule, Discussion, Enrollment, Lesson, LessonProgress, LmsOptions, LmsSettings, Notification, Page, ProgressSummary, PublicEnrollment, PublicLesson, PublicQuestion, PublicQuizAttempt, QuestionResult, Quiz, QuizAttempt, QuizQuestion, Review, RouteEnvelope, Versioned };
+export { AccessGrant, Acquisition, Actor, Answers, AssignmentDraft, AssignmentState, AssignmentSubmission, AuditRecord, Certificate, CertificateIndex, Cohort, CohortMembership, Course, CourseAgenda, CourseCard, CourseData, CourseDetail, CourseEdition, CourseModule, CourseRevision, CurriculumLesson, CurriculumModule, Discussion, Enrollment, LearnerPath, LearnerPreferences, LearningPath, Lesson, LessonAvailability, LessonProgress, LmsHealth, LmsOptions, LmsSettings, MigrationState, Notebook, Notification, Page, PathEnrollment, Playback, ProgressSummary, PublicEnrollment, PublicLesson, PublicPath, PublicQuestion, PublicQuizAttempt, QuestionResult, Quiz, QuizAttempt, QuizQuestion, Review, RevisionSummary, RouteEnvelope, RubricCriterion, RubricScore, SavedCourse, StudyNote, Versioned };
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anantagnanam/lms",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Courses, assessments, enrollment, progress, certificates and learning communities for EmDash CMS.",
   "type": "module",
   "license": "MIT",

package/dist/constants-C0kT94tc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-C0kT94tc.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["export const PLUGIN_ID = \"anantagnanam-lms\";\nexport const PLUGIN_VERSION = \"0.1.0\";\nexport const API_BASE = `/_emdash/api/plugins/${PLUGIN_ID}`;\nexport const MAX_DOCUMENT_BYTES = 950_000;\n\nimport type { PluginStorageConfig } from \"emdash\";\n\nexport const storage = {\n  courses: {\n    indexes: [\n      \"status\",\n      \"title\",\n      \"searchTitle\",\n      \"category\",\n      \"level\",\n      \"language\",\n      \"updatedAt\",\n      \"createdBy\",\n    ],\n    uniqueIndexes: [\"slug\"],\n  },\n  enrollments: {\n    indexes: [\n      \"userId\",\n      \"courseId\",\n      \"status\",\n      \"accessStatus\",\n      \"accessSource\",\n      \"enrolledAt\",\n      \"completedAt\",\n      \"lastActivityAt\",\n      \"cohortId\",\n      [\"courseId\", \"status\"],\n      [\"userId\", \"status\"],\n    ],\n  },\n  certificates: { indexes: [\"userId\", \"courseId\"] },\n  discussions: {\n    indexes: [\n      \"courseId\",\n      \"lessonId\",\n      \"authorId\",\n      \"status\",\n      \"createdAt\",\n      \"parentId\",\n      [\"courseId\", \"createdAt\"],\n    ],\n  },\n  reviews: { indexes: [\"courseId\", \"userId\", \"status\", \"createdAt\"] },\n  cohorts: { indexes: [\"title\", \"createdAt\", \"createdBy\"] },\n  cohort_enrollments: { indexes: [\"cohortId\", \"userId\", \"status\", \"requestedAt\"] },\n  notifications: { indexes: [\"userId\", \"read\", \"createdAt\", \"emailStatus\", \"claimedAt\"] },\n  audit: { indexes: [\"actorId\", \"action\", \"resourceId\", \"createdAt\"] },\n} satisfies PluginStorageConfig;\n\nexport const adminPages = [\n  { path: \"/\", label: \"Learning overview\", icon: \"graduation-cap\", group: \"Learning\" },\n  { path: \"/courses\", label: \"Courses\", icon: \"books\", group: \"Learning\" },\n  { path: \"/learners\", label: \"Enrollments\", icon: \"users\", group: \"Learning\" },\n  { path: \"/assignments\", label: \"Assignments\", icon: \"exam\", group: \"Learning\" },\n  { path: \"/community\", label: \"Community\", icon: \"chats\", group: \"Learning\" },\n  { path: \"/cohorts\", label: \"Cohorts\", icon: \"users-three\", group: \"Learning\" },\n  { path: \"/reports\", label: \"Reports\", icon: \"chart-bar\", group: \"Learning\" },\n  { path: \"/notifications\", label: \"Notifications\", icon: \"bell\", group: \"Learning\" },\n  { path: \"/audit\", label: \"Audit history\", icon: \"clock-counter-clockwise\", group: \"Learning\" },\n  { path: \"/settings\", label: \"LMS settings\", icon: \"gear\", group: \"Learning\" },\n];\n"],"mappings":";AAAA,MAAa,YAAY;AACzB,MAAa,iBAAiB;AAC9B,MAAa,WAAW,wBAAwB;AAChD,MAAa,qBAAqB;AAIlC,MAAa,UAAU;CACrB,SAAS;EACP,SAAS;GACP;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD;EACD,eAAe,CAAC,OAAO;EACxB;CACD,aAAa,EACX,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,CAAC,YAAY,SAAS;EACtB,CAAC,UAAU,SAAS;EACrB,EACF;CACD,cAAc,EAAE,SAAS,CAAC,UAAU,WAAW,EAAE;CACjD,aAAa,EACX,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA,CAAC,YAAY,YAAY;EAC1B,EACF;CACD,SAAS,EAAE,SAAS;EAAC;EAAY;EAAU;EAAU;EAAY,EAAE;CACnE,SAAS,EAAE,SAAS;EAAC;EAAS;EAAa;EAAY,EAAE;CACzD,oBAAoB,EAAE,SAAS;EAAC;EAAY;EAAU;EAAU;EAAc,EAAE;CAChF,eAAe,EAAE,SAAS;EAAC;EAAU;EAAQ;EAAa;EAAe;EAAY,EAAE;CACvF,OAAO,EAAE,SAAS;EAAC;EAAW;EAAU;EAAc;EAAY,EAAE;CACrE;AAED,MAAa,aAAa;CACxB;EAAE,MAAM;EAAK,OAAO;EAAqB,MAAM;EAAkB,OAAO;EAAY;CACpF;EAAE,MAAM;EAAY,OAAO;EAAW,MAAM;EAAS,OAAO;EAAY;CACxE;EAAE,MAAM;EAAa,OAAO;EAAe,MAAM;EAAS,OAAO;EAAY;CAC7E;EAAE,MAAM;EAAgB,OAAO;EAAe,MAAM;EAAQ,OAAO;EAAY;CAC/E;EAAE,MAAM;EAAc,OAAO;EAAa,MAAM;EAAS,OAAO;EAAY;CAC5E;EAAE,MAAM;EAAY,OAAO;EAAW,MAAM;EAAe,OAAO;EAAY;CAC9E;EAAE,MAAM;EAAY,OAAO;EAAW,MAAM;EAAa,OAAO;EAAY;CAC5E;EAAE,MAAM;EAAkB,OAAO;EAAiB,MAAM;EAAQ,OAAO;EAAY;CACnF;EAAE,MAAM;EAAU,OAAO;EAAiB,MAAM;EAA2B,OAAO;EAAY;CAC9F;EAAE,MAAM;EAAa,OAAO;EAAgB,MAAM;EAAQ,OAAO;EAAY;CAC9E"}

package/dist/errors-ChzJS9al.js

@@ -1,16 +0,0 @@
-//#region src/errors.ts
-var LmsError = class extends Error {
-	constructor(code, message, status = 400) {
-		super(message);
-		this.code = code;
-		this.status = status;
-		this.name = "PluginRouteError";
-	}
-};
-function invariant(condition, code, message, status = 400) {
-	if (!condition) throw new LmsError(code, message, status);
-}
-
-//#endregion
-export { invariant as n, LmsError as t };
-//# sourceMappingURL=errors-ChzJS9al.js.map

package/dist/errors-ChzJS9al.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-ChzJS9al.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["export class LmsError extends Error {\n  constructor(\n    readonly code: string,\n    message: string,\n    readonly status = 400,\n  ) {\n    super(message);\n    this.name = \"PluginRouteError\";\n  }\n}\n\nexport function invariant(\n  condition: unknown,\n  code: string,\n  message: string,\n  status = 400,\n): asserts condition {\n  if (!condition) throw new LmsError(code, message, status);\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAClC,YACE,AAAS,MACT,SACA,AAAS,SAAS,KAClB;AACA,QAAM,QAAQ;EAJL;EAEA;AAGT,OAAK,OAAO;;;AAIhB,SAAgB,UACd,WACA,MACA,SACA,SAAS,KACU;AACnB,KAAI,CAAC,UAAW,OAAM,IAAI,SAAS,MAAM,SAAS,OAAO"}