@playcademy/sdk 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _playcademy_realtime_server_types from '@playcademy/realtime/server/types';
-import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import * as _playcademy_timeback_types from '@playcademy/timeback/types';
+import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
 /**
@@ -736,166 +736,6 @@ declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-declare const gameTimebackIntegrations: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "game_timeback_integrations";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        gameId: drizzle_orm_pg_core.PgColumn<{
-            name: "game_id";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        courseId: drizzle_orm_pg_core.PgColumn<{
-            name: "course_id";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        grade: drizzle_orm_pg_core.PgColumn<{
-            name: "grade";
-            tableName: "game_timeback_integrations";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        subject: drizzle_orm_pg_core.PgColumn<{
-            name: "subject";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        totalXp: drizzle_orm_pg_core.PgColumn<{
-            name: "total_xp";
-            tableName: "game_timeback_integrations";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        lastVerifiedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "last_verified_at";
-            tableName: "game_timeback_integrations";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "game_timeback_integrations";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "game_timeback_integrations";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
 type Item = typeof items.$inferSelect;
 type InventoryItem = typeof inventoryItems.$inferSelect;
 
@@ -932,177 +772,6 @@ interface UserInfo {
 type InventoryItemWithItem = Omit<InventoryItem, 'itemId'> & {
     item: Item;
 };
-type GameTimebackIntegration = typeof gameTimebackIntegrations.$inferSelect;
-type TodayXpResponse = {
-    xp: number;
-    date: string;
-};
-type TotalXpResponse = {
-    totalXp: number;
-};
-type XpHistoryResponse = {
-    history: Array<{
-        date: string;
-        xp: number;
-    }>;
-};
-type TimebackSetupRequest = {
-    gameId: string;
-    config: {
-        organization: {
-            name: string;
-            type: string;
-            identifier: string;
-        };
-        course: {
-            title: string;
-            subjects: string[];
-            grades: number[];
-            courseCode: string;
-            level: string;
-            gradingScheme: string;
-            metadata?: Record<string, unknown>;
-        };
-        component: {
-            title: string;
-            sortOrder: number;
-            prerequisites: string[];
-            prerequisiteCriteria: string;
-        };
-        resource: {
-            title: string;
-            vendorResourceId: string;
-            vendorId: string;
-            applicationId: string;
-            roles: string[];
-            importance: string;
-            metadata: {
-                type?: string;
-                launchUrl?: string;
-                toolProvider?: string;
-                instructionalMethod?: string;
-                subject?: string;
-                grades?: number[];
-                language?: string;
-                xp?: number;
-                [key: string]: unknown;
-            };
-        };
-        componentResource: {
-            title: string;
-            sortOrder: number;
-            lessonType: string | null;
-        };
-    };
-    verbose?: boolean;
-};
-/**
- * Minimal course configuration for TimeBack integration (used in user-facing config).
- *
- * NOTE: Per-course overrides (title, courseCode, level, metadata) are defined
- * in @playcademy/sdk/server as TimebackCourseConfigWithOverrides.
- * This base type only includes the minimal required fields.
- *
- * For totalXp, use metadata.metrics.totalXp (aligns with upstream TimeBack structure).
- */
-type TimebackCourseConfig = {
-    subject: string;
-    grade: number;
-};
-/**
- * Derived course configuration after merging base + per-course overrides + templating.
- * This is what the CLI sends to the Platform API in PlatformTimebackSetupRequest.
- */
-type DerivedPlatformCourseConfig = TimebackCourseConfig & {
-    title: string;
-    courseCode: string;
-    level: string;
-    metadata?: Record<string, unknown>;
-    totalXp?: number | null;
-    masterableUnits?: number | null;
-};
-type PlatformTimebackSetupRequest = {
-    gameId: string;
-    courses: DerivedPlatformCourseConfig[];
-    baseConfig: {
-        organization: {
-            name: string;
-            type: string;
-            identifier: string;
-        };
-        component: {
-            title: string;
-            titleSuffix?: string;
-            sortOrder: number;
-            prerequisites: string[];
-            prerequisiteCriteria: string;
-        };
-        resource: {
-            title: string;
-            titleSuffix?: string;
-            vendorResourceId: string;
-            vendorId: string;
-            applicationId: string;
-            roles: string[];
-            importance: string;
-            metadata: {
-                type?: string;
-                launchUrl?: string;
-                toolProvider?: string;
-                instructionalMethod?: string;
-                language?: string;
-                [key: string]: unknown;
-            };
-        };
-        componentResource: {
-            title: string;
-            titleSuffix?: string;
-            sortOrder: number;
-            lessonType: string | null;
-        };
-    };
-    verbose?: boolean;
-};
-type PlatformTimebackSetupResponse = {
-    integrations: GameTimebackIntegration[];
-    verbose?: Array<{
-        integration: GameTimebackIntegration;
-        config: {
-            course: unknown;
-            component: unknown;
-            resource: unknown;
-            componentResource: unknown;
-        };
-    }>;
-};
-type TimebackVerificationResources = {
-    course: {
-        found: boolean;
-        data?: unknown;
-    };
-    component: {
-        found: boolean;
-        data?: unknown;
-    };
-    resource: {
-        found: boolean;
-        data?: unknown;
-    };
-    componentResource: {
-        found: boolean;
-        data?: unknown;
-    };
-};
-type TimebackVerifyCourseResult = {
-    integration: GameTimebackIntegration;
-    resources: TimebackVerificationResources;
-    status: 'success' | 'error';
-    errors?: string[];
-};
-type TimebackVerifyAllResponse = {
-    status: 'success' | 'error';
-    results: TimebackVerifyCourseResult[];
-};
 type EndActivityResponse = {
     status: 'ok';
     courseId: string;
@@ -1113,14 +782,6 @@ type EndActivityResponse = {
     inProgress?: string;
 };
 
-/**
- * Combined response type for summary method
- */
-type XpSummaryResponse = {
-    today: TodayXpResponse;
-    total: TotalXpResponse;
-};
-
 /**
  * Auto-initializes a PlaycademyClient with context from the environment.
  * Works in both iframe mode (production/development) and standalone mode (local dev).
@@ -1519,28 +1180,6 @@ declare class PlaycademyClient {
         pauseActivity: () => void;
         resumeActivity: () => void;
         endActivity: (data: _playcademy_timeback_types.EndActivityScoreData) => Promise<EndActivityResponse>;
-        management: {
-            setup: (request: PlatformTimebackSetupRequest) => Promise<PlatformTimebackSetupResponse>;
-            verify: (gameId: string) => Promise<TimebackVerifyAllResponse>;
-            cleanup: (gameId: string) => Promise<void>;
-            get: (gameId: string) => Promise<GameTimebackIntegration[]>;
-            getConfig: (gameId: string) => Promise<TimebackSetupRequest["config"]>;
-        };
-        xp: {
-            today: (options?: {
-                date?: string;
-                timezone?: string;
-            }) => Promise<TodayXpResponse>;
-            total: () => Promise<TotalXpResponse>;
-            history: (options?: {
-                startDate?: string;
-                endDate?: string;
-            }) => Promise<XpHistoryResponse>;
-            summary: (options?: {
-                date?: string;
-                timezone?: string;
-            }) => Promise<XpSummaryResponse>;
-        };
     };
     /** Credits methods (credits management) */
     credits: {

package/dist/index.js

@@ -1843,65 +1843,6 @@ function createTimebackNamespace(client) {
         currentActivity = null;
         throw error;
       }
-    },
-    management: {
-      setup: (request2) => {
-        return client["request"]("/timeback/setup", "POST", {
-          body: request2
-        });
-      },
-      verify: (gameId) => {
-        return client["request"](`/timeback/verify/${gameId}`, "GET");
-      },
-      cleanup: (gameId) => {
-        return client["request"](`/timeback/integrations/${gameId}`, "DELETE");
-      },
-      get: (gameId) => {
-        return client["request"](`/timeback/integrations/${gameId}`, "GET");
-      },
-      getConfig: (gameId) => {
-        return client["request"](`/timeback/config/${gameId}`, "GET");
-      }
-    },
-    xp: {
-      today: async (options) => {
-        const params = new URLSearchParams;
-        if (options?.date)
-          params.set("date", options.date);
-        if (options?.timezone)
-          params.set("tz", options.timezone);
-        const query = params.toString();
-        const endpoint = query ? `/timeback/xp/today?${query}` : "/timeback/xp/today";
-        return client["request"](endpoint, "GET");
-      },
-      total: async () => {
-        return client["request"]("/timeback/xp/total", "GET");
-      },
-      history: async (options) => {
-        const params = new URLSearchParams;
-        if (options?.startDate)
-          params.set("startDate", options.startDate);
-        if (options?.endDate)
-          params.set("endDate", options.endDate);
-        const query = params.toString();
-        const endpoint = query ? `/timeback/xp/history?${query}` : "/timeback/xp/history";
-        return client["request"](endpoint, "GET");
-      },
-      summary: async (options) => {
-        const [today, total] = await Promise.all([
-          client["request"]((() => {
-            const params = new URLSearchParams;
-            if (options?.date)
-              params.set("date", options.date);
-            if (options?.timezone)
-              params.set("tz", options.timezone);
-            const query = params.toString();
-            return query ? `/timeback/xp/today?${query}` : "/timeback/xp/today";
-          })(), "GET"),
-          client["request"]("/timeback/xp/total", "GET")
-        ]);
-        return { today, total };
-      }
     }
   };
 }

