@playcademy/sandbox 0.4.2-beta.1 → 0.4.2-beta.2

package/dist/cli.js

@@ -249,6 +249,7 @@ var init_timeback2 = __esm(() => {
     END_ACTIVITY: "/integrations/timeback/end-activity",
     GET_XP: "/integrations/timeback/xp",
     GET_MASTERY: "/integrations/timeback/mastery",
+    GET_HIGHEST_GRADE_MASTERED: "/integrations/timeback/highest-grade-mastered",
     HEARTBEAT: "/integrations/timeback/heartbeat",
     ADVANCE_COURSE: "/integrations/timeback/advance-course",
     UNENROLL_COURSE: "/integrations/timeback/unenroll-course"
@@ -1077,7 +1078,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.4.2-beta.1",
+    version: "0.4.2-beta.2",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -28248,6 +28249,7 @@ var init_constants3 = __esm(() => {
       END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
       GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
       GET_MASTERY: `/api${TIMEBACK_ROUTES.GET_MASTERY}`,
+      GET_HIGHEST_GRADE_MASTERED: `/api${TIMEBACK_ROUTES.GET_HIGHEST_GRADE_MASTERED}`,
       HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`,
       ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`,
       UNENROLL_COURSE: `/api${TIMEBACK_ROUTES.UNENROLL_COURSE}`
@@ -29128,6 +29130,7 @@ var init_utils6 = __esm(() => {
     };
   });
   init_constants7();
+  init_constants7();
   if (process.env.DEBUG === "true") {
     process.env.TERM = "dumb";
   }
@@ -33560,6 +33563,25 @@ var init_timeback_service = __esm(() => {
       });
       return result;
     }
+    async getStudentHighestGradeMastered(timebackId, user, options) {
+      const client = this.requireClient();
+      const db2 = this.deps.db;
+      await this.deps.validateDeveloperAccess(user, options.gameId);
+      const integration = await db2.query.gameTimebackIntegrations.findFirst({
+        where: and(eq(gameTimebackIntegrations.gameId, options.gameId), eq(gameTimebackIntegrations.subject, options.subject))
+      });
+      if (!integration) {
+        throw new ValidationError(`Subject "${options.subject}" is not configured for game ${options.gameId}`);
+      }
+      const result = await client.getHighestGradeMastered(timebackId, options.subject);
+      logger20.debug("Retrieved student highest grade mastered", {
+        timebackId,
+        gameId: options.gameId,
+        subject: options.subject,
+        highestGradeMastered: result.highestGradeMastered
+      });
+      return result;
+    }
   };
 });
 
