@playcademy/sandbox 0.7.1-beta.13 → 0.7.1-beta.15

package/dist/server.js

@@ -1122,7 +1122,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.7.1-beta.13",
+    version: "0.7.1-beta.15",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -9491,9 +9491,18 @@ function assessmentReviewBankShortage(fulfillment) {
 function assessmentFlowForPurpose(purpose) {
   return purpose === "review" || purpose === "mastery" ? "item-submit" : "attempt-submit";
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
 function isTimebackGrade(value) {
   return typeof value === "number" && Number.isInteger(value) && GRADE_VALUES.includes(value);
 }
+function isAssessmentSessionTiming(value) {
+  return isObject(value) && typeof value.runId === "string" && isValidUUID(value.runId) && typeof value.resumeId === "string" && isValidUUID(value.resumeId) && isNonNegativeDuration(value.activeSeconds) && (value.inactiveSeconds === undefined || isNonNegativeDuration(value.inactiveSeconds));
+}
+function isNonNegativeDuration(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
 function isAssessmentPurpose(value) {
   return ASSESSMENT_PURPOSES.includes(value);
 }
@@ -10337,7 +10346,7 @@ function isPlaycademyAssessmentResultMetadataV1(value) {
   const selectedTest = metadata2.selectedTest;
   const mastery = metadata2.mastery;
   const review = metadata2.review;
-  return metadata2.version === 1 && typeof metadata2.activityId === "string" && isAssessmentPurpose(metadata2.purpose) && typeof metadata2.courseId === "string" && typeof metadata2.integrationId === "string" && typeof metadata2.enrollmentId === "string" && Boolean(selectedTest) && typeof selectedTest?.identifier === "string" && typeof selectedTest.contentRevision === "string" && Number.isInteger(metadata2.attemptNumber) && Number.isInteger(metadata2.responseVersion) && Boolean(metadata2.responses) && typeof metadata2.responses === "object" && Array.isArray(metadata2.itemSubmissions) && metadata2.itemSubmissions.every(isAssessmentItemSubmission) && typeof metadata2.startedAt === "string" && typeof metadata2.updatedAt === "string" && (metadata2.purpose === "mastery" ? isMasteryAttemptMetadata(mastery) : mastery === undefined) && (metadata2.purpose === "review" ? isReviewAttemptMetadata(review) : review === undefined) && (metadata2.submissionId === undefined || typeof metadata2.submissionId === "string") && (metadata2.score === undefined || isAssessmentScore(metadata2.score)) && (metadata2.completion === undefined || isRecord(metadata2.completion) && typeof metadata2.completion.testName === "string" && Number.isInteger(metadata2.completion.correctQuestions) && (metadata2.completion.totalQuestions === undefined || Number.isInteger(metadata2.completion.totalQuestions) && metadata2.completion.totalQuestions >= 0) && (metadata2.completion.itemOutcomes === undefined || metadata2.purpose === "review" && Array.isArray(metadata2.completion.itemOutcomes) && metadata2.completion.itemOutcomes.every(isReviewItemOutcome)));
+  return metadata2.version === 1 && typeof metadata2.activityId === "string" && isAssessmentPurpose(metadata2.purpose) && typeof metadata2.courseId === "string" && typeof metadata2.integrationId === "string" && typeof metadata2.enrollmentId === "string" && Boolean(selectedTest) && typeof selectedTest?.identifier === "string" && typeof selectedTest.contentRevision === "string" && Number.isInteger(metadata2.attemptNumber) && Number.isInteger(metadata2.responseVersion) && Boolean(metadata2.responses) && typeof metadata2.responses === "object" && Array.isArray(metadata2.itemSubmissions) && metadata2.itemSubmissions.every(isAssessmentItemSubmission) && typeof metadata2.startedAt === "string" && typeof metadata2.updatedAt === "string" && (metadata2.purpose === "mastery" ? isMasteryAttemptMetadata(mastery) : mastery === undefined) && (metadata2.purpose === "review" ? isReviewAttemptMetadata(review) : review === undefined) && (metadata2.submissionId === undefined || typeof metadata2.submissionId === "string") && (metadata2.score === undefined || isAssessmentScore(metadata2.score)) && (metadata2.completion === undefined || isRecord(metadata2.completion) && typeof metadata2.completion.testName === "string" && Number.isInteger(metadata2.completion.correctQuestions) && (metadata2.completion.session === undefined || isAssessmentSessionTiming(metadata2.completion.session)) && (metadata2.completion.totalQuestions === undefined || Number.isInteger(metadata2.completion.totalQuestions) && metadata2.completion.totalQuestions >= 0) && (metadata2.completion.itemOutcomes === undefined || metadata2.purpose === "review" && Array.isArray(metadata2.completion.itemOutcomes) && metadata2.completion.itemOutcomes.every(isReviewItemOutcome)));
 }
 function isPlaycademyAssessmentItemResultMetadataV1(value) {
   if (!isRecord(value) || !isRecord(value.responses)) {
@@ -10394,6 +10403,7 @@ var init_assessment_runtime = __esm(() => {
   init_src();
   init_timeback3();
   init_src();
+  init_uuid();
   init_src();
   init_uuid();
   init_src();
@@ -10652,7 +10662,10 @@ var init_assessment_runtime = __esm(() => {
   });
   SubmitAssessmentBodySchema = exports_external.object({
     expectedResponseVersion: exports_external.number().int().nonnegative(),
-    submissionId: exports_external.string().trim().min(1)
+    submissionId: exports_external.string().trim().min(1),
+    session: exports_external.custom(isAssessmentSessionTiming, {
+      message: "Session timing needs a UUID runId and resumeId with non-negative active and inactive seconds"
+    }).optional()
   });
   StartRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.and(StartAssessmentBodySchema);
   SaveRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.extend(SaveAssessmentBodySchema.shape);
@@ -19108,10 +19121,10 @@ var require_util = __commonJS((exports) => {
     return objectToString(re) === "[object RegExp]";
   }
   exports.isRegExp = isRegExp;
-  function isObject(arg) {
+  function isObject2(arg) {
     return typeof arg === "object" && arg !== null;
   }
-  exports.isObject = isObject;
+  exports.isObject = isObject2;
   function isDate(d) {
     return objectToString(d) === "[object Date]";
   }
@@ -35461,23 +35474,23 @@ var init_game_member_service = __esm(() => {
 });
 
 // ../timeback/dist/types.js
-function isObject(value) {
+function isObject2(value) {
   return typeof value === "object" && value !== null;
 }
 function isCourseMetadata(value) {
-  return isObject(value);
+  return isObject2(value);
 }
 function isResourceMetadata(value) {
-  return isObject(value);
+  return isObject2(value);
 }
 function isPlaycademyResourceMetadata(value) {
-  if (!isObject(value)) {
+  if (!isObject2(value)) {
     return false;
   }
   if (!("mastery" in value) || value.mastery === undefined) {
     return true;
   }
-  return isObject(value.mastery);
+  return isObject2(value.mastery);
 }
 function isTimebackSubject(value) {
   return typeof value === "string" && SUBJECT_VALUES.includes(value);
@@ -35488,6 +35501,7 @@ function isTimebackGrade2(value) {
 var SUBJECT_VALUES, GRADE_VALUES2;
 var init_types2 = __esm(() => {
   init_src();
+  init_uuid();
   SUBJECT_VALUES = TIMEBACK_SUBJECTS;
   GRADE_VALUES2 = TIMEBACK_GRADES;
 });
@@ -39899,7 +39913,7 @@ __export(exports_chunk_wex8rmr0, {
   isString: () => isString,
   isRegExp: () => isRegExp,
   isPrimitive: () => isPrimitive,
-  isObject: () => isObject2,
+  isObject: () => isObject3,
   isNumber: () => isNumber,
   isNullOrUndefined: () => isNullOrUndefined,
   isNull: () => isNull2,
@@ -39949,7 +39963,7 @@ function format(f, ...args2) {
     }
   });
   for (var x = args2[i2];i2 < len; x = args2[++i2])
-    if (isNull2(x) || !isObject2(x))
+    if (isNull2(x) || !isObject3(x))
       str += " " + x;
     else
       str += " " + inspect(x);
@@ -40157,16 +40171,16 @@ function isUndefined(arg) {
   return arg === undefined;
 }
 function isRegExp(re) {
-  return isObject2(re) && objectToString(re) === "[object RegExp]";
+  return isObject3(re) && objectToString(re) === "[object RegExp]";
 }
-function isObject2(arg) {
+function isObject3(arg) {
   return typeof arg === "object" && arg !== null;
 }
 function isDate(d) {
-  return isObject2(d) && objectToString(d) === "[object Date]";
+  return isObject3(d) && objectToString(d) === "[object Date]";
 }
 function isError(e) {
-  return isObject2(e) && (objectToString(e) === "[object Error]" || e instanceof Error);
+  return isObject3(e) && (objectToString(e) === "[object Error]" || e instanceof Error);
 }
 function isFunction(arg) {
   return typeof arg === "function";
@@ -40195,7 +40209,7 @@ function inherits(ctor, superCtor) {
     ctor.super_ = superCtor, ctor.prototype = Object.create(superCtor.prototype, { constructor: { value: ctor, enumerable: false, writable: true, configurable: true } });
 }
 function _extend(origin, add) {
-  if (!add || !isObject2(add))
+  if (!add || !isObject3(add))
     return origin;
   var keys = Object.keys(add), i2 = keys.length;
   while (i2--)
@@ -42012,7 +42026,7 @@ __export(exports_util, {
   joinValues: () => joinValues,
   issue: () => issue2,
   isPlainObject: () => isPlainObject,
-  isObject: () => isObject3,
+  isObject: () => isObject4,
   getSizableOrigin: () => getSizableOrigin,
   getParsedType: () => getParsedType2,
   getLengthableOrigin: () => getLengthableOrigin,
@@ -42148,17 +42162,17 @@ function randomString(length = 10) {
 function esc(str) {
   return JSON.stringify(str);
 }
-function isObject3(data) {
+function isObject4(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
 function isPlainObject(o) {
-  if (isObject3(o) === false)
+  if (isObject4(o) === false)
     return false;
   const ctor = o.constructor;
   if (ctor === undefined)
     return true;
   const prot = ctor.prototype;
-  if (isObject3(prot) === false)
+  if (isObject4(prot) === false)
     return false;
   if (Object.prototype.hasOwnProperty.call(prot, "isPrototypeOf") === false) {
     return false;
@@ -44265,7 +44279,7 @@ var init_schemas5 = __esm(() => {
       return (payload, ctx) => fn(shape, payload, ctx);
     };
     let fastpass;
-    const isObject4 = isObject3;
+    const isObject5 = isObject4;
     const jit = !globalConfig.jitless;
     const allowsEval2 = allowsEval;
     const fastEnabled = jit && allowsEval2.value;
@@ -44274,7 +44288,7 @@ var init_schemas5 = __esm(() => {
     inst._zod.parse = (payload, ctx) => {
       value ?? (value = _normalized.value);
       const input = payload.value;
-      if (!isObject4(input)) {
+      if (!isObject5(input)) {
         payload.issues.push({
           expected: "object",
           code: "invalid_type",
@@ -44418,7 +44432,7 @@ var init_schemas5 = __esm(() => {
     });
     inst._zod.parse = (payload, ctx) => {
       const input = payload.value;
-      if (!isObject3(input)) {
+      if (!isObject4(input)) {
         payload.issues.push({
           code: "invalid_type",
           expected: "object",
@@ -59379,7 +59393,7 @@ __export(exports_chunk_dd0pbbq3, {
   isString: () => isString2,
   isRegExp: () => isRegExp2,
   isPrimitive: () => isPrimitive2,
-  isObject: () => isObject4,
+  isObject: () => isObject5,
   isNumber: () => isNumber2,
   isNullOrUndefined: () => isNullOrUndefined2,
   isNull: () => isNull3,
@@ -59429,7 +59443,7 @@ function format2(f, ...args2) {
     }
   });
   for (var x = args2[i2];i2 < len; x = args2[++i2])
-    if (isNull3(x) || !isObject4(x))
+    if (isNull3(x) || !isObject5(x))
       str += " " + x;
     else
       str += " " + inspect2(x);
@@ -59637,16 +59651,16 @@ function isUndefined2(arg) {
   return arg === undefined;
 }
 function isRegExp2(re) {
-  return isObject4(re) && objectToString2(re) === "[object RegExp]";
+  return isObject5(re) && objectToString2(re) === "[object RegExp]";
 }
-function isObject4(arg) {
+function isObject5(arg) {
   return typeof arg === "object" && arg !== null;
 }
 function isDate2(d) {
-  return isObject4(d) && objectToString2(d) === "[object Date]";
+  return isObject5(d) && objectToString2(d) === "[object Date]";
 }
 function isError2(e) {
-  return isObject4(e) && (objectToString2(e) === "[object Error]" || e instanceof Error);
+  return isObject5(e) && (objectToString2(e) === "[object Error]" || e instanceof Error);
 }
 function isFunction2(arg) {
   return typeof arg === "function";
@@ -59675,7 +59689,7 @@ function inherits2(ctor, superCtor) {
     ctor.super_ = superCtor, ctor.prototype = Object.create(superCtor.prototype, { constructor: { value: ctor, enumerable: false, writable: true, configurable: true } });
 }
 function _extend2(origin, add) {
-  if (!add || !isObject4(add))
+  if (!add || !isObject5(add))
     return origin;
   var keys = Object.keys(add), i2 = keys.length;
   while (i2--)
@@ -61457,7 +61471,7 @@ __export(exports_util2, {
   joinValues: () => joinValues2,
   issue: () => issue4,
   isPlainObject: () => isPlainObject2,
-  isObject: () => isObject5,
+  isObject: () => isObject6,
   hexToUint8Array: () => hexToUint8Array,
   getSizableOrigin: () => getSizableOrigin2,
   getParsedType: () => getParsedType3,
@@ -61618,11 +61632,11 @@ function esc2(str) {
 function slugify(input) {
   return input.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
 }
-function isObject5(data) {
+function isObject6(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
 function isPlainObject2(o) {
-  if (isObject5(o) === false)
+  if (isObject6(o) === false)
     return false;
   const ctor = o.constructor;
   if (ctor === undefined)
@@ -61630,7 +61644,7 @@ function isPlainObject2(o) {
   if (typeof ctor !== "function")
     return true;
   const prot = ctor.prototype;
-  if (isObject5(prot) === false)
+  if (isObject6(prot) === false)
     return false;
   if (Object.prototype.hasOwnProperty.call(prot, "isPrototypeOf") === false) {
     return false;
@@ -64148,13 +64162,13 @@ var init_schemas7 = __esm(() => {
       }
       return propValues;
     });
-    const isObject6 = isObject5;
+    const isObject7 = isObject6;
     const catchall = def.catchall;
     let value;
     inst._zod.parse = (payload, ctx) => {
       value ?? (value = _normalized.value);
       const input = payload.value;
-      if (!isObject6(input)) {
+      if (!isObject7(input)) {
         payload.issues.push({
           expected: "object",
           code: "invalid_type",
@@ -64281,7 +64295,7 @@ var init_schemas7 = __esm(() => {
       return (payload, ctx) => fn(shape, payload, ctx);
     };
     let fastpass;
-    const isObject6 = isObject5;
+    const isObject7 = isObject6;
     const jit = !globalConfig2.jitless;
     const allowsEval3 = allowsEval2;
     const fastEnabled = jit && allowsEval3.value;
@@ -64290,7 +64304,7 @@ var init_schemas7 = __esm(() => {
     inst._zod.parse = (payload, ctx) => {
       value ?? (value = _normalized.value);
       const input = payload.value;
-      if (!isObject6(input)) {
+      if (!isObject7(input)) {
         payload.issues.push({
           expected: "object",
           code: "invalid_type",
@@ -64422,7 +64436,7 @@ var init_schemas7 = __esm(() => {
     });
     inst._zod.parse = (payload, ctx) => {
       const input = payload.value;
-      if (!isObject5(input)) {
+      if (!isObject6(input)) {
         payload.issues.push({
           code: "invalid_type",
           expected: "object",
@@ -78476,7 +78490,7 @@ __export(exports_chunk_dd0pbbq32, {
   isString: () => isString3,
   isRegExp: () => isRegExp3,
   isPrimitive: () => isPrimitive3,
-  isObject: () => isObject6,
+  isObject: () => isObject7,
   isNumber: () => isNumber3,
   isNullOrUndefined: () => isNullOrUndefined3,
   isNull: () => isNull4,
@@ -78526,7 +78540,7 @@ function format3(f, ...args2) {
     }
   });
   for (var x = args2[i2];i2 < len; x = args2[++i2])
-    if (isNull4(x) || !isObject6(x))
+    if (isNull4(x) || !isObject7(x))
       str += " " + x;
     else
       str += " " + inspect3(x);
@@ -78734,16 +78748,16 @@ function isUndefined3(arg) {
   return arg === undefined;
 }
 function isRegExp3(re) {
-  return isObject6(re) && objectToString3(re) === "[object RegExp]";
+  return isObject7(re) && objectToString3(re) === "[object RegExp]";
 }
-function isObject6(arg) {
+function isObject7(arg) {
   return typeof arg === "object" && arg !== null;
 }
 function isDate3(d) {
-  return isObject6(d) && objectToString3(d) === "[object Date]";
+  return isObject7(d) && objectToString3(d) === "[object Date]";
 }
 function isError3(e) {
-  return isObject6(e) && (objectToString3(e) === "[object Error]" || e instanceof Error);
+  return isObject7(e) && (objectToString3(e) === "[object Error]" || e instanceof Error);
 }
 function isFunction3(arg) {
   return typeof arg === "function";
@@ -78772,7 +78786,7 @@ function inherits3(ctor, superCtor) {
     ctor.super_ = superCtor, ctor.prototype = Object.create(superCtor.prototype, { constructor: { value: ctor, enumerable: false, writable: true, configurable: true } });
 }
 function _extend3(origin, add) {
-  if (!add || !isObject6(add))
+  if (!add || !isObject7(add))
     return origin;
   var keys = Object.keys(add), i2 = keys.length;
   while (i2--)
@@ -83278,7 +83292,8 @@ function buildAssessmentCompletionMetadata(input) {
       attemptId: input.attemptId,
       submissionId: input.submissionId,
       testIdentifier: input.testIdentifier,
-      assessmentPurpose: input.purpose
+      assessmentPurpose: input.purpose,
+      ...input.resumeId ? { resumeId: input.resumeId } : {}
     }
   };
 }
@@ -83300,11 +83315,13 @@ function buildAssessmentCompletionEvent(input) {
     appName: input.appName,
     sensorUrl: input.sensorUrl,
     eventId: input.eventId,
+    runId: input.attemptId,
     generatedExtensions: metadata2,
     eventExtensions: {
       playcademy: {
         assessmentPurpose: input.purpose,
-        attemptId: input.attemptId
+        attemptId: input.attemptId,
+        ...input.resumeId ? { resumeId: input.resumeId } : {}
       }
     }
   };
@@ -83922,17 +83939,17 @@ function createActivityNamespace(core3, deps) {
     completeAssessment: (data) => deps.events.emitActivityEvent(buildAssessmentCompletionEvent(data))
   };
 }
-function isObject7(value) {
+function isObject8(value) {
   return typeof value === "object" && value !== null;
 }
 function isPlaycademyResourceMetadata2(value) {
-  if (!isObject7(value)) {
+  if (!isObject8(value)) {
     return false;
   }
   if (!("mastery" in value) || value.mastery === undefined) {
     return true;
   }
-  return isObject7(value.mastery);
+  return isObject8(value.mastery);
 }
 function isTimebackSubject3(value) {
   return typeof value === "string" && SUBJECT_VALUES2.includes(value);
@@ -85205,6 +85222,7 @@ var init_dist5 = __esm(async () => {
   init_src();
   init_spans();
   init_src();
+  init_uuid();
   init_src();
   init_spans();
   init_src9();
@@ -85420,6 +85438,7 @@ function deriveSourcedIds2(courseId) {
 }
 var init_utils6 = __esm(() => {
   init_src();
+  init_uuid();
 });
 
 // ../api-core/src/utils/timeback-admin-metrics.util.ts
@@ -91389,6 +91408,7 @@ function buildAssessmentResultFinalization(input) {
       testName: input.testName,
       totalQuestions: input.totalQuestions,
       correctQuestions: input.correctQuestions,
+      ...input.session ? { session: input.session } : {},
       ...input.itemOutcomes ? { itemOutcomes: input.itemOutcomes } : {}
     },
     updatedAt: input.timestamp
@@ -91497,7 +91517,7 @@ class TimebackAssessmentRuntimeService {
       const compatibleAttempts = this.attemptsMatchingRequest(attempts, requestFingerprint);
       let decision = this.requireDecision(selectRuntimeAssessment(tests, [...compatibleAttempts.values()].map((entry) => entry.selection)), input.purpose);
       if (decision.kind === "resume") {
-        return this.resumeSnapshot(decision, attempts);
+        return this.resumeSnapshot(decision, attempts, context2.integration);
       }
       let assessment = await this.loadAssessment(decision.test.qtiTestIdentifier);
       const refreshedListing = await this.listAttempts(attemptScope);
@@ -91505,7 +91525,7 @@ class TimebackAssessmentRuntimeService {
       const refreshedCompatible = this.attemptsMatchingRequest(refreshed, requestFingerprint);
       const refreshedDecision = this.requireDecision(selectRuntimeAssessment(tests, [...refreshedCompatible.values()].map((entry) => entry.selection)), input.purpose);
       if (refreshedDecision.kind === "resume") {
-        return this.resumeSnapshot(refreshedDecision, refreshed);
+        return this.resumeSnapshot(refreshedDecision, refreshed, context2.integration);
       }
       decision = refreshedDecision;
       if (assessment.identifier !== decision.test.qtiTestIdentifier) {
@@ -91565,7 +91585,7 @@ class TimebackAssessmentRuntimeService {
           grade: context2.integration.grade
         })
       });
-      return this.snapshot(result, metadata2, assessment);
+      return this.snapshot(result, metadata2, assessment, context2.integration);
     });
   }
   async startReview({
@@ -91700,12 +91720,12 @@ class TimebackAssessmentRuntimeService {
         existingChildResults: refreshedListing.reviewChildren,
         lookupMissingResults: false
       });
-      return this.snapshot(result, metadata2, assessment);
+      return this.snapshot(result, metadata2, assessment, context2.integration);
     });
   }
   async get(params) {
     const attempt = await this.authorizeAttemptRead(params);
-    return this.snapshotForResult(attempt.result, attempt.metadata);
+    return this.snapshotForResult(attempt.result, attempt.metadata, attempt.integration);
   }
   async latest({
     gameId,
@@ -92054,6 +92074,9 @@ class TimebackAssessmentRuntimeService {
       if (submissionDisposition === "reject") {
         throw AssessmentRuntimeError.from(assessmentAlreadySubmitted(attempt.result.sourcedId));
       }
+      if (input.session && input.session.runId !== attempt.result.sourcedId) {
+        throw new ValidationError("Assessment session runId must match the attemptId.");
+      }
       this.assertResponseVersion(attempt.metadata, input.expectedResponseVersion);
       if (assessmentFlowForPurpose(attempt.metadata.purpose) === "item-submit") {
         const assessment2 = await this.loadAttemptAssessment(attempt.metadata);
@@ -92082,6 +92105,7 @@ class TimebackAssessmentRuntimeService {
         testName: assessment.title,
         totalQuestions: assessment.items.length,
         correctQuestions,
+        ...input.session ? { session: input.session } : {},
         ...reviewOutcomes ? { itemOutcomes: reviewOutcomes } : {}
       });
       const metadata2 = finalization.metadata;
@@ -92120,7 +92144,10 @@ class TimebackAssessmentRuntimeService {
       };
     });
     if (submission.completion) {
-      await this.emitCompletionBestEffort(submission.completion);
+      await Promise.allSettled([
+        this.emitCompletionBestEffort(submission.completion),
+        this.emitSessionBestEffort(submission.completion)
+      ]);
     }
     return submission.response;
   }
@@ -92375,7 +92402,7 @@ class TimebackAssessmentRuntimeService {
     }
     return decision;
   }
-  resumeSnapshot(decision, attempts) {
+  resumeSnapshot(decision, attempts, integration) {
     if (decision.additionalResumableAttemptIds.length > 0) {
       addEvent("assessment.multiple_resumable_attempts", {
         "app.assessment.attempt_id": decision.attempt.attemptId,
@@ -92383,7 +92410,7 @@ class TimebackAssessmentRuntimeService {
       });
     }
     const resumed = attempts.get(decision.attempt.attemptId);
-    return this.snapshotForResult(resumed.result, resumed.metadata);
+    return this.snapshotForResult(resumed.result, resumed.metadata, integration);
   }
   async resumeReviewSnapshot(decision, attempts, existingChildResults, context2) {
     if (decision.additionalResumableAttemptIds.length > 0) {
@@ -92408,7 +92435,7 @@ class TimebackAssessmentRuntimeService {
       existingChildResults,
       lookupMissingResults: true
     });
-    return this.snapshot(resumed.result, resumed.metadata, assessment);
+    return this.snapshot(resumed.result, resumed.metadata, assessment, context2.integration);
   }
   async loadReviewBank(identifier, expectedSourceRevision) {
     if (expectedSourceRevision) {
@@ -92873,17 +92900,19 @@ class TimebackAssessmentRuntimeService {
   unauthorizedAttempt(attemptId) {
     return AssessmentRuntimeError.from(assessmentAttemptUnauthorized(attemptId));
   }
-  async snapshotForResult(result, metadata2) {
-    return this.snapshot(result, metadata2, await this.loadAttemptAssessment(metadata2));
+  async snapshotForResult(result, metadata2, integration) {
+    return this.snapshot(result, metadata2, await this.loadAttemptAssessment(metadata2), integration);
   }
-  snapshot(result, metadata2, assessment) {
+  snapshot(result, metadata2, assessment, integration) {
     const completed = this.isCompleted(result);
     const selection = this.selectionContext(metadata2);
+    const activityData = this.activityData(metadata2, assessment, integration);
     return {
       attemptId: result.sourcedId,
       responseVersion: metadata2.responseVersion,
       status: completed ? "completed" : "in_progress",
       flow: assessmentFlowForPurpose(metadata2.purpose),
+      ...activityData ? { activityData } : {},
       assessment: assessmentPresentationForAttempt(assessment, result.sourcedId),
       responses: metadata2.responses,
       itemSubmissions: metadata2.itemSubmissions,
@@ -92891,6 +92920,30 @@ class TimebackAssessmentRuntimeService {
       selection
     };
   }
+  activityData(metadata2, assessment, integration) {
+    const course = this.trackableCourse(integration, "assessment.activity_tracking_invalid_course_metadata");
+    if (!course) {
+      return;
+    }
+    return {
+      activityId: metadata2.activityId,
+      activityName: assessment.title,
+      ...course,
+      courseId: integration.courseId
+    };
+  }
+  trackableCourse(integration, event, attributes2 = {}) {
+    if (!isTimebackGrade2(integration.grade) || !isTimebackSubject(integration.subject)) {
+      addEvent(event, {
+        ...attributes2,
+        "app.timeback.integration_id": integration.id,
+        "app.timeback.grade": integration.grade,
+        "app.timeback.subject": integration.subject
+      });
+      return null;
+    }
+    return { grade: integration.grade, subject: integration.subject };
+  }
   selectionContext(metadata2) {
     if (metadata2.purpose === "review") {
       return {
@@ -93002,12 +93055,9 @@ class TimebackAssessmentRuntimeService {
   async emitCompletionBestEffort(input) {
     const { attempt } = input;
     const integration = attempt.integration;
-    if (!isTimebackGrade2(integration.grade) || !isTimebackSubject(integration.subject)) {
-      addEvent("assessment.completion_event_invalid_course_metadata", {
-        "app.assessment.attempt_id": attempt.result.sourcedId,
-        "app.timeback.grade": integration.grade,
-        "app.timeback.subject": integration.subject
-      });
+    const session2 = attempt.metadata.completion?.session;
+    const course = this.trackableCourse(integration, "assessment.completion_event_invalid_course_metadata", { "app.assessment.attempt_id": attempt.result.sourcedId });
+    if (!course) {
       return;
     }
     try {
@@ -93029,14 +93079,14 @@ class TimebackAssessmentRuntimeService {
         testName: input.testName,
         courseId: integration.courseId,
         courseName: attempt.enrollment.course.title,
-        subject: integration.subject,
-        grade: integration.grade,
+        ...course,
         appName: input.game.appName,
         sensorUrl: input.game.sensorUrl,
         attemptNumber: attempt.metadata.attemptNumber,
         totalQuestions: input.totalQuestions,
         correctQuestions: input.correctQuestions,
-        eventId
+        eventId,
+        ...session2 ? { resumeId: session2.resumeId } : {}
       };
       await this.requireClient().activity.completeAssessment(event);
     } catch (error88) {
@@ -93047,6 +93097,54 @@ class TimebackAssessmentRuntimeService {
       });
     }
   }
+  async emitSessionBestEffort(input) {
+    const { attempt } = input;
+    const session2 = attempt.metadata.completion?.session;
+    if (!session2 || session2.activeSeconds === 0 && (session2.inactiveSeconds ?? 0) === 0) {
+      return;
+    }
+    const integration = attempt.integration;
+    const course = this.trackableCourse(integration, "assessment.time_spent_event_invalid_course_metadata", { "app.assessment.attempt_id": attempt.result.sourcedId });
+    if (!course) {
+      return;
+    }
+    try {
+      const eventId = `urn:uuid:${await deterministicUUID([
+        "playcademy-assessment-time-spent-event-v1",
+        attempt.result.sourcedId,
+        input.submissionId,
+        session2.resumeId
+      ].join("\x00"))}`;
+      await this.requireClient().activity.session(integration.courseId, input.studentId, {
+        eventId,
+        gameId: input.gameId,
+        activityId: attempt.metadata.activityId,
+        activityName: input.testName,
+        courseId: integration.courseId,
+        courseName: attempt.enrollment.course.title,
+        activeTimeSeconds: session2.activeSeconds,
+        ...session2.inactiveSeconds !== undefined ? { inactiveTimeSeconds: session2.inactiveSeconds } : {},
+        subject: course.subject,
+        appName: input.game.appName,
+        sensorUrl: input.game.sensorUrl,
+        runId: session2.runId,
+        extensions: {
+          playcademy: {
+            resumeId: session2.resumeId,
+            assessmentPurpose: attempt.metadata.purpose,
+            attemptId: attempt.result.sourcedId,
+            submissionId: input.submissionId
+          }
+        }
+      });
+    } catch (error88) {
+      addEvent("assessment.time_spent_event_failed", {
+        "app.assessment.attempt_id": attempt.result.sourcedId,
+        "exception.type": errorType(error88),
+        "app.error.message": errorMessage(error88)
+      });
+    }
+  }
 }
 var init_timeback_assessment_runtime_service = __esm(async () => {
   init_drizzle_orm();
@@ -117992,7 +118090,7 @@ See: https://github.com/isaacs/node-glob/issues/167`);
           throw new TypeError(FUNC_ERROR_TEXT);
         }
         wait = toNumber2(wait) || 0;
-        if (isObject8(options)) {
+        if (isObject9(options)) {
           leading = !!options.leading;
           maxing = "maxWait" in options;
           maxWait = maxing ? nativeMax(toNumber2(options.maxWait) || 0, wait) : maxWait;
@@ -118071,7 +118169,7 @@ See: https://github.com/isaacs/node-glob/issues/167`);
         if (typeof func2 != "function") {
           throw new TypeError(FUNC_ERROR_TEXT);
         }
-        if (isObject8(options)) {
+        if (isObject9(options)) {
           leading = "leading" in options ? !!options.leading : leading;
           trailing = "trailing" in options ? !!options.trailing : trailing;
         }
@@ -118081,7 +118179,7 @@ See: https://github.com/isaacs/node-glob/issues/167`);
           trailing
         });
       }
-      function isObject8(value) {
+      function isObject9(value) {
         var type = typeof value;
         return !!value && (type == "object" || type == "function");
       }
@@ -118098,9 +118196,9 @@ See: https://github.com/isaacs/node-glob/issues/167`);
         if (isSymbol4(value)) {
           return NAN;
         }
-        if (isObject8(value)) {
+        if (isObject9(value)) {
           var other = typeof value.valueOf == "function" ? value.valueOf() : value;
-          value = isObject8(other) ? other + "" : other;
+          value = isObject9(other) ? other + "" : other;
         }
         if (typeof value != "string") {
           return value === 0 ? value : +value;
@@ -155035,7 +155133,8 @@ var init_timeback_controller = __esm(() => {
       attemptId,
       input: {
         expectedResponseVersion: body2.expectedResponseVersion,
-        submissionId: body2.submissionId
+        submissionId: body2.submissionId,
+        ...body2.session ? { session: body2.session } : {}
       },
       game: {
         appName: body2.appName,