@playcademy/sdk 0.13.0 → 0.13.1-beta.2

package/dist/index.d.ts

@@ -1284,6 +1284,9 @@ interface TimebackUserMastery {
     /**
      * Fetch mastery data from the server.
      * Returns mastery for all courses in this game, or filter by grade/subject.
+     * Returned masteredUnits values are true analytics values and may exceed
+     * the course masterableUnits maximum when historical data violates the
+     * expected invariant.
      * Results are cached for 5 seconds (use `force: true` to bypass).
      *
      * @param options - Query options
@@ -1379,15 +1382,15 @@ interface XpResponse {
     todayXp?: number;
     courses?: CourseXp[];
 }
-/**
- * Mastery data for a single course.
- */
 interface CourseMastery {
     grade: TimebackGrade;
     subject: TimebackSubject;
     title: string;
+    /** True mastered units from analytics. May exceed masterableUnits for historical data. */
     masteredUnits: number;
+    /** Configured mastery ceiling for the course. */
     masterableUnits: number;
+    /** Clamped course completion percentage from 0..100. */
     pctComplete: number;
     isComplete: boolean;
 }
@@ -1395,7 +1398,9 @@ interface CourseMastery {
  * Response from mastery query.
  */
 interface MasteryResponse {
+    /** True mastered units across all queried courses. */
     totalMasteredUnits: number;
+    /** Configured mastery ceiling across all queried courses. */
     totalMasterableUnits: number;
     courses?: CourseMastery[];
 }

package/dist/index.js

@@ -2379,7 +2379,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.13.0";
+var SDK_VERSION = "0.13.1-beta.2";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -1135,6 +1135,9 @@ interface TimebackUserMastery {
     /**
      * Fetch mastery data from the server.
      * Returns mastery for all courses in this game, or filter by grade/subject.
+     * Returned masteredUnits values are true analytics values and may exceed
+     * the course masterableUnits maximum when historical data violates the
+     * expected invariant.
      * Results are cached for 5 seconds (use `force: true` to bypass).
      *
      * @param options - Query options
@@ -1230,15 +1233,15 @@ interface XpResponse {
     todayXp?: number;
     courses?: CourseXp[];
 }
-/**
- * Mastery data for a single course.
- */
 interface CourseMastery {
     grade: TimebackGrade;
     subject: TimebackSubject;
     title: string;
+    /** True mastered units from analytics. May exceed masterableUnits for historical data. */
     masteredUnits: number;
+    /** Configured mastery ceiling for the course. */
     masterableUnits: number;
+    /** Clamped course completion percentage from 0..100. */
     pctComplete: number;
     isComplete: boolean;
 }
@@ -1246,7 +1249,9 @@ interface CourseMastery {
  * Response from mastery query.
  */
 interface MasteryResponse {
+    /** True mastered units across all queried courses. */
     totalMasteredUnits: number;
+    /** Configured mastery ceiling across all queried courses. */
     totalMasterableUnits: number;
     courses?: CourseMastery[];
 }
@@ -3106,6 +3111,8 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
                 limit?: number;
                 offset?: number;
             }) => Promise<_playcademy_types.TimebackStudentActivityResponse>;
+            getGradeLevelTestResults: (gameId: string, courseId: string, studentId: string) => Promise<_playcademy_types.TimebackGradeLevelTestResultsResponse>;
+            getGradeLevelTestReview: (gameId: string, courseId: string, resultId: string, studentId: string) => Promise<_playcademy_types.TimebackGradeLevelTestReviewResponse>;
             getActivityDetail: (timebackId: string, courseId: string, activityId: string, options: {
                 gameId: string;
                 runId?: string;
@@ -3125,7 +3132,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             adjustMastery: (request: _playcademy_types.AdjustTimebackMasteryRequest) => Promise<_playcademy_types.TimebackAdminMutationResponse>;
             reconcileMasteryForConfigChange: (request: _playcademy_types.ReconcileMasteryForConfigChangeRequest) => Promise<_playcademy_types.ReconcileMasteryForConfigChangeResponse>;
             searchStudents: (gameId: string, courseId: string, query: string) => Promise<_playcademy_types.SearchStudentsResponse>;
-            enrollStudent: (request: _playcademy_types.EnrollStudentRequest) => Promise<_playcademy_types.TimebackAdminMutationResponse>;
+            enrollStudent: (request: _playcademy_types.EnrollStudentRequest) => Promise<_playcademy_types.EnrollStudentResponse>;
             unenrollStudent: (request: _playcademy_types.UnenrollStudentRequest) => Promise<_playcademy_types.TimebackAdminMutationResponse>;
             reactivateEnrollment: (request: _playcademy_types.ReactivateEnrollmentRequest) => Promise<_playcademy_types.TimebackAdminMutationResponse>;
         };

package/dist/internal.js

@@ -2775,6 +2775,14 @@ function createTimebackNamespace2(client) {
         }
         return client["request"](`/timeback/student-activity/${timebackId}/${courseId}?${params}`, "GET");
       },
+      getGradeLevelTestResults: (gameId, courseId, studentId) => {
+        const params = new URLSearchParams({ studentId });
+        return client["request"](`/timeback/grade-level-test-results/${gameId}/${courseId}?${params}`, "GET");
+      },
+      getGradeLevelTestReview: (gameId, courseId, resultId, studentId) => {
+        const params = new URLSearchParams({ studentId });
+        return client["request"](`/timeback/grade-level-test-results/${gameId}/${courseId}/${resultId}?${params}`, "GET");
+      },
       getActivityDetail: (timebackId, courseId, activityId, options) => {
         const params = new URLSearchParams({ gameId: options.gameId });
         if (options.runId) {
@@ -3070,7 +3078,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.13.0";
+var SDK_VERSION = "0.13.1-beta.2";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/server/edge.js

@@ -233,7 +233,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.13.0";
+var SDK_VERSION = "0.13.1-beta.2";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.js

@@ -422,7 +422,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.13.0";
+var SDK_VERSION = "0.13.1-beta.2";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -1650,6 +1650,9 @@ interface TimebackUserMastery {
     /**
      * Fetch mastery data from the server.
      * Returns mastery for all courses in this game, or filter by grade/subject.
+     * Returned masteredUnits values are true analytics values and may exceed
+     * the course masterableUnits maximum when historical data violates the
+     * expected invariant.
      * Results are cached for 5 seconds (use `force: true` to bypass).
      *
      * @param options - Query options
@@ -1745,15 +1748,15 @@ interface XpResponse {
     todayXp?: number;
     courses?: CourseXp[];
 }
-/**
- * Mastery data for a single course.
- */
 interface CourseMastery {
     grade: TimebackGrade;
     subject: TimebackSubject;
     title: string;
+    /** True mastered units from analytics. May exceed masterableUnits for historical data. */
     masteredUnits: number;
+    /** Configured mastery ceiling for the course. */
     masterableUnits: number;
+    /** Clamped course completion percentage from 0..100. */
     pctComplete: number;
     isComplete: boolean;
 }
@@ -1761,7 +1764,9 @@ interface CourseMastery {
  * Response from mastery query.
  */
 interface MasteryResponse {
+    /** True mastered units across all queried courses. */
     totalMasteredUnits: number;
+    /** Configured mastery ceiling across all queried courses. */
     totalMasterableUnits: number;
     courses?: CourseMastery[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.13.0",
+    "version": "0.13.1-beta.2",
     "type": "module",
     "exports": {
         ".": {