playcademy 0.22.1 → 0.22.2-beta.2

package/dist/cli.js

@@ -1065,7 +1065,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.14",
+  version: "0.0.15-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -1262,6 +1262,17 @@ var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS = {
   sortOrder: 1,
   lessonType: "quiz"
 };
+var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
+  xp: 1,
+  mastery: 0,
+  score: 2
+};
+var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
+  xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
+  mastery: 0,
+  time: 60,
+  score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
+};
 
 // ../constants/src/cloudflare.ts
 var WORKER_NAMING = {
@@ -2909,7 +2920,7 @@ import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as re
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.22.1";
+var cliVersion = false ? "0.0.0-dev" : "0.22.2-beta.2";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");

package/dist/constants.js

@@ -20,7 +20,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.14",
+  version: "0.0.15-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -247,6 +247,19 @@ var GAME_WORKER_DOMAINS = {
   staging: "staging.playcademy.gg"
 };
 
+// ../constants/src/timeback.ts
+var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
+  xp: 1,
+  mastery: 0,
+  score: 2
+};
+var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
+  xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
+  mastery: 0,
+  time: 60,
+  score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
+};
+
 // src/constants/urls.ts
 var DOCS_URL = "https://docs.dev.playcademy.net/platform";
 export {

package/dist/db.js

@@ -36,7 +36,7 @@ var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.14",
+  version: "0.0.15-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -147,6 +147,19 @@ var CLI_FILES = {
   INITIAL_DATABASE: "initial.sqlite"
 };
 
+// ../constants/src/timeback.ts
+var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
+  xp: 1,
+  mastery: 0,
+  score: 2
+};
+var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
+  xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
+  mastery: 0,
+  time: 60,
+  score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
+};
+
 // src/lib/db/path.ts
 var DB_DIRECTORY = CLI_DIRECTORIES.DATABASE;
 var INITIAL_DB_NAME = CLI_FILES.INITIAL_DATABASE;

package/dist/index.js

@@ -326,7 +326,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.14",
+  version: "0.0.15-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -534,6 +534,7 @@ var LOG_COLLECTOR_URL = "https://logs.playcademy.gg";
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
   GET_XP: "/integrations/timeback/xp",
+  GET_MASTERY: "/integrations/timeback/mastery",
   HEARTBEAT: "/integrations/timeback/heartbeat",
   ADVANCE_COURSE: "/integrations/timeback/advance-course"
 };
@@ -576,6 +577,17 @@ var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS = {
   sortOrder: 1,
   lessonType: "quiz"
 };