@@ -34789,6 +34811,19 @@ async function getTimebackTokenResponse(config2) {
 function getAuthUrl(environment = "production") {
   return TIMEBACK_AUTH_URLS5[environment];
 }
+function parseEduBridgeGrade(value) {
+  if (value === null || value === undefined || value.trim() === "") {
+    return null;
+  }
+  const parsed = Number(value);
+  return isTimebackGrade3(parsed) ? parsed : null;
+}
+function normalizeHighestGradeMastered(response, subject) {
+  return {
+    subject,
+    highestGradeMastered: parseEduBridgeGrade(response.grades.highestGradeOverall)
+  };
+}
 function handleHttpError(res, errorBody, attempt, retries, url2) {
   const error = new TimebackApiError2(res.status, res.statusText, errorBody);
   if (res.status >= HTTP_STATUS5.CLIENT_ERROR_MIN && res.status < HTTP_STATUS5.CLIENT_ERROR_MAX) {
@@ -35133,7 +35168,8 @@ function createEduBridgeNamespace(client) {
   const analytics = {
     getEnrollmentFacts: async (enrollmentId, options) => client["request"](buildPath(`/edubridge/analytics/enrollment/${enrollmentId}`, {
       timezone: options?.timezone
-    }), "GET")
+    }), "GET"),
+    getHighestGradeMastered: async (studentId, subject) => client["request"](`/edubridge/analytics/highestGradeMastered/${encodeURIComponent(studentId)}/${encodeURIComponent(subject)}`, "GET")
   };
   return {
     enrollments,
@@ -36875,6 +36911,11 @@ class TimebackClient {
       ...options?.include?.perCourse && { courses }
     };
   }
+  async getHighestGradeMastered(studentId, subject) {
+    await this._ensureAuthenticated();
+    const response = await this.edubridge.analytics.getHighestGradeMastered(studentId, subject);
+    return normalizeHighestGradeMastered(response, subject);
+  }
   async getStudentXp(studentId, options) {
     await this._ensureAuthenticated();
     const enrollments = await this.edubridge.enrollments.listByUser(studentId);
@@ -94197,7 +94238,7 @@ var init_session_controller = __esm(() => {
 });
 
 // ../api-core/src/controllers/timeback.controller.ts
-var logger45, populateStudent, getUser, getUserEnrollments, getUserById, setupIntegration, getIntegrations, updateIntegration, getIntegrationConfig, verifyIntegration, getConfig, deleteIntegrations, endActivity, heartbeat, advanceCourse, unenrollCourse, getStudentXp, getStudentMastery, getRoster, getStudentOverview, getGameMetrics, getStudentActivity, getActivityDetail, grantXp, adjustTime, adjustMastery, reconcileMasteryForConfigChange, searchStudents, enrollStudent, unenrollStudent, reactivateEnrollment, listAssessments, createAssessment, deleteAssessment, reorderAssessments, reorderQuestions, activateAssessment, deactivateAssessment, listQuestions, createQuestion, updateQuestion, deleteQuestion, getAssessmentBankStatus, destroyAssessmentBank, timeback2;
+var logger45, populateStudent, getUser, getUserEnrollments, getUserById, setupIntegration, getIntegrations, updateIntegration, getIntegrationConfig, verifyIntegration, getConfig, deleteIntegrations, endActivity, heartbeat, advanceCourse, unenrollCourse, getStudentXp, getStudentMastery, getStudentHighestGradeMastered, getRoster, getStudentOverview, getGameMetrics, getStudentActivity, getActivityDetail, grantXp, adjustTime, adjustMastery, reconcileMasteryForConfigChange, searchStudents, enrollStudent, unenrollStudent, reactivateEnrollment, listAssessments, createAssessment, deleteAssessment, reorderAssessments, reorderQuestions, activateAssessment, deactivateAssessment, listQuestions, createQuestion, updateQuestion, deleteQuestion, getAssessmentBankStatus, destroyAssessmentBank, timeback2;
 var init_timeback_controller = __esm(() => {
   init_esm();
   init_schemas_index();
@@ -94541,6 +94582,33 @@ var init_timeback_controller = __esm(() => {
       include
     });
   });
+  getStudentHighestGradeMastered = requireDeveloper(async (ctx) => {
+    const timebackId = ctx.params.timebackId;
+    if (!timebackId) {
+      throw ApiError.badRequest("Missing timebackId parameter");
+    }
+    const gameId = ctx.url.searchParams.get("gameId");
+    if (!gameId) {
+      throw ApiError.badRequest("Missing required gameId query parameter");
+    }
+    const subjectParam = ctx.url.searchParams.get("subject");
+    if (!subjectParam) {
+      throw ApiError.badRequest("Missing required subject query parameter");
+    }
+    if (!isTimebackSubject2(subjectParam)) {
+      throw ApiError.badRequest(`Invalid subject: ${subjectParam}. Valid subjects: ${TIMEBACK_SUBJECTS4.join(", ")}`);
+    }
+    logger45.debug("Getting student highest grade mastered", {
+      requesterId: ctx.user.id,
+      timebackId,
+      gameId,
+      subject: subjectParam
+    });
+    return ctx.services.timeback.getStudentHighestGradeMastered(timebackId, ctx.user, {
+      gameId,
+      subject: subjectParam
+    });
+  });
   getRoster = requireGameManagementAccess(async (ctx) => {
     const gameId = ctx.params.gameId;
     const courseId = ctx.params.courseId;
@@ -94879,6 +94947,7 @@ var init_timeback_controller = __esm(() => {
     unenrollCourse,
     getStudentXp,
     getStudentMastery,
+    getStudentHighestGradeMastered,
     getRoster,
     getStudentOverview,
     getGameMetrics,
@@ -95087,6 +95156,10 @@ async function getMockTimebackUser(db2, gameId) {
   const timebackId = config.timeback.timebackId || "mock-student-00000001";
   return getMockTimebackData(db2, timebackId, gameId);
 }
+function getMockHighestGradeMastered(enrollments, subject) {
+  const subjectGrades = enrollments.filter((enrollment) => enrollment.subject === subject).map((enrollment) => enrollment.grade);
+  return subjectGrades.length > 0 ? Math.max(...subjectGrades) : null;
+}
 async function buildMockUserResponse(db2, user, gameId) {
   const timeback3 = user.timebackId ? await getMockTimebackData(db2, user.timebackId, gameId) : undefined;
   if (gameId) {
@@ -95934,6 +96007,39 @@ var init_timeback6 = __esm(() => {
     }
     return handle2(timeback2.getStudentMastery)(c2);
   });
+  timebackRouter.get("/student-highest-grade-mastered/:timebackId", async (c2) => {
+    const user = c2.get("user");
+    if (!user) {
+      const error2 = ApiError.unauthorized("Must be logged in to get student highest grade mastered");
+      return c2.json(createErrorResponse(error2), error2.status);
+    }
+    if (shouldMockTimeback()) {
+      const url2 = new URL(c2.req.url);
+      const subject = url2.searchParams.get("subject");
+      const contextGameId = c2.get("gameId");
+      const gameId = url2.searchParams.get("gameId") || (typeof contextGameId === "string" ? contextGameId : undefined);
+      if (!subject) {
+        const error2 = ApiError.badRequest("Missing required subject query parameter");
+        return c2.json(createErrorResponse(error2), error2.status);
+      }
+      if (!gameId) {
+        const error2 = ApiError.badRequest("Missing required gameId query parameter");
+        return c2.json(createErrorResponse(error2), error2.status);
+      }
+      if (!isTimebackSubject2(subject)) {
+        const error2 = ApiError.badRequest(`Invalid subject: ${subject}. Valid subjects: ${TIMEBACK_SUBJECTS4.join(", ")}`);
+        return c2.json(createErrorResponse(error2), error2.status);
+      }
+      const db2 = c2.get("db");
+      const enrollments = await getMockEnrollments(db2);
+      const gameScopedEnrollments = filterEnrollmentsByGame(enrollments, gameId);
+      return c2.json({
+        subject,
+        highestGradeMastered: getMockHighestGradeMastered(gameScopedEnrollments, subject)
+      });
+    }
+    return handle2(timeback2.getStudentHighestGradeMastered)(c2);
+  });
 });
 
 // src/routes/integrations/lti.ts
@@ -98311,7 +98417,8 @@ program2.name("playcademy-sandbox").description("Local development server for Pl
       port,
       url: `http://localhost:${port}/api`,
       startedAt: Date.now(),
-      projectRoot: process.cwd()
+      projectRoot: process.cwd(),
+      gameId: server.gameId
     });
     const totalCourses = project?.timebackCourses?.length ?? 0;
     const excludedCount = options.timebackExcludedCourses ? options.timebackExcludedCourses.split(",").filter(Boolean).length : 0;

package/dist/constants.js

@@ -84,6 +84,7 @@ var init_timeback = __esm(() => {
     END_ACTIVITY: "/integrations/timeback/end-activity",
     GET_XP: "/integrations/timeback/xp",
     GET_MASTERY: "/integrations/timeback/mastery",
+    GET_HIGHEST_GRADE_MASTERED: "/integrations/timeback/highest-grade-mastered",
     HEARTBEAT: "/integrations/timeback/heartbeat",
     ADVANCE_COURSE: "/integrations/timeback/advance-course",
     UNENROLL_COURSE: "/integrations/timeback/unenroll-course"

package/dist/mocks/timeback.d.ts

@@ -30,6 +30,7 @@ export declare function getMockTimebackData(db: DatabaseInstance, timebackId: st
  * Uses the configured timebackId from sandbox config.
  */
 export declare function getMockTimebackUser(db: DatabaseInstance, gameId?: string): Promise<UserTimebackData>;
+export declare function getMockHighestGradeMastered(enrollments: UserEnrollment[], subject: string): number | null;
 /**
  * Build a complete user response with mock timeback data.
  * Used to bypass api-core when in mock mode (avoids real API calls).

package/dist/server.js

@@ -248,6 +248,7 @@ var init_timeback2 = __esm(() => {
     END_ACTIVITY: "/integrations/timeback/end-activity",
     GET_XP: "/integrations/timeback/xp",
     GET_MASTERY: "/integrations/timeback/mastery",
+    GET_HIGHEST_GRADE_MASTERED: "/integrations/timeback/highest-grade-mastered",
     HEARTBEAT: "/integrations/timeback/heartbeat",
     ADVANCE_COURSE: "/integrations/timeback/advance-course",
     UNENROLL_COURSE: "/integrations/timeback/unenroll-course"
@@ -1076,7 +1077,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.4.2-beta.1",
+    version: "0.4.2-beta.2",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -28247,6 +28248,7 @@ var init_constants3 = __esm(() => {
       END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
       GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
       GET_MASTERY: `/api${TIMEBACK_ROUTES.GET_MASTERY}`,
+      GET_HIGHEST_GRADE_MASTERED: `/api${TIMEBACK_ROUTES.GET_HIGHEST_GRADE_MASTERED}`,
       HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`,
       ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`,
       UNENROLL_COURSE: `/api${TIMEBACK_ROUTES.UNENROLL_COURSE}`
@@ -29127,6 +29129,7 @@ var init_utils6 = __esm(() => {
     };
   });
   init_constants7();
+  init_constants7();
   if (process.env.DEBUG === "true") {
     process.env.TERM = "dumb";
   }
@@ -33559,6 +33562,25 @@ var init_timeback_service = __esm(() => {
       });
       return result;
     }
+    async getStudentHighestGradeMastered(timebackId, user, options) {
+      const client = this.requireClient();
+      const db2 = this.deps.db;
+      await this.deps.validateDeveloperAccess(user, options.gameId);
+      const integration = await db2.query.gameTimebackIntegrations.findFirst({
+        where: and(eq(gameTimebackIntegrations.gameId, options.gameId), eq(gameTimebackIntegrations.subject, options.subject))
+      });
+      if (!integration) {
+        throw new ValidationError(`Subject "${options.subject}" is not configured for game ${options.gameId}`);
+      }
+      const result = await client.getHighestGradeMastered(timebackId, options.subject);
+      logger20.debug("Retrieved student highest grade mastered", {
+        timebackId,
+        gameId: options.gameId,
+        subject: options.subject,
+        highestGradeMastered: result.highestGradeMastered
+      });
+      return result;
+    }
   };
 });
 
@@ -34788,6 +34810,19 @@ async function getTimebackTokenResponse(config2) {
 function getAuthUrl(environment = "production") {
   return TIMEBACK_AUTH_URLS5[environment];
 }
+function parseEduBridgeGrade(value) {
+  if (value === null || value === undefined || value.trim() === "") {
+    return null;
+  }
+  const parsed = Number(value);
+  return isTimebackGrade3(parsed) ? parsed : null;
+}
+function normalizeHighestGradeMastered(response, subject) {
+  return {
+    subject,
+    highestGradeMastered: parseEduBridgeGrade(response.grades.highestGradeOverall)
+  };
+}
 function handleHttpError(res, errorBody, attempt, retries, url2) {
   const error = new TimebackApiError2(res.status, res.statusText, errorBody);
   if (res.status >= HTTP_STATUS5.CLIENT_ERROR_MIN && res.status < HTTP_STATUS5.CLIENT_ERROR_MAX) {
@@ -35132,7 +35167,8 @@ function createEduBridgeNamespace(client) {
   const analytics = {
     getEnrollmentFacts: async (enrollmentId, options) => client["request"](buildPath(`/edubridge/analytics/enrollment/${enrollmentId}`, {
       timezone: options?.timezone
-    }), "GET")
+    }), "GET"),
+    getHighestGradeMastered: async (studentId, subject) => client["request"](`/edubridge/analytics/highestGradeMastered/${encodeURIComponent(studentId)}/${encodeURIComponent(subject)}`, "GET")
   };
   return {
     enrollments,
@@ -36874,6 +36910,11 @@ class TimebackClient {
       ...options?.include?.perCourse && { courses }
     };
   }
+  async getHighestGradeMastered(studentId, subject) {
+    await this._ensureAuthenticated();
+    const response = await this.edubridge.analytics.getHighestGradeMastered(studentId, subject);
+    return normalizeHighestGradeMastered(response, subject);
+  }
   async getStudentXp(studentId, options) {
     await this._ensureAuthenticated();
     const enrollments = await this.edubridge.enrollments.listByUser(studentId);
@@ -94196,7 +94237,7 @@ var init_session_controller = __esm(() => {
 });
 
 // ../api-core/src/controllers/timeback.controller.ts
-var logger45, populateStudent, getUser, getUserEnrollments, getUserById, setupIntegration, getIntegrations, updateIntegration, getIntegrationConfig, verifyIntegration, getConfig, deleteIntegrations, endActivity, heartbeat, advanceCourse, unenrollCourse, getStudentXp, getStudentMastery, getRoster, getStudentOverview, getGameMetrics, getStudentActivity, getActivityDetail, grantXp, adjustTime, adjustMastery, reconcileMasteryForConfigChange, searchStudents, enrollStudent, unenrollStudent, reactivateEnrollment, listAssessments, createAssessment, deleteAssessment, reorderAssessments, reorderQuestions, activateAssessment, deactivateAssessment, listQuestions, createQuestion, updateQuestion, deleteQuestion, getAssessmentBankStatus, destroyAssessmentBank, timeback2;
+var logger45, populateStudent, getUser, getUserEnrollments, getUserById, setupIntegration, getIntegrations, updateIntegration, getIntegrationConfig, verifyIntegration, getConfig, deleteIntegrations, endActivity, heartbeat, advanceCourse, unenrollCourse, getStudentXp, getStudentMastery, getStudentHighestGradeMastered, getRoster, getStudentOverview, getGameMetrics, getStudentActivity, getActivityDetail, grantXp, adjustTime, adjustMastery, reconcileMasteryForConfigChange, searchStudents, enrollStudent, unenrollStudent, reactivateEnrollment, listAssessments, createAssessment, deleteAssessment, reorderAssessments, reorderQuestions, activateAssessment, deactivateAssessment, listQuestions, createQuestion, updateQuestion, deleteQuestion, getAssessmentBankStatus, destroyAssessmentBank, timeback2;
 var init_timeback_controller = __esm(() => {
   init_esm();
   init_schemas_index();
@@ -94540,6 +94581,33 @@ var init_timeback_controller = __esm(() => {
       include
     });
   });
+  getStudentHighestGradeMastered = requireDeveloper(async (ctx) => {
+    const timebackId = ctx.params.timebackId;
+    if (!timebackId) {
+      throw ApiError.badRequest("Missing timebackId parameter");
+    }
+    const gameId = ctx.url.searchParams.get("gameId");
+    if (!gameId) {
+      throw ApiError.badRequest("Missing required gameId query parameter");
+    }
+    const subjectParam = ctx.url.searchParams.get("subject");
+    if (!subjectParam) {
+      throw ApiError.badRequest("Missing required subject query parameter");
+    }
+    if (!isTimebackSubject2(subjectParam)) {
+      throw ApiError.badRequest(`Invalid subject: ${subjectParam}. Valid subjects: ${TIMEBACK_SUBJECTS4.join(", ")}`);
+    }
+    logger45.debug("Getting student highest grade mastered", {
+      requesterId: ctx.user.id,
+      timebackId,
+      gameId,
+      subject: subjectParam
+    });
+    return ctx.services.timeback.getStudentHighestGradeMastered(timebackId, ctx.user, {
+      gameId,
+      subject: subjectParam
+    });
+  });
   getRoster = requireGameManagementAccess(async (ctx) => {
     const gameId = ctx.params.gameId;
     const courseId = ctx.params.courseId;
@@ -94878,6 +94946,7 @@ var init_timeback_controller = __esm(() => {
     unenrollCourse,
     getStudentXp,
     getStudentMastery,
+    getStudentHighestGradeMastered,
     getRoster,
     getStudentOverview,
     getGameMetrics,
@@ -95086,6 +95155,10 @@ async function getMockTimebackUser(db2, gameId) {
   const timebackId = config.timeback.timebackId || "mock-student-00000001";
   return getMockTimebackData(db2, timebackId, gameId);
 }
+function getMockHighestGradeMastered(enrollments, subject) {
+  const subjectGrades = enrollments.filter((enrollment) => enrollment.subject === subject).map((enrollment) => enrollment.grade);
+  return subjectGrades.length > 0 ? Math.max(...subjectGrades) : null;
+}
 async function buildMockUserResponse(db2, user, gameId) {
   const timeback3 = user.timebackId ? await getMockTimebackData(db2, user.timebackId, gameId) : undefined;
   if (gameId) {
@@ -95933,6 +96006,39 @@ var init_timeback6 = __esm(() => {
     }
     return handle2(timeback2.getStudentMastery)(c2);
   });
+  timebackRouter.get("/student-highest-grade-mastered/:timebackId", async (c2) => {
+    const user = c2.get("user");
+    if (!user) {
+      const error2 = ApiError.unauthorized("Must be logged in to get student highest grade mastered");
+      return c2.json(createErrorResponse(error2), error2.status);
+    }
+    if (shouldMockTimeback()) {
+      const url2 = new URL(c2.req.url);
+      const subject = url2.searchParams.get("subject");
+      const contextGameId = c2.get("gameId");
+      const gameId = url2.searchParams.get("gameId") || (typeof contextGameId === "string" ? contextGameId : undefined);
+      if (!subject) {
+        const error2 = ApiError.badRequest("Missing required subject query parameter");
+        return c2.json(createErrorResponse(error2), error2.status);
+      }
+      if (!gameId) {
+        const error2 = ApiError.badRequest("Missing required gameId query parameter");
+        return c2.json(createErrorResponse(error2), error2.status);
+      }
+      if (!isTimebackSubject2(subject)) {
+        const error2 = ApiError.badRequest(`Invalid subject: ${subject}. Valid subjects: ${TIMEBACK_SUBJECTS4.join(", ")}`);
+        return c2.json(createErrorResponse(error2), error2.status);
+      }
+      const db2 = c2.get("db");
+      const enrollments = await getMockEnrollments(db2);
+      const gameScopedEnrollments = filterEnrollmentsByGame(enrollments, gameId);
+      return c2.json({
+        subject,
+        highestGradeMastered: getMockHighestGradeMastered(gameScopedEnrollments, subject)
+      });
+    }
+    return handle2(timeback2.getStudentHighestGradeMastered)(c2);
+  });
 });
 
 // src/routes/integrations/lti.ts

package/package.json

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