@phalanx-engine/client 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,501 @@
+/**
+ * Phalanx Client Types
+ * Types for the client-side library
+ */
+import type { DesyncEvent } from './DesyncDetector.js';
+import type { RoomRecoveryStatusEvent, RoomTerminatedEvent } from './recovery/RoomRecoveryController.js';
+import type { KeyValueStorage } from './recovery/KeyValueStorage.js';
+import type { RecoverTimeoutBudget } from './recovery/NetworkQuality.js';
+export type { DesyncEvent };
+export type { RoomRecoveryStatusEvent, RoomTerminatedEvent } from './recovery/RoomRecoveryController.js';
+/**
+ * Configuration for pause/resume behavior
+ */
+export interface PauseConfig {
+    /**
+     * Maximum number of pauses allowed per player.
+     * Set to Infinity for unlimited pauses.
+     * @default Infinity
+     */
+    maxPausesPerPlayer: number;
+    /**
+     * Whether the game can only be resumed by the same player who paused it.
+     * If false, any player can resume the game.
+     * @default false
+     */
+    requireSamePlayerToResume: boolean;
+}
+/** Socket.IO transport names supported by PhalanxClient. */
+export type SocketTransport = 'polling' | 'websocket';
+/**
+ * Configuration for the Phalanx client
+ */
+export interface PhalanxClientConfig {
+    /**
+     * URL of the Phalanx server (e.g., 'http://localhost:3000')
+     */
+    serverUrl: string;
+    /**
+     * Unique identifier for this player.
+     * If auth is enabled and user signs in, this will be overwritten with the auth user ID.
+     */
+    playerId?: string;
+    /**
+     * Display name for this player.
+     * If auth is enabled and user signs in, this will be overwritten with the auth username.
+     */
+    username?: string;
+    /**
+     * Authentication token (e.g., Google ID token).
+     * Required if server has authentication enabled.
+     * If using built-in auth, this is managed automatically.
+     */
+    authToken?: string;
+    /**
+     * Authentication configuration.
+     * If provided, the client will manage authentication internally.
+     */
+    auth?: PhalanxAuthConfig;
+    /**
+     * Whether to automatically attempt reconnection after disconnection
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Maximum number of reconnection attempts
+     * @default 5
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * Delay between reconnection attempts in milliseconds
+     * @default 1000
+     */
+    reconnectDelayMs?: number;
+    /**
+     * Connection timeout in milliseconds
+     * @default 10000
+     */
+    connectionTimeoutMs?: number;
+    /**
+     * Timeout for private-room recovery acknowledgements in milliseconds.
+     * @default 10000
+     */
+    recoverRoomTimeoutMs?: number;
+    /**
+     * Socket.IO transports to use when connecting.
+     * Defaults to WebSocket-only for existing desktop behavior. Mobile
+     * clients can pass ['polling', 'websocket'] for a more resilient fallback.
+     * @default ['websocket']
+     */
+    socketTransports?: readonly SocketTransport[];
+    /**
+     * If true, automatically pick `['polling']` on mobile UAs and
+     * `['websocket']` on desktop. Ignored when `socketTransports` is
+     * also set explicitly. Opt-in to avoid silently regressing games
+     * that intentionally pin a specific transport.
+     * @default false
+     */
+    mobileFriendlyTransports?: boolean;
+    /**
+     * Persist a stable guest playerId across page reloads so private-room
+     * recovery can survive a hard reload. When `true`, uses the default
+     * key `phalanx:guestPlayerId:v1`. When a string, uses that as the key.
+     * Authenticated users override this with the auth user id, so this is
+     * primarily a guest-mode quality-of-life flag.
+     * @default false
+     */
+    persistGuestPlayerId?: boolean | string;
+    /**
+     * Configure mobile-friendly room recovery (visibilitychange/pageshow
+     * listeners, exponential backoff, room persistence, pre-game stall
+     * watchdog). When omitted recovery is disabled and the controller is
+     * not constructed.
+     */
+    roomRecovery?: PhalanxRoomRecoveryConfig;
+    /**
+     * Tick rate (ticks per second) - should match server configuration
+     * @default 20
+     */
+    tickRate?: number;
+    /**
+     * Pause/resume behavior configuration.
+     * Should match server configuration for proper validation.
+     */
+    pause?: Partial<PauseConfig>;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Configuration for the optional mobile-friendly room recovery layer.
+ * See `RoomRecoveryController` for behavior. Leave unset to disable.
+ */
+export interface PhalanxRoomRecoveryConfig {
+    /** Master enable flag. When false the controller is not created. */
+    enabled: boolean;
+    /**
+     * localStorage key for the persisted active-room record.
+     * @default 'phalanx:activeRoom:v1'
+     */
+    storageKey?: string;
+    /**
+     * Local TTL mirroring the server's RoomService.ROOM_TTL_MS.
+     * @default 5 * 60 * 1000
+     */
+    roomTtlMs?: number;
+    /**
+     * Storage adapter. Defaults to `localStorage` (with a memory fallback
+     * when the DOM is unavailable). React Native / Capacitor host apps can
+     * supply a custom synchronous wrapper around their native storage.
+     */
+    storage?: KeyValueStorage;
+    /** Per-quality recover-room ack timeout budget. */
+    recoverTimeoutBudget?: RecoverTimeoutBudget;
+    /** Max backoff retries before emitting `gave-up`. @default 5 */
+    maxRecoverAttempts?: number;
+    /** Auto-arm the pre-game stall watchdog. @default true */
+    preGameStallWatchdog?: boolean;
+    /** Pre-game stall budget in ms. @default 4500 */
+    preGameStallMs?: number;
+}
+/**
+ * Authentication configuration for PhalanxClient
+ */
+export interface PhalanxAuthConfig {
+    /**
+     * OAuth provider to use
+     */
+    provider: 'google';
+    /**
+     * Google OAuth configuration
+     */
+    google?: {
+        /**
+         * Google OAuth Client ID
+         */
+        clientId: string;
+        /**
+         * OAuth scopes (default: ['openid', 'profile', 'email'])
+         */
+        scopes?: string[];
+        /**
+         * Redirect URI after auth (default: window.location.origin)
+         */
+        redirectUri?: string;
+        /**
+         * Backend endpoint URL for token exchange.
+         * Required for secure token exchange with client_secret on server.
+         */
+        tokenExchangeUrl?: string;
+    };
+}
+/**
+ * A command sent from or to players
+ * When received from server, includes playerId and tick added by server
+ */
+export interface PlayerCommand {
+    type: string;
+    data: unknown;
+    /** Added by server when broadcasting - identifies the player who sent the command */
+    playerId?: string;
+    /** Added by server when broadcasting - the tick this command was submitted for */
+    tick?: number;
+}
+/**
+ * Information about a player in match-found event
+ */
+export interface MatchPlayerInfo {
+    playerId: string;
+    username: string;
+}
+/**
+ * Event received when a match is found
+ */
+export interface MatchFoundEvent {
+    matchId: string;
+    playerId: string;
+    teamId: number;
+    teammates: MatchPlayerInfo[];
+    opponents: MatchPlayerInfo[];
+}
+/**
+ * Event received during countdown before game starts
+ */
+export interface CountdownEvent {
+    seconds: number;
+}
+/**
+ * Event received when the game starts
+ */
+export interface GameStartEvent {
+    matchId: string;
+    /** Random seed for deterministic RNG (optional for backward compatibility) */
+    randomSeed?: number;
+}
+/**
+ * Event received on each tick for synchronization
+ */
+export interface TickSyncEvent {
+    tick: number;
+    timestamp: number;
+}
+/**
+ * Commands batch received each tick from the server
+ */
+export interface CommandsBatchEvent {
+    tick: number;
+    commands: PlayerCommand[];
+}
+/**
+ * Queue status event received after joining queue
+ */
+export interface QueueStatusEvent {
+    position: number;
+    waitTime: number;
+}
+/**
+ * Event received when another player disconnects
+ */
+export interface PlayerDisconnectedEvent {
+    playerId: string;
+    gracePeriodMs: number;
+}
+/**
+ * Event received when another player reconnects
+ */
+export interface PlayerReconnectedEvent {
+    playerId: string;
+}
+/**
+ * Event received when a player reports ready during the loading phase
+ */
+export interface PlayerReadyEvent {
+    playerId: string;
+}
+/**
+ * State received when reconnecting to a match.
+ *
+ * Includes a snapshot of the countdown / game-start phase so a client
+ * that reconnected mid-countdown (e.g. a private-room host whose mobile
+ * browser killed the WebSocket while they were sharing the invite link)
+ * can render the correct remaining number without waiting for the next
+ * 1Hz broadcast tick, and so a client that reconnected after `game-start`
+ * already fired can synthesize the event locally and enter the playing
+ * phase without waiting for an event it will never receive again.
+ *
+ * The countdown/gameStart fields are optional for wire-compatibility
+ * with older servers that don't populate them.
+ */
+export interface ReconnectStateEvent {
+    matchId: string;
+    currentTick: number;
+    state: 'countdown' | 'waiting-for-ready' | 'playing' | 'paused' | 'finished';
+    recentCommands: TickCommandsHistory[];
+    /**
+     * Integer number of seconds left on the countdown at the moment this
+     * snapshot was taken, or `null` if the countdown is no longer running
+     * (either it never started with a positive duration, or `game-start`
+     * has already been emitted).
+     */
+    countdownSecondsRemaining?: number | null;
+    /**
+     * True if `game-start` has already been broadcast for this match.
+     * Clients should treat this as a signal to synthesize a local
+     * `game-start` event rather than waiting for the server to emit one.
+     */
+    gameStartEmitted?: boolean;
+    /**
+     * The match's deterministic RNG seed. Forwarded here so clients that
+     * missed the original `game-start` broadcast can still feed the seed
+     * into their deterministic simulation on the synthesized start.
+     */
+    randomSeed?: number;
+}
+/**
+ * Commands history for a specific tick (used in reconnection)
+ */
+export interface TickCommandsHistory {
+    tick: number;
+    commands: PlayerCommand[];
+}
+/**
+ * Reconnection status response
+ */
+export interface ReconnectStatusEvent {
+    success: boolean;
+    reason?: string;
+}
+/**
+ * Acknowledgment for submitted commands
+ */
+export interface SubmitCommandsAck {
+    accepted: boolean;
+    reason?: string;
+}
+/**
+ * Event received when match ends
+ */
+export interface MatchEndEvent {
+    reason: string;
+    /** Additional details about the match end (e.g., desync info) */
+    details?: unknown;
+    /** Winner information (null on desync) */
+    winner?: string | null;
+}
+/**
+ * Event received when the game is paused
+ */
+export interface GamePausedEvent {
+    requestedBy: string;
+    lastTick: number;
+}
+/**
+ * Event received when the game is resumed
+ */
+export interface GameResumedEvent {
+    requestedBy: string;
+}
+/**
+ * Hash comparison data received from server
+ */
+export interface HashComparisonEvent {
+    tick: number;
+    hashes: Record<string, string>;
+}
+/**
+ * Error event from the server
+ */
+export interface PhalanxError {
+    message: string;
+    code?: string;
+}
+/**
+ * Connection state of the client
+ */
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/**
+ * Client state (overall lifecycle)
+ */
+export type ClientState = 'idle' | 'in-queue' | 'match-found' | 'countdown' | 'playing' | 'paused' | 'reconnecting' | 'finished';
+/**
+ * Commands grouped by player ID (for easier processing in game logic)
+ */
+export interface CommandsBatch {
+    tick: number;
+    commands: {
+        [playerId: string]: PlayerCommand[];
+    };
+}
+/**
+ * Tick handler callback type
+ */
+export type TickHandler = (tick: number, commands: CommandsBatch) => void;
+/**
+ * Frame handler callback type
+ */
+export type FrameHandler = (alpha: number, dt: number) => void;
+/**
+ * Unsubscribe function type
+ */
+export type Unsubscribe = () => void;
+/**
+ * Pause/Resume handler callback type
+ */
+export type PauseHandler = () => void;
+/**
+ * Auth user information
+ */
+export interface PhalanxAuthUser {
+    id: string;
+    username?: string;
+    email?: string;
+    avatarUrl?: string;
+    provider: string;
+}
+/**
+ * Auth state
+ */
+export interface PhalanxAuthState {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user: PhalanxAuthUser | null;
+    error?: string;
+}
+/**
+ * Events emitted by PhalanxClient
+ */
+export interface PhalanxClientEvents {
+    connected: () => void;
+    disconnected: () => void;
+    reconnecting: (attempt: number) => void;
+    reconnectFailed: () => void;
+    error: (error: PhalanxError) => void;
+    authStateChanged: (state: PhalanxAuthState) => void;
+    authError: (error: PhalanxError) => void;
+    queueJoined: (status: QueueStatusEvent) => void;
+    queueLeft: () => void;
+    queueError: (error: PhalanxError) => void;
+    matchFound: (event: MatchFoundEvent) => void;
+    countdown: (event: CountdownEvent) => void;
+    gameStart: (event: GameStartEvent) => void;
+    matchEnd: (event: MatchEndEvent) => void;
+    gamePaused: (event: GamePausedEvent) => void;
+    gameResumed: (event: GameResumedEvent) => void;
+    tick: (event: TickSyncEvent) => void;
+    commands: (event: CommandsBatchEvent) => void;
+    playerDisconnected: (event: PlayerDisconnectedEvent) => void;
+    playerReconnected: (event: PlayerReconnectedEvent) => void;
+    playerReady: (event: PlayerReadyEvent) => void;
+    reconnectState: (event: ReconnectStateEvent) => void;
+    reconnectStatus: (event: ReconnectStatusEvent) => void;
+    desync: (event: DesyncEvent) => void;
+    roomCreated: (event: RoomCreatedEvent) => void;
+    roomError: (event: RoomErrorEvent) => void;
+    roomExpired: (event: RoomExpiredEvent) => void;
+    roomCancelled: (event: RoomCancelledEvent) => void;
+    roomRecovered: (event: RoomRecoveredEvent) => void;
+    recoveryStatus: (event: RoomRecoveryStatusEvent) => void;
+    roomTerminated: (event: RoomTerminatedEvent) => void;
+}
+/**
+ * Event emitted when a private room is created.
+ */
+export interface RoomCreatedEvent {
+    code: string;
+}
+/**
+ * Event emitted when a room operation fails.
+ */
+export interface RoomErrorEvent {
+    message: string;
+}
+/**
+ * Event emitted when a room expires (TTL exceeded).
+ */
+export interface RoomExpiredEvent {
+    code: string;
+}
+/**
+ * Event emitted when a room is cancelled.
+ */
+export interface RoomCancelledEvent {
+    code: string;
+}
+/**
+ * Event emitted when a host successfully reclaims a private room after a
+ * transient socket disconnect (e.g. mobile browser killing the WebSocket
+ * when the user switches to a messenger to share the invite link).
+ *
+ * The returned `code` is the canonical server-side value — callers should
+ * prefer it over whatever they passed into `recoverRoom`. In practice
+ * this differs from the caller's input only in casing: the server
+ * uppercases the provided code and rejects anything else with
+ * `room-error: "Room expired"`. Echoing the stored code lets callers
+ * update any cached value that drifted in case only.
+ */
+export interface RoomRecoveredEvent {
+    code: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Phalanx Client Types
+ * Types for the client-side library
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@phalanx-engine/client",
+  "version": "0.1.0",
+  "description": "Client library for Phalanx Engine - a game-agnostic deterministic lockstep multiplayer engine",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js"
+    }
+  },
+  "keywords": [
+    "multiplayer",
+    "game-client",
+    "lockstep",
+    "deterministic",
+    "netcode",
+    "socket.io-client",
+    "phalanx",
+    "game-engine"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phaeton-forge/phalanx-engine.git",
+    "directory": "phalanx-client"
+  },
+  "bugs": "https://github.com/phaeton-forge/phalanx-engine/issues",
+  "homepage": "https://github.com/phaeton-forge/phalanx-engine/tree/main/phalanx-client#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.0.0 <25.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "pure-rand": "^7.0.1",
+    "socket.io-client": "^4.7.0",
+    "@phalanx-engine/math": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0",
+    "@phalanx-engine/server": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}