@playcademy/sdk 0.9.1-beta.2 → 0.10.0

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-import { UserRole, AUTH_PROVIDER_IDS } from '@playcademy/constants';
-import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
+import * as _playcademy_types from '@playcademy/types';
+import { TimebackGrade, TimebackSubject } from '@playcademy/types/timeback';
+import { TimebackUserRole, UserEnrollment, UserOrganization, UserInfo } from '@playcademy/types/user';
+import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
 /**
  * Base error class for Cademy SDK specific errors.
@@ -138,231 +140,17 @@ interface ApiErrorInfo {
  * @example
  * ```typescript
  * try {
- *   await client.shop.purchase(itemId)
+ *   await client.scores.submit(100)
  * } catch (error) {
  *   const info = extractApiErrorInfo(error)
  *   if (info) {
- *     showToast(`Error: ${info.message}`)
+ *     console.error(`Error: ${info.message}`)
  *   }
  * }
  * ```
  */
 declare function extractApiErrorInfo(error: unknown): ApiErrorInfo | null;
 
-/**
- * Connection monitoring types
- *
- * Type definitions for connection state, configuration, and callbacks.
- */
-/**
- * Possible connection states.
- *
- * - **online**: Connection is stable and healthy
- * - **offline**: Complete loss of network connectivity
- * - **degraded**: Connection is slow or experiencing intermittent issues
- */
-type ConnectionState = 'online' | 'offline' | 'degraded';
-/**
- * Configuration options for ConnectionMonitor.
- *
- * @see {@link ConnectionMonitor} for usage
- */
-interface ConnectionMonitorConfig {
-    /** Base URL for heartbeat pings (e.g., 'https://api.playcademy.com') */
-    baseUrl: string;
-    /** How often to send heartbeat pings in milliseconds (default: 10000) */
-    heartbeatInterval?: number;
-    /** How long to wait for heartbeat response in milliseconds (default: 5000) */
-    heartbeatTimeout?: number;
-    /** Number of consecutive failures before triggering disconnect (default: 2) */
-    failureThreshold?: number;
-    /** Enable periodic heartbeat monitoring (default: true) */
-    enableHeartbeat?: boolean;
-    /** Enable browser online/offline event listeners (default: true) */
-    enableOfflineEvents?: boolean;
-}
-/**
- * Callback function signature for connection state changes.
- *
- * @param state - The new connection state
- * @param reason - Human-readable reason for the state change
- */
-type ConnectionChangeCallback = (state: ConnectionState, reason: string) => void;
-
-/**
- * Connection Monitor
- *
- * Monitors network connectivity using multiple signals:
- * 1. navigator.onLine - Instant offline detection
- * 2. Periodic heartbeat - Detects slow/degraded connections
- * 3. Request failure tracking - Piggybacks on actual API calls
- *
- * Designed for school WiFi environments where connections may be
- * unstable or degraded without fully disconnecting.
- */
-
-/**
- * Monitors network connectivity using multiple signals and notifies callbacks of state changes.
- *
- * The ConnectionMonitor uses a multi-signal approach to detect connection issues:
- *
- * 1. **navigator.onLine events** - Instant detection of hard disconnects
- * 2. **Heartbeat pings** - Periodic checks to detect slow/degraded connections
- * 3. **Request failure tracking** - Piggybacks on actual API calls
- *
- * This comprehensive approach ensures reliable detection across different network
- * failure modes common in school WiFi environments (hard disconnect, slow connection,
- * intermittent failures).
- *
- * @example
- * ```typescript
- * const monitor = new ConnectionMonitor({
- *   baseUrl: 'https://api.playcademy.com',
- *   heartbeatInterval: 10000,  // Check every 10s
- *   failureThreshold: 2         // Trigger after 2 failures
- * })
- *
- * monitor.onChange((state, reason) => {
- *   console.log(`Connection: ${state} - ${reason}`)
- * })
- *
- * monitor.start()
- * ```
- *
- * @see {@link ConnectionManagerConfig} for configuration options
- */
-declare class ConnectionMonitor {
-    private state;
-    private callbacks;
-    private heartbeatInterval?;
-    private consecutiveFailures;
-    private isMonitoring;
-    private config;
-    /**
-     * Creates a new ConnectionMonitor instance.
-     *
-     * The monitor starts in a stopped state. Call `start()` to begin monitoring.
-     *
-     * @param config - Configuration options
-     * @param config.baseUrl - Base URL for heartbeat pings
-     * @param config.heartbeatInterval - How often to check (default: 10000ms)
-     * @param config.heartbeatTimeout - Request timeout (default: 5000ms)
-     * @param config.failureThreshold - Failures before triggering disconnect (default: 2)
-     * @param config.enableHeartbeat - Enable periodic checks (default: true)
-     * @param config.enableOfflineEvents - Listen to browser events (default: true)
-     */
-    constructor(config: ConnectionMonitorConfig);
-    /**
-     * Starts monitoring the connection state.
-     *
-     * Sets up event listeners and begins heartbeat checks based on configuration.
-     * Idempotent - safe to call multiple times.
-     */
-    start(): void;
-    /**
-     * Stops monitoring the connection state and cleans up resources.
-     *
-     * Removes event listeners and clears heartbeat intervals.
-     * Idempotent - safe to call multiple times.
-     */
-    stop(): void;
-    /**
-     * Registers a callback to be notified of all connection state changes.
-     *
-     * The callback fires for all state transitions: online → offline,
-     * offline → degraded, degraded → online, etc.
-     *
-     * @param callback - Function called with (state, reason) when connection changes
-     * @returns Cleanup function to unregister the callback
-     *
-     * @example
-     * ```typescript
-     * const cleanup = monitor.onChange((state, reason) => {
-     *   console.log(`Connection: ${state}`)
-     *   if (state === 'offline') {
-     *     showReconnectingUI()
-     *   }
-     * })
-     *
-     * // Later: cleanup() to unregister
-     * ```
-     */
-    onChange(callback: ConnectionChangeCallback): () => void;
-    /**
-     * Gets the current connection state.
-     *
-     * @returns The current state ('online', 'offline', or 'degraded')
-     */
-    getState(): ConnectionState;
-    /**
-     * Manually triggers an immediate connection check.
-     *
-     * Forces a heartbeat ping to verify connectivity right now, bypassing
-     * the normal interval. Useful before critical operations.
-     *
-     * @returns Promise resolving to the current connection state after the check
-     *
-     * @example
-     * ```typescript
-     * const state = await monitor.checkNow()
-     * if (state !== 'online') {
-     *   alert('Please check your internet connection')
-     * }
-     * ```
-     */
-    checkNow(): Promise<ConnectionState>;
-    /**
-     * Reports a request failure for tracking.
-     *
-     * This should be called from your request wrapper whenever an API call fails.
-     * Only network errors are tracked (TypeError, fetch failures) - HTTP error
-     * responses (4xx, 5xx) are ignored.
-     *
-     * After consecutive failures exceed the threshold, the monitor transitions
-     * to 'degraded' or 'offline' state.
-     *
-     * @param error - The error from the failed request
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   await fetch('/api/data')
-     * } catch (error) {
-     *   monitor.reportRequestFailure(error)
-     *   throw error
-     * }
-     * ```
-     */
-    reportRequestFailure(error: unknown): void;
-    /**
-     * Reports a successful request.
-     *
-     * This should be called from your request wrapper whenever an API call succeeds.
-     * Resets the consecutive failure counter and transitions from 'degraded' to
-     * 'online' if the connection has recovered.
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   const result = await fetch('/api/data')
-     *   monitor.reportRequestSuccess()
-     *   return result
-     * } catch (error) {
-     *   monitor.reportRequestFailure(error)
-     *   throw error
-     * }
-     * ```
-     */
-    reportRequestSuccess(): void;
-    private _detectInitialState;
-    private _handleOnline;
-    private _handleOffline;
-    private _startHeartbeat;
-    private _performHeartbeat;
-    private _handleHeartbeatFailure;
-    private _setState;
-}
-
 /**
  * OAuth 2.0 implementation for the Playcademy SDK
  */
