@playcademy/sandbox 0.3.16-beta.7 → 0.3.17-beta.1

package/dist/cli.js

@@ -1310,7 +1310,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.16-beta.7",
+    version: "0.3.17-beta.1",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -30485,6 +30485,27 @@ class TimebackAdminService {
     const rounded = Math.round(value * TimebackAdminService.XP_PRECISION_FACTOR) / TimebackAdminService.XP_PRECISION_FACTOR;
     return Object.is(rounded, -0) ? 0 : rounded;
   }
+  static toAttributionEventTime(date3) {
+    if (!date3) {
+      return;
+    }
+    const match = date3.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+    if (!match) {
+      throw new ValidationError("Date must be in YYYY-MM-DD format");
+    }
+    const [, yearStr, monthStr, dayStr] = match;
+    const year = Number(yearStr);
+    const month = Number(monthStr);
+    const day = Number(dayStr);
+    if (!Number.isInteger(year) || !Number.isInteger(month) || !Number.isInteger(day)) {
+      throw new ValidationError("Date must be in YYYY-MM-DD format");
+    }
+    const eventTime = new Date(Date.UTC(year, month - 1, day, 12, 0, 0));
+    if (eventTime.getUTCFullYear() !== year || eventTime.getUTCMonth() + 1 !== month || eventTime.getUTCDate() !== day) {
+      throw new ValidationError("Date must be a valid calendar date");
+    }
+    return eventTime.toISOString();
+  }
   requireClient() {
     if (!this.deps.timeback) {
       logger16.error("Timeback client not available in context");
@@ -30560,7 +30581,6 @@ class TimebackAdminService {
           masteredUnitsForDay += masteredUnitsFromFact;
         }
       }
-      const roundedXpForDay = TimebackAdminService.roundXpToTenths(xpForDay);
       totalXpRaw += xpForDay;
       activeTimeSeconds += activeSecondsForDay;
       masteredUnits += masteredUnitsForDay;
@@ -30569,7 +30589,7 @@ class TimebackAdminService {
       }
       history.push({
         date: date3,
-        xpEarned: roundedXpForDay,
+        xpEarned: TimebackAdminService.roundXpToTenths(xpForDay),
         activeTimeSeconds: activeSecondsForDay,
         masteredUnits: masteredUnitsForDay
       });
@@ -30883,6 +30903,7 @@ class TimebackAdminService {
       courseId: data.courseId,
       studentId: data.studentId,
       xpEarned: data.xp,
+      eventTime: TimebackAdminService.toAttributionEventTime(data.date),
       reason: data.reason,
       actor,
       appName,
@@ -30897,6 +30918,7 @@ class TimebackAdminService {
       courseId: data.courseId,
       studentId: data.studentId,
       activeTimeSeconds: data.seconds,
+      eventTime: TimebackAdminService.toAttributionEventTime(data.date),
       reason: data.reason,
       actor,
       appName,
@@ -30911,6 +30933,7 @@ class TimebackAdminService {
       courseId: data.courseId,
       studentId: data.studentId,
       masteredUnits: data.units,
+      eventTime: TimebackAdminService.toAttributionEventTime(data.date),
       reason: data.reason,
       actor,
       appName,
@@ -34838,7 +34861,7 @@ function createCaliperNamespace(client) {
         "@context": CALIPER_CONSTANTS4.context,
         id: `urn:uuid:${crypto.randomUUID()}`,
         type: TIMEBACK_EVENT_TYPES4.timeSpentEvent,
-        eventTime: new Date().toISOString(),
+        eventTime: data.eventTime || new Date().toISOString(),
         profile: CALIPER_CONSTANTS4.profile,
         actor: {
           id: urls.user(data.studentId),
@@ -35339,6 +35362,7 @@ class AdminEventRecorder {
       courseId: data.courseId,
       courseName: ctx.courseContext.courseName,
       xpEarned: data.xpEarned,
+      eventTime: data.eventTime,
       subject: ctx.courseContext.subject,
       appName: ctx.appName,
       sensorUrl: ctx.sensorUrl,
@@ -35364,6 +35388,7 @@ class AdminEventRecorder {
       courseId: data.courseId,
       courseName: ctx.courseContext.courseName,
       activeTimeSeconds: data.activeTimeSeconds,
+      eventTime: data.eventTime,
       subject: ctx.courseContext.subject,
       appName: ctx.appName,
       sensorUrl: ctx.sensorUrl,
@@ -35384,6 +35409,7 @@ class AdminEventRecorder {
       courseId: data.courseId,
       courseName: ctx.courseContext.courseName,
       masteredUnits: data.masteredUnits,
+      eventTime: data.eventTime,
       subject: ctx.courseContext.subject,
       appName: ctx.appName,
       sensorUrl: ctx.sensorUrl,
@@ -93379,7 +93405,19 @@ function isTimebackGrade3(value) {
 function isTimebackSubject3(value) {
   return TIMEBACK_SUBJECTS5.includes(value);
 }
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS5, TimebackGradeSchema, TimebackSubjectSchema, UpdateTimebackXpRequestSchema, EndActivityRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ToggleCourseCompletionRequestSchema;
+function isValidAdminAttributionDate(value) {
+  const match3 = value.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+  if (!match3) {
+    return false;
+  }
+  const [, yearStr, monthStr, dayStr] = match3;
+  const year3 = Number(yearStr);
+  const month = Number(monthStr);
+  const day = Number(dayStr);
+  const date4 = new Date(Date.UTC(year3, month - 1, day, 12, 0, 0));
+  return date4.getUTCFullYear() === year3 && date4.getUTCMonth() + 1 === month && date4.getUTCDate() === day;
+}
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS5, TimebackGradeSchema, TimebackSubjectSchema, UpdateTimebackXpRequestSchema, EndActivityRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, AdminAttributionDateSchema, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ToggleCourseCompletionRequestSchema;
 var init_schemas11 = __esm(() => {
   init_esm();
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
@@ -93489,14 +93527,32 @@ var init_schemas11 = __esm(() => {
     studentId: exports_external.string().min(1),
     reason: exports_external.string().min(1)
   });
+  AdminAttributionDateSchema = exports_external.string().superRefine((value, ctx) => {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+      ctx.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        message: "Date must be in YYYY-MM-DD format"
+      });
+      return;
+    }
+    if (!isValidAdminAttributionDate(value)) {
+      ctx.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        message: "Date must be a valid calendar date"
+      });
+    }
+  });
   GrantTimebackXpRequestSchema = AdminTimebackMutationBaseSchema.extend({
-    xp: exports_external.number().min(-100, "Amount must be between -100 and 100").max(100, "Amount must be between -100 and 100").refine((value) => value !== 0, { message: "Amount cannot be 0" })
+    xp: exports_external.number().min(-100, "Amount must be between -100 and 100").max(100, "Amount must be between -100 and 100").refine((value) => value !== 0, { message: "Amount cannot be 0" }),
+    date: AdminAttributionDateSchema.optional()
   });
   AdjustTimebackTimeRequestSchema = AdminTimebackMutationBaseSchema.extend({
-    seconds: exports_external.number().refine((value) => value !== 0, { message: "Time amount cannot be 0" })
+    seconds: exports_external.number().refine((value) => value !== 0, { message: "Time amount cannot be 0" }),
+    date: AdminAttributionDateSchema.optional()
   });
   AdjustTimebackMasteryRequestSchema = AdminTimebackMutationBaseSchema.extend({
-    units: exports_external.number().refine((value) => value !== 0, { message: "Units cannot be 0" })
+    units: exports_external.number().refine((value) => value !== 0, { message: "Units cannot be 0" }),
+    date: AdminAttributionDateSchema.optional()
   });
   ToggleCourseCompletionRequestSchema = exports_external.object({
     gameId: exports_external.string().uuid(),
@@ -95907,7 +95963,8 @@ var init_timeback_controller = __esm(() => {
       gameId: body2.gameId,
       courseId: body2.courseId,
       studentId: body2.studentId,
-      xp: body2.xp
+      xp: body2.xp,
+      date: body2.date
     });
     return ctx.services.timebackAdmin.grantManualXp(body2, ctx.user);
   });
@@ -95918,7 +95975,8 @@ var init_timeback_controller = __esm(() => {
       gameId: body2.gameId,
       courseId: body2.courseId,
       studentId: body2.studentId,
-      seconds: body2.seconds
+      seconds: body2.seconds,
+      date: body2.date
     });
     return ctx.services.timebackAdmin.adjustTimeSpent(body2, ctx.user);
   });
@@ -95929,7 +95987,8 @@ var init_timeback_controller = __esm(() => {
       gameId: body2.gameId,
       courseId: body2.courseId,
       studentId: body2.studentId,
-      units: body2.units
+      units: body2.units,
+      date: body2.date
     });
     return ctx.services.timebackAdmin.adjustMasteredUnits(body2, ctx.user);
   });

package/dist/server.js

@@ -1309,7 +1309,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.16-beta.7",
+    version: "0.3.17-beta.1",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -30484,6 +30484,27 @@ class TimebackAdminService {
     const rounded = Math.round(value * TimebackAdminService.XP_PRECISION_FACTOR) / TimebackAdminService.XP_PRECISION_FACTOR;
     return Object.is(rounded, -0) ? 0 : rounded;
   }
+  static toAttributionEventTime(date3) {
+    if (!date3) {
+      return;
+    }
+    const match = date3.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+    if (!match) {
+      throw new ValidationError("Date must be in YYYY-MM-DD format");
+    }
+    const [, yearStr, monthStr, dayStr] = match;
+    const year = Number(yearStr);
+    const month = Number(monthStr);
+    const day = Number(dayStr);
+    if (!Number.isInteger(year) || !Number.isInteger(month) || !Number.isInteger(day)) {
+      throw new ValidationError("Date must be in YYYY-MM-DD format");
+    }
+    const eventTime = new Date(Date.UTC(year, month - 1, day, 12, 0, 0));
+    if (eventTime.getUTCFullYear() !== year || eventTime.getUTCMonth() + 1 !== month || eventTime.getUTCDate() !== day) {
+      throw new ValidationError("Date must be a valid calendar date");
+    }
+    return eventTime.toISOString();
+  }
   requireClient() {
     if (!this.deps.timeback) {
       logger16.error("Timeback client not available in context");
@@ -30559,7 +30580,6 @@ class TimebackAdminService {
           masteredUnitsForDay += masteredUnitsFromFact;
         }
       }
-      const roundedXpForDay = TimebackAdminService.roundXpToTenths(xpForDay);
       totalXpRaw += xpForDay;
       activeTimeSeconds += activeSecondsForDay;
       masteredUnits += masteredUnitsForDay;
@@ -30568,7 +30588,7 @@ class TimebackAdminService {
       }
       history.push({
         date: date3,
-        xpEarned: roundedXpForDay,
+        xpEarned: TimebackAdminService.roundXpToTenths(xpForDay),
         activeTimeSeconds: activeSecondsForDay,
         masteredUnits: masteredUnitsForDay
       });
@@ -30882,6 +30902,7 @@ class TimebackAdminService {
       courseId: data.courseId,
       studentId: data.studentId,
       xpEarned: data.xp,
+      eventTime: TimebackAdminService.toAttributionEventTime(data.date),
       reason: data.reason,
       actor,
       appName,
@@ -30896,6 +30917,7 @@ class TimebackAdminService {
       courseId: data.courseId,
       studentId: data.studentId,
       activeTimeSeconds: data.seconds,
+      eventTime: TimebackAdminService.toAttributionEventTime(data.date),
       reason: data.reason,
       actor,
       appName,
@@ -30910,6 +30932,7 @@ class TimebackAdminService {
       courseId: data.courseId,
       studentId: data.studentId,
       masteredUnits: data.units,
+      eventTime: TimebackAdminService.toAttributionEventTime(data.date),
       reason: data.reason,
       actor,
       appName,
@@ -34837,7 +34860,7 @@ function createCaliperNamespace(client) {
         "@context": CALIPER_CONSTANTS4.context,
         id: `urn:uuid:${crypto.randomUUID()}`,
         type: TIMEBACK_EVENT_TYPES4.timeSpentEvent,
-        eventTime: new Date().toISOString(),
+        eventTime: data.eventTime || new Date().toISOString(),
         profile: CALIPER_CONSTANTS4.profile,
         actor: {
           id: urls.user(data.studentId),
@@ -35338,6 +35361,7 @@ class AdminEventRecorder {
       courseId: data.courseId,
       courseName: ctx.courseContext.courseName,
       xpEarned: data.xpEarned,
+      eventTime: data.eventTime,
       subject: ctx.courseContext.subject,
       appName: ctx.appName,
       sensorUrl: ctx.sensorUrl,
@@ -35363,6 +35387,7 @@ class AdminEventRecorder {
       courseId: data.courseId,
       courseName: ctx.courseContext.courseName,
       activeTimeSeconds: data.activeTimeSeconds,
+      eventTime: data.eventTime,
       subject: ctx.courseContext.subject,
       appName: ctx.appName,
       sensorUrl: ctx.sensorUrl,
@@ -35383,6 +35408,7 @@ class AdminEventRecorder {
       courseId: data.courseId,
       courseName: ctx.courseContext.courseName,
       masteredUnits: data.masteredUnits,
+      eventTime: data.eventTime,
       subject: ctx.courseContext.subject,
       appName: ctx.appName,
       sensorUrl: ctx.sensorUrl,
@@ -93378,7 +93404,19 @@ function isTimebackGrade3(value) {
 function isTimebackSubject3(value) {
   return TIMEBACK_SUBJECTS5.includes(value);
 }
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS5, TimebackGradeSchema, TimebackSubjectSchema, UpdateTimebackXpRequestSchema, EndActivityRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ToggleCourseCompletionRequestSchema;
+function isValidAdminAttributionDate(value) {
+  const match3 = value.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+  if (!match3) {
+    return false;
+  }
+  const [, yearStr, monthStr, dayStr] = match3;
+  const year3 = Number(yearStr);
+  const month = Number(monthStr);
+  const day = Number(dayStr);
+  const date4 = new Date(Date.UTC(year3, month - 1, day, 12, 0, 0));
+  return date4.getUTCFullYear() === year3 && date4.getUTCMonth() + 1 === month && date4.getUTCDate() === day;
+}
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS5, TimebackGradeSchema, TimebackSubjectSchema, UpdateTimebackXpRequestSchema, EndActivityRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, AdminAttributionDateSchema, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ToggleCourseCompletionRequestSchema;
 var init_schemas11 = __esm(() => {
   init_esm();
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
@@ -93488,14 +93526,32 @@ var init_schemas11 = __esm(() => {
     studentId: exports_external.string().min(1),
     reason: exports_external.string().min(1)
   });
+  AdminAttributionDateSchema = exports_external.string().superRefine((value, ctx) => {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+      ctx.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        message: "Date must be in YYYY-MM-DD format"
+      });
+      return;
+    }
+    if (!isValidAdminAttributionDate(value)) {
+      ctx.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        message: "Date must be a valid calendar date"
+      });
+    }
+  });
   GrantTimebackXpRequestSchema = AdminTimebackMutationBaseSchema.extend({
-    xp: exports_external.number().min(-100, "Amount must be between -100 and 100").max(100, "Amount must be between -100 and 100").refine((value) => value !== 0, { message: "Amount cannot be 0" })
+    xp: exports_external.number().min(-100, "Amount must be between -100 and 100").max(100, "Amount must be between -100 and 100").refine((value) => value !== 0, { message: "Amount cannot be 0" }),
+    date: AdminAttributionDateSchema.optional()
   });
   AdjustTimebackTimeRequestSchema = AdminTimebackMutationBaseSchema.extend({
-    seconds: exports_external.number().refine((value) => value !== 0, { message: "Time amount cannot be 0" })
+    seconds: exports_external.number().refine((value) => value !== 0, { message: "Time amount cannot be 0" }),
+    date: AdminAttributionDateSchema.optional()
   });
   AdjustTimebackMasteryRequestSchema = AdminTimebackMutationBaseSchema.extend({
-    units: exports_external.number().refine((value) => value !== 0, { message: "Units cannot be 0" })
+    units: exports_external.number().refine((value) => value !== 0, { message: "Units cannot be 0" }),
+    date: AdminAttributionDateSchema.optional()
   });
   ToggleCourseCompletionRequestSchema = exports_external.object({
     gameId: exports_external.string().uuid(),
@@ -95906,7 +95962,8 @@ var init_timeback_controller = __esm(() => {
       gameId: body2.gameId,
       courseId: body2.courseId,
       studentId: body2.studentId,
-      xp: body2.xp
+      xp: body2.xp,
+      date: body2.date
     });
     return ctx.services.timebackAdmin.grantManualXp(body2, ctx.user);
   });
@@ -95917,7 +95974,8 @@ var init_timeback_controller = __esm(() => {
       gameId: body2.gameId,
       courseId: body2.courseId,
       studentId: body2.studentId,
-      seconds: body2.seconds
+      seconds: body2.seconds,
+      date: body2.date
     });
     return ctx.services.timebackAdmin.adjustTimeSpent(body2, ctx.user);
   });
@@ -95928,7 +95986,8 @@ var init_timeback_controller = __esm(() => {
       gameId: body2.gameId,
       courseId: body2.courseId,
       studentId: body2.studentId,
-      units: body2.units
+      units: body2.units,
+      date: body2.date
     });
     return ctx.services.timebackAdmin.adjustMasteredUnits(body2, ctx.user);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.3.16-beta.7",
+    "version": "0.3.17-beta.1",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {