@timeback/sdk 0.1.5 → 0.1.7

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

@@ -434,12 +434,32 @@ async function getUserInfo(params) {
   return response.json();
 }
 // src/server/lib/utils.ts
+function safeIdSegment(value) {
+  return encodeURIComponent(value).replace(/%/g, "_");
+}
+function hashSuffix64Base36(value) {
+  let hash = 0xcbf29ce484222325n;
+  const prime = 0x100000001b3n;
+  const mod64 = 0xffffffffffffffffn;
+  for (let i = 0;i < value.length; i++) {
+    hash ^= BigInt(value.charCodeAt(i));
+    hash = hash * prime & mod64;
+  }
+  const base36 = hash.toString(36);
+  return base36.length > 12 ? base36.slice(-12) : base36;
+}
 function mapEnvForApi(env) {
   if (env === "local" || env === "staging") {
     return "staging";
   }
   return "production";
 }
+function normalizeEnv(env) {
+  if (env === "production" || env === "local" || env === "staging") {
+    return env;
+  }
+  return "staging";
+}
 function jsonResponse(data, status = 200, headers) {
   const responseHeaders = new Headers(headers);
   responseHeaders.set("Content-Type", "application/json");
@@ -15391,7 +15411,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 +15428,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 +15661,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);
 }, {
@@ -15714,14 +15759,20 @@ var TimebackConfig = exports_external.object({
   message: "Duplicate courseCode found; each must be unique",
   path: ["courses"]
 }).refine((config2) => {
-  return config2.courses.every((c) => c.sensor !== undefined || config2.sensor !== undefined);
-}, {
-  message: "Each course must have an effective sensor; set a top-level `sensor` or per-course `sensor`",
-  path: ["courses"]
-}).refine((config2) => {
-  return config2.courses.every((c) => c.launchUrl !== undefined || config2.launchUrl !== undefined);
+  return config2.courses.every((c) => {
+    if (c.sensor !== undefined || config2.sensor !== undefined) {
+      return true;
+    }
+    const launchUrls = [
+      c.launchUrl,
+      config2.launchUrl,
+      c.overrides?.staging?.launchUrl,
+      c.overrides?.production?.launchUrl
+    ].filter(Boolean);
+    return launchUrls.length > 0;
+  });
 }, {
-  message: "Each course must have an effective launchUrl; set a top-level `launchUrl` or per-course `launchUrl`",
+  message: "Each course must have an effective sensor. Either set `sensor` explicitly (top-level or per-course), or provide a `launchUrl` so sensor can be derived from its origin.",
   path: ["courses"]
 });
 var EdubridgeDateString = exports_external.union([IsoDateString, IsoDateTimeString]);
@@ -31769,7 +31820,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 +31837,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 +32070,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);
 }, {
@@ -32092,14 +32168,20 @@ var TimebackConfig2 = exports_external2.object({
   message: "Duplicate courseCode found; each must be unique",
   path: ["courses"]
 }).refine((config22) => {
-  return config22.courses.every((c) => c.sensor !== undefined || config22.sensor !== undefined);
-}, {
-  message: "Each course must have an effective sensor; set a top-level `sensor` or per-course `sensor`",
-  path: ["courses"]
-}).refine((config22) => {
-  return config22.courses.every((c) => c.launchUrl !== undefined || config22.launchUrl !== undefined);
+  return config22.courses.every((c) => {
+    if (c.sensor !== undefined || config22.sensor !== undefined) {
+      return true;
+    }
+    const launchUrls = [
+      c.launchUrl,
+      config22.launchUrl,
+      c.overrides?.staging?.launchUrl,
+      c.overrides?.production?.launchUrl
+    ].filter(Boolean);
+    return launchUrls.length > 0;
+  });
 }, {
-  message: "Each course must have an effective launchUrl; set a top-level `launchUrl` or per-course `launchUrl`",
+  message: "Each course must have an effective sensor. Either set `sensor` explicitly (top-level or per-course), or provide a `launchUrl` so sensor can be derived from its origin.",
   path: ["courses"]
 });
 var EdubridgeDateString2 = exports_external2.union([IsoDateString2, IsoDateTimeString2]);
@@ -49177,7 +49259,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 +49276,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 +49509,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);
 }, {
@@ -49500,14 +49607,20 @@ var TimebackConfig3 = exports_external3.object({
   message: "Duplicate courseCode found; each must be unique",
   path: ["courses"]
 }).refine((config22) => {
-  return config22.courses.every((c) => c.sensor !== undefined || config22.sensor !== undefined);
-}, {
-  message: "Each course must have an effective sensor; set a top-level `sensor` or per-course `sensor`",
-  path: ["courses"]
-}).refine((config22) => {
-  return config22.courses.every((c) => c.launchUrl !== undefined || config22.launchUrl !== undefined);
+  return config22.courses.every((c) => {
+    if (c.sensor !== undefined || config22.sensor !== undefined) {
+      return true;
+    }
+    const launchUrls = [
+      c.launchUrl,
+      config22.launchUrl,
+      c.overrides?.staging?.launchUrl,
+      c.overrides?.production?.launchUrl
+    ].filter(Boolean);
+    return launchUrls.length > 0;
+  });
 }, {
-  message: "Each course must have an effective launchUrl; set a top-level `launchUrl` or per-course `launchUrl`",
+  message: "Each course must have an effective sensor. Either set `sensor` explicitly (top-level or per-course), or provide a `launchUrl` so sensor can be derived from its origin.",
   path: ["courses"]
 });
 var EdubridgeDateString3 = exports_external3.union([IsoDateString3, IsoDateTimeString3]);
@@ -66784,7 +66897,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 +66914,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 +67147,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);
 }, {
@@ -67107,14 +67245,20 @@ var TimebackConfig4 = exports_external4.object({
   message: "Duplicate courseCode found; each must be unique",
   path: ["courses"]
 }).refine((config22) => {
-  return config22.courses.every((c) => c.sensor !== undefined || config22.sensor !== undefined);
-}, {
-  message: "Each course must have an effective sensor; set a top-level `sensor` or per-course `sensor`",
-  path: ["courses"]
-}).refine((config22) => {
-  return config22.courses.every((c) => c.launchUrl !== undefined || config22.launchUrl !== undefined);
+  return config22.courses.every((c) => {
+    if (c.sensor !== undefined || config22.sensor !== undefined) {
+      return true;
+    }
+    const launchUrls = [
+      c.launchUrl,
+      config22.launchUrl,
+      c.overrides?.staging?.launchUrl,
+      c.overrides?.production?.launchUrl
+    ].filter(Boolean);
+    return launchUrls.length > 0;
+  });
 }, {
-  message: "Each course must have an effective launchUrl; set a top-level `launchUrl` or per-course `launchUrl`",
+  message: "Each course must have an effective sensor. Either set `sensor` explicitly (top-level or per-course), or provide a `launchUrl` so sensor can be derived from its origin.",
   path: ["courses"]
 });
 var EdubridgeDateString4 = exports_external4.union([IsoDateString4, IsoDateTimeString4]);
@@ -83421,7 +83565,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 +83582,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 +83815,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);
 }, {
@@ -83744,14 +83913,20 @@ var TimebackConfig5 = exports_external5.object({
   message: "Duplicate courseCode found; each must be unique",
   path: ["courses"]
 }).refine((config22) => {
-  return config22.courses.every((c) => c.sensor !== undefined || config22.sensor !== undefined);
-}, {
-  message: "Each course must have an effective sensor; set a top-level `sensor` or per-course `sensor`",
-  path: ["courses"]
-}).refine((config22) => {
-  return config22.courses.every((c) => c.launchUrl !== undefined || config22.launchUrl !== undefined);
+  return config22.courses.every((c) => {
+    if (c.sensor !== undefined || config22.sensor !== undefined) {
+      return true;
+    }
+    const launchUrls = [
+      c.launchUrl,
+      config22.launchUrl,
+      c.overrides?.staging?.launchUrl,
+      c.overrides?.production?.launchUrl
+    ].filter(Boolean);
+    return launchUrls.length > 0;
+  });
 }, {
-  message: "Each course must have an effective launchUrl; set a top-level `launchUrl` or per-course `launchUrl`",
+  message: "Each course must have an effective sensor. Either set `sensor` explicitly (top-level or per-course), or provide a `launchUrl` so sensor can be derived from its origin.",
   path: ["courses"]
 });
 var EdubridgeDateString5 = exports_external5.union([IsoDateString5, IsoDateTimeString5]);
@@ -85509,163 +85684,6 @@ async function lookupTimebackIdByEmail(params) {
     throw new TimebackUserResolutionError(`Failed to lookup Timeback user: ${message}`, "timeback_user_lookup_failed");
   }
 }