@@ -384,239 +172,6 @@ interface RetryPolicy {
     retryableMethods?: readonly Method[];
 }
 
-/**
- * User Types
- *
- * Enums, DTOs and API response types. Database row types are in @playcademy/data/types.
- *
- * @module types/user
- */
-
-type UserRoleEnumType = UserRole;
-type DeveloperStatusEnumType = 'none' | 'pending' | 'approved';
-type TimebackUserRole = 'administrator' | 'aide' | 'guardian' | 'parent' | 'proctor' | 'relative' | 'student' | 'teacher';
-type TimebackOrgType = 'department' | 'school' | 'district' | 'local' | 'state' | 'national';
-interface UserEnrollment {
-    gameId?: string;
-    courseId: string;
-    enrollmentIds?: {
-        active: string;
-        inactive?: 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 DemoProfile {
-    displayName: string;
-    isDefault: boolean;
-}
-/**
- * Update shape for `client.demo.profile.update(...)`.
- *
- * Kept as a named type so callers typed against it pick up new fields
- * automatically, but `displayName` is the only updatable field today and
- * the server's `DemoProfileSchema` requires it — a no-field payload would
- * 400 at runtime, so we model that at the type level too. When additional
- * fields land, make them required/optional individually based on server
- * validation, rather than blanket-optional.
- */
-interface DemoProfileUpdate {
-    displayName: string;
-}
-/**
- * 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;
-}
-
-/**
- * Leaderboard Types
- *
- * @module types/leaderboard
- */
-type LeaderboardTimeframe = 'all_time' | 'monthly' | 'weekly' | 'daily';
-interface LeaderboardOptions {
-    timeframe?: LeaderboardTimeframe;
-    limit?: number;
-    offset?: number;
-    gameId?: 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;
-}
-
-/**
- * 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';
-
-/**
- * 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
- */
-
-/**
- * Known extensions for TimeBack Activity Metrics Collection
- */
-interface TimebackActivityExtensions {
-    /** Percentage complete (0-100) for the app course */
-    pctCompleteApp?: number;
-    /** Allow other arbitrary extensions */
-    [key: string]: unknown;
-}
-/**
- * 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;
-    /** Optional arbitrary extensions to include in the Caliper event */
-    extensions?: TimebackActivityExtensions;
-}
-
-/**
- * TimeBack API Request/Response Types
- *
- * Types for TimeBack API endpoints including XP tracking,
- * setup, verification, and activity completion.
- *
- * @module types/timeback/api
- */
-
-type TimebackPromotionStatus = 'promoted' | 'no-next-course' | 'already-promoted' | 'not-enrolled' | 'not-mastered';
-interface TimebackPromotionResult {
-    status: TimebackPromotionStatus;
-    currentCourseId: string;
-    nextCourseId?: string;
-    masteredUnits?: number;
-    masterableUnits?: number;
-}
-interface EndActivityResponse {
-    status: 'ok';
-    courseId: string;
-    xpAwarded: number;
-    masteredUnits?: number;
-    pctCompleteApp?: number;
-    scoreStatus?: string;
-    inProgress?: string;
-}
-interface AdvanceCourseResponse {
-    status: 'ok';
-    promotion: TimebackPromotionResult;
-}
-
 /**
  * Cache configuration types for runtime customization
  */
@@ -632,282 +187,6 @@ interface TTLCacheConfig {
     skipCache?: boolean;
 }
 
-declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "items";
-    schema: undefined;
-    columns: {
-        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;
-        }, {}, {}>;
-    };
-    dialect: 'pg';
-}>;
-declare const inventoryItems: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "inventory_items";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "inventory_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;
-        }, {}, {}>;
-        userId: drizzle_orm_pg_core.PgColumn<{
-            name: "user_id";
-            tableName: "inventory_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;
-        }, {}, {}>;
-        itemId: drizzle_orm_pg_core.PgColumn<{
-            name: "item_id";
-            tableName: "inventory_items";
-            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;
-        }, {}, {}>;
-        quantity: drizzle_orm_pg_core.PgColumn<{
-            name: "quantity";
-            tableName: "inventory_items";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        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';
-}>;
-
-type ItemRow = typeof items.$inferSelect;
-type InventoryItemRow = typeof inventoryItems.$inferSelect;
-type InventoryItemWithItem = InventoryItemRow & {
-    item: ItemRow;
-};
-
 /**
  * @fileoverview Authentication Strategy Pattern
  *
@@ -929,7 +208,7 @@ interface AuthStrategy {
 
 /**
  * Base Playcademy SDK client with shared infrastructure.
- * Provides authentication, HTTP requests, events, connection monitoring,
+ * Provides authentication, HTTP requests, events,
  * and fundamental namespaces used by all clients.
  *
  * Extended by PlaycademyClient (game SDK) and PlaycademyInternalClient (platform SDK).
@@ -942,24 +221,11 @@ declare abstract class PlaycademyBaseClient {
     protected gameId?: string;
     protected config: Partial<ClientConfig>;
     protected listeners: EventListeners;
-    protected internalClientSessionId?: string;
     protected authContext?: {
         isInIframe: boolean;
     };
     protected initPayload?: InitPayload;
-    protected connectionManager?: ConnectionManager;
     protected launchId?: string;
-    /**
-     * Internal session manager for automatic session lifecycle.
-     * @private
-     * @internal
-     */
-    protected _sessionManager: {
-        startSession: (gameId: string) => Promise<{
-            sessionId: string;
-        }>;
-        endSession: (sessionId: string, gameId: string) => Promise<void>;
-    };
     constructor(config?: Partial<ClientConfig>);
     /**
      * Gets the effective base URL for API requests.
@@ -994,18 +260,6 @@ declare abstract class PlaycademyBaseClient {
      * Registers a callback to be called when authentication state changes.
      */
     onAuthChange(callback: (token: string | null) => void): void;