package/dist/internal.d.ts

@@ -1,10 +1,10 @@
+import * as _playcademy_timeback_types from '@playcademy/timeback/types';
+import { CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
 import * as _playcademy_realtime_server_types from '@playcademy/realtime/server/types';
 import { InferSelectModel } from 'drizzle-orm';
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import * as drizzle_zod from 'drizzle-zod';
 import { z } from 'zod';
-import * as _playcademy_timeback_types from '@playcademy/timeback/types';
-import { CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 import { SchemaInfo } from '@playcademy/cloudflare';
 
@@ -4386,14 +4386,6 @@ type EndActivityResponse = {
     inProgress?: string;
 };
 
-/**
- * Combined response type for summary method
- */
-type XpSummaryResponse$1 = {
-    today: TodayXpResponse;
-    total: TotalXpResponse;
-};
-
 /**
  * Auto-initializes a PlaycademyClient with context from the environment.
  * Works in both iframe mode (production/development) and standalone mode (local dev).
@@ -4792,28 +4784,6 @@ declare class PlaycademyClient {
         pauseActivity: () => void;
         resumeActivity: () => void;
         endActivity: (data: _playcademy_timeback_types.EndActivityScoreData) => Promise<EndActivityResponse>;
-        management: {
-            setup: (request: PlatformTimebackSetupRequest) => Promise<PlatformTimebackSetupResponse>;
-            verify: (gameId: string) => Promise<TimebackVerifyAllResponse>;
-            cleanup: (gameId: string) => Promise<void>;
-            get: (gameId: string) => Promise<GameTimebackIntegration[]>;
-            getConfig: (gameId: string) => Promise<TimebackSetupRequest["config"]>;
-        };
-        xp: {
-            today: (options?: {
-                date?: string;
-                timezone?: string;
-            }) => Promise<TodayXpResponse>;
-            total: () => Promise<TotalXpResponse>;
-            history: (options?: {
-                startDate?: string;
-                endDate?: string;
-            }) => Promise<XpHistoryResponse>;
-            summary: (options?: {
-                date?: string;
-                timezone?: string;
-            }) => Promise<XpSummaryResponse$1>;
-        };
     };
     /** Credits methods (credits management) */
     credits: {
@@ -5083,19 +5053,6 @@ interface ScoreSubmission {
     achievedAt: Date;
 }
 
-/**
- * TimeBack namespace types
- */
-
-/**
- * Combined response type for summary method
- */
-type XpSummaryResponse = {
-    today: TodayXpResponse;
-    total: TotalXpResponse;
-    history: XpHistoryResponse;
-};
-
 /**
  * Users namespace types
  */
@@ -5255,6 +5212,41 @@ type DevUploadHooks = {
     onClose?: () => void;
 };
 
+/**
+ * Platform TimeBack Types
+ *
+ * Types for TimeBack enrollment and student data on the platform side.
+ * These are used by the cademy hub to determine which games users have access to.
+ */
+
+/**
+ * Enrollment data for a student in a specific game/course.
+ * Represents the mapping between a TimeBack course and a Playcademy game.
+ */
+interface StudentEnrollment {
+    /** The Playcademy game ID the student is enrolled in */
+    gameId: string;
+    /** The grade level for this enrollment */
+    grade: number;
+    /** The subject area (e.g., 'Math', 'Science') */
+    subject: string;
+    /** The TimeBack course ID */
+    courseId: string;
+}
+/**
+ * Response from the enrollments endpoint
+ */
+interface EnrollmentsResponse {
+    enrollments: StudentEnrollment[];
+}
+/**
+ * Combined response type for xp.summary() method
+ */
+interface XpSummaryResponse {
+    today: TodayXpResponse;
+    total: TotalXpResponse;
+}
+
 /**
  * @fileoverview Server SDK Type Definitions
  *
@@ -6561,11 +6553,46 @@ declare class PlaycademyInternalClient extends PlaycademyClient {
     /** Scores methods */
     scores: {
         getByUser: (gameId: string, userId: string, options?: {
-            limit?: number;
+            limit
+            /** Cross-game leaderboards (overworld) */
+            ?: number;
         }) => Promise<UserScore$1[]>;
         submit: (gameId: string, score: number, metadata?: Record<string, unknown>) => Promise<ScoreSubmission>;
     };
+    /** TimeBack (platform version with enrollments, game methods throw) */
+    timeback: {
+        startActivity: (_metadata: _playcademy_timeback_types.ActivityData) => void;
+        pauseActivity: () => void;
+        resumeActivity: () => void;
+        endActivity: (_data: _playcademy_timeback_types.EndActivityScoreData) => Promise<EndActivityResponse>;
+        management: {
+            setup: (request: PlatformTimebackSetupRequest) => Promise<PlatformTimebackSetupResponse>;
+            verify: (gameId: string) => Promise<TimebackVerifyAllResponse>;
+            cleanup: (gameId: string) => Promise<void>;
+            get: (gameId: string) => Promise<GameTimebackIntegration[]>;
+            getConfig: (gameId: string) => Promise<TimebackSetupRequest["config"]>;
+        };
+        xp: {
+            today: (options?: {
+                date?: string;
+                timezone?: string;
+            }) => Promise<TodayXpResponse>;
+            total: () => Promise<TotalXpResponse>;
+            history: (options?: {
+                startDate?: string;
+                endDate?: string;
+            }) => Promise<XpHistoryResponse>;
+            summary: (options?: {
+                date?: string;
+                timezone?: string;
+            }) => Promise<XpSummaryResponse>;
+        };
+        enrollments: {
+            get: (timebackId: string, options?: TTLCacheConfig) => Promise<StudentEnrollment[]>;
+            clearCache: (timebackId?: string) => void;
+        };
+    };
 }
 
 export { ApiError, ConnectionManager, ConnectionMonitor, MessageEvents, PlaycademyInternalClient as PlaycademyClient, PlaycademyError, PlaycademyInternalClient, extractApiErrorInfo, messaging };
-export type { Achievement, AchievementCurrent, AchievementProgressResponse, ApiErrorInfo, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponent, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionMonitorConfig, ConnectionState, ConnectionStatePayload, CreateCharacterData, Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusResponse, DisconnectContext, DisconnectHandler, DisplayAlertPayload, ErrorResponseBody, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameLeaderboardEntry, GameSession, GameStateData, GameTokenResponse, GameUser, HostedGame, InitPayload, InventoryItem, InventoryItemWithItem, InventoryMutationResponse, Item, KeyEventPayload, LeaderboardEntry, LevelConfig, LoginResponse, ManifestV1, Map, MapElement, MapElementWithGame, MapObject, MapObjectWithItem, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacter, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, User, UserInfo, UserLevel, UserLevelWithConfig, UserRank, UserRankResponse, UserRoleEnumType, UserScore, XpHistoryResponse, XpSummaryResponse };
+export type { Achievement, AchievementCurrent, AchievementProgressResponse, ApiErrorInfo, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponent, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionMonitorConfig, ConnectionState, ConnectionStatePayload, CreateCharacterData, Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusResponse, DisconnectContext, DisconnectHandler, DisplayAlertPayload, EnrollmentsResponse, ErrorResponseBody, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameLeaderboardEntry, GameSession, GameStateData, GameTokenResponse, GameUser, HostedGame, InitPayload, InventoryItem, InventoryItemWithItem, InventoryMutationResponse, Item, KeyEventPayload, LeaderboardEntry, LevelConfig, LoginResponse, ManifestV1, Map, MapElement, MapElementWithGame, MapObject, MapObjectWithItem, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacter, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, StudentEnrollment, TelemetryPayload, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, User, UserInfo, UserLevel, UserLevelWithConfig, UserRank, UserRankResponse, UserRoleEnumType, UserScore, XpHistoryResponse, XpSummaryResponse };

package/dist/internal.js

@@ -1210,6 +1210,98 @@ function createScoresNamespace2(client) {
     }
   };
 }