-
-class ActivityCourseResolutionError extends Error {
-  code;
-  selector;
-  count;
-  constructor(code, selector, count) {
-    super(code);
-    this.code = code;
-    this.selector = selector;
-    this.count = count;
-  }
-  get selectorDescription() {
-    if ("grade" in this.selector) {
-      return `${this.selector.subject} grade ${this.selector.grade}`;
-    }
-    return `code "${this.selector.code}"`;
-  }
-}
-function resolveActivityCourse(courses, courseRef) {
-  let matches;
-  if ("grade" in courseRef) {
-    matches = courses.filter((c) => c.subject === courseRef.subject && c.grade === courseRef.grade);
-  } else {
-    matches = courses.filter((c) => c.courseCode === courseRef.code);
-  }
-  if (matches.length === 0) {
-    throw new ActivityCourseResolutionError("unknown_course", courseRef);
-  }
-  if (matches.length > 1) {
-    throw new ActivityCourseResolutionError("ambiguous_course", courseRef, matches.length);
-  }
-  return matches[0];
-}
-// src/server/lib/build-activity-events.ts
-class MissingSyncedCourseIdError extends Error {
-  course;
-  env;
-  constructor(course, env) {
-    const identifier = course.grade === undefined ? course.courseCode ?? course.subject : `${course.subject} grade ${course.grade}`;
-    super(`Course "${identifier}" is missing a synced ID for ${env}. Run \`timeback sync\` first.`);
-    this.name = "MissingSyncedCourseIdError";
-    this.course = course;
-    this.env = env;
-  }
-}
-function buildCourseId(course, apiEnv) {
-  const courseId = course.ids?.[apiEnv];
-  if (!courseId) {
-    throw new MissingSyncedCourseIdError(course, apiEnv);
-  }
-  return courseId;
-}
-function buildCourseName(course) {
-  if (course.courseCode) {
-    return course.courseCode;
-  }
-  if (course.grade !== undefined) {
-    return `${course.subject} G${String(course.grade)}`;
-  }
-  return course.subject;
-}
-
-class InvalidSensorUrlError extends Error {
-  sensor;
-  constructor(sensor) {
-    super(`Invalid sensor URL "${sensor}". Sensor must be a valid absolute URL (e.g., "https://sensor.example.com") to support slug-based activity IDs.`);
-    this.name = "InvalidSensorUrlError";
-    this.sensor = sensor;
-  }
-}
-function buildCanonicalActivityUrl(sensor, selector, slug) {
-  let base;
-  try {
-    base = new URL(sensor);
-  } catch {
-    throw new InvalidSensorUrlError(sensor);
-  }
-  const pathSegment = "grade" in selector ? `${selector.subject}/g${String(selector.grade)}` : selector.code;
-  const basePath = base.pathname.replace(/\/+$/, "");
-  base.pathname = `${basePath}/activities/${pathSegment}/${encodeURIComponent(slug)}`;
-  return base.toString();
-}
-function buildActivityContext(payload, course, appName, apiEnv, sensor) {
-  return {
-    id: buildCanonicalActivityUrl(sensor, payload.course, payload.id),
-    type: "TimebackActivityContext",
-    subject: course.subject,
-    app: { name: appName },
-    activity: { name: payload.name },
-    course: {
-      id: buildCourseId(course, apiEnv),
-      name: buildCourseName(course)
-    }
-  };
-}
-function buildActivityMetrics(metrics) {
-  const result = [];
-  if (metrics.totalQuestions !== undefined) {
-    result.push({ type: "totalQuestions", value: metrics.totalQuestions });
-  }
-  if (metrics.correctQuestions !== undefined) {
-    result.push({ type: "correctQuestions", value: metrics.correctQuestions });
-  }
-  if (metrics.xpEarned !== undefined) {
-    result.push({ type: "xpEarned", value: metrics.xpEarned });
-  }
-  if (metrics.masteredUnits !== undefined) {
-    result.push({ type: "masteredUnits", value: metrics.masteredUnits });
-  }
-  return result;
-}
-function buildTimeSpentMetrics(elapsedMs, pausedMs) {
-  const result = [{ type: "active", value: Math.max(0, elapsedMs) / 1000 }];
-  if (pausedMs > 0) {
-    result.push({ type: "inactive", value: Math.max(0, pausedMs) / 1000 });
-  }
-  return result;
-}
-async function sendCaliperEnvelope(client, sensor, activityEvent, timeSpentEvent) {
-  await client.caliper.events.send(sensor, [activityEvent, timeSpentEvent]);
-}
-// src/server/lib/build-user-profile.ts
-function buildCourseLookup(courses, apiEnv) {
-  const courseById = new Map;
-  for (const course of courses) {
-    const courseId = course.ids?.[apiEnv];
-    if (courseId) {
-      courseById.set(courseId, course);
-    }
-  }
-  return courseById;
-}
-function mapEnrollmentsToCourses(enrollments, courseById) {
-  return enrollments.map((enrollment) => {
-    const configuredCourse = courseById.get(enrollment.course.id);
-    return {
-      id: enrollment.course.id,
-      code: configuredCourse?.courseCode ?? enrollment.course.id,
-      name: enrollment.course.title
-    };
-  });
-}
-function pickGoalsFromEnrollments(enrollments) {
-  return enrollments.map((enrollment) => enrollment.metadata?.goals).find(Boolean);
-}
-function getUtcDayRange(date6) {
-  const start = new Date(Date.UTC(date6.getUTCFullYear(), date6.getUTCMonth(), date6.getUTCDate()));
-  const end = new Date(Date.UTC(date6.getUTCFullYear(), date6.getUTCMonth(), date6.getUTCDate(), 23, 59, 59, 999));
-  return { start, end };
-}
-function sumXp(facts) {
-  return Object.values(facts).reduce((dateTotal, subjects) => {
-    return dateTotal + Object.values(subjects).reduce((subjectTotal, metrics) => {
-      return subjectTotal + (metrics.activityMetrics?.xpEarned ?? 0);
-    }, 0);
-  }, 0);
-}
 // src/shared/constants.ts
 var ROUTES = {
   ACTIVITY: "/activity",
@@ -85675,10 +85693,83 @@ var ROUTES = {
     CALLBACK: "/identity/callback"
   },
   USER: {
-    ME: "/user/me"
+    ME: "/user/me",
+    VERIFY: "/user/verify"
   }
 };
 
