@playcademy/sandbox 0.3.17-beta.10 → 0.3.17-beta.12

package/dist/cli.js

@@ -1311,7 +1311,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.17-beta.10",
+    version: "0.3.17-beta.12",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -31808,7 +31808,8 @@ var init_timeback_service = __esm(() => {
     }) {
       const client = this.requireClient();
       const db2 = this.deps.db;
-      const extensionsWithResumeId = TimebackService.addResumeIdToExtensions(extensions, resumeId);
+      const effectiveResumeId = resumeId ?? runId ?? crypto.randomUUID();
+      const extensionsWithResumeId = TimebackService.addResumeIdToExtensions(extensions, effectiveResumeId);
       await this.deps.validateDeveloperAccess(user, gameId);
       const integration = await db2.query.gameTimebackIntegrations.findFirst({
         where: and(eq(gameTimebackIntegrations.gameId, gameId), eq(gameTimebackIntegrations.grade, activityData.grade), eq(gameTimebackIntegrations.subject, activityData.subject))
@@ -31881,18 +31882,26 @@ var init_timeback_service = __esm(() => {
       activityData,
       timingData,
       windowStartedAtMs,
+      windowSequence,
       isFinal,
       user
     }) {
       const client = this.requireClient();
       const db2 = this.deps.db;
-      const heartbeatWindowKey = `${runId}:${windowStartedAtMs}`;
+      const hasWindowStartedAtMs = windowStartedAtMs !== undefined;
+      const hasWindowSequence = windowSequence !== undefined;
+      if (hasWindowStartedAtMs === hasWindowSequence) {
+        throw new ValidationError("Provide exactly one of windowStartedAtMs or windowSequence");
+      }
+      const heartbeatWindowKey = hasWindowStartedAtMs ? `${runId}:t:${windowStartedAtMs}` : `${runId}:s:${windowSequence}`;
+      const effectiveResumeId = resumeId ?? runId;
       if (TimebackService.isDuplicateHeartbeatWindow(heartbeatWindowKey)) {
         logger17.debug("Skipping duplicate heartbeat window", {
           gameId,
           studentId,
           runId,
           windowStartedAtMs,
+          windowSequence,
           isFinal
         });
         return { status: "ok" };
@@ -31905,6 +31914,7 @@ var init_timeback_service = __esm(() => {
           studentId,
           runId,
           windowStartedAtMs,
+          windowSequence,
           isFinal
         });
         return inFlightHeartbeat;
@@ -31931,7 +31941,7 @@ var init_timeback_service = __esm(() => {
             courseId: activityData.courseId,
             courseName: activityData.courseName,
             studentEmail: activityData.studentEmail,
-            extensions: TimebackService.addResumeIdToExtensions(undefined, resumeId),
+            extensions: TimebackService.addResumeIdToExtensions(undefined, effectiveResumeId),
             ...runId ? { runId } : {}
           });
         }
@@ -31942,6 +31952,7 @@ var init_timeback_service = __esm(() => {
           studentId,
           runId,
           windowStartedAtMs,
+          windowSequence,
           activeTimeSeconds,
           isFinal
         });
@@ -93846,7 +93857,7 @@ var init_schemas11 = __esm(() => {
     gameId: exports_external.string().uuid(),
     studentId: exports_external.string().min(1),
     runId: exports_external.string().uuid().optional(),
-    resumeId: exports_external.string().uuid(),
+    resumeId: exports_external.string().uuid().optional(),
     activityData: TimebackActivityDataSchema,
     scoreData: exports_external.object({
       correctQuestions: exports_external.number().int().min(0),
@@ -93867,14 +93878,18 @@ var init_schemas11 = __esm(() => {
     gameId: exports_external.string().uuid(),
     studentId: exports_external.string().min(1),
     runId: exports_external.string().uuid(),
-    resumeId: exports_external.string().uuid(),
+    resumeId: exports_external.string().uuid().optional(),
     activityData: TimebackActivityDataSchema,
     timingData: exports_external.object({
       activeMs: exports_external.number().nonnegative(),
       pausedMs: exports_external.number().nonnegative()
     }),
-    windowStartedAtMs: exports_external.number().int().nonnegative(),
+    windowStartedAtMs: exports_external.number().int().nonnegative().optional(),
+    windowSequence: exports_external.number().int().nonnegative().optional(),
     isFinal: exports_external.boolean().optional()
+  }).refine((value) => value.windowStartedAtMs !== undefined !== (value.windowSequence !== undefined), {
+    message: "Provide exactly one of windowStartedAtMs or windowSequence",
+    path: ["windowStartedAtMs"]
   });
   PopulateStudentRequestSchema = exports_external.object({
     firstName: exports_external.string().min(1).optional(),
@@ -96321,6 +96336,7 @@ var init_timeback_controller = __esm(() => {
       activityData,
       timingData,
       windowStartedAtMs,
+      windowSequence,
       isFinal
     } = body2;
     logger63.debug("Recording heartbeat", {
@@ -96329,6 +96345,7 @@ var init_timeback_controller = __esm(() => {
       runId,
       resumeId,
       windowStartedAtMs,
+      windowSequence,
       activeMs: timingData.activeMs,
       isFinal
     });
@@ -96340,6 +96357,7 @@ var init_timeback_controller = __esm(() => {
       activityData,
       timingData,
       windowStartedAtMs,
+      windowSequence,
       isFinal,
       user: ctx.user
     });

package/dist/server.js

@@ -1310,7 +1310,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.17-beta.10",
+    version: "0.3.17-beta.12",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -31807,7 +31807,8 @@ var init_timeback_service = __esm(() => {
     }) {
       const client = this.requireClient();
       const db2 = this.deps.db;
-      const extensionsWithResumeId = TimebackService.addResumeIdToExtensions(extensions, resumeId);
+      const effectiveResumeId = resumeId ?? runId ?? crypto.randomUUID();
+      const extensionsWithResumeId = TimebackService.addResumeIdToExtensions(extensions, effectiveResumeId);
       await this.deps.validateDeveloperAccess(user, gameId);
       const integration = await db2.query.gameTimebackIntegrations.findFirst({
         where: and(eq(gameTimebackIntegrations.gameId, gameId), eq(gameTimebackIntegrations.grade, activityData.grade), eq(gameTimebackIntegrations.subject, activityData.subject))
@@ -31880,18 +31881,26 @@ var init_timeback_service = __esm(() => {
       activityData,
       timingData,
       windowStartedAtMs,
+      windowSequence,
       isFinal,
       user
     }) {
       const client = this.requireClient();
       const db2 = this.deps.db;
-      const heartbeatWindowKey = `${runId}:${windowStartedAtMs}`;
+      const hasWindowStartedAtMs = windowStartedAtMs !== undefined;
+      const hasWindowSequence = windowSequence !== undefined;
+      if (hasWindowStartedAtMs === hasWindowSequence) {
+        throw new ValidationError("Provide exactly one of windowStartedAtMs or windowSequence");
+      }
+      const heartbeatWindowKey = hasWindowStartedAtMs ? `${runId}:t:${windowStartedAtMs}` : `${runId}:s:${windowSequence}`;
+      const effectiveResumeId = resumeId ?? runId;
       if (TimebackService.isDuplicateHeartbeatWindow(heartbeatWindowKey)) {
         logger17.debug("Skipping duplicate heartbeat window", {
           gameId,
           studentId,
           runId,
           windowStartedAtMs,
+          windowSequence,
           isFinal
         });
         return { status: "ok" };
@@ -31904,6 +31913,7 @@ var init_timeback_service = __esm(() => {
           studentId,
           runId,
           windowStartedAtMs,
+          windowSequence,
           isFinal
         });
         return inFlightHeartbeat;
@@ -31930,7 +31940,7 @@ var init_timeback_service = __esm(() => {
             courseId: activityData.courseId,
             courseName: activityData.courseName,
             studentEmail: activityData.studentEmail,
-            extensions: TimebackService.addResumeIdToExtensions(undefined, resumeId),
+            extensions: TimebackService.addResumeIdToExtensions(undefined, effectiveResumeId),
             ...runId ? { runId } : {}
           });
         }
@@ -31941,6 +31951,7 @@ var init_timeback_service = __esm(() => {
           studentId,
           runId,
           windowStartedAtMs,
+          windowSequence,
           activeTimeSeconds,
           isFinal
         });
@@ -93845,7 +93856,7 @@ var init_schemas11 = __esm(() => {
     gameId: exports_external.string().uuid(),
     studentId: exports_external.string().min(1),
     runId: exports_external.string().uuid().optional(),
-    resumeId: exports_external.string().uuid(),
+    resumeId: exports_external.string().uuid().optional(),
     activityData: TimebackActivityDataSchema,
     scoreData: exports_external.object({
       correctQuestions: exports_external.number().int().min(0),
@@ -93866,14 +93877,18 @@ var init_schemas11 = __esm(() => {
     gameId: exports_external.string().uuid(),
     studentId: exports_external.string().min(1),
     runId: exports_external.string().uuid(),
-    resumeId: exports_external.string().uuid(),
+    resumeId: exports_external.string().uuid().optional(),
     activityData: TimebackActivityDataSchema,
     timingData: exports_external.object({
       activeMs: exports_external.number().nonnegative(),
       pausedMs: exports_external.number().nonnegative()
     }),
-    windowStartedAtMs: exports_external.number().int().nonnegative(),
+    windowStartedAtMs: exports_external.number().int().nonnegative().optional(),
+    windowSequence: exports_external.number().int().nonnegative().optional(),
     isFinal: exports_external.boolean().optional()
+  }).refine((value) => value.windowStartedAtMs !== undefined !== (value.windowSequence !== undefined), {
+    message: "Provide exactly one of windowStartedAtMs or windowSequence",
+    path: ["windowStartedAtMs"]
   });
   PopulateStudentRequestSchema = exports_external.object({
     firstName: exports_external.string().min(1).optional(),
@@ -96320,6 +96335,7 @@ var init_timeback_controller = __esm(() => {
       activityData,
       timingData,
       windowStartedAtMs,
+      windowSequence,
       isFinal
     } = body2;
     logger63.debug("Recording heartbeat", {
@@ -96328,6 +96344,7 @@ var init_timeback_controller = __esm(() => {
       runId,
       resumeId,
       windowStartedAtMs,
+      windowSequence,
       activeMs: timingData.activeMs,
       isFinal
     });
@@ -96339,6 +96356,7 @@ var init_timeback_controller = __esm(() => {
       activityData,
       timingData,
       windowStartedAtMs,
+      windowSequence,
       isFinal,
       user: ctx.user
     });

package/package.json

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