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

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.21",
+    version: "0.3.17-beta.22",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -30922,21 +30922,25 @@ class TimebackAdminService {
     });
     return new Map(results);
   }
+  async fetchCaliperEventsForStudent(client, studentId, source, limit) {
+    const actorId = `${client.getBaseUrl().replace(/\/$/, "")}/ims/oneroster/rostering/v1p2/users/${studentId}`;
+    const { events } = await client.caliper.events.list({
+      limit,
+      actorId,
+      ...source.sourceMode === "production" ? { sensor: source.sensorUrl } : {},
+      extensions: {
+        gameId: source.gameId
+      }
+    });
+    return events;
+  }
   async listRecentActivityForStudent(client, studentId, source, relevantCourseIds, maxResults = TimebackAdminService.RECENT_ACTIVITY_LIMIT) {
     if (relevantCourseIds.size === 0) {
       return [];
     }
     try {
-      const actorId = `${client.getBaseUrl().replace(/\/$/, "")}/ims/oneroster/rostering/v1p2/users/${studentId}`;
       const eventLimit = Math.min(Math.max(200, maxResults * 20), TimebackAdminService.MAX_RECENT_ACTIVITY_EVENT_FETCH);
-      const { events } = await client.caliper.events.list({
-        limit: eventLimit,
-        actorId,
-        ...source.sourceMode === "production" ? { sensor: source.sensorUrl } : {},
-        extensions: {
-          gameId: source.gameId
-        }
-      });
+      const events = await this.fetchCaliperEventsForStudent(client, studentId, source, eventLimit);
       return TimebackAdminService.mapRecentActivityItems(events, relevantCourseIds).slice(0, maxResults);
     } catch (error) {
       logger16.warn("Failed to load recent Caliper activity", {
@@ -31060,6 +31064,42 @@ class TimebackAdminService {
     const hasMore = allActivities.length > safeOffset + safeLimit;
     return { activities, hasMore };
   }
+  async getActivityDetail(user, options) {
+    const { gameId, studentId, courseId, activityId, runId } = options;
+    const client = this.requireClient();
+    await this.deps.validateGameManagementAccess(user, gameId);
+    const [integration, gameSource] = await Promise.all([
+      this.deps.db.query.gameTimebackIntegrations.findFirst({
+        where: and(eq(gameTimebackIntegrations.gameId, gameId), eq(gameTimebackIntegrations.courseId, courseId))
+      }),
+      this.getGameActivitySource(gameId)
+    ]);
+    if (!integration) {
+      throw new NotFoundError("Timeback integration", `${gameId}:${courseId}`);
+    }
+    await this.assertStudentEnrolledInCourse(client, studentId, courseId);
+    const events = await this.fetchCaliperEventsForStudent(client, studentId, gameSource, TimebackAdminService.MAX_RECENT_ACTIVITY_EVENT_FETCH);
+    const relevantCourseIds = new Set([courseId]);
+    let matchedEvents;
+    let activity;
+    if (runId) {
+      const gameplayEvents = events.filter((event) => (event.type === "ActivityEvent" || event.type === "TimeSpentEvent") && !isCaliperRemediationOrCompletionEvent(event));
+      const groups = groupCaliperEventsByRun(gameplayEvents);
+      matchedEvents = [...groups.values()].find((group) => group.some((event) => getCanonicalRunId(event.session) === runId && event.externalId === activityId)) ?? [];
+      activity = mapCaliperEventGroupToActivity(matchedEvents, relevantCourseIds);
+    } else {
+      matchedEvents = events.filter((event) => event.externalId === activityId);
+      if (matchedEvents.length > 0) {
+        activity = mapCaliperEventToRemediationActivity(matchedEvents[0], relevantCourseIds) ?? mapCaliperEventGroupToActivity(matchedEvents, relevantCourseIds);
+      } else {
+        activity = null;
+      }
+    }
+    if (!activity) {
+      throw new NotFoundError("Activity", activityId);
+    }
+    return { activity, rawEvents: matchedEvents };
+  }
   async grantManualXp(data, user) {
     const { client, sensorUrl, appName, actor } = await this.resolveAdminMutationContext(data.gameId, data.courseId, user, data.studentId);
     await client.recordAdminXpAdjustment({
@@ -96522,7 +96562,7 @@ var init_sprite_controller = __esm(() => {
 });
 
 // ../api-core/src/controllers/timeback.controller.ts
-var logger64, getTodayXp, getTotalXp, updateTodayXp, getXpHistory, populateStudent, getUser, getUserById, setupIntegration, getIntegrations, verifyIntegration, getConfig2, deleteIntegrations, endActivity, heartbeat, advanceCourse, getStudentXp, getRoster, getStudentOverview, getStudentActivity, grantXp, adjustTime, adjustMastery, toggleCompletion, searchStudents, enrollStudent, unenrollStudent, timeback2;
+var logger64, getTodayXp, getTotalXp, updateTodayXp, getXpHistory, populateStudent, getUser, getUserById, setupIntegration, getIntegrations, verifyIntegration, getConfig2, deleteIntegrations, endActivity, heartbeat, advanceCourse, getStudentXp, getRoster, getStudentOverview, getStudentActivity, getActivityDetail, grantXp, adjustTime, adjustMastery, toggleCompletion, searchStudents, enrollStudent, unenrollStudent, timeback2;
 var init_timeback_controller = __esm(() => {
   init_esm();
   init_schemas_index();
@@ -96858,6 +96898,31 @@ var init_timeback_controller = __esm(() => {
       offset
     });
   });
+  getActivityDetail = requireGameManagementAccess(async (ctx) => {
+    const timebackId = ctx.params.timebackId;
+    const courseId = ctx.params.courseId;
+    const activityId = ctx.params.activityId;
+    const gameId = ctx.url.searchParams.get("gameId") || undefined;
+    const runId = ctx.url.searchParams.get("runId") || undefined;
+    if (!timebackId || !courseId || !activityId || !gameId) {
+      throw ApiError.badRequest("Missing timebackId, courseId, or activityId path parameter, or gameId query parameter");
+    }
+    logger64.debug("Getting activity detail", {
+      requesterId: ctx.user.id,
+      timebackId,
+      courseId,
+      activityId,
+      gameId,
+      runId
+    });
+    return ctx.services.timebackAdmin.getActivityDetail(ctx.user, {
+      gameId,
+      studentId: timebackId,
+      courseId,
+      activityId,
+      runId
+    });
+  });
   grantXp = requireDeveloper(async (ctx) => {
     const body2 = await parseRequestBody(ctx.request, GrantTimebackXpRequestSchema);
     logger64.debug("Granting manual XP", {
@@ -96960,6 +97025,7 @@ var init_timeback_controller = __esm(() => {
     getRoster,
     getStudentOverview,
     getStudentActivity,
+    getActivityDetail,
     grantXp,
     adjustTime,
     adjustMastery,

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.21",
+    version: "0.3.17-beta.22",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -30921,21 +30921,25 @@ class TimebackAdminService {
     });
     return new Map(results);
   }
+  async fetchCaliperEventsForStudent(client, studentId, source, limit) {
+    const actorId = `${client.getBaseUrl().replace(/\/$/, "")}/ims/oneroster/rostering/v1p2/users/${studentId}`;
+    const { events } = await client.caliper.events.list({
+      limit,
+      actorId,
+      ...source.sourceMode === "production" ? { sensor: source.sensorUrl } : {},
+      extensions: {
+        gameId: source.gameId
+      }
+    });
+    return events;
+  }
   async listRecentActivityForStudent(client, studentId, source, relevantCourseIds, maxResults = TimebackAdminService.RECENT_ACTIVITY_LIMIT) {
     if (relevantCourseIds.size === 0) {
       return [];
     }
     try {
-      const actorId = `${client.getBaseUrl().replace(/\/$/, "")}/ims/oneroster/rostering/v1p2/users/${studentId}`;
       const eventLimit = Math.min(Math.max(200, maxResults * 20), TimebackAdminService.MAX_RECENT_ACTIVITY_EVENT_FETCH);
-      const { events } = await client.caliper.events.list({
-        limit: eventLimit,
-        actorId,
-        ...source.sourceMode === "production" ? { sensor: source.sensorUrl } : {},
-        extensions: {
-          gameId: source.gameId
-        }
-      });
+      const events = await this.fetchCaliperEventsForStudent(client, studentId, source, eventLimit);
       return TimebackAdminService.mapRecentActivityItems(events, relevantCourseIds).slice(0, maxResults);
     } catch (error) {
       logger16.warn("Failed to load recent Caliper activity", {
@@ -31059,6 +31063,42 @@ class TimebackAdminService {
     const hasMore = allActivities.length > safeOffset + safeLimit;
     return { activities, hasMore };
   }
+  async getActivityDetail(user, options) {
+    const { gameId, studentId, courseId, activityId, runId } = options;
+    const client = this.requireClient();
+    await this.deps.validateGameManagementAccess(user, gameId);
+    const [integration, gameSource] = await Promise.all([
+      this.deps.db.query.gameTimebackIntegrations.findFirst({
+        where: and(eq(gameTimebackIntegrations.gameId, gameId), eq(gameTimebackIntegrations.courseId, courseId))
+      }),
+      this.getGameActivitySource(gameId)
+    ]);
+    if (!integration) {
+      throw new NotFoundError("Timeback integration", `${gameId}:${courseId}`);
+    }
+    await this.assertStudentEnrolledInCourse(client, studentId, courseId);
+    const events = await this.fetchCaliperEventsForStudent(client, studentId, gameSource, TimebackAdminService.MAX_RECENT_ACTIVITY_EVENT_FETCH);
+    const relevantCourseIds = new Set([courseId]);
+    let matchedEvents;
+    let activity;
+    if (runId) {
+      const gameplayEvents = events.filter((event) => (event.type === "ActivityEvent" || event.type === "TimeSpentEvent") && !isCaliperRemediationOrCompletionEvent(event));
+      const groups = groupCaliperEventsByRun(gameplayEvents);
+      matchedEvents = [...groups.values()].find((group) => group.some((event) => getCanonicalRunId(event.session) === runId && event.externalId === activityId)) ?? [];
+      activity = mapCaliperEventGroupToActivity(matchedEvents, relevantCourseIds);
+    } else {
+      matchedEvents = events.filter((event) => event.externalId === activityId);
+      if (matchedEvents.length > 0) {
+        activity = mapCaliperEventToRemediationActivity(matchedEvents[0], relevantCourseIds) ?? mapCaliperEventGroupToActivity(matchedEvents, relevantCourseIds);
+      } else {
+        activity = null;
+      }
+    }
+    if (!activity) {
+      throw new NotFoundError("Activity", activityId);
+    }
+    return { activity, rawEvents: matchedEvents };
+  }
   async grantManualXp(data, user) {
     const { client, sensorUrl, appName, actor } = await this.resolveAdminMutationContext(data.gameId, data.courseId, user, data.studentId);
     await client.recordAdminXpAdjustment({
@@ -96521,7 +96561,7 @@ var init_sprite_controller = __esm(() => {
 });
 
 // ../api-core/src/controllers/timeback.controller.ts
-var logger64, getTodayXp, getTotalXp, updateTodayXp, getXpHistory, populateStudent, getUser, getUserById, setupIntegration, getIntegrations, verifyIntegration, getConfig2, deleteIntegrations, endActivity, heartbeat, advanceCourse, getStudentXp, getRoster, getStudentOverview, getStudentActivity, grantXp, adjustTime, adjustMastery, toggleCompletion, searchStudents, enrollStudent, unenrollStudent, timeback2;
+var logger64, getTodayXp, getTotalXp, updateTodayXp, getXpHistory, populateStudent, getUser, getUserById, setupIntegration, getIntegrations, verifyIntegration, getConfig2, deleteIntegrations, endActivity, heartbeat, advanceCourse, getStudentXp, getRoster, getStudentOverview, getStudentActivity, getActivityDetail, grantXp, adjustTime, adjustMastery, toggleCompletion, searchStudents, enrollStudent, unenrollStudent, timeback2;
 var init_timeback_controller = __esm(() => {
   init_esm();
   init_schemas_index();
@@ -96857,6 +96897,31 @@ var init_timeback_controller = __esm(() => {
       offset
     });
   });
+  getActivityDetail = requireGameManagementAccess(async (ctx) => {
+    const timebackId = ctx.params.timebackId;
+    const courseId = ctx.params.courseId;
+    const activityId = ctx.params.activityId;
+    const gameId = ctx.url.searchParams.get("gameId") || undefined;
+    const runId = ctx.url.searchParams.get("runId") || undefined;
+    if (!timebackId || !courseId || !activityId || !gameId) {
+      throw ApiError.badRequest("Missing timebackId, courseId, or activityId path parameter, or gameId query parameter");
+    }
+    logger64.debug("Getting activity detail", {
+      requesterId: ctx.user.id,
+      timebackId,
+      courseId,
+      activityId,
+      gameId,
+      runId
+    });
+    return ctx.services.timebackAdmin.getActivityDetail(ctx.user, {
+      gameId,
+      studentId: timebackId,
+      courseId,
+      activityId,
+      runId
+    });
+  });
   grantXp = requireDeveloper(async (ctx) => {
     const body2 = await parseRequestBody(ctx.request, GrantTimebackXpRequestSchema);
     logger64.debug("Granting manual XP", {
@@ -96959,6 +97024,7 @@ var init_timeback_controller = __esm(() => {
     getRoster,
     getStudentOverview,
     getStudentActivity,
+    getActivityDetail,
     grantXp,
     adjustTime,
     adjustMastery,

package/package.json

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