@timeback/core 0.1.2 → 0.1.4

package/dist/utils.js

@@ -485,6 +485,9 @@ var BEYONDAI_PATHS = {
   },
   edubridge: {
     base: "/edubridge"
+  },
+  powerpath: {
+    base: "/powerpath"
   }
 };
 var LEARNWITHAI_PATHS = {
@@ -500,7 +503,8 @@ var LEARNWITHAI_PATHS = {
     gradebook: "/gradebook/1.0",
     resources: "/resources/1.0"
   },
-  edubridge: null
+  edubridge: null,
+  powerpath: null
 };
 var PLATFORM_PATHS = {
   BEYOND_AI: BEYONDAI_PATHS,
@@ -520,7 +524,8 @@ function resolvePathProfiles(pathProfile, customPaths) {
   return {
     caliper: customPaths?.caliper ?? basePaths.caliper,
     oneroster: customPaths?.oneroster ?? basePaths.oneroster,
-    edubridge: customPaths?.edubridge ?? basePaths.edubridge
+    edubridge: customPaths?.edubridge ?? basePaths.edubridge,
+    powerpath: customPaths?.powerpath ?? basePaths.powerpath
   };
 }
 
@@ -556,6 +561,10 @@ class TimebackProvider {
           baseUrl: platformEndpoints.api[env],
           authUrl: this.authUrl
         },
+        powerpath: {
+          baseUrl: platformEndpoints.api[env],
+          authUrl: this.authUrl
+        },
         caliper: {
           baseUrl: platformEndpoints.caliper[env],
           authUrl: this.authUrl
@@ -572,6 +581,7 @@ class TimebackProvider {
       this.endpoints = {
         oneroster: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         edubridge: { baseUrl: config.baseUrl, authUrl: this.authUrl },
+        powerpath: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         caliper: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         qti: { baseUrl: config.baseUrl, authUrl: this.authUrl }
       };
@@ -689,7 +699,17 @@ class TimebackProvider {
 }
 function getEnv(key) {
   try {
-    return typeof process === "undefined" ? undefined : process.env[key];
+    if (typeof process === "undefined")
+      return;
+    if (typeof key === "string") {
+      return process.env[key];
+    }
+    for (const k of key) {
+      const value = process.env[k];
+      if (value !== undefined)
+        return value;
+    }
+    return;
   } catch {
     return;
   }
@@ -720,6 +740,18 @@ var DEFAULT_PROVIDER_REGISTRY = {
     }
   }
 };
+function primaryEnvVar(key) {
+  if (typeof key === "string") {
+    return key;
+  }
+  if (key.length === 0) {
+    throw new Error(`Missing env var key: ${key}`);
+  }
+  return key[0];
+}
+function formatEnvVarKey(key) {
+  return primaryEnvVar(key);
+}
 function validateEnv(env) {
   if (env !== "staging" && env !== "production") {
     throw new Error(`Invalid env "${env}": must be "staging" or "production"`);
@@ -730,10 +762,10 @@ function validateAuth(auth, envVars) {
   const clientId = auth?.clientId ?? getEnv(envVars.clientId);
   const clientSecret = auth?.clientSecret ?? getEnv(envVars.clientSecret);
   if (!clientId) {
-    throw new Error(`Missing clientId: provide in config or set ${envVars.clientId}`);
+    throw new Error(`Missing clientId: provide in config or set ${formatEnvVarKey(envVars.clientId)}`);
   }
   if (!clientSecret) {
-    throw new Error(`Missing clientSecret: provide in config or set ${envVars.clientSecret}`);
+    throw new Error(`Missing clientSecret: provide in config or set ${formatEnvVarKey(envVars.clientSecret)}`);
   }
   return { clientId, clientSecret };
 }
@@ -749,21 +781,21 @@ function buildMissingEnvError(envVars) {
   const clientId = getEnv(envVars.clientId);
   const clientSecret = getEnv(envVars.clientSecret);
   if (baseUrl === undefined && clientId === undefined) {
-    const hint = envVars.env ?? envVars.baseUrl;
+    const hint = formatEnvVarKey(envVars.env ?? envVars.baseUrl);
     return `Missing env: provide in config or set ${hint}`;
   }
   const missing = [];
   if (baseUrl === undefined) {
-    missing.push(envVars.env ?? envVars.baseUrl);
+    missing.push(formatEnvVarKey(envVars.env ?? envVars.baseUrl));
   }
   if (baseUrl !== undefined && authUrl === undefined) {
-    missing.push(envVars.authUrl);
+    missing.push(formatEnvVarKey(envVars.authUrl));
   }
   if (clientId === undefined) {
-    missing.push(envVars.clientId);
+    missing.push(formatEnvVarKey(envVars.clientId));
   }
   if (clientSecret === undefined) {
-    missing.push(envVars.clientSecret);
+    missing.push(formatEnvVarKey(envVars.clientSecret));
   }
   return `Missing environment variables: ${missing.join(", ")}`;
 }
@@ -1254,10 +1286,10 @@ function validateNonEmptyString(value, name) {
   }
 }
 var EDUBRIDGE_ENV_VARS = {
-  baseUrl: "EDUBRIDGE_BASE_URL",
-  clientId: "EDUBRIDGE_CLIENT_ID",
-  clientSecret: "EDUBRIDGE_CLIENT_SECRET",
-  authUrl: "EDUBRIDGE_TOKEN_URL"
+  baseUrl: ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "EDUBRIDGE_BASE_URL"],
+  clientId: ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "EDUBRIDGE_CLIENT_ID"],
+  clientSecret: ["TIMEBACK_API_CLIENT_SECRET", "TIMEBACK_CLIENT_SECRET", "EDUBRIDGE_CLIENT_SECRET"],
+  authUrl: ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "EDUBRIDGE_TOKEN_URL"]
 };
 function resolveToProvider2(config, registry = DEFAULT_PROVIDER_REGISTRY) {
   return resolveToProvider(config, EDUBRIDGE_ENV_VARS, registry);
@@ -3585,7 +3617,7 @@ class Doc {
 var version = {
   major: 4,
   minor: 3,
-  patch: 5
+  patch: 6
 };
 var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
   var _a;
@@ -4869,7 +4901,7 @@ var $ZodRecord = /* @__PURE__ */ $constructor("$ZodRecord", (inst, def) => {
         if (keyResult instanceof Promise) {
           throw new Error("Async schemas not supported in object keys currently");
         }
-        const checkNumericKey = typeof key === "string" && number.test(key) && keyResult.issues.length && keyResult.issues.some((iss) => iss.code === "invalid_type" && iss.expected === "number");
+        const checkNumericKey = typeof key === "string" && number.test(key) && keyResult.issues.length;
         if (checkNumericKey) {
           const retryResult = def.keyType._zod.run({ value: Number(key), issues: [] }, ctx);
           if (retryResult instanceof Promise) {
@@ -12186,7 +12218,7 @@ function finalize(ctx, schema) {
           }
         }
       }
-      if (refSchema.$ref) {
+      if (refSchema.$ref && refSeen.def) {
         for (const key in schema2) {
           if (key === "$ref" || key === "allOf")
             continue;
@@ -14818,7 +14850,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),
@@ -14835,7 +14867,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",
@@ -14862,6 +14897,47 @@ var OneRosterUserRole = exports_external.enum([
   "teacher"
 ]);
 var EnrollmentRole = exports_external.enum(["administrator", "proctor", "student", "teacher"]);
+var ResourceType = exports_external.enum([
+  "qti",
+  "text",
+  "audio",
+  "video",
+  "interactive",
+  "visual",
+  "course-material",
+  "assessment-bank"
+]);
+var QtiSubType = exports_external.enum(["qti-test", "qti-question", "qti-stimulus", "qti-test-bank"]);
+var CourseMaterialSubType = exports_external.enum(["unit", "course", "resource-collection"]);
+var QuestionType = exports_external.enum([
+  "choice",
+  "order",
+  "associate",
+  "match",
+  "hotspot",
+  "hottext",
+  "select-point",
+  "graphic-order",
+  "graphic-associate",
+  "graphic-gap-match",
+  "text-entry",
+  "extended-text",
+  "inline-choice",
+  "upload",
+  "slider",
+  "drawing",
+  "media",
+  "custom"
+]);
+var Difficulty = exports_external.enum(["easy", "medium", "hard"]);
+var LearningObjectiveSetSchema = exports_external.array(exports_external.object({
+  source: exports_external.string(),
+  learningObjectiveIds: exports_external.array(exports_external.string())
+}));
+var FastFailConfigSchema = exports_external.object({
+  consecutive_failures: exports_external.number().int().min(1).optional(),
+  stagnation_limit: exports_external.number().int().min(1).optional()
+}).optional();
 var LessonType = exports_external.enum(["powerpath-100", "quiz", "test-out", "placement", "unit-test", "alpha-read-article"]).nullable();
 var IMSErrorResponse = exports_external.object({
   imsx_codeMajor: exports_external.enum(["failure", "success"]),
@@ -14937,7 +15013,11 @@ var ActivityCompletedInput = exports_external.object({
   eventTime: IsoDateTimeString.optional(),
   metricsId: exports_external.string().optional(),
   id: exports_external.string().optional(),
-  extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  attempt: exports_external.number().int().min(1).optional(),
+  generatedExtensions: exports_external.object({
+    pctCompleteApp: exports_external.number().optional()
+  }).loose().optional()
 }).strict();
 var TimeSpentInput = exports_external.object({
   actor: TimebackUser,
@@ -15020,50 +15100,121 @@ 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().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.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,
-  ids: CourseIds.nullable().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.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"),
-  sensors: exports_external.array(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);
+}, {
+  message: "Each course must have either a grade or a courseCode",
+  path: ["courses"]
+}).refine((config2) => {
+  const withGrade = config2.courses.filter((c) => c.grade !== undefined);
+  const keys = withGrade.map((c) => `${c.subject}:${c.grade}`);
+  return new Set(keys).size === keys.length;
+}, {
+  message: "Duplicate (subject, grade) pair found; each must be unique",
+  path: ["courses"]
+}).refine((config2) => {
+  const withCode = config2.courses.filter((c) => c.courseCode !== undefined);
+  const codes = withCode.map((c) => c.courseCode);
+  return new Set(codes).size === codes.length;
+}, {
+  message: "Duplicate courseCode found; each must be unique",
+  path: ["courses"]
+}).refine((config2) => {
+  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 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]);
+var EdubridgeDateString = IsoDateTimeString;
 var EduBridgeEnrollment = exports_external.object({
   id: exports_external.string(),
   role: exports_external.string(),
@@ -15127,13 +15278,11 @@ var EmailOrStudentId = exports_external.object({
 });
 var SubjectTrackInput = exports_external.object({
   subject: NonEmptyString,
-  gradeLevel: NonEmptyString,
-  targetCourseId: NonEmptyString,
-  metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
-});
-var SubjectTrackUpsertInput = SubjectTrackInput.extend({
-  id: NonEmptyString
+  grade: NonEmptyString,
+  courseId: NonEmptyString,
+  orgSourcedId: NonEmptyString.optional()
 });
+var SubjectTrackUpsertInput = SubjectTrackInput;
 var EdubridgeListEnrollmentsParams = exports_external.object({
   userId: NonEmptyString
 });
@@ -15310,20 +15459,45 @@ var OneRosterScoreScaleCreateInput = exports_external.object({
 }).strict();
 var OneRosterAssessmentLineItemCreateInput = exports_external.object({
   sourcedId: NonEmptyString2.optional(),
+  status: Status.optional(),
+  dateLastModified: IsoDateTimeString.optional(),
   title: NonEmptyString2.describe("title must be a non-empty string"),
-  class: Ref,
-  school: Ref,
-  category: Ref,
-  assignDate: OneRosterDateString,
-  dueDate: OneRosterDateString,
-  status: Status,
+  description: exports_external.string().nullable().optional(),
+  class: Ref.nullable().optional(),
+  parentAssessmentLineItem: Ref.nullable().optional(),
+  scoreScale: Ref.nullable().optional(),
+  resultValueMin: exports_external.number().nullable().optional(),
+  resultValueMax: exports_external.number().nullable().optional(),
+  component: Ref.nullable().optional(),
+  componentResource: Ref.nullable().optional(),
+  learningObjectiveSet: exports_external.array(exports_external.object({
+    source: exports_external.string(),
+    learningObjectiveIds: exports_external.array(exports_external.string())
+  })).optional().nullable(),
+  course: Ref.nullable().optional(),
   metadata: Metadata
 }).strict();
+var LearningObjectiveResult = exports_external.object({
+  learningObjectiveId: exports_external.string(),
+  score: exports_external.number().optional(),
+  textScore: exports_external.string().optional()
+});
+var LearningObjectiveScoreSetSchema = exports_external.array(exports_external.object({
+  source: exports_external.string(),
+  learningObjectiveResults: exports_external.array(LearningObjectiveResult)
+}));
 var OneRosterAssessmentResultCreateInput = exports_external.object({
   sourcedId: NonEmptyString2.optional(),
-  lineItem: Ref,
+  status: Status.optional(),
+  dateLastModified: IsoDateTimeString.optional(),
+  metadata: Metadata,
+  assessmentLineItem: Ref,
   student: Ref,
-  scoreDate: OneRosterDateString,
+  score: exports_external.number().nullable().optional(),
+  textScore: exports_external.string().nullable().optional(),
+  scoreDate: exports_external.string().datetime(),
+  scoreScale: Ref.nullable().optional(),
+  scorePercentile: exports_external.number().nullable().optional(),
   scoreStatus: exports_external.enum([
     "exempt",
     "fully graded",
@@ -15331,9 +15505,12 @@ var OneRosterAssessmentResultCreateInput = exports_external.object({
     "partially graded",
     "submitted"
   ]),
-  score: exports_external.string().optional(),
-  status: Status,
-  metadata: Metadata
+  comment: exports_external.string().nullable().optional(),
+  learningObjectiveSet: LearningObjectiveScoreSetSchema.nullable().optional(),
+  inProgress: exports_external.string().nullable().optional(),
+  incomplete: exports_external.string().nullable().optional(),
+  late: exports_external.string().nullable().optional(),
+  missing: exports_external.string().nullable().optional()
 }).strict();
 var OneRosterOrgCreateInput = exports_external.object({
   sourcedId: NonEmptyString2.optional(),
@@ -15401,6 +15578,75 @@ var OneRosterCredentialInput = exports_external.object({
 var OneRosterDemographicsCreateInput = exports_external.object({
   sourcedId: NonEmptyString2.describe("sourcedId must be a non-empty string")
 }).loose();
+var CommonResourceMetadataSchema = exports_external.object({
+  type: ResourceType,
+  subject: TimebackSubject.nullish(),
+  grades: exports_external.array(TimebackGrade).nullish(),
+  language: exports_external.string().nullish(),
+  xp: exports_external.number().nullish(),
+  url: exports_external.url().nullish(),
+  keywords: exports_external.array(exports_external.string()).nullish(),
+  learningObjectiveSet: LearningObjectiveSetSchema.nullish(),
+  lessonType: exports_external.string().nullish()
+}).passthrough();
+var QtiMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("qti"),
+  subType: QtiSubType,
+  questionType: QuestionType.optional(),
+  difficulty: Difficulty.optional()
+});
+var TextMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("text"),
+  format: exports_external.string(),
+  author: exports_external.string().optional(),
+  pageCount: exports_external.number().optional()
+});
+var AudioMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("audio"),
+  duration: exports_external.string().regex(/^\d{2}:\d{2}:\d{2}(\.\d{2})?$/).optional(),
+  format: exports_external.string(),
+  speaker: exports_external.string().optional()
+});
+var VideoMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("video"),
+  duration: exports_external.string().regex(/^\d{2}:\d{2}:\d{2}(\.\d{2})?$/).optional(),
+  captionsAvailable: exports_external.boolean().optional(),
+  format: exports_external.string()
+});
+var InteractiveMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("interactive"),
+  launchUrl: exports_external.url().optional(),
+  toolProvider: exports_external.string().optional(),
+  instructionalMethod: exports_external.string().optional(),
+  courseIdOnFail: exports_external.string().nullable().optional(),
+  fail_fast: FastFailConfigSchema
+});
+var VisualMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("visual"),
+  format: exports_external.string(),
+  resolution: exports_external.string().optional()
+});
+var CourseMaterialMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("course-material"),
+  subType: CourseMaterialSubType,
+  author: exports_external.string().optional(),
+  format: exports_external.string(),
+  instructionalMethod: exports_external.string().optional()
+});
+var AssessmentBankMetadataSchema = CommonResourceMetadataSchema.extend({
+  type: exports_external.literal("assessment-bank"),
+  resources: exports_external.array(exports_external.string())
+});
+var ResourceMetadataSchema = exports_external.discriminatedUnion("type", [
+  QtiMetadataSchema,
+  TextMetadataSchema,
+  AudioMetadataSchema,
+  VideoMetadataSchema,
+  InteractiveMetadataSchema,
+  VisualMetadataSchema,
+  CourseMaterialMetadataSchema,
+  AssessmentBankMetadataSchema
+]);
 var OneRosterResourceCreateInput = exports_external.object({
   sourcedId: NonEmptyString2.optional(),
   title: NonEmptyString2.describe("title must be a non-empty string"),
@@ -15410,7 +15656,7 @@ var OneRosterResourceCreateInput = exports_external.object({
   vendorId: exports_external.string().optional(),
   applicationId: exports_external.string().optional(),
   status: Status.optional(),
-  metadata: Metadata
+  metadata: ResourceMetadataSchema.nullable().optional()
 }).strict();
 var CourseStructureItem = exports_external.object({
   url: NonEmptyString2.describe("courseStructure.url must be a non-empty string"),
@@ -15435,6 +15681,267 @@ var OneRosterBulkResultItem = exports_external.object({
   student: Ref
 }).loose();
 var OneRosterBulkResultsInput = exports_external.array(OneRosterBulkResultItem).min(1, "results must have at least one item");
+var NonEmptyString3 = exports_external.string().trim().min(1);
+var ToolProvider = exports_external.enum(["edulastic", "mastery-track"]);
+var LessonTypeRequired = exports_external.enum([
+  "powerpath-100",
+  "quiz",
+  "test-out",
+  "placement",
+  "unit-test",
+  "alpha-read-article"
+]);
+var GradeArray = exports_external.array(TimebackGrade);
+var ResourceMetadata = exports_external.record(exports_external.string(), exports_external.unknown()).optional();
+var ExternalTestBase = exports_external.object({
+  courseId: NonEmptyString3,
+  lessonTitle: NonEmptyString3.optional(),
+  launchUrl: exports_external.url().optional(),
+  toolProvider: ToolProvider,
+  unitTitle: NonEmptyString3.optional(),
+  courseComponentSourcedId: NonEmptyString3.optional(),
+  vendorId: NonEmptyString3.optional(),
+  description: NonEmptyString3.optional(),
+  resourceMetadata: ResourceMetadata.nullable().optional(),
+  grades: GradeArray
+});
+var ExternalTestOut = ExternalTestBase.extend({
+  lessonType: exports_external.literal("test-out"),
+  xp: exports_external.number()
+});
+var ExternalPlacement = ExternalTestBase.extend({
+  lessonType: exports_external.literal("placement"),
+  courseIdOnFail: NonEmptyString3.optional(),
+  xp: exports_external.number().optional()
+});
+var InternalTestBase = exports_external.object({
+  courseId: NonEmptyString3,
+  lessonType: LessonTypeRequired,
+  lessonTitle: NonEmptyString3.optional(),
+  unitTitle: NonEmptyString3.optional(),
+  courseComponentSourcedId: NonEmptyString3.optional(),
+  resourceMetadata: ResourceMetadata.nullable().optional(),
+  xp: exports_external.number().optional(),
+  grades: GradeArray.optional(),
+  courseIdOnFail: NonEmptyString3.optional()
+});
+var PowerPathCreateInternalTestInput = exports_external.union([
+  InternalTestBase.extend({
+    testType: exports_external.literal("qti"),
+    qti: exports_external.object({
+      url: exports_external.url(),
+      title: NonEmptyString3.optional(),
+      metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+    })
+  }),
+  InternalTestBase.extend({
+    testType: exports_external.literal("assessment-bank"),
+    assessmentBank: exports_external.object({
+      resources: exports_external.array(exports_external.object({
+        url: exports_external.url(),
+        title: NonEmptyString3.optional(),
+        metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+      }))
+    })
+  })
+]);
+var PowerPathCreateNewAttemptInput = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3
+});
+var PowerPathFinalStudentAssessmentResponseInput = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3
+});
+var PowerPathLessonPlansCreateInput = exports_external.object({
+  courseId: NonEmptyString3,
+  userId: NonEmptyString3,
+  classId: NonEmptyString3.optional()
+});
+var LessonPlanTarget = exports_external.object({
+  type: exports_external.enum(["component", "resource"]),
+  id: NonEmptyString3
+});
+var PowerPathLessonPlanOperationInput = exports_external.union([
+  exports_external.object({
+    type: exports_external.literal("set-skipped"),
+    payload: exports_external.object({
+      target: LessonPlanTarget,
+      value: exports_external.boolean()
+    })
+  }),
+  exports_external.object({
+    type: exports_external.literal("add-custom-resource"),
+    payload: exports_external.object({
+      resource_id: NonEmptyString3,
+      parent_component_id: NonEmptyString3,
+      skipped: exports_external.boolean().optional()
+    })
+  }),
+  exports_external.object({
+    type: exports_external.literal("move-item-before"),
+    payload: exports_external.object({
+      target: LessonPlanTarget,
+      reference_id: NonEmptyString3
+    })
+  }),
+  exports_external.object({
+    type: exports_external.literal("move-item-after"),
+    payload: exports_external.object({
+      target: LessonPlanTarget,
+      reference_id: NonEmptyString3
+    })
+  }),
+  exports_external.object({
+    type: exports_external.literal("move-item-to-start"),
+    payload: exports_external.object({
+      target: LessonPlanTarget
+    })
+  }),
+  exports_external.object({
+    type: exports_external.literal("move-item-to-end"),
+    payload: exports_external.object({
+      target: LessonPlanTarget
+    })
+  }),
+  exports_external.object({
+    type: exports_external.literal("change-item-parent"),
+    payload: exports_external.object({
+      target: LessonPlanTarget,
+      new_parent_id: NonEmptyString3,
+      position: exports_external.enum(["start", "end"]).optional()
+    })
+  })
+]);
+var PowerPathLessonPlanOperationsInput = exports_external.object({
+  operation: exports_external.array(PowerPathLessonPlanOperationInput),
+  reason: NonEmptyString3.optional()
+});
+var PowerPathLessonPlanUpdateStudentItemResponseInput = exports_external.object({
+  studentId: NonEmptyString3,
+  componentResourceId: NonEmptyString3,
+  result: exports_external.object({
+    status: exports_external.enum(["active", "tobedeleted"]),
+    metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+    score: exports_external.number().optional(),
+    textScore: NonEmptyString3.optional(),
+    scoreDate: NonEmptyString3,
+    scorePercentile: exports_external.number().optional(),
+    scoreStatus: ScoreStatus,
+    comment: NonEmptyString3.optional(),
+    learningObjectiveSet: exports_external.array(exports_external.object({
+      source: NonEmptyString3,
+      learningObjectiveResults: exports_external.array(exports_external.object({
+        learningObjectiveId: NonEmptyString3,
+        score: exports_external.number().optional(),
+        textScore: NonEmptyString3.optional()
+      }))
+    })).optional(),
+    inProgress: NonEmptyString3.optional(),
+    incomplete: NonEmptyString3.optional(),
+    late: NonEmptyString3.optional(),
+    missing: NonEmptyString3.optional()
+  })
+});
+var PowerPathMakeExternalTestAssignmentInput = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3,
+  applicationName: NonEmptyString3.optional(),
+  testId: NonEmptyString3.optional(),
+  skipCourseEnrollment: exports_external.boolean().optional()
+});
+var PowerPathPlacementResetUserPlacementInput = exports_external.object({
+  student: NonEmptyString3,
+  subject: TimebackSubject
+});
+var PowerPathResetAttemptInput = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3
+});
+var PowerPathScreeningResetSessionInput = exports_external.object({
+  userId: NonEmptyString3
+});
+var PowerPathScreeningAssignTestInput = exports_external.object({
+  userId: NonEmptyString3,
+  subject: exports_external.enum(["Math", "Reading", "Language", "Science"])
+});
+var PowerPathTestAssignmentsCreateInput = exports_external.object({
+  student: NonEmptyString3,
+  subject: TimebackSubject,
+  grade: TimebackGrade,
+  testName: NonEmptyString3.optional()
+});
+var PowerPathTestAssignmentsUpdateInput = exports_external.object({
+  testName: NonEmptyString3
+});
+var PowerPathTestAssignmentItemInput = exports_external.object({
+  student: NonEmptyString3,
+  subject: TimebackSubject,
+  grade: TimebackGrade,
+  testName: NonEmptyString3.optional()
+});
+var PowerPathTestAssignmentsBulkInput = exports_external.object({
+  items: exports_external.array(PowerPathTestAssignmentItemInput)
+});
+var PowerPathTestAssignmentsImportInput = exports_external.object({
+  spreadsheetUrl: exports_external.url(),
+  sheet: NonEmptyString3
+});
+var PowerPathTestAssignmentsListParams = exports_external.object({
+  student: NonEmptyString3,
+  status: exports_external.enum(["assigned", "in_progress", "completed", "failed", "expired", "cancelled"]).optional(),
+  subject: NonEmptyString3.optional(),
+  grade: TimebackGrade.optional(),
+  limit: exports_external.number().int().positive().max(3000).optional(),
+  offset: exports_external.number().int().nonnegative().optional()
+});
+var PowerPathTestAssignmentsAdminParams = exports_external.object({
+  student: NonEmptyString3.optional(),
+  status: exports_external.enum(["assigned", "in_progress", "completed", "failed", "expired", "cancelled"]).optional(),
+  subject: NonEmptyString3.optional(),
+  grade: TimebackGrade.optional(),
+  limit: exports_external.number().int().positive().max(3000).optional(),
+  offset: exports_external.number().int().nonnegative().optional()
+});
+var PowerPathUpdateStudentQuestionResponseInput = exports_external.object({
+  student: NonEmptyString3,
+  question: NonEmptyString3,
+  response: exports_external.union([NonEmptyString3, exports_external.array(NonEmptyString3)]).optional(),
+  responses: exports_external.record(exports_external.string(), exports_external.union([NonEmptyString3, exports_external.array(NonEmptyString3)])).optional(),
+  lesson: NonEmptyString3
+});
+var PowerPathGetAssessmentProgressParams = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3,
+  attempt: exports_external.number().int().positive().optional()
+});
+var PowerPathGetNextQuestionParams = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3
+});
+var PowerPathGetAttemptsParams = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3
+});
+var PowerPathTestOutParams = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3.optional(),
+  finalized: exports_external.boolean().optional(),
+  toolProvider: NonEmptyString3.optional(),
+  attempt: exports_external.number().int().positive().optional()
+});
+var PowerPathImportExternalTestAssignmentResultsParams = exports_external.object({
+  student: NonEmptyString3,
+  lesson: NonEmptyString3,
+  applicationName: NonEmptyString3.optional()
+});
+var PowerPathPlacementQueryParams = exports_external.object({
+  student: NonEmptyString3,
+  subject: TimebackSubject
+});
+var PowerPathSyllabusQueryParams = exports_external.object({
+  status: exports_external.enum(["active", "tobedeleted"]).optional()
+});
 var QtiAssessmentItemType = exports_external.enum([
   "choice",
   "text-entry",