@playcademy/sdk 0.3.6-beta.1 → 0.3.6-beta.3

package/dist/internal.d.ts

@@ -872,6 +872,106 @@ interface EndActivityResponse {
     scoreStatus?: string;
     inProgress?: string;
 }
+interface TimebackRosterStudent {
+    studentId: string;
+    enrollmentId: string | null;
+    classId: string | null;
+    className: string | null;
+    name: string;
+    email: string | null;
+    analyticsUnavailable: boolean;
+    totalXp: number;
+    todayXp: number;
+    activeTimeSeconds: number;
+    masteredUnits: number;
+    masterableUnits?: number;
+    pctCompleteApp?: number;
+}
+interface TimebackRosterResponse {
+    gameId: string;
+    courseId: string;
+    students: TimebackRosterStudent[];
+}
+interface TimebackStudentHistoryPoint {
+    date: string;
+    xpEarned: number;
+    activeTimeSeconds: number;
+    masteredUnits: number;
+}
+type CourseCompletionStatus = 'none' | 'complete' | 'incomplete';
+interface TimebackStudentCourseOverview {
+    courseId: string;
+    title: string;
+    grade: number;
+    subject: string;
+    enrollmentId: string | null;
+    analyticsUnavailable: boolean;
+    totalXp: number;
+    todayXp: number;
+    activeTimeSeconds: number;
+    masteredUnits: number;
+    masterableUnits?: number;
+    pctCompleteApp?: number;
+    completionStatus: CourseCompletionStatus;
+    history: TimebackStudentHistoryPoint[];
+}
+type TimebackRecentActivityKind = 'activity' | 'time-spent' | 'remediation-xp' | 'remediation-time' | 'remediation-mastery' | 'course-completed' | 'course-resumed';
+interface TimebackRecentActivity {
+    id: string;
+    kind: TimebackRecentActivityKind;
+    occurredAt: string;
+    courseId: string;
+    title: string;
+    activityId?: string;
+    appName?: string;
+    reason?: string;
+    score?: number;
+    xpDelta?: number;
+    timeDeltaSeconds?: number;
+    masteredUnitsDelta?: number;
+}
+interface TimebackStudentOverviewResponse {
+    student: {
+        studentId: string;
+        name: string;
+        email: string | null;
+    };
+    courses: TimebackStudentCourseOverview[];
+}
+interface TimebackStudentActivityResponse {
+    activities: TimebackRecentActivity[];
+    hasMore: boolean;
+}
+interface GrantTimebackXpRequest {
+    gameId: string;
+    courseId: string;
+    studentId: string;
+    xp: number;
+    reason: string;
+}
+interface AdjustTimebackTimeRequest {
+    gameId: string;
+    courseId: string;
+    studentId: string;
+    seconds: number;
+    reason: string;
+}
+interface AdjustTimebackMasteryRequest {
+    gameId: string;
+    courseId: string;
+    studentId: string;
+    units: number;
+    reason: string;
+}
+interface ToggleCourseCompletionRequest {
+    gameId: string;
+    courseId: string;
+    studentId: string;
+    action: 'complete' | 'resume';
+}
+interface TimebackAdminMutationResponse {
+    status: 'ok';
+}
 
 /**
  * Inventory & Shop Types
@@ -7660,6 +7760,22 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             get: (timebackId: string, options?: TTLCacheConfig | undefined) => Promise<PlatformTimebackUserContext>;
             clearCache: (timebackId?: string | undefined) => void;
         };
+        admin: {
+            getRoster: (gameId: string, courseId: string) => Promise<TimebackRosterResponse>;
+            getStudentOverview: (timebackId: string, options: {
+                gameId: string;
+                courseId?: string | undefined;
+            }) => Promise<TimebackStudentOverviewResponse>;
+            getStudentActivity: (timebackId: string, courseId: string, options: {
+                gameId: string;
+                limit?: number | undefined;
+                offset?: number | undefined;
+            }) => Promise<TimebackStudentActivityResponse>;
+            grantXp: (request: GrantTimebackXpRequest) => Promise<TimebackAdminMutationResponse>;
+            adjustTime: (request: AdjustTimebackTimeRequest) => Promise<TimebackAdminMutationResponse>;
+            adjustMastery: (request: AdjustTimebackMasteryRequest) => Promise<TimebackAdminMutationResponse>;
+            toggleCompletion: (request: ToggleCourseCompletionRequest) => Promise<TimebackAdminMutationResponse>;
+        };
     };
     /** Auto-initializes a PlaycademyInternalClient with context from the environment */
     static init: typeof init;

package/dist/internal.js

@@ -2766,6 +2766,38 @@ function createTimebackNamespace2(client) {
       clearCache: (timebackId) => {
         studentCache.clear(timebackId);
       }
+    },
+    admin: {
+      getRoster: (gameId, courseId) => client["request"](`/timeback/roster/${gameId}/${courseId}`, "GET"),
+      getStudentOverview: (timebackId, options) => {
+        const params = new URLSearchParams({ gameId: options.gameId });
+        if (options.courseId) {
+          params.set("courseId", options.courseId);
+        }
+        return client["request"](`/timeback/student-overview/${timebackId}?${params}`, "GET");
+      },
+      getStudentActivity: (timebackId, courseId, options) => {
+        const params = new URLSearchParams({ gameId: options.gameId });
+        if (options.limit !== undefined) {
+          params.set("limit", String(options.limit));
+        }
+        if (options.offset !== undefined) {
+          params.set("offset", String(options.offset));
+        }
+        return client["request"](`/timeback/student-activity/${timebackId}/${courseId}?${params}`, "GET");
+      },
+      grantXp: (request2) => client["request"]("/timeback/grant-xp", "POST", {
+        body: request2
+      }),
+      adjustTime: (request2) => client["request"]("/timeback/adjust-time", "POST", {
+        body: request2
+      }),
+      adjustMastery: (request2) => client["request"]("/timeback/adjust-mastery", "POST", {
+        body: request2
+      }),
+      toggleCompletion: (request2) => client["request"]("/timeback/toggle-completion", "POST", {
+        body: request2
+      })
     }
   };
 }

package/package.json

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