-    /**
-     * Registers a callback to be called when connection issues are detected.
-     */
-    onDisconnect(callback: (context: DisconnectContext) => void | Promise<void>): () => void;
-    /**
-     * Gets the current connection state.
-     */
-    getConnectionState(): ConnectionState | 'unknown';
-    /**
-     * Manually triggers a connection check immediately.
-     */
-    checkConnection(): Promise<ConnectionState | 'unknown'>;
     /**
      * Sets the authentication context for the client.
      * @internal
@@ -1057,25 +311,11 @@ declare abstract class PlaycademyBaseClient {
      */
     private _detectAuthContext;
     /**
-     * Initializes connection monitoring if enabled.
-     */
-    private _initializeConnectionMonitor;
-    private _initializeInternalSession;
-    /**
-     * Current user data and inventory management.
+     * Current user data.
      * - `me()` - Get authenticated user profile
-     * - `inventory.get()` - List user's items
-     * - `inventory.add(slug, qty)` - Award items to user
      */
     users: {
-        me: () => Promise<AuthenticatedUser>;
-        inventory: {
-            get: () => Promise<InventoryItemWithItem[]>;
-            add: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
-            remove: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
-            quantity: (identifier: string) => Promise<number>;
-            has: (identifier: string, minQuantity?: number) => Promise<boolean>;
-        };
+        me: () => Promise<_playcademy_types.AuthenticatedUser>;
     };
 }
 
