@timeback/core 0.2.3-beta.20260326015342 → 0.2.3-beta.20260330020222

package/dist/{chunk-z964w2xh.js → chunk-jqy7m30q.js}

@@ -39,7 +39,17 @@ function getTimezoneOffsetMs(at, timezone) {
   const localMs = Date.UTC(n("year"), n("month") - 1, n("day"), n("hour"), n("minute"), n("second"));
   return at.getTime() - at.getTime() % 1000 - localMs;
 }
-function bareDateToUTC(bareDate, time, timezone) {
+function validateBareDate(bareDate, fieldName) {
+  const [year, month, day] = bareDate.split("-").map(Number);
+  const d = new Date(Date.UTC(year, month - 1, day));
+  if (d.getUTCFullYear() !== year || d.getUTCMonth() !== month - 1 || d.getUTCDate() !== day) {
+    throw createInputValidationError("Invalid date", [
+      { path: fieldName, message: `Not a valid calendar date: "${bareDate}"` }
+    ]);
+  }
+}
+function bareDateToUTC(bareDate, time, timezone, fieldName) {
+  validateBareDate(bareDate, fieldName);
   try {
     const [year, month, day] = bareDate.split("-").map(Number);
     const [h, m, secMs] = time.split(":");
@@ -59,19 +69,23 @@ function bareDateToUTC(bareDate, time, timezone) {
     throw err;
   }
 }
-function normalizeStartDate(date, timezone) {
+function normalizeStartDate(date, timezone, fieldName = "startDate") {
   if (date.includes("T"))
     return date;
+  validateBareDate(date, fieldName);
   if (!timezone)
     return `${date}T00:00:00.000Z`;
-  return bareDateToUTC(date, "00:00:00.000", timezone);
+  return bareDateToUTC(date, "00:00:00.000", timezone, fieldName);
 }
-function normalizeEndDate(date, timezone) {
-  if (date.includes("T"))
+function normalizeEndDate(date, timezone, fieldName = "endDate") {
+  if (date.includes("T")) {
     return date;
-  if (!timezone)
+  }
+  validateBareDate(date, fieldName);
+  if (!timezone) {
     return `${date}T23:59:59.999Z`;
-  return bareDateToUTC(date, "23:59:59.999", timezone);
+  }
+  return bareDateToUTC(date, "23:59:59.999", timezone, fieldName);
 }
 function aggregateActivityMetrics(data) {
   const result = {
@@ -183,7 +197,7 @@ var TimebackSubject = z.enum([
   "None",
   "Other"
 ]).meta({ id: "TimebackSubject", description: "Subject area" });
-var TimebackGrade = z.union([
+var NumericTimebackGrade = z.union([
   z.literal(-1),
   z.literal(0),
   z.literal(1),
@@ -199,7 +213,39 @@ var TimebackGrade = z.union([
   z.literal(11),
   z.literal(12),
   z.literal(13)
-]).meta({
+]);
+var StringTimebackGrade = z.string().transform((value, ctx) => {
+  const raw = value.toLowerCase().trim().replaceAll("_", " ");
+  if (raw === "") {
+    ctx.addIssue({
+      code: "custom",
+      message: "must be a valid Timeback grade"
+    });
+    return z.NEVER;
+  }
+  const stripped = raw.replace(/\bgrade\b/g, "").replace(/(\d+)(st|nd|rd|th)\b/g, "$1").trim();
+  if (stripped === "pre-k" || stripped === "pk") {
+    return -1;
+  }
+  if (stripped === "k") {
+    return 0;
+  }
+  if (stripped === "middle school") {
+    return 7;
+  }
+  const normalized = stripped.replace(/\s+/g, "");
+  const withoutLeadingZeros = normalized.replace(/^0+/, "") || "0";
+  const parsed = Number(withoutLeadingZeros);
+  if (!Number.isInteger(parsed)) {
+    ctx.addIssue({
+      code: "custom",
+      message: "must be a valid Timeback grade"
+    });
+    return z.NEVER;
+  }
+  return parsed;
+});
+var TimebackGrade = z.union([z.number(), StringTimebackGrade]).pipe(NumericTimebackGrade).meta({
   id: "TimebackGrade",
   description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
 });
@@ -1015,7 +1061,42 @@ var Ref = z9.object({
   type: z9.string().optional(),
   href: z9.string().optional()
 }).strict();
+var GuidRefType = z9.enum([
+  "academicSession",
+  "assessmentLineItem",
+  "category",
+  "class",
+  "course",
+  "demographics",
+  "enrollment",
+  "gradingPeriod",
+  "lineItem",
+  "org",
+  "resource",
+  "result",
+  "scoreScale",
+  "student",
+  "teacher",
+  "term",
+  "user",
+  "componentResource",
+  "courseComponent"
+]);
+var GuidRef = z9.object({
+  sourcedId: NonEmptyString,
+  type: GuidRefType,
+  href: z9.url()
+}).strict();
 var OneRosterDateString = z9.union([IsoDateString, IsoDateTimeString]).transform((date) => date.includes("T") ? date : `${date}T00:00:00Z`);
+var LearningObjectiveResult = z9.object({
+  learningObjectiveId: z9.string(),
+  score: z9.number().optional(),
+  textScore: z9.string().optional()
+});
+var LearningObjectiveScoreSetSchema = z9.array(z9.object({
+  source: z9.string(),
+  learningObjectiveResults: z9.array(LearningObjectiveResult)
+}));
 var OneRosterUserRoleInput = z9.object({
   roleType: z9.enum(["primary", "secondary"]),
   role: OneRosterUserRole,
@@ -1028,35 +1109,46 @@ var OneRosterUserRoleInput = z9.object({
 var OneRosterUserCreateInput = z9.object({
   sourcedId: NonEmptyString.describe("sourcedId must be a non-empty string"),
   status: Status.optional(),
-  enabledUser: z9.boolean(),
+  enabledUser: z9.union([
+    z9.boolean(),
+    z9.enum(["true", "false"]).transform((value) => value === "true")
+  ]),
   givenName: NonEmptyString.describe("givenName must be a non-empty string"),
   familyName: NonEmptyString.describe("familyName must be a non-empty string"),
-  middleName: NonEmptyString.optional(),
-  username: NonEmptyString.optional(),
+  middleName: NonEmptyString.nullable().optional(),
+  preferredFirstName: NonEmptyString.nullable().optional(),
+  preferredMiddleName: NonEmptyString.nullable().optional(),
+  preferredLastName: NonEmptyString.nullable().optional(),
+  username: NonEmptyString.nullable().optional(),
   email: z9.email(),
+  userMasterIdentifier: z9.string().nullable().optional(),
   roles: z9.array(OneRosterUserRoleInput).min(1, "roles must include at least one role"),
   userIds: z9.array(z9.object({
     type: NonEmptyString,
     identifier: NonEmptyString
   }).strict()).optional(),
   agents: z9.array(Ref).optional(),
+  primaryOrg: Ref.optional(),
   grades: z9.array(TimebackGrade).optional(),
-  identifier: NonEmptyString.optional(),
-  sms: NonEmptyString.optional(),
-  phone: NonEmptyString.optional(),
-  pronouns: NonEmptyString.optional(),
-  password: NonEmptyString.optional(),
+  sms: NonEmptyString.nullable().optional(),
+  phone: NonEmptyString.nullable().optional(),
+  pronouns: NonEmptyString.nullable().optional(),
+  password: NonEmptyString.nullable().optional(),
   metadata: Metadata
 }).strict();
 var OneRosterCourseCreateInput = z9.object({
   sourcedId: NonEmptyString.describe("sourcedId must be a non-empty string").optional(),
-  status: Status.optional(),
+  status: Status,
   title: NonEmptyString.describe("title must be a non-empty string"),
   org: Ref,
-  courseCode: NonEmptyString.optional(),
-  subjects: z9.array(TimebackSubject).optional(),
-  grades: z9.array(TimebackGrade).optional(),
-  level: NonEmptyString.optional(),
+  courseCode: NonEmptyString.nullable().optional(),
+  subjects: z9.array(TimebackSubject).nullable().optional(),
+  subjectCodes: z9.array(z9.string()).nullable().optional(),
+  grades: z9.array(TimebackGrade).nullable().optional(),
+  level: NonEmptyString.nullable().optional(),
+  academicSession: Ref.nullable().optional(),
+  schoolYear: GuidRef.nullable().optional(),
+  gradingScheme: NonEmptyString.nullable().optional(),
   metadata: Metadata
 }).strict();
 var OneRosterClassCreateInput = z9.object({
@@ -1066,9 +1158,9 @@ var OneRosterClassCreateInput = z9.object({
   terms: z9.array(Ref).min(1, "terms must have at least one item"),
   course: Ref,
   org: Ref,
-  classCode: NonEmptyString.optional(),
+  classCode: NonEmptyString.nullable().optional(),
   classType: z9.enum(["homeroom", "scheduled"]).optional(),
-  location: NonEmptyString.optional(),
+  location: NonEmptyString.nullable().optional(),
   grades: z9.array(TimebackGrade).optional(),
   subjects: z9.array(TimebackSubject).optional(),
   subjectCodes: z9.array(NonEmptyString).optional(),
@@ -1103,18 +1195,21 @@ var OneRosterLineItemCreateInput = z9.object({
   category: Ref,
   assignDate: OneRosterDateString,
   dueDate: OneRosterDateString,
-  status: Status,
-  description: z9.string().optional(),
+  status: Status.optional(),
+  description: z9.string().nullable().optional(),
   resultValueMin: z9.number().nullable().optional(),
   resultValueMax: z9.number().nullable().optional(),
-  scoreScale: Ref.optional(),
+  gradingPeriod: Ref.nullable().optional(),
+  academicSession: Ref.nullable().optional(),
+  scoreScale: Ref.nullable().optional(),
+  learningObjectiveSet: LearningObjectiveSetSchema.nullable().optional(),
   metadata: Metadata
 }).strict();
 var OneRosterResultCreateInput = z9.object({
   sourcedId: NonEmptyString.optional(),
   lineItem: Ref,
   student: Ref,
-  class: Ref.optional(),
+  class: Ref.nullable().optional(),
   scoreDate: OneRosterDateString,
   scoreStatus: z9.enum([
     "exempt",
@@ -1126,14 +1221,20 @@ var OneRosterResultCreateInput = z9.object({
   score: z9.number().nullable().optional(),
   textScore: z9.string().nullable().optional(),
   status: Status,
+  scoreScale: Ref.nullable().optional(),
   comment: z9.string().nullable().optional(),
+  learningObjectiveSet: LearningObjectiveScoreSetSchema.nullable().optional(),
+  inProgress: z9.string().optional(),
+  incomplete: z9.string().optional(),
+  late: z9.string().optional(),
+  missing: z9.string().optional(),
   metadata: Metadata
 }).strict();
 var OneRosterScoreScaleCreateInput = z9.object({
   sourcedId: NonEmptyString.optional(),
   title: NonEmptyString.describe("title must be a non-empty string"),
-  status: Status.optional(),
-  type: z9.string(),
+  status: Status,
+  type: NonEmptyString,
   class: Ref,
   course: Ref.nullable().optional(),
   scoreScaleValue: z9.array(z9.object({
@@ -1142,13 +1243,11 @@ var OneRosterScoreScaleCreateInput = z9.object({
     value: z9.string().optional(),
     description: z9.string().optional()
   }).strict()),
-  minScore: z9.number().optional(),
-  maxScore: z9.number().optional(),
   metadata: Metadata
 }).strict();
 var OneRosterAssessmentLineItemCreateInput = z9.object({
   sourcedId: NonEmptyString.optional(),
-  status: Status.optional(),
+  status: Status,
   dateLastModified: IsoDateTimeString.optional(),
   title: NonEmptyString.describe("title must be a non-empty string"),
   description: z9.string().nullable().optional(),
@@ -1166,18 +1265,9 @@ var OneRosterAssessmentLineItemCreateInput = z9.object({
   course: Ref.nullable().optional(),
   metadata: Metadata
 }).strict();
-var LearningObjectiveResult = z9.object({
-  learningObjectiveId: z9.string(),
-  score: z9.number().optional(),
-  textScore: z9.string().optional()
-});
-var LearningObjectiveScoreSetSchema = z9.array(z9.object({
-  source: z9.string(),
-  learningObjectiveResults: z9.array(LearningObjectiveResult)
-}));
 var OneRosterAssessmentResultCreateInput = z9.object({
   sourcedId: NonEmptyString.optional(),
-  status: Status.optional(),
+  status: Status,
   dateLastModified: IsoDateTimeString.optional(),
   metadata: Metadata,
   assessmentLineItem: Ref,
@@ -1206,7 +1296,7 @@ var OneRosterOrgCreateInput = z9.object({
   status: Status.optional(),
   name: NonEmptyString.describe("name must be a non-empty string"),
   type: OrganizationType,
-  identifier: NonEmptyString.optional(),
+  identifier: z9.string().nullish(),
   parent: Ref.optional(),
   metadata: Metadata
 }).strict();
@@ -1214,8 +1304,8 @@ var OneRosterSchoolCreateInput = z9.object({
   sourcedId: NonEmptyString.optional(),
   status: Status.optional(),
   name: NonEmptyString.describe("name must be a non-empty string"),
-  type: z9.literal("school").optional(),
-  identifier: NonEmptyString.optional(),
+  type: z9.literal("school").default("school"),
+  identifier: z9.string().nullish(),
   parent: Ref.optional(),
   metadata: Metadata
 }).strict();
@@ -1233,11 +1323,13 @@ var OneRosterAcademicSessionCreateInput = z9.object({
   metadata: Metadata
 }).strict();
 var OneRosterComponentResourceCreateInput = z9.object({
-  sourcedId: NonEmptyString.optional(),
+  sourcedId: NonEmptyString,
   title: NonEmptyString.describe("title must be a non-empty string"),
   courseComponent: Ref,
   resource: Ref,
   status: Status,
+  sortOrder: z9.number().optional(),
+  lessonType: LessonType.optional(),
   metadata: Metadata
 }).strict();
 var OneRosterCourseComponentCreateInput = z9.object({
@@ -1245,8 +1337,17 @@ var OneRosterCourseComponentCreateInput = z9.object({
   title: NonEmptyString.describe("title must be a non-empty string"),
   course: Ref,
   status: Status,
+  sortOrder: z9.number().optional(),
+  parent: Ref.nullable().optional(),
+  courseComponent: Ref.nullable().optional(),
+  prerequisites: z9.array(z9.string()).nullable().optional(),
+  prerequisiteCriteria: z9.string().nullable().optional(),
+  unlockDate: OneRosterDateString.nullable().optional(),
   metadata: Metadata
-}).strict();
+}).strict().transform(({ courseComponent, parent, ...rest }) => ({
+  ...rest,
+  parent: parent === undefined ? courseComponent ?? undefined : parent
+}));
 var OneRosterEnrollInput = z9.object({
   sourcedId: NonEmptyString.describe("sourcedId must be a non-empty string"),
   role: z9.enum(["student", "teacher"]),
@@ -1266,8 +1367,23 @@ var OneRosterCredentialInput = z9.object({
   })
 }).strict();
 var OneRosterDemographicsCreateInput = z9.object({
-  sourcedId: NonEmptyString.describe("sourcedId must be a non-empty string")
-}).loose();
+  sourcedId: NonEmptyString.describe("sourcedId must be a non-empty string"),
+  status: Status.optional(),
+  metadata: Metadata,
+  birthDate: z9.string().regex(/^\d{4}-\d{2}-\d{2}$/).nullable().optional(),
+  sex: z9.enum(["male", "female"]).nullable().optional(),
+  americanIndianOrAlaskaNative: StringBoolean.nullable().optional(),
+  asian: StringBoolean.nullable().optional(),
+  blackOrAfricanAmerican: StringBoolean.nullable().optional(),
+  nativeHawaiianOrOtherPacificIslander: StringBoolean.nullable().optional(),
+  white: StringBoolean.nullable().optional(),
+  demographicRaceTwoOrMoreRaces: StringBoolean.nullable().optional(),
+  hispanicOrLatinoEthnicity: StringBoolean.nullable().optional(),
+  countryOfBirthCode: z9.string().nullable().optional(),
+  stateOfBirthAbbreviation: z9.string().nullable().optional(),
+  cityOfBirth: z9.string().nullable().optional(),
+  publicSchoolResidenceStatus: z9.string().nullable().optional()
+}).strict();
 var CommonResourceMetadataSchema = z9.object({
   type: ResourceType,
   subject: TimebackSubject.nullish(),
@@ -1337,16 +1453,63 @@ var ResourceMetadataSchema = z9.discriminatedUnion("type", [
   CourseMaterialMetadataSchema,
   AssessmentBankMetadataSchema
 ]);
+var ReservedResourceMetadataKeys = new Set([
+  "type",
+  "subject",
+  "grades",
+  "language",
+  "xp",
+  "url",
+  "keywords",
+  "learningObjectiveSet",
+  "lessonType",
+  "subType",
+  "questionType",
+  "difficulty",
+  "format",
+  "author",
+  "pageCount",
+  "duration",
+  "speaker",
+  "captionsAvailable",
+  "launchUrl",
+  "toolProvider",
+  "instructionalMethod",
+  "courseIdOnFail",
+  "resolution",
+  "resources"
+]);
+var UntypedResourceMetadataSchema = z9.record(z9.string(), z9.unknown()).superRefine((metadata, ctx) => {
+  if ("fail_fast" in metadata) {
+    const result = FastFailConfigSchema.safeParse(metadata.fail_fast);
+    if (!result.success) {
+      for (const issue of result.error.issues) {
+        ctx.addIssue({
+          ...issue,
+          path: ["fail_fast", ...issue.path]
+        });
+      }
+    }
+  }
+  const reservedKeys = Object.keys(metadata).filter((key) => ReservedResourceMetadataKeys.has(key));
+  if (reservedKeys.length === 0) {
+    return;
+  }
+  ctx.addIssue({
+    code: "custom",
+    message: `metadata keys ${reservedKeys.map((key) => `\`${key}\``).join(", ")} require a valid \`type\` discriminator`
+  });
+});
 var OneRosterResourceCreateInput = z9.object({
   sourcedId: NonEmptyString.optional(),
   title: NonEmptyString.describe("title must be a non-empty string"),
   vendorResourceId: NonEmptyString.describe("vendorResourceId must be a non-empty string"),
   roles: z9.array(z9.enum(["primary", "secondary"])).optional(),
   importance: z9.enum(["primary", "secondary"]).optional(),
-  vendorId: z9.string().optional(),
-  applicationId: z9.string().optional(),
+  vendorId: NonEmptyString.nullable().optional(),
+  applicationId: NonEmptyString.nullable().optional(),
   status: Status.optional(),
-  metadata: ResourceMetadataSchema.nullable().optional()
+  metadata: z9.union([ResourceMetadataSchema, UntypedResourceMetadataSchema]).nullable().optional()
 }).strict();
 var CourseStructureItem = z9.object({
   url: NonEmptyString.describe("courseStructure.url must be a non-empty string"),
@@ -1961,7 +2124,7 @@ class AnalyticsResource {
       params: {
         email: validated.email,
         studentId: validated.studentId,
-        weekDate: normalizeStartDate(validated.weekDate, validated.timezone),
+        weekDate: normalizeStartDate(validated.weekDate, validated.timezone, "weekDate"),
         timezone: validated.timezone
       }
     });

package/dist/index.js

@@ -85,7 +85,7 @@ import {
   WebhookFilterCreateInput,
   WebhookFilterUpdateInput,
   WebhookUpdateInput
-} from "./chunk-z964w2xh.js";
+} from "./chunk-jqy7m30q.js";
 import {
   ApiError,
   BaseTransport,
@@ -2264,17 +2264,18 @@ class CoursesResourceImpl extends BaseResource {
     return response.courseComponent;
   }
   createComponent(data) {
-    validateWithSchema(OneRosterCourseComponentCreateInput, data, "course component");
+    const validated = validateWithSchema(OneRosterCourseComponentCreateInput, data, "course component");
     return this.transport.request(`${this.basePath}/components`, {
       method: "POST",
-      body: { courseComponent: data }
+      body: { courseComponent: validated }
     });
   }
   updateComponent(sourcedId, data) {
     validateSourcedId(sourcedId, "update course component");
+    const validated = validateWithSchema(OneRosterCourseComponentCreateInput, data, "course component");
     return this.transport.request(`${this.basePath}/components/${sourcedId}`, {
       method: "PUT",
-      body: { courseComponent: data }
+      body: { courseComponent: validated }
     });
   }
   deleteComponent(sourcedId) {
@@ -2295,17 +2296,18 @@ class CoursesResourceImpl extends BaseResource {
     return response.componentResource;
   }
   createComponentResource(data) {
-    validateWithSchema(OneRosterComponentResourceCreateInput, data, "component resource");
+    const validated = validateWithSchema(OneRosterComponentResourceCreateInput, data, "component resource");
     return this.transport.request(`${this.basePath}/component-resources`, {
       method: "POST",
-      body: { componentResource: data }
+      body: { componentResource: validated }
     });
   }
   updateComponentResource(sourcedId, data) {
     validateSourcedId(sourcedId, "update component resource");
+    const validated = validateWithSchema(OneRosterComponentResourceCreateInput, data, "component resource");
     return this.transport.request(`${this.basePath}/component-resources/${sourcedId}`, {
       method: "PUT",
-      body: { componentResource: data }
+      body: { componentResource: validated }
     });
   }
   deleteComponentResource(sourcedId) {

package/dist/utils.js

@@ -1,6 +1,6 @@
 import {
   aggregateActivityMetrics
-} from "./chunk-z964w2xh.js";
+} from "./chunk-jqy7m30q.js";
 import"./chunk-bjb7ngh9.js";
 import"./chunk-3j7jywnx.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/core",
-	"version": "0.2.3-beta.20260326015342",
+	"version": "0.2.3-beta.20260330020222",
 	"type": "module",
 	"exports": {
 		".": {