@playcademy/sdk 0.11.0 → 0.11.1-beta.1

package/dist/index.d.ts

@@ -1028,9 +1028,15 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
         pauseActivity: () => void;
         resumeActivity: () => void;
         endActivity: (data: _playcademy_types.EndActivityScoreData) => Promise<_playcademy_types.EndActivityResponse>;
-        advanceCourse: (options?: {
-            subject?: _playcademy_types.TimebackSubject;
-        }) => Promise<_playcademy_types.AdvanceCourseResponse>;
+        course: {
+            advance: (options?: {
+                subject?: _playcademy_types.TimebackSubject;
+            }) => Promise<_playcademy_types.AdvanceCourseResponse>;
+            unenroll: (options?: {
+                subject?: _playcademy_types.TimebackSubject;
+                force?: boolean;
+            }) => Promise<_playcademy_types.UnenrollCourseResponse>;
+        };
     };
     /**
      * Game score submission and leaderboards.

package/dist/index.js

@@ -1147,7 +1147,8 @@ var TIMEBACK_ROUTES = {
   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"
 };
 var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
   xp: 1,
@@ -1804,16 +1805,20 @@ function createTimebackEngine(client) {
     ttl: 5 * 60 * 1000,
     keyPrefix: "game.timeback.enrollments"
   });
-  async function applyPromotion(promotion) {
-    if (promotion.status !== "promoted" && promotion.status !== "already-promoted") {
-      return;
-    }
+  async function refreshAfterCourseMutation() {
     userCache.clear("current");
     enrollmentsCache.clear("current");
+    xpCache.clear();
     try {
       await userStore.refresh();
     } catch {}
   }
+  async function applyPromotion(promotion) {
+    if (promotion.status !== "promoted" && promotion.status !== "already-promoted") {
+      return;
+    }
+    await refreshAfterCourseMutation();
+  }
   const activityTracker = createTimebackActivityTracker(client);
   async function refreshUserContext() {
     const context = await userStore.refresh();
@@ -1900,10 +1905,22 @@ function createTimebackEngine(client) {
       resume: activityTracker.resumeActivity,
       end: activityTracker.endActivity
     },
-    async advanceCourse(params) {
-      const response = await client["requestGameBackend"](TIMEBACK_ROUTES.ADVANCE_COURSE, "POST", params?.subject !== undefined ? { subject: params.subject } : {});
-      await applyPromotion(response.promotion);
-      return response;
+    course: {
+      async advance(params) {
+        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.ADVANCE_COURSE, "POST", params?.subject !== undefined ? { subject: params.subject } : {});
+        await applyPromotion(response.promotion);
+        return response;
+      },
+      async unenroll(params) {
+        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.UNENROLL_COURSE, "POST", {
+          ...params?.subject !== undefined ? { subject: params.subject } : {},
+          ...params?.force !== undefined ? { force: params.force } : {}
+        });
+        if (response.unenrollment.status === "unenrolled") {
+          await refreshAfterCourseMutation();
+        }
+        return response;
+      }
     }
   };
 }
@@ -1999,12 +2016,24 @@ function createTimebackNamespace(client) {
       assertPlatformMode(client, "timeback.endActivity()");
       return engine.activity.end(data);
     },
-    advanceCourse: async (options) => {
-      assertPlatformMode(client, "timeback.advanceCourse()");
-      if (options?.subject !== undefined && !isValidSubject(options.subject)) {
-        throw new Error(`Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS.join(", ")}`);
+    course: {
+      advance: async (options) => {
+        assertPlatformMode(client, "timeback.course.advance()");
+        if (options?.subject !== undefined && !isValidSubject(options.subject)) {
+          throw new Error(`Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS.join(", ")}`);
+        }
+        return engine.course.advance(options);
+      },
+      unenroll: async (options) => {
+        assertPlatformMode(client, "timeback.course.unenroll()");
+        if (options?.subject !== undefined && !isValidSubject(options.subject)) {
+          throw new Error(`Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS.join(", ")}`);
+        }
+        if (options?.force !== undefined && typeof options.force !== "boolean") {
+          throw new Error("Invalid force: must be a boolean");
+        }
+        return engine.course.unenroll(options);
       }
-      return engine.advanceCourse(options);
     }
   };
 }

package/dist/internal.js

@@ -1147,7 +1147,8 @@ var TIMEBACK_ROUTES = {
   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"
 };
 var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
   xp: 1,
@@ -1804,16 +1805,20 @@ function createTimebackEngine(client) {
     ttl: 5 * 60 * 1000,
     keyPrefix: "game.timeback.enrollments"
   });
-  async function applyPromotion(promotion) {
-    if (promotion.status !== "promoted" && promotion.status !== "already-promoted") {
-      return;
-    }
+  async function refreshAfterCourseMutation() {
     userCache.clear("current");
     enrollmentsCache.clear("current");
+    xpCache.clear();
     try {
       await userStore.refresh();
     } catch {}
   }
+  async function applyPromotion(promotion) {
+    if (promotion.status !== "promoted" && promotion.status !== "already-promoted") {
+      return;
+    }
+    await refreshAfterCourseMutation();
+  }
   const activityTracker = createTimebackActivityTracker(client);
   async function refreshUserContext() {
     const context = await userStore.refresh();
@@ -1900,10 +1905,22 @@ function createTimebackEngine(client) {
       resume: activityTracker.resumeActivity,
       end: activityTracker.endActivity
     },
-    async advanceCourse(params) {
-      const response = await client["requestGameBackend"](TIMEBACK_ROUTES.ADVANCE_COURSE, "POST", params?.subject !== undefined ? { subject: params.subject } : {});
-      await applyPromotion(response.promotion);
-      return response;
+    course: {
+      async advance(params) {
+        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.ADVANCE_COURSE, "POST", params?.subject !== undefined ? { subject: params.subject } : {});
+        await applyPromotion(response.promotion);
+        return response;
+      },
+      async unenroll(params) {
+        const response = await client["requestGameBackend"](TIMEBACK_ROUTES.UNENROLL_COURSE, "POST", {
+          ...params?.subject !== undefined ? { subject: params.subject } : {},
+          ...params?.force !== undefined ? { force: params.force } : {}
+        });
+        if (response.unenrollment.status === "unenrolled") {
+          await refreshAfterCourseMutation();
+        }
+        return response;
+      }
     }
   };
 }
@@ -1999,12 +2016,24 @@ function createTimebackNamespace(client) {
       assertPlatformMode(client, "timeback.endActivity()");
       return engine.activity.end(data);
     },
-    advanceCourse: async (options) => {
-      assertPlatformMode(client, "timeback.advanceCourse()");
-      if (options?.subject !== undefined && !isValidSubject(options.subject)) {
-        throw new Error(`Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS.join(", ")}`);
+    course: {
+      advance: async (options) => {
+        assertPlatformMode(client, "timeback.course.advance()");
+        if (options?.subject !== undefined && !isValidSubject(options.subject)) {
+          throw new Error(`Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS.join(", ")}`);
+        }
+        return engine.course.advance(options);
+      },
+      unenroll: async (options) => {
+        assertPlatformMode(client, "timeback.course.unenroll()");
+        if (options?.subject !== undefined && !isValidSubject(options.subject)) {
+          throw new Error(`Invalid subject: ${options.subject}. Valid subjects: ${VALID_SUBJECTS.join(", ")}`);
+        }
+        if (options?.force !== undefined && typeof options.force !== "boolean") {
+          throw new Error("Invalid force: must be a boolean");
+        }
+        return engine.course.unenroll(options);
       }
-      return engine.advanceCourse(options);
     }
   };
 }

package/dist/types.d.ts

@@ -1385,9 +1385,15 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
         pauseActivity: () => void;
         resumeActivity: () => void;
         endActivity: (data: _playcademy_types.EndActivityScoreData) => Promise<_playcademy_types.EndActivityResponse>;
-        advanceCourse: (options?: {
-            subject?: _playcademy_types.TimebackSubject;
-        }) => Promise<_playcademy_types.AdvanceCourseResponse>;
+        course: {
+            advance: (options?: {
+                subject?: _playcademy_types.TimebackSubject;
+            }) => Promise<_playcademy_types.AdvanceCourseResponse>;
+            unenroll: (options?: {
+                subject?: _playcademy_types.TimebackSubject;
+                force?: boolean;
+            }) => Promise<_playcademy_types.UnenrollCourseResponse>;
+        };
     };
     /**
      * Game score submission and leaderboards.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.11.0",
+    "version": "0.11.1-beta.1",
     "type": "module",
     "exports": {
         ".": {