+// src/server/lib/sso.ts
+function buildErrorContext(error57, errorCode, state, req) {
+  return {
+    error: error57,
+    errorCode,
+    state,
+    req,
+    redirect: redirectResponse,
+    json: jsonResponse
+  };
+}
+function tryDecodeState(stateParam) {
+  try {
+    return decodeBase64Url(stateParam);
+  } catch {
+    ssoLog.warn("Failed to decode state");
+    return;
+  }
+}
+function handleIdpError(errorParam, url6, state, req, onCallbackError) {
+  const errorDesc = url6.searchParams.get("error_description");
+  ssoLog.error("IdP returned error", { error: errorParam, description: errorDesc });
+  const error57 = new Error(errorDesc ?? errorParam);
+  if (onCallbackError) {
+    return onCallbackError(buildErrorContext(error57, errorParam, state, req));
+  }
+  return jsonResponse({ error: errorParam }, 400);
+}
+function handleMissingCode(state, req, onCallbackError) {
+  ssoLog.error("Missing authorization code in callback");
+  const error57 = new Error("Missing authorization code");
+  if (onCallbackError) {
+    return onCallbackError(buildErrorContext(error57, "missing_code", state, req));
+  }
+  return jsonResponse({ error: "Missing authorization code" }, 400);
+}
+async function initiateSignIn(params) {
+  const { req, env, clientId, buildState } = params;
+  const issuer = params.issuer ?? getIssuer(env);
+  const url6 = new URL(req.url);
+  let redirectUri = params.redirectUri;
+  if (!redirectUri) {
+    const basePath = url6.pathname.replace(ROUTES.IDENTITY.SIGNIN, "");
+    redirectUri = `${url6.origin}${basePath}${ROUTES.IDENTITY.CALLBACK}`;
+  }
+  ssoLog.debug("SSO sign-in initiated", { env, issuer, clientId, redirectUri });
+  const stateData = buildState ? buildState({ req, url: url6 }) : {};
+  const state = encodeBase64Url(stateData);
+  const authUrl = await buildAuthorizationUrl({
+    issuer,
+    clientId,
+    redirectUri,
+    state
+  });
+  return redirectResponse(authUrl);
+}
+function parseCallback(req) {
+  const url6 = new URL(req.url);
+  const code = url6.searchParams.get("code");
+  const errorParam = url6.searchParams.get("error");
+  const stateParam = url6.searchParams.get("state");
+  ssoLog.debug("Received callback from IdP", { hasCode: !!code, error: errorParam });
+  const state = stateParam ? tryDecodeState(stateParam) : undefined;
+  return { url: url6, code, errorParam, state };
+}
+function computeRedirectUri(url6, configuredRedirectUri) {
+  if (configuredRedirectUri) {
+    return configuredRedirectUri;
+  }
+  const basePath = url6.pathname.replace(ROUTES.IDENTITY.CALLBACK, "");
+  return `${url6.origin}${basePath}${ROUTES.IDENTITY.CALLBACK}`;
+}
 // src/server/adapters/utils.ts
 function normalizePathname(path) {
   const raw = path.trim();
@@ -85728,6 +85819,8 @@ function matchTimebackRoute(params) {
         return "identity.signOut";
       if (relative === ROUTES.USER.ME)
         return "user.me";
+      if (relative === ROUTES.USER.VERIFY)
+        return "user.verify";
     }
     if (method === "POST") {
       if (relative === ROUTES.ACTIVITY)
@@ -85753,6 +85846,8 @@ function matchTimebackRoute(params) {
       return "identity.signOut";
     if (pathname.endsWith(ROUTES.USER.ME))
       return "user.me";
+    if (pathname.endsWith(ROUTES.USER.VERIFY))
+      return "user.verify";
   }
   if (method === "POST") {
     if (pathname.endsWith(ROUTES.ACTIVITY))
@@ -85791,6 +85886,11 @@ function toSolidStartHandler(input) {
         return jsonResponse({ error: "Not found" }, 404);
       return handle.user.me(event.request);
     }
+    if (route === "user.verify") {
+      if (!hasUserHandler(handle))
+        return jsonResponse({ error: "Not found" }, 404);
+      return handle.user.verify(event.request);
+    }
     if (route === "activity") {
       if (!hasActivityHandler(handle))
         return jsonResponse({ error: "Not found" }, 404);
@@ -85827,6 +85927,11 @@ function solidStartHandler(options) {
       return;
     return handle.user.me(request);
   }
+  if (route === "user.verify") {
+    if (!hasUserHandler(handle))
+      return;
+    return handle.user.verify(request);
+  }
   if (route === "activity") {
     if (!hasActivityHandler(handle))
       return;