+var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
+  xp: 1,
+  mastery: 0,
+  score: 2
+};
+var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
+  xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
+  mastery: 0,
+  time: 60,
+  score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
+};
 
 // ../constants/src/cloudflare.ts
 var WORKER_NAMING = {
@@ -4171,7 +4183,7 @@ import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as rea
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.22.1";
+var cliVersion = false ? "0.0.0-dev" : "0.22.2-beta.2";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
@@ -6612,6 +6624,7 @@ var ROUTES = {
   TIMEBACK: {
     END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
     GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
+    GET_MASTERY: `/api${TIMEBACK_ROUTES.GET_MASTERY}`,
     HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`,
     ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`
   }

package/dist/runtime/backend-runtime/index.js

@@ -8,6 +8,75 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// ../utils/src/timeback.ts
+function formatGradeLabel(grade) {
+  switch (grade) {
+    case -1: {
+      return "Pre-K";
+    }
+    case 0: {
+      return "Kindergarten";
+    }
+    case 13: {
+      return "AP";
+    }
+    default: {
+      return `Grade ${grade}`;
+    }
+  }
+}
+var init_timeback = __esm({
+  "../utils/src/timeback.ts"() {
+  }
+});
+
+// ../edge-play/src/lib/validation.ts
+function isNonNegativeNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function isNonNegativeInteger(value) {
+  return isNonNegativeNumber(value) && Number.isInteger(value);
+}
+function isValidGrade(value) {
+  return typeof value === "number" && Number.isInteger(value) && VALID_GRADES.includes(value);
+}
+function isValidSubject(value) {
+  return typeof value === "string" && VALID_SUBJECTS.includes(value);
+}
+function validateCourseConfig(params) {
+  const { grade, subject, config } = params;
+  const timebackConfig = config.integrations?.timeback;
+  const configuredCourse = timebackConfig?.courses?.find(
+    (course) => course.grade === grade && course.subject === subject
+  );
+  if (!configuredCourse) {
+    const configured = timebackConfig?.courses?.map((c) => `${c.subject} (${formatGradeLabel(c.grade)})`).join(", ");
+    return {
+      error: `Invalid grade/subject combination: ${subject} (${formatGradeLabel(grade)}). Configured courses: ${configured || "none"}`
+    };
+  }
+  return null;
+}
+var VALID_GRADES, VALID_SUBJECTS;
+var init_validation = __esm({
+  "../edge-play/src/lib/validation.ts"() {
+    "use strict";
+    init_timeback();
+    VALID_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
+    VALID_SUBJECTS = [
+      "Reading",
+      "Language",
+      "Vocabulary",
+      "Social Studies",
+      "Writing",
+      "Science",
+      "FastMath",
+      "Math",
+      "None"
+    ];
+  }
+});
+
 // ../constants/src/auth.ts
 var init_auth = __esm({
   "../constants/src/auth.ts"() {
@@ -67,16 +136,28 @@ var init_system = __esm({
 });
 
 // ../constants/src/timeback.ts
-var TIMEBACK_ROUTES;
-var init_timeback = __esm({
+var TIMEBACK_ROUTES, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
+var init_timeback2 = __esm({
   "../constants/src/timeback.ts"() {
     "use strict";
     TIMEBACK_ROUTES = {
       END_ACTIVITY: "/integrations/timeback/end-activity",
       GET_XP: "/integrations/timeback/xp",
+      GET_MASTERY: "/integrations/timeback/mastery",
       HEARTBEAT: "/integrations/timeback/heartbeat",
       ADVANCE_COURSE: "/integrations/timeback/advance-course"
     };
+    TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
+      xp: 1,
+      mastery: 0,
+      score: 2
+    };
+    TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
+      xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
+      mastery: 0,
+      time: 60,
+      score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
+    };
   }
 });
 
@@ -100,7 +181,7 @@ var init_src = __esm({
     init_game();
     init_platform();
     init_system();
-    init_timeback();
+    init_timeback2();
     init_cloudflare();
   }
 });
@@ -120,6 +201,7 @@ var init_constants = __esm({
       TIMEBACK: {
         END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
         GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
+        GET_MASTERY: `/api${TIMEBACK_ROUTES.GET_MASTERY}`,
         HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`,
         ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`
       }
@@ -212,9 +294,9 @@ var init_routes = __esm({
 // ../edge-play/src/entry/metadata.ts
 function getRuntimeMetadata() {
   return {
-    cliVersion: true ? "0.22.1" : "0.0.0-dev",
-    sdkVersion: true ? "0.10.0" : "0.0.0-dev",
-    buildId: true ? "86c338e2c882" : "dev-source"
+    cliVersion: true ? "0.22.2-beta.2" : "0.0.0-dev",
+    sdkVersion: true ? "0.10.1-beta.2" : "0.0.0-dev",
+    buildId: true ? "9c6fe529d1f4" : "dev-source"
   };
 }
 var init_metadata = __esm({
@@ -364,69 +446,6 @@ var init_errors = __esm({
   }
 });
 
-// ../utils/src/timeback.ts
-function formatGradeLabel(grade) {
-  switch (grade) {
-    case -1: {
-      return "Pre-K";
-    }
-    case 0: {
-      return "Kindergarten";
-    }
-    case 13: {
-      return "AP";
-    }
-    default: {
-      return `Grade ${grade}`;
-    }
-  }
-}
-var init_timeback2 = __esm({
-  "../utils/src/timeback.ts"() {
-  }
-});
-
-// ../edge-play/src/lib/validation.ts
-function isValidGrade2(value) {
-  return typeof value === "number" && Number.isInteger(value) && VALID_GRADES2.includes(value);
-}
-function isValidSubject2(value) {
-  return typeof value === "string" && VALID_SUBJECTS2.includes(value);
-}
-function validateCourseConfig(params) {
-  const { grade, subject, config } = params;
-  const timebackConfig = config.integrations?.timeback;
-  const configuredCourse = timebackConfig?.courses?.find(
-    (course) => course.grade === grade && course.subject === subject
-  );
-  if (!configuredCourse) {
-    const configured = timebackConfig?.courses?.map((c) => `${c.subject} (${formatGradeLabel(c.grade)})`).join(", ");
-    return {
-      error: `Invalid grade/subject combination: ${subject} (${formatGradeLabel(grade)}). Configured courses: ${configured || "none"}`
-    };
-  }
-  return null;
-}
-var VALID_GRADES2, VALID_SUBJECTS2;
-var init_validation = __esm({
-  "../edge-play/src/lib/validation.ts"() {
-    "use strict";
-    init_timeback2();
-    VALID_GRADES2 = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
-    VALID_SUBJECTS2 = [
-      "Reading",
-      "Language",
-      "Vocabulary",
-      "Social Studies",
-      "Writing",
-      "Science",
-      "FastMath",
-      "Math",
-      "None"
-    ];
-  }
-});
-
 // ../edge-play/src/lib/index.ts
 var init_lib = __esm({
   "../edge-play/src/lib/index.ts"() {
@@ -495,12 +514,13 @@ async function POST(c) {
       sessionTimingData,
       xpEarned,
       masteredUnits,
+      masteredUnitsAbsolute,
       extensions
     } = await c.req.json();
     assertTimebackIntegrated(c);
     const config = getConfig(c);
     const structuredActivityData = isActivityDataInput(activityData) ? activityData : void 0;
-    if (structuredActivityData && isValidGrade2(structuredActivityData.grade) && isValidSubject2(structuredActivityData.subject)) {
+    if (structuredActivityData && isValidGrade(structuredActivityData.grade) && isValidSubject(structuredActivityData.subject)) {
       const courseValidationError = validateCourseConfig({
         grade: structuredActivityData.grade,
         subject: structuredActivityData.subject,
@@ -532,6 +552,7 @@ async function POST(c) {
         sessionTimingData,
         xpEarned,
         masteredUnits,
+        masteredUnitsAbsolute,
         extensions
       }
     );
@@ -581,12 +602,12 @@ async function GET3(c) {
       }
       grade = parseInt(gradeParam, 10);
       subject = subjectParam;
-      if (!isValidGrade2(grade)) {
-        const message2 = `grade must be a valid grade level (${VALID_GRADES2.join(", ")})`;
+      if (!isValidGrade(grade)) {
+        const message2 = `grade must be a valid grade level (${VALID_GRADES.join(", ")})`;
         return c.json(buildErrorResponse(c, message2, message2), 400);
       }
-      if (!isValidSubject2(subject)) {
-        const message2 = `subject must be a valid subject (${VALID_SUBJECTS2.join(", ")})`;
+      if (!isValidSubject(subject)) {
+        const message2 = `subject must be a valid subject (${VALID_SUBJECTS.join(", ")})`;
         return c.json(buildErrorResponse(c, message2, message2), 400);
       }
       const courseValidationError = validateCourseConfig({ grade, subject, config });
@@ -617,6 +638,74 @@ var init_get_xp = __esm({
   }
 });
 
+// ../edge-play/src/routes/integrations/timeback/get-mastery.ts
+var get_mastery_exports = {};
+__export(get_mastery_exports, {
+  GET: () => GET4
+});
+async function GET4(c) {
+  try {
+    const user = c.get("playcademyUser");
+    if (!user) {
+      return c.json(buildErrorResponse(c, "Unauthorized", "Unauthorized"), 401);
+    }
+    if (!user.timeback_id) {
+      const message2 = "User does not have TimeBack integration";
+      console.error("[TimeBack Get Mastery] Error:", message2);
+      return c.json(buildErrorResponse(c, message2, message2), 400);
+    }
+    assertTimebackIntegrated(c);
+    const config = getConfig(c);
+    const url = new URL(c.req.url);
+    const gradeParam = url.searchParams.get("grade");
+    const subjectParam = url.searchParams.get("subject");
+    const includeParam = url.searchParams.get("include");
+    const include = includeParam ? includeParam.split(",").map((s) => s.trim()) : void 0;
+    let grade;
+    let subject;
+    if (gradeParam !== null || subjectParam !== null) {
+      if (gradeParam === null || subjectParam === null) {
+        const message2 = "Both grade and subject must be provided together";
+        return c.json(buildErrorResponse(c, message2, message2), 400);
+      }
+      grade = parseInt(gradeParam, 10);
+      subject = subjectParam;
+      if (!isValidGrade(grade)) {
+        const message2 = `grade must be a valid grade level (${VALID_GRADES.join(", ")})`;
+        return c.json(buildErrorResponse(c, message2, message2), 400);
+      }
+      if (!isValidSubject(subject)) {
+        const message2 = `subject must be a valid subject (${VALID_SUBJECTS.join(", ")})`;
+        return c.json(buildErrorResponse(c, message2, message2), 400);
+      }
+      const courseValidationError = validateCourseConfig({ grade, subject, config });
+      if (courseValidationError) {
+        return c.json(
+          buildErrorResponse(c, courseValidationError.error, courseValidationError.error),
+          400
+        );
+      }
+    }
+    const sdk = c.get("sdk");
+    const result = await sdk.timeback.getStudentMastery(user.timeback_id, {
+      grade,
+      subject,
+      include
+    });
+    return c.json(result);
+  } catch (error) {
+    logError("TimeBack Get Mastery", error);
+    return c.json(buildErrorResponse(c, error, "Failed to get mastery"), getErrorStatus(error));
+  }
+}
+var init_get_mastery = __esm({
+  "../edge-play/src/routes/integrations/timeback/get-mastery.ts"() {
+    "use strict";
+    init_lib();
+    init_shared();
+  }
+});
+
 // ../edge-play/src/routes/integrations/timeback/heartbeat.ts
 var heartbeat_exports = {};
 __export(heartbeat_exports, {
@@ -652,7 +741,7 @@ async function POST2(c) {
     assertTimebackIntegrated(c);
     const config = getConfig(c);
     const structuredActivityData = isActivityDataInput(activityData) ? activityData : void 0;
-    if (structuredActivityData && isValidGrade2(structuredActivityData.grade) && isValidSubject2(structuredActivityData.subject)) {
+    if (structuredActivityData && isValidGrade(structuredActivityData.grade) && isValidSubject(structuredActivityData.subject)) {
       const courseValidationError = validateCourseConfig({
         grade: structuredActivityData.grade,
         subject: structuredActivityData.subject,
@@ -716,7 +805,7 @@ async function POST3(c) {
     }
     const body = await c.req.json().catch(() => ({}));
     const subject = body.subject;
-    if (subject !== void 0 && !isValidSubject2(subject)) {
+    if (subject !== void 0 && !isValidSubject(subject)) {
       const message2 = "Invalid subject: must be one of the supported TimeBack subjects";
       console.error("[TimeBack Advance] Error:", message2);
       return c.json(buildErrorResponse(c, message2, message2), 400);
@@ -3484,22 +3573,10 @@ function createLocalJWKSet(jwks) {
   return localJWKSet;
 }
 
-// ../edge-play/src/entry/metrics.ts
+// ../edge-play/src/lib/jwt.ts
 var SERVICE_JWT_ISSUER = "playcademy-platform";
 var SERVICE_JWT_AUDIENCE = "playcademy-game-metrics";
 var SERVICE_JWT_CLOCK_TOLERANCE = "10s";
-var TIMEBACK_GRADES = /* @__PURE__ */ new Set([-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13]);
-var TIMEBACK_SUBJECTS = /* @__PURE__ */ new Set([
-  "Reading",
-  "Language",
-  "Vocabulary",
-  "Social Studies",
-  "Writing",
-  "Science",
-  "FastMath",
-  "Math",
-  "None"
-]);
 function getBearerToken(c) {
   const header = c.req.header("Authorization");
   if (!header?.startsWith("Bearer ")) {
@@ -3594,22 +3671,24 @@ async function verifyMetricsToken(c) {
     return null;
   }
 }
-function isNonNegativeNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0;
-}
-function isNonNegativeInteger(value) {
-  return isNonNegativeNumber(value) && Number.isInteger(value);
-}
-function isIsoDateString(value) {
-  return typeof value === "string" && !Number.isNaN(Date.parse(value));
+
+// ../utils/src/uuid.ts
+var UUID_REGEX = /^[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}$/;
+function isValidUUID(value) {
+  if (!value || typeof value !== "string") {
+    return false;
+  }
+  return UUID_REGEX.test(value);
 }
-function isValidActivity(value) {
+
+// ../edge-play/src/lib/metrics.ts
+init_validation();
+function isValidRunMetrics(value) {
   if (!value || typeof value !== "object") {
     return false;
   }
   const activity = value;
-  const completionCount = activity.completionCount;
-  return typeof activity.activityId === "string" && activity.activityId.length > 0 && (activity.activityName === void 0 || typeof activity.activityName === "string") && isNonNegativeNumber(activity.totalXp) && isNonNegativeInteger(activity.masteredUnits) && isNonNegativeNumber(activity.activeTimeSeconds) && Number.isInteger(completionCount) && typeof completionCount === "number" && completionCount >= 0 && (activity.lastCompletedAt === void 0 || isIsoDateString(activity.lastCompletedAt));
+  return typeof activity.runId === "string" && isValidUUID(activity.runId) && typeof activity.activityId === "string" && activity.activityId.length > 0 && (activity.activityName === void 0 || typeof activity.activityName === "string") && (activity.totalXp === void 0 || isNonNegativeNumber(activity.totalXp)) && (activity.masteredUnits === void 0 || isNonNegativeInteger(activity.masteredUnits)) && (activity.activeTimeSeconds === void 0 || isNonNegativeNumber(activity.activeTimeSeconds)) && (activity.score === void 0 || isNonNegativeNumber(activity.score) && activity.score <= 100);
 }
 function isValidGameMetricsResponse(value) {
   if (!value || typeof value !== "object") {
@@ -3626,9 +3705,15 @@ function isValidGameMetricsResponse(value) {
     }
     const metrics = course;
     const activities = metrics.activities;
-    return TIMEBACK_GRADES.has(metrics.grade) && TIMEBACK_SUBJECTS.has(metrics.subject) && isNonNegativeNumber(metrics.totalXp) && isNonNegativeInteger(metrics.masteredUnits) && isNonNegativeNumber(metrics.activeTimeSeconds) && (activities === void 0 || Array.isArray(activities) && activities.every(isValidActivity));
+    return isValidGrade(metrics.grade) && isValidSubject(metrics.subject) && (metrics.totalXp === void 0 || isNonNegativeNumber(metrics.totalXp)) && (metrics.masteredUnits === void 0 || isNonNegativeInteger(metrics.masteredUnits)) && (metrics.activeTimeSeconds === void 0 || isNonNegativeNumber(metrics.activeTimeSeconds)) && (activities === void 0 || Array.isArray(activities) && activities.every(isValidRunMetrics));
   });
 }
+function getRequestedRunIds(request) {
+  const runIds = new URL(request.url).searchParams.getAll("runId").filter((runId) => isValidUUID(runId));
+  return [...new Set(runIds)];
+}
+
+// ../edge-play/src/entry/metrics.ts
 function registerMetricsRoute(app, metricsModule) {
   app.get("/__playcademy/metrics", async (c) => {
     const claims = await verifyMetricsToken(c);
@@ -3645,6 +3730,7 @@ function registerMetricsRoute(app, metricsModule) {
     try {
       metrics = await metricsModule.getMetrics({
         studentId: claims.studentId,
+        runIds: getRequestedRunIds(c.req.raw),
         env: c.env,
         sdk: c.get("sdk"),
         request: c.req.raw,
@@ -3746,8 +3832,8 @@ var cors = (options) => {
 };
 
 // ../sdk/src/core/guards.ts
-var VALID_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
-var VALID_SUBJECTS = [
+var VALID_GRADES2 = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
+var VALID_SUBJECTS2 = [
   "Reading",
   "Language",
   "Vocabulary",
@@ -3758,11 +3844,11 @@ var VALID_SUBJECTS = [
   "Math",
   "None"
 ];
-function isValidGrade(value) {
-  return typeof value === "number" && Number.isInteger(value) && VALID_GRADES.includes(value);
+function isValidGrade2(value) {
+  return typeof value === "number" && Number.isInteger(value) && VALID_GRADES2.includes(value);
 }
-function isValidSubject(value) {
-  return typeof value === "string" && VALID_SUBJECTS.includes(value);
+function isValidSubject2(value) {
+  return typeof value === "string" && VALID_SUBJECTS2.includes(value);
 }
 
 // ../sdk/src/server/namespaces/timeback.ts
@@ -3820,10 +3906,10 @@ function createTimebackNamespace(client) {
      * ```
      */
     endActivity: async (studentId, payload) => {
-      if (!isValidGrade(payload.activityData.grade)) {
+      if (!isValidGrade2(payload.activityData.grade)) {
         throw new Error("activityData.grade must be a valid grade level (-1 to 13)");
       }
-      if (!isValidSubject(payload.activityData.subject)) {
+      if (!isValidSubject2(payload.activityData.subject)) {
         throw new Error("activityData.subject must be a valid subject");
       }
       const enrichedActivityData = enrichActivityData2(payload.activityData);
@@ -3879,14 +3965,14 @@ function createTimebackNamespace(client) {
       if (hasGrade !== hasSubject) {
         throw new Error("Both grade and subject must be provided together");
       }
-      if (hasGrade && !isValidGrade(options.grade)) {
+      if (hasGrade && !isValidGrade2(options.grade)) {
         throw new Error(
-          `Invalid grade: ${options.grade}. Valid grades: ${VALID_GRADES.join(", ")}`
+          `Invalid grade: ${options.grade}. Valid grades: ${VALID_GRADES2.join(", ")}`
         );
       }
-      if (hasSubject && !isValidSubject(options.subject)) {
+      if (hasSubject && !isValidSubject2(options.subject)) {
         throw new Error(
-          `Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS.join(", ")}`
+          `Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS2.join(", ")}`
         );
       }
       const params = new URLSearchParams();
@@ -3903,6 +3989,37 @@ function createTimebackNamespace(client) {
       const queryString = params.toString();
       const endpoint = `/api/timeback/student-xp/${studentId}?${queryString}`;
       return client["request"](endpoint, "GET");
+    },
+    getStudentMastery: async (studentId, options) => {
+      const hasGrade = options?.grade !== void 0;
+      const hasSubject = options?.subject !== void 0;
+      if (hasGrade !== hasSubject) {
+        throw new Error("Both grade and subject must be provided together");
+      }
+      if (hasGrade && !isValidGrade2(options.grade)) {
+        throw new Error(
+          `Invalid grade: ${options.grade}. Valid grades: ${VALID_GRADES2.join(", ")}`
+        );
+      }
+      if (hasSubject && !isValidSubject2(options.subject)) {
+        throw new Error(
+          `Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS2.join(", ")}`
+        );
+      }
+      const params = new URLSearchParams();
+      params.set("gameId", client.gameId);
+      if (options?.grade !== void 0) {
+        params.set("grade", String(options.grade));
+      }
+      if (options?.subject) {
+        params.set("subject", options.subject);
+      }
+      if (options?.include?.length) {
+        params.set("include", options.include.join(","));
+      }
+      const queryString = params.toString();
+      const endpoint = `/api/timeback/student-mastery/${studentId}?${queryString}`;
+      return client["request"](endpoint, "GET");
     }
   };
 }
@@ -4499,14 +4616,16 @@ async function registerBuiltinRoutes(app, integrations) {
   const health = await Promise.resolve().then(() => (init_health(), health_exports));
   app.get(ROUTES.HEALTH, health.GET);
   if (integrations?.timeback) {
-    const [endActivity, getXp, heartbeat, advanceCourse] = await Promise.all([
+    const [endActivity, getXp, getMastery, heartbeat, advanceCourse] = await Promise.all([
       Promise.resolve().then(() => (init_end_activity(), end_activity_exports)),
       Promise.resolve().then(() => (init_get_xp(), get_xp_exports)),
+      Promise.resolve().then(() => (init_get_mastery(), get_mastery_exports)),
       Promise.resolve().then(() => (init_heartbeat(), heartbeat_exports)),
       Promise.resolve().then(() => (init_advance_course(), advance_course_exports))
     ]);
     app.post(ROUTES.TIMEBACK.END_ACTIVITY, endActivity.POST);
     app.get(ROUTES.TIMEBACK.GET_XP, getXp.GET);
+    app.get(ROUTES.TIMEBACK.GET_MASTERY, getMastery.GET);
     app.post(ROUTES.TIMEBACK.HEARTBEAT, heartbeat.POST);
     app.post(ROUTES.TIMEBACK.ADVANCE_COURSE, advanceCourse.POST);
   } else if (integrations?.timeback === null) {
@@ -4525,6 +4644,14 @@ async function registerBuiltinRoutes(app, integrations) {
         __playcademyDevWarning: "timeback-not-configured"
       })
     );
+    app.get(
+      "/api/integrations/timeback/mastery",
+      async (c) => c.json({
+        totalMasteredUnits: 0,
+        totalMasterableUnits: 0,
+        __playcademyDevWarning: "timeback-not-configured"
+      })
+    );
     app.post(
       "/api/integrations/timeback/heartbeat",
       async (c) => c.json({

package/dist/runtime/backend-runtime/manifest.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "0.22.1",
-  "sdkVersion": "0.10.0",
-  "runtimeBuildId": "86c338e2c882",
-  "inputFingerprint": "86c338e2c88222a4d95079601c19768a92c2bc085711d714d53c54b3aec80831",
+  "cliVersion": "0.22.2-beta.2",
+  "sdkVersion": "0.10.1-beta.2",
+  "runtimeBuildId": "9c6fe529d1f4",
+  "inputFingerprint": "9c6fe529d1f48ee9088ace05896b75194ea23409008e5aa76a5d927ab95a919d",
   "entry": "index.js"
 }

package/dist/templates/playcademy-env.d.ts.template

@@ -41,6 +41,7 @@ declare global {
 
     interface MetricsResolverContext {
         studentId: string
+        runIds: string[]
         env: PlaycademyEnv
     }
 }

package/dist/utils.js

@@ -305,9 +305,21 @@ import { dirname as dirname3, resolve as resolve3 } from "path";
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
   GET_XP: "/integrations/timeback/xp",
+  GET_MASTERY: "/integrations/timeback/mastery",
   HEARTBEAT: "/integrations/timeback/heartbeat",
   ADVANCE_COURSE: "/integrations/timeback/advance-course"
 };
+var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
+  xp: 1,
+  mastery: 0,
+  score: 2
+};
+var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
+  xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
+  mastery: 0,
+  time: 60,
+  score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
+};
 
 // ../constants/src/cloudflare.ts
 var WORKER_NAMING = {
@@ -345,7 +357,7 @@ var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.14",
+  version: "0.0.15-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -1830,6 +1842,7 @@ var ROUTES = {
   TIMEBACK: {
     END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
     GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
+    GET_MASTERY: `/api${TIMEBACK_ROUTES.GET_MASTERY}`,
     HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`,
     ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`
   }
@@ -2455,7 +2468,7 @@ import { existsSync as existsSync9, mkdirSync as mkdirSync2, writeFileSync as wr
 import { dirname as dirname4, join as join14 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.22.1";
+var cliVersion = false ? "0.0.0-dev" : "0.22.2-beta.2";
 
 // src/lib/build/binary-resource.ts
 function writeFileTree(baseDir, files) {

package/dist/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.22.1";
+var cliVersion = false ? "0.0.0-dev" : "0.22.2-beta.2";
 export {
   cliVersion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.22.1",
+    "version": "0.22.2-beta.2",
     "type": "module",
     "exports": {
         ".": {