@playcademy/sandbox 0.6.0 → 0.6.1-beta.2

package/dist/cli.js

@@ -234,7 +234,7 @@ var init_game = __esm(() => {
 });
 
 // ../constants/src/platform.ts
-var CORE_GAME_UUIDS;
+var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone", CORE_GAME_UUIDS;
 var init_platform = __esm(() => {
   CORE_GAME_UUIDS = {
     DEMO: "00000000-0000-0000-0000-000000000001"
@@ -1080,7 +1080,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.6.0",
+    version: "0.6.1-beta.2",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -11057,6 +11057,11 @@ var init_table3 = __esm(() => {
     email: text("email").notNull().unique(),
     isAnonymous: boolean("is_anonymous").notNull().default(false),
     timebackId: text("timeback_id").unique(),
+    learningTimeZone: text("learning_time_zone"),
+    learningTimeZoneUpdatedAt: timestamp("learning_time_zone_updated_at", {
+      mode: "date",
+      withTimezone: true
+    }),
     emailVerified: boolean("email_verified").notNull().default(false),
     image: text("image"),
     role: userRoleEnum("role").notNull().default("player"),
@@ -31042,7 +31047,7 @@ var init_schemas4 = __esm(() => {
     subject: TimebackSubjectSchema,
     appName: exports_external.string().optional(),
     sensorUrl: exports_external.string().url().optional(),
-    courseId: exports_external.string().optional(),
+    courseId: exports_external.string().min(1).optional(),
     courseName: exports_external.string().optional(),
     studentEmail: exports_external.string().email().optional()
   });
@@ -75585,6 +75590,7 @@ class AnalyticsXp {
     this.core = core3;
   }
   async get(studentId, options) {
+    const timezone2 = options?.timezone ?? PLATFORM_TIMEZONE;
     const enrollments = await this.core.api.edubridge.enrollments.list({ userId: studentId });
     const filteredEnrollments = options?.courseIds?.length ? enrollments.filter((e) => options.courseIds.includes(e.course.id)) : enrollments;
     if (filteredEnrollments.length === 0) {
@@ -75598,7 +75604,7 @@ class AnalyticsXp {
       try {
         const analytics = await this.core.api.edubridge.analytics.getEnrollmentFacts({
           enrollmentId: enrollment.id,
-          timezone: PLATFORM_TIMEZONE
+          timezone: timezone2
         });
         return { enrollment, analytics };
       } catch (error88) {
@@ -75610,7 +75616,7 @@ class AnalyticsXp {
         return { enrollment, analytics: null };
       }
     }));
-    const today = formatDateYMDInTimezone(PLATFORM_TIMEZONE);
+    const today = formatDateYMDInTimezone(timezone2);
     let totalXp = 0;
     let todayXp = 0;
     const courses = [];
@@ -80367,6 +80373,24 @@ var init_timeback_service = __esm(async () => {
         }
       };
     }
+    static resolveRuntimeCourse(resolvedCourseId, requestedCourseId, courseName) {
+      let requestedCourseIdStatus = "absent";
+      if (requestedCourseId === resolvedCourseId) {
+        requestedCourseIdStatus = "accepted";
+      } else if (requestedCourseId !== undefined) {
+        requestedCourseIdStatus = "ignored_mismatch";
+      }
+      return {
+        courseId: resolvedCourseId,
+        courseName: requestedCourseIdStatus === "ignored_mismatch" ? undefined : courseName,
+        attributes: {
+          "app.timeback.course_id": resolvedCourseId,
+          "app.timeback.resolved_course_id": resolvedCourseId,
+          "app.timeback.requested_course_id": requestedCourseId,
+          "app.timeback.requested_course_id_status": requestedCourseIdStatus
+        }
+      };
+    }
     static recordRuntimeContext({
       operation,
       studentId,
@@ -81232,8 +81256,13 @@ var init_timeback_service = __esm(async () => {
         if (!integration) {
           throw new NotFoundError(`Timeback integration for game (grade ${activityData.grade}, subject ${activityData.subject})`);
         }
+        const {
+          courseId: runtimeCourseId,
+          courseName: runtimeCourseName,
+          attributes: courseAttributes
+        } = TimebackService.resolveRuntimeCourse(integration.courseId, activityData.courseId, activityData.courseName);
         const scorePercentage = scoreData.totalQuestions > 0 ? scoreData.correctQuestions / scoreData.totalQuestions * 100 : 0;
-        const result = await client.activity.record(integration.courseId, studentId, {
+        const result = await client.activity.record(runtimeCourseId, studentId, {
           gameId,
           score: scorePercentage,
           totalQuestions: scoreData.totalQuestions,
@@ -81248,8 +81277,8 @@ var init_timeback_service = __esm(async () => {
           subject: activityData.subject,
           appName: activityData.appName,
           sensorUrl: activityData.sensorUrl,
-          courseId: activityData.courseId,
-          courseName: activityData.courseName,
+          courseId: runtimeCourseId,
+          courseName: runtimeCourseName,
           studentEmail: activityData.studentEmail,
           courseTotalXp: integration.totalXp,
           ...runId ? { runId } : {}
@@ -81258,7 +81287,7 @@ var init_timeback_service = __esm(async () => {
         const sessionEndInactiveSeconds = sessionTimingData?.inactiveSeconds;
         const sessionEndEmitted = sessionEndActiveSeconds > 0 || (sessionEndInactiveSeconds ?? 0) > 0;
         if (sessionEndEmitted) {
-          await client.activity.session(integration.courseId, studentId, {
+          await client.activity.session(runtimeCourseId, studentId, {
             gameId,
             activeTimeSeconds: sessionEndActiveSeconds,
             ...sessionEndInactiveSeconds !== undefined ? { inactiveTimeSeconds: sessionEndInactiveSeconds } : {},
@@ -81267,15 +81296,15 @@ var init_timeback_service = __esm(async () => {
             subject: activityData.subject,
             appName: activityData.appName,
             sensorUrl: activityData.sensorUrl,
-            courseId: activityData.courseId,
-            courseName: activityData.courseName,
+            courseId: runtimeCourseId,
+            courseName: runtimeCourseName,
             studentEmail: activityData.studentEmail,
             extensions: extensionsWithResumeId,
             ...runId ? { runId } : {}
           });
         }
         setAttributes({
-          "app.timeback.course_id": integration.courseId,
+          ...courseAttributes,
           "app.timeback.grade": activityData.grade,
           "app.timeback.subject": activityData.subject,
           "app.timeback.total_questions": scoreData.totalQuestions,
@@ -81292,7 +81321,7 @@ var init_timeback_service = __esm(async () => {
         });
         return {
           status: "ok",
-          courseId: integration.courseId,
+          courseId: runtimeCourseId,
           xpAwarded: result.xpAwarded,
           masteredUnits: result.masteredUnitsApplied,
           pctCompleteApp: result.pctCompleteApp,
@@ -81503,10 +81532,15 @@ var init_timeback_service = __esm(async () => {
           if (!integration) {
             throw new NotFoundError(`Timeback integration for game (grade ${activityData.grade}, subject ${activityData.subject})`);
           }
+          const {
+            courseId: runtimeCourseId,
+            courseName: runtimeCourseName,
+            attributes: courseAttributes
+          } = TimebackService.resolveRuntimeCourse(integration.courseId, activityData.courseId, activityData.courseName);
           const activeTimeSeconds = timingData.activeMs / 1000;
           const inactiveTimeSeconds = timingData.pausedMs / 1000;
           if (activeTimeSeconds > 0 || inactiveTimeSeconds > 0) {
-            await client.activity.session(integration.courseId, studentId, {
+            await client.activity.session(runtimeCourseId, studentId, {
               gameId,
               activeTimeSeconds,
               ...inactiveTimeSeconds > 0 ? { inactiveTimeSeconds } : {},
@@ -81515,15 +81549,15 @@ var init_timeback_service = __esm(async () => {
               subject: activityData.subject,
               appName: activityData.appName,
               sensorUrl: activityData.sensorUrl,
-              courseId: activityData.courseId,
-              courseName: activityData.courseName,
+              courseId: runtimeCourseId,
+              courseName: runtimeCourseName,
               studentEmail: activityData.studentEmail,
               extensions: TimebackService.addResumeIdToExtensions(undefined, effectiveResumeId),
               ...runId ? { runId } : {}
             });
           }
           setAttributes({
-            "app.timeback.course_id": integration.courseId,
+            ...courseAttributes,
             "app.timeback.grade": activityData.grade,
             "app.timeback.subject": activityData.subject,
             "app.timeback.active_time_seconds": activeTimeSeconds,
@@ -81568,13 +81602,24 @@ var init_timeback_service = __esm(async () => {
             };
           }
         }
+        const timezone2 = await this.getLearningTimeZoneForStudent(timebackId);
         const result = await client.analytics.getXp(timebackId, {
           courseIds: courseIds.length > 0 ? courseIds : undefined,
+          timezone: timezone2,
           include: options?.include
         });
         return result;
       });
     }
+    async getLearningTimeZoneForStudent(timebackId) {
+      const user = await this.deps.db.query.users.findFirst({
+        where: eq(users.timebackId, timebackId),
+        columns: {
+          learningTimeZone: true
+        }
+      });
+      return user?.learningTimeZone ?? PLATFORM_TIMEZONE;
+    }
     async getStudentMastery(timebackId, user, options) {
       return this.withClientTelemetry(async () => {
         const client = this.requireClient();
@@ -82356,13 +82401,28 @@ var init_session_service = __esm(() => {
   init_errors();
 });
 
+// ../api-core/src/utils/timezone.util.ts
+function normalizeIanaTimeZone(value) {
+  const timeZone = value?.trim();
+  if (!timeZone || timeZone.length > MAX_IANA_TIME_ZONE_LENGTH) {
+    return;
+  }
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone }).format(new Date);
+    return timeZone;
+  } catch {
+    return;
+  }
+}
+var MAX_IANA_TIME_ZONE_LENGTH = 100;
+
 // ../api-core/src/services/user.service.ts
 class UserService {
   deps;
   constructor(deps) {
     this.deps = deps;
   }
-  async getMe(user, gameId) {
+  async getMe(user, gameId, observedTimeZone) {
     const db2 = this.deps.db;
     const userData = await db2.query.users.findFirst({
       where: eq(users.id, user.id)
@@ -82375,6 +82435,7 @@ class UserService {
       "app.user.has_timeback_account": Boolean(userData.timebackId),
       "app.user.timeback_enriched": false
     });
+    const localDay = await this.resolveLocalDay(userData, observedTimeZone);
     const timeback2 = userData.timebackId ? await this.fetchTimebackData(userData.timebackId, gameId) : undefined;
     setAttribute("app.user.timeback_enriched", Boolean(timeback2));
     if (gameId) {
@@ -82384,6 +82445,7 @@ class UserService {
         role: userData.role,
         username: userData.username,
         email: userData.email,
+        localDay,
         timeback: timeback2
       };
     }
@@ -82403,6 +82465,7 @@ class UserService {
       createdAt: userData.createdAt,
       updatedAt: userData.updatedAt,
       hasTimebackAccount: Boolean(timebackAccount),
+      localDay,
       timeback: timeback2
     };
   }
@@ -82440,6 +82503,44 @@ class UserService {
       isDefault: updatedUser.name === DEMO_DISPLAY_NAME_PLACEHOLDER
     };
   }
+  async resolveLocalDay(userData, observedTimeZone) {
+    const normalizedTimeZone = normalizeIanaTimeZone(observedTimeZone);
+    if (normalizedTimeZone) {
+      const observedAt = new Date;
+      const shouldPersist = userData.learningTimeZone !== normalizedTimeZone || !userData.learningTimeZoneUpdatedAt || observedAt.getTime() - userData.learningTimeZoneUpdatedAt.getTime() >= LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS;
+      if (shouldPersist) {
+        await this.deps.db.update(users).set({
+          learningTimeZone: normalizedTimeZone,
+          learningTimeZoneUpdatedAt: observedAt
+        }).where(eq(users.id, userData.id));
+      }
+      setAttributes({
+        "app.user.learning_time_zone_observed": true,
+        "app.user.learning_time_zone_persisted": shouldPersist
+      });
+      return {
+        timeZone: normalizedTimeZone,
+        source: "browser_last_seen",
+        observedAt: (shouldPersist ? observedAt : userData.learningTimeZoneUpdatedAt)?.toISOString() ?? null
+      };
+    }
+    setAttributes({
+      "app.user.learning_time_zone_observed": false,
+      "app.user.learning_time_zone_persisted": false
+    });
+    if (userData.learningTimeZone) {
+      return {
+        timeZone: userData.learningTimeZone,
+        source: "browser_last_seen",
+        observedAt: userData.learningTimeZoneUpdatedAt?.toISOString() ?? null
+      };
+    }
+    return {
+      timeZone: PLATFORM_TIMEZONE,
+      source: "platform_default",
+      observedAt: null
+    };
+  }
   async fetchTimebackData(timebackId, gameId) {
     const [{ role, organizations: allOrganizations }, allEnrollments] = await Promise.all([
       withSpan("timeback.fetch_profile", () => this.fetchStudentProfile(timebackId)),
@@ -82521,6 +82622,7 @@ class UserService {
     return organizations.filter((o) => enrollmentOrgIds.has(o.id));
   }
 }
+var LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS;
 var init_user_service = __esm(() => {
   init_drizzle_orm();
   init_src();
@@ -82529,6 +82631,7 @@ var init_user_service = __esm(() => {
   init_spans();
   init_errors();
   init_timeback_util();
+  LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS = 24 * 60 * 60 * 1000;
 });
 
 // ../api-core/src/services/verify.service.ts
@@ -140159,9 +140262,10 @@ var init_upload_controller = __esm(() => {
 // ../api-core/src/controllers/user.controller.ts
 var getMe, getDemoProfile, updateDemoProfile, users2;
 var init_user_controller = __esm(() => {
+  init_src();
   init_schemas_index();
   init_utils11();
-  getMe = requireNonAnonymous(async (ctx) => ctx.services.user.getMe(ctx.user, ctx.gameId));
+  getMe = requireNonAnonymous(async (ctx) => ctx.services.user.getMe(ctx.user, ctx.gameId, ctx.request.headers.get(PLAYCADEMY_BROWSER_TIME_ZONE_HEADER)));
   getDemoProfile = requireAnonymous(async (ctx) => ctx.services.user.getDemoProfile(ctx.user.id));
   updateDemoProfile = requireAnonymous(async (ctx) => {
     const body2 = await parseRequestBody(ctx.request, DemoProfileSchema);
@@ -140316,8 +140420,39 @@ function getMockHighestGradeMastered(enrollments, subject) {
   const subjectGrades = enrollments.filter((enrollment) => enrollment.subject === subject).map((enrollment) => enrollment.grade);
   return subjectGrades.length > 0 ? Math.max(...subjectGrades) : null;
 }
-async function buildMockUserResponse(db2, user, gameId) {
+async function buildLocalDayContext(db2, user, observedTimeZone) {
+  const normalizedTimeZone = normalizeIanaTimeZone(observedTimeZone);
+  if (normalizedTimeZone) {
+    const observedAt = new Date;
+    const shouldPersist = user.learningTimeZone !== normalizedTimeZone || !user.learningTimeZoneUpdatedAt || observedAt.getTime() - user.learningTimeZoneUpdatedAt.getTime() >= LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS2;
+    if (shouldPersist) {
+      await db2.update(users).set({
+        learningTimeZone: normalizedTimeZone,
+        learningTimeZoneUpdatedAt: observedAt
+      }).where(eq(users.id, user.id));
+    }
+    return {
+      timeZone: normalizedTimeZone,
+      source: "browser_last_seen",
+      observedAt: (shouldPersist ? observedAt : user.learningTimeZoneUpdatedAt)?.toISOString() ?? null
+    };
+  }
+  if (user.learningTimeZone) {
+    return {
+      timeZone: user.learningTimeZone,
+      source: "browser_last_seen",
+      observedAt: user.learningTimeZoneUpdatedAt?.toISOString() ?? null
+    };
+  }
+  return {
+    timeZone: PLATFORM_TIMEZONE,
+    source: "platform_default",
+    observedAt: null
+  };
+}
+async function buildMockUserResponse(db2, user, gameId, observedTimeZone) {
   const timeback3 = user.timebackId ? await getMockTimebackData(db2, user.timebackId, gameId) : undefined;
+  const localDay = await buildLocalDayContext(db2, user, observedTimeZone);
   if (gameId) {
     return {
       id: user.id,
@@ -140325,6 +140460,7 @@ async function buildMockUserResponse(db2, user, gameId) {
       role: user.role,
       username: user.username,
       email: user.email,
+      localDay,
       timeback: timeback3
     };
   }
@@ -140343,15 +140479,19 @@ async function buildMockUserResponse(db2, user, gameId) {
     createdAt: user.createdAt,
     updatedAt: user.updatedAt,
     hasTimebackAccount: Boolean(timebackAccount),
+    localDay,
     timeback: timeback3
   };
 }
+var LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS2;
 var init_timeback6 = __esm(() => {
   init_drizzle_orm();
   init_utils11();
+  init_src();
   init_tables_index();
   init_src2();
   init_config();
+  LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS2 = 24 * 60 * 60 * 1000;
 });
 
 // src/routes/platform/users.ts
@@ -140361,6 +140501,7 @@ var init_users = __esm(async () => {
   init_dist7();
   init_controllers();
   init_errors();
+  init_src();
   init_tables_index();
   init_error_handler();
   init_timeback6();
@@ -140382,7 +140523,7 @@ var init_users = __esm(async () => {
         const error89 = ApiError.notFound("User not found");
         return c2.json(createErrorResponse(error89), error89.status);
       }
-      const response = await buildMockUserResponse(db2, userData, gameId);
+      const response = await buildMockUserResponse(db2, userData, gameId, c2.req.header(PLAYCADEMY_BROWSER_TIME_ZONE_HEADER));
       return c2.json(response);
     }
     return handle2(users2.getMe)(c2);

package/dist/constants.js

@@ -69,7 +69,7 @@ var init_game = __esm(() => {
 });
 
 // ../constants/src/platform.ts
-var CORE_GAME_UUIDS;
+var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone", CORE_GAME_UUIDS;
 var init_platform = __esm(() => {
   CORE_GAME_UUIDS = {
     DEMO: "00000000-0000-0000-0000-000000000001"

package/dist/mocks/timeback.d.ts

@@ -35,4 +35,4 @@ export declare function getMockHighestGradeMastered(enrollments: UserEnrollment[
  * Build a complete user response with mock timeback data.
  * Used to bypass api-core when in mock mode (avoids real API calls).
  */
-export declare function buildMockUserResponse(db: DatabaseInstance, user: User, gameId?: string): Promise<AuthenticatedUser | GameUser>;
+export declare function buildMockUserResponse(db: DatabaseInstance, user: User, gameId?: string, observedTimeZone?: string | null): Promise<AuthenticatedUser | GameUser>;

package/dist/server.js

@@ -233,7 +233,7 @@ var init_game = __esm(() => {
 });
 
 // ../constants/src/platform.ts
-var CORE_GAME_UUIDS;
+var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone", CORE_GAME_UUIDS;
 var init_platform = __esm(() => {
   CORE_GAME_UUIDS = {
     DEMO: "00000000-0000-0000-0000-000000000001"
@@ -1079,7 +1079,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.6.0",
+    version: "0.6.1-beta.2",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -11056,6 +11056,11 @@ var init_table3 = __esm(() => {
     email: text("email").notNull().unique(),
     isAnonymous: boolean("is_anonymous").notNull().default(false),
     timebackId: text("timeback_id").unique(),
+    learningTimeZone: text("learning_time_zone"),
+    learningTimeZoneUpdatedAt: timestamp("learning_time_zone_updated_at", {
+      mode: "date",
+      withTimezone: true
+    }),
     emailVerified: boolean("email_verified").notNull().default(false),
     image: text("image"),
     role: userRoleEnum("role").notNull().default("player"),
@@ -31041,7 +31046,7 @@ var init_schemas4 = __esm(() => {
     subject: TimebackSubjectSchema,
     appName: exports_external.string().optional(),
     sensorUrl: exports_external.string().url().optional(),
-    courseId: exports_external.string().optional(),
+    courseId: exports_external.string().min(1).optional(),
     courseName: exports_external.string().optional(),
     studentEmail: exports_external.string().email().optional()
   });
@@ -75584,6 +75589,7 @@ class AnalyticsXp {
     this.core = core3;
   }
   async get(studentId, options) {
+    const timezone2 = options?.timezone ?? PLATFORM_TIMEZONE;
     const enrollments = await this.core.api.edubridge.enrollments.list({ userId: studentId });
     const filteredEnrollments = options?.courseIds?.length ? enrollments.filter((e) => options.courseIds.includes(e.course.id)) : enrollments;
     if (filteredEnrollments.length === 0) {
@@ -75597,7 +75603,7 @@ class AnalyticsXp {
       try {
         const analytics = await this.core.api.edubridge.analytics.getEnrollmentFacts({
           enrollmentId: enrollment.id,
-          timezone: PLATFORM_TIMEZONE
+          timezone: timezone2
         });
         return { enrollment, analytics };
       } catch (error88) {
@@ -75609,7 +75615,7 @@ class AnalyticsXp {
         return { enrollment, analytics: null };
       }
     }));
-    const today = formatDateYMDInTimezone(PLATFORM_TIMEZONE);
+    const today = formatDateYMDInTimezone(timezone2);
     let totalXp = 0;
     let todayXp = 0;
     const courses = [];
@@ -80366,6 +80372,24 @@ var init_timeback_service = __esm(async () => {
         }
       };
     }
+    static resolveRuntimeCourse(resolvedCourseId, requestedCourseId, courseName) {
+      let requestedCourseIdStatus = "absent";
+      if (requestedCourseId === resolvedCourseId) {
+        requestedCourseIdStatus = "accepted";
+      } else if (requestedCourseId !== undefined) {
+        requestedCourseIdStatus = "ignored_mismatch";
+      }
+      return {
+        courseId: resolvedCourseId,
+        courseName: requestedCourseIdStatus === "ignored_mismatch" ? undefined : courseName,
+        attributes: {
+          "app.timeback.course_id": resolvedCourseId,
+          "app.timeback.resolved_course_id": resolvedCourseId,
+          "app.timeback.requested_course_id": requestedCourseId,
+          "app.timeback.requested_course_id_status": requestedCourseIdStatus
+        }
+      };
+    }
     static recordRuntimeContext({
       operation,
       studentId,
@@ -81231,8 +81255,13 @@ var init_timeback_service = __esm(async () => {
         if (!integration) {
           throw new NotFoundError(`Timeback integration for game (grade ${activityData.grade}, subject ${activityData.subject})`);
         }
+        const {
+          courseId: runtimeCourseId,
+          courseName: runtimeCourseName,
+          attributes: courseAttributes
+        } = TimebackService.resolveRuntimeCourse(integration.courseId, activityData.courseId, activityData.courseName);
         const scorePercentage = scoreData.totalQuestions > 0 ? scoreData.correctQuestions / scoreData.totalQuestions * 100 : 0;
-        const result = await client.activity.record(integration.courseId, studentId, {
+        const result = await client.activity.record(runtimeCourseId, studentId, {
           gameId,
           score: scorePercentage,
           totalQuestions: scoreData.totalQuestions,
@@ -81247,8 +81276,8 @@ var init_timeback_service = __esm(async () => {
           subject: activityData.subject,
           appName: activityData.appName,
           sensorUrl: activityData.sensorUrl,
-          courseId: activityData.courseId,
-          courseName: activityData.courseName,
+          courseId: runtimeCourseId,
+          courseName: runtimeCourseName,
           studentEmail: activityData.studentEmail,
           courseTotalXp: integration.totalXp,
           ...runId ? { runId } : {}
@@ -81257,7 +81286,7 @@ var init_timeback_service = __esm(async () => {
         const sessionEndInactiveSeconds = sessionTimingData?.inactiveSeconds;
         const sessionEndEmitted = sessionEndActiveSeconds > 0 || (sessionEndInactiveSeconds ?? 0) > 0;
         if (sessionEndEmitted) {
-          await client.activity.session(integration.courseId, studentId, {
+          await client.activity.session(runtimeCourseId, studentId, {
             gameId,
             activeTimeSeconds: sessionEndActiveSeconds,
             ...sessionEndInactiveSeconds !== undefined ? { inactiveTimeSeconds: sessionEndInactiveSeconds } : {},
@@ -81266,15 +81295,15 @@ var init_timeback_service = __esm(async () => {
             subject: activityData.subject,
             appName: activityData.appName,
             sensorUrl: activityData.sensorUrl,
-            courseId: activityData.courseId,
-            courseName: activityData.courseName,
+            courseId: runtimeCourseId,
+            courseName: runtimeCourseName,
             studentEmail: activityData.studentEmail,
             extensions: extensionsWithResumeId,
             ...runId ? { runId } : {}
           });
         }
         setAttributes({
-          "app.timeback.course_id": integration.courseId,
+          ...courseAttributes,
           "app.timeback.grade": activityData.grade,
           "app.timeback.subject": activityData.subject,
           "app.timeback.total_questions": scoreData.totalQuestions,
@@ -81291,7 +81320,7 @@ var init_timeback_service = __esm(async () => {
         });
         return {
           status: "ok",
-          courseId: integration.courseId,
+          courseId: runtimeCourseId,
           xpAwarded: result.xpAwarded,
           masteredUnits: result.masteredUnitsApplied,
           pctCompleteApp: result.pctCompleteApp,
@@ -81502,10 +81531,15 @@ var init_timeback_service = __esm(async () => {
           if (!integration) {
             throw new NotFoundError(`Timeback integration for game (grade ${activityData.grade}, subject ${activityData.subject})`);
           }
+          const {
+            courseId: runtimeCourseId,
+            courseName: runtimeCourseName,
+            attributes: courseAttributes
+          } = TimebackService.resolveRuntimeCourse(integration.courseId, activityData.courseId, activityData.courseName);
           const activeTimeSeconds = timingData.activeMs / 1000;
           const inactiveTimeSeconds = timingData.pausedMs / 1000;
           if (activeTimeSeconds > 0 || inactiveTimeSeconds > 0) {
-            await client.activity.session(integration.courseId, studentId, {
+            await client.activity.session(runtimeCourseId, studentId, {
               gameId,
               activeTimeSeconds,
               ...inactiveTimeSeconds > 0 ? { inactiveTimeSeconds } : {},
@@ -81514,15 +81548,15 @@ var init_timeback_service = __esm(async () => {
               subject: activityData.subject,
               appName: activityData.appName,
               sensorUrl: activityData.sensorUrl,
-              courseId: activityData.courseId,
-              courseName: activityData.courseName,
+              courseId: runtimeCourseId,
+              courseName: runtimeCourseName,
               studentEmail: activityData.studentEmail,
               extensions: TimebackService.addResumeIdToExtensions(undefined, effectiveResumeId),
               ...runId ? { runId } : {}
             });
           }
           setAttributes({
-            "app.timeback.course_id": integration.courseId,
+            ...courseAttributes,
             "app.timeback.grade": activityData.grade,
             "app.timeback.subject": activityData.subject,
             "app.timeback.active_time_seconds": activeTimeSeconds,
@@ -81567,13 +81601,24 @@ var init_timeback_service = __esm(async () => {
             };
           }
         }
+        const timezone2 = await this.getLearningTimeZoneForStudent(timebackId);
         const result = await client.analytics.getXp(timebackId, {
           courseIds: courseIds.length > 0 ? courseIds : undefined,
+          timezone: timezone2,
           include: options?.include
         });
         return result;
       });
     }
+    async getLearningTimeZoneForStudent(timebackId) {
+      const user = await this.deps.db.query.users.findFirst({
+        where: eq(users.timebackId, timebackId),
+        columns: {
+          learningTimeZone: true
+        }
+      });
+      return user?.learningTimeZone ?? PLATFORM_TIMEZONE;
+    }
     async getStudentMastery(timebackId, user, options) {
       return this.withClientTelemetry(async () => {
         const client = this.requireClient();
@@ -82355,13 +82400,28 @@ var init_session_service = __esm(() => {
   init_errors();
 });
 
+// ../api-core/src/utils/timezone.util.ts
+function normalizeIanaTimeZone(value) {
+  const timeZone = value?.trim();
+  if (!timeZone || timeZone.length > MAX_IANA_TIME_ZONE_LENGTH) {
+    return;
+  }
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone }).format(new Date);
+    return timeZone;
+  } catch {
+    return;
+  }
+}
+var MAX_IANA_TIME_ZONE_LENGTH = 100;
+
 // ../api-core/src/services/user.service.ts
 class UserService {
   deps;
   constructor(deps) {
     this.deps = deps;
   }
-  async getMe(user, gameId) {
+  async getMe(user, gameId, observedTimeZone) {
     const db2 = this.deps.db;
     const userData = await db2.query.users.findFirst({
       where: eq(users.id, user.id)
@@ -82374,6 +82434,7 @@ class UserService {
       "app.user.has_timeback_account": Boolean(userData.timebackId),
       "app.user.timeback_enriched": false
     });
+    const localDay = await this.resolveLocalDay(userData, observedTimeZone);
     const timeback2 = userData.timebackId ? await this.fetchTimebackData(userData.timebackId, gameId) : undefined;
     setAttribute("app.user.timeback_enriched", Boolean(timeback2));
     if (gameId) {
@@ -82383,6 +82444,7 @@ class UserService {
         role: userData.role,
         username: userData.username,
         email: userData.email,
+        localDay,
         timeback: timeback2
       };
     }
@@ -82402,6 +82464,7 @@ class UserService {
       createdAt: userData.createdAt,
       updatedAt: userData.updatedAt,
       hasTimebackAccount: Boolean(timebackAccount),
+      localDay,
       timeback: timeback2
     };
   }
@@ -82439,6 +82502,44 @@ class UserService {
       isDefault: updatedUser.name === DEMO_DISPLAY_NAME_PLACEHOLDER
     };
   }
+  async resolveLocalDay(userData, observedTimeZone) {
+    const normalizedTimeZone = normalizeIanaTimeZone(observedTimeZone);
+    if (normalizedTimeZone) {
+      const observedAt = new Date;
+      const shouldPersist = userData.learningTimeZone !== normalizedTimeZone || !userData.learningTimeZoneUpdatedAt || observedAt.getTime() - userData.learningTimeZoneUpdatedAt.getTime() >= LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS;
+      if (shouldPersist) {
+        await this.deps.db.update(users).set({
+          learningTimeZone: normalizedTimeZone,
+          learningTimeZoneUpdatedAt: observedAt
+        }).where(eq(users.id, userData.id));
+      }
+      setAttributes({
+        "app.user.learning_time_zone_observed": true,
+        "app.user.learning_time_zone_persisted": shouldPersist
+      });
+      return {
+        timeZone: normalizedTimeZone,
+        source: "browser_last_seen",
+        observedAt: (shouldPersist ? observedAt : userData.learningTimeZoneUpdatedAt)?.toISOString() ?? null
+      };
+    }
+    setAttributes({
+      "app.user.learning_time_zone_observed": false,
+      "app.user.learning_time_zone_persisted": false
+    });
+    if (userData.learningTimeZone) {
+      return {
+        timeZone: userData.learningTimeZone,
+        source: "browser_last_seen",
+        observedAt: userData.learningTimeZoneUpdatedAt?.toISOString() ?? null
+      };
+    }
+    return {
+      timeZone: PLATFORM_TIMEZONE,
+      source: "platform_default",
+      observedAt: null
+    };
+  }
   async fetchTimebackData(timebackId, gameId) {
     const [{ role, organizations: allOrganizations }, allEnrollments] = await Promise.all([
       withSpan("timeback.fetch_profile", () => this.fetchStudentProfile(timebackId)),
@@ -82520,6 +82621,7 @@ class UserService {
     return organizations.filter((o) => enrollmentOrgIds.has(o.id));
   }
 }
+var LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS;
 var init_user_service = __esm(() => {
   init_drizzle_orm();
   init_src();
@@ -82528,6 +82630,7 @@ var init_user_service = __esm(() => {
   init_spans();
   init_errors();
   init_timeback_util();
+  LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS = 24 * 60 * 60 * 1000;
 });
 
 // ../api-core/src/services/verify.service.ts
@@ -140158,9 +140261,10 @@ var init_upload_controller = __esm(() => {
 // ../api-core/src/controllers/user.controller.ts
 var getMe, getDemoProfile, updateDemoProfile, users2;
 var init_user_controller = __esm(() => {
+  init_src();
   init_schemas_index();
   init_utils11();
-  getMe = requireNonAnonymous(async (ctx) => ctx.services.user.getMe(ctx.user, ctx.gameId));
+  getMe = requireNonAnonymous(async (ctx) => ctx.services.user.getMe(ctx.user, ctx.gameId, ctx.request.headers.get(PLAYCADEMY_BROWSER_TIME_ZONE_HEADER)));
   getDemoProfile = requireAnonymous(async (ctx) => ctx.services.user.getDemoProfile(ctx.user.id));
   updateDemoProfile = requireAnonymous(async (ctx) => {
     const body2 = await parseRequestBody(ctx.request, DemoProfileSchema);
@@ -140315,8 +140419,39 @@ function getMockHighestGradeMastered(enrollments, subject) {
   const subjectGrades = enrollments.filter((enrollment) => enrollment.subject === subject).map((enrollment) => enrollment.grade);
   return subjectGrades.length > 0 ? Math.max(...subjectGrades) : null;
 }
-async function buildMockUserResponse(db2, user, gameId) {
+async function buildLocalDayContext(db2, user, observedTimeZone) {
+  const normalizedTimeZone = normalizeIanaTimeZone(observedTimeZone);
+  if (normalizedTimeZone) {
+    const observedAt = new Date;
+    const shouldPersist = user.learningTimeZone !== normalizedTimeZone || !user.learningTimeZoneUpdatedAt || observedAt.getTime() - user.learningTimeZoneUpdatedAt.getTime() >= LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS2;
+    if (shouldPersist) {
+      await db2.update(users).set({
+        learningTimeZone: normalizedTimeZone,
+        learningTimeZoneUpdatedAt: observedAt
+      }).where(eq(users.id, user.id));
+    }
+    return {
+      timeZone: normalizedTimeZone,
+      source: "browser_last_seen",
+      observedAt: (shouldPersist ? observedAt : user.learningTimeZoneUpdatedAt)?.toISOString() ?? null
+    };
+  }
+  if (user.learningTimeZone) {
+    return {
+      timeZone: user.learningTimeZone,
+      source: "browser_last_seen",
+      observedAt: user.learningTimeZoneUpdatedAt?.toISOString() ?? null
+    };
+  }
+  return {
+    timeZone: PLATFORM_TIMEZONE,
+    source: "platform_default",
+    observedAt: null
+  };
+}
+async function buildMockUserResponse(db2, user, gameId, observedTimeZone) {
   const timeback3 = user.timebackId ? await getMockTimebackData(db2, user.timebackId, gameId) : undefined;
+  const localDay = await buildLocalDayContext(db2, user, observedTimeZone);
   if (gameId) {
     return {
       id: user.id,
@@ -140324,6 +140459,7 @@ async function buildMockUserResponse(db2, user, gameId) {
       role: user.role,
       username: user.username,
       email: user.email,
+      localDay,
       timeback: timeback3
     };
   }
@@ -140342,15 +140478,19 @@ async function buildMockUserResponse(db2, user, gameId) {
     createdAt: user.createdAt,
     updatedAt: user.updatedAt,
     hasTimebackAccount: Boolean(timebackAccount),
+    localDay,
     timeback: timeback3
   };
 }
+var LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS2;
 var init_timeback6 = __esm(() => {
   init_drizzle_orm();
   init_utils11();
+  init_src();
   init_tables_index();
   init_src2();
   init_config();
+  LEARNING_TIME_ZONE_REFRESH_INTERVAL_MS2 = 24 * 60 * 60 * 1000;
 });
 
 // src/routes/platform/users.ts
@@ -140360,6 +140500,7 @@ var init_users = __esm(async () => {
   init_dist7();
   init_controllers();
   init_errors();
+  init_src();
   init_tables_index();
   init_error_handler();
   init_timeback6();
@@ -140381,7 +140522,7 @@ var init_users = __esm(async () => {
         const error89 = ApiError.notFound("User not found");
         return c2.json(createErrorResponse(error89), error89.status);
       }
-      const response = await buildMockUserResponse(db2, userData, gameId);
+      const response = await buildMockUserResponse(db2, userData, gameId, c2.req.header(PLAYCADEMY_BROWSER_TIME_ZONE_HEADER));
       return c2.json(response);
     }
     return handle2(users2.getMe)(c2);

package/package.json

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