@playcademy/sdk 0.1.18 → 0.2.1

package/dist/types.d.ts

@@ -1,12 +1,24 @@
-import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
-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_realtime_server_types from '@playcademy/realtime/server/types';
 import * as _playcademy_timeback_types from '@playcademy/timeback/types';
-import { OrganizationConfig, CourseConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
-import { SchemaInfo } from '@playcademy/cloudflare';
+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';
+
+/**
+ * OAuth 2.0 implementation for the Playcademy SDK
+ */
+
+/**
+ * Parses an OAuth state parameter to extract CSRF token and any encoded data.
+ *
+ * @param state - The OAuth state parameter to parse
+ * @returns Object containing CSRF token and optional decoded data
+ */
+declare function parseOAuthState(state: string): {
+    csrfToken: string;
+    data?: Record<string, string>;
+};
 
 declare const userRoleEnum: drizzle_orm_pg_core.PgEnum<["admin", "player", "developer"]>;
 declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
@@ -226,23 +238,6 @@ type GameMetadata = {
     emoji?: string;
     [key: string]: unknown;
 };
-/**
- * DNS validation records for custom hostname
- * Structure for the validationRecords JSON field in game_custom_hostnames table
- */
-type CustomHostnameValidationRecords = {
-    /** TXT record for ownership verification */
-    ownership?: {
-        name?: string;
-        value?: string;
-        type?: string;
-    };
-    /** TXT records for SSL certificate validation */
-    ssl?: Array<{
-        txt_name?: string;
-        txt_value?: string;
-    }>;
-};
 declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "games";
     schema: undefined;
@@ -571,207 +566,6 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-/**
- * Custom hostnames table
- *
- * Stores custom domain mappings for games with SSL provisioning via Cloudflare.
- */
-declare const gameCustomHostnames: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "game_custom_hostnames";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "game_custom_hostnames";
-            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_custom_hostnames";
-            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;
-        }, {}, {}>;
-        userId: drizzle_orm_pg_core.PgColumn<{
-            name: "user_id";
-            tableName: "game_custom_hostnames";
-            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;
-        }, {}, {}>;
-        hostname: drizzle_orm_pg_core.PgColumn<{
-            name: "hostname";
-            tableName: "game_custom_hostnames";
-            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;
-        }, {}, {}>;
-        cloudflareId: drizzle_orm_pg_core.PgColumn<{
-            name: "cloudflare_id";
-            tableName: "game_custom_hostnames";
-            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;
-        }, {}, {}>;
-        environment: drizzle_orm_pg_core.PgColumn<{
-            name: "environment";
-            tableName: "game_custom_hostnames";
-            dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "staging" | "production";
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["staging", "production"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        status: drizzle_orm_pg_core.PgColumn<{
-            name: "status";
-            tableName: "game_custom_hostnames";
-            dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "pending" | "pending_validation" | "pending_deployment" | "pending_deletion" | "active" | "blocked" | "deleted";
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["pending", "pending_validation", "pending_deployment", "pending_deletion", "active", "blocked", "deleted"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        sslStatus: drizzle_orm_pg_core.PgColumn<{
-            name: "ssl_status";
-            tableName: "game_custom_hostnames";
-            dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "pending_validation" | "pending_deployment" | "active" | "deleted" | "initializing" | "pending_issuance";
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["initializing", "pending_validation", "pending_issuance", "pending_deployment", "active", "deleted"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        validationRecords: drizzle_orm_pg_core.PgColumn<{
-            name: "validation_records";
-            tableName: "game_custom_hostnames";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: CustomHostnameValidationRecords;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            $type: CustomHostnameValidationRecords;
-        }>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "game_custom_hostnames";
-            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_custom_hostnames";
-            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 items: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "items";
     schema: undefined;
@@ -1150,13 +944,13 @@ declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "shop_listings";
+declare const maps: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "maps";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "shop_listings";
+            tableName: "maps";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -1171,11 +965,11 @@ declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        itemId: drizzle_orm_pg_core.PgColumn<{
-            name: "item_id";
-            tableName: "shop_listings";
+        identifier: drizzle_orm_pg_core.PgColumn<{
+            name: "identifier";
+            tableName: "maps";
             dataType: "string";
-            columnType: "PgUUID";
+            columnType: "PgVarchar";
             data: string;
             driverParam: string;
             notNull: true;
@@ -1183,16 +977,18 @@ declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        currencyId: drizzle_orm_pg_core.PgColumn<{
-            name: "currency_id";
-            tableName: "shop_listings";
+        }, {}, {
+            length: 255;
+        }>;
+        displayName: drizzle_orm_pg_core.PgColumn<{
+            name: "display_name";
+            tableName: "maps";
             dataType: "string";
-            columnType: "PgUUID";
+            columnType: "PgVarchar";
             data: string;
             driverParam: string;
             notNull: true;
@@ -1200,241 +996,45 @@ declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        price: drizzle_orm_pg_core.PgColumn<{
-            name: "price";
-            tableName: "shop_listings";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
+        }, {}, {
+            length: 255;
+        }>;
+        filePath: drizzle_orm_pg_core.PgColumn<{
+            name: "file_path";
+            tableName: "maps";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        sellBackPercentage: drizzle_orm_pg_core.PgColumn<{
-            name: "sell_back_percentage";
-            tableName: "shop_listings";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
+        }, {}, {
+            length: 255;
+        }>;
+        tilesetBasePath: drizzle_orm_pg_core.PgColumn<{
+            name: "tileset_base_path";
+            tableName: "maps";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        stock: drizzle_orm_pg_core.PgColumn<{
-            name: "stock";
-            tableName: "shop_listings";
-            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;
-        }, {}, {}>;
-        isActive: drizzle_orm_pg_core.PgColumn<{
-            name: "is_active";
-            tableName: "shop_listings";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        availableFrom: drizzle_orm_pg_core.PgColumn<{
-            name: "available_from";
-            tableName: "shop_listings";
-            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;
-        }, {}, {}>;
-        availableUntil: drizzle_orm_pg_core.PgColumn<{
-            name: "available_until";
-            tableName: "shop_listings";
-            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: "shop_listings";
-            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: "shop_listings";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-declare const maps: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "maps";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "maps";
-            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;
-        }, {}, {}>;
-        identifier: drizzle_orm_pg_core.PgColumn<{
-            name: "identifier";
-            tableName: "maps";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        displayName: drizzle_orm_pg_core.PgColumn<{
-            name: "display_name";
-            tableName: "maps";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        filePath: drizzle_orm_pg_core.PgColumn<{
-            name: "file_path";
-            tableName: "maps";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        tilesetBasePath: drizzle_orm_pg_core.PgColumn<{
-            name: "tileset_base_path";
-            tableName: "maps";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
@@ -2521,32 +2121,36 @@ declare const playerCharacterAccessories: drizzle_orm_pg_core.PgTableWithColumns
     };
     dialect: "pg";
 }>;
-declare const gameTimebackIntegrations: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "game_timeback_integrations";
+
+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<{
+    name: "achievements";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "game_timeback_integrations";
+            tableName: "achievements";
             dataType: "string";
-            columnType: "PgUUID";
+            columnType: "PgVarchar";
             data: string;
             driverParam: string;
             notNull: true;
-            hasDefault: true;
+            hasDefault: false;
             isPrimaryKey: true;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        gameId: drizzle_orm_pg_core.PgColumn<{
-            name: "game_id";
-            tableName: "game_timeback_integrations";
+        }, {}, {
+            length: 255;
+        }>;
+        title: drizzle_orm_pg_core.PgColumn<{
+            name: "title";
+            tableName: "achievements";
             dataType: "string";
-            columnType: "PgUUID";
+            columnType: "PgVarchar";
             data: string;
             driverParam: string;
             notNull: true;
@@ -2554,19 +2158,21 @@ declare const gameTimebackIntegrations: drizzle_orm_pg_core.PgTableWithColumns<{
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        courseId: drizzle_orm_pg_core.PgColumn<{
-            name: "course_id";
-            tableName: "game_timeback_integrations";
+        }, {}, {
+            length: 255;
+        }>;
+        description: drizzle_orm_pg_core.PgColumn<{
+            name: "description";
+            tableName: "achievements";
             dataType: "string";
             columnType: "PgText";
             data: string;
             driverParam: string;
-            notNull: true;
+            notNull: false;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -2576,30 +2182,30 @@ declare const gameTimebackIntegrations: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        lastVerifiedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "last_verified_at";
-            tableName: "game_timeback_integrations";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
+        scope: drizzle_orm_pg_core.PgColumn<{
+            name: "scope";
+            tableName: "achievements";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "map" | "game" | "level" | "daily" | "weekly" | "monthly" | "yearly" | "global" | "event";
             driverParam: string;
-            notNull: false;
+            notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: ["daily", "weekly", "monthly", "yearly", "game", "global", "map", "level", "event"];
             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;
+        rewardCredits: drizzle_orm_pg_core.PgColumn<{
+            name: "reward_credits";
+            tableName: "achievements";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
@@ -2610,128 +2216,13 @@ declare const gameTimebackIntegrations: drizzle_orm_pg_core.PgTableWithColumns<{
             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<{
-    name: "achievements";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "achievements";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        title: drizzle_orm_pg_core.PgColumn<{
-            name: "title";
-            tableName: "achievements";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        description: drizzle_orm_pg_core.PgColumn<{
-            name: "description";
-            tableName: "achievements";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        scope: drizzle_orm_pg_core.PgColumn<{
-            name: "scope";
-            tableName: "achievements";
-            dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "map" | "game" | "level" | "daily" | "weekly" | "monthly" | "yearly" | "global" | "event";
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["daily", "weekly", "monthly", "yearly", "game", "global", "map", "level", "event"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        rewardCredits: drizzle_orm_pg_core.PgColumn<{
-            name: "reward_credits";
-            tableName: "achievements";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        limit: drizzle_orm_pg_core.PgColumn<{
-            name: "limit";
-            tableName: "achievements";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
+        limit: drizzle_orm_pg_core.PgColumn<{
+            name: "limit";
+            tableName: "achievements";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
@@ -2849,291 +2340,6 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-declare const notifications: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "notifications";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        userId: drizzle_orm_pg_core.PgColumn<{
-            name: "user_id";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        type: drizzle_orm_pg_core.PgColumn<{
-            name: "type";
-            tableName: "notifications";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 50;
-        }>;
-        title: drizzle_orm_pg_core.PgColumn<{
-            name: "title";
-            tableName: "notifications";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        message: drizzle_orm_pg_core.PgColumn<{
-            name: "message";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        data: drizzle_orm_pg_core.PgColumn<{
-            name: "data";
-            tableName: "notifications";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        priority: drizzle_orm_pg_core.PgColumn<{
-            name: "priority";
-            tableName: "notifications";
-            dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "low" | "normal" | "high" | "urgent";
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["low", "normal", "high", "urgent"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        status: drizzle_orm_pg_core.PgColumn<{
-            name: "status";
-            tableName: "notifications";
-            dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "pending" | "delivered" | "seen" | "clicked" | "dismissed" | "expired";
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["pending", "delivered", "seen", "clicked", "dismissed", "expired"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        deliveredAt: drizzle_orm_pg_core.PgColumn<{
-            name: "delivered_at";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        seenAt: drizzle_orm_pg_core.PgColumn<{
-            name: "seen_at";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        clickedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "clicked_at";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        expiresAt: drizzle_orm_pg_core.PgColumn<{
-            name: "expires_at";
-            tableName: "notifications";
-            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;
-        }, {}, {}>;
-        method: drizzle_orm_pg_core.PgColumn<{
-            name: "method";
-            tableName: "notifications";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 50;
-        }>;
-        clickUrl: drizzle_orm_pg_core.PgColumn<{
-            name: "click_url";
-            tableName: "notifications";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        metadata: drizzle_orm_pg_core.PgColumn<{
-            name: "metadata";
-            tableName: "notifications";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
 declare const DeveloperStatusResponseSchema: z.ZodObject<{
     status: z.ZodEnum<["none", "pending", "approved"]>;
 }, "strip", z.ZodTypeAny, {
@@ -3141,42 +2347,6 @@ declare const DeveloperStatusResponseSchema: z.ZodObject<{
 }, {
     status: "none" | "pending" | "approved";
 }>;
-declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
-    displayName: z.ZodString;
-    mapElementId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-    platform: z.ZodEnum<["web", "godot", "unity"]>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    gameType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hosted", "external"]>>>;
-    externalUrl: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    displayName: string;
-    gameType: "hosted" | "external";
-    platform: "web" | "godot" | "unity";
-    metadata: Record<string, unknown>;
-    externalUrl?: string | undefined;
-    mapElementId?: string | null | undefined;
-}, {
-    displayName: string;
-    platform: "web" | "godot" | "unity";
-    gameType?: "hosted" | "external" | undefined;
-    externalUrl?: string | undefined;
-    mapElementId?: string | null | undefined;
-    metadata?: Record<string, unknown> | undefined;
-}>, {
-    displayName: string;
-    gameType: "hosted" | "external";
-    platform: "web" | "godot" | "unity";
-    metadata: Record<string, unknown>;
-    externalUrl?: string | undefined;
-    mapElementId?: string | null | undefined;
-}, {
-    displayName: string;
-    platform: "web" | "godot" | "unity";
-    gameType?: "hosted" | "external" | undefined;
-    externalUrl?: string | undefined;
-    mapElementId?: string | null | undefined;
-    metadata?: Record<string, unknown> | undefined;
-}>;
 /**
  * Simplified game manifest for Cloudflare Workers deployments
  *
@@ -3204,299 +2374,6 @@ declare const ManifestV1Schema: z.ZodObject<{
     version: string;
     platform: string;
 }>;
-declare const InsertItemSchema: drizzle_zod.BuildSchema<"insert", {
-    id: drizzle_orm_pg_core.PgColumn<{
-        name: "id";
-        tableName: "items";
-        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;
-    }, {}, {}>;
-    slug: drizzle_orm_pg_core.PgColumn<{
-        name: "slug";
-        tableName: "items";
-        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;
-    }, {}, {}>;
-    gameId: drizzle_orm_pg_core.PgColumn<{
-        name: "game_id";
-        tableName: "items";
-        dataType: "string";
-        columnType: "PgUUID";
-        data: string;
-        driverParam: string;
-        notNull: false;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: undefined;
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    displayName: drizzle_orm_pg_core.PgColumn<{
-        name: "display_name";
-        tableName: "items";
-        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;
-    }, {}, {}>;
-    description: drizzle_orm_pg_core.PgColumn<{
-        name: "description";
-        tableName: "items";
-        dataType: "string";
-        columnType: "PgText";
-        data: string;
-        driverParam: string;
-        notNull: false;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: [string, ...string[]];
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    type: drizzle_orm_pg_core.PgColumn<{
-        name: "type";
-        tableName: "items";
-        dataType: "string";
-        columnType: "PgEnumColumn";
-        data: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "accessory" | "other";
-        driverParam: string;
-        notNull: true;
-        hasDefault: true;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: ["currency", "badge", "trophy", "collectible", "consumable", "unlock", "upgrade", "accessory", "other"];
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    isPlaceable: drizzle_orm_pg_core.PgColumn<{
-        name: "is_placeable";
-        tableName: "items";
-        dataType: "boolean";
-        columnType: "PgBoolean";
-        data: boolean;
-        driverParam: boolean;
-        notNull: true;
-        hasDefault: true;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: undefined;
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    imageUrl: drizzle_orm_pg_core.PgColumn<{
-        name: "image_url";
-        tableName: "items";
-        dataType: "string";
-        columnType: "PgText";
-        data: string;
-        driverParam: string;
-        notNull: false;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: [string, ...string[]];
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    metadata: drizzle_orm_pg_core.PgColumn<{
-        name: "metadata";
-        tableName: "items";
-        dataType: "json";
-        columnType: "PgJsonb";
-        data: unknown;
-        driverParam: unknown;
-        notNull: false;
-        hasDefault: true;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: undefined;
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    createdAt: drizzle_orm_pg_core.PgColumn<{
-        name: "created_at";
-        tableName: "items";
-        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;
-    }, {}, {}>;
-}, {
-    imageUrl: z.ZodNullable<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}>;
-declare const UpdateItemSchema: z.ZodObject<Omit<{
-    id: z.ZodOptional<z.ZodString>;
-    slug: z.ZodOptional<z.ZodString>;
-    gameId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    displayName: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    type: z.ZodOptional<z.ZodEnum<["currency", "badge", "trophy", "collectible", "consumable", "unlock", "upgrade", "accessory", "other"]>>;
-    isPlaceable: z.ZodOptional<z.ZodBoolean>;
-    imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    createdAt: z.ZodOptional<z.ZodDate>;
-}, "id" | "createdAt">, "strip", z.ZodTypeAny, {
-    slug?: string | undefined;
-    description?: string | null | undefined;
-    displayName?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
-    gameId?: string | null | undefined;
-    type?: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "accessory" | "other" | undefined;
-    isPlaceable?: boolean | undefined;
-    imageUrl?: string | null | undefined;
-}, {
-    slug?: string | undefined;
-    description?: string | null | undefined;
-    displayName?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
-    gameId?: string | null | undefined;
-    type?: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "accessory" | "other" | undefined;
-    isPlaceable?: boolean | undefined;
-    imageUrl?: string | null | undefined;
-}>;
-declare const InsertCurrencySchema: z.ZodObject<Omit<{
-    id: z.ZodOptional<z.ZodString>;
-    itemId: z.ZodString;
-    symbol: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    isPrimary: z.ZodDefault<z.ZodBoolean>;
-    createdAt: z.ZodOptional<z.ZodDate>;
-    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
-}, "id" | "createdAt" | "updatedAt">, "strip", z.ZodTypeAny, {
-    itemId: string;
-    isPrimary: boolean;
-    symbol?: string | null | undefined;
-}, {
-    itemId: string;
-    symbol?: string | null | undefined;
-    isPrimary?: boolean | undefined;
-}>;
-declare const UpdateCurrencySchema: z.ZodObject<{
-    symbol: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-    itemId: z.ZodOptional<z.ZodString>;
-    isPrimary: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    symbol?: string | null | undefined;
-    itemId?: string | undefined;
-    isPrimary?: boolean | undefined;
-}, {
-    symbol?: string | null | undefined;
-    itemId?: string | undefined;
-    isPrimary?: boolean | undefined;
-}>;
-declare const InsertShopListingSchema: z.ZodObject<Omit<{
-    id: z.ZodOptional<z.ZodString>;
-    itemId: z.ZodString;
-    currencyId: z.ZodString;
-    price: z.ZodNumber;
-    sellBackPercentage: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-    stock: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-    isActive: z.ZodDefault<z.ZodBoolean>;
-    availableFrom: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
-    availableUntil: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
-    createdAt: z.ZodOptional<z.ZodDate>;
-    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
-}, "id" | "createdAt" | "updatedAt">, "strip", z.ZodTypeAny, {
-    isActive: boolean;
-    itemId: string;
-    currencyId: string;
-    price: number;
-    sellBackPercentage?: number | null | undefined;
-    stock?: number | null | undefined;
-    availableFrom?: Date | null | undefined;
-    availableUntil?: Date | null | undefined;
-}, {
-    itemId: string;
-    currencyId: string;
-    price: number;
-    isActive?: boolean | undefined;
-    sellBackPercentage?: number | null | undefined;
-    stock?: number | null | undefined;
-    availableFrom?: Date | null | undefined;
-    availableUntil?: Date | null | undefined;
-}>;
-declare const UpdateShopListingSchema: z.ZodObject<{
-    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
-    itemId: z.ZodOptional<z.ZodString>;
-    currencyId: z.ZodOptional<z.ZodString>;
-    price: z.ZodOptional<z.ZodNumber>;
-    sellBackPercentage: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNumber>>>;
-    stock: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNumber>>>;
-    availableFrom: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodDate>>>;
-    availableUntil: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodDate>>>;
-}, "strip", z.ZodTypeAny, {
-    isActive?: boolean | undefined;
-    itemId?: string | undefined;
-    currencyId?: string | undefined;
-    price?: number | undefined;
-    sellBackPercentage?: number | null | undefined;
-    stock?: number | null | undefined;
-    availableFrom?: Date | null | undefined;
-    availableUntil?: Date | null | undefined;
-}, {
-    isActive?: boolean | undefined;
-    itemId?: string | undefined;
-    currencyId?: string | undefined;
-    price?: number | undefined;
-    sellBackPercentage?: number | null | undefined;
-    stock?: number | null | undefined;
-    availableFrom?: Date | null | undefined;
-    availableUntil?: Date | null | undefined;
-}>;
 
 declare enum AchievementCompletionType {
     TIME_PLAYED_SESSION = "time_played_session",
@@ -3528,17 +2405,6 @@ interface AchievementCurrent {
     windowStart: string;
     windowEnd: string;
 }
-/**
- * Achievement claim history entry
- * Used in GET /api/achievements/history
- */
-interface AchievementHistoryEntry {
-    achievementId: string;
-    title: string;
-    rewardCredits: number;
-    createdAt: string;
-    scopeKey: string;
-}
 /**
  * Achievement progress submission response
  * Used in POST /api/achievements/progress
@@ -3551,30 +2417,6 @@ interface AchievementProgressResponse {
     createdAt: string;
 }
 
-declare enum NotificationType {
-    ACHIEVEMENT = "achievement",
-    SYSTEM = "system",
-    PROMO = "promo"
-}
-declare enum NotificationStatus {
-    PENDING = "pending",
-    DELIVERED = "delivered",
-    SEEN = "seen",
-    CLICKED = "clicked",
-    DISMISSED = "dismissed",
-    EXPIRED = "expired"
-}
-type Notification = InferSelectModel<typeof notifications>;
-interface NotificationStats {
-    total: number;
-    delivered: number;
-    seen: number;
-    clicked: number;
-    dismissed: number;
-    expired: number;
-    clickThroughRate: number;
-}
-
 type CharacterComponent = typeof characterComponents.$inferSelect;
 type PlayerCharacter = typeof playerCharacters.$inferSelect & {
     accessories?: PlayerCharacterAccessory[];
@@ -3595,18 +2437,9 @@ type ExternalGame = BaseGame & {
 type Game = HostedGame | ExternalGame;
 type GameSession = typeof gameSessions.$inferSelect;
 type GameStateData = Record<string, unknown>;
-type GameCustomHostname = typeof gameCustomHostnames.$inferSelect;
-type UpsertGameMetadataInput = z.infer<typeof UpsertGameMetadataSchema>;
 type Item = typeof items.$inferSelect;
 type InventoryItem = typeof inventoryItems.$inferSelect;
 type Currency = typeof currencies.$inferSelect;
-type ShopListing = typeof shopListings.$inferSelect;
-type InsertItemInput = z.infer<typeof InsertItemSchema>;
-type UpdateItemInput = z.infer<typeof UpdateItemSchema>;
-type InsertCurrencyInput = z.infer<typeof InsertCurrencySchema>;
-type UpdateCurrencyInput = z.infer<typeof UpdateCurrencySchema>;
-type InsertShopListingInput = z.infer<typeof InsertShopListingSchema>;
-type UpdateShopListingInput = z.infer<typeof UpdateShopListingSchema>;
 interface PlaceableItemMetadata {
     tilesWide?: number;
     tilesHigh?: number;
@@ -3616,28 +2449,10 @@ interface PlaceableItemMetadata {
 type Map = typeof maps.$inferSelect;
 type MapElement = typeof mapElements.$inferSelect;
 type MapObject = typeof mapObjects.$inferSelect;
-interface MapData {
-    id: string;
-    identifier: string;
-    displayName: string;
-    description?: string;
-    metadata?: Record<string, unknown>;
-}
-interface CreateMapObjectData {
-    itemId: string;
-    worldX: number;
-    worldY: number;
-    width?: number;
-    height?: number;
-    rotation?: number;
-    scale?: number;
-    metadata?: Record<string, unknown>;
-}
 
 type User = typeof users.$inferSelect;
 type UserRoleEnumType = (typeof userRoleEnum.enumValues)[number];
 type DeveloperStatusResponse = z.infer<typeof DeveloperStatusResponseSchema>;
-type DeveloperStatusValue = DeveloperStatusResponse['status'];
 /**
  * User data with authentication provider information.
  * Returned by the /users/me endpoint with additional auth context.
@@ -3749,12 +2564,6 @@ type UserLevelWithConfig = UserLevel & {
     xpToNextLevel: number;
     nextLevelConfig?: LevelConfig;
 };
-interface LeaderboardOptions {
-    timeframe?: 'all_time' | 'monthly' | 'weekly' | 'daily';
-    limit?: number;
-    offset?: number;
-    gameId?: string;
-}
 interface LeaderboardEntry {
     rank: number;
     userId: string;
@@ -3778,15 +2587,6 @@ interface UserRankResponse {
     score: number;
     userId: string;
 }
-interface UserScore$1 {
-    id: string;
-    score: number;
-    achievedAt: Date;
-    metadata?: Record<string, unknown>;
-    gameId: string;
-    gameTitle: string;
-    gameSlug: string;
-}
 
 type SpriteTemplate = typeof spriteTemplates.$inferSelect;
 interface SpriteTemplateData {
@@ -3870,7 +2670,6 @@ interface SpriteTemplateData {
         };
     };
 }
-type GameTimebackIntegration = typeof gameTimebackIntegrations.$inferSelect;
 type TodayXpResponse = {
     xp: number;
     date: string;
@@ -3884,435 +2683,98 @@ 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;
-};
-type TimebackSetupResponse = {
-    integration: GameTimebackIntegration;
-    courseId: string;
-    verbose?: {
-        course: unknown;
-        component: unknown;
-        resource: unknown;
-        componentResource: unknown;
-    };
-};
-type TimebackVerifyResponse = {
-    status: 'success' | 'error';
-    integration: GameTimebackIntegration;
-    resources: {
-        course: {
-            found: boolean;
-            data?: unknown;
-        };
-        component: {
-            found: boolean;
-            data?: unknown;
-        };
-        resource: {
-            found: boolean;
-            data?: unknown;
-        };
-        componentResource: {
-            found: boolean;
-            data?: unknown;
-        };
-    };
-    errors?: string[];
+/**
+ * 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;
 };
 type EndActivityResponse = {
     status: 'ok';
     courseId: string;
     xpAwarded: number;
+    masteredUnits?: number;
+    pctCompleteApp?: number;
+    scoreStatus?: string;
+    inProgress?: string;
 };
 
 /**
- * OAuth 2.0 implementation for the Playcademy SDK
+ * Connection monitoring types
+ *
+ * Type definitions for connection state, configuration, and callbacks.
  */
-
 /**
- * Parses an OAuth state parameter to extract CSRF token and any encoded data.
+ * Possible connection states.
  *
- * @param state - The OAuth state parameter to parse
- * @returns Object containing CSRF token and optional decoded data
+ * - **online**: Connection is stable and healthy
+ * - **offline**: Complete loss of network connectivity
+ * - **degraded**: Connection is slow or experiencing intermittent issues
  */
-declare function parseOAuthState(state: string): {
-    csrfToken: string;
-    data?: Record<string, string>;
-};
+type ConnectionState = 'online' | 'offline' | 'degraded';
 
 /**
- * Response type for the realtime token API
+ * @fileoverview Playcademy Messaging System
+ *
+ * This file implements a unified messaging system for the Playcademy platform that handles
+ * communication between different contexts:
+ *
+ * 1. **Iframe-to-Parent Communication**: When games run inside iframes (production/development),
+ *    they need to communicate with the parent window using postMessage API
+ *
+ * 2. **Local Communication**: When games run in the same context (local development),
+ *    they use CustomEvents for internal messaging
+ *
+ * The system automatically detects the runtime environment and chooses the appropriate
+ * transport method, abstracting this complexity from the developer.
+ *
+ * **Architecture Overview**:
+ * - Games run in iframes for security and isolation
+ * - Parent window (Playcademy shell) manages game lifecycle
+ * - Messages flow bidirectionally between parent and iframe
+ * - Local development mode simulates this architecture without iframes
  */
-interface RealtimeTokenResponse {
-    token: string;
-}
 
 /**
- * Cache configuration types for runtime customization
- */
-/**
- * Runtime configuration for TTL cache behavior
- */
-interface TTLCacheConfig {
-    /** Time-to-live in milliseconds. Set to 0 to disable caching for this call. */
-    ttl?: number;
-    /** Force refresh, bypassing cache */
-    force?: boolean;
-    /** Skip cache and fetch fresh data (alias for force) */
-    skipCache?: boolean;
-}
-/**
- * Runtime configuration for cooldown cache behavior
+ * Enumeration of all message types used in the Playcademy messaging system.
+ *
+ * **Message Flow Patterns**:
+ *
+ * **Parent → Game (Overworld → Game)**:
+ * - INIT: Provides game with authentication token and configuration
+ * - TOKEN_REFRESH: Updates game's authentication token before expiry
+ * - PAUSE/RESUME: Controls game execution state
+ * - FORCE_EXIT: Immediately terminates the game
+ * - OVERLAY: Shows/hides UI overlays over the game
+ *
+ * **Game → Parent (Game → Overworld)**:
+ * - READY: Game has loaded and is ready to receive messages
+ * - EXIT: Game requests to be closed (user clicked exit, game ended, etc.)
+ * - TELEMETRY: Game reports performance metrics (FPS, memory usage, etc.)
  */
-interface CooldownCacheConfig {
-    /** Cooldown period in milliseconds. Set to 0 to disable cooldown for this call. */
-    cooldown?: number;
-    /** Force refresh, bypassing cooldown */
-    force?: boolean;
-}
-
-interface CharacterComponentsOptions {
+declare enum MessageEvents {
     /**
-     * Optional level filter for components
-     * When provided, only components available at this level or below are returned
+     * Initializes the game with authentication context and configuration.
+     * Sent immediately after game iframe loads.
+     * Payload:
+     * - `baseUrl`: string
+     * - `token`: string
+     * - `gameId`: string
      */
-    level?: number;
+    INIT = "PLAYCADEMY_INIT",
     /**
-     * Whether to bypass the cache and force a fresh API request
-     * Default: false (use cache when available)
-     */
-    skipCache?: boolean;
-}
-interface CreateCharacterData {
-    bodyComponentId: string;
-    eyesComponentId: string;
-    hairstyleComponentId: string;
-    outfitComponentId: string;
-}
-interface UpdateCharacterData {
-    bodyComponentId?: string;
-    eyesComponentId?: string;
-    hairstyleComponentId?: string;
-    outfitComponentId?: string;
-}
-
-interface ScoreSubmission {
-    id: string;
-    score: number;
-    achievedAt: Date;
-}
-
-/**
- * Combined response type for summary method
- */
-type XpSummaryResponse = {
-    today: TodayXpResponse;
-    total: TotalXpResponse;
-};
-
-/**
- * @fileoverview Server SDK Type Definitions
- *
- * TypeScript type definitions for the server-side Playcademy SDK.
- * Includes configuration types, client state, and re-exported TimeBack types.
- */
-
-/**
- * TimeBack integration configuration for Playcademy config file
- */
-interface TimebackIntegrationConfig {
-    /** Organization overrides */
-    organization?: Partial<OrganizationConfig>;
-    /** Course configuration (subjects and grades REQUIRED) */
-    course: CourseConfig;
-    /** Component overrides */
-    component?: Partial<ComponentConfig>;
-    /** Resource overrides */
-    resource?: Partial<ResourceConfig>;
-    /** Component-Resource link overrides */
-    componentResource?: Partial<ComponentResourceConfig>;
-}
-/**
- * Custom API routes integration
- */
-interface CustomRoutesIntegration {
-    /** Directory for custom API routes (defaults to 'server/api') */
-    directory?: string;
-}
-/**
- * Database integration
- */
-interface DatabaseIntegration {
-    /** Database directory (defaults to 'db') */
-    directory?: string;
-}
-/**
- * Integrations configuration
- * All backend features (database, custom routes, external services) are configured here
- */
-interface IntegrationsConfig {
-    /** TimeBack integration (optional) */
-    timeback?: TimebackIntegrationConfig;
-    /** Custom API routes (optional) */
-    customRoutes?: CustomRoutesIntegration | boolean;
-    /** Database (optional) */
-    database?: DatabaseIntegration | boolean;
-    /** Key-Value storage (optional) */
-    kv?: boolean;
-    /** Bucket storage (optional) */
-    bucket?: boolean;
-    /** Authentication (optional) */
-    auth?: boolean;
-}
-/**
- * Unified Playcademy configuration
- * Used for playcademy.config.{js,json}
- */
-interface PlaycademyConfig {
-    /** Game name */
-    name: string;
-    /** Game description */
-    description?: string;
-    /** Game emoji icon */
-    emoji?: string;
-    /** Build command to run before deployment */
-    buildCommand?: string[];
-    /** Path to build output */
-    buildPath?: string;
-    /** Game type */
-    gameType?: 'hosted' | 'external';
-    /** External URL (for external games) */
-    externalUrl?: string;
-    /** Game platform */
-    platform?: 'web' | 'unity' | 'godot';
-    /** Integrations (database, custom routes, external services) */
-    integrations?: IntegrationsConfig;
-}
-
-/**
- * Configuration options for initializing a PlaycademyClient instance.
- *
- * @example
- * ```typescript
- * const config: PlaycademyServerClientConfig = {
- *   apiKey: process.env.PLAYCADEMY_API_KEY!,
- *   gameId: 'my-math-game',
- *   configPath: './playcademy.config.js'
- * }
- * ```
- */
-interface PlaycademyServerClientConfig {
-    /**
-     * Playcademy API key for server-to-server authentication.
-     * Obtain from the Playcademy developer dashboard.
-     */
-    apiKey: string;
-    /**
-     * Optional path to playcademy.config.js file.
-     * If not provided, searches current directory and up to 3 parent directories.
-     * Ignored if `config` is provided directly.
-     *
-     * @example './config/playcademy.config.js'
-     */
-    configPath?: string;
-    /**
-     * Optional config object (for edge environments without filesystem).
-     * If provided, skips filesystem-based config loading.
-     *
-     * @example { name: 'My Game', integrations: { timeback: {...} } }
-     */
-    config?: PlaycademyConfig;
-    /**
-     * Optional base URL for Playcademy API.
-     * Defaults to environment variables or 'https://hub.playcademy.net'.
-     *
-     * @example 'http://localhost:3000' for local development
-     */
-    baseUrl?: string;
-    /**
-     * Optional game ID.
-     * If not provided, will attempt to fetch from API using the API token.
-     *
-     * @example 'my-math-game'
-     */
-    gameId?: string;
-}
-/**
- * Internal state maintained by the PlaycademyClient instance.
- *
- * @internal
- */
-interface PlaycademyServerClientState {
-    /** API key for authentication */
-    apiKey: string;
-    /** Base URL for API requests */
-    baseUrl: string;
-    /** Game identifier */
-    gameId: string;
-    /** Loaded game configuration from playcademy.config.js */
-    config: PlaycademyConfig;
-    /**
-     * TimeBack course ID fetched from the Playcademy API.
-     * Used for all TimeBack event recording.
-     */
-    courseId?: string;
-}
-
-/**
- * Resource bindings for backend deployment
- * Provider-agnostic abstraction for cloud resources
- */
-interface BackendResourceBindings {
-    /** SQL database instances to create and bind (maps to D1 on Cloudflare) */
-    database?: string[];
-    /** Key-value store namespaces to create and bind (maps to KV on Cloudflare) */
-    keyValue?: string[];
-    /** Object storage buckets to bind (maps to R2 on Cloudflare) */
-    bucket?: string[];
-}
-/**
- * Backend deployment bundle for uploading to Playcademy platform
- */
-interface BackendDeploymentBundle {
-    /** Bundled JavaScript code ready for deployment */
-    code: string;
-    /** Game configuration */
-    config: PlaycademyConfig;
-    /** Optional resource bindings (database, storage, etc.) */
-    bindings?: BackendResourceBindings;
-    /** Optional schema information for database setup */
-    schema?: SchemaInfo;
-    /** Optional game secrets */
-    secrets?: Record<string, string>;
-}
-
-interface UserScore {
-    id: string;
-    score: number;
-    achievedAt: Date;
-    metadata?: Record<string, unknown>;
-    gameId: string;
-    gameTitle: string;
-    gameSlug: string;
-}
-
-/**
- * Connection monitoring types
- *
- * Type definitions for connection state, configuration, and callbacks.
- */
-/**
- * Possible connection states.
- *
- * - **online**: Connection is stable and healthy
- * - **offline**: Complete loss of network connectivity
- * - **degraded**: Connection is slow or experiencing intermittent issues
- */
-type ConnectionState = 'online' | 'offline' | 'degraded';
-
-/**
- * @fileoverview Playcademy Messaging System
- *
- * This file implements a unified messaging system for the Playcademy platform that handles
- * communication between different contexts:
- *
- * 1. **Iframe-to-Parent Communication**: When games run inside iframes (production/development),
- *    they need to communicate with the parent window using postMessage API
- *
- * 2. **Local Communication**: When games run in the same context (local development),
- *    they use CustomEvents for internal messaging
- *
- * The system automatically detects the runtime environment and chooses the appropriate
- * transport method, abstracting this complexity from the developer.
- *
- * **Architecture Overview**:
- * - Games run in iframes for security and isolation
- * - Parent window (Playcademy shell) manages game lifecycle
- * - Messages flow bidirectionally between parent and iframe
- * - Local development mode simulates this architecture without iframes
- */
-
-/**
- * Enumeration of all message types used in the Playcademy messaging system.
- *
- * **Message Flow Patterns**:
- *
- * **Parent → Game (Overworld → Game)**:
- * - INIT: Provides game with authentication token and configuration
- * - TOKEN_REFRESH: Updates game's authentication token before expiry
- * - PAUSE/RESUME: Controls game execution state
- * - FORCE_EXIT: Immediately terminates the game
- * - OVERLAY: Shows/hides UI overlays over the game
- *
- * **Game → Parent (Game → Overworld)**:
- * - READY: Game has loaded and is ready to receive messages
- * - EXIT: Game requests to be closed (user clicked exit, game ended, etc.)
- * - TELEMETRY: Game reports performance metrics (FPS, memory usage, etc.)
- */
-declare enum MessageEvents {
-    /**
-     * Initializes the game with authentication context and configuration.
-     * Sent immediately after game iframe loads.
-     * Payload:
-     * - `baseUrl`: string
-     * - `token`: string
-     * - `gameId`: string
-     */
-    INIT = "PLAYCADEMY_INIT",
-    /**
-     * Updates the game's authentication token before it expires.
-     * Sent periodically to maintain valid authentication.
-     * Payload:
-     * - `token`: string
-     * - `exp`: number
+     * Updates the game's authentication token before it expires.
+     * Sent periodically to maintain valid authentication.
+     * Payload:
+     * - `token`: string
+     * - `exp`: number
      */
     TOKEN_REFRESH = "PLAYCADEMY_TOKEN_REFRESH",
     /**
@@ -4428,12 +2890,12 @@ declare enum MessageEvents {
  * const client = await PlaycademyClient.init({ baseUrl: 'https://custom.api.com' })
  * ```
  */
-declare function init(options?: {
+declare function init<T extends PlaycademyClient = PlaycademyClient>(this: new (...args: ConstructorParameters<typeof PlaycademyClient>) => T, options?: {
     baseUrl?: string;
     allowedParentOrigins?: string[];
     onDisconnect?: DisconnectHandler;
     enableConnectionMonitoring?: boolean;
-}): Promise<PlaycademyClient>;
+}): Promise<T>;
 
 /**
  * Authenticates a user with email and password.
@@ -4488,10 +2950,21 @@ declare class PlaycademyClient {
     private initPayload?;
     private connectionManager?;
     /**
-     * Creates a new PlaycademyClient instance.
+     * Internal session manager for automatic session lifecycle.
      *
-     * @param config - Optional configuration object
-     * @param config.baseUrl - Base URL (e.g., 'https://hub.playcademy.net' or '/'). SDK automatically appends /api
+     * This manager handles starting and ending game sessions automatically.
+     * Game developers don't need to call these methods directly - they're managed
+     * by the SDK during initialization and cleanup.
+     *
+     * @private
+     * @internal
+     */
+    private _sessionManager;
+    /**
+     * Creates a new PlaycademyClient instance.
+     *
+     * @param config - Optional configuration object
+     * @param config.baseUrl - Base URL (e.g., 'https://hub.playcademy.net' or '/'). SDK automatically appends /api
      * @param config.token - Authentication token
      * @param config.tokenType - Optional token type (auto-detected if not provided)
      * @param config.gameId - Game ID for automatic session management
@@ -4732,32 +3205,6 @@ declare class PlaycademyClient {
      * 3. autoStartSession is enabled (defaults to false)
      */
     private _initializeInternalSession;
-    /** Platform API authentication methods (login, logout) */
-    auth: {
-        login: (credentials: {
-            email: string;
-            password: string;
-        }) => Promise<{
-            success: boolean;
-            token?: string;
-            user?: {
-                id: string;
-                email: string;
-            };
-            expiresAt?: string;
-            error?: string;
-        }>;
-        logout: () => Promise<void>;
-        apiKeys: {
-            create: (options?: {
-                name?: string;
-                expiresIn?: number | null;
-                permissions?: Record<string, string[]>;
-            }) => Promise<BetterAuthApiKeyResponse>;
-            list: () => Promise<BetterAuthApiKey[]>;
-            revoke: (keyId: string) => Promise<void>;
-        };
-    };
     /** Identity provider connection methods (connect external accounts) */
     identity: {
         connect: (options: AuthOptions) => Promise<AuthResult>;
@@ -4800,26 +3247,6 @@ declare class PlaycademyClient {
             arrayBuffer: (path: string) => Promise<ArrayBuffer>;
         };
     };
-    /** Game management methods (fetch, list, saveState, loadState, sessions) */
-    games: {
-        fetch: (gameIdOrSlug: string, options?: TTLCacheConfig) => Promise<FetchedGame>;
-        list: (options?: TTLCacheConfig) => Promise<Array<Game>>;
-        saveState: (state: Record<string, unknown>) => Promise<void>;
-        loadState: () => Promise<GameStateData>;
-        startSession: (gameId?: string) => Promise<StartSessionResponse>;
-        endSession: (sessionId: string, gameId?: string) => Promise<void>;
-        token: {
-            create: (gameId: string, options?: {
-                apply?: boolean;
-            }) => Promise<GameTokenResponse>;
-        };
-        leaderboard: {
-            get: (gameId: string, options?: {
-                limit?: number;
-                offset?: number;
-            }) => Promise<LeaderboardEntry[]>;
-        };
-    };
     /** User methods (me, inventory management) */
     users: {
         me: () => Promise<AuthenticatedUser>;
@@ -4830,258 +3257,6 @@ declare class PlaycademyClient {
             quantity: (identifier: string) => Promise<number>;
             has: (identifier: string, minQuantity?: number) => Promise<boolean>;
         };
-        scores: {
-            get: (userIdOrOptions?: string | {
-                limit?: number;
-                gameId?: string;
-            }, options?: {
-                limit?: number;
-                gameId?: string;
-            }) => Promise<UserScore[]>;
-        };
-    };
-    /** Developer tools (auth, games, keys management) */
-    dev: {
-        status: {
-            apply: () => Promise<void>;
-            get: () => Promise<DeveloperStatusValue>;
-        };
-        games: {
-            deploy: (slug: string, options: {
-                metadata?: UpsertGameMetadataInput;
-                file?: File | Blob | null;
-                backend?: BackendDeploymentBundle;
-                hooks?: DevUploadHooks;
-            }) => Promise<Game>;
-            seed: (slug: string, code: string, environment?: "staging" | "production") => Promise<{
-                success: boolean;
-                deploymentId: string;
-                executedAt: string;
-            }>;
-            upsert: (slug: string, metadata: UpsertGameMetadataInput) => Promise<Game>;
-            delete: (gameId: string) => Promise<void>;
-            secrets: {
-                set: (slug: string, secrets: Record<string, string>) => Promise<string[]>;
-                list: (slug: string) => Promise<string[]>;
-                get: (slug: string) => Promise<Record<string, string>>;
-                delete: (slug: string, key: string) => Promise<void>;
-            };
-            database: {
-                reset: (slug: string, schema?: {
-                    sql: string;
-                    hash: string;
-                }) => Promise<{
-                    success: boolean;
-                    deploymentId: string;
-                    resetAt: string;
-                    schemaPushed: boolean;
-                }>;
-            };
-            bucket: {
-                list: (slug: string, prefix?: string) => Promise<BucketFile[]>;
-                get: (slug: string, key: string) => Promise<ArrayBuffer>;
-                put: (slug: string, key: string, content: Blob | ArrayBuffer | Uint8Array, contentType?: string) => Promise<void>;
-                delete: (slug: string, key: string) => Promise<void>;
-            };
-            domains: {
-                add: (slug: string, hostname: string) => Promise<GameCustomHostname>;
-                list: (slug: string) => Promise<GameCustomHostname[]>;
-                status: (slug: string, hostname: string, refresh?: boolean) => Promise<GameCustomHostname>;
-                delete: (slug: string, hostname: string) => Promise<void>;
-            };
-        };
-        items: {
-            create: (gameId: string, slug: string, itemData: Omit<InsertItemInput, "slug" | "gameId">) => Promise<Item>;
-            update: (gameId: string, itemId: string, updates: UpdateItemInput) => Promise<Item>;
-            list: (gameId: string) => Promise<Array<Item>>;
-            get: (gameId: string, slug: string) => Promise<Item>;
-            delete: (gameId: string, itemId: string) => Promise<void>;
-            shop: {
-                create: (gameId: string, itemId: string, listingData: Omit<InsertShopListingInput, "itemId">) => Promise<ShopListing>;
-                get: (gameId: string, itemId: string) => Promise<ShopListing | null>;
-                update: (gameId: string, itemId: string, updates: UpdateShopListingInput) => Promise<ShopListing>;
-                delete: (gameId: string, itemId: string) => Promise<void>;
-                list: (gameId: string) => Promise<Array<ShopListing & {
-                    item: Item;
-                }>>;
-            };
-        };
-    };
-    /** Map methods (elements) */
-    maps: {
-        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>;
-            delete: (mapId: string, objectId: string) => Promise<void>;
-        };
-    };
-    /** Admin methods (games, items, currencies, shop listings) */
-    admin: {
-        games: {
-            pauseGame: (gameId: string) => Promise<void>;
-            resumeGame: (gameId: string) => Promise<void>;
-        };
-        items: {
-            create: (props: InsertItemInput) => Promise<{
-                id: string;
-                createdAt: Date;
-                gameId: string | null;
-                slug: string;
-                displayName: string;
-                metadata: unknown;
-                description: string | null;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
-                isPlaceable: boolean;
-                imageUrl: string | null;
-            }>;
-            get: (itemId: string) => Promise<{
-                id: string;
-                createdAt: Date;
-                gameId: string | null;
-                slug: string;
-                displayName: string;
-                metadata: unknown;
-                description: string | null;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
-                isPlaceable: boolean;
-                imageUrl: string | null;
-            }>;
-            list: () => Promise<{
-                id: string;
-                createdAt: Date;
-                gameId: string | null;
-                slug: string;
-                displayName: string;
-                metadata: unknown;
-                description: string | null;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
-                isPlaceable: boolean;
-                imageUrl: string | null;
-            }[]>;
-            update: (itemId: string, props: UpdateItemInput) => Promise<{
-                id: string;
-                createdAt: Date;
-                gameId: string | null;
-                slug: string;
-                displayName: string;
-                metadata: unknown;
-                description: string | null;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
-                isPlaceable: boolean;
-                imageUrl: string | null;
-            }>;
-            delete: (itemId: string) => Promise<void>;
-        };
-        currencies: {
-            create: (props: InsertCurrencyInput) => Promise<{
-                symbol: string | null;
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                isPrimary: boolean;
-            }>;
-            get: (currencyId: string) => Promise<{
-                symbol: string | null;
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                isPrimary: boolean;
-            }>;
-            list: () => Promise<{
-                symbol: string | null;
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                isPrimary: boolean;
-            }[]>;
-            update: (currencyId: string, props: UpdateCurrencyInput) => Promise<{
-                symbol: string | null;
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                isPrimary: boolean;
-            }>;
-            delete: (currencyId: string) => Promise<void>;
-        };
-        shopListings: {
-            create: (props: InsertShopListingInput) => Promise<{
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                currencyId: string;
-                price: number;
-                sellBackPercentage: number | null;
-                stock: number | null;
-                isActive: boolean;
-                availableFrom: Date | null;
-                availableUntil: Date | null;
-            }>;
-            get: (listingId: string) => Promise<{
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                currencyId: string;
-                price: number;
-                sellBackPercentage: number | null;
-                stock: number | null;
-                isActive: boolean;
-                availableFrom: Date | null;
-                availableUntil: Date | null;
-            }>;
-            list: () => Promise<{
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                currencyId: string;
-                price: number;
-                sellBackPercentage: number | null;
-                stock: number | null;
-                isActive: boolean;
-                availableFrom: Date | null;
-                availableUntil: Date | null;
-            }[]>;
-            update: (listingId: string, props: UpdateShopListingInput) => Promise<{
-                id: string;
-                createdAt: Date;
-                updatedAt: Date | null;
-                itemId: string;
-                currencyId: string;
-                price: number;
-                sellBackPercentage: number | null;
-                stock: number | null;
-                isActive: boolean;
-                availableFrom: Date | null;
-                availableUntil: Date | null;
-            }>;
-            delete: (listingId: string) => Promise<void>;
-        };
-    };
-    /** Shop methods (view) */
-    shop: {
-        view: () => Promise<ShopViewResponse>;
-    };
-    /** Level methods (levels) */
-    levels: {
-        get: () => Promise<UserLevel>;
-        progress: (options?: CooldownCacheConfig) => Promise<{
-            level: number;
-            currentXp: number;
-            xpToNextLevel: number;
-            totalXP: number;
-        }>;
-        config: {
-            list: () => Promise<LevelConfig[]>;
-            get: (level: number) => Promise<LevelConfig | null>;
-        };
     };
     /** TimeBack XP methods (today, total, history) */
     timeback: {
@@ -5089,32 +3264,6 @@ declare class PlaycademyClient {
         pauseActivity: () => void;
         resumeActivity: () => void;
         endActivity: (data: _playcademy_timeback_types.EndActivityScoreData) => Promise<EndActivityResponse>;
-        management: {
-            setup: (request: TimebackSetupRequest) => Promise<TimebackSetupResponse>;
-            verify: (gameId: string) => Promise<TimebackVerifyResponse>;
-            cleanup: (gameId: string) => Promise<void>;
-            get: (gameId: string) => Promise<GameTimebackIntegration | null>;
-            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>;
-        };
-    };
-    /** Telemetry methods (pushMetrics) */
-    telemetry: {
-        pushMetrics: (metrics: Record<string, number>) => Promise<void>;
     };
     /** Credits methods (credits management) */
     credits: {
@@ -5122,41 +3271,9 @@ declare class PlaycademyClient {
         add: (amount: number) => Promise<number>;
         spend: (amount: number) => Promise<number>;
     };
-    /** Platform-wide leaderboard methods (fetch, getUserRank) */
-    leaderboard: {
-        fetch: (options?: LeaderboardOptions) => Promise<GameLeaderboardEntry[]>;
-        getUserRank: (gameId: string, userId: string) => Promise<UserRankResponse>;
-    };
     /** Platform-wide scores methods (submit, getUserScores) */
     scores: {
         submit: (gameId: string, score: number, metadata?: Record<string, unknown>) => Promise<ScoreSubmission>;
-        getByUser: (gameId: string, userId: string, options?: {
-            limit?: number;
-        }) => Promise<UserScore$1[]>;
-    };
-    /** Character methods (get, create, update, components) */
-    character: {
-        get: (userId?: string) => Promise<PlayerCharacter | null>;
-        create: (characterData: CreateCharacterData) => Promise<PlayerCharacter>;
-        update: (updates: UpdateCharacterData) => Promise<PlayerCharacter>;
-        components: {
-            list: (options?: CharacterComponentsOptions & TTLCacheConfig) => Promise<CharacterComponentWithSpriteUrl[]>;
-            clearCache: (key?: string) => void;
-            getCacheKeys: () => string[];
-        };
-        accessories: {
-            equip: (slot: string, componentId: string) => Promise<PlayerCharacterAccessory>;
-            remove: (slot: string) => Promise<{
-                success: boolean;
-            }>;
-            list: () => Promise<PlayerCharacterAccessory[]>;
-        };
-    };
-    /** Sprites methods (templates) */
-    sprites: {
-        templates: {
-            get: (slug: string) => Promise<SpriteTemplateData>;
-        };
     };
     /** Realtime methods (token) */
     realtime: {
@@ -5165,36 +3282,6 @@ declare class PlaycademyClient {
         };
         open(channel?: string, url?: string): Promise<_playcademy_realtime_server_types.RealtimeChannel>;
     };
-    /** Achievements methods (list, history, progress) */
-    achievements: {
-        list: (options?: TTLCacheConfig) => Promise<AchievementCurrent[]>;
-        history: {
-            list: (queryOptions?: {
-                limit?: number;
-            }, cacheOptions?: TTLCacheConfig) => Promise<AchievementHistoryEntry[]>;
-        };
-        progress: {
-            submit: (achievementId: string) => Promise<AchievementProgressResponse>;
-        };
-    };
-    /** Notifications methods (list, update status, stats) */
-    notifications: {
-        list: (queryOptions?: {
-            status?: NotificationStatus;
-            type?: NotificationType;
-            limit?: number;
-            offset?: number;
-        }, cacheOptions?: TTLCacheConfig) => Promise<Notification[]>;
-        markAsSeen: (notificationId: string) => Promise<Notification>;
-        markAsClicked: (notificationId: string) => Promise<Notification>;
-        dismiss: (notificationId: string) => Promise<Notification>;
-        stats: {
-            get: (queryOptions?: {
-                from?: string;
-                to?: string;
-            }, cacheOptions?: TTLCacheConfig) => Promise<NotificationStats>;
-        };
-    };
     /** Backend methods for calling custom game API routes */
     backend: {
         get<T = unknown>(path: string, headers?: Record<string, string>): Promise<T>;
@@ -5216,6 +3303,9 @@ declare class PlaycademyClient {
     };
 }
 
+/**
+ * Core client configuration and lifecycle types
+ */
 type TokenType = 'session' | 'apiKey' | 'gameJwt';
 interface ClientConfig {
     baseUrl: string;
@@ -5260,46 +3350,6 @@ interface InitPayload {
     /** Realtime WebSocket URL */
     realtimeUrl?: string;
 }
-type AuthProviderType = (typeof AUTH_PROVIDER_IDS)[keyof typeof AUTH_PROVIDER_IDS];
-interface AuthOptions {
-    /** The identity provider to use for authentication */
-    provider: AuthProviderType;
-    /** The OAuth callback URL where your server handles the callback */
-    callbackUrl: string;
-    /** Authentication mode - auto detects best option based on context */
-    mode?: 'auto' | 'popup' | 'redirect';
-    /** Callback for authentication state changes */
-    onStateChange?: (state: AuthStateUpdate) => void;
-    /** Custom OAuth configuration (for users embedding the SDK outside of the Playcademy platform) */
-    oauth?: {
-        clientId: string;
-        authorizationEndpoint?: string;
-        tokenEndpoint?: string;
-        scope?: string;
-    };
-    /**
-     * Optional custom data to encode in OAuth state parameter.
-     * By default, the SDK automatically includes playcademy_user_id and game_id.
-     * Use this to add additional custom data if needed.
-     */
-    stateData?: Record<string, string>;
-}
-interface AuthStateUpdate {
-    /** Current status of the authentication flow */
-    status: 'opening_popup' | 'exchanging_token' | 'complete' | 'error';
-    /** Human-readable message about the current state */
-    message: string;
-    /** Error details if status is 'error' */
-    error?: Error;
-}
-interface AuthResult {
-    /** Whether authentication was successful */
-    success: boolean;
-    /** User information if authentication was successful */
-    user?: UserInfo;
-    /** Error if authentication failed */
-    error?: Error;
-}
 /**
  * Simplified user data passed to games via InitPayload
  * This is a subset of AuthenticatedUser suitable for external game consumption
@@ -5318,6 +3368,52 @@ interface GameUser {
     /** Whether the user has a Timeback account */
     hasTimebackAccount: boolean;
 }
+type GameContextPayload = {
+    token: string;
+    baseUrl: string;
+    realtimeUrl: string;
+    gameId: string;
+    forwardKeys?: string[];
+};
+type EventListeners = {
+    [E in keyof ClientEvents]?: Array<(payload: ClientEvents[E]) => void>;
+};
+interface ClientEvents {
+    authChange: {
+        token: string | null;
+    };
+    inventoryChange: {
+        itemId: string;
+        delta: number;
+        newTotal: number;
+    };
+    levelUp: {
+        oldLevel: number;
+        newLevel: number;
+        creditsAwarded: number;
+    };
+    xpGained: {
+        amount: number;
+        totalXP: number;
+        leveledUp: boolean;
+    };
+    connectionChange: {
+        state: 'online' | 'offline' | 'degraded';
+        reason: string;
+    };
+}
+
+/**
+ * Event and message payload types for SDK messaging system
+ */
+
+interface DisplayAlertPayload {
+    message: string;
+    options?: {
+        type?: 'info' | 'warning' | 'error';
+        duration?: number;
+    };
+}
 /**
  * Authentication state change event payload.
  * Used when authentication state changes in the application.
@@ -5392,24 +3488,6 @@ interface KeyEventPayload {
     /** Event type */
     type: 'keydown' | 'keyup';
 }
-interface DisplayAlertPayload {
-    message: string;
-    options?: {
-        type?: 'info' | 'warning' | 'error';
-        duration?: number;
-    };
-}
-/**
- * Display alert payload.
- * Request from game to show platform-level alert.
- */
-interface DisplayAlertPayload {
-    message: string;
-    options?: {
-        type?: 'info' | 'warning' | 'error';
-        duration?: number;
-    };
-}
 /**
  * Connection state payload.
  * Broadcast from platform to games when connection changes.
@@ -5418,40 +3496,10 @@ interface ConnectionStatePayload {
     state: 'online' | 'offline' | 'degraded';
     reason: string;
 }
-interface ClientEvents {
-    authChange: {
-        token: string | null;
-    };
-    inventoryChange: {
-        itemId: string;
-        delta: number;
-        newTotal: number;
-    };
-    levelUp: {
-        oldLevel: number;
-        newLevel: number;
-        creditsAwarded: number;
-    };
-    xpGained: {
-        amount: number;
-        totalXP: number;
-        leveledUp: boolean;
-    };
-    connectionChange: {
-        state: 'online' | 'offline' | 'degraded';
-        reason: string;
-    };
-}
-type GameContextPayload = {
-    token: string;
-    baseUrl: string;
-    realtimeUrl: string;
-    gameId: string;
-    forwardKeys?: string[];
-};
-type EventListeners = {
-    [E in keyof ClientEvents]?: Array<(payload: ClientEvents[E]) => void>;
-};
+
+/**
+ * SDK-specific API response types
+ */
 type LoginResponse = {
     token: string;
 };
@@ -5465,29 +3513,83 @@ type StartSessionResponse = {
 type InventoryMutationResponse = {
     newTotal: number;
 };
-type DevUploadEvent = {
-    type: 'init';
-} | {
-    type: 's3Progress';
-    loaded: number;
-    total: number;
-    percent: number;
-} | {
-    type: 'finalizeStart';
-} | {
-    type: 'finalizeProgress';
-    percent: number;
-    currentFileLabel?: string;
-} | {
-    type: 'finalizeStatus';
+
+/**
+ * Realtime namespace types
+ */
+/**
+ * Response type for the realtime token API
+ */
+interface RealtimeTokenResponse {
+    token: string;
+}
+
+/**
+ * Scores namespace types
+ */
+interface ScoreSubmission {
+    id: string;
+    score: number;
+    achievedAt: Date;
+}
+
+/**
+ * Users namespace types
+ */
+interface UserScore {
+    id: string;
+    score: number;
+    achievedAt: Date;
+    metadata?: Record<string, unknown>;
+    gameId: string;
+    gameTitle: string;
+    gameSlug: string;
+}
+
+/**
+ * Authentication namespace types
+ */
+
+type AuthProviderType = (typeof AUTH_PROVIDER_IDS)[keyof typeof AUTH_PROVIDER_IDS];
+interface AuthOptions {
+    /** The identity provider to use for authentication */
+    provider: AuthProviderType;
+    /** The OAuth callback URL where your server handles the callback */
+    callbackUrl: string;
+    /** Authentication mode - auto detects best option based on context */
+    mode?: 'auto' | 'popup' | 'redirect';
+    /** Callback for authentication state changes */
+    onStateChange?: (state: AuthStateUpdate) => void;
+    /** Custom OAuth configuration (for users embedding the SDK outside of the Playcademy platform) */
+    oauth?: {
+        clientId: string;
+        authorizationEndpoint?: string;
+        tokenEndpoint?: string;
+        scope?: string;
+    };
+    /**
+     * Optional custom data to encode in OAuth state parameter.
+     * By default, the SDK automatically includes playcademy_user_id and game_id.
+     * Use this to add additional custom data if needed.
+     */
+    stateData?: Record<string, string>;
+}
+interface AuthStateUpdate {
+    /** Current status of the authentication flow */
+    status: 'opening_popup' | 'exchanging_token' | 'complete' | 'error';
+    /** Human-readable message about the current state */
     message: string;
-} | {
-    type: 'close';
-};
-type DevUploadHooks = {
-    onEvent?: (e: DevUploadEvent) => void;
-    onClose?: () => void;
-};
+    /** Error details if status is 'error' */
+    error?: Error;
+}
+interface AuthResult {
+    /** Whether authentication was successful */
+    success: boolean;
+    /** User information if authentication was successful */
+    user?: UserInfo;
+    /** Error if authentication failed */
+    error?: Error;
+}
 /**
  * Better-auth sign-in response
  */
@@ -5525,6 +3627,38 @@ interface BetterAuthApiKey {
     lastRequest: string | null;
     requestCount: number;
 }
+
+/**
+ * Character namespace types
+ */
+interface CharacterComponentsOptions {
+    /**
+     * Optional level filter for components
+     * When provided, only components available at this level or below are returned
+     */
+    level?: number;
+    /**
+     * Whether to bypass the cache and force a fresh API request
+     * Default: false (use cache when available)
+     */
+    skipCache?: boolean;
+}
+interface CreateCharacterData {
+    bodyComponentId: string;
+    eyesComponentId: string;
+    hairstyleComponentId: string;
+    outfitComponentId: string;
+}
+interface UpdateCharacterData {
+    bodyComponentId?: string;
+    eyesComponentId?: string;
+    hairstyleComponentId?: string;
+    outfitComponentId?: string;
+}
+
+/**
+ * Developer namespace types
+ */
 /**
  * Bucket file metadata
  */
@@ -5534,6 +3668,242 @@ interface BucketFile {
     uploaded: string;
     contentType?: string;
 }
+type DevUploadEvent = {
+    type: 'init';
+} | {
+    type: 's3Progress';
+    loaded: number;
+    total: number;
+    percent: number;
+} | {
+    type: 'finalizeStart';
+} | {
+    type: 'finalizeProgress';
+    percent: number;
+    currentFileLabel?: string;
+} | {
+    type: 'finalizeStatus';
+    message: string;
+} | {
+    type: 'close';
+};
+type DevUploadHooks = {
+    onEvent?: (e: DevUploadEvent) => void;
+    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
+ *
+ * TypeScript type definitions for the server-side Playcademy SDK.
+ * Includes configuration types, client state, and re-exported TimeBack types.
+ */
+
+/**
+ * Base configuration for TimeBack integration (shared across all courses).
+ * References upstream TimeBack types from @playcademy/timeback.
+ *
+ * All fields are optional and support template variables: {grade}, {subject}, {gameSlug}
+ */
+interface TimebackBaseConfig {
+    /** Organization configuration (shared across all courses) */
+    organization?: Partial<OrganizationConfig>;
+    /** Course defaults (can be overridden per-course) */
+    course?: Partial<CourseConfig>;
+    /** Component defaults */
+    component?: Partial<ComponentConfig>;
+    /** Resource defaults */
+    resource?: Partial<ResourceConfig>;
+    /** ComponentResource defaults */
+    componentResource?: Partial<ComponentResourceConfig>;
+}
+/**
+ * Extended course configuration that merges TimebackCourseConfig with per-course overrides.
+ * Used in playcademy.config.* to allow per-course customization.
+ */
+interface TimebackCourseConfigWithOverrides extends TimebackCourseConfig {
+    title?: string;
+    courseCode?: string;
+    level?: string;
+    metadata?: CourseConfig['metadata'];
+    totalXp?: number | null;
+    masterableUnits?: number | null;
+}
+/**
+ * TimeBack integration configuration for Playcademy config file.
+ *
+ * Supports two levels of customization:
+ * 1. `base`: Shared defaults for all courses (organization, course, component, resource, componentResource)
+ * 2. Per-course overrides in the `courses` array (title, courseCode, level, gradingScheme, metadata)
+ *
+ * Template variables ({grade}, {subject}, {gameSlug}) can be used in string fields.
+ */
+interface TimebackIntegrationConfig {
+    /** Multi-grade course configuration (array of grade/subject/totalXp with optional per-course overrides) */
+    courses: TimebackCourseConfigWithOverrides[];
+    /** Optional base configuration (shared across all courses, can be overridden per-course) */
+    base?: TimebackBaseConfig;
+}
+/**
+ * Custom API routes integration
+ */
+interface CustomRoutesIntegration {
+    /** Directory for custom API routes (defaults to 'server/api') */
+    directory?: string;
+}
+/**
+ * Database integration
+ */
+interface DatabaseIntegration {
+    /** Database directory (defaults to 'db') */
+    directory?: string;
+}
+/**
+ * Integrations configuration
+ * All backend features (database, custom routes, external services) are configured here
+ */
+interface IntegrationsConfig {
+    /** TimeBack integration (optional) */
+    timeback?: TimebackIntegrationConfig | null;
+    /** Custom API routes (optional) */
+    customRoutes?: CustomRoutesIntegration | boolean;
+    /** Database (optional) */
+    database?: DatabaseIntegration | boolean;
+    /** Key-Value storage (optional) */
+    kv?: boolean;
+    /** Bucket storage (optional) */
+    bucket?: boolean;
+    /** Authentication (optional) */
+    auth?: boolean;
+}
+/**
+ * Unified Playcademy configuration
+ * Used for playcademy.config.{js,json}
+ */
+interface PlaycademyConfig {
+    /** Game name */
+    name: string;
+    /** Game description */
+    description?: string;
+    /** Game emoji icon */
+    emoji?: string;
+    /** Build command to run before deployment */
+    buildCommand?: string[];
+    /** Path to build output */
+    buildPath?: string;
+    /** Game type */
+    gameType?: 'hosted' | 'external';
+    /** External URL (for external games) */
+    externalUrl?: string;
+    /** Game platform */
+    platform?: 'web' | 'unity' | 'godot';
+    /** Integrations (database, custom routes, external services) */
+    integrations?: IntegrationsConfig;
+}
+
+/**
+ * Configuration options for initializing a PlaycademyClient instance.
+ *
+ * @example
+ * ```typescript
+ * const config: PlaycademyServerClientConfig = {
+ *   apiKey: process.env.PLAYCADEMY_API_KEY!,
+ *   gameId: 'my-math-game',
+ *   configPath: './playcademy.config.js'
+ * }
+ * ```
+ */
+interface PlaycademyServerClientConfig {
+    /**
+     * Playcademy API key for server-to-server authentication.
+     * Obtain from the Playcademy developer dashboard.
+     */
+    apiKey: string;
+    /**
+     * Optional path to playcademy.config.js file.
+     * If not provided, searches current directory and up to 3 parent directories.
+     * Ignored if `config` is provided directly.
+     *
+     * @example './config/playcademy.config.js'
+     */
+    configPath?: string;
+    /**
+     * Optional config object (for edge environments without filesystem).
+     * If provided, skips filesystem-based config loading.
+     *
+     * @example { name: 'My Game', integrations: { timeback: {...} } }
+     */
+    config?: PlaycademyConfig;
+    /**
+     * Optional base URL for Playcademy API.
+     * Defaults to environment variables or 'https://hub.playcademy.net'.
+     *
+     * @example 'http://localhost:3000' for local development
+     */
+    baseUrl?: string;
+    /**
+     * Optional game ID.
+     * If not provided, will attempt to fetch from API using the API token.
+     *
+     * @example 'my-math-game'
+     */
+    gameId?: string;
+}
+/**
+ * Internal state maintained by the PlaycademyClient instance.
+ *
+ * @internal
+ */
+interface PlaycademyServerClientState {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for API requests */
+    baseUrl: string;
+    /** Game identifier */
+    gameId: string;
+    /** Loaded game configuration from playcademy.config.js */
+    config: PlaycademyConfig;
+    /**
+     * TimeBack course ID fetched from the Playcademy API.
+     * Used for all TimeBack event recording.
+     */
+    courseId?: string;
+}
 
 export { PlaycademyClient };
-export type { Achievement, AchievementCurrent, AchievementProgressResponse, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponent, CharacterComponentWithSpriteUrl, ClientConfig, ClientEvents, ConnectionStatePayload, 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, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, User, UserInfo, UserLevel, UserLevelWithConfig, UserRank, UserRankResponse, UserRoleEnumType, UserScore$1 as UserScore, XpHistoryResponse };
+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 };