@playcademy/sdk 0.6.1-beta.4 → 0.6.1-beta.5

package/dist/internal.d.ts

@@ -1,8 +1,8 @@
+import { SchemaInfo } from '@playcademy/cloudflare';
 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 { SchemaInfo } from '@playcademy/cloudflare';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
 /** Permitted HTTP verbs */
@@ -315,6 +315,56 @@ interface PopulateStudentResponse {
     status: string;
     message?: string;
 }
+interface 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;
+}
 interface PlatformTimebackSetupRequest {
     gameId: string;
     courses: DerivedPlatformCourseConfig[];
@@ -1304,7 +1354,7 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 
 interface GameMetadata {
@@ -1580,7 +1630,7 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "game_sessions";
@@ -1672,7 +1722,7 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 /**
  * Custom hostnames table
@@ -1873,7 +1923,7 @@ declare const gameCustomHostnames: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "items";
@@ -2050,7 +2100,7 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "inventory_items";
@@ -2142,7 +2192,7 @@ declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "currencies";
@@ -2251,7 +2301,7 @@ declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "shop_listings";
@@ -2445,7 +2495,7 @@ declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const maps: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "maps";
@@ -2596,7 +2646,7 @@ declare const maps: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const mapElements: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "map_elements";
@@ -2709,7 +2759,7 @@ declare const mapElements: drizzle_orm_pg_core.PgTableWithColumns<{
             $type: Record<string, unknown>;
         }>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const mapObjects: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "map_objects";
@@ -2869,7 +2919,7 @@ declare const mapObjects: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 
 declare const userLevels: drizzle_orm_pg_core.PgTableWithColumns<{
@@ -2996,7 +3046,7 @@ declare const userLevels: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const levelConfigs: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "level_configs";
@@ -3088,7 +3138,7 @@ declare const levelConfigs: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 
 declare const spriteTemplates: drizzle_orm_pg_core.PgTableWithColumns<{
@@ -3185,7 +3235,7 @@ declare const spriteTemplates: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const characterComponents: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "character_components";
@@ -3368,7 +3418,7 @@ declare const characterComponents: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const playerCharacters: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "player_characters";
@@ -3511,7 +3561,7 @@ declare const playerCharacters: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const playerCharacterAccessories: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "player_character_accessories";
@@ -3622,7 +3672,7 @@ declare const playerCharacterAccessories: drizzle_orm_pg_core.PgTableWithColumns
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const notifications: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "notifications";
@@ -3907,7 +3957,7 @@ declare const notifications: drizzle_orm_pg_core.PgTableWithColumns<{
             generated: undefined;
         }, {}, {}>;
     };
-    dialect: "pg";
+    dialect: 'pg';
 }>;
 declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     displayName: z.ZodString;
@@ -6905,8 +6955,8 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      */
     runtime: {
         getGameToken: (gameId: string, options?: {
-            apply?: boolean | undefined;
-        } | undefined) => Promise<GameTokenResponse>;
+            apply?: boolean;
+        }) => Promise<GameTokenResponse>;
         exit: () => Promise<void>;
         onInit: (handler: (context: GameContextPayload) => void) => void;
         onTokenRefresh: (handler: (data: {
@@ -6930,7 +6980,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
         getListenerCounts: () => Record<string, number>;
         assets: {
             url(pathOrStrings: string | TemplateStringsArray, ...values: unknown[]): string;
-            fetch: (path: string, options?: RequestInit | undefined) => Promise<Response>;
+            fetch: (path: string, options?: RequestInit) => Promise<Response>;
             json: <T = unknown>(path: string) => Promise<T>;
             blob: (path: string) => Promise<Blob>;
             text: (path: string) => Promise<string>;
@@ -6961,13 +7011,13 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `get(path)`, `post(path, body)`, `put()`, `delete()` - HTTP methods
      */
     backend: {
-        get<T = unknown>(path: string, headers?: Record<string, string> | undefined): Promise<T>;
-        post<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
-        put<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
-        patch<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
-        delete<T = unknown>(path: string, headers?: Record<string, string> | undefined): Promise<T>;
-        request<T = unknown>(path: string, method: Method, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
-        download(path: string, method?: Method, body?: unknown, headers?: Record<string, string> | undefined): Promise<Response>;
+        get<T = unknown>(path: string, headers?: Record<string, string>): Promise<T>;
+        post<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+        put<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+        patch<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+        delete<T = unknown>(path: string, headers?: Record<string, string>): Promise<T>;
+        request<T = unknown>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
+        download(path: string, method?: Method, body?: unknown, headers?: Record<string, string>): Promise<Response>;
         url(pathOrStrings: string | TemplateStringsArray, ...values: unknown[]): string;
     };
     /**
@@ -6982,21 +7032,21 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             password: string;
         }) => Promise<{
             success: boolean;
-            token?: string | undefined;
+            token?: string;
             user?: {
                 id: string;
                 email: string;
-            } | undefined;
-            expiresAt?: string | undefined;
-            error?: string | undefined;
+            };
+            expiresAt?: string;
+            error?: string;
         }>;
         logout: () => Promise<void>;
         apiKeys: {
             create: (options?: {
-                name?: string | undefined;
-                expiresIn?: number | null | undefined;
-                permissions?: Record<string, string[]> | undefined;
-            } | undefined) => Promise<BetterAuthApiKeyResponse>;
+                name?: string;
+                expiresIn?: number | null;
+                permissions?: Record<string, string[]>;
+            }) => Promise<BetterAuthApiKeyResponse>;
             list: () => Promise<BetterAuthApiKey[]>;
             revoke: (keyId: string) => Promise<void>;
         };
@@ -7013,18 +7063,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             resumeGame: (gameId: string) => Promise<void>;
         };
         items: {
-            create: (props: {
-                id?: string | undefined;
-                slug: string;
-                gameId?: string | null | undefined;
-                displayName: string;
-                description?: string | null | undefined;
-                type?: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade" | undefined;
-                isPlaceable?: boolean | undefined;
-                imageUrl?: string | null | undefined;
-                metadata?: Record<string, unknown> | undefined;
-                createdAt?: Date | undefined;
-            }) => Promise<{
+            create: (props: InsertItemInput) => Promise<{
                 createdAt: Date;
                 description: string | null;
                 displayName: string;
@@ -7060,16 +7099,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
                 slug: string;
                 type: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
             }[]>;
-            update: (itemId: string, props: {
-                slug?: string | undefined;
-                gameId?: string | null | undefined;
-                displayName?: string | undefined;
-                description?: string | null | undefined;
-                type?: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade" | undefined;
-                isPlaceable?: boolean | undefined;
-                imageUrl?: string | null | undefined;
-                metadata?: Record<string, unknown> | undefined;
-            }) => Promise<{
+            update: (itemId: string, props: UpdateItemInput) => Promise<{
                 createdAt: Date;
                 description: string | null;
                 displayName: string;
@@ -7084,14 +7114,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             delete: (itemId: string) => Promise<void>;
         };
         currencies: {
-            create: (props: {
-                id?: string | undefined;
-                itemId: string;
-                symbol?: string | null | undefined;
-                isPrimary: boolean;
-                createdAt?: Date | undefined;
-                updatedAt?: Date | null | undefined;
-            }) => Promise<{
+            create: (props: InsertCurrencyInput) => Promise<{
                 createdAt: Date;
                 id: string;
                 isPrimary: boolean;
@@ -7115,11 +7138,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
                 symbol: string | null;
                 updatedAt: Date | null;
             }[]>;
-            update: (currencyId: string, props: {
-                itemId?: string | undefined;
-                symbol?: string | null | undefined;
-                isPrimary?: boolean | undefined;
-            }) => Promise<{
+            update: (currencyId: string, props: UpdateCurrencyInput) => Promise<{
                 createdAt: Date;
                 id: string;
                 isPrimary: boolean;
@@ -7130,19 +7149,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             delete: (currencyId: string) => Promise<void>;
         };
         shopListings: {
-            create: (props: {
-                id?: string | undefined;
-                itemId: string;
-                currencyId: string;
-                price: number;
-                sellBackPercentage?: number | null | undefined;
-                stock?: number | null | undefined;
-                isActive: boolean;
-                availableFrom?: Date | null | undefined;
-                availableUntil?: Date | null | undefined;
-                createdAt?: Date | undefined;
-                updatedAt?: Date | null | undefined;
-            }) => Promise<{
+            create: (props: InsertShopListingInput) => Promise<{
                 availableFrom: Date | null;
                 availableUntil: Date | null;
                 createdAt: Date;
@@ -7181,19 +7188,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
                 stock: number | null;
                 updatedAt: Date | null;
             }[]>;
-            update: (listingId: string, props: {
-                id?: string | undefined;
-                itemId?: string | undefined;
-                currencyId?: string | undefined;
-                price?: number | undefined;
-                sellBackPercentage?: number | null | undefined;
-                stock?: number | null | undefined;
-                isActive?: boolean | undefined;
-                availableFrom?: Date | null | undefined;
-                availableUntil?: Date | null | undefined;
-                createdAt?: Date | undefined;
-                updatedAt?: Date | null | undefined;
-            }) => Promise<{
+            update: (listingId: string, props: UpdateShopListingInput) => Promise<{
                 availableFrom: Date | null;
                 availableUntil: Date | null;
                 createdAt: Date;
@@ -7218,33 +7213,17 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
     dev: {
         status: {
             apply: () => Promise<void>;
-            get: () => Promise<DeveloperStatusEnumType>;
+            get: () => Promise<DeveloperStatusValue>;
         };
         games: {
             deploy: (slug: string, options: {
-                metadata?: {
-                    displayName: string;
-                    mapElementId?: string | null | undefined;
-                    platform: "godot" | "unity" | "web";
-                    metadata: Record<string, unknown>;
-                    gameType: "external" | "hosted";
-                    visibility?: "internal" | "unlisted" | "visible" | undefined;
-                    externalUrl?: string | undefined;
-                } | undefined;
-                file?: Blob | File | null | undefined;
-                backend?: BackendDeploymentBundle | undefined;
-                hooks?: DevUploadHooks | undefined;
-            }) => Promise<Game>;
-            seed: (slug: string, code: string, environment?: "production" | "staging" | undefined, secrets?: Record<string, string> | undefined) => Promise<SeedResponse>;
-            upsert: (slug: string, metadata: {
-                displayName: string;
-                mapElementId?: string | null | undefined;
-                platform: "godot" | "unity" | "web";
-                metadata: Record<string, unknown>;
-                gameType: "external" | "hosted";
-                visibility?: "internal" | "unlisted" | "visible" | undefined;
-                externalUrl?: string | undefined;
+                metadata?: UpsertGameMetadataInput;
+                file?: File | Blob | null;
+                backend?: BackendDeploymentBundle;
+                hooks?: DevUploadHooks;
             }) => Promise<Game>;
+            seed: (slug: string, code: string, environment?: 'staging' | 'production', secrets?: Record<string, string>) => Promise<SeedResponse>;
+            upsert: (slug: string, metadata: UpsertGameMetadataInput) => Promise<Game>;
             delete: (gameId: string) => Promise<void>;
             secrets: {
                 set: (slug: string, secrets: Record<string, string>) => Promise<string[]>;
@@ -7255,7 +7234,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
                 reset: (slug: string, schema?: {
                     sql: string;
                     hash: string;
-                } | undefined) => Promise<{
+                }) => Promise<{
                     success: boolean;
                     deploymentId: string;
                     resetAt: string;
@@ -7263,13 +7242,13 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
                 }>;
             };
             bucket: {
-                list: (slug: string, prefix?: string | undefined) => Promise<BucketFile[]>;
+                list: (slug: string, prefix?: string) => Promise<BucketFile[]>;
                 get: (slug: string, key: string) => Promise<ArrayBuffer>;
-                put: (slug: string, key: string, content: ArrayBuffer | Blob | Uint8Array<ArrayBufferLike>, contentType?: string | undefined) => Promise<void>;
+                put: (slug: string, key: string, content: Blob | ArrayBuffer | Uint8Array, contentType?: string) => Promise<void>;
                 delete: (slug: string, key: string) => Promise<void>;
             };
             kv: {
-                list: (slug: string, prefix?: string | undefined) => Promise<KVKeyEntry[]>;
+                list: (slug: string, prefix?: string) => Promise<KVKeyEntry[]>;
                 get: (slug: string, key: string) => Promise<string | null>;
                 set: (slug: string, key: string, value: string) => Promise<void>;
                 delete: (slug: string, key: string) => Promise<void>;
@@ -7281,176 +7260,29 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             domains: {
                 add: (slug: string, hostname: string) => Promise<GameCustomHostname>;
                 list: (slug: string) => Promise<GameCustomHostname[]>;
-                status: (slug: string, hostname: string, refresh?: boolean | undefined) => Promise<GameCustomHostname>;
+                status: (slug: string, hostname: string, refresh?: boolean) => Promise<GameCustomHostname>;
                 delete: (slug: string, hostname: string) => Promise<void>;
             };
             logs: {
-                getToken: (slug: string, environment: "production" | "staging") => Promise<{
+                getToken: (slug: string, environment: 'staging' | 'production') => Promise<{
                     token: string;
                     workerId: string;
                 }>;
             };
         };
         items: {
-            create: (gameId: string, slug: string, itemData: Omit<{
-                id?: string | undefined;
-                slug: string;
-                gameId?: string | null | undefined;
-                displayName: string;
-                description?: string | null | undefined;
-                type?: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade" | undefined;
-                isPlaceable?: boolean | undefined;
-                imageUrl?: string | null | undefined;
-                metadata?: Record<string, unknown> | undefined;
-                createdAt?: Date | undefined;
-            }, "gameId" | "slug">) => Promise<{
-                createdAt: Date;
-                description: string | null;
-                displayName: string;
-                gameId: string | null;
-                id: string;
-                imageUrl: string | null;
-                isPlaceable: boolean;
-                metadata: unknown;
-                slug: string;
-                type: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
-            }>;
-            update: (gameId: string, itemId: string, updates: {
-                slug?: string | undefined;
-                gameId?: string | null | undefined;
-                displayName?: string | undefined;
-                description?: string | null | undefined;
-                type?: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade" | undefined;
-                isPlaceable?: boolean | undefined;
-                imageUrl?: string | null | undefined;
-                metadata?: Record<string, unknown> | undefined;
-            }) => Promise<{
-                createdAt: Date;
-                description: string | null;
-                displayName: string;
-                gameId: string | null;
-                id: string;
-                imageUrl: string | null;
-                isPlaceable: boolean;
-                metadata: unknown;
-                slug: string;
-                type: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
-            }>;
-            list: (gameId: string) => Promise<{
-                createdAt: Date;
-                description: string | null;
-                displayName: string;
-                gameId: string | null;
-                id: string;
-                imageUrl: string | null;
-                isPlaceable: boolean;
-                metadata: unknown;
-                slug: string;
-                type: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
-            }[]>;
-            get: (gameId: string, slug: string) => Promise<{
-                createdAt: Date;
-                description: string | null;
-                displayName: string;
-                gameId: string | null;
-                id: string;
-                imageUrl: string | null;
-                isPlaceable: boolean;
-                metadata: unknown;
-                slug: string;
-                type: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
-            }>;
+            create: (gameId: string, slug: string, itemData: Omit<InsertItemInput, 'slug' | 'gameId'>) => Promise<ItemRow>;
+            update: (gameId: string, itemId: string, updates: UpdateItemInput) => Promise<ItemRow>;
+            list: (gameId: string) => Promise<ItemRow[]>;
+            get: (gameId: string, slug: string) => Promise<ItemRow>;
             delete: (gameId: string, itemId: string) => Promise<void>;
             shop: {
-                create: (gameId: string, itemId: string, listingData: Omit<{
-                    id?: string | undefined;
-                    itemId: string;
-                    currencyId: string;
-                    price: number;
-                    sellBackPercentage?: number | null | undefined;
-                    stock?: number | null | undefined;
-                    isActive: boolean;
-                    availableFrom?: Date | null | undefined;
-                    availableUntil?: Date | null | undefined;
-                    createdAt?: Date | undefined;
-                    updatedAt?: Date | null | undefined;
-                }, "itemId">) => Promise<{
-                    availableFrom: Date | null;
-                    availableUntil: Date | null;
-                    createdAt: Date;
-                    currencyId: string;
-                    id: string;
-                    isActive: boolean;
-                    itemId: string;
-                    price: number;
-                    sellBackPercentage: number | null;
-                    stock: number | null;
-                    updatedAt: Date | null;
-                }>;
-                get: (gameId: string, itemId: string) => Promise<{
-                    availableFrom: Date | null;
-                    availableUntil: Date | null;
-                    createdAt: Date;
-                    currencyId: string;
-                    id: string;
-                    isActive: boolean;
-                    itemId: string;
-                    price: number;
-                    sellBackPercentage: number | null;
-                    stock: number | null;
-                    updatedAt: Date | null;
-                } | null>;
-                update: (gameId: string, itemId: string, updates: {
-                    id?: string | undefined;
-                    itemId?: string | undefined;
-                    currencyId?: string | undefined;
-                    price?: number | undefined;
-                    sellBackPercentage?: number | null | undefined;
-                    stock?: number | null | undefined;
-                    isActive?: boolean | undefined;
-                    availableFrom?: Date | null | undefined;
-                    availableUntil?: Date | null | undefined;
-                    createdAt?: Date | undefined;
-                    updatedAt?: Date | null | undefined;
-                }) => Promise<{
-                    availableFrom: Date | null;
-                    availableUntil: Date | null;
-                    createdAt: Date;
-                    currencyId: string;
-                    id: string;
-                    isActive: boolean;
-                    itemId: string;
-                    price: number;
-                    sellBackPercentage: number | null;
-                    stock: number | null;
-                    updatedAt: Date | null;
-                }>;
+                create: (gameId: string, itemId: string, listingData: Omit<InsertShopListingInput, 'itemId'>) => Promise<ShopListingRow>;
+                get: (gameId: string, itemId: string) => Promise<ShopListingRow | null>;
+                update: (gameId: string, itemId: string, updates: UpdateShopListingInput) => Promise<ShopListingRow>;
                 delete: (gameId: string, itemId: string) => Promise<void>;
-                list: (gameId: string) => Promise<({
-                    availableFrom: Date | null;
-                    availableUntil: Date | null;
-                    createdAt: Date;
-                    currencyId: string;
-                    id: string;
-                    isActive: boolean;
-                    itemId: string;
-                    price: number;
-                    sellBackPercentage: number | null;
-                    stock: number | null;
-                    updatedAt: Date | null;
-                } & {
-                    item: {
-                        createdAt: Date;
-                        description: string | null;
-                        displayName: string;
-                        gameId: string | null;
-                        id: string;
-                        imageUrl: string | null;
-                        isPlaceable: boolean;
-                        metadata: unknown;
-                        slug: string;
-                        type: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
-                    };
+                list: (gameId: string) => Promise<(ShopListingRow & {
+                    item: ItemRow;
                 })[]>;
             };
         };
@@ -7463,21 +7295,21 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `getGameToken(gameId)` - Get short-lived game auth token
      */
     games: {
-        fetch: (gameIdOrSlug: string, options?: TTLCacheConfig | undefined) => Promise<FetchedGame>;
-        list: (options?: TTLCacheConfig | undefined) => Promise<Game[]>;
+        fetch: (gameIdOrSlug: string, options?: TTLCacheConfig) => Promise<FetchedGame>;
+        list: (options?: TTLCacheConfig) => Promise<Game[]>;
         getSubjects: () => Promise<Record<string, string | null>>;
-        startSession: (gameId?: string | undefined) => Promise<StartSessionResponse>;
-        endSession: (sessionId: string, gameId?: string | undefined) => Promise<void>;
+        startSession: (gameId?: string) => Promise<StartSessionResponse>;
+        endSession: (sessionId: string, gameId?: string) => Promise<void>;
         token: {
             create: (gameId: string, options?: {
-                apply?: boolean | undefined;
-            } | undefined) => Promise<GameTokenResponse>;
+                apply?: boolean;
+            }) => Promise<GameTokenResponse>;
         };
         leaderboard: {
             get: (gameId: string, options?: {
-                limit?: number | undefined;
-                offset?: number | undefined;
-            } | undefined) => Promise<LeaderboardEntry[]>;
+                limit?: number;
+                offset?: number;
+            }) => Promise<LeaderboardEntry[]>;
         };
     };
     /**
@@ -7486,34 +7318,20 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `update(config)` - Update avatar appearance
      */
     character: {
-        get: (userId?: string | undefined) => Promise<PlayerCharacterRow | null>;
+        get: (userId?: string) => Promise<PlayerCharacterRow | null>;
         create: (characterData: CreateCharacterData) => Promise<PlayerCharacterRow>;
         update: (updates: UpdateCharacterData) => Promise<PlayerCharacterRow>;
         components: {
-            list: (options?: (CharacterComponentsOptions & TTLCacheConfig) | undefined) => Promise<CharacterComponentWithSpriteUrl[]>;
-            clearCache: (key?: string | undefined) => void;
+            list: (options?: CharacterComponentsOptions & TTLCacheConfig) => Promise<CharacterComponentWithSpriteUrl[]>;
+            clearCache: (key?: string) => void;
             getCacheKeys: () => string[];
         };
         accessories: {
-            equip: (slot: string, componentId: string) => Promise<{
-                accessoryComponentId: string;
-                equippedAt: Date;
-                id: string;
-                playerCharacterId: string;
-                slot: string;
-                updatedAt: Date;
-            }>;
+            equip: (slot: string, componentId: string) => Promise<PlayerCharacterAccessoryRow>;
             remove: (slot: string) => Promise<{
                 success: boolean;
             }>;
-            list: () => Promise<{
-                accessoryComponentId: string;
-                equippedAt: Date;
-                id: string;
-                playerCharacterId: string;
-                slot: string;
-                updatedAt: Date;
-            }[]>;
+            list: () => Promise<PlayerCharacterAccessoryRow[]>;
         };
     };
     /**
@@ -7523,11 +7341,11 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `award(achievementId)` - Grant achievement to user
      */
     achievements: {
-        list: (options?: TTLCacheConfig | undefined) => Promise<AchievementCurrent[]>;
+        list: (options?: TTLCacheConfig) => Promise<AchievementCurrent[]>;
         history: {
             list: (queryOptions?: {
-                limit?: number | undefined;
-            } | undefined, cacheOptions?: TTLCacheConfig | undefined) => Promise<AchievementHistoryEntry[]>;
+                limit?: number;
+            }, cacheOptions?: TTLCacheConfig) => Promise<AchievementHistoryEntry[]>;
         };
         progress: {
             submit: (achievementId: string) => Promise<AchievementProgressResponse>;
@@ -7539,7 +7357,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `submit(leaderboardId, score)` - Submit score to leaderboard
      */
     leaderboard: {
-        fetch: (options?: LeaderboardOptions | undefined) => Promise<GameLeaderboardEntry[]>;
+        fetch: (options?: LeaderboardOptions) => Promise<GameLeaderboardEntry[]>;
         getUserRank: (gameId: string, userId: string) => Promise<UserRank | null>;
     };
     /**
@@ -7548,36 +7366,16 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `addXp(amount)` - Award XP to user
      */
     levels: {
-        get: () => Promise<{
-            createdAt: Date;
-            currentLevel: number;
-            currentXp: number;
-            lastLevelUpAt: Date | null;
-            totalXP: number;
-            updatedAt: Date | null;
-            userId: string;
-        }>;
-        progress: (options?: CooldownCacheConfig | undefined) => Promise<{
+        get: () => Promise<UserLevelRow>;
+        progress: (options?: CooldownCacheConfig) => Promise<{
             level: number;
             currentXp: number;
             xpToNextLevel: number;
             totalXP: number;
         }>;
         config: {
-            list: () => Promise<{
-                createdAt: Date;
-                creditsReward: number;
-                id: string;
-                level: number;
-                xpRequired: number;
-            }[]>;
-            get: (level: number) => Promise<{
-                createdAt: Date;
-                creditsReward: number;
-                id: string;
-                level: number;
-                xpRequired: number;
-            } | null>;
+            list: () => Promise<LevelConfigRow[]>;
+            get: (level: number) => Promise<LevelConfigRow | null>;
         };
     };
     /**
@@ -7595,108 +7393,23 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      */
     notifications: {
         list: (queryOptions?: {
-            status?: NotificationStatus | undefined;
-            type?: NotificationType | undefined;
-            limit?: number | undefined;
-            offset?: number | undefined;
-        } | undefined, cacheOptions?: TTLCacheConfig | undefined) => Promise<{
-            clickUrl: string | null;
-            clickedAt: Date | null;
-            createdAt: Date;
-            data: unknown;
-            deliveredAt: Date | null;
-            expiresAt: Date | null;
-            id: string;
-            message: string;
-            metadata: unknown;
-            method: string | null;
-            priority: "high" | "low" | "normal" | "urgent";
-            seenAt: Date | null;
-            status: "clicked" | "delivered" | "dismissed" | "expired" | "pending" | "seen";
-            title: string;
-            type: string;
-            userId: string;
-        }[]>;
-        markAsSeen: (notificationId: string) => Promise<{
-            clickUrl: string | null;
-            clickedAt: Date | null;
-            createdAt: Date;
-            data: unknown;
-            deliveredAt: Date | null;
-            expiresAt: Date | null;
-            id: string;
-            message: string;
-            metadata: unknown;
-            method: string | null;
-            priority: "high" | "low" | "normal" | "urgent";
-            seenAt: Date | null;
-            status: "clicked" | "delivered" | "dismissed" | "expired" | "pending" | "seen";
-            title: string;
-            type: string;
-            userId: string;
-        }>;
-        markAsClicked: (notificationId: string) => Promise<{
-            clickUrl: string | null;
-            clickedAt: Date | null;
-            createdAt: Date;
-            data: unknown;
-            deliveredAt: Date | null;
-            expiresAt: Date | null;
-            id: string;
-            message: string;
-            metadata: unknown;
-            method: string | null;
-            priority: "high" | "low" | "normal" | "urgent";
-            seenAt: Date | null;
-            status: "clicked" | "delivered" | "dismissed" | "expired" | "pending" | "seen";
-            title: string;
-            type: string;
-            userId: string;
-        }>;
-        dismiss: (notificationId: string) => Promise<{
-            clickUrl: string | null;
-            clickedAt: Date | null;
-            createdAt: Date;
-            data: unknown;
-            deliveredAt: Date | null;
-            expiresAt: Date | null;
-            id: string;
-            message: string;
-            metadata: unknown;
-            method: string | null;
-            priority: "high" | "low" | "normal" | "urgent";
-            seenAt: Date | null;
-            status: "clicked" | "delivered" | "dismissed" | "expired" | "pending" | "seen";
-            title: string;
-            type: string;
-            userId: string;
-        }>;
-        markAsDelivered: (notificationId: string, method?: NotificationMethod) => Promise<{
-            clickUrl: string | null;
-            clickedAt: Date | null;
-            createdAt: Date;
-            data: unknown;
-            deliveredAt: Date | null;
-            expiresAt: Date | null;
-            id: string;
-            message: string;
-            metadata: unknown;
-            method: string | null;
-            priority: "high" | "low" | "normal" | "urgent";
-            seenAt: Date | null;
-            status: "clicked" | "delivered" | "dismissed" | "expired" | "pending" | "seen";
-            title: string;
-            type: string;
-            userId: string;
-        }>;
+            status?: NotificationStatus;
+            type?: NotificationType;
+            limit?: number;
+            offset?: number;
+        }, cacheOptions?: TTLCacheConfig) => Promise<NotificationRow[]>;
+        markAsSeen: (notificationId: string) => Promise<NotificationRow>;
+        markAsClicked: (notificationId: string) => Promise<NotificationRow>;
+        dismiss: (notificationId: string) => Promise<NotificationRow>;
+        markAsDelivered: (notificationId: string, method?: NotificationMethod) => Promise<NotificationRow>;
         deliverPending: () => Promise<{
             success: boolean;
         }>;
         stats: {
             get: (queryOptions?: {
-                from?: string | undefined;
-                to?: string | undefined;
-            } | undefined, cacheOptions?: TTLCacheConfig | undefined) => Promise<NotificationStats>;
+                from?: string;
+                to?: string;
+            }, cacheOptions?: TTLCacheConfig) => Promise<NotificationStats>;
         };
     };
     /**
@@ -7705,8 +7418,8 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `unlock(areaId)` - Unlock a new map area
      */
     maps: {
-        get: (identifier: string, options?: TTLCacheConfig | undefined) => Promise<MapData>;
-        elements: (mapId: string, options?: TTLCacheConfig | undefined) => Promise<MapElementWithGame[]>;
+        get: (identifier: string, options?: TTLCacheConfig) => Promise<MapData>;
+        elements: (mapId: string, options?: TTLCacheConfig) => Promise<MapElementWithGame[]>;
         objects: {
             list: (mapId: string) => Promise<MapObjectWithItem[]>;
             create: (mapId: string, objectData: CreateMapObjectData) => Promise<MapObjectWithItem>;
@@ -7737,10 +7450,10 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
      * - `getByUser(userId)` - Get all scores for a user
      */
     scores: {
-        submit: (gameId: string, score: number, metadata?: Record<string, unknown> | undefined) => Promise<ScoreSubmission>;
+        submit: (gameId: string, score: number, metadata?: Record<string, unknown>) => Promise<ScoreSubmission>;
         getByUser: (gameId: string, userId: string, options?: {
-            limit?: number | undefined;
-        } | undefined) => Promise<UserScore[]>;
+            limit?: number;
+        }) => Promise<UserScore[]>;
     };
     /**
      * TimeBack integration for user context, XP tracking, and course management.
@@ -7761,9 +7474,9 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
     timeback: {
         readonly user: PlatformTimebackUser;
         populateStudent: (names?: {
-            firstName?: string | undefined;
-            lastName?: string | undefined;
-        } | undefined) => Promise<PopulateStudentResponse>;
+            firstName?: string;
+            lastName?: string;
+        }) => Promise<PopulateStudentResponse>;
         startActivity: (_metadata: ActivityData) => void;
         pauseActivity: () => void;
         resumeActivity: () => void;
@@ -7773,82 +7486,37 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             verify: (gameId: string) => Promise<TimebackVerifyAllResponse>;
             cleanup: (gameId: string) => Promise<void>;
             get: (gameId: string) => Promise<GameTimebackIntegration[]>;
-            getConfig: (gameId: string) => Promise<{
-                organization: {
-                    name: string;
-                    type: string;
-                    identifier: string;
-                };
-                course: {
-                    title: string;
-                    subjects: string[];
-                    grades: number[];
-                    courseCode: string;
-                    level: string;
-                    gradingScheme: string;
-                    metadata?: Record<string, unknown> | undefined;
-                };
-                component: {
-                    title: string;
-                    sortOrder: number;
-                    prerequisites: string[];
-                    prerequisiteCriteria: string;
-                };
-                resource: {
-                    title: string;
-                    vendorResourceId: string;
-                    vendorId: string;
-                    applicationId: string;
-                    roles: string[];
-                    importance: string;
-                    metadata: {
-                        [key: string]: unknown;
-                        type?: string | undefined;
-                        launchUrl?: string | undefined;
-                        toolProvider?: string | undefined;
-                        instructionalMethod?: string | undefined;
-                        subject?: string | undefined;
-                        grades?: number[] | undefined;
-                        language?: string | undefined;
-                        xp?: number | undefined;
-                    };
-                };
-                componentResource: {
-                    title: string;
-                    sortOrder: number;
-                    lessonType: string | null;
-                };
-            }>;
+            getConfig: (gameId: string) => Promise<TimebackSetupRequest['config']>;
         };
         xp: {
             today: (options?: {
-                date?: string | undefined;
-                timezone?: string | undefined;
-            } | undefined) => Promise<TodayXpResponse>;
+                date?: string;
+                timezone?: string;
+            }) => Promise<TodayXpResponse>;
             total: () => Promise<TotalXpResponse>;
             history: (options?: {
-                startDate?: string | undefined;
-                endDate?: string | undefined;
-            } | undefined) => Promise<XpHistoryResponse>;
+                startDate?: string;
+                endDate?: string;
+            }) => Promise<XpHistoryResponse>;
             summary: (options?: {
-                date?: string | undefined;
-                timezone?: string | undefined;
-            } | undefined) => Promise<XpSummaryResponse>;
+                date?: string;
+                timezone?: string;
+            }) => Promise<XpSummaryResponse>;
         };
         students: {
-            get: (timebackId: string, options?: TTLCacheConfig | undefined) => Promise<PlatformTimebackUserContext>;
-            clearCache: (timebackId?: string | undefined) => void;
+            get: (timebackId: string, options?: TTLCacheConfig) => Promise<PlatformTimebackUserContext>;
+            clearCache: (timebackId?: string) => void;
         };
         admin: {
             getRoster: (gameId: string, courseId: string) => Promise<TimebackRosterResponse>;
             getStudentOverview: (timebackId: string, options: {
                 gameId: string;
-                courseId?: string | undefined;
+                courseId?: string;
             }) => Promise<TimebackStudentOverviewResponse>;
             getStudentActivity: (timebackId: string, courseId: string, options: {
                 gameId: string;
-                limit?: number | undefined;
-                offset?: number | undefined;
+                limit?: number;
+                offset?: number;
             }) => Promise<TimebackStudentActivityResponse>;
             grantXp: (request: GrantTimebackXpRequest) => Promise<TimebackAdminMutationResponse>;
             adjustTime: (request: AdjustTimebackTimeRequest) => Promise<TimebackAdminMutationResponse>;