+// src/namespaces/platform/timeback.ts
+var NOT_SUPPORTED = "Activity tracking is not available on the platform client. Use the game SDK instead.";
+function createTimebackNamespace(client) {
+  const enrollmentsCache = createTTLCache({
+    ttl: 30 * 1000,
+    keyPrefix: "platform.timeback.enrollments"
+  });
+  return {
+    startActivity: (_metadata) => {
+      throw new Error(NOT_SUPPORTED);
+    },
+    pauseActivity: () => {
+      throw new Error(NOT_SUPPORTED);
+    },
+    resumeActivity: () => {
+      throw new Error(NOT_SUPPORTED);
+    },
+    endActivity: async (_data) => {
+      throw new Error(NOT_SUPPORTED);
+    },
+    management: {
+      setup: (request2) => {
+        return client["request"]("/timeback/setup", "POST", {
+          body: request2
+        });
+      },
+      verify: (gameId) => {
+        return client["request"](`/timeback/verify/${gameId}`, "GET");
+      },
+      cleanup: (gameId) => {
+        return client["request"](`/timeback/integrations/${gameId}`, "DELETE");
+      },
+      get: (gameId) => {
+        return client["request"](`/timeback/integrations/${gameId}`, "GET");
+      },
+      getConfig: (gameId) => {
+        return client["request"](`/timeback/config/${gameId}`, "GET");
+      }
+    },
+    xp: {
+      today: async (options) => {
+        const params = new URLSearchParams;
+        if (options?.date)
+          params.set("date", options.date);
+        if (options?.timezone)
+          params.set("tz", options.timezone);
+        const query = params.toString();
+        const endpoint = query ? `/timeback/xp/today?${query}` : "/timeback/xp/today";
+        return client["request"](endpoint, "GET");
+      },
+      total: async () => {
+        return client["request"]("/timeback/xp/total", "GET");
+      },
+      history: async (options) => {
+        const params = new URLSearchParams;
+        if (options?.startDate)
+          params.set("startDate", options.startDate);
+        if (options?.endDate)
+          params.set("endDate", options.endDate);
+        const query = params.toString();
+        const endpoint = query ? `/timeback/xp/history?${query}` : "/timeback/xp/history";
+        return client["request"](endpoint, "GET");
+      },
+      summary: async (options) => {
+        const [today, total] = await Promise.all([
+          client["request"]((() => {
+            const params = new URLSearchParams;
+            if (options?.date)
+              params.set("date", options.date);
+            if (options?.timezone)
+              params.set("tz", options.timezone);
+            const query = params.toString();
+            return query ? `/timeback/xp/today?${query}` : "/timeback/xp/today";
+          })(), "GET"),
+          client["request"]("/timeback/xp/total", "GET")
+        ]);
+        return { today, total };
+      }
+    },
+    enrollments: {
+      get: async (timebackId, options) => {
+        return enrollmentsCache.get(timebackId, async () => {
+          const response = await client["request"](`/timeback/enrollments/${timebackId}`, "GET");
+          return response.enrollments;
+        }, options);
+      },
+      clearCache: (timebackId) => {
+        enrollmentsCache.clear(timebackId);
+      }
+    }
+  };
+}
 // src/core/auth/strategies.ts
 class ApiKeyAuth {
   apiKey;
@@ -2623,7 +2715,7 @@ function createRealtimeNamespace(client) {
   };
 }
 // src/namespaces/game/timeback.ts
-function createTimebackNamespace(client) {
+function createTimebackNamespace2(client) {
   let currentActivity = null;
   return {
     startActivity: (metadata) => {
@@ -2688,65 +2780,6 @@ function createTimebackNamespace(client) {
         currentActivity = null;
         throw error;
       }
-    },
-    management: {
-      setup: (request2) => {
-        return client["request"]("/timeback/setup", "POST", {
-          body: request2
-        });
-      },
-      verify: (gameId) => {
-        return client["request"](`/timeback/verify/${gameId}`, "GET");
-      },
-      cleanup: (gameId) => {
-        return client["request"](`/timeback/integrations/${gameId}`, "DELETE");
-      },
-      get: (gameId) => {
-        return client["request"](`/timeback/integrations/${gameId}`, "GET");
-      },
-      getConfig: (gameId) => {
-        return client["request"](`/timeback/config/${gameId}`, "GET");
-      }
-    },
-    xp: {
-      today: async (options) => {
-        const params = new URLSearchParams;
-        if (options?.date)
-          params.set("date", options.date);
-        if (options?.timezone)
-          params.set("tz", options.timezone);
-        const query = params.toString();
-        const endpoint = query ? `/timeback/xp/today?${query}` : "/timeback/xp/today";
-        return client["request"](endpoint, "GET");
-      },
-      total: async () => {
-        return client["request"]("/timeback/xp/total", "GET");
-      },
-      history: async (options) => {
-        const params = new URLSearchParams;
-        if (options?.startDate)
-          params.set("startDate", options.startDate);
-        if (options?.endDate)
-          params.set("endDate", options.endDate);
-        const query = params.toString();
-        const endpoint = query ? `/timeback/xp/history?${query}` : "/timeback/xp/history";
-        return client["request"](endpoint, "GET");
-      },
-      summary: async (options) => {
-        const [today, total] = await Promise.all([
-          client["request"]((() => {
-            const params = new URLSearchParams;
-            if (options?.date)
-              params.set("date", options.date);
-            if (options?.timezone)
-              params.set("tz", options.timezone);
-            const query = params.toString();
-            return query ? `/timeback/xp/today?${query}` : "/timeback/xp/today";
-          })(), "GET"),
-          client["request"]("/timeback/xp/total", "GET")
-        ]);
-        return { today, total };
-      }
     }
   };
 }
@@ -2932,7 +2965,7 @@ class PlaycademyClient {
   identity = createIdentityNamespace(this);
   runtime = createRuntimeNamespace(this);
   users = createUsersNamespace(this);
-  timeback = createTimebackNamespace(this);
+  timeback = createTimebackNamespace2(this);
   credits = createCreditsNamespace(this);
   scores = createScoresNamespace(this);
   realtime = createRealtimeNamespace(this);
@@ -2958,6 +2991,7 @@ class PlaycademyInternalClient extends PlaycademyClient {
   sprites = createSpritesNamespace(this);
   telemetry = createTelemetryNamespace(this);
   scores = createScoresNamespace2(this);
+  timeback = createTimebackNamespace(this);
 }
 export {
   messaging,

package/dist/types.d.ts

@@ -1,8 +1,8 @@
 import * as _playcademy_realtime_server_types from '@playcademy/realtime/server/types';
-import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
-import { z } from 'zod';
 import * as _playcademy_timeback_types from '@playcademy/timeback/types';
 import { CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
+import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
+import { z } from 'zod';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
 /**
@@ -2121,166 +2121,6 @@ declare const playerCharacterAccessories: drizzle_orm_pg_core.PgTableWithColumns
     };
     dialect: "pg";
 }>;
-declare const gameTimebackIntegrations: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "game_timeback_integrations";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        gameId: drizzle_orm_pg_core.PgColumn<{
-            name: "game_id";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        courseId: drizzle_orm_pg_core.PgColumn<{
-            name: "course_id";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        grade: drizzle_orm_pg_core.PgColumn<{
-            name: "grade";
-            tableName: "game_timeback_integrations";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        subject: drizzle_orm_pg_core.PgColumn<{
-            name: "subject";
-            tableName: "game_timeback_integrations";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        totalXp: drizzle_orm_pg_core.PgColumn<{
-            name: "total_xp";
-            tableName: "game_timeback_integrations";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        lastVerifiedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "last_verified_at";
-            tableName: "game_timeback_integrations";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "game_timeback_integrations";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "game_timeback_integrations";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
 
 declare const achievementScopeEnum: drizzle_orm_pg_core.PgEnum<["daily", "weekly", "monthly", "yearly", "game", "global", "map", "level", "event"]>;
 declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
@@ -2830,7 +2670,6 @@ interface SpriteTemplateData {
         };
     };
 }
-type GameTimebackIntegration = typeof gameTimebackIntegrations.$inferSelect;
 type TodayXpResponse = {
     xp: number;
     date: string;
@@ -2844,56 +2683,6 @@ type XpHistoryResponse = {
         xp: number;
     }>;
 };
-type TimebackSetupRequest = {
-    gameId: string;
-    config: {
-        organization: {
-            name: string;
-            type: string;
-            identifier: string;
-        };
-        course: {
-            title: string;
-            subjects: string[];
-            grades: number[];
-            courseCode: string;
-            level: string;
-            gradingScheme: string;
-            metadata?: Record<string, unknown>;
-        };
-        component: {
-            title: string;
-            sortOrder: number;
-            prerequisites: string[];
-            prerequisiteCriteria: string;
-        };
-        resource: {
-            title: string;
-            vendorResourceId: string;
-            vendorId: string;
-            applicationId: string;
-            roles: string[];
-            importance: string;
-            metadata: {
-                type?: string;
-                launchUrl?: string;
-                toolProvider?: string;
-                instructionalMethod?: string;
-                subject?: string;
-                grades?: number[];
-                language?: string;
-                xp?: number;
-                [key: string]: unknown;
-            };
-        };
-        componentResource: {
-            title: string;
-            sortOrder: number;
-            lessonType: string | null;
-        };
-    };
-    verbose?: boolean;
-};
 /**
  * Minimal course configuration for TimeBack integration (used in user-facing config).
  *
@@ -2907,100 +2696,6 @@ type TimebackCourseConfig = {
     subject: string;
     grade: number;
 };
-/**
- * Derived course configuration after merging base + per-course overrides + templating.
- * This is what the CLI sends to the Platform API in PlatformTimebackSetupRequest.
- */
-type DerivedPlatformCourseConfig = TimebackCourseConfig & {
-    title: string;
-    courseCode: string;
-    level: string;
-    metadata?: Record<string, unknown>;
-    totalXp?: number | null;
-    masterableUnits?: number | null;
-};
-type PlatformTimebackSetupRequest = {
-    gameId: string;
-    courses: DerivedPlatformCourseConfig[];
-    baseConfig: {
-        organization: {
-            name: string;
-            type: string;
-            identifier: string;
-        };
-        component: {
-            title: string;
-            titleSuffix?: string;
-            sortOrder: number;
-            prerequisites: string[];
-            prerequisiteCriteria: string;
-        };
-        resource: {
-            title: string;
-            titleSuffix?: string;
-            vendorResourceId: string;
-            vendorId: string;
-            applicationId: string;
-            roles: string[];
-            importance: string;
-            metadata: {
-                type?: string;
-                launchUrl?: string;
-                toolProvider?: string;
-                instructionalMethod?: string;
-                language?: string;
-                [key: string]: unknown;
-            };
-        };
-        componentResource: {
-            title: string;
-            titleSuffix?: string;
-            sortOrder: number;
-            lessonType: string | null;
-        };
-    };
-    verbose?: boolean;
-};
-type PlatformTimebackSetupResponse = {
-    integrations: GameTimebackIntegration[];
-    verbose?: Array<{
-        integration: GameTimebackIntegration;
-        config: {
-            course: unknown;
-            component: unknown;
-            resource: unknown;
-            componentResource: unknown;
-        };
-    }>;
-};
-type TimebackVerificationResources = {
-    course: {
-        found: boolean;
-        data?: unknown;
-    };
-    component: {
-        found: boolean;
-        data?: unknown;
-    };
-    resource: {
-        found: boolean;
-        data?: unknown;
-    };
-    componentResource: {
-        found: boolean;
-        data?: unknown;
-    };
-};
-type TimebackVerifyCourseResult = {
-    integration: GameTimebackIntegration;
-    resources: TimebackVerificationResources;
-    status: 'success' | 'error';
-    errors?: string[];
-};
-type TimebackVerifyAllResponse = {
-    status: 'success' | 'error';
-    results: TimebackVerifyCourseResult[];
-};
 type EndActivityResponse = {
     status: 'ok';
     courseId: string;
@@ -3011,14 +2706,6 @@ type EndActivityResponse = {
     inProgress?: string;
 };
 
-/**
- * Combined response type for summary method
- */
-type XpSummaryResponse$1 = {
-    today: TodayXpResponse;
-    total: TotalXpResponse;
-};
-
 /**
  * Connection monitoring types
  *
@@ -3577,28 +3264,6 @@ declare class PlaycademyClient {
         pauseActivity: () => void;
         resumeActivity: () => void;
         endActivity: (data: _playcademy_timeback_types.EndActivityScoreData) => Promise<EndActivityResponse>;
-        management: {
-            setup: (request: PlatformTimebackSetupRequest) => Promise<PlatformTimebackSetupResponse>;
-            verify: (gameId: string) => Promise<TimebackVerifyAllResponse>;
-            cleanup: (gameId: string) => Promise<void>;
-            get: (gameId: string) => Promise<GameTimebackIntegration[]>;
-            getConfig: (gameId: string) => Promise<TimebackSetupRequest["config"]>;
-        };
-        xp: {
-            today: (options?: {
-                date?: string;
-                timezone?: string;
-            }) => Promise<TodayXpResponse>;
-            total: () => Promise<TotalXpResponse>;
-            history: (options?: {
-                startDate?: string;
-                endDate?: string;
-            }) => Promise<XpHistoryResponse>;
-            summary: (options?: {
-                date?: string;
-                timezone?: string;
-            }) => Promise<XpSummaryResponse$1>;
-        };
     };
     /** Credits methods (credits management) */
     credits: {
@@ -3868,19 +3533,6 @@ interface ScoreSubmission {
     achievedAt: Date;
 }
 
-/**
- * TimeBack namespace types
- */
-
-/**
- * Combined response type for summary method
- */
-type XpSummaryResponse = {
-    today: TodayXpResponse;
-    total: TotalXpResponse;
-    history: XpHistoryResponse;
-};
-
 /**
  * Users namespace types
  */
@@ -4040,6 +3692,41 @@ type DevUploadHooks = {
     onClose?: () => void;
 };
 
+/**
+ * Platform TimeBack Types
+ *
+ * Types for TimeBack enrollment and student data on the platform side.
+ * These are used by the cademy hub to determine which games users have access to.
+ */
+
+/**
+ * Enrollment data for a student in a specific game/course.
+ * Represents the mapping between a TimeBack course and a Playcademy game.
+ */
+interface StudentEnrollment {
+    /** The Playcademy game ID the student is enrolled in */
+    gameId: string;
+    /** The grade level for this enrollment */
+    grade: number;
+    /** The subject area (e.g., 'Math', 'Science') */
+    subject: string;
+    /** The TimeBack course ID */
+    courseId: string;
+}
+/**
+ * Response from the enrollments endpoint
+ */
+interface EnrollmentsResponse {
+    enrollments: StudentEnrollment[];
+}
+/**
+ * Combined response type for xp.summary() method
+ */
+interface XpSummaryResponse {
+    today: TodayXpResponse;
+    total: TotalXpResponse;
+}
+
 /**
  * @fileoverview Server SDK Type Definitions
  *
@@ -4219,4 +3906,4 @@ interface PlaycademyServerClientState {
 }
 
 export { PlaycademyClient };
-export type { Achievement, AchievementCurrent, AchievementProgressResponse, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponent, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionStatePayload, CreateCharacterData, Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusResponse, DisconnectContext, DisconnectHandler, DisplayAlertPayload, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameLeaderboardEntry, GameSession, GameStateData, GameTokenResponse, GameUser, HostedGame, InitPayload, InventoryItem, InventoryItemWithItem, InventoryMutationResponse, Item, KeyEventPayload, LeaderboardEntry, LevelConfig, LoginResponse, ManifestV1, Map, MapElement, MapElementWithGame, MapObject, MapObjectWithItem, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacter, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, User, UserInfo, UserLevel, UserLevelWithConfig, UserRank, UserRankResponse, UserRoleEnumType, UserScore, XpHistoryResponse, XpSummaryResponse };
+export type { Achievement, AchievementCurrent, AchievementProgressResponse, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponent, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionStatePayload, CreateCharacterData, Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusResponse, DisconnectContext, DisconnectHandler, DisplayAlertPayload, EnrollmentsResponse, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameLeaderboardEntry, GameSession, GameStateData, GameTokenResponse, GameUser, HostedGame, InitPayload, InventoryItem, InventoryItemWithItem, InventoryMutationResponse, Item, KeyEventPayload, LeaderboardEntry, LevelConfig, LoginResponse, ManifestV1, Map, MapElement, MapElementWithGame, MapObject, MapObjectWithItem, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacter, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, StudentEnrollment, TelemetryPayload, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, User, UserInfo, UserLevel, UserLevelWithConfig, UserRank, UserRankResponse, UserRoleEnumType, UserScore, XpHistoryResponse, XpSummaryResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.2.0",
+    "version": "0.2.1",
     "type": "module",
     "exports": {
         ".": {
@@ -47,7 +47,7 @@
         "@playcademy/timeback": "0.0.1",
         "@playcademy/utils": "0.0.1",
         "@types/bun": "latest",
-        "playcademy": "0.14.20",
+        "playcademy": "0.14.23",
         "rollup": "^4.50.2",
         "rollup-plugin-dts": "^6.2.3",
         "typescript": "^5.7.2"