@@ -1106,8 +346,6 @@ declare abstract class PlaycademyBaseClient {
 declare function init<T extends PlaycademyBaseClient = PlaycademyBaseClient>(this: new (config?: Partial<ClientConfig>) => T, options?: {
     baseUrl?: string;
     allowedParentOrigins?: string[];
-    onDisconnect?: DisconnectHandler;
-    enableConnectionMonitoring?: boolean;
 }): Promise<T>;
 
 /**
@@ -1225,14 +463,6 @@ declare enum MessageEvents {
      * Payload: boolean (true = show overlay, false = hide overlay)
      */
     OVERLAY = "PLAYCADEMY_OVERLAY",
-    /**
-     * Broadcasts connection state changes to games.
-     * Sent by platform when network connectivity changes.
-     * Payload:
-     * - `state`: 'online' | 'offline' | 'degraded'
-     * - `reason`: string
-     */
-    CONNECTION_STATE = "PLAYCADEMY_CONNECTION_STATE",
     /**
      * Game has finished loading and is ready to receive messages.
      * Sent once after game initialization is complete.
@@ -1270,14 +500,6 @@ declare enum MessageEvents {
      * - `type`: 'keydown' | 'keyup'
      */
     KEY_EVENT = "PLAYCADEMY_KEY_EVENT",
-    /**
-     * Game requests platform to display an alert.
-     * Sent when connection issues are detected or other important events occur.
-     * Payload:
-     * - `message`: string
-     * - `options`: `{ type?: 'info' | 'warning' | 'error', duration?: number }`
-     */
-    DISPLAY_ALERT = "PLAYCADEMY_DISPLAY_ALERT",
     /**
      * Game signals that demo mode has ended.
      * Sent when a demo experience reaches its CTA/upgrade boundary.
@@ -1342,8 +564,6 @@ interface MessageEventMap {
     [MessageEvents.FORCE_EXIT]: void;
     /** Overlay visibility state (true = show, false = hide) */
     [MessageEvents.OVERLAY]: boolean;
-    /** Connection state change from platform */
-    [MessageEvents.CONNECTION_STATE]: ConnectionStatePayload;
     /** Ready message has no payload data */
     [MessageEvents.READY]: void;
     /** SDK init error data */
@@ -1354,8 +574,6 @@ interface MessageEventMap {
     [MessageEvents.TELEMETRY]: TelemetryPayload;
     /** Key event data */
     [MessageEvents.KEY_EVENT]: KeyEventPayload;
-    /** Display alert request from game */
-    [MessageEvents.DISPLAY_ALERT]: DisplayAlertPayload;
     /** Demo end signal from game */
     [MessageEvents.DEMO_END]: DemoEndPayload;
     /** Authentication state change notification */
@@ -1755,7 +973,7 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
         getGameToken: (gameId: string, options?: {
             apply?: boolean;
         }) => Promise<GameTokenResponse>;
-        exit: () => Promise<void>;
+        exit: () => void;
         onInit: (handler: (context: GameContextPayload) => void) => void;
         onTokenRefresh: (handler: (data: {
             token: string;
@@ -1806,23 +1024,13 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
     timeback: {
         readonly user: TimebackUser;
         readonly currentRunId: string | undefined;
-        startActivity: (metadata: ActivityData, options?: StartActivityOptions) => StartActivityResult;
+        startActivity: (metadata: _playcademy_types.ActivityData, options?: StartActivityOptions) => StartActivityResult;
         pauseActivity: () => void;
         resumeActivity: () => void;
-        endActivity: (data: EndActivityScoreData) => Promise<EndActivityResponse>;
+        endActivity: (data: _playcademy_types.EndActivityScoreData) => Promise<_playcademy_types.EndActivityResponse>;
         advanceCourse: (options?: {
-            subject?: TimebackSubject;
-        }) => Promise<AdvanceCourseResponse>;
-    };
-    /**
-     * Playcademy Credits (platform currency) management.
-     * - `get()` - Get user's credit balance
-     * - `add(amount)` - Award credits to user
-     */
-    credits: {
-        balance: () => Promise<number>;
-        add: (amount: number) => Promise<number>;
-        spend: (amount: number) => Promise<number>;
+            subject?: _playcademy_types.TimebackSubject;
+        }) => Promise<_playcademy_types.AdvanceCourseResponse>;
     };
     /**
      * Game score submission and leaderboards.
@@ -1836,7 +1044,7 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      * - `fetch(options?)` - Fetch leaderboard entries
      */
     leaderboard: {
-        fetch: (options?: LeaderboardOptions) => Promise<GameLeaderboardEntry[]>;
+        fetch: (options?: _playcademy_types.LeaderboardOptions) => Promise<_playcademy_types.GameLeaderboardEntry[]>;
     };
     /**
      * Demo-mode helpers. Methods throw when called outside `client.mode === 'demo'`,
@@ -1847,20 +1055,11 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      */
     demo: {
         profile: {
-            get: () => Promise<DemoProfile>;
-            update: (updates: DemoProfileUpdate) => Promise<DemoProfile>;
+            get: () => Promise<_playcademy_types.DemoProfile>;
+            update: (updates: _playcademy_types.DemoProfileUpdate) => Promise<_playcademy_types.DemoProfile>;
         };
         end: (score: number, options?: DemoEndOptions) => void;
     };
-    /**
-     * Realtime multiplayer authentication.
-     * - `getToken()` - Get token for WebSocket/realtime connections
-     */
-    realtime: {
-        token: {
-            get: () => Promise<RealtimeTokenResponse>;
-        };
-    };
     /**
      * Make requests to your game's custom backend API routes.
      * - `get(path)`, `post(path, body)`, `put()`, `delete()` - HTTP methods
@@ -2113,32 +1312,8 @@ interface ClientConfig {
     tokenType?: TokenType;
     gameId?: string;
     launchId?: string;
-    autoStartSession?: boolean;
-    onDisconnect?: DisconnectHandler;
-    enableConnectionMonitoring?: boolean;
     mode?: PlaycademyMode;
 }
-/**
- * Handler called when connection state changes to offline or degraded.
- * Games can implement this to handle disconnects gracefully.
- */
-type DisconnectHandler = (context: DisconnectContext) => void | Promise<void>;
-/**
- * Context provided to disconnect handlers
- */
-interface DisconnectContext {
-    /** Current connection state */
-    state: 'offline' | 'degraded';
-    /** Reason for the disconnect */
-    reason: string;
-    /** Timestamp when disconnect was detected */
-    timestamp: number;
-    /** Utility to display a platform-level alert */
-    displayAlert: (message: string, options?: {
-        type?: 'info' | 'warning' | 'error';
-        duration?: number;
-    }) => void;
-}
 interface InitPayload {
     /** Hub API base URL */
     baseUrl: string;
@@ -2148,8 +1323,6 @@ interface InitPayload {
     token: string;
     /** Game ID */
     gameId: string;
-    /** Realtime WebSocket URL */
-    realtimeUrl?: string;
     /** Timeback context (if user has a Timeback account) */
     timeback?: TimebackInitContext;
     /** Runtime mode for the game client */
@@ -2158,7 +1331,6 @@ interface InitPayload {
 interface GameContextPayload {
     token: string;
     baseUrl: string;
-    realtimeUrl: string;
     gameId: string;
     forwardKeys?: string[];
     mode?: PlaycademyMode;
@@ -2170,38 +1342,12 @@ interface ClientEvents {
     authChange: {
         token: string | null;
     };
-    inventoryChange: {
-        itemId: string;
-        delta: number;
-        newTotal: number;
-    };
-    levelUp: {
-        oldLevel: number;
-        newLevel: number;
-        creditsAwarded: number;
-    };
-    xpGained: {
-        amount: number;
-        totalXP: number;
-        leveledUp: boolean;
-    };
-    connectionChange: {
-        state: 'online' | 'offline' | 'degraded';
-        reason: string;
-    };
 }
 
 /**
  * Event and message payload types for SDK messaging system
  */
 
-interface DisplayAlertPayload {
-    message: string;
-    options?: {
-        type?: 'info' | 'warning' | 'error';
-        duration?: number;
-    };
-}
 /**
  * Authentication state change event payload.
  * Used when authentication state changes in the application.
@@ -2258,14 +1404,6 @@ interface KeyEventPayload {
     /** Event type */
     type: 'keydown' | 'keyup';
 }
-/**
- * Connection state payload.
- * Broadcast from platform to games when connection changes.
- */
-interface ConnectionStatePayload {
-    state: 'online' | 'offline' | 'degraded';
-    reason: string;
-}
 /**
  * Init error payload.
  * Sent from game iframe to parent when SDK initialization fails
@@ -2306,19 +1444,6 @@ interface GameTokenResponse {
     exp: number;
     baseUrl?: string;
 }
-interface InventoryMutationResponse {
-    newTotal: number;
-}
-
-/**
- * Realtime namespace types
- */
-/**
- * Response type for the realtime token API
- */
-interface RealtimeTokenResponse {
-    token: string;
-}
 
 /**
  * Scores namespace types
@@ -2400,179 +1525,5 @@ interface DevUploadHooks {
     onClose?: () => void;
 }
 
-/**
- * Connection Manager
- *
- * Manages connection monitoring and integrates it with the Playcademy client.
- * Handles event wiring, state management, and disconnect callbacks.
- *
- * In iframe mode, disables local monitoring and listens to platform connection
- * state broadcasts instead (avoids duplicate heartbeats).
- */
-
-/**
- * Configuration for the ConnectionManager.
- */
-interface ConnectionManagerConfig {
-    /** Base URL for API requests (used for heartbeat pings) */
-    baseUrl: string;
-    /** Authentication context (iframe vs standalone) for alert routing */
-    authContext?: {
-        isInIframe: boolean;
-    };
-    /** Handler to call when connection issues are detected */
-    onDisconnect?: DisconnectHandler;
-    /** Callback to emit connection change events to the client */
-    onConnectionChange?: (state: ConnectionState, reason: string) => void;
-}
-/**
- * Manages connection monitoring for the Playcademy client.
- *
- * The ConnectionManager serves as an integration layer between the low-level
- * ConnectionMonitor and the PlaycademyClient. It handles:
- * - Event wiring and coordination
- * - Disconnect callbacks with context
- * - Platform-level alert integration
- * - Request success/failure tracking
- *
- * This class is used internally by PlaycademyClient and typically not
- * instantiated directly by game developers.
- *
- * @see {@link ConnectionMonitor} for the underlying monitoring implementation
- * @see {@link PlaycademyClient.onDisconnect} for the public API
- */
-declare class ConnectionManager {
-    private monitor?;
-    private authContext?;
-    private disconnectHandler?;
-    private connectionChangeCallback?;
-    private currentState;
-    private additionalDisconnectHandlers;
-    /**
-     * Creates a new ConnectionManager instance.
-     *
-     * @param config - Configuration options for the manager
-     *
-     * @example
-     * ```typescript
-     * const manager = new ConnectionManager({
-     *   baseUrl: 'https://api.playcademy.com',
-     *   authContext: { isInIframe: false },
-     *   onDisconnect: (context) => {
-     *     console.log(`Disconnected: ${context.state}`)
-     *   },
-     *   onConnectionChange: (state, reason) => {
-     *     console.log(`Connection changed: ${state}`)
-     *   }
-     * })
-     * ```
-     */
-    constructor(config: ConnectionManagerConfig);
-    /**
-     * Gets the current connection state.
-     *
-     * @returns The current connection state ('online', 'offline', or 'degraded')
-     *
-     * @example
-     * ```typescript
-     * const state = manager.getState()
-     * if (state === 'offline') {
-     *   console.log('No connection')
-     * }
-     * ```
-     */
-    getState(): ConnectionState;
-    /**
-     * Manually triggers a connection check immediately.
-     *
-     * Forces a heartbeat ping to verify the current connection status.
-     * Useful when you need to check connectivity before a critical operation.
-     *
-     * In iframe mode, this returns the last known state from platform.
-     *
-     * @returns Promise resolving to the current connection state
-     *
-     * @example
-     * ```typescript
-     * const state = await manager.checkNow()
-     * if (state === 'online') {
-     *   await performCriticalOperation()
-     * }
-     * ```
-     */
-    checkNow(): Promise<ConnectionState>;
-    /**
-     * Reports a successful API request to the connection monitor.
-     *
-     * This resets the consecutive failure counter and transitions from
-     * 'degraded' to 'online' state if applicable.
-     *
-     * Typically called automatically by the SDK's request wrapper.
-     * No-op in iframe mode (platform handles monitoring).
-     */
-    reportRequestSuccess(): void;
-    /**
-     * Reports a failed API request to the connection monitor.
-     *
-     * Only network errors are tracked (not 4xx/5xx HTTP responses).
-     * After consecutive failures exceed the threshold, the state transitions
-     * to 'degraded' or 'offline'.
-     *
-     * Typically called automatically by the SDK's request wrapper.
-     * No-op in iframe mode (platform handles monitoring).
-     *
-     * @param error - The error from the failed request
-     */
-    reportRequestFailure(error: unknown): void;
-    /**
-     * Registers a callback to be called when connection issues are detected.
-     *
-     * The callback only fires for 'offline' and 'degraded' states, not when
-     * recovering to 'online'. This provides a clean API for games to handle
-     * disconnect scenarios without being notified of every state change.
-     *
-     * Works in both iframe and standalone modes transparently.
-     *
-     * @param callback - Function to call when connection degrades
-     * @returns Cleanup function to unregister the callback
-     *
-     * @example
-     * ```typescript
-     * const cleanup = manager.onDisconnect(({ state, reason, displayAlert }) => {
-     *   if (state === 'offline') {
-     *     displayAlert?.('Connection lost. Saving your progress...', { type: 'error' })
-     *     saveGameState()
-     *   }
-     * })
-     *
-     * // Later: cleanup() to unregister
-     * ```
-     */
-    onDisconnect(callback: DisconnectHandler): () => void;
-    /**
-     * Stops connection monitoring and performs cleanup.
-     *
-     * Removes event listeners and clears heartbeat intervals.
-     * Should be called when the client is being destroyed.
-     */
-    stop(): void;
-    /**
-     * Sets up listener for platform connection state broadcasts (iframe mode only).
-     */
-    private _setupPlatformListener;
-    /**
-     * Handles connection state changes from the monitor or platform.
-     *
-     * Coordinates between:
-     * 1. Emitting events to the client (for client.on('connectionChange'))
-     * 2. Calling the disconnect handler if configured
-     * 3. Calling any additional handlers registered via onDisconnect()
-     *
-     * @param state - The new connection state
-     * @param reason - Human-readable reason for the state change
-     */
-    private _handleConnectionChange;
-}
-
-export { ApiError, ConnectionManager, ConnectionMonitor, MessageEvents, PlaycademyClient, PlaycademyError, extractApiErrorInfo, messaging };
-export type { ApiErrorCode, ApiErrorInfo, ConnectionMonitorConfig, ConnectionState, ConnectionStatePayload, DevUploadEvent, DevUploadHooks, DisconnectContext, DisconnectHandler, DisplayAlertPayload, ErrorResponseBody, PlaycademyMode };
+export { ApiError, MessageEvents, PlaycademyClient, PlaycademyError, extractApiErrorInfo, messaging };
+export type { ApiErrorCode, ApiErrorInfo, DevUploadEvent, DevUploadHooks, ErrorResponseBody, PlaycademyMode };