@playcademy/sdk 0.2.1 → 0.2.3

package/dist/types.d.ts

@@ -1,7 +1,6 @@
-import * as _playcademy_realtime_server_types from '@playcademy/realtime/server/types';
-import * as _playcademy_timeback_types from '@playcademy/timeback/types';
-import { CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
+import { InferSelectModel } from 'drizzle-orm';
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
+import * as drizzle_zod from 'drizzle-zod';
 import { z } from 'zod';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
@@ -20,31 +19,1153 @@ declare function parseOAuthState(state: string): {
     data?: Record<string, string>;
 };
 
-declare const userRoleEnum: drizzle_orm_pg_core.PgEnum<["admin", "player", "developer"]>;
+/**
+ * Game Types
+ *
+ * Literal types and API DTOs. Database row types are in @playcademy/data/types.
+ *
+ * @module types/game
+ */
+type GameType = 'hosted' | 'external';
+type GamePlatform = 'web' | 'godot' | 'unity' | (string & {});
+/**
+ * Game manifest file format (manifest.json).
+ * Note: createdAt is a string here because it's parsed from JSON file.
+ */
+interface ManifestV1 {
+    version: string;
+    platform: string;
+    createdAt: string;
+}
+interface DomainValidationRecords {
+    ownership?: {
+        name?: string;
+        value?: string;
+        type?: string;
+    };
+    ssl?: Array<{
+        txt_name?: string;
+        txt_value?: string;
+    }>;
+}
+
+/** Permitted HTTP verbs */
+type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+
+/**
+ * User Types
+ *
+ * Enums, DTOs and API response types. Database row types are in @playcademy/data/types.
+ *
+ * @module types/user
+ */
+type UserRoleEnumType = 'admin' | 'player' | 'developer';
+type DeveloperStatusEnumType = 'none' | 'pending' | 'approved';
+type DeveloperStatusValue = DeveloperStatusEnumType;
+type TimebackUserRole = 'administrator' | 'aide' | 'guardian' | 'parent' | 'proctor' | 'relative' | 'student' | 'teacher';
+type TimebackOrgType = 'department' | 'school' | 'district' | 'local' | 'state' | 'national';
+interface UserEnrollment {
+    gameId?: string;
+    courseId: string;
+    grade: number;
+    subject: string;
+    orgId?: string;
+}
+interface UserOrganization {
+    id: string;
+    name: string | null;
+    type: TimebackOrgType | string;
+    isPrimary: boolean;
+}
+interface TimebackStudentProfile {
+    role: TimebackUserRole;
+    organizations: UserOrganization[];
+}
+interface UserTimebackData extends TimebackStudentProfile {
+    id: string;
+    enrollments: UserEnrollment[];
+}
+/**
+ * OpenID Connect UserInfo claims (NOT a database row).
+ */
+interface UserInfo {
+    sub: string;
+    email: string;
+    name: string | null;
+    email_verified?: boolean;
+    given_name?: string;
+    family_name?: string;
+    issuer?: string;
+    lti_roles?: unknown;
+    lti_context?: unknown;
+    lti_resource_link?: unknown;
+    timeback_id?: string;
+}
+interface DeveloperStatusResponse {
+    status: DeveloperStatusEnumType;
+}
+/**
+ * Authenticated user for API responses.
+ * Differs from UserRow: omits timebackId, adds hasTimebackAccount and timeback.
+ */
+interface AuthenticatedUser {
+    id: string;
+    email: string;
+    emailVerified: boolean;
+    name: string | null;
+    image: string | null;
+    username: string | null;
+    role: UserRoleEnumType;
+    developerStatus: DeveloperStatusEnumType;
+    characterCreated: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    hasTimebackAccount: boolean;
+    timeback?: UserTimebackData;
+}
+interface GameUser {
+    id: string;
+    name: string | null;
+    role: UserRoleEnumType;
+    username: string | null;
+    email: string | null;
+    timeback?: UserTimebackData;
+}
+
+/**
+ * Leaderboard Types
+ *
+ * @module types/leaderboard
+ */
+type LeaderboardTimeframe = 'all_time' | 'monthly' | 'weekly' | 'daily';
+interface LeaderboardOptions {
+    timeframe?: LeaderboardTimeframe;
+    limit?: number;
+    offset?: number;
+    gameId?: string;
+}
+interface LeaderboardEntry {
+    rank: number;
+    userId: string;
+    username: string;
+    userImage?: string | null;
+    score: number;
+    achievedAt: Date;
+    metadata?: Record<string, unknown>;
+    gameId?: string;
+    gameTitle?: string;
+    gameSlug?: string;
+}
+interface UserRank {
+    rank: number;
+    totalPlayers: number;
+    score: number;
+    percentile: number;
+}
+interface UserRankResponse {
+    rank: number;
+    score: number;
+    userId: string;
+}
+interface UserScore {
+    id: string;
+    score: number;
+    achievedAt: Date;
+    metadata?: Record<string, unknown>;
+    gameId: string;
+    gameTitle: string;
+    gameSlug: string;
+}
+/**
+ * Leaderboard entry with required game context.
+ * Used when fetching leaderboards for a specific game.
+ */
+interface GameLeaderboardEntry {
+    rank: number;
+    userId: string;
+    username: string;
+    userImage?: string | null;
+    score: number;
+    achievedAt: Date;
+    metadata?: Record<string, unknown>;
+    gameId: string;
+    gameTitle: string;
+    gameSlug: string;
+}
+
+/**
+ * Achievement Types
+ *
+ * @module types/achievement
+ */
+type AchievementScopeType = 'daily' | 'weekly' | 'monthly' | 'yearly' | 'game' | 'global' | 'map' | 'level' | 'event';
+declare enum AchievementCompletionType {
+    TIME_PLAYED_SESSION = "time_played_session",
+    INTERACTION = "interaction",
+    LEADERBOARD_RANK = "leaderboard_rank",
+    FIRST_SCORE = "first_score",
+    PERSONAL_BEST = "personal_best"
+}
+interface AchievementCurrent {
+    id: string;
+    title: string;
+    description?: string | null;
+    scope: AchievementScopeType;
+    rewardCredits: number;
+    limit: number;
+    completionType: string;
+    completionConfig: unknown;
+    target: unknown;
+    active: boolean;
+    createdAt?: Date | null;
+    updatedAt?: Date | null;
+    status: 'available' | 'completed';
+    scopeKey: string;
+    windowStart: string;
+    windowEnd: string;
+}
+interface AchievementWithStatus {
+    id: string;
+    title: string;
+    description: string | null;
+    scope: AchievementScopeType;
+    rewardCredits: number;
+    limit: number;
+    completionType: string;
+    completionConfig: unknown;
+    target: unknown;
+    active: boolean;
+    createdAt: Date | null;
+    updatedAt: Date | null;
+    status: 'available' | 'completed';
+    scopeKey: string;
+    windowStart?: string;
+    windowEnd?: string;
+}
+interface AchievementHistoryEntry {
+    achievementId: string;
+    title: string;
+    rewardCredits: number;
+    createdAt: Date;
+    scopeKey: string;
+}
+interface AchievementProgressResponse {
+    achievementId: string;
+    status: 'completed' | 'already_completed';
+    rewardCredits: number;
+    scopeKey: string;
+    createdAt: Date;
+}
+
+/**
+ * TimeBack Enums & Literal Types
+ *
+ * Basic type definitions used throughout the TimeBack integration.
+ *
+ * @module types/timeback/types
+ */
+/**
+ * Valid TimeBack subject values for course configuration.
+ * These are the supported subject values for OneRoster courses.
+ */
+type TimebackSubject = 'Reading' | 'Language' | 'Vocabulary' | 'Social Studies' | 'Writing' | 'Science' | 'FastMath' | 'Math' | 'None';
+/**
+ * Grade levels per AE OneRoster GradeEnum.
+ * -1 = Pre-K, 0 = Kindergarten, 1-12 = Grades 1-12, 13 = AP
+ */
+type TimebackGrade = -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13;
+/**
+ * Valid Caliper subject values.
+ * Matches OneRoster subjects, with "None" as a Caliper-specific fallback.
+ */
+type CaliperSubject = 'Reading' | 'Language' | 'Vocabulary' | 'Social Studies' | 'Writing' | 'Science' | 'FastMath' | 'Math' | 'None';
+/**
+ * OneRoster organization types.
+ */
+type OrganizationType = 'department' | 'school' | 'district' | 'local' | 'state' | 'national';
+/**
+ * Lesson types for PowerPath integration.
+ */
+type LessonType = 'powerpath-100' | 'quiz' | 'test-out' | 'placement' | 'unit-test' | 'alpha-read-article' | null;
+
+/**
+ * TimeBack Configuration Types
+ *
+ * Configuration interfaces for Organization, Course, Component,
+ * Resource, and complete TimeBack setup.
+ *
+ * @module types/timeback/config
+ */
+
+/**
+ * Organization configuration for TimeBack (user input - optionals allowed)
+ */
+interface OrganizationConfig {
+    /** Display name for your organization */
+    name?: string;
+    /** Organization type */
+    type?: OrganizationType;
+    /** Unique identifier (defaults to Playcademy's org) */
+    identifier?: string;
+}
+/**
+ * Course goals for daily student targets
+ */
+interface CourseGoals {
+    /** Target XP students should earn per day */
+    dailyXp?: number;
+    /** Target lessons per day */
+    dailyLessons?: number;
+    /** Target active minutes per day */
+    dailyActiveMinutes?: number;
+    /** Target accuracy percentage */
+    dailyAccuracy?: number;
+    /** Target mastered units per day */
+    dailyMasteredUnits?: number;
+}
+/**
+ * Course metrics and totals
+ */
+interface CourseMetrics {
+    /** Total XP available in the course */
+    totalXp?: number;
+    /** Total lessons/activities in the course */
+    totalLessons?: number;
+    /** Total number of grade levels covered by this course */
+    totalGrades?: number;
+    /** The type of course (e.g. 'optional', 'hole-filling', 'base') */
+    courseType?: 'base' | 'hole-filling' | 'optional' | 'Base' | 'Hole-Filling' | 'Optional';
+    /** Indicates whether the course is supplemental content */
+    isSupplemental?: boolean;
+}
+/**
+ * Complete course metadata structure
+ */
+interface CourseMetadata {
+    /** Define the type of course and priority for the student */
+    courseType?: 'base' | 'hole-filling' | 'optional';
+    /** Boolean value to determine if a course is supplemental to a base course */
+    isSupplemental?: boolean;
+    /** Boolean value to determine if a course is custom to an individual student */
+    isCustom?: boolean;
+    /** Signals whether a course is in production with students */
+    publishStatus?: 'draft' | 'testing' | 'published' | 'deactivated';
+    /** Who to contact when issues reported with questions */
+    contactEmail?: string;
+    /** Primary app identifier */
+    primaryApp?: string;
+    /** Learning goals for students */
+    goals?: CourseGoals;
+    /** Course metrics and totals */
+    metrics?: CourseMetrics;
+    /** Vendor-specific metadata (e.g., AlphaLearn) */
+    [key: string]: unknown;
+}
+/**
+ * Course configuration for TimeBack (user input)
+ */
+interface CourseConfig {
+    /** Allocated OneRoster sourcedId (set after creation) */
+    sourcedId?: string;
+    /** Course title (defaults to game name) */
+    title?: string;
+    /** Subjects (REQUIRED for TimeBack integration) */
+    subjects: TimebackSubject[];
+    /** Used when recording progress/sessions if not explicitly specified per event. */
+    defaultSubject?: TimebackSubject;
+    /** Grade levels (REQUIRED for TimeBack integration) */
+    grades: TimebackGrade[];
+    /** Short course code (optional, auto-generated) */
+    courseCode?: string;
+    /** Course level (auto-derived from grades) */
+    level?: 'Elementary' | 'Middle' | 'High' | 'AP' | string;
+    /** Grading system */
+    gradingScheme?: 'STANDARD';
+    /** Total XP available in this course (REQUIRED before setup) */
+    totalXp?: number | null;
+    /** Total masterable units in this course (REQUIRED before setup) */
+    masterableUnits?: number | null;
+    /** Custom Playcademy metadata */
+    metadata?: CourseMetadata;
+}
+/**
+ * Component configuration for TimeBack (user input)
+ */
+interface ComponentConfig {
+    /** Component title (defaults to "{course.title} Activities") */
+    title?: string;
+    /** Display order */
+    sortOrder?: number;
+    /** Required prior components */
+    prerequisites?: string[];
+    /** How prerequisites work */
+    prerequisiteCriteria?: 'ALL' | 'ANY';
+}
+/**
+ * Playcademy-specific resource extensions
+ */
+interface PlaycademyResourceMetadata {
+    /** Mastery configuration for tracking discrete learning units */
+    mastery?: {
+        /** Total number of masterable units in the resource */
+        masterableUnits: number;
+        /** Type of mastery unit for semantic clarity */
+        unitType?: 'level' | 'rank' | 'skill' | 'module';
+    };
+}
+/**
+ * Resource configuration for TimeBack (user input)
+ */
+interface ResourceConfig {
+    /** Resource title (defaults to "{course.title} Game") */
+    title?: string;
+    /** Internal resource ID (auto-generated from package.json) */
+    vendorResourceId?: string;
+    /** Vendor identifier */
+    vendorId?: string;
+    /** Application identifier */
+    applicationId?: string;
+    /** Resource roles */
+    roles?: ('primary' | 'secondary')[];
+    /** Resource importance */
+    importance?: 'primary' | 'secondary';
+    /** Interactive resource metadata */
+    metadata?: {
+        /** Resource type */
+        type?: 'interactive';
+        /** Launch URL (defaults to Playcademy game URL) */
+        launchUrl?: string;
+        /** Platform name */
+        toolProvider?: string;
+        /** Teaching method */
+        instructionalMethod?: 'exploratory' | 'direct-instruction';
+        /** Subject area */
+        subject?: TimebackSubject;
+        /** Target grades */
+        grades?: TimebackGrade[];
+        /** Content language */
+        language?: string;
+        /** Base XP for completion */
+        xp?: number;
+        /** Playcademy-specific extensions */
+        playcademy?: PlaycademyResourceMetadata;
+    };
+}
+/**
+ * Component Resource link configuration (user input)
+ */
+interface ComponentResourceConfig {
+    /** Link title (defaults to "{resource.title} Activity") */
+    title?: string;
+    /** Display order */
+    sortOrder?: number;
+    /** Lesson type for PowerPath integration */
+    lessonType?: LessonType;
+}
+interface TimebackCourseConfig {
+    subject: string;
+    grade: number;
+}
+
+/**
+ * TimeBack Client SDK DTOs
+ *
+ * Data transfer objects for the TimeBack client SDK including
+ * progress tracking, session management, and activity completion.
+ *
+ * Note: TimebackClientConfig lives in @playcademy/timeback as it's
+ * SDK configuration, not a DTO.
+ *
+ * @module types/timeback/client
+ */
+
+/**
+ * Activity data for ending an activity
+ */
+interface ActivityData {
+    /** Unique activity identifier (required) */
+    activityId: string;
+    /** Grade level for this activity (required for multi-grade course routing) */
+    grade: number;
+    /** Subject area (required for multi-grade course routing) */
+    subject: CaliperSubject;
+    /** Activity display name (optional) */
+    activityName?: string;
+    /** Course identifier (auto-filled from config if not provided) */
+    courseId?: string;
+    /** Course display name (auto-filled from config if not provided) */
+    courseName?: string;
+    /** Student email address (optional) */
+    studentEmail?: string;
+    /** Application name for Caliper events (defaults to 'Game') */
+    appName?: string;
+    /** Sensor URL for Caliper events (defaults to baseUrl) */
+    sensorUrl?: string;
+}
+/**
+ * Score data with optional XP override for ending an activity
+ */
+interface EndActivityScoreData {
+    /** Number of questions answered correctly */
+    correctQuestions: number;
+    /** Total number of questions */
+    totalQuestions: number;
+    /** Optional XP override - bypasses automatic XP calculation */
+    xpAwarded?: number;
+    /** Number of learning units mastered */
+    masteredUnits?: number;
+}
+
+/**
+ * TimeBack API Request/Response Types
+ *
+ * Types for TimeBack API endpoints including XP tracking,
+ * setup, verification, and activity completion.
+ *
+ * @module types/timeback/api
+ */
+
+interface TodayXpResponse {
+    xp: number;
+    date: string;
+}
+interface TotalXpResponse {
+    totalXp: number;
+}
+interface XpHistoryResponse {
+    history: Array<{
+        date: string;
+        xp: number;
+    }>;
+}
+interface PopulateStudentResponse {
+    status: string;
+    message?: string;
+}
+interface GameTimebackIntegration {
+    id: string;
+    gameId: string;
+    courseId: string;
+    grade: number;
+    subject: string;
+    totalXp?: number | null;
+    lastVerifiedAt?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface EndActivityResponse {
+    status: 'ok';
+    courseId: string;
+    xpAwarded: number;
+    masteredUnits?: number;
+    pctCompleteApp?: number;
+    scoreStatus?: string;
+    inProgress?: string;
+}
+
+/**
+ * Inventory & Shop Types
+ *
+ * Literal types for inventory system. Database row types are in @playcademy/data/types.
+ *
+ * @module types/inventory
+ */
+/**
+ * Item categories available on the platform.
+ */
+type ItemType = 'currency' | 'badge' | 'trophy' | 'collectible' | 'consumable' | 'unlock' | 'upgrade' | 'accessory' | 'other';
+
+/**
+ * Map & Placement Types
+ *
+ * Literal types and JSON shapes for maps. Database row types are in @playcademy/data/types.
+ *
+ * @module types/map
+ */
+/**
+ * Allowed map interaction types.
+ */
+type InteractionType = 'game_entry' | 'game_registry' | 'info' | 'teleport' | 'door_in' | 'door_out' | 'npc_interaction' | 'quest_trigger';
+/**
+ * Metadata for interactive map elements.
+ */
+interface MapElementMetadata {
+    description?: string;
+    title?: string;
+    targetMapIdentifier?: string;
+    targetSpawnTileX?: number;
+    targetSpawnTileY?: number;
+    sourceTiledObjects?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+}
+/**
+ * Metadata describing how an item should be placed on the map.
+ */
+interface PlaceableItemMetadata {
+    tilesWide?: number;
+    tilesHigh?: number;
+    flippable?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Simplified map data for API responses.
+ */
+interface MapData {
+    id: string;
+    identifier: string;
+    displayName: string;
+    description?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+/**
+ * Input for creating a map object.
+ */
+interface CreateMapObjectData {
+    itemId: string;
+    worldX: number;
+    worldY: number;
+    width?: number;
+    height?: number;
+    rotation?: number;
+    scale?: number;
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Character & Avatar Types
+ *
+ * Literal types for character system. Database row types are in @playcademy/data/types.
+ *
+ * @module types/character
+ */
+/**
+ * Character component categories.
+ */
+type CharacterComponentType = 'body' | 'outfit' | 'hairstyle' | 'eyes' | 'accessory';
+
+/**
+ * Notification Types
+ *
+ * @module types/notification
+ */
+
+declare enum NotificationType {
+    ACHIEVEMENT = "achievement",
+    SYSTEM = "system",
+    PROMO = "promo"
+}
+declare enum NotificationStatus {
+    PENDING = "pending",
+    DELIVERED = "delivered",
+    SEEN = "seen",
+    CLICKED = "clicked",
+    DISMISSED = "dismissed",
+    EXPIRED = "expired"
+}
+interface NotificationStats {
+    total: number;
+    delivered: number;
+    seen: number;
+    clicked: number;
+    dismissed: number;
+    expired: number;
+    clickThroughRate: number;
+}
+
 declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "user";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "user";
+            tableName: "user";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: true;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: drizzle_orm_pg_core.PgColumn<{
+            name: "name";
+            tableName: "user";
+            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;
+        }, {}, {}>;
+        username: drizzle_orm_pg_core.PgColumn<{
+            name: "username";
+            tableName: "user";
+            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;
+        }, {}, {}>;
+        email: drizzle_orm_pg_core.PgColumn<{
+            name: "email";
+            tableName: "user";
+            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;
+        }, {}, {}>;
+        timebackId: drizzle_orm_pg_core.PgColumn<{
+            name: "timeback_id";
+            tableName: "user";
+            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;
+        }, {}, {}>;
+        emailVerified: drizzle_orm_pg_core.PgColumn<{
+            name: "email_verified";
+            tableName: "user";
+            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;
+        }, {}, {}>;
+        image: drizzle_orm_pg_core.PgColumn<{
+            name: "image";
+            tableName: "user";
+            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;
+        }, {}, {}>;
+        role: drizzle_orm_pg_core.PgColumn<{
+            name: "role";
+            tableName: "user";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "admin" | "developer" | "player";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["admin", "player", "developer"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        developerStatus: drizzle_orm_pg_core.PgColumn<{
+            name: "developer_status";
+            tableName: "user";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "approved" | "none" | "pending";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["none", "pending", "approved"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        characterCreated: drizzle_orm_pg_core.PgColumn<{
+            name: "character_created";
+            tableName: "user";
+            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;
+        }, {}, {}>;
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "user";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "updated_at";
+            tableName: "user";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+
+type GameMetadata = {
+    description?: string;
+    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;
+    columns: {
+        id: drizzle_orm_pg_core.PgColumn<{
+            name: "id";
+            tableName: "games";
+            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;
+        }, {}, {}>;
+        developerId: drizzle_orm_pg_core.PgColumn<{
+            name: "developer_id";
+            tableName: "games";
+            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;
+        }, {}, {}>;
+        slug: drizzle_orm_pg_core.PgColumn<{
+            name: "slug";
+            tableName: "games";
+            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: "games";
+            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;
+        }>;
+        version: drizzle_orm_pg_core.PgColumn<{
+            name: "version";
+            tableName: "games";
+            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;
+        }>;
+        gameType: drizzle_orm_pg_core.PgColumn<{
+            name: "game_type";
+            tableName: "games";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "external" | "hosted";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["hosted", "external"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deploymentUrl: drizzle_orm_pg_core.PgColumn<{
+            name: "deployment_url";
+            tableName: "games";
+            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;
+        }, {}, {}>;
+        externalUrl: drizzle_orm_pg_core.PgColumn<{
+            name: "external_url";
+            tableName: "games";
+            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;
+        }, {}, {}>;
+        platform: drizzle_orm_pg_core.PgColumn<{
+            name: "platform";
+            tableName: "games";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "godot" | "unity" | "web";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["web", "godot", "unity"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        mapElementId: drizzle_orm_pg_core.PgColumn<{
+            name: "map_element_id";
+            tableName: "games";
+            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;
+        }, {}, {}>;
+        metadata: drizzle_orm_pg_core.PgColumn<{
+            name: "metadata";
+            tableName: "games";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: GameMetadata;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: GameMetadata;
+        }>;
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "games";
+            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;
+        }, {}, {}>;
+        updatedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "updated_at";
+            tableName: "games";
+            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 gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "game_sessions";
+    schema: undefined;
+    columns: {
+        id: drizzle_orm_pg_core.PgColumn<{
+            name: "id";
+            tableName: "game_sessions";
             dataType: "string";
-            columnType: "PgText";
+            columnType: "PgUUID";
             data: string;
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: true;
             isAutoincrement: false;
-            hasRuntimeDefault: true;
-            enumValues: [string, ...string[]];
+            hasRuntimeDefault: false;
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        name: drizzle_orm_pg_core.PgColumn<{
-            name: "name";
-            tableName: "user";
+        userId: drizzle_orm_pg_core.PgColumn<{
+            name: "user_id";
+            tableName: "game_sessions";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -59,28 +1180,91 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        username: drizzle_orm_pg_core.PgColumn<{
-            name: "username";
-            tableName: "user";
+        gameId: drizzle_orm_pg_core.PgColumn<{
+            name: "game_id";
+            tableName: "game_sessions";
             dataType: "string";
-            columnType: "PgText";
+            columnType: "PgUUID";
             data: string;
             driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        startedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "started_at";
+            tableName: "game_sessions";
+            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;
+        }, {}, {}>;
+        endedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "ended_at";
+            tableName: "game_sessions";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
             notNull: false;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        email: drizzle_orm_pg_core.PgColumn<{
-            name: "email";
-            tableName: "user";
+    };
+    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: "PgText";
+            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;
@@ -88,19 +1272,19 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        timebackId: drizzle_orm_pg_core.PgColumn<{
-            name: "timeback_id";
-            tableName: "user";
+        userId: drizzle_orm_pg_core.PgColumn<{
+            name: "user_id";
+            tableName: "game_custom_hostnames";
             dataType: "string";
             columnType: "PgText";
             data: string;
             driverParam: string;
-            notNull: false;
+            notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -110,31 +1294,31 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        emailVerified: drizzle_orm_pg_core.PgColumn<{
-            name: "email_verified";
-            tableName: "user";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
+        hostname: drizzle_orm_pg_core.PgColumn<{
+            name: "hostname";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
             notNull: true;
-            hasDefault: true;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        image: drizzle_orm_pg_core.PgColumn<{
-            name: "image";
-            tableName: "user";
+        cloudflareId: drizzle_orm_pg_core.PgColumn<{
+            name: "cloudflare_id";
+            tableName: "game_custom_hostnames";
             dataType: "string";
             columnType: "PgText";
             data: string;
             driverParam: string;
-            notNull: false;
+            notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -144,66 +1328,85 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        role: drizzle_orm_pg_core.PgColumn<{
-            name: "role";
-            tableName: "user";
+        environment: drizzle_orm_pg_core.PgColumn<{
+            name: "environment";
+            tableName: "game_custom_hostnames";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "admin" | "player" | "developer";
+            data: "production" | "staging";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["admin", "player", "developer"];
+            enumValues: ["staging", "production"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        developerStatus: drizzle_orm_pg_core.PgColumn<{
-            name: "developer_status";
-            tableName: "user";
+        status: drizzle_orm_pg_core.PgColumn<{
+            name: "status";
+            tableName: "game_custom_hostnames";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "none" | "pending" | "approved";
+            data: "active" | "blocked" | "deleted" | "pending" | "pending_deletion" | "pending_deployment" | "pending_validation";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["none", "pending", "approved"];
+            enumValues: ["pending", "pending_validation", "pending_deployment", "pending_deletion", "active", "blocked", "deleted"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        characterCreated: drizzle_orm_pg_core.PgColumn<{
-            name: "character_created";
-            tableName: "user";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
+        sslStatus: drizzle_orm_pg_core.PgColumn<{
+            name: "ssl_status";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "active" | "deleted" | "initializing" | "pending_deployment" | "pending_issuance" | "pending_validation";
+            driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            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: "user";
+            tableName: "game_custom_hostnames";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -214,13 +1417,13 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
         }, {}, {}>;
         updatedAt: drizzle_orm_pg_core.PgColumn<{
             name: "updated_at";
-            tableName: "user";
+            tableName: "game_custom_hostnames";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -232,19 +1435,13 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-
-type GameMetadata = {
-    description?: string;
-    emoji?: string;
-    [key: string]: unknown;
-};
-declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "games";
+declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "items";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "games";
+            tableName: "items";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -254,71 +1451,16 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             isPrimaryKey: true;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        developerId: drizzle_orm_pg_core.PgColumn<{
-            name: "developer_id";
-            tableName: "games";
-            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;
-        }, {}, {}>;
-        slug: drizzle_orm_pg_core.PgColumn<{
-            name: "slug";
-            tableName: "games";
-            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: "games";
-            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;
-        }>;
-        version: drizzle_orm_pg_core.PgColumn<{
-            name: "version";
-            tableName: "games";
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        slug: drizzle_orm_pg_core.PgColumn<{
+            name: "slug";
+            tableName: "items";
             dataType: "string";
-            columnType: "PgVarchar";
+            columnType: "PgText";
             data: string;
             driverParam: string;
             notNull: true;
@@ -330,34 +1472,32 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {
-            length: 50;
-        }>;
-        gameType: drizzle_orm_pg_core.PgColumn<{
-            name: "game_type";
-            tableName: "games";
+        }, {}, {}>;
+        gameId: drizzle_orm_pg_core.PgColumn<{
+            name: "game_id";
+            tableName: "items";
             dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "hosted" | "external";
+            columnType: "PgUUID";
+            data: string;
             driverParam: string;
-            notNull: true;
-            hasDefault: true;
+            notNull: false;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["hosted", "external"];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        deploymentUrl: drizzle_orm_pg_core.PgColumn<{
-            name: "deployment_url";
-            tableName: "games";
+        displayName: drizzle_orm_pg_core.PgColumn<{
+            name: "display_name";
+            tableName: "items";
             dataType: "string";
             columnType: "PgText";
             data: string;
             driverParam: string;
-            notNull: false;
+            notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -367,9 +1507,9 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        externalUrl: drizzle_orm_pg_core.PgColumn<{
-            name: "external_url";
-            tableName: "games";
+        description: drizzle_orm_pg_core.PgColumn<{
+            name: "description";
+            tableName: "items";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -384,28 +1524,45 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        platform: drizzle_orm_pg_core.PgColumn<{
-            name: "platform";
-            tableName: "games";
+        type: drizzle_orm_pg_core.PgColumn<{
+            name: "type";
+            tableName: "items";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "web" | "godot" | "unity";
+            data: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["web", "godot", "unity"];
+            enumValues: ["currency", "badge", "trophy", "collectible", "consumable", "unlock", "upgrade", "accessory", "other"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        mapElementId: drizzle_orm_pg_core.PgColumn<{
-            name: "map_element_id";
-            tableName: "games";
+        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: "PgUUID";
+            columnType: "PgText";
             data: string;
             driverParam: string;
             notNull: false;
@@ -413,37 +1570,18 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: [string, ...string[]];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
         metadata: drizzle_orm_pg_core.PgColumn<{
             name: "metadata";
-            tableName: "games";
+            tableName: "items";
             dataType: "json";
             columnType: "PgJsonb";
-            data: GameMetadata;
+            data: unknown;
             driverParam: unknown;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            $type: GameMetadata;
-        }>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "games";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
             notNull: false;
             hasDefault: true;
             isPrimaryKey: false;
@@ -454,14 +1592,14 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "games";
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "items";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
-            notNull: false;
+            notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -474,13 +1612,13 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "game_sessions";
+declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "inventory_items";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "game_sessions";
+            tableName: "inventory_items";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -497,7 +1635,7 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
         }, {}, {}>;
         userId: drizzle_orm_pg_core.PgColumn<{
             name: "user_id";
-            tableName: "game_sessions";
+            tableName: "inventory_items";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -512,9 +1650,9 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        gameId: drizzle_orm_pg_core.PgColumn<{
-            name: "game_id";
-            tableName: "game_sessions";
+        itemId: drizzle_orm_pg_core.PgColumn<{
+            name: "item_id";
+            tableName: "inventory_items";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -529,13 +1667,13 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        startedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "started_at";
-            tableName: "game_sessions";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
+        quantity: drizzle_orm_pg_core.PgColumn<{
+            name: "quantity";
+            tableName: "inventory_items";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
@@ -546,15 +1684,15 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        endedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "ended_at";
-            tableName: "game_sessions";
+        updatedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "updated_at";
+            tableName: "inventory_items";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
             notNull: false;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -566,13 +1704,13 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "items";
+declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "currencies";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "items";
+            tableName: "currencies";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -587,60 +1725,26 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
             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";
+        itemId: drizzle_orm_pg_core.PgColumn<{
+            name: "item_id";
+            tableName: "currencies";
             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[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        description: drizzle_orm_pg_core.PgColumn<{
-            name: "description";
-            tableName: "items";
+        symbol: drizzle_orm_pg_core.PgColumn<{
+            name: "symbol";
+            tableName: "currencies";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -655,26 +1759,9 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
             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";
+        isPrimary: drizzle_orm_pg_core.PgColumn<{
+            name: "is_primary";
+            tableName: "currencies";
             dataType: "boolean";
             columnType: "PgBoolean";
             data: boolean;
@@ -689,31 +1776,14 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        imageUrl: drizzle_orm_pg_core.PgColumn<{
-            name: "image_url";
-            tableName: "items";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "currencies";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
             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;
+            notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -722,15 +1792,15 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "items";
+        }, {}, {}>;
+        updatedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "updated_at";
+            tableName: "currencies";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
-            notNull: true;
+            notNull: false;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -743,13 +1813,13 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "inventory_items";
+declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "shop_listings";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "inventory_items";
+            tableName: "shop_listings";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -764,11 +1834,11 @@ declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        userId: drizzle_orm_pg_core.PgColumn<{
-            name: "user_id";
-            tableName: "inventory_items";
+        itemId: drizzle_orm_pg_core.PgColumn<{
+            name: "item_id";
+            tableName: "shop_listings";
             dataType: "string";
-            columnType: "PgText";
+            columnType: "PgUUID";
             data: string;
             driverParam: string;
             notNull: true;
@@ -776,14 +1846,14 @@ declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        itemId: drizzle_orm_pg_core.PgColumn<{
-            name: "item_id";
-            tableName: "inventory_items";
+        currencyId: drizzle_orm_pg_core.PgColumn<{
+            name: "currency_id";
+            tableName: "shop_listings";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -798,15 +1868,15 @@ declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        quantity: drizzle_orm_pg_core.PgColumn<{
-            name: "quantity";
-            tableName: "inventory_items";
+        price: drizzle_orm_pg_core.PgColumn<{
+            name: "price";
+            tableName: "shop_listings";
             dataType: "number";
             columnType: "PgInteger";
             data: number;
             driverParam: string | number;
             notNull: true;
-            hasDefault: true;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -815,15 +1885,15 @@ declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "inventory_items";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
+        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: true;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -832,23 +1902,16 @@ declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "currencies";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "currencies";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
+        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;
@@ -856,15 +1919,15 @@ declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        itemId: drizzle_orm_pg_core.PgColumn<{
-            name: "item_id";
-            tableName: "currencies";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
+        isActive: drizzle_orm_pg_core.PgColumn<{
+            name: "is_active";
+            tableName: "shop_listings";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -873,32 +1936,32 @@ declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        symbol: drizzle_orm_pg_core.PgColumn<{
-            name: "symbol";
-            tableName: "currencies";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
+        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: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        isPrimary: drizzle_orm_pg_core.PgColumn<{
-            name: "is_primary";
-            tableName: "currencies";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
+        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;
@@ -909,7 +1972,7 @@ declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
         }, {}, {}>;
         createdAt: drizzle_orm_pg_core.PgColumn<{
             name: "created_at";
-            tableName: "currencies";
+            tableName: "shop_listings";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -926,7 +1989,7 @@ declare const currencies: drizzle_orm_pg_core.PgTableWithColumns<{
         }, {}, {}>;
         updatedAt: drizzle_orm_pg_core.PgColumn<{
             name: "updated_at";
-            tableName: "currencies";
+            tableName: "shop_listings";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -1157,7 +2220,7 @@ declare const mapElements: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "map_elements";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "game_entry" | "game_registry" | "info" | "teleport" | "door_in" | "door_out" | "npc_interaction" | "quest_trigger";
+            data: "door_in" | "door_out" | "game_entry" | "game_registry" | "info" | "npc_interaction" | "quest_trigger" | "teleport";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -1710,7 +2773,7 @@ declare const characterComponents: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "character_components";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "accessory" | "body" | "outfit" | "hairstyle" | "eyes";
+            data: "accessory" | "body" | "eyes" | "hairstyle" | "outfit";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -2121,22 +3184,54 @@ declare const playerCharacterAccessories: drizzle_orm_pg_core.PgTableWithColumns
     };
     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";
+declare const notifications: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "notifications";
     schema: undefined;
     columns: {
         id: drizzle_orm_pg_core.PgColumn<{
             name: "id";
-            tableName: "achievements";
+            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: true;
+            isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
             enumValues: [string, ...string[]];
@@ -2144,11 +3239,11 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: 255;
+            length: 50;
         }>;
         title: drizzle_orm_pg_core.PgColumn<{
             name: "title";
-            tableName: "achievements";
+            tableName: "notifications";
             dataType: "string";
             columnType: "PgVarchar";
             data: string;
@@ -2165,14 +3260,14 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
         }, {}, {
             length: 255;
         }>;
-        description: drizzle_orm_pg_core.PgColumn<{
-            name: "description";
-            tableName: "achievements";
+        message: drizzle_orm_pg_core.PgColumn<{
+            name: "message";
+            tableName: "notifications";
             dataType: "string";
             columnType: "PgText";
             data: string;
             driverParam: string;
-            notNull: false;
+            notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -2182,85 +3277,83 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             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;
+        data: drizzle_orm_pg_core.PgColumn<{
+            name: "data";
+            tableName: "notifications";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["daily", "weekly", "monthly", "yearly", "game", "global", "map", "level", "event"];
+            enumValues: undefined;
             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;
+        priority: drizzle_orm_pg_core.PgColumn<{
+            name: "priority";
+            tableName: "notifications";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "high" | "low" | "normal" | "urgent";
+            driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: ["low", "normal", "high", "urgent"];
             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;
+        status: drizzle_orm_pg_core.PgColumn<{
+            name: "status";
+            tableName: "notifications";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "clicked" | "delivered" | "dismissed" | "expired" | "pending" | "seen";
+            driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: ["pending", "delivered", "seen", "clicked", "dismissed", "expired"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        completionType: drizzle_orm_pg_core.PgColumn<{
-            name: "completion_type";
-            tableName: "achievements";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "notifications";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
             driverParam: string;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {
-            length: 50;
-        }>;
-        completionConfig: drizzle_orm_pg_core.PgColumn<{
-            name: "completion_config";
-            tableName: "achievements";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: true;
+        }, {}, {}>;
+        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;
@@ -2269,15 +3362,15 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        target: drizzle_orm_pg_core.PgColumn<{
-            name: "target";
-            tableName: "achievements";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: true;
+        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;
@@ -2286,15 +3379,15 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        active: drizzle_orm_pg_core.PgColumn<{
-            name: "active";
-            tableName: "achievements";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
+        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;
@@ -2303,15 +3396,15 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "achievements";
+        expiresAt: drizzle_orm_pg_core.PgColumn<{
+            name: "expires_at";
+            tableName: "notifications";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
             notNull: false;
-            hasDefault: true;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -2320,14 +3413,50 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "achievements";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
+        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;
@@ -2340,88 +3469,600 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-declare const DeveloperStatusResponseSchema: z.ZodObject<{
-    status: z.ZodEnum<["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, {
-    status: "none" | "pending" | "approved";
+    displayName: string;
+    mapElementId?: string | null | undefined;
+    platform: "godot" | "unity" | "web";
+    metadata: Record<string, unknown>;
+    gameType: "external" | "hosted";
+    externalUrl?: string | undefined;
+}, {
+    displayName: string;
+    mapElementId?: string | null | undefined;
+    platform: "godot" | "unity" | "web";
+    metadata?: Record<string, unknown> | undefined;
+    gameType?: "external" | "hosted" | undefined;
+    externalUrl?: string | undefined;
+}>, {
+    displayName: string;
+    mapElementId?: string | null | undefined;
+    platform: "godot" | "unity" | "web";
+    metadata: Record<string, unknown>;
+    gameType: "external" | "hosted";
+    externalUrl?: string | undefined;
 }, {
-    status: "none" | "pending" | "approved";
+    displayName: string;
+    mapElementId?: string | null | undefined;
+    platform: "godot" | "unity" | "web";
+    metadata?: Record<string, unknown> | undefined;
+    gameType?: "external" | "hosted" | undefined;
+    externalUrl?: string | undefined;
 }>;
-/**
- * Simplified game manifest for Cloudflare Workers deployments
- *
- * The manifest is auto-generated by build tools (Godot plugin, Vite plugin, etc.)
- * and provides minimal metadata about the build.
- *
- * Fields:
- * - version: Manifest schema version (for future migrations)
- * - platform: Auto-detected by build tool (e.g., 'web', 'godot@4.3', 'unity@2023')
- * - createdAt: Build timestamp (ISO 8601)
- *
- * Note: With unified Cloudflare Workers deployments, the worker handles all routing
- * internally, so we no longer need bootMode, entryPoint, or styles fields.
- */
-declare const ManifestV1Schema: z.ZodObject<{
-    version: z.ZodString;
-    platform: z.ZodString;
-    createdAt: z.ZodString;
+
+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: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
+        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>;
+}, "createdAt" | "id">, "strip", z.ZodTypeAny, {
+    slug?: string | undefined;
+    gameId?: string | null | undefined;
+    displayName?: string | undefined;
+    description?: string | null | undefined;
+    type?: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade" | undefined;
+    isPlaceable?: boolean | undefined;
+    imageUrl?: string | null | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    slug?: string | undefined;
+    gameId?: string | null | undefined;
+    displayName?: string | undefined;
+    description?: string | null | undefined;
+    type?: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade" | undefined;
+    isPlaceable?: boolean | undefined;
+    imageUrl?: string | null | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+declare const InsertCurrencySchema: drizzle_zod.BuildSchema<"insert", {
+    id: drizzle_orm_pg_core.PgColumn<{
+        name: "id";
+        tableName: "currencies";
+        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;
+    }, {}, {}>;
+    itemId: drizzle_orm_pg_core.PgColumn<{
+        name: "item_id";
+        tableName: "currencies";
+        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;
+    }, {}, {}>;
+    symbol: drizzle_orm_pg_core.PgColumn<{
+        name: "symbol";
+        tableName: "currencies";
+        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;
+    }, {}, {}>;
+    isPrimary: drizzle_orm_pg_core.PgColumn<{
+        name: "is_primary";
+        tableName: "currencies";
+        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;
+    }, {}, {}>;
+    createdAt: drizzle_orm_pg_core.PgColumn<{
+        name: "created_at";
+        tableName: "currencies";
+        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: "currencies";
+        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;
+    }, {}, {}>;
+}, {
+    itemId: z.ZodString;
+    isPrimary: z.ZodDefault<z.ZodBoolean>;
+}>;
+declare const UpdateCurrencySchema: z.ZodObject<{
+    itemId: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    isPrimary: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
-    createdAt: string;
-    version: string;
-    platform: string;
+    itemId?: string | undefined;
+    symbol?: string | null | undefined;
+    isPrimary?: boolean | undefined;
 }, {
-    createdAt: string;
-    version: string;
-    platform: string;
+    itemId?: string | undefined;
+    symbol?: string | null | undefined;
+    isPrimary?: boolean | undefined;
+}>;
+declare const InsertShopListingSchema: drizzle_zod.BuildSchema<"insert", {
+    id: drizzle_orm_pg_core.PgColumn<{
+        name: "id";
+        tableName: "shop_listings";
+        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;
+    }, {}, {}>;
+    itemId: drizzle_orm_pg_core.PgColumn<{
+        name: "item_id";
+        tableName: "shop_listings";
+        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;
+    }, {}, {}>;
+    currencyId: drizzle_orm_pg_core.PgColumn<{
+        name: "currency_id";
+        tableName: "shop_listings";
+        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;
+    }, {}, {}>;
+    price: drizzle_orm_pg_core.PgColumn<{
+        name: "price";
+        tableName: "shop_listings";
+        dataType: "number";
+        columnType: "PgInteger";
+        data: number;
+        driverParam: string | number;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    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;
+        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;
+    }, {}, {}>;
+}, {
+    price: z.ZodNumber;
+    sellBackPercentage: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    stock: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}>;
+declare const UpdateShopListingSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    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>>>;
+    isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    availableFrom: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodDate>>>;
+    availableUntil: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodDate>>>;
+    createdAt: z.ZodOptional<z.ZodOptional<z.ZodDate>>;
+    updatedAt: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodDate>>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    itemId?: string | undefined;
+    currencyId?: string | undefined;
+    price?: number | undefined;
+    sellBackPercentage?: number | null | undefined;
+    stock?: number | null | undefined;
+    isActive?: boolean | undefined;
+    availableFrom?: Date | null | undefined;
+    availableUntil?: Date | null | undefined;
+    createdAt?: Date | undefined;
+    updatedAt?: Date | null | undefined;
+}, {
+    id?: string | undefined;
+    itemId?: string | undefined;
+    currencyId?: string | undefined;
+    price?: number | undefined;
+    sellBackPercentage?: number | null | undefined;
+    stock?: number | null | undefined;
+    isActive?: boolean | undefined;
+    availableFrom?: Date | null | undefined;
+    availableUntil?: Date | null | undefined;
+    createdAt?: Date | undefined;
+    updatedAt?: Date | null | undefined;
 }>;
 
-declare enum AchievementCompletionType {
-    TIME_PLAYED_SESSION = "time_played_session",
-    INTERACTION = "interaction",
-    LEADERBOARD_RANK = "leaderboard_rank",
-    FIRST_SCORE = "first_score",
-    PERSONAL_BEST = "personal_best"
-}
-type AchievementScopeType = (typeof achievementScopeEnum.enumValues)[number];
-type Achievement = typeof achievements.$inferSelect;
-/**
- * Current-scope achievement with computed status and window metadata
- */
-interface AchievementCurrent {
-    id: string;
-    title: string;
-    description?: string | null;
-    scope: AchievementScopeType;
-    rewardCredits: number;
-    limit: number;
-    completionType: AchievementCompletionType;
-    completionConfig: Record<string, unknown>;
-    target: Record<string, unknown>;
-    active: boolean;
-    createdAt?: Date;
-    updatedAt?: Date;
-    status: 'available' | 'completed';
-    scopeKey: string;
-    windowStart: string;
-    windowEnd: string;
-}
-/**
- * Achievement progress submission response
- * Used in POST /api/achievements/progress
- */
-interface AchievementProgressResponse {
-    achievementId: string;
-    status: 'completed' | 'already_completed';
-    rewardCredits: number;
-    scopeKey: string;
-    createdAt: string;
-}
-
-type CharacterComponent = typeof characterComponents.$inferSelect;
-type PlayerCharacter = typeof playerCharacters.$inferSelect & {
-    accessories?: PlayerCharacterAccessory[];
-};
-type PlayerCharacterAccessory = typeof playerCharacterAccessories.$inferSelect;
 type GameRow = typeof games.$inferSelect;
 type BaseGame = Omit<GameRow, 'gameType' | 'deploymentUrl' | 'externalUrl'>;
 type HostedGame = BaseGame & {
@@ -2435,68 +4076,43 @@ type ExternalGame = BaseGame & {
     externalUrl: string;
 };
 type Game = HostedGame | ExternalGame;
-type GameSession = typeof gameSessions.$inferSelect;
-type GameStateData = Record<string, unknown>;
-type Item = typeof items.$inferSelect;
-type InventoryItem = typeof inventoryItems.$inferSelect;
-type Currency = typeof currencies.$inferSelect;
-interface PlaceableItemMetadata {
-    tilesWide?: number;
-    tilesHigh?: number;
-    flippable?: boolean;
-    [key: string]: unknown;
-}
-type Map = typeof maps.$inferSelect;
-type MapElement = typeof mapElements.$inferSelect;
-type MapObject = typeof mapObjects.$inferSelect;
+type GameSessionRow = typeof gameSessions.$inferSelect;
+type GameCustomHostnameRow = typeof gameCustomHostnames.$inferSelect;
 
-type User = typeof users.$inferSelect;
-type UserRoleEnumType = (typeof userRoleEnum.enumValues)[number];
-type DeveloperStatusResponse = z.infer<typeof DeveloperStatusResponseSchema>;
-/**
- * User data with authentication provider information.
- * Returned by the /users/me endpoint with additional auth context.
- */
-type AuthenticatedUser = User & {
-    /** Whether the user authenticated via Timeback SSO */
-    hasTimebackAccount: boolean;
+type UpsertGameMetadataInput = z.infer<typeof UpsertGameMetadataSchema>;
+
+type MapRow = typeof maps.$inferSelect;
+type MapElementRow = typeof mapElements.$inferSelect;
+type MapObjectRow = typeof mapObjects.$inferSelect;
+
+type CharacterComponentRow = typeof characterComponents.$inferSelect;
+type PlayerCharacterRow = typeof playerCharacters.$inferSelect & {
+    accessories?: PlayerCharacterAccessoryRow[];
 };
+type PlayerCharacterAccessoryRow = typeof playerCharacterAccessories.$inferSelect;
+
+type ItemRow = typeof items.$inferSelect;
+type InventoryItemRow = typeof inventoryItems.$inferSelect;
+type CurrencyRow = typeof currencies.$inferSelect;
+type ShopListingRow = 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>;
+
+type UserRow = typeof users.$inferSelect;
 
 /**
  * Cross-Domain Composite Types
  * Types that combine data from multiple domains
  */
-type ManifestV1 = z.infer<typeof ManifestV1Schema>;
-/**
- * Basic user information in the shape of the claims from identity providers
- */
-interface UserInfo {
-    /** Unique user identifier (sub claim from JWT) */
-    sub: string;
-    /** User's email address */
-    email: string;
-    /** User's display name */
-    name: string;
-    /** Whether the email has been verified */
-    email_verified: boolean;
-    /** Optional given name (first name) */
-    given_name?: string;
-    /** Optional family name (last name) */
-    family_name?: string;
-    /** TimeBack student ID (if user has TimeBack integration) */
-    timeback_id?: string;
-    /** Additional user attributes from the identity provider */
-    [key: string]: unknown;
-}
-/**
- * Character-related Composite Types
- * Types that combine character component data with sprite sheet information
- */
-type CharacterComponentWithSpriteUrl = CharacterComponent & {
+type CharacterComponentWithSpriteUrl = CharacterComponentRow & {
     spriteSheetUrl: string;
 };
-type InventoryItemWithItem = Omit<InventoryItem, 'itemId'> & {
-    item: Item;
+type InventoryItemWithItem = InventoryItemRow & {
+    item: ItemRow;
 };
 /**
  * Game with optional manifest metadata from build tools
@@ -2505,22 +4121,159 @@ type FetchedGame = (HostedGame | ExternalGame | GameRow) & {
     manifest?: ManifestV1;
 };
 /**
- * Map-related Composite Types
- * Types that combine map, game, and item data for rendering and interaction
+ * Session Bootstrap Payload Types
+ * Complex types that combine user, inventory, game, and map data for client initialization
  */
-interface MapElementWithGame extends MapElement {
-    game: Pick<Game, 'id' | 'displayName'> | null;
+interface PlayerProfile {
+    userId: UserRow['id'];
+    username: UserRow['username'];
+    name: UserRow['name'];
+    image?: UserRow['image'];
+    role?: UserRow['role'];
+    level?: number;
+    experience?: number;
+    experienceToNextLevel?: number;
+    characterCreated?: UserRow['characterCreated'];
+    hasTimebackAccount?: boolean;
+}
+interface PlayerCurrency {
+    currencySystemId: CurrencyRow['id'];
+    itemId: ItemRow['id'];
+    name: ItemRow['displayName'];
+    symbol?: CurrencyRow['symbol'];
+    imageUrl?: ItemRow['imageUrl'];
+    isPrimary: CurrencyRow['isPrimary'];
+    balance: number;
+}
+interface PlayerInventoryItem {
+    inventoryItemEntryId: InventoryItemRow['id'];
+    item: ItemRow;
+    quantity: InventoryItemRow['quantity'];
+    updatedAt: InventoryItemRow['updatedAt'];
+}
+interface PlayerLocation {
+    mapIdentifier: MapRow['identifier'];
+    mapDisplayName: MapRow['displayName'];
+    tileX?: number;
+    tileY?: number;
+    worldX?: number;
+    worldY?: number;
+    direction?: 'up' | 'down' | 'left' | 'right';
+}
+interface PlayerSessionPayload {
+    profile: PlayerProfile;
+    currencies: PlayerCurrency[];
+    inventory: PlayerInventoryItem[];
+    ownedGameIds: Game['id'][];
+    currentLocation?: PlayerLocation;
+    characterCreated?: UserRow['characterCreated'];
+    playerCharacter?: PlayerCharacterRow | null;
 }
-interface MapObjectWithItem extends MapObject {
-    item: Pick<Item, 'id' | 'slug' | 'displayName' | 'description' | 'imageUrl' | 'isPlaceable'> & {
-        metadata: PlaceableItemMetadata;
+/**
+ * Map-related Composite Types
+ * DB row + joined game/item data
+ */
+type MapElementWithGame = MapElementRow & {
+    game: {
+        id: string;
+        displayName: string;
+    } | null;
+};
+type MapObjectWithItem = MapObjectRow & {
+    item: {
+        id: string;
+        slug: string;
+        displayName: string;
+        description?: string | null;
+        imageUrl?: string | null;
+        isPlaceable: boolean;
+        metadata?: PlaceableItemMetadata | null;
     };
+};
+/**
+ * Game custom hostname with validation records
+ */
+type GameCustomHostname = GameCustomHostnameRow & {
+    validationRecords?: DomainValidationRecords;
+};
+
+type UserLevelRow = typeof userLevels.$inferSelect;
+type LevelConfigRow = typeof levelConfigs.$inferSelect;
+type UserLevelWithConfig = UserLevelRow & {
+    xpToNextLevel: number;
+    nextLevelConfig?: LevelConfigRow;
+};
+
+type SpriteTemplateRow = typeof spriteTemplates.$inferSelect;
+
+type NotificationRow = InferSelectModel<typeof notifications>;
+
+/**
+ * Level & Progression Types
+ *
+ * API response DTOs for level system. Database row types are in @playcademy/data/types.
+ *
+ * @module types/level
+ */
+/**
+ * Result of adding XP to a user.
+ */
+interface XPAddResult {
+    totalXP: number;
+    newLevel: number;
+    leveledUp: boolean;
+    creditsAwarded: number;
+    xpToNextLevel: number;
+}
+/**
+ * Result of checking whether a level up occurred.
+ */
+interface LevelUpCheckResult {
+    newLevel: number;
+    remainingXp: number;
+    leveledUp: boolean;
+    creditsAwarded: number;
+    xpToNextLevel: number;
+}
+/**
+ * Level progress API response.
+ */
+interface LevelProgressResponse {
+    level: number;
+    currentXp: number;
+    xpToNextLevel: number;
+    totalXP: number;
+}
+
+/**
+ * Shop Types
+ *
+ * @module types/shop
+ */
+/**
+ * Currency display info for shop UI.
+ */
+interface ShopCurrency {
+    id: string;
+    symbol: string | null;
+    isPrimary: boolean;
+    displayName?: string | null;
+    imageUrl?: string | null;
 }
 /**
- * Shop-related Composite Types
- * Types that combine inventory, currency, and shop listing data for commerce operations
+ * Shop item for display.
+ * Combines Item fields (excluding createdAt) with shop listing data.
  */
-interface ShopDisplayItem extends Omit<Item, 'createdAt'> {
+interface ShopDisplayItem {
+    id: string;
+    slug: string;
+    gameId?: string | null;
+    displayName: string;
+    description?: string | null;
+    type: string;
+    isPlaceable: boolean;
+    imageUrl?: string | null;
+    metadata?: unknown;
     listingId: string;
     shopPrice: number;
     currencyId: string;
@@ -2530,65 +4283,33 @@ interface ShopDisplayItem extends Omit<Item, 'createdAt'> {
     stock?: number | null;
     sellBackPercentage?: number | null;
 }
-interface ShopCurrency {
-    id: string;
-    symbol: string | null;
-    isPrimary: boolean;
-    displayName?: string | null;
-    imageUrl?: string | null;
-}
+/**
+ * Complete shop view response.
+ */
 interface ShopViewResponse {
     shopItems: ShopDisplayItem[];
     currencies: ShopCurrency[];
 }
+
 /**
- * Leaderboard Composite Types
- * Types that combine leaderboard, user, and game data
+ * Sprite Types
+ *
+ * JSON shapes for sprite configuration. Database row types are in @playcademy/data/types.
+ *
+ * @module types/sprite
  */
-interface GameLeaderboardEntry {
-    rank: number;
-    userId: string;
-    username: string;
-    userImage?: string | null;
-    score: number;
-    achievedAt: Date;
-    metadata?: Record<string, unknown>;
-    gameId: string;
-    gameTitle: string;
-    gameSlug: string;
-}
-
-type UserLevel = typeof userLevels.$inferSelect;
-type LevelConfig = typeof levelConfigs.$inferSelect;
-type UserLevelWithConfig = UserLevel & {
-    xpToNextLevel: number;
-    nextLevelConfig?: LevelConfig;
-};
-interface LeaderboardEntry {
-    rank: number;
-    userId: string;
-    username: string;
-    userImage?: string | null;
-    score: number;
-    achievedAt: Date;
-    metadata?: Record<string, unknown>;
-    gameId?: string;
-    gameTitle?: string;
-    gameSlug?: string;
-}
-interface UserRank {
-    rank: number;
-    totalPlayers: number;
-    score: number;
-    percentile: number;
-}
-interface UserRankResponse {
-    rank: number;
-    score: number;
-    userId: string;
+/**
+ * Animation frame configuration.
+ */
+interface SpriteAnimationFrame {
+    row: number;
+    frameStart: number;
+    numFrames: number;
+    fps: number;
 }
-
-type SpriteTemplate = typeof spriteTemplates.$inferSelect;
+/**
+ * Sprite template data structure (stored in JSONB).
+ */
 interface SpriteTemplateData {
     tileSize: number;
     tileHeight: number;
@@ -2596,115 +4317,31 @@ interface SpriteTemplateData {
     rows: number;
     spacing: number;
     animations: {
-        base_right: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        base_up: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        base_left: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        base_down: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        idle_right: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        walk_right: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        idle_up: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        walk_up: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        idle_left: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        walk_left: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        idle_down: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
-        walk_down: {
-            row: number;
-            frameStart: number;
-            numFrames: number;
-            fps: number;
-        };
+        base_right: SpriteAnimationFrame;
+        base_up: SpriteAnimationFrame;
+        base_left: SpriteAnimationFrame;
+        base_down: SpriteAnimationFrame;
+        idle_right: SpriteAnimationFrame;
+        walk_right: SpriteAnimationFrame;
+        idle_up: SpriteAnimationFrame;
+        walk_up: SpriteAnimationFrame;
+        idle_left: SpriteAnimationFrame;
+        walk_left: SpriteAnimationFrame;
+        idle_down: SpriteAnimationFrame;
+        walk_down: SpriteAnimationFrame;
     };
-}
-type TodayXpResponse = {
-    xp: number;
-    date: string;
-};
-type TotalXpResponse = {
-    totalXp: number;
-};
-type XpHistoryResponse = {
-    history: Array<{
-        date: string;
-        xp: number;
-    }>;
-};
-/**
- * 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;
-};
+}
+/**
+ * Sprite sheet configuration with precomputed dimensions.
+ */
+interface SpriteConfigWithDimensions {
+    textureUrl: string;
+    columns: number;
+    rows: number;
+    spriteWidth: number;
+    spriteHeight: number;
+    animations: Record<string, SpriteAnimationFrame>;
+}
 
 /**
  * Connection monitoring types
@@ -2720,6 +4357,180 @@ type EndActivityResponse = {
  */
 type ConnectionState = 'online' | 'offline' | 'degraded';
 
+/**
+ * Connection Manager
+ *
+ * Manages connection monitoring and integrates it with the Playcademy client.
+ * Handles event wiring, state management, and disconnect callbacks.
+ *
+ * In iframe mode, disables local monitoring and listens to platform connection
+ * state broadcasts instead (avoids duplicate heartbeats).
+ */
+
+/**
+ * Configuration for the ConnectionManager.
+ */
+interface ConnectionManagerConfig {
+    /** Base URL for API requests (used for heartbeat pings) */
+    baseUrl: string;
+    /** Authentication context (iframe vs standalone) for alert routing */
+    authContext?: {
+        isInIframe: boolean;
+    };
+    /** Handler to call when connection issues are detected */
+    onDisconnect?: DisconnectHandler;
+    /** Callback to emit connection change events to the client */
+    onConnectionChange?: (state: ConnectionState, reason: string) => void;
+}
+/**
+ * Manages connection monitoring for the Playcademy client.
+ *
+ * The ConnectionManager serves as an integration layer between the low-level
+ * ConnectionMonitor and the PlaycademyClient. It handles:
+ * - Event wiring and coordination
+ * - Disconnect callbacks with context
+ * - Platform-level alert integration
+ * - Request success/failure tracking
+ *
+ * This class is used internally by PlaycademyClient and typically not
+ * instantiated directly by game developers.
+ *
+ * @see {@link ConnectionMonitor} for the underlying monitoring implementation
+ * @see {@link PlaycademyClient.onDisconnect} for the public API
+ */
+declare class ConnectionManager {
+    private monitor?;
+    private authContext?;
+    private disconnectHandler?;
+    private connectionChangeCallback?;
+    private currentState;
+    private additionalDisconnectHandlers;
+    /**
+     * Creates a new ConnectionManager instance.
+     *
+     * @param config - Configuration options for the manager
+     *
+     * @example
+     * ```typescript
+     * const manager = new ConnectionManager({
+     *   baseUrl: 'https://api.playcademy.com',
+     *   authContext: { isInIframe: false },
+     *   onDisconnect: (context) => {
+     *     console.log(`Disconnected: ${context.state}`)
+     *   },
+     *   onConnectionChange: (state, reason) => {
+     *     console.log(`Connection changed: ${state}`)
+     *   }
+     * })
+     * ```
+     */
+    constructor(config: ConnectionManagerConfig);
+    /**
+     * Gets the current connection state.
+     *
+     * @returns The current connection state ('online', 'offline', or 'degraded')
+     *
+     * @example
+     * ```typescript
+     * const state = manager.getState()
+     * if (state === 'offline') {
+     *   console.log('No connection')
+     * }
+     * ```
+     */
+    getState(): ConnectionState;
+    /**
+     * Manually triggers a connection check immediately.
+     *
+     * Forces a heartbeat ping to verify the current connection status.
+     * Useful when you need to check connectivity before a critical operation.
+     *
+     * In iframe mode, this returns the last known state from platform.
+     *
+     * @returns Promise resolving to the current connection state
+     *
+     * @example
+     * ```typescript
+     * const state = await manager.checkNow()
+     * if (state === 'online') {
+     *   await performCriticalOperation()
+     * }
+     * ```
+     */
+    checkNow(): Promise<ConnectionState>;
+    /**
+     * Reports a successful API request to the connection monitor.
+     *
+     * This resets the consecutive failure counter and transitions from
+     * 'degraded' to 'online' state if applicable.
+     *
+     * Typically called automatically by the SDK's request wrapper.
+     * No-op in iframe mode (platform handles monitoring).
+     */
+    reportRequestSuccess(): void;
+    /**
+     * Reports a failed API request to the connection monitor.
+     *
+     * Only network errors are tracked (not 4xx/5xx HTTP responses).
+     * After consecutive failures exceed the threshold, the state transitions
+     * to 'degraded' or 'offline'.
+     *
+     * Typically called automatically by the SDK's request wrapper.
+     * No-op in iframe mode (platform handles monitoring).
+     *
+     * @param error - The error from the failed request
+     */
+    reportRequestFailure(error: unknown): void;
+    /**
+     * Registers a callback to be called when connection issues are detected.
+     *
+     * The callback only fires for 'offline' and 'degraded' states, not when
+     * recovering to 'online'. This provides a clean API for games to handle
+     * disconnect scenarios without being notified of every state change.
+     *
+     * Works in both iframe and standalone modes transparently.
+     *
+     * @param callback - Function to call when connection degrades
+     * @returns Cleanup function to unregister the callback
+     *
+     * @example
+     * ```typescript
+     * const cleanup = manager.onDisconnect(({ state, reason, displayAlert }) => {
+     *   if (state === 'offline') {
+     *     displayAlert?.('Connection lost. Saving your progress...', { type: 'error' })
+     *     saveGameState()
+     *   }
+     * })
+     *
+     * // Later: cleanup() to unregister
+     * ```
+     */
+    onDisconnect(callback: DisconnectHandler): () => void;
+    /**
+     * Stops connection monitoring and performs cleanup.
+     *
+     * Removes event listeners and clears heartbeat intervals.
+     * Should be called when the client is being destroyed.
+     */
+    stop(): void;
+    /**
+     * Sets up listener for platform connection state broadcasts (iframe mode only).
+     */
+    private _setupPlatformListener;
+    /**
+     * Handles connection state changes from the monitor or platform.
+     *
+     * Coordinates between:
+     * 1. Emitting events to the client (for client.on('connectionChange'))
+     * 2. Calling the disconnect handler if configured
+     * 3. Calling any additional handlers registered via onDisconnect()
+     *
+     * @param state - The new connection state
+     * @param reason - Human-readable reason for the state change
+     */
+    private _handleConnectionChange;
+}
+
 /**
  * @fileoverview Playcademy Messaging System
  *
@@ -2931,208 +4742,103 @@ declare function init<T extends PlaycademyClient = PlaycademyClient>(this: new (
  */
 declare function login(baseUrl: string, email: string, password: string): Promise<LoginResponse>;
 
-/** Permitted HTTP verbs */
-type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+/**
+ * @fileoverview Authentication Strategy Pattern
+ *
+ * Provides different authentication strategies for the Playcademy SDK.
+ * Each strategy knows how to add its authentication headers to requests.
+ */
 
 /**
- * Main Playcademy SDK client for interacting with the platform API.
- * Provides namespaced access to all platform features including games, users, inventory, and more.
+ * Base interface for authentication strategies
  */
-declare class PlaycademyClient {
+interface AuthStrategy {
+    /** Get the token value */
+    getToken(): string | null;
+    /** Get the token type */
+    getType(): TokenType;
+    /** Get authentication headers for a request */
+    getHeaders(): Record<string, string>;
+}
+
+/**
+ * Base Playcademy SDK client with shared infrastructure.
+ * Provides authentication, HTTP requests, events, connection monitoring,
+ * and fundamental namespaces used by all clients.
+ *
+ * Extended by PlaycademyClient (game SDK) and PlaycademyInternalClient (platform SDK).
+ */
+declare abstract class PlaycademyBaseClient {
     baseUrl: string;
     gameUrl?: string;
-    private authStrategy;
-    private gameId?;
-    private config;
-    private listeners;
-    private internalClientSessionId?;
-    private authContext?;
-    private initPayload?;
-    private connectionManager?;
+    protected authStrategy: AuthStrategy;
+    protected gameId?: string;
+    protected config: Partial<ClientConfig>;
+    protected listeners: EventListeners;
+    protected internalClientSessionId?: string;
+    protected authContext?: {
+        isInIframe: boolean;
+    };
+    protected initPayload?: InitPayload;
+    protected connectionManager?: ConnectionManager;
     /**
      * Internal session manager for automatic session lifecycle.
-     *
-     * 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
-     * @param config.autoStartSession - Automatically start a game session?
-     */
+    protected _sessionManager: {
+        startSession: (gameId: string) => Promise<{
+            sessionId: string;
+        }>;
+        endSession: (sessionId: string, gameId: string) => Promise<void>;
+    };
     constructor(config?: Partial<ClientConfig>);
     /**
      * Gets the effective base URL for API requests.
-     * Converts relative URLs to absolute URLs in browser environments.
-     * Note: baseUrl already includes /api suffix from constructor.
-     *
-     * @returns The complete base URL for API requests (with /api suffix)
      */
     getBaseUrl(): string;
     /**
      * Gets the effective game backend URL for integration requests.
-     * Throws if gameUrl is not configured.
-     *
-     * @returns The complete game backend URL for API requests (with /api suffix)
-     * @throws PlaycademyError if gameUrl is not set
      */
-    private getGameBackendUrl;
+    protected getGameBackendUrl(): string;
     /**
      * Simple ping method for testing connectivity.
-     *
-     * @returns 'pong' string response
      */
     ping(): string;
     /**
      * Sets the authentication token for API requests.
-     * Emits an 'authChange' event when the token changes.
-     *
-     * @param token - The authentication token, or null to clear
-     * @param tokenType - Optional token type (auto-detected if not provided)
      */
     setToken(token: string | null, tokenType?: TokenType): void;
     /**
      * Gets the current token type.
-     *
-     * @returns The token type
      */
     getTokenType(): TokenType;
     /**
      * Gets the current authentication token.
-     *
-     * @returns The current token or null if not authenticated
-     *
-     * @example
-     * ```typescript
-     * // Send token to your backend for verification
-     * const token = client.getToken()
-     * const response = await fetch('/api/auth/playcademy', {
-     *     method: 'POST',
-     *     body: JSON.stringify({ gameToken: token })
-     * })
-     * ```
      */
     getToken(): string | null;
     /**
-     * Checks if the client has a valid API token for making Playcademy API requests.
-     *
-     * For games (iframe context): Checks if we have a valid token from the parent.
-     * For Cademy (standalone): Checks if we have a token from better-auth.
-     *
-     * Note: This checks for API authentication, not whether a user has linked
-     * their identity via OAuth.
-     *
-     * @returns true if API token exists, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (client.isAuthenticated()) {
-     *     // Can make API calls
-     *     const games = await client.games.list()
-     * } else {
-     *     console.error('No API token available')
-     * }
-     * ```
+     * Checks if the client has a valid API token.
      */
     isAuthenticated(): boolean;
     /**
      * Registers a callback to be called when authentication state changes.
-     *
-     * @param callback - Function to call when auth state changes
      */
     onAuthChange(callback: (token: string | null) => void): void;
     /**
      * Registers a callback to be called when connection issues are detected.
-     *
-     * This is a convenience method that filters connection change events to only
-     * fire when the connection degrades (offline or degraded states). Use this
-     * when you want to handle disconnects without being notified of recoveries.
-     *
-     * For all connection state changes, use `client.on('connectionChange', ...)` instead.
-     *
-     * @param callback - Function to call when connection state changes to offline or degraded
-     * @returns Cleanup function to unregister the callback
-     *
-     * @example
-     * ```typescript
-     * const cleanup = client.onDisconnect(({ state, reason, displayAlert }) => {
-     *   console.log(`Connection ${state}: ${reason}`)
-     *
-     *   if (state === 'offline') {
-     *     // Save state and return to game lobby
-     *     displayAlert?.('Connection lost. Your progress has been saved.', { type: 'error' })
-     *     saveGameState()
-     *     returnToLobby()
-     *   } else if (state === 'degraded') {
-     *     displayAlert?.('Slow connection detected.', { type: 'warning' })
-     *   }
-     * })
-     *
-     * // Later: cleanup() to unregister
-     * ```
-     *
-     * @see Connection monitoring documentation in SDK Browser docs for detailed usage examples
-     * @see {@link ConnectionManager.onDisconnect} for the underlying implementation
      */
     onDisconnect(callback: (context: DisconnectContext) => void | Promise<void>): () => void;
     /**
      * Gets the current connection state.
-     *
-     * Returns the last known connection state without triggering a new check.
-     * Use `checkConnection()` to force an immediate verification.
-     *
-     * @returns Current connection state ('online', 'offline', 'degraded') or 'unknown' if monitoring is disabled
-     *
-     * @example
-     * ```typescript
-     * const state = client.getConnectionState()
-     * if (state === 'offline') {
-     *   console.log('No connection available')
-     * }
-     * ```
-     *
-     * @see {@link checkConnection} to trigger an immediate connection check
-     * @see {@link ConnectionManager.getState} for the underlying implementation
      */
     getConnectionState(): ConnectionState | 'unknown';
     /**
      * Manually triggers a connection check immediately.
-     *
-     * Forces a heartbeat ping to verify connectivity right now, bypassing the normal
-     * interval. Useful when you need to verify connection status before a critical
-     * operation (e.g., saving important game state).
-     *
-     * @returns Promise resolving to the current connection state after verification
-     *
-     * @example
-     * ```typescript
-     * // Check before critical operation
-     * const state = await client.checkConnection()
-     * if (state !== 'online') {
-     *   alert('Please check your internet connection before saving')
-     *   return
-     * }
-     *
-     * await client.games.saveState(importantData)
-     * ```
-     *
-     * @see {@link getConnectionState} to get the last known state without checking
-     * @see {@link ConnectionManager.checkNow} for the underlying implementation
      */
     checkConnection(): Promise<ConnectionState | 'unknown'>;
     /**
      * Sets the authentication context for the client.
-     * This is called during initialization to store environment info.
      * @internal
      */
     _setAuthContext(context: {
@@ -3140,28 +4846,14 @@ declare class PlaycademyClient {
     }): void;
     /**
      * Registers an event listener for client events.
-     *
-     * @param event - The event type to listen for
-     * @param callback - Function to call when the event is emitted
      */
     on<E extends keyof ClientEvents>(event: E, callback: (payload: ClientEvents[E]) => void): void;
     /**
      * Emits an event to all registered listeners.
-     *
-     * @param event - The event type to emit
-     * @param payload - The event payload
      */
-    private emit;
+    protected emit<E extends keyof ClientEvents>(event: E, payload: ClientEvents[E]): void;
     /**
      * Makes an authenticated HTTP request to the platform API.
-     *
-     * @param path - API endpoint path
-     * @param method - HTTP method
-     * @param options - Optional request configuration
-     * @param options.body - Request body
-     * @param options.headers - Additional headers
-     * @param options.raw - If true, returns raw Response instead of parsing
-     * @returns Promise resolving to the response data or raw Response
      */
     protected request<T>(path: string, method: Method, options?: {
         body?: unknown;
@@ -3170,53 +4862,65 @@ declare class PlaycademyClient {
     }): Promise<T>;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
-     * Uses gameUrl if set, otherwise falls back to platform API.
-     *
-     * @param path - API endpoint path
-     * @param method - HTTP method
-     * @param body - Request body (optional)
-     * @param headers - Additional headers (optional)
-     * @param raw - If true, returns raw Response instead of parsing (optional)
-     * @returns Promise resolving to the response data or raw Response
      */
     protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, raw?: boolean): Promise<T>;
     /**
      * Ensures a gameId is available, throwing an error if not.
-     *
-     * @returns The gameId
-     * @throws PlaycademyError if no gameId is configured
      */
-    private _ensureGameId;
+    protected _ensureGameId(): string;
     /**
      * Detects and sets the authentication context (iframe vs standalone).
-     * Safe to call in any environment - isInIframe handles browser detection.
      */
     private _detectAuthContext;
     /**
      * Initializes connection monitoring if enabled.
-     * Safe to call in any environment - only runs in browser.
      */
     private _initializeConnectionMonitor;
+    private _initializeInternalSession;
     /**
-     * Initializes an internal game session for automatic session management.
-     * Only starts a session if:
-     * 1. A gameId is configured
-     * 2. No session already exists
-     * 3. autoStartSession is enabled (defaults to false)
+     * Current user data and inventory management.
+     * - `me()` - Get authenticated user profile
+     * - `inventory.get()` - List user's items
+     * - `inventory.add(slug, qty)` - Award items to user
+     */
+    users: {
+        me: () => Promise<AuthenticatedUser>;
+        inventory: {
+            get: () => Promise<InventoryItemWithItem[]>;
+            add: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
+            remove: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
+            quantity: (identifier: string) => Promise<number>;
+            has: (identifier: string, minQuantity?: number) => Promise<boolean>;
+        };
+    };
+}
+
+/**
+ * Playcademy SDK client for game developers.
+ * Provides namespaced access to platform features for games running inside Cademy.
+ */
+declare class PlaycademyClient extends PlaycademyBaseClient {
+    /**
+     * Connect external identity providers to the user's Playcademy account.
+     * - `connect(provider)` - Link Discord, Google, etc. via OAuth popup
      */
-    private _initializeInternalSession;
-    /** Identity provider connection methods (connect external accounts) */
     identity: {
         connect: (options: AuthOptions) => Promise<AuthResult>;
         _getContext: () => {
             isInIframe: boolean;
         };
     };
-    /** Runtime methods (getGameToken, exit) */
+    /**
+     * Game runtime lifecycle and asset loading.
+     * - `exit()` - Return to Cademy hub
+     * - `getGameToken()` - Get short-lived auth token
+     * - `assets.url()`, `assets.json()`, `assets.fetch()` - Load game assets
+     * - `on('pause')`, `on('resume')` - Handle visibility changes
+     */
     runtime: {
         getGameToken: (gameId: string, options?: {
-            apply?: boolean;
-        }) => Promise<GameTokenResponse>;
+            apply?: boolean | undefined;
+        } | undefined) => Promise<GameTokenResponse>;
         exit: () => Promise<void>;
         onInit: (handler: (context: GameContextPayload) => void) => void;
         onTokenRefresh: (handler: (data: {
@@ -3240,57 +4944,73 @@ declare class PlaycademyClient {
         getListenerCounts: () => Record<string, number>;
         assets: {
             url(pathOrStrings: string | TemplateStringsArray, ...values: unknown[]): string;
-            fetch: (path: string, options?: RequestInit) => Promise<Response>;
+            fetch: (path: string, options?: RequestInit | undefined) => Promise<Response>;
             json: <T = unknown>(path: string) => Promise<T>;
             blob: (path: string) => Promise<Blob>;
             text: (path: string) => Promise<string>;
             arrayBuffer: (path: string) => Promise<ArrayBuffer>;
         };
     };
-    /** User methods (me, inventory management) */
-    users: {
-        me: () => Promise<AuthenticatedUser>;
-        inventory: {
-            get: () => Promise<InventoryItemWithItem[]>;
-            add: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
-            remove: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
-            quantity: (identifier: string) => Promise<number>;
-            has: (identifier: string, minQuantity?: number) => Promise<boolean>;
-        };
-    };
-    /** TimeBack XP methods (today, total, history) */
+    /**
+     * TimeBack integration for activity tracking and user context.
+     *
+     * User context (cached from init, refreshable):
+     * - `user.role` - User's role (student, parent, teacher, etc.)
+     * - `user.enrollments` - Courses the player is enrolled in for this game
+     * - `user.organizations` - Schools/districts the player belongs to
+     * - `user.fetch()` - Refresh user context from server
+     *
+     * Activity tracking:
+     * - `startActivity(metadata)` - Begin tracking an activity
+     * - `pauseActivity()` / `resumeActivity()` - Pause/resume timer
+     * - `endActivity(scoreData)` - Submit activity results to TimeBack
+     */
     timeback: {
-        startActivity: (metadata: _playcademy_timeback_types.ActivityData) => void;
+        readonly user: TimebackUser;
+        startActivity: (metadata: ActivityData) => void;
         pauseActivity: () => void;
         resumeActivity: () => void;
-        endActivity: (data: _playcademy_timeback_types.EndActivityScoreData) => Promise<EndActivityResponse>;
+        endActivity: (data: EndActivityScoreData) => Promise<EndActivityResponse>;
     };
-    /** Credits methods (credits management) */
+    /**
+     * Playcademy Credits (platform currency) management.
+     * - `get()` - Get user's credit balance
+     * - `add(amount)` - Award credits to user
+     */
     credits: {
         balance: () => Promise<number>;
         add: (amount: number) => Promise<number>;
         spend: (amount: number) => Promise<number>;
     };
-    /** Platform-wide scores methods (submit, getUserScores) */
+    /**
+     * Game score submission and leaderboards.
+     * - `submit(gameId, score, metadata?)` - Record a game score
+     */
     scores: {
-        submit: (gameId: string, score: number, metadata?: Record<string, unknown>) => Promise<ScoreSubmission>;
+        submit: (gameId: string, score: number, metadata?: Record<string, unknown> | undefined) => Promise<ScoreSubmission>;
     };
-    /** Realtime methods (token) */
+    /**
+     * Realtime multiplayer authentication.
+     * - `getToken()` - Get token for WebSocket/realtime connections
+     */
     realtime: {
         token: {
             get: () => Promise<RealtimeTokenResponse>;
         };
-        open(channel?: string, url?: string): Promise<_playcademy_realtime_server_types.RealtimeChannel>;
     };
-    /** Backend methods for calling custom game API routes */
+    /**
+     * Make requests to your game's custom backend API routes.
+     * - `get(path)`, `post(path, body)`, `put()`, `delete()` - HTTP methods
+     * - Routes are relative to your game's deployment (e.g., '/hello' → your-game.playcademy.gg/api/hello)
+     */
     backend: {
-        get<T = unknown>(path: string, headers?: Record<string, string>): Promise<T>;
-        post<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        put<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        patch<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        delete<T = unknown>(path: string, headers?: Record<string, string>): Promise<T>;
-        request<T = unknown>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        download(path: string, method?: Method, body?: unknown, headers?: Record<string, string>): Promise<Response>;
+        get<T = unknown>(path: string, headers?: Record<string, string> | undefined): Promise<T>;
+        post<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        put<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        patch<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        delete<T = unknown>(path: string, headers?: Record<string, string> | undefined): Promise<T>;
+        request<T = unknown>(path: string, method: Method, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        download(path: string, method?: Method, body?: unknown, headers?: Record<string, string> | undefined): Promise<Response>;
         url(pathOrStrings: string | TemplateStringsArray, ...values: unknown[]): string;
     };
     /** Auto-initializes a PlaycademyClient with context from the environment */
@@ -3303,9 +5023,70 @@ declare class PlaycademyClient {
     };
 }
 
+/**
+ * Type definitions for the game timeback namespace.
+ *
+ * SDK-specific types like TimebackInitContext that wrap the core types
+ * from @playcademy/types/user (which are re-exported via types/data.ts).
+ */
+
+/**
+ * A TimeBack enrollment for the current game session.
+ * Alias for UserEnrollment without the optional gameId.
+ */
+type TimebackEnrollment = Omit<UserEnrollment, 'gameId'>;
+/**
+ * A TimeBack organization (school/district) for the current user.
+ * Alias for UserOrganization.
+ */
+type TimebackOrganization = UserOrganization;
+/**
+ * TimeBack context passed during game initialization.
+ * This is sent from the platform (cademy) to the game iframe via postMessage.
+ */
+interface TimebackInitContext {
+    /** User's TimeBack ID */
+    id: string;
+    /** User's role in TimeBack (student, parent, teacher, etc.) */
+    role: TimebackUserRole;
+    /** User's enrollments for this game (one per grade/subject combo) */
+    enrollments: TimebackEnrollment[];
+    /** User's organizations (schools/districts) */
+    organizations: TimebackOrganization[];
+}
+/**
+ * TimeBack user context with current data (may be stale from init).
+ * Use `fetch()` to get fresh data from the server.
+ */
+interface TimebackUserContext {
+    /** User's TimeBack ID */
+    id: string | undefined;
+    /** User's role in TimeBack (student, parent, teacher, etc.) */
+    role: TimebackUserRole | undefined;
+    /** User's enrollments for this game */
+    enrollments: TimebackEnrollment[];
+    /** User's organizations (schools/districts) */
+    organizations: TimebackOrganization[];
+}
+/**
+ * TimeBack user object with both cached getters and fetch method.
+ */
+interface TimebackUser extends TimebackUserContext {
+    /**
+     * Fetch TimeBack data from the server (cached for 5 min).
+     * Updates the cached values so subsequent property access returns fresh data.
+     * @param options - Cache options (pass { force: true } to bypass cache)
+     * @returns Promise resolving to fresh user context
+     */
+    fetch(options?: {
+        force?: boolean;
+    }): Promise<TimebackUserContext>;
+}
+
 /**
  * Core client configuration and lifecycle types
  */
+
 type TokenType = 'session' | 'apiKey' | 'gameJwt';
 interface ClientConfig {
     baseUrl: string;
@@ -3349,12 +5130,17 @@ interface InitPayload {
     gameId: string;
     /** Realtime WebSocket URL */
     realtimeUrl?: string;
+    /** Timeback context (if user has a Timeback account) */
+    timeback?: TimebackInitContext;
 }
 /**
  * Simplified user data passed to games via InitPayload
  * This is a subset of AuthenticatedUser suitable for external game consumption
+ *
+ * Note: Named GameInitUser to distinguish from the cross-game GameUser DTO
+ * exported from @playcademy/types
  */
-interface GameUser {
+interface GameInitUser {
     /** Playcademy user ID */
     id: string;
     /** Unique username */
@@ -3533,19 +5319,6 @@ interface ScoreSubmission {
     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
  */
@@ -3684,6 +5457,8 @@ type DevUploadEvent = {
 } | {
     type: 'finalizeStatus';
     message: string;
+} | {
+    type: 'complete';
 } | {
     type: 'close';
 };
@@ -3695,29 +5470,37 @@ type DevUploadHooks = {
 /**
  * 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.
+ * Types for TimeBack data on the platform side.
+ * Unlike game types, these include gameId for cross-game enrollment views.
  */
 
 /**
- * Enrollment data for a student in a specific game/course.
- * Represents the mapping between a TimeBack course and a Playcademy game.
+ * Platform TimeBack user context.
+ * Unlike game context, enrollments include gameId for cross-game views.
  */
-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;
+interface PlatformTimebackUserContext {
+    /** User's TimeBack ID */
+    id: string | undefined;
+    /** User's role in TimeBack (student, parent, teacher, etc.) */
+    role: TimebackUserRole | undefined;
+    /** User's enrollments across ALL games (includes gameId) */
+    enrollments: UserEnrollment[];
+    /** User's organizations (schools/districts) */
+    organizations: UserOrganization[];
 }
 /**
- * Response from the enrollments endpoint
+ * Platform TimeBack user object with both cached getters and fetch method.
  */
-interface EnrollmentsResponse {
-    enrollments: StudentEnrollment[];
+interface PlatformTimebackUser extends PlatformTimebackUserContext {
+    /**
+     * Fetch TimeBack data from the server (cached for 5 min).
+     * Updates the cached values so subsequent property access returns fresh data.
+     * @param options - Cache options (pass { force: true } to bypass cache)
+     * @returns Promise resolving to user context with full enrollment data
+     */
+    fetch(options?: {
+        force?: boolean;
+    }): Promise<PlatformTimebackUserContext>;
 }
 /**
  * Combined response type for xp.summary() method
@@ -3905,5 +5688,5 @@ interface PlaycademyServerClientState {
     courseId?: string;
 }
 
-export { PlaycademyClient };
-export type { Achievement, AchievementCurrent, AchievementProgressResponse, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponent, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionStatePayload, CreateCharacterData, Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusResponse, DisconnectContext, DisconnectHandler, DisplayAlertPayload, 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 };
+export { AchievementCompletionType, NotificationStatus, NotificationType, PlaycademyClient };
+export type { AchievementCurrent, AchievementHistoryEntry, AchievementProgressResponse, AchievementScopeType, AchievementWithStatus, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponentRow as CharacterComponent, CharacterComponentType, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionStatePayload, CreateCharacterData, CreateMapObjectData, CurrencyRow as Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, DisconnectContext, DisconnectHandler, DisplayAlertPayload, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameCustomHostname, GameInitUser, GameLeaderboardEntry, MapRow as GameMap, GamePlatform, GameRow as GameRecord, GameSessionRow as GameSession, GameTimebackIntegration, GameTokenResponse, GameType, GameUser, HostedGame, InitPayload, InsertCurrencyInput, InsertItemInput, InsertShopListingInput, InteractionType, InventoryItemRow as InventoryItem, InventoryItemWithItem, InventoryMutationResponse, ItemRow as Item, ItemType, KeyEventPayload, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LevelConfigRow as LevelConfig, LevelProgressResponse, LevelUpCheckResult, LoginResponse, ManifestV1, MapData, MapElementRow as MapElement, MapElementMetadata, MapElementWithGame, MapObjectRow as MapObject, MapObjectWithItem, NotificationRow as Notification, NotificationStats, PlaceableItemMetadata, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacterRow as PlayerCharacter, PlayerCharacterAccessoryRow as PlayerCharacterAccessory, PlayerCurrency, PlayerInventoryItem, PlayerProfile, PlayerSessionPayload, PopulateStudentResponse, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopListingRow as ShopListing, ShopViewResponse, SpriteAnimationFrame, SpriteConfigWithDimensions, SpriteTemplateRow as SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TimebackEnrollment, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, UpdateCurrencyInput, UpdateItemInput, UpdateShopListingInput, UpsertGameMetadataInput, UserRow as User, UserEnrollment, UserInfo, UserLevelRow as UserLevel, UserLevelWithConfig, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData, XPAddResult, XpHistoryResponse, XpSummaryResponse };