@playcademy/sandbox 0.3.17-beta.20 → 0.3.17-beta.21

package/dist/cli.js

@@ -1330,7 +1330,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.17-beta.20",
+    version: "0.3.17-beta.21",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -36277,7 +36277,7 @@ class MasteryTracker {
   }
   async checkProgress(input) {
     const { studentId, courseId, resourceId, masteredUnits } = input;
-    if (typeof masteredUnits !== "number" || masteredUnits <= 0) {
+    if (typeof masteredUnits !== "number" || masteredUnits === 0) {
       return;
     }
     const status = await this.calculateStatus({
@@ -36289,9 +36289,11 @@ class MasteryTracker {
     if (!status) {
       return;
     }
+    const wasComplete = status.historicalMasteredUnits >= status.masterableUnits;
     return {
       pctCompleteApp: status.pctCompleteApp,
-      masteryAchieved: status.historicalMasteredUnits < status.masterableUnits && status.isComplete
+      masteryAchieved: !wasComplete && status.isComplete,
+      masteryRevoked: wasComplete && !status.isComplete
     };
   }
   async getStatus(input) {
@@ -36332,7 +36334,7 @@ class MasteryTracker {
       return;
     }
     const historicalMasteredUnits = this.sumAnalyticsMetric(facts, "masteredUnits");
-    const totalMastered = historicalMasteredUnits + additionalMasteredUnits;
+    const totalMastered = Math.max(0, historicalMasteredUnits + additionalMasteredUnits);
     const rawPct = totalMastered / masterableUnits * 100;
     const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
     return {
@@ -36382,6 +36384,45 @@ class MasteryTracker {
       });
     }
   }
+  async revokeCompletionEntry(studentId, courseId, classId, appName) {
+    const ids = deriveSourcedIds2(courseId);
+    const lineItemId = `${ids.course}-mastery-completion-assessment`;
+    const resultId = `${lineItemId}:${studentId}:completion`;
+    try {
+      await this.onerosterNamespace.assessmentLineItems.findOrCreate(lineItemId, {
+        sourcedId: lineItemId,
+        title: "Mastery Completion",
+        status: ONEROSTER_STATUS4.active,
+        ...classId ? { class: { sourcedId: classId } } : { course: { sourcedId: ids.course } },
+        ...ids.componentResource ? { componentResource: { sourcedId: ids.componentResource } } : {}
+      });
+      await this.onerosterNamespace.assessmentResults.upsert(resultId, {
+        sourcedId: resultId,
+        status: ONEROSTER_STATUS4.active,
+        assessmentLineItem: { sourcedId: lineItemId },
+        student: { sourcedId: studentId },
+        score: 0,
+        scoreDate: new Date().toISOString(),
+        scoreStatus: SCORE_STATUS4.notSubmitted,
+        inProgress: "true",
+        metadata: {
+          isMasteryCompletion: true,
+          appName
+        }
+      });
+      log.info("[MasteryTracker] Revoked mastery completion entry", {
+        studentId,
+        lineItemId,
+        resultId
+      });
+    } catch (error) {
+      log.error("[MasteryTracker] Failed to revoke mastery completion entry", {
+        studentId,
+        lineItemId,
+        error
+      });
+    }
+  }
   async resolveMasterableUnits(resourceId) {
     if (!resourceId) {
       return;
@@ -36591,6 +36632,9 @@ class ProgressRecorder {
         sensorUrl: progressData.sensorUrl
       });
     }
+    if (masteryProgress?.masteryRevoked) {
+      await this.masteryTracker.revokeCompletionEntry(studentId, courseId, progressData.classId, progressData.appName);
+    }
     await this.emitCaliperEvent({
       studentId,
       studentEmail,
@@ -94183,7 +94227,7 @@ var init_schemas11 = __esm(() => {
       inactiveSeconds: exports_external.number().nonnegative().optional()
     }).optional(),
     xpEarned: exports_external.number().optional(),
-    masteredUnits: exports_external.number().nonnegative().optional(),
+    masteredUnits: exports_external.number().optional(),
     extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
   });
   AdvanceCourseRequestSchema = exports_external.object({

package/dist/server.js

@@ -1329,7 +1329,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.17-beta.20",
+    version: "0.3.17-beta.21",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -36276,7 +36276,7 @@ class MasteryTracker {
   }
   async checkProgress(input) {
     const { studentId, courseId, resourceId, masteredUnits } = input;
-    if (typeof masteredUnits !== "number" || masteredUnits <= 0) {
+    if (typeof masteredUnits !== "number" || masteredUnits === 0) {
       return;
     }
     const status = await this.calculateStatus({
@@ -36288,9 +36288,11 @@ class MasteryTracker {
     if (!status) {
       return;
     }
+    const wasComplete = status.historicalMasteredUnits >= status.masterableUnits;
     return {
       pctCompleteApp: status.pctCompleteApp,
-      masteryAchieved: status.historicalMasteredUnits < status.masterableUnits && status.isComplete
+      masteryAchieved: !wasComplete && status.isComplete,
+      masteryRevoked: wasComplete && !status.isComplete
     };
   }
   async getStatus(input) {
@@ -36331,7 +36333,7 @@ class MasteryTracker {
       return;
     }
     const historicalMasteredUnits = this.sumAnalyticsMetric(facts, "masteredUnits");
-    const totalMastered = historicalMasteredUnits + additionalMasteredUnits;
+    const totalMastered = Math.max(0, historicalMasteredUnits + additionalMasteredUnits);
     const rawPct = totalMastered / masterableUnits * 100;
     const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
     return {
@@ -36381,6 +36383,45 @@ class MasteryTracker {
       });
     }
   }
+  async revokeCompletionEntry(studentId, courseId, classId, appName) {
+    const ids = deriveSourcedIds2(courseId);
+    const lineItemId = `${ids.course}-mastery-completion-assessment`;
+    const resultId = `${lineItemId}:${studentId}:completion`;
+    try {
+      await this.onerosterNamespace.assessmentLineItems.findOrCreate(lineItemId, {
+        sourcedId: lineItemId,
+        title: "Mastery Completion",
+        status: ONEROSTER_STATUS4.active,
+        ...classId ? { class: { sourcedId: classId } } : { course: { sourcedId: ids.course } },
+        ...ids.componentResource ? { componentResource: { sourcedId: ids.componentResource } } : {}
+      });
+      await this.onerosterNamespace.assessmentResults.upsert(resultId, {
+        sourcedId: resultId,
+        status: ONEROSTER_STATUS4.active,
+        assessmentLineItem: { sourcedId: lineItemId },
+        student: { sourcedId: studentId },
+        score: 0,
+        scoreDate: new Date().toISOString(),
+        scoreStatus: SCORE_STATUS4.notSubmitted,
+        inProgress: "true",
+        metadata: {
+          isMasteryCompletion: true,
+          appName
+        }
+      });
+      log.info("[MasteryTracker] Revoked mastery completion entry", {
+        studentId,
+        lineItemId,
+        resultId
+      });
+    } catch (error) {
+      log.error("[MasteryTracker] Failed to revoke mastery completion entry", {
+        studentId,
+        lineItemId,
+        error
+      });
+    }
+  }
   async resolveMasterableUnits(resourceId) {
     if (!resourceId) {
       return;
@@ -36590,6 +36631,9 @@ class ProgressRecorder {
         sensorUrl: progressData.sensorUrl
       });
     }
+    if (masteryProgress?.masteryRevoked) {
+      await this.masteryTracker.revokeCompletionEntry(studentId, courseId, progressData.classId, progressData.appName);
+    }
     await this.emitCaliperEvent({
       studentId,
       studentEmail,
@@ -94182,7 +94226,7 @@ var init_schemas11 = __esm(() => {
       inactiveSeconds: exports_external.number().nonnegative().optional()
     }).optional(),
     xpEarned: exports_external.number().optional(),
-    masteredUnits: exports_external.number().nonnegative().optional(),
+    masteredUnits: exports_external.number().optional(),
     extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
   });
   AdvanceCourseRequestSchema = exports_external.object({

package/package.json

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