@timeback/sdk 0.1.5 → 0.1.6

package/dist/server/adapters/solid-start.js

@@ -15391,7 +15391,7 @@ var TimebackSubject = exports_external.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade = exports_external.union([
   exports_external.literal(-1),
   exports_external.literal(0),
@@ -15408,7 +15408,10 @@ var TimebackGrade = exports_external.union([
   exports_external.literal(11),
   exports_external.literal(12),
   exports_external.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus = exports_external.enum([
   "exempt",
   "fully graded",
@@ -15638,62 +15641,84 @@ var CaliperListEventsParams = exports_external.object({
   actorEmail: exports_external.email().optional()
 }).strict();
 var CourseIds = exports_external.object({
-  staging: exports_external.string().optional(),
-  production: exports_external.string().optional()
-});
-var CourseType = exports_external.enum(["base", "hole-filling", "optional"]);
-var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType = exports_external.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals = exports_external.object({
-  dailyXp: exports_external.number().int().positive().optional(),
-  dailyLessons: exports_external.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external.number().int().positive().optional(),
-  dailyAccuracy: exports_external.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external.number().int().positive().optional()
-});
+  dailyXp: exports_external.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics = exports_external.object({
-  totalXp: exports_external.number().int().positive().optional(),
-  totalLessons: exports_external.number().int().positive().optional(),
-  totalGrades: exports_external.number().int().positive().optional()
-});
+  totalXp: exports_external.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata = exports_external.object({
   courseType: CourseType.optional(),
-  isSupplemental: exports_external.boolean().optional(),
-  isCustom: exports_external.boolean().optional(),
+  isSupplemental: exports_external.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus.optional(),
-  contactEmail: exports_external.email().optional(),
-  primaryApp: exports_external.string().optional(),
+  contactEmail: exports_external.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals.optional(),
   metrics: CourseMetrics.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults = exports_external.object({
-  courseCode: exports_external.string().optional(),
-  level: exports_external.string().optional(),
+  courseCode: exports_external.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides = exports_external.object({
-  level: exports_external.string().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  level: exports_external.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides = exports_external.object({
-  staging: CourseEnvOverrides.optional(),
-  production: CourseEnvOverrides.optional()
-});
+  staging: CourseEnvOverrides.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig = CourseDefaults.extend({
-  subject: TimebackSubject,
-  grade: TimebackGrade.optional(),
+  subject: TimebackSubject.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds.nullable().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig = exports_external.object({
-  name: exports_external.string().min(1, "App name is required"),
-  defaults: CourseDefaults.optional(),
-  courses: exports_external.array(CourseConfig).min(1, "At least one course is required"),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional()
+  $schema: exports_external.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external.array(CourseConfig).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config2) => {
   return config2.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -31769,7 +31794,7 @@ var TimebackSubject2 = exports_external2.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade2 = exports_external2.union([
   exports_external2.literal(-1),
   exports_external2.literal(0),
@@ -31786,7 +31811,10 @@ var TimebackGrade2 = exports_external2.union([
   exports_external2.literal(11),
   exports_external2.literal(12),
   exports_external2.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus2 = exports_external2.enum([
   "exempt",
   "fully graded",
@@ -32016,62 +32044,84 @@ var CaliperListEventsParams2 = exports_external2.object({
   actorEmail: exports_external2.email().optional()
 }).strict();
 var CourseIds2 = exports_external2.object({
-  staging: exports_external2.string().optional(),
-  production: exports_external2.string().optional()
-});
-var CourseType2 = exports_external2.enum(["base", "hole-filling", "optional"]);
-var PublishStatus2 = exports_external2.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external2.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external2.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType2 = exports_external2.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus2 = exports_external2.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals2 = exports_external2.object({
-  dailyXp: exports_external2.number().int().positive().optional(),
-  dailyLessons: exports_external2.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external2.number().int().positive().optional(),
-  dailyAccuracy: exports_external2.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external2.number().int().positive().optional()
-});
+  dailyXp: exports_external2.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external2.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external2.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external2.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external2.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics2 = exports_external2.object({
-  totalXp: exports_external2.number().int().positive().optional(),
-  totalLessons: exports_external2.number().int().positive().optional(),
-  totalGrades: exports_external2.number().int().positive().optional()
-});
+  totalXp: exports_external2.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external2.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external2.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata2 = exports_external2.object({
   courseType: CourseType2.optional(),
-  isSupplemental: exports_external2.boolean().optional(),
-  isCustom: exports_external2.boolean().optional(),
+  isSupplemental: exports_external2.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external2.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus2.optional(),
-  contactEmail: exports_external2.email().optional(),
-  primaryApp: exports_external2.string().optional(),
+  contactEmail: exports_external2.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external2.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals2.optional(),
   metrics: CourseMetrics2.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults2 = exports_external2.object({
-  courseCode: exports_external2.string().optional(),
-  level: exports_external2.string().optional(),
+  courseCode: exports_external2.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external2.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata2.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides2 = exports_external2.object({
-  level: exports_external2.string().optional(),
-  sensor: exports_external2.string().url().optional(),
-  launchUrl: exports_external2.string().url().optional(),
+  level: exports_external2.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external2.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external2.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata2.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides2 = exports_external2.object({
-  staging: CourseEnvOverrides2.optional(),
-  production: CourseEnvOverrides2.optional()
-});
+  staging: CourseEnvOverrides2.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides2.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig2 = CourseDefaults2.extend({
-  subject: TimebackSubject2,
-  grade: TimebackGrade2.optional(),
+  subject: TimebackSubject2.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade2.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds2.nullable().optional(),
-  sensor: exports_external2.string().url().optional(),
-  launchUrl: exports_external2.string().url().optional(),
+  sensor: exports_external2.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external2.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides2.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig2 = exports_external2.object({
-  name: exports_external2.string().min(1, "App name is required"),
-  defaults: CourseDefaults2.optional(),
-  courses: exports_external2.array(CourseConfig2).min(1, "At least one course is required"),
-  sensor: exports_external2.string().url().optional(),
-  launchUrl: exports_external2.string().url().optional()
+  $schema: exports_external2.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external2.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults2.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external2.array(CourseConfig2).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external2.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external2.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -49177,7 +49227,7 @@ var TimebackSubject3 = exports_external3.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade3 = exports_external3.union([
   exports_external3.literal(-1),
   exports_external3.literal(0),
@@ -49194,7 +49244,10 @@ var TimebackGrade3 = exports_external3.union([
   exports_external3.literal(11),
   exports_external3.literal(12),
   exports_external3.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus3 = exports_external3.enum([
   "exempt",
   "fully graded",
@@ -49424,62 +49477,84 @@ var CaliperListEventsParams3 = exports_external3.object({
   actorEmail: exports_external3.email().optional()
 }).strict();
 var CourseIds3 = exports_external3.object({
-  staging: exports_external3.string().optional(),
-  production: exports_external3.string().optional()
-});
-var CourseType3 = exports_external3.enum(["base", "hole-filling", "optional"]);
-var PublishStatus3 = exports_external3.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external3.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external3.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType3 = exports_external3.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus3 = exports_external3.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals3 = exports_external3.object({
-  dailyXp: exports_external3.number().int().positive().optional(),
-  dailyLessons: exports_external3.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external3.number().int().positive().optional(),
-  dailyAccuracy: exports_external3.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external3.number().int().positive().optional()
-});
+  dailyXp: exports_external3.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external3.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external3.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external3.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external3.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics3 = exports_external3.object({
-  totalXp: exports_external3.number().int().positive().optional(),
-  totalLessons: exports_external3.number().int().positive().optional(),
-  totalGrades: exports_external3.number().int().positive().optional()
-});
+  totalXp: exports_external3.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external3.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external3.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata3 = exports_external3.object({
   courseType: CourseType3.optional(),
-  isSupplemental: exports_external3.boolean().optional(),
-  isCustom: exports_external3.boolean().optional(),
+  isSupplemental: exports_external3.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external3.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus3.optional(),
-  contactEmail: exports_external3.email().optional(),
-  primaryApp: exports_external3.string().optional(),
+  contactEmail: exports_external3.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external3.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals3.optional(),
   metrics: CourseMetrics3.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults3 = exports_external3.object({
-  courseCode: exports_external3.string().optional(),
-  level: exports_external3.string().optional(),
+  courseCode: exports_external3.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external3.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata3.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides3 = exports_external3.object({
-  level: exports_external3.string().optional(),
-  sensor: exports_external3.string().url().optional(),
-  launchUrl: exports_external3.string().url().optional(),
+  level: exports_external3.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external3.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external3.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata3.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides3 = exports_external3.object({
-  staging: CourseEnvOverrides3.optional(),
-  production: CourseEnvOverrides3.optional()
-});
+  staging: CourseEnvOverrides3.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides3.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig3 = CourseDefaults3.extend({
-  subject: TimebackSubject3,
-  grade: TimebackGrade3.optional(),
+  subject: TimebackSubject3.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade3.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds3.nullable().optional(),
-  sensor: exports_external3.string().url().optional(),
-  launchUrl: exports_external3.string().url().optional(),
+  sensor: exports_external3.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external3.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides3.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig3 = exports_external3.object({
-  name: exports_external3.string().min(1, "App name is required"),
-  defaults: CourseDefaults3.optional(),
-  courses: exports_external3.array(CourseConfig3).min(1, "At least one course is required"),
-  sensor: exports_external3.string().url().optional(),
-  launchUrl: exports_external3.string().url().optional()
+  $schema: exports_external3.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external3.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults3.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external3.array(CourseConfig3).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external3.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external3.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -66784,7 +66859,7 @@ var TimebackSubject4 = exports_external4.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade4 = exports_external4.union([
   exports_external4.literal(-1),
   exports_external4.literal(0),
@@ -66801,7 +66876,10 @@ var TimebackGrade4 = exports_external4.union([
   exports_external4.literal(11),
   exports_external4.literal(12),
   exports_external4.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus4 = exports_external4.enum([
   "exempt",
   "fully graded",
@@ -67031,62 +67109,84 @@ var CaliperListEventsParams4 = exports_external4.object({
   actorEmail: exports_external4.email().optional()
 }).strict();
 var CourseIds4 = exports_external4.object({
-  staging: exports_external4.string().optional(),
-  production: exports_external4.string().optional()
-});
-var CourseType4 = exports_external4.enum(["base", "hole-filling", "optional"]);
-var PublishStatus4 = exports_external4.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external4.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external4.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType4 = exports_external4.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus4 = exports_external4.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals4 = exports_external4.object({
-  dailyXp: exports_external4.number().int().positive().optional(),
-  dailyLessons: exports_external4.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external4.number().int().positive().optional(),
-  dailyAccuracy: exports_external4.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external4.number().int().positive().optional()
-});
+  dailyXp: exports_external4.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external4.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external4.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external4.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external4.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics4 = exports_external4.object({
-  totalXp: exports_external4.number().int().positive().optional(),
-  totalLessons: exports_external4.number().int().positive().optional(),
-  totalGrades: exports_external4.number().int().positive().optional()
-});
+  totalXp: exports_external4.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external4.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external4.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata4 = exports_external4.object({
   courseType: CourseType4.optional(),
-  isSupplemental: exports_external4.boolean().optional(),
-  isCustom: exports_external4.boolean().optional(),
+  isSupplemental: exports_external4.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external4.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus4.optional(),
-  contactEmail: exports_external4.email().optional(),
-  primaryApp: exports_external4.string().optional(),
+  contactEmail: exports_external4.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external4.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals4.optional(),
   metrics: CourseMetrics4.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults4 = exports_external4.object({
-  courseCode: exports_external4.string().optional(),
-  level: exports_external4.string().optional(),
+  courseCode: exports_external4.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external4.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata4.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides4 = exports_external4.object({
-  level: exports_external4.string().optional(),
-  sensor: exports_external4.string().url().optional(),
-  launchUrl: exports_external4.string().url().optional(),
+  level: exports_external4.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external4.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external4.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata4.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides4 = exports_external4.object({
-  staging: CourseEnvOverrides4.optional(),
-  production: CourseEnvOverrides4.optional()
-});
+  staging: CourseEnvOverrides4.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides4.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig4 = CourseDefaults4.extend({
-  subject: TimebackSubject4,
-  grade: TimebackGrade4.optional(),
+  subject: TimebackSubject4.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade4.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds4.nullable().optional(),
-  sensor: exports_external4.string().url().optional(),
-  launchUrl: exports_external4.string().url().optional(),
+  sensor: exports_external4.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external4.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides4.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig4 = exports_external4.object({
-  name: exports_external4.string().min(1, "App name is required"),
-  defaults: CourseDefaults4.optional(),
-  courses: exports_external4.array(CourseConfig4).min(1, "At least one course is required"),
-  sensor: exports_external4.string().url().optional(),
-  launchUrl: exports_external4.string().url().optional()
+  $schema: exports_external4.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external4.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults4.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external4.array(CourseConfig4).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external4.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external4.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -83421,7 +83521,7 @@ var TimebackSubject5 = exports_external5.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade5 = exports_external5.union([
   exports_external5.literal(-1),
   exports_external5.literal(0),
@@ -83438,7 +83538,10 @@ var TimebackGrade5 = exports_external5.union([
   exports_external5.literal(11),
   exports_external5.literal(12),
   exports_external5.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus5 = exports_external5.enum([
   "exempt",
   "fully graded",
@@ -83668,62 +83771,84 @@ var CaliperListEventsParams5 = exports_external5.object({
   actorEmail: exports_external5.email().optional()
 }).strict();
 var CourseIds5 = exports_external5.object({
-  staging: exports_external5.string().optional(),
-  production: exports_external5.string().optional()
-});
-var CourseType5 = exports_external5.enum(["base", "hole-filling", "optional"]);
-var PublishStatus5 = exports_external5.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external5.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external5.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType5 = exports_external5.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus5 = exports_external5.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals5 = exports_external5.object({
-  dailyXp: exports_external5.number().int().positive().optional(),
-  dailyLessons: exports_external5.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external5.number().int().positive().optional(),
-  dailyAccuracy: exports_external5.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external5.number().int().positive().optional()
-});
+  dailyXp: exports_external5.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external5.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external5.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external5.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external5.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics5 = exports_external5.object({
-  totalXp: exports_external5.number().int().positive().optional(),
-  totalLessons: exports_external5.number().int().positive().optional(),
-  totalGrades: exports_external5.number().int().positive().optional()
-});
+  totalXp: exports_external5.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external5.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external5.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata5 = exports_external5.object({
   courseType: CourseType5.optional(),
-  isSupplemental: exports_external5.boolean().optional(),
-  isCustom: exports_external5.boolean().optional(),
+  isSupplemental: exports_external5.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external5.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus5.optional(),
-  contactEmail: exports_external5.email().optional(),
-  primaryApp: exports_external5.string().optional(),
+  contactEmail: exports_external5.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external5.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals5.optional(),
   metrics: CourseMetrics5.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults5 = exports_external5.object({
-  courseCode: exports_external5.string().optional(),
-  level: exports_external5.string().optional(),
+  courseCode: exports_external5.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external5.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata5.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides5 = exports_external5.object({
-  level: exports_external5.string().optional(),
-  sensor: exports_external5.string().url().optional(),
-  launchUrl: exports_external5.string().url().optional(),
+  level: exports_external5.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external5.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external5.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata5.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides5 = exports_external5.object({
-  staging: CourseEnvOverrides5.optional(),
-  production: CourseEnvOverrides5.optional()
-});
+  staging: CourseEnvOverrides5.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides5.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig5 = CourseDefaults5.extend({
-  subject: TimebackSubject5,
-  grade: TimebackGrade5.optional(),
+  subject: TimebackSubject5.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade5.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds5.nullable().optional(),
-  sensor: exports_external5.string().url().optional(),
-  launchUrl: exports_external5.string().url().optional(),
+  sensor: exports_external5.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external5.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides5.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig5 = exports_external5.object({
-  name: exports_external5.string().min(1, "App name is required"),
-  defaults: CourseDefaults5.optional(),
-  courses: exports_external5.array(CourseConfig5).min(1, "At least one course is required"),
-  sensor: exports_external5.string().url().optional(),
-  launchUrl: exports_external5.string().url().optional()
+  $schema: exports_external5.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external5.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults5.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external5.array(CourseConfig5).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external5.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external5.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {