@playcademy/vite-plugin 0.2.22-beta.3 → 0.2.22-beta.5

package/dist/index.js

@@ -25334,7 +25334,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.3.16-beta.3",
+    version: "0.3.16-beta.5",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -50501,9 +50501,37 @@ var init_developer_service = __esm(() => {
 
 class GameService {
   deps;
+  static MANIFEST_FETCH_TIMEOUT_MS = 5000;
+  static MAX_FETCH_ERROR_MESSAGE_LENGTH = 512;
   constructor(deps) {
     this.deps = deps;
   }
+  static getManifestHost(manifestUrl) {
+    try {
+      return new URL(manifestUrl).host;
+    } catch {
+      return manifestUrl;
+    }
+  }
+  static getFetchErrorMessage(error) {
+    let raw;
+    if (error instanceof Error) {
+      raw = error.message;
+    } else if (typeof error === "string") {
+      raw = error;
+    }
+    if (!raw) {
+      return;
+    }
+    const normalized = raw.replace(/\s+/g, " ").trim();
+    if (!normalized) {
+      return;
+    }
+    return normalized.slice(0, GameService.MAX_FETCH_ERROR_MESSAGE_LENGTH);
+  }
+  static isRetryableStatus(status) {
+    return status === 429 || status >= 500;
+  }
   async list(caller) {
     const db2 = this.deps.db;
     const isAdmin = caller?.role === "admin";
@@ -50565,6 +50593,109 @@ class GameService {
     this.enforceVisibility(game, caller, slug);
     return game;
   }
+  async getManifest(gameId, caller) {
+    const game = await this.getById(gameId, caller);
+    if (game.gameType !== "hosted" || !game.deploymentUrl) {
+      throw new BadRequestError("Game does not have a deployment manifest");
+    }
+    const deploymentUrl = game.deploymentUrl;
+    const manifestUrl = `${deploymentUrl.replace(/\/$/, "")}/playcademy.manifest.json`;
+    const manifestHost = GameService.getManifestHost(manifestUrl);
+    const startedAt = Date.now();
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), GameService.MANIFEST_FETCH_TIMEOUT_MS);
+    function buildDetails(fetchOutcome, manifestErrorKind, extra = {}) {
+      return {
+        manifestUrl,
+        manifestHost,
+        deploymentUrl,
+        fetchOutcome,
+        retryCount: 0,
+        durationMs: Date.now() - startedAt,
+        manifestErrorKind,
+        ...extra
+      };
+    }
+    let response;
+    try {
+      response = await fetch(manifestUrl, {
+        method: "GET",
+        headers: {
+          Accept: "application/json"
+        },
+        signal: controller.signal
+      });
+    } catch (error) {
+      clearTimeout(timeout);
+      const fetchErrorMessage = GameService.getFetchErrorMessage(error);
+      const details = buildDetails("network_error", "temporary", fetchErrorMessage ? { fetchErrorMessage } : {});
+      logger5.error("Failed to fetch game manifest", {
+        gameId,
+        manifestUrl,
+        error,
+        details
+      });
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new TimeoutError("Timed out loading game manifest", details);
+      }
+      throw new ServiceUnavailableError("Failed to load game manifest", details);
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (!response.ok) {
+      const resolvedManifestUrl = response.url || manifestUrl;
+      const resolvedManifestHost = GameService.getManifestHost(resolvedManifestUrl);
+      const manifestErrorKind = GameService.isRetryableStatus(response.status) ? "temporary" : "permanent";
+      const details = buildDetails("bad_status", manifestErrorKind, {
+        manifestUrl: resolvedManifestUrl,
+        manifestHost: resolvedManifestHost,
+        status: response.status,
+        contentType: response.headers.get("content-type") ?? undefined,
+        cfRay: response.headers.get("cf-ray") ?? undefined,
+        redirected: response.redirected,
+        ...response.redirected ? {
+          originalManifestUrl: manifestUrl,
+          originalManifestHost: manifestHost
+        } : {}
+      });
+      const message = `Failed to fetch manifest: ${response.status} ${response.statusText}`;
+      logger5.error("Game manifest returned non-ok response", {
+        gameId,
+        manifestUrl,
+        status: response.status,
+        details
+      });
+      if (manifestErrorKind === "temporary") {
+        throw new ServiceUnavailableError(message, details);
+      }
+      throw new BadRequestError(message, details);
+    }
+    try {
+      return await response.json();
+    } catch (error) {
+      const resolvedManifestUrl = response.url || manifestUrl;
+      const resolvedManifestHost = GameService.getManifestHost(resolvedManifestUrl);
+      const details = buildDetails("invalid_body", "permanent", {
+        manifestUrl: resolvedManifestUrl,
+        manifestHost: resolvedManifestHost,
+        status: response.status,
+        contentType: response.headers.get("content-type") ?? undefined,
+        cfRay: response.headers.get("cf-ray") ?? undefined,
+        redirected: response.redirected,
+        ...response.redirected ? {
+          originalManifestUrl: manifestUrl,
+          originalManifestHost: manifestHost
+        } : {}
+      });
+      logger5.error("Failed to parse game manifest", {
+        gameId,
+        manifestUrl,
+        error,
+        details
+      });
+      throw new BadRequestError("Failed to parse game manifest", details);
+    }
+  }
   enforceVisibility(game, caller, lookupIdentifier) {
     if (game.visibility !== "internal") {
       return;
@@ -54095,16 +54226,7 @@ function mapAssessmentResultToRecentActivity(assessment, relevantCourseIds, cour
     return null;
   }
   if (isMasteryCompletionEntry(assessment)) {
-    const metadata3 = isRecord2(assessment.metadata) ? assessment.metadata : undefined;
-    const isResume = Boolean(metadata3?.resumedAt);
-    return {
-      id: assessment.sourcedId || `${assessment.assessmentLineItem.sourcedId}:${assessment.scoreDate}`,
-      kind: "admin-completion",
-      occurredAt: assessment.scoreDate,
-      courseId,
-      title: isResume ? "Course resumed" : "Course marked complete",
-      reason: metadata3?.adminAction ? "Admin action" : undefined
-    };
+    return null;
   }
   const metadata2 = isRecord2(assessment.metadata) ? assessment.metadata : undefined;
   const activityName = getStringValue(metadata2?.activityName);
@@ -54137,6 +54259,7 @@ function parseCaliperEventContext(event, relevantCourseIds) {
     courseId,
     occurredAt,
     eventKind: getStringValue(playcademy?.eventKind),
+    source: getStringValue(playcademy?.source),
     reason: getStringValue(playcademy?.reason),
     titleFromEvent: getStringValue(event.object.activity?.name),
     appName: getStringValue(event.object.app?.name),
@@ -54160,30 +54283,59 @@ function mapTimeSpentRemediation(event, ctx) {
   };
 }
 function mapActivityRemediation(event, ctx) {
-  let kind;
   if (ctx.eventKind === "remediation-xp") {
-    kind = "remediation-xp";
-  } else if (ctx.eventKind === "remediation-mastery") {
-    kind = "remediation-mastery";
-  } else {
-    return null;
+    return {
+      id: event.externalId,
+      kind: "remediation-xp",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "XP Adjustment",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason,
+      xpDelta: getGeneratedMetricValue(event, "xpEarned"),
+      masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
+    };
   }
-  const titleMap = {
-    "remediation-xp": "XP Adjustment",
-    "remediation-mastery": "Mastery Adjustment"
-  };
-  return {
-    id: event.externalId,
-    kind,
-    occurredAt: ctx.occurredAt,
-    courseId: ctx.courseId,
-    title: titleMap[kind] || "Remediation Activity",
-    activityId: ctx.activityId,
-    appName: ctx.appName,
-    reason: ctx.reason,
-    xpDelta: getGeneratedMetricValue(event, "xpEarned"),
-    masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
-  };
+  if (ctx.eventKind === "remediation-mastery") {
+    return {
+      id: event.externalId,
+      kind: "remediation-mastery",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "Mastery Adjustment",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason,
+      xpDelta: getGeneratedMetricValue(event, "xpEarned"),
+      masteredUnitsDelta: getGeneratedMetricValue(event, "masteredUnits")
+    };
+  }
+  if (ctx.eventKind === "course-completed") {
+    return {
+      id: event.externalId,
+      kind: "course-completed",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: ctx.source === "admin" ? "Course marked complete" : "Course completed",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason
+    };
+  }
+  if (ctx.eventKind === "course-resumed") {
+    return {
+      id: event.externalId,
+      kind: "course-resumed",
+      occurredAt: ctx.occurredAt,
+      courseId: ctx.courseId,
+      title: "Course resumed",
+      activityId: ctx.activityId,
+      appName: ctx.appName,
+      reason: ctx.reason
+    };
+  }
+  return null;
 }
 function mapCaliperEventToRemediationActivity(event, relevantCourseIds) {
   const ctx = parseCaliperEventContext(event, relevantCourseIds);
@@ -54204,6 +54356,7 @@ var init_timeback_util = __esm(() => {
 
 class TimebackAdminService {
   deps;
+  static XP_PRECISION_FACTOR = 10;
   static RECENT_ACTIVITY_LIMIT = 20;
   static MAX_STUDENT_ACTIVITY_LIMIT = 200;
   static MAX_STUDENT_ACTIVITY_OFFSET = 1000;
@@ -54215,6 +54368,10 @@ class TimebackAdminService {
   constructor(deps) {
     this.deps = deps;
   }
+  static roundXpToTenths(value) {
+    const rounded = Math.round(value * TimebackAdminService.XP_PRECISION_FACTOR) / TimebackAdminService.XP_PRECISION_FACTOR;
+    return Object.is(rounded, -0) ? 0 : rounded;
+  }
   requireClient() {
     if (!this.deps.timeback) {
       logger16.error("Timeback client not available in context");
@@ -54222,6 +54379,17 @@ class TimebackAdminService {
     }
     return this.deps.timeback;
   }
+  async recordCourseCompletionHistory(client, data) {
+    await client.recordAdminCourseCompletionChange(data).catch((error) => {
+      logger16.error("Failed to record admin course completion history event", {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: data.action,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    });
+  }
   async resolveAdminMutationContext(gameId, courseId, user, studentId) {
     const client = this.requireClient();
     await this.deps.validateDeveloperAccess(user, gameId);
@@ -54261,8 +54429,8 @@ class TimebackAdminService {
     }
     const today = formatDateYMD();
     const history = [];
-    let totalXp = 0;
-    let todayXp = 0;
+    let totalXpRaw = 0;
+    let todayXpRaw = 0;
     let activeTimeSeconds = 0;
     let masteredUnits = 0;
     for (const [date3, subjectFacts] of Object.entries(facts)) {
@@ -54279,15 +54447,16 @@ class TimebackAdminService {
           masteredUnitsForDay += masteredUnitsFromFact;
         }
       }
-      totalXp += xpForDay;
+      const roundedXpForDay = TimebackAdminService.roundXpToTenths(xpForDay);
+      totalXpRaw += xpForDay;
       activeTimeSeconds += activeSecondsForDay;
       masteredUnits += masteredUnitsForDay;
       if (date3 === today) {
-        todayXp += xpForDay;
+        todayXpRaw += xpForDay;
       }
       history.push({
         date: date3,
-        xpEarned: xpForDay,
+        xpEarned: roundedXpForDay,
         activeTimeSeconds: activeSecondsForDay,
         masteredUnits: masteredUnitsForDay
       });
@@ -54295,8 +54464,8 @@ class TimebackAdminService {
     history.sort((a, b) => a.date.localeCompare(b.date));
     return {
       analyticsAvailable: true,
-      totalXp,
-      todayXp,
+      totalXp: TimebackAdminService.roundXpToTenths(totalXpRaw),
+      todayXp: TimebackAdminService.roundXpToTenths(todayXpRaw),
       activeTimeSeconds,
       masteredUnits,
       history
@@ -54638,6 +54807,7 @@ class TimebackAdminService {
   }
   async toggleCourseCompletion(data, user) {
     const { client, sensorUrl, appName, actor } = await this.resolveAdminMutationContext(data.gameId, data.courseId, user, data.studentId);
+    const historyClient = client;
     const ids = deriveSourcedIds(data.courseId);
     const lineItemId = `${ids.course}-mastery-completion-assessment`;
     const resultId = `${lineItemId}:${data.studentId}:completion`;
@@ -54688,11 +54858,19 @@ class TimebackAdminService {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           adminAction: true,
           appName
         }
       });
+      await this.recordCourseCompletionHistory(historyClient, {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: "complete",
+        actor,
+        appName,
+        sensorUrl
+      });
     } else {
       await client.oneroster.assessmentResults.upsert(resultId, {
         sourcedId: resultId,
@@ -54705,11 +54883,19 @@ class TimebackAdminService {
         inProgress: "true",
         metadata: {
           isMasteryCompletion: true,
-          resumedAt: new Date().toISOString(),
           adminAction: true,
           appName
         }
       });
+      await this.recordCourseCompletionHistory(historyClient, {
+        gameId: data.gameId,
+        courseId: data.courseId,
+        studentId: data.studentId,
+        action: "resume",
+        actor,
+        appName,
+        sensorUrl
+      });
     }
     return { status: "ok" };
   }
@@ -58934,7 +59120,8 @@ function buildAdminEventMetadata({
   return {
     playcademy: {
       eventKind,
-      reason
+      reason,
+      source: "admin"
     }
   };
 }
@@ -59050,6 +59237,30 @@ class AdminEventRecorder {
       eventExtensions: ctx.metadata
     });
   }
+  async recordCourseCompletionChange(data) {
+    const isResume = data.action === "resume";
+    const ctx = await this.prepareAdminEvent({
+      ...data,
+      defaultActivityId: isResume ? "playcademy-admin-course-resumed" : "playcademy-admin-course-completed",
+      reason: "Admin action",
+      eventKind: isResume ? "course-resumed" : "course-completed"
+    });
+    await this.caliper.emitActivityEvent({
+      studentId: ctx.student.id,
+      studentEmail: ctx.student.email,
+      activityId: ctx.activityId,
+      activityName: isResume ? "Course resumed" : "Course marked complete",
+      courseId: data.courseId,
+      courseName: ctx.courseContext.courseName,
+      subject: ctx.courseContext.subject,
+      appName: ctx.appName,
+      sensorUrl: ctx.sensorUrl,
+      process: false,
+      includeAttempt: false,
+      generatedExtensions: ctx.metadata,
+      eventExtensions: ctx.metadata
+    });
+  }
 }
 
 class TimebackCache {
@@ -59263,7 +59474,7 @@ class MasteryTracker {
     const totalMastered = historicalMasteredUnits + masteredUnits;
     const rawPct = totalMastered / masterableUnits * 100;
     const pctCompleteApp = Math.min(100, Math.max(0, Math.round(rawPct)));
-    const masteryAchieved = totalMastered >= masterableUnits;
+    const masteryAchieved = historicalMasteredUnits < masterableUnits && totalMastered >= masterableUnits;
     return { pctCompleteApp, masteryAchieved };
   }
   async createCompletionEntry(studentId, courseId, classId, appName) {
@@ -59289,7 +59500,6 @@ class MasteryTracker {
         inProgress: "false",
         metadata: {
           isMasteryCompletion: true,
-          completedAt: new Date().toISOString(),
           appName
         }
       });
@@ -59505,6 +59715,16 @@ class ProgressRecorder {
     }
     if (masteryAchieved) {
       await this.masteryTracker.createCompletionEntry(studentId, courseId, progressData.classId, progressData.appName);
+      await this.emitCourseCompletionHistoryEvent({
+        studentId,
+        studentEmail,
+        activityId,
+        courseId: ids.course,
+        courseName,
+        subject: progressData.subject,
+        appName: progressData.appName,
+        sensorUrl: progressData.sensorUrl
+      });
     }
     await this.emitCaliperEvent({
       studentId,
@@ -59679,6 +59899,38 @@ class ProgressRecorder {
       log.error("[ProgressRecorder] Failed to emit activity event", { error });
     });
   }
+  async emitCourseCompletionHistoryEvent(data) {
+    await this.caliperNamespace.emitActivityEvent({
+      studentId: data.studentId,
+      studentEmail: data.studentEmail,
+      activityId: data.activityId,
+      activityName: "Course completed",
+      courseId: data.courseId,
+      courseName: data.courseName,
+      subject: data.subject,
+      appName: data.appName,
+      sensorUrl: data.sensorUrl,
+      process: false,
+      includeAttempt: false,
+      eventExtensions: {
+        playcademy: {
+          eventKind: "course-completed",
+          source: "gameplay"
+        }
+      },
+      generatedExtensions: {
+        playcademy: {
+          eventKind: "course-completed",
+          source: "gameplay",
+          activityId: data.activityId
+        }
+      }
+    }).catch((error) => {
+      log.error("[ProgressRecorder] Failed to emit course completion history event", {
+        error
+      });
+    });
+  }
 }
 
 class SessionRecorder {
@@ -60073,6 +60325,10 @@ class TimebackClient {
     await this._ensureAuthenticated();
     return this.adminEventRecorder.recordMasteryAdjustment(data);
   }
+  async recordAdminCourseCompletionChange(data) {
+    await this._ensureAuthenticated();
+    return this.adminEventRecorder.recordCourseCompletionChange(data);
+  }
   clearCaches() {
     this.cacheManager.clearAll();
   }
@@ -120597,6 +120853,7 @@ var listManageable;
 var getSubjects;
 var getById2;
 var getBySlug;
+var getManifest;
 var upsertBySlug;
 var remove3;
 var games2;
@@ -120639,6 +120896,21 @@ var init_game_controller = __esm(() => {
     logger46.debug("Getting game by slug", { userId: ctx.user.id, slug: slug2, launchId: ctx.launchId });
     return ctx.services.game.getBySlug(slug2, ctx.user);
   });
+  getManifest = requireAuth(async (ctx) => {
+    const gameId = ctx.params.gameId;
+    if (!gameId) {
+      throw ApiError.badRequest("Missing game ID");
+    }
+    if (!isValidUUID(gameId)) {
+      throw ApiError.unprocessableEntity("gameId must be a valid UUID format");
+    }
+    logger46.debug("Getting game manifest by ID", {
+      userId: ctx.user.id,
+      gameId,
+      launchId: ctx.launchId
+    });
+    return ctx.services.game.getManifest(gameId, ctx.user);
+  });
   upsertBySlug = requireAuth(async (ctx) => {
     const slug2 = ctx.params.slug;
     if (!slug2) {
@@ -120675,6 +120947,7 @@ var init_game_controller = __esm(() => {
     listManageable,
     getSubjects,
     getById: getById2,
+    getManifest,
     getBySlug,
     upsertBySlug,
     remove: remove3
@@ -122549,7 +122822,8 @@ var init_crud = __esm(() => {
   init_api();
   gameCrudRouter = new Hono2;
   gameCrudRouter.get("/", handle2(games2.list));
-  gameCrudRouter.get("/:gameId{[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}}", handle2(games2.getById));
+  gameCrudRouter.get("/:gameId{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}/manifest", handle2(games2.getManifest));
+  gameCrudRouter.get("/:gameId{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}", handle2(games2.getById));
   gameCrudRouter.get("/:slug", handle2(games2.getBySlug));
   gameCrudRouter.put("/:slug", handle2(games2.upsertBySlug));
   gameCrudRouter.delete("/:gameId", handle2(games2.remove, { status: 204 }));
@@ -124862,7 +125136,7 @@ var import_picocolors12 = __toESM(require_picocolors(), 1);
 // package.json
 var package_default2 = {
   name: "@playcademy/vite-plugin",
-  version: "0.2.22-beta.3",
+  version: "0.2.22-beta.5",
   type: "module",
   exports: {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/vite-plugin",
-    "version": "0.2.22-beta.3",
+    "version": "0.2.22-beta.5",
     "type": "module",
     "exports": {
         ".": {