@playcademy/sandbox 0.4.1 → 0.4.2-beta.1

package/dist/cli.js

@@ -250,7 +250,8 @@ var init_timeback2 = __esm(() => {
     GET_XP: "/integrations/timeback/xp",
     GET_MASTERY: "/integrations/timeback/mastery",
     HEARTBEAT: "/integrations/timeback/heartbeat",
-    ADVANCE_COURSE: "/integrations/timeback/advance-course"
+    ADVANCE_COURSE: "/integrations/timeback/advance-course",
+    UNENROLL_COURSE: "/integrations/timeback/unenroll-course"
   };
   TIMEBACK_COURSE_DEFAULTS = {
     gradingScheme: "STANDARD",
@@ -1076,7 +1077,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.4.1",
+    version: "0.4.2-beta.1",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -28248,7 +28249,8 @@ var init_constants3 = __esm(() => {
       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}`
+      ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`,
+      UNENROLL_COURSE: `/api${TIMEBACK_ROUTES.UNENROLL_COURSE}`
     }
   };
 });
@@ -29902,7 +29904,7 @@ function isValidAdminAttributionDate(value) {
   const date3 = new Date(Date.UTC(year, month - 1, day, 12, 0, 0));
   return date3.getUTCFullYear() === year && date3.getUTCMonth() + 1 === month && date3.getUTCDate() === day;
 }
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS4, TimebackGradeSchema, TimebackSubjectSchema, CourseGoalsSchema, UpdateGameTimebackIntegrationRequestSchema, TimebackActivityDataSchema, EndActivityRequestSchema, GameRunMetricsSchema, GameCourseMetricsSchema, GameMetricsResponseSchema, AdvanceCourseRequestSchema, HeartbeatRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, AdminAttributionDateSchema, ADMIN_GRANT_XP_MIN = -1e5, ADMIN_GRANT_XP_MAX = 1e5, ADMIN_GRANT_XP_AMOUNT_RANGE_MESSAGE, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ReconcileMasteryForConfigChangeSchema, EnrollStudentRequestSchema, UnenrollStudentRequestSchema, ReactivateEnrollmentRequestSchema, InsertAssessmentTestSchema, CreateAssessmentRequestSchema, ReorderAssessmentsRequestSchema, ReorderQuestionsRequestSchema;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS4, TimebackGradeSchema, TimebackSubjectSchema, CourseGoalsSchema, UpdateGameTimebackIntegrationRequestSchema, TimebackActivityDataSchema, EndActivityRequestSchema, GameRunMetricsSchema, GameCourseMetricsSchema, GameMetricsResponseSchema, AdvanceCourseRequestSchema, UnenrollCourseRequestSchema, HeartbeatRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, AdminAttributionDateSchema, ADMIN_GRANT_XP_MIN = -1e5, ADMIN_GRANT_XP_MAX = 1e5, ADMIN_GRANT_XP_AMOUNT_RANGE_MESSAGE, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ReconcileMasteryForConfigChangeSchema, EnrollStudentRequestSchema, UnenrollStudentRequestSchema, ReactivateEnrollmentRequestSchema, InsertAssessmentTestSchema, CreateAssessmentRequestSchema, ReorderAssessmentsRequestSchema, ReorderQuestionsRequestSchema;
 var init_schemas4 = __esm(() => {
   init_drizzle_zod();
   init_esm();
@@ -30004,6 +30006,12 @@ var init_schemas4 = __esm(() => {
     studentId: exports_external.string().min(1),
     subject: TimebackSubjectSchema.optional()
   });
+  UnenrollCourseRequestSchema = exports_external.object({
+    gameId: exports_external.string().uuid(),
+    studentId: exports_external.string().min(1),
+    subject: TimebackSubjectSchema.optional(),
+    force: exports_external.boolean().optional()
+  });
   HeartbeatRequestSchema = exports_external.object({
     gameId: exports_external.string().uuid(),
     studentId: exports_external.string().min(1),
@@ -33208,15 +33216,14 @@ var init_timeback_service = __esm(() => {
         inProgress: result.inProgress
       };
     }
-    async advanceCourse({
+    async resolveActiveGameCourse({
       gameId,
       studentId,
       subject,
-      user
+      action
     }) {
       const client = this.requireClient();
       const db2 = this.deps.db;
-      await this.deps.validateDeveloperAccess(user, gameId);
       const integrations = await db2.query.gameTimebackIntegrations.findMany({
         where: subject ? and(eq(gameTimebackIntegrations.gameId, gameId), eq(gameTimebackIntegrations.subject, subject)) : eq(gameTimebackIntegrations.gameId, gameId)
       });
@@ -33231,12 +33238,30 @@ var init_timeback_service = __esm(() => {
       }
       const subjectsInPlay = new Set(enrolledIntegrations.map((i2) => i2.subject));
       if (subjectsInPlay.size > 1) {
-        throw new ValidationError(`Ambiguous Timeback advance: student is enrolled in ${subjectsInPlay.size} parallel ladders (${[...subjectsInPlay].join(", ")}); pass { subject } to disambiguate`);
+        throw new ValidationError(`Ambiguous Timeback ${action}: student is enrolled in ${subjectsInPlay.size} parallel ladders (${[...subjectsInPlay].join(", ")}); pass { subject } to disambiguate`);
       }
       const currentIntegration = enrolledIntegrations.toSorted((left, right) => left.grade - right.grade)[0];
+      const currentEnrollment = enrollments.find((enrollment) => enrollment.course.id === currentIntegration.courseId);
+      return { currentIntegration, currentEnrollment, enrollments };
+    }
+    async advanceCourse({
+      gameId,
+      studentId,
+      subject,
+      user
+    }) {
+      const client = this.requireClient();
+      const db2 = this.deps.db;
+      await this.deps.validateDeveloperAccess(user, gameId);
+      const { currentIntegration, enrollments } = await this.resolveActiveGameCourse({
+        gameId,
+        studentId,
+        subject,
+        action: "advance"
+      });
       const masteryStatus = await client.getMasteryStatus(currentIntegration.courseId, studentId);
       if (!masteryStatus) {
-        throw new ValidationError(`Cannot advance course: mastery status is unavailable for course ${currentIntegration.courseId}. Ensure the course has mastery configuration and the student has enrollment analytics before calling client.timeback.advanceCourse().`);
+        throw new ValidationError(`Cannot advance course: mastery status is unavailable for course ${currentIntegration.courseId}. Ensure the course has mastery configuration and the student has enrollment analytics before calling client.timeback.course.advance().`);
       }
       if (!masteryStatus.isComplete) {
         const promotion2 = {
@@ -33274,6 +33299,93 @@ var init_timeback_service = __esm(() => {
       });
       return { status: "ok", promotion };
     }
+    async unenrollCourse({
+      gameId,
+      studentId,
+      subject,
+      force,
+      user
+    }) {
+      const client = this.requireClient();
+      await this.deps.validateDeveloperAccess(user, gameId);
+      const { currentIntegration, currentEnrollment } = await this.resolveActiveGameCourse({
+        gameId,
+        studentId,
+        subject,
+        action: "unenroll"
+      });
+      const schoolId = currentEnrollment.school.id;
+      const masteryStatus = await client.getMasteryStatus(currentIntegration.courseId, studentId);
+      if (!masteryStatus && !force) {
+        throw new ValidationError(`Cannot unenroll course: mastery status is unavailable for course ${currentIntegration.courseId}. Pass { force: true } to unenroll without mastery data.`);
+      }
+      if (masteryStatus && !masteryStatus.isComplete && !force) {
+        const unenrollment = {
+          status: "not-mastered",
+          currentCourseId: currentIntegration.courseId,
+          masteredUnits: masteryStatus.masteredUnits,
+          masterableUnits: masteryStatus.masterableUnits
+        };
+        logger20.debug("Skipping game-initiated course unenroll because mastery is incomplete", {
+          event: "timeback.course.unenroll",
+          outcome: "not-mastered",
+          gameId,
+          studentId,
+          courseId: currentIntegration.courseId,
+          subject: currentIntegration.subject,
+          grade: currentIntegration.grade,
+          masteredUnits: masteryStatus.masteredUnits,
+          masterableUnits: masteryStatus.masterableUnits,
+          forced: false,
+          requesterUserId: user.id
+        });
+        return { status: "ok", unenrollment };
+      }
+      const forcedEarlyExit = Boolean(force && (!masteryStatus || !masteryStatus.isComplete));
+      if (forcedEarlyExit) {
+        logger20.warn("Force-unenrolled student before mastery completion", {
+          event: "timeback.course.unenroll",
+          outcome: "force-unenrolled",
+          gameId,
+          studentId,
+          courseId: currentIntegration.courseId,
+          subject: currentIntegration.subject,
+          grade: currentIntegration.grade,
+          masteredUnits: masteryStatus?.masteredUnits,
+          masterableUnits: masteryStatus?.masterableUnits,
+          masteryStatusAvailable: Boolean(masteryStatus),
+          forced: true,
+          requesterUserId: user.id
+        });
+      }
+      await client.edubridge.enrollments.unenroll(studentId, currentIntegration.courseId, schoolId ? { schoolId } : {});
+      client.invalidateEnrollments(studentId);
+      logger20.info("Game-initiated course unenroll completed", {
+        event: "timeback.course.unenroll",
+        outcome: "unenrolled",
+        gameId,
+        studentId,
+        courseId: currentIntegration.courseId,
+        subject: currentIntegration.subject,
+        grade: currentIntegration.grade,
+        masteredUnits: masteryStatus?.masteredUnits,
+        masterableUnits: masteryStatus?.masterableUnits,
+        forced: forcedEarlyExit,
+        requesterUserId: user.id
+      });
+      return {
+        status: "ok",
+        unenrollment: {
+          status: "unenrolled",
+          currentCourseId: currentIntegration.courseId,
+          ...masteryStatus ? {
+            masteredUnits: masteryStatus.masteredUnits,
+            masterableUnits: masteryStatus.masterableUnits
+          } : {},
+          ...forcedEarlyExit ? { forced: true } : {}
+        }
+      };
+    }
     async recordHeartbeat({
       gameId,
       studentId,
@@ -94085,7 +94197,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, 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, 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();
@@ -94323,6 +94435,20 @@ var init_timeback_controller = __esm(() => {
       user: ctx.user
     });
   });
+  unenrollCourse = requireDeveloper(async (ctx) => {
+    const body2 = await parseRequestBody(ctx.request, UnenrollCourseRequestSchema);
+    logger45.debug("Unenrolling student from current course", {
+      userId: ctx.user.id,
+      gameId: body2.gameId,
+      studentId: body2.studentId,
+      subject: body2.subject,
+      force: body2.force
+    });
+    return ctx.services.timeback.unenrollCourse({
+      ...body2,
+      user: ctx.user
+    });
+  });
   getStudentXp = requireDeveloper(async (ctx) => {
     const timebackId = ctx.params.timebackId;
     if (!timebackId) {
@@ -94750,6 +94876,7 @@ var init_timeback_controller = __esm(() => {
     endActivity,
     heartbeat,
     advanceCourse,
+    unenrollCourse,
     getStudentXp,
     getStudentMastery,
     getRoster,
@@ -95654,6 +95781,7 @@ var init_timeback6 = __esm(() => {
   timebackRouter.post("/end-activity", handle2(timeback2.endActivity));
   timebackRouter.post("/heartbeat", handle2(timeback2.heartbeat));
   timebackRouter.post("/advance-course", handle2(timeback2.advanceCourse));
+  timebackRouter.post("/unenroll-course", handle2(timeback2.unenrollCourse));
   timebackRouter.get("/user", async (c2) => {
     const user = c2.get("user");
     const gameId = c2.get("gameId");

package/dist/constants.js

@@ -85,7 +85,8 @@ var init_timeback = __esm(() => {
     GET_XP: "/integrations/timeback/xp",
     GET_MASTERY: "/integrations/timeback/mastery",
     HEARTBEAT: "/integrations/timeback/heartbeat",
-    ADVANCE_COURSE: "/integrations/timeback/advance-course"
+    ADVANCE_COURSE: "/integrations/timeback/advance-course",
+    UNENROLL_COURSE: "/integrations/timeback/unenroll-course"
   };
   TIMEBACK_COURSE_DEFAULTS = {
     gradingScheme: "STANDARD",

package/dist/server.js

@@ -249,7 +249,8 @@ var init_timeback2 = __esm(() => {
     GET_XP: "/integrations/timeback/xp",
     GET_MASTERY: "/integrations/timeback/mastery",
     HEARTBEAT: "/integrations/timeback/heartbeat",
-    ADVANCE_COURSE: "/integrations/timeback/advance-course"
+    ADVANCE_COURSE: "/integrations/timeback/advance-course",
+    UNENROLL_COURSE: "/integrations/timeback/unenroll-course"
   };
   TIMEBACK_COURSE_DEFAULTS = {
     gradingScheme: "STANDARD",
@@ -1075,7 +1076,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.4.1",
+    version: "0.4.2-beta.1",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -28247,7 +28248,8 @@ var init_constants3 = __esm(() => {
       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}`
+      ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`,
+      UNENROLL_COURSE: `/api${TIMEBACK_ROUTES.UNENROLL_COURSE}`
     }
   };
 });
@@ -29901,7 +29903,7 @@ function isValidAdminAttributionDate(value) {
   const date3 = new Date(Date.UTC(year, month - 1, day, 12, 0, 0));
   return date3.getUTCFullYear() === year && date3.getUTCMonth() + 1 === month && date3.getUTCDate() === day;
 }
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS4, TimebackGradeSchema, TimebackSubjectSchema, CourseGoalsSchema, UpdateGameTimebackIntegrationRequestSchema, TimebackActivityDataSchema, EndActivityRequestSchema, GameRunMetricsSchema, GameCourseMetricsSchema, GameMetricsResponseSchema, AdvanceCourseRequestSchema, HeartbeatRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, AdminAttributionDateSchema, ADMIN_GRANT_XP_MIN = -1e5, ADMIN_GRANT_XP_MAX = 1e5, ADMIN_GRANT_XP_AMOUNT_RANGE_MESSAGE, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ReconcileMasteryForConfigChangeSchema, EnrollStudentRequestSchema, UnenrollStudentRequestSchema, ReactivateEnrollmentRequestSchema, InsertAssessmentTestSchema, CreateAssessmentRequestSchema, ReorderAssessmentsRequestSchema, ReorderQuestionsRequestSchema;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS4, TimebackGradeSchema, TimebackSubjectSchema, CourseGoalsSchema, UpdateGameTimebackIntegrationRequestSchema, TimebackActivityDataSchema, EndActivityRequestSchema, GameRunMetricsSchema, GameCourseMetricsSchema, GameMetricsResponseSchema, AdvanceCourseRequestSchema, UnenrollCourseRequestSchema, HeartbeatRequestSchema, PopulateStudentRequestSchema, DerivedPlatformCourseConfigSchema, TimebackBaseConfigSchema, PlatformTimebackSetupRequestSchema, AdminTimebackMutationBaseSchema, AdminAttributionDateSchema, ADMIN_GRANT_XP_MIN = -1e5, ADMIN_GRANT_XP_MAX = 1e5, ADMIN_GRANT_XP_AMOUNT_RANGE_MESSAGE, GrantTimebackXpRequestSchema, AdjustTimebackTimeRequestSchema, AdjustTimebackMasteryRequestSchema, ReconcileMasteryForConfigChangeSchema, EnrollStudentRequestSchema, UnenrollStudentRequestSchema, ReactivateEnrollmentRequestSchema, InsertAssessmentTestSchema, CreateAssessmentRequestSchema, ReorderAssessmentsRequestSchema, ReorderQuestionsRequestSchema;
 var init_schemas4 = __esm(() => {
   init_drizzle_zod();
   init_esm();
@@ -30003,6 +30005,12 @@ var init_schemas4 = __esm(() => {
     studentId: exports_external.string().min(1),
     subject: TimebackSubjectSchema.optional()
   });
+  UnenrollCourseRequestSchema = exports_external.object({
+    gameId: exports_external.string().uuid(),
+    studentId: exports_external.string().min(1),
+    subject: TimebackSubjectSchema.optional(),
+    force: exports_external.boolean().optional()
+  });
   HeartbeatRequestSchema = exports_external.object({
     gameId: exports_external.string().uuid(),
     studentId: exports_external.string().min(1),
@@ -33207,15 +33215,14 @@ var init_timeback_service = __esm(() => {
         inProgress: result.inProgress
       };
     }
-    async advanceCourse({
+    async resolveActiveGameCourse({
       gameId,
       studentId,
       subject,
-      user
+      action
     }) {
       const client = this.requireClient();
       const db2 = this.deps.db;
-      await this.deps.validateDeveloperAccess(user, gameId);
       const integrations = await db2.query.gameTimebackIntegrations.findMany({
         where: subject ? and(eq(gameTimebackIntegrations.gameId, gameId), eq(gameTimebackIntegrations.subject, subject)) : eq(gameTimebackIntegrations.gameId, gameId)
       });
@@ -33230,12 +33237,30 @@ var init_timeback_service = __esm(() => {
       }
       const subjectsInPlay = new Set(enrolledIntegrations.map((i2) => i2.subject));
       if (subjectsInPlay.size > 1) {
-        throw new ValidationError(`Ambiguous Timeback advance: student is enrolled in ${subjectsInPlay.size} parallel ladders (${[...subjectsInPlay].join(", ")}); pass { subject } to disambiguate`);
+        throw new ValidationError(`Ambiguous Timeback ${action}: student is enrolled in ${subjectsInPlay.size} parallel ladders (${[...subjectsInPlay].join(", ")}); pass { subject } to disambiguate`);
       }
       const currentIntegration = enrolledIntegrations.toSorted((left, right) => left.grade - right.grade)[0];
+      const currentEnrollment = enrollments.find((enrollment) => enrollment.course.id === currentIntegration.courseId);
+      return { currentIntegration, currentEnrollment, enrollments };
+    }
+    async advanceCourse({
+      gameId,
+      studentId,
+      subject,
+      user
+    }) {
+      const client = this.requireClient();
+      const db2 = this.deps.db;
+      await this.deps.validateDeveloperAccess(user, gameId);
+      const { currentIntegration, enrollments } = await this.resolveActiveGameCourse({
+        gameId,
+        studentId,
+        subject,
+        action: "advance"
+      });
       const masteryStatus = await client.getMasteryStatus(currentIntegration.courseId, studentId);
       if (!masteryStatus) {
-        throw new ValidationError(`Cannot advance course: mastery status is unavailable for course ${currentIntegration.courseId}. Ensure the course has mastery configuration and the student has enrollment analytics before calling client.timeback.advanceCourse().`);
+        throw new ValidationError(`Cannot advance course: mastery status is unavailable for course ${currentIntegration.courseId}. Ensure the course has mastery configuration and the student has enrollment analytics before calling client.timeback.course.advance().`);
       }
       if (!masteryStatus.isComplete) {
         const promotion2 = {
@@ -33273,6 +33298,93 @@ var init_timeback_service = __esm(() => {
       });
       return { status: "ok", promotion };
     }
+    async unenrollCourse({
+      gameId,
+      studentId,
+      subject,
+      force,
+      user
+    }) {
+      const client = this.requireClient();
+      await this.deps.validateDeveloperAccess(user, gameId);
+      const { currentIntegration, currentEnrollment } = await this.resolveActiveGameCourse({
+        gameId,
+        studentId,
+        subject,
+        action: "unenroll"
+      });
+      const schoolId = currentEnrollment.school.id;
+      const masteryStatus = await client.getMasteryStatus(currentIntegration.courseId, studentId);
+      if (!masteryStatus && !force) {
+        throw new ValidationError(`Cannot unenroll course: mastery status is unavailable for course ${currentIntegration.courseId}. Pass { force: true } to unenroll without mastery data.`);
+      }
+      if (masteryStatus && !masteryStatus.isComplete && !force) {
+        const unenrollment = {
+          status: "not-mastered",
+          currentCourseId: currentIntegration.courseId,
+          masteredUnits: masteryStatus.masteredUnits,
+          masterableUnits: masteryStatus.masterableUnits
+        };
+        logger20.debug("Skipping game-initiated course unenroll because mastery is incomplete", {
+          event: "timeback.course.unenroll",
+          outcome: "not-mastered",
+          gameId,
+          studentId,
+          courseId: currentIntegration.courseId,
+          subject: currentIntegration.subject,
+          grade: currentIntegration.grade,
+          masteredUnits: masteryStatus.masteredUnits,
+          masterableUnits: masteryStatus.masterableUnits,
+          forced: false,
+          requesterUserId: user.id
+        });
+        return { status: "ok", unenrollment };
+      }
+      const forcedEarlyExit = Boolean(force && (!masteryStatus || !masteryStatus.isComplete));
+      if (forcedEarlyExit) {
+        logger20.warn("Force-unenrolled student before mastery completion", {
+          event: "timeback.course.unenroll",
+          outcome: "force-unenrolled",
+          gameId,
+          studentId,
+          courseId: currentIntegration.courseId,
+          subject: currentIntegration.subject,
+          grade: currentIntegration.grade,
+          masteredUnits: masteryStatus?.masteredUnits,
+          masterableUnits: masteryStatus?.masterableUnits,
+          masteryStatusAvailable: Boolean(masteryStatus),
+          forced: true,
+          requesterUserId: user.id
+        });
+      }
+      await client.edubridge.enrollments.unenroll(studentId, currentIntegration.courseId, schoolId ? { schoolId } : {});
+      client.invalidateEnrollments(studentId);
+      logger20.info("Game-initiated course unenroll completed", {
+        event: "timeback.course.unenroll",
+        outcome: "unenrolled",
+        gameId,
+        studentId,
+        courseId: currentIntegration.courseId,
+        subject: currentIntegration.subject,
+        grade: currentIntegration.grade,
+        masteredUnits: masteryStatus?.masteredUnits,
+        masterableUnits: masteryStatus?.masterableUnits,
+        forced: forcedEarlyExit,
+        requesterUserId: user.id
+      });
+      return {
+        status: "ok",
+        unenrollment: {
+          status: "unenrolled",
+          currentCourseId: currentIntegration.courseId,
+          ...masteryStatus ? {
+            masteredUnits: masteryStatus.masteredUnits,
+            masterableUnits: masteryStatus.masterableUnits
+          } : {},
+          ...forcedEarlyExit ? { forced: true } : {}
+        }
+      };
+    }
     async recordHeartbeat({
       gameId,
       studentId,
@@ -94084,7 +94196,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, 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, 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();
@@ -94322,6 +94434,20 @@ var init_timeback_controller = __esm(() => {
       user: ctx.user
     });
   });
+  unenrollCourse = requireDeveloper(async (ctx) => {
+    const body2 = await parseRequestBody(ctx.request, UnenrollCourseRequestSchema);
+    logger45.debug("Unenrolling student from current course", {
+      userId: ctx.user.id,
+      gameId: body2.gameId,
+      studentId: body2.studentId,
+      subject: body2.subject,
+      force: body2.force
+    });
+    return ctx.services.timeback.unenrollCourse({
+      ...body2,
+      user: ctx.user
+    });
+  });
   getStudentXp = requireDeveloper(async (ctx) => {
     const timebackId = ctx.params.timebackId;
     if (!timebackId) {
@@ -94749,6 +94875,7 @@ var init_timeback_controller = __esm(() => {
     endActivity,
     heartbeat,
     advanceCourse,
+    unenrollCourse,
     getStudentXp,
     getStudentMastery,
     getRoster,
@@ -95653,6 +95780,7 @@ var init_timeback6 = __esm(() => {
   timebackRouter.post("/end-activity", handle2(timeback2.endActivity));
   timebackRouter.post("/heartbeat", handle2(timeback2.heartbeat));
   timebackRouter.post("/advance-course", handle2(timeback2.advanceCourse));
+  timebackRouter.post("/unenroll-course", handle2(timeback2.unenrollCourse));
   timebackRouter.get("/user", async (c2) => {
     const user = c2.get("user");
     const gameId = c2.get("gameId");

package/package.json

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