@playcademy/vite-plugin 1.1.0 → 1.1.1-beta.1

package/dist/index.js

@@ -23746,7 +23746,7 @@ import path from "node:path";
 // package.json
 var package_default = {
   name: "@playcademy/vite-plugin",
-  version: "1.1.0",
+  version: "1.1.1-beta.1",
   type: "module",
   exports: {
     ".": {
@@ -25342,7 +25342,7 @@ var package_default2;
 var init_package = __esm(() => {
   package_default2 = {
     name: "@playcademy/sandbox",
-    version: "0.5.1",
+    version: "0.5.2-beta.1",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -55859,6 +55859,95 @@ class TimebackCacheManager {
     this.enrollmentCache.cleanup();
   }
 }
+function computeMasteryPct(masteredUnits, masterableUnits) {
+  if (masterableUnits <= 0) {
+    return 0;
+  }
+  return masteredUnits / masterableUnits;
+}
+function clampMasteryPct(masteryPct) {
+  return Math.min(1, Math.max(0, masteryPct));
+}
+function createMasteryWriteWarning({
+  currentMasteredUnits,
+  attemptedMasteredUnits,
+  storedMasteredUnits,
+  masterableUnits,
+  effectiveDelta
+}) {
+  let message;
+  if (attemptedMasteredUnits < 0) {
+    message = `Activity saved. Mastery was capped at the configured minimum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  } else if (storedMasteredUnits > masterableUnits) {
+    message = `Activity saved. Mastery remains above the configured maximum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  } else {
+    message = `Activity saved. Mastery was capped at the configured maximum: attempted ${attemptedMasteredUnits}/${masterableUnits}, applied ${effectiveDelta} units, stored ${storedMasteredUnits}/${masterableUnits}.`;
+  }
+  return {
+    code: MASTERY_WRITE_CAPPED_WARNING_CODE,
+    message,
+    currentMasteredUnits,
+    attemptedMasteredUnits,
+    appliedMasteredUnits: effectiveDelta,
+    storedMasteredUnits,
+    masterableUnits
+  };
+}
+function evaluateMasteryBounds({
+  currentMasteredUnits,
+  masterableUnits,
+  masteredUnits = 0,
+  masteredUnitsAbsolute
+}) {
+  const attemptedMasteredUnits = masteredUnitsAbsolute === undefined ? currentMasteredUnits + masteredUnits : masteredUnitsAbsolute;
+  const base = {
+    currentMasteredUnits,
+    attemptedMasteredUnits,
+    masterableUnits
+  };
+  if (!Number.isFinite(currentMasteredUnits) || !Number.isFinite(masterableUnits) || !Number.isFinite(masteredUnits) || masteredUnitsAbsolute !== undefined && !Number.isFinite(masteredUnitsAbsolute) || !Number.isFinite(attemptedMasteredUnits)) {
+    throw new Error("Mastery bounds evaluation requires finite numeric values.");
+  }
+  if (attemptedMasteredUnits < 0) {
+    const storedMasteredUnits2 = 0;
+    const effectiveDelta2 = storedMasteredUnits2 - currentMasteredUnits;
+    return {
+      ...base,
+      storedMasteredUnits: storedMasteredUnits2,
+      effectiveDelta: effectiveDelta2,
+      writeWarning: createMasteryWriteWarning({
+        currentMasteredUnits,
+        attemptedMasteredUnits,
+        storedMasteredUnits: storedMasteredUnits2,
+        masterableUnits,
+        effectiveDelta: effectiveDelta2
+      })
+    };
+  }
+  if (masterableUnits > 0 && attemptedMasteredUnits > masterableUnits) {
+    const storedMasteredUnits2 = currentMasteredUnits > masterableUnits ? Math.min(currentMasteredUnits, attemptedMasteredUnits) : masterableUnits;
+    const effectiveDelta2 = storedMasteredUnits2 - currentMasteredUnits;
+    return {
+      ...base,
+      storedMasteredUnits: storedMasteredUnits2,
+      effectiveDelta: effectiveDelta2,
+      writeWarning: createMasteryWriteWarning({
+        currentMasteredUnits,
+        attemptedMasteredUnits,
+        storedMasteredUnits: storedMasteredUnits2,
+        masterableUnits,
+        effectiveDelta: effectiveDelta2
+      })
+    };
+  }
+  const storedMasteredUnits = attemptedMasteredUnits;
+  const effectiveDelta = storedMasteredUnits - currentMasteredUnits;
+  return {
+    ...base,
+    storedMasteredUnits,
+    effectiveDelta
+  };
+}
 
 class MasteryTracker {
   cacheManager;
@@ -55881,7 +55970,8 @@ class MasteryTracker {
       courseId,
       resourceId,
       additionalMasteredUnits: hasAbsolute ? 0 : masteredUnits,
-      absoluteMasteredUnits: hasAbsolute ? masteredUnitsAbsolute : undefined
+      absoluteMasteredUnits: hasAbsolute ? masteredUnitsAbsolute : undefined,
+      validateBounds: true
     });
     if (!status) {
       return;
@@ -55891,13 +55981,15 @@ class MasteryTracker {
       pctCompleteApp: status.pctCompleteApp,
       masteryAchieved: !wasComplete && status.isComplete,
       masteryRevoked: wasComplete && !status.isComplete,
-      effectiveDelta: status.effectiveDelta
+      effectiveDelta: status.effectiveDelta,
+      ...status.writeWarning ? { writeWarning: status.writeWarning } : {}
     };
   }
   async getStatus(input) {
     const status = await this.calculateStatus({
       ...input,
-      additionalMasteredUnits: 0
+      additionalMasteredUnits: 0,
+      validateBounds: false
     });
     if (!status) {
       return;
@@ -55914,7 +56006,8 @@ class MasteryTracker {
     courseId,
     resourceId,
     additionalMasteredUnits,
-    absoluteMasteredUnits
+    absoluteMasteredUnits,
+    validateBounds
   }) {
     const masterableUnits = await this.resolveMasterableUnits(resourceId);
     if (!masterableUnits || masterableUnits <= 0) {
@@ -55927,24 +56020,38 @@ class MasteryTracker {
       return;
     }
     const historicalMasteredUnits = this.sumAnalyticsMetric(facts, "masteredUnits");
-    let totalMastered;
-    let effectiveDelta;
-    if (absoluteMasteredUnits !== undefined) {
-      totalMastered = Math.max(0, absoluteMasteredUnits);
-      effectiveDelta = totalMastered - historicalMasteredUnits;
-    } else {
-      effectiveDelta = additionalMasteredUnits;
-      totalMastered = Math.max(0, historicalMasteredUnits + effectiveDelta);
-    }
-    const rawPct = totalMastered / masterableUnits * 100;
-    const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
+    const bounds = validateBounds ? evaluateMasteryBounds({
+      currentMasteredUnits: historicalMasteredUnits,
+      masterableUnits,
+      masteredUnits: additionalMasteredUnits,
+      masteredUnitsAbsolute: absoluteMasteredUnits
+    }) : {
+      currentMasteredUnits: historicalMasteredUnits,
+      attemptedMasteredUnits: historicalMasteredUnits,
+      storedMasteredUnits: historicalMasteredUnits,
+      masterableUnits,
+      effectiveDelta: 0
+    };
+    if (validateBounds && bounds.writeWarning) {
+      addEvent("timeback.mastery_write_capped", {
+        "app.timeback.current_mastered_units": bounds.currentMasteredUnits,
+        "app.timeback.attempted_mastered_units": bounds.attemptedMasteredUnits,
+        "app.timeback.applied_mastered_units": bounds.effectiveDelta,
+        "app.timeback.stored_mastered_units": bounds.storedMasteredUnits,
+        "app.timeback.masterable_units": bounds.masterableUnits
+      });
+    }
+    const masteredUnits = bounds.storedMasteredUnits;
+    const masteryPct = computeMasteryPct(masteredUnits, masterableUnits);
+    const pctCompleteApp = Math.round(clampMasteryPct(masteryPct) * 100);
     return {
-      masteredUnits: totalMastered,
+      masteredUnits,
       masterableUnits,
       pctCompleteApp,
-      isComplete: totalMastered >= masterableUnits,
+      isComplete: masteredUnits >= masterableUnits,
       historicalMasteredUnits,
-      effectiveDelta
+      effectiveDelta: bounds.effectiveDelta,
+      ...bounds.writeWarning ? { writeWarning: bounds.writeWarning } : {}
     };
   }
   async createCompletionEntry(studentId, courseId, classId, appName) {
@@ -56143,8 +56250,6 @@ class ProgressRecorder {
       xpEarned = 0,
       attemptNumber
     } = progressData;
-    const actualLineItemId = await this.resolveAssessmentLineItem(activityId, activityName, progressData.classId, ids);
-    const currentAttemptNumber = await this.resolveAttemptNumber(attemptNumber, score, studentId, actualLineItemId);
     let extensions = progressData.extensions;
     const masteryProgress = await this.masteryTracker.checkProgress({
       studentId,
@@ -56158,6 +56263,7 @@ class ProgressRecorder {
     let masteryAchieved = false;
     let scoreStatus = SCORE_STATUS.fullyGraded;
     const inProgress = "false";
+    const warnings = masteryProgress?.writeWarning ? [masteryProgress.writeWarning] : undefined;
     if (masteryProgress) {
       masteryAchieved = masteryProgress.masteryAchieved;
       pctCompleteApp = masteryProgress.pctCompleteApp;
@@ -56169,6 +56275,8 @@ class ProgressRecorder {
         scoreStatus = SCORE_STATUS.fullyGraded;
       }
     }
+    const actualLineItemId = await this.resolveAssessmentLineItem(activityId, activityName, progressData.classId, ids);
+    const currentAttemptNumber = await this.resolveAttemptNumber(attemptNumber, score, studentId, actualLineItemId);
     if (score !== undefined) {
       await this.createGradebookEntry({
         lineItemId: actualLineItemId,
@@ -56227,7 +56335,8 @@ class ProgressRecorder {
       masteredUnitsApplied: effectiveMasteredUnits,
       pctCompleteApp,
       scoreStatus,
-      inProgress
+      inProgress,
+      ...warnings ? { warnings } : {}
     };
   }
   async resolveContext(courseId, studentIdentifier, progressData) {
@@ -56958,6 +57067,7 @@ var GRADE_VALUES;
 var TimebackAuthError;
 var UUID_PATTERN;
 var storage;
+var MASTERY_WRITE_CAPPED_WARNING_CODE = "MASTERY_WRITE_CAPPED";
 var EmailSchema;
 var StudentSourcedIdSchema;
 var StudentIdentifierSchema;
@@ -58627,8 +58737,8 @@ var init_schemas4 = __esm(() => {
       inactiveSeconds: exports_external.number().nonnegative().optional()
     }).optional(),
     xpEarned: exports_external.number(),
-    masteredUnits: exports_external.number().optional(),
-    masteredUnitsAbsolute: exports_external.number().int().nonnegative().optional(),
+    masteredUnits: exports_external.number().finite().optional(),
+    masteredUnitsAbsolute: exports_external.number().finite().int().optional(),
     extensions: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
   }).refine((data) => !(data.masteredUnits !== undefined && data.masteredUnitsAbsolute !== undefined), {
     message: "Cannot provide both masteredUnits and masteredUnitsAbsolute",
@@ -62736,7 +62846,8 @@ var init_timeback_service = __esm(() => {
         masteredUnits: result.masteredUnitsApplied,
         pctCompleteApp: result.pctCompleteApp,
         scoreStatus: result.scoreStatus,
-        inProgress: result.inProgress
+        inProgress: result.inProgress,
+        ...result.warnings ? { warnings: result.warnings } : {}
       };
     }
     async resolveActiveGameCourse({
@@ -125081,7 +125192,7 @@ var init_timeback7 = __esm(() => {
         const seed3 = hashCode(`${e.grade}-${e.subject}`);
         const masterableUnits = 5 + seed3 % 16;
         const masteredUnits = seed3 % (masterableUnits + 1);
-        const pctComplete = masterableUnits > 0 ? Math.round(masteredUnits / masterableUnits * 1e4) / 100 : 0;
+        const pctComplete = masterableUnits > 0 ? Math.round(masteredUnits / masterableUnits * 100) : 0;
         return {
           grade: e.grade,
           subject: e.subject,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/vite-plugin",
-    "version": "1.1.0",
+    "version": "1.1.1-beta.1",
     "type": "module",
     "exports": {
         ".": {
@@ -19,14 +19,14 @@
     "dependencies": {
         "archiver": "^7.0.1",
         "picocolors": "^1.1.1",
-        "playcademy": "0.25.0"
+        "playcademy": "0.25.1-beta.1"
     },
     "devDependencies": {
         "@electric-sql/pglite": "^0.3.16",
         "@inquirer/prompts": "^7.8.6",
         "@playcademy/constants": "0.0.1",
-        "@playcademy/sandbox": "0.5.1",
-        "@playcademy/sdk": "0.13.0",
+        "@playcademy/sandbox": "0.5.2-beta.1",
+        "@playcademy/sdk": "0.13.1-beta.1",
         "@playcademy/types": "0.0.1",
         "@playcademy/utils": "0.0.1",
         "@types/archiver": "^6.0.3",