@playcademy/sdk 0.2.2 → 0.2.4

package/dist/types.d.ts

@@ -1,7 +1,7 @@
+import { InferSelectModel } from 'drizzle-orm';
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
+import * as drizzle_zod from 'drizzle-zod';
 import { z } from 'zod';
-import * as _playcademy_timeback_types from '@playcademy/timeback/types';
-import { CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
 /**
@@ -19,7 +19,659 @@ 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;
@@ -148,7 +800,7 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "user";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "admin" | "player" | "developer";
+            data: "admin" | "developer" | "player";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -165,7 +817,7 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "user";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "none" | "pending" | "approved";
+            data: "approved" | "none" | "pending";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -237,6 +889,23 @@ type GameMetadata = {
     emoji?: string;
     [key: string]: unknown;
 };
+/**
+ * DNS validation records for custom hostname
+ * Structure for the validationRecords JSON field in game_custom_hostnames table
+ */
+type CustomHostnameValidationRecords = {
+    /** TXT record for ownership verification */
+    ownership?: {
+        name?: string;
+        value?: string;
+        type?: string;
+    };
+    /** TXT records for SSL certificate validation */
+    ssl?: Array<{
+        txt_name?: string;
+        txt_value?: string;
+    }>;
+};
 declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
     name: "games";
     schema: undefined;
@@ -337,7 +1006,7 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "games";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "hosted" | "external";
+            data: "external" | "hosted";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -388,7 +1057,7 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "games";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "web" | "godot" | "unity";
+            data: "godot" | "unity" | "web";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -470,55 +1139,254 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             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";
+    };
+    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: "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: "game_sessions";
+            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: "game_sessions";
+            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;
+        }, {}, {}>;
+        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: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * Custom hostnames table
+ *
+ * Stores custom domain mappings for games with SSL provisioning via Cloudflare.
+ */
+declare const gameCustomHostnames: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "game_custom_hostnames";
+    schema: undefined;
+    columns: {
+        id: drizzle_orm_pg_core.PgColumn<{
+            name: "id";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        gameId: drizzle_orm_pg_core.PgColumn<{
+            name: "game_id";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        userId: drizzle_orm_pg_core.PgColumn<{
+            name: "user_id";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        hostname: drizzle_orm_pg_core.PgColumn<{
+            name: "hostname";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        cloudflareId: drizzle_orm_pg_core.PgColumn<{
+            name: "cloudflare_id";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        environment: drizzle_orm_pg_core.PgColumn<{
+            name: "environment";
+            tableName: "game_custom_hostnames";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "production" | "staging";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["staging", "production"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: drizzle_orm_pg_core.PgColumn<{
+            name: "status";
+            tableName: "game_custom_hostnames";
             dataType: "string";
-            columnType: "PgUUID";
-            data: string;
+            columnType: "PgEnumColumn";
+            data: "active" | "blocked" | "deleted" | "pending" | "pending_deletion" | "pending_deployment" | "pending_validation";
             driverParam: string;
             notNull: true;
             hasDefault: true;
-            isPrimaryKey: true;
+            isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: ["pending", "pending_validation", "pending_deployment", "pending_deletion", "active", "blocked", "deleted"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        userId: drizzle_orm_pg_core.PgColumn<{
-            name: "user_id";
-            tableName: "game_sessions";
+        sslStatus: drizzle_orm_pg_core.PgColumn<{
+            name: "ssl_status";
+            tableName: "game_custom_hostnames";
             dataType: "string";
-            columnType: "PgText";
-            data: string;
+            columnType: "PgEnumColumn";
+            data: "active" | "deleted" | "initializing" | "pending_deployment" | "pending_issuance" | "pending_validation";
             driverParam: string;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: ["initializing", "pending_validation", "pending_issuance", "pending_deployment", "active", "deleted"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        gameId: drizzle_orm_pg_core.PgColumn<{
-            name: "game_id";
-            tableName: "game_sessions";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
+        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;
@@ -527,10 +1395,12 @@ declare const gameSessions: drizzle_orm_pg_core.PgTableWithColumns<{
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        startedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "started_at";
-            tableName: "game_sessions";
+        }, {}, {
+            $type: CustomHostnameValidationRecords;
+        }>;
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "game_custom_hostnames";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -545,15 +1415,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: "game_custom_hostnames";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
-            notNull: false;
-            hasDefault: false;
+            notNull: true;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -659,7 +1529,7 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "items";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "accessory" | "other";
+            data: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -814,15 +1684,233 @@ 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;
+        updatedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "updated_at";
+            tableName: "inventory_items";
+            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 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;
+            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;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+declare const shopListings: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "shop_listings";
+    schema: undefined;
+    columns: {
+        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: true;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -831,23 +1919,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;
+        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: true;
+            isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
             enumValues: undefined;
@@ -855,14 +1936,14 @@ 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;
+        availableFrom: drizzle_orm_pg_core.PgColumn<{
+            name: "available_from";
+            tableName: "shop_listings";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
             driverParam: string;
-            notNull: true;
+            notNull: false;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -872,35 +1953,18 @@ 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;
+        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: [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;
@@ -908,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;
@@ -925,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;
@@ -1156,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;
@@ -1709,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;
@@ -2120,34 +3184,47 @@ 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: "PgVarchar";
+            columnType: "PgUUID";
             data: string;
             driverParam: string;
             notNull: true;
-            hasDefault: false;
+            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;
-        }, {}, {
-            length: 255;
-        }>;
-        title: drizzle_orm_pg_core.PgColumn<{
-            name: "title";
-            tableName: "achievements";
+        }, {}, {}>;
+        type: drizzle_orm_pg_core.PgColumn<{
+            name: "type";
+            tableName: "notifications";
             dataType: "string";
             columnType: "PgVarchar";
             data: string;
@@ -2162,16 +3239,16 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: 255;
+            length: 50;
         }>;
-        description: drizzle_orm_pg_core.PgColumn<{
-            name: "description";
-            tableName: "achievements";
+        title: drizzle_orm_pg_core.PgColumn<{
+            name: "title";
+            tableName: "notifications";
             dataType: "string";
-            columnType: "PgText";
+            columnType: "PgVarchar";
             data: string;
             driverParam: string;
-            notNull: false;
+            notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -2180,31 +3257,33 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        scope: drizzle_orm_pg_core.PgColumn<{
-            name: "scope";
-            tableName: "achievements";
+        }, {}, {
+            length: 255;
+        }>;
+        message: drizzle_orm_pg_core.PgColumn<{
+            name: "message";
+            tableName: "notifications";
             dataType: "string";
-            columnType: "PgEnumColumn";
-            data: "map" | "game" | "level" | "daily" | "weekly" | "monthly" | "yearly" | "global" | "event";
+            columnType: "PgText";
+            data: string;
             driverParam: string;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["daily", "weekly", "monthly", "yearly", "game", "global", "map", "level", "event"];
+            enumValues: [string, ...string[]];
             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;
+        data: drizzle_orm_pg_core.PgColumn<{
+            name: "data";
+            tableName: "notifications";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
@@ -2215,49 +3294,47 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        limit: drizzle_orm_pg_core.PgColumn<{
-            name: "limit";
-            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;
         }, {}, {}>;
-        completionType: drizzle_orm_pg_core.PgColumn<{
-            name: "completion_type";
-            tableName: "achievements";
+        status: drizzle_orm_pg_core.PgColumn<{
+            name: "status";
+            tableName: "notifications";
             dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
+            columnType: "PgEnumColumn";
+            data: "clicked" | "delivered" | "dismissed" | "expired" | "pending" | "seen";
             driverParam: string;
             notNull: true;
-            hasDefault: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: ["pending", "delivered", "seen", "clicked", "dismissed", "expired"];
             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;
+        }, {}, {}>;
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "notifications";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
@@ -2268,15 +3345,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;
+        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;
@@ -2285,15 +3362,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;
+        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;
@@ -2302,15 +3379,15 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        createdAt: drizzle_orm_pg_core.PgColumn<{
-            name: "created_at";
-            tableName: "achievements";
+        clickedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "clicked_at";
+            tableName: "notifications";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
             notNull: false;
-            hasDefault: true;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -2319,14 +3396,67 @@ declare const achievements: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_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: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        method: drizzle_orm_pg_core.PgColumn<{
+            name: "method";
+            tableName: "notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 50;
+        }>;
+        clickUrl: drizzle_orm_pg_core.PgColumn<{
+            name: "click_url";
+            tableName: "notifications";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        metadata: drizzle_orm_pg_core.PgColumn<{
+            name: "metadata";
+            tableName: "notifications";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -2339,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;
 }, {
-    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;
+}>, {
+    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;
 }>;
-/**
- * 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 & {
@@ -2434,145 +4076,204 @@ 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 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;
 
-type User = typeof users.$inferSelect;
-type UserRoleEnumType = (typeof userRoleEnum.enumValues)[number];
-type DeveloperStatusResponse = z.infer<typeof DeveloperStatusResponseSchema>;
 /**
- * TimeBack enrollment information for a game.
+ * Cross-Domain Composite Types
+ * Types that combine data from multiple domains
  */
-type UserEnrollment = {
-    gameId?: string;
-    courseId: string;
-    grade: number;
-    subject: string;
-    orgId?: string;
+type CharacterComponentWithSpriteUrl = CharacterComponentRow & {
+    spriteSheetUrl: string;
+};
+type InventoryItemWithItem = InventoryItemRow & {
+    item: ItemRow;
 };
 /**
- * TimeBack user role (matches OneRoster spec).
+ * Game with optional manifest metadata from build tools
  */
-type TimebackUserRole = 'administrator' | 'aide' | 'guardian' | 'parent' | 'proctor' | 'relative' | 'student' | 'teacher';
+type FetchedGame = (HostedGame | ExternalGame | GameRow) & {
+    manifest?: ManifestV1;
+};
 /**
- * Organization type (matches OneRoster spec).
+ * Session Bootstrap Payload Types
+ * Complex types that combine user, inventory, game, and map data for client initialization
  */
-type TimebackOrgType = 'department' | 'school' | 'district' | 'local' | 'state' | 'national';
+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;
+}
 /**
- * TimeBack organization data for a user.
- * Represents schools, districts, or other educational organizations.
+ * Map-related Composite Types
+ * DB row + joined game/item data
  */
-type UserOrganization = {
-    /** Organization ID (OneRoster sourcedId) */
-    id: string;
-    /** Organization name */
-    name: string | null;
-    /** Organization type (school, district, etc.) */
-    type: TimebackOrgType | string;
-    /** Whether this is the user's primary organization */
-    isPrimary: boolean;
+type MapElementWithGame = MapElementRow & {
+    game: {
+        id: string;
+        displayName: string;
+    } | null;
 };
-/**
- * TimeBack student profile (role + organizations).
- * Subset of UserTimebackData returned by OneRoster API.
- */
-type TimebackStudentProfile = {
-    /** User's primary role in TimeBack (student, parent, teacher, etc.) */
-    role: TimebackUserRole;
-    /** User's organizations (schools/districts) */
-    organizations: UserOrganization[];
+type MapObjectWithItem = MapObjectRow & {
+    item: {
+        id: string;
+        slug: string;
+        displayName: string;
+        description?: string | null;
+        imageUrl?: string | null;
+        isPlaceable: boolean;
+        metadata?: PlaceableItemMetadata | null;
+    };
 };
 /**
- * TimeBack-related data for a user.
+ * Game custom hostname with validation records
  */
-type UserTimebackData = TimebackStudentProfile & {
-    /** User's TimeBack ID (sourcedId) */
-    id: string;
-    /** Course enrollments */
-    enrollments: UserEnrollment[];
+type GameCustomHostname = GameCustomHostnameRow & {
+    validationRecords?: DomainValidationRecords;
 };
-/**
- * User data with authentication provider information.
- * Returned by the /users/me endpoint with additional auth context.
- */
-type AuthenticatedUser = Omit<User, 'timebackId'> & {
-    /** Whether the user authenticated via Timeback SSO */
-    hasTimebackAccount: boolean;
-    /** TimeBack data (id, role, enrollments, organizations) - only present if user has a timeback account */
-    timeback?: UserTimebackData;
+
+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>;
+
 /**
- * Cross-Domain Composite Types
- * Types that combine data from multiple domains
+ * Level & Progression Types
+ *
+ * API response DTOs for level system. Database row types are in @playcademy/data/types.
+ *
+ * @module types/level
  */
-type ManifestV1 = z.infer<typeof ManifestV1Schema>;
 /**
- * Basic user information in the shape of the claims from identity providers
+ * Result of adding XP to a user.
  */
-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;
+interface XPAddResult {
+    totalXP: number;
+    newLevel: number;
+    leveledUp: boolean;
+    creditsAwarded: number;
+    xpToNextLevel: number;
 }
 /**
- * Character-related Composite Types
- * Types that combine character component data with sprite sheet information
+ * Result of checking whether a level up occurred.
  */
-type CharacterComponentWithSpriteUrl = CharacterComponent & {
-    spriteSheetUrl: string;
-};
-type InventoryItemWithItem = Omit<InventoryItem, 'itemId'> & {
-    item: Item;
-};
+interface LevelUpCheckResult {
+    newLevel: number;
+    remainingXp: number;
+    leveledUp: boolean;
+    creditsAwarded: number;
+    xpToNextLevel: number;
+}
 /**
- * Game with optional manifest metadata from build tools
+ * Level progress API response.
  */
-type FetchedGame = (HostedGame | ExternalGame | GameRow) & {
-    manifest?: ManifestV1;
-};
+interface LevelProgressResponse {
+    level: number;
+    currentXp: number;
+    xpToNextLevel: number;
+    totalXP: number;
+}
+
 /**
- * Map-related Composite Types
- * Types that combine map, game, and item data for rendering and interaction
+ * Shop Types
+ *
+ * @module types/shop
  */
-interface MapElementWithGame extends MapElement {
-    game: Pick<Game, 'id' | 'displayName'> | null;
-}
-interface MapObjectWithItem extends MapObject {
-    item: Pick<Item, 'id' | 'slug' | 'displayName' | 'description' | 'imageUrl' | 'isPlaceable'> & {
-        metadata: PlaceableItemMetadata;
-    };
+/**
+ * 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;
@@ -2582,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;
@@ -2648,118 +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).
+ * Sprite sheet configuration with precomputed dimensions.
  */
-type TimebackCourseConfig = {
-    subject: string;
-    grade: number;
-};
-type EndActivityResponse = {
-    status: 'ok';
-    courseId: string;
-    xpAwarded: number;
-    masteredUnits?: number;
-    pctCompleteApp?: number;
-    scoreStatus?: string;
-    inProgress?: string;
-};
-
-/** Permitted HTTP verbs */
-type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface SpriteConfigWithDimensions {
+    textureUrl: string;
+    columns: number;
+    rows: number;
+    spriteWidth: number;
+    spriteHeight: number;
+    animations: Record<string, SpriteAnimationFrame>;
+}
 
 /**
  * Connection monitoring types
@@ -3294,9 +4876,6 @@ declare abstract class PlaycademyBaseClient {
      * Initializes connection monitoring if enabled.
      */
     private _initializeConnectionMonitor;
-    /**
-     * Initializes an internal game session for automatic session management.
-     */
     private _initializeInternalSession;
     /**
      * Current user data and inventory management.
@@ -3340,8 +4919,8 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      */
     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: {
@@ -3365,7 +4944,7 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
         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>;
@@ -3388,10 +4967,10 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      */
     timeback: {
         readonly user: TimebackUser;
-        startActivity: (metadata: _playcademy_timeback_types.ActivityData) => void;
+        startActivity: (metadata: ActivityData) => void;
         pauseActivity: () => void;
         resumeActivity: () => void;
-        endActivity: (data: _playcademy_timeback_types.EndActivityScoreData) => Promise<EndActivityResponse>;
+        endActivity: (data: EndActivityScoreData) => Promise<EndActivityResponse>;
     };
     /**
      * Playcademy Credits (platform currency) management.
@@ -3408,7 +4987,7 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      * - `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 multiplayer authentication.
@@ -3425,13 +5004,13 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      * - 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 */
@@ -3447,8 +5026,8 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
 /**
  * Type definitions for the game timeback namespace.
  *
- * Re-exports core types from @playcademy/data for SDK consumers,
- * plus SDK-specific types like TimebackInitContext.
+ * SDK-specific types like TimebackInitContext that wrap the core types
+ * from @playcademy/types/user (which are re-exported via types/data.ts).
  */
 
 /**
@@ -3557,8 +5136,11 @@ interface InitPayload {
 /**
  * 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 */
@@ -3737,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
  */
@@ -3888,6 +5457,8 @@ type DevUploadEvent = {
 } | {
     type: 'finalizeStatus';
     message: string;
+} | {
+    type: 'complete';
 } | {
     type: 'close';
 };
@@ -4117,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, 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, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacter, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TimebackEnrollment, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TimebackUserRole, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, User, UserEnrollment, UserInfo, UserLevel, UserLevelWithConfig, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData, 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 };