@phalanx-engine/client 0.1.0

package/dist/recovery/RoomRecoveryController.js

@@ -0,0 +1,348 @@
+import { armBrowserLifecycle, isOnline, waitForOnlineEvent, } from './BrowserLifecycle.js';
+import { DEFAULT_RECOVER_TIMEOUT_BUDGET, getRecoverTimeoutMs, } from './NetworkQuality.js';
+import { RoomPersistence } from './RoomPersistence.js';
+const NETWORK_STABILIZE_DELAY_MS = 300;
+const CONNECTED_RECOVER_DELAY_MS = 300;
+const DISCONNECTED_RECOVER_DELAY_MS = 300;
+const OFFLINE_WAIT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_RECOVER_ATTEMPTS = 5;
+const DEFAULT_PRE_GAME_STALL_MS = 4_500;
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Owns the entire mobile-friendly recovery state machine for a single
+ * private room: visibility/pageshow/online listeners, socket connect/
+ * disconnect hooks, exponential-backoff retry, and the localStorage
+ * persistence record. Emits typed status events instead of touching
+ * UI directly so each game can render its own strings.
+ *
+ * Lifecycle:
+ *   client.roomRecovery.startTrackingHost(code)  // host created room
+ *   client.roomRecovery.trackGuestJoin(code)     // guest is mid-join
+ *   client.roomRecovery.resumeTrackingHost(code) // cold-start recover
+ *   client.roomRecovery.stop()                   // cancel / match started
+ *
+ * The pre-game stall watchdog is auto-armed on every matchFound and
+ * disarmed on gameStart, so games no longer need their own
+ * `armPreGameStallWatchdog` helper.
+ */
+export class RoomRecoveryController {
+    client;
+    persistence;
+    recoverBudget;
+    maxRecoverAttempts;
+    preGameStallEnabled;
+    preGameStallMs;
+    emit;
+    activeRoomCode = null;
+    isRecovering = false;
+    pendingRecoverRequested = false;
+    pendingForceReconnectRequested = false;
+    recoverAttempt = 0;
+    recoverRetryTimer = null;
+    recoverScheduleTimer = null;
+    lifecycleHandle = null;
+    clientEventUnsubs = [];
+    preGameStallTimer = null;
+    hasGameStartedSinceTracking = false;
+    constructor(client, config, emit) {
+        this.client = client;
+        this.persistence = new RoomPersistence({
+            storageKey: config.storageKey,
+            roomTtlMs: config.roomTtlMs,
+            storage: config.storage,
+        });
+        this.recoverBudget =
+            config.recoverTimeoutBudget ?? DEFAULT_RECOVER_TIMEOUT_BUDGET;
+        this.maxRecoverAttempts =
+            config.maxRecoverAttempts ?? DEFAULT_MAX_RECOVER_ATTEMPTS;
+        this.preGameStallEnabled = config.preGameStallWatchdog ?? true;
+        this.preGameStallMs = config.preGameStallMs ?? DEFAULT_PRE_GAME_STALL_MS;
+        this.emit = emit;
+    }
+    // ── Public surface ──────────────────────────────────────────────
+    hasActiveRoom() {
+        return this.activeRoomCode !== null;
+    }
+    getActiveRoomCode() {
+        return this.activeRoomCode;
+    }
+    /**
+     * Cold-start recovery: read the persisted host record (mobile killed
+     * the tab while the user was in a messenger) and validate it against
+     * the current playerId. Returns the code to recover, or null when
+     * there's nothing to do (no record, expired, or playerId drift).
+     */
+    loadColdStartCode() {
+        const persisted = this.persistence.load();
+        if (!persisted || persisted.role !== 'host')
+            return null;
+        const currentPlayerId = this.client.getPlayerId();
+        if (currentPlayerId && currentPlayerId === persisted.playerId) {
+            return persisted.code;
+        }
+        // playerId drift — abandon the stale entry rather than leaving
+        // the user staring at a permanently-failing recover attempt.
+        this.persistence.clear();
+        return null;
+    }
+    /** Begin tracking `code` as the active host-side room. */
+    startTrackingHost(code) {
+        this.activeRoomCode = code;
+        this.persistence.save({
+            code,
+            role: 'host',
+            playerId: this.client.getPlayerId(),
+        });
+        this.armHooks();
+    }
+    /**
+     * Variant used by cold-start recover: assumes the persistence record
+     * was already written by a previous tab and just rearms the hooks.
+     */
+    resumeTrackingHost(code) {
+        this.activeRoomCode = code;
+        this.armHooks();
+    }
+    /** Persist a guest-side join attempt for cold-start surfacing. */
+    trackGuestJoin(code) {
+        this.persistence.save({
+            code,
+            role: 'guest',
+            playerId: this.client.getPlayerId(),
+        });
+    }
+    /** Stop all recovery machinery and forget the active room. Idempotent. */
+    stop() {
+        this.disarmHooks();
+        this.clearPreGameStallWatchdog();
+        this.activeRoomCode = null;
+        this.pendingRecoverRequested = false;
+        this.pendingForceReconnectRequested = false;
+        this.recoverAttempt = 0;
+        this.hasGameStartedSinceTracking = false;
+        this.persistence.clear();
+        this.emit('recoveryStatus', { phase: 'idle' });
+    }
+    /**
+     * Recover through a fresh socket even if Socket.IO still reports the
+     * current one as connected. This handles mobile carrier/WebView
+     * stalls where server→client packets stop arriving but heartbeat has
+     * not fired yet, so the normal `disconnected` hook would be too late.
+     */
+    forceRecover(reason) {
+        if (!this.activeRoomCode)
+            return;
+        void reason;
+        this.pendingForceReconnectRequested = true;
+        this.scheduleRecover(NETWORK_STABILIZE_DELAY_MS);
+    }
+    /**
+     * Attempt one recovery cycle. Idempotent against concurrent calls
+     * (the visibility and `connected` hooks may fire near-simultaneously
+     * on mobile). Schedules its own backoff retry on transient failure.
+     */
+    async tryRecover() {
+        const code = this.activeRoomCode;
+        if (!code)
+            return;
+        if (this.isRecovering) {
+            this.pendingRecoverRequested = true;
+            return;
+        }
+        this.isRecovering = true;
+        const forceReconnect = this.pendingForceReconnectRequested;
+        this.pendingRecoverRequested = false;
+        this.pendingForceReconnectRequested = false;
+        if (this.recoverRetryTimer) {
+            clearTimeout(this.recoverRetryTimer);
+            this.recoverRetryTimer = null;
+        }
+        try {
+            this.emit('recoveryStatus', {
+                phase: 'recovering',
+                attempt: this.recoverAttempt + 1,
+            });
+            await this.waitForOnlineAndStabilize();
+            if (this.activeRoomCode !== code)
+                return;
+            // NOTE: we deliberately do NOT short-circuit on isConnected().
+            // socket.io auto-reconnect can produce a fresh connection while
+            // we were backgrounded — that socket has no record of being this
+            // room's host, so we must send `room-recover` on it either way.
+            // The server's recover path is idempotent and rebinds on the
+            // live socket.
+            if (forceReconnect && this.client.isConnected()) {
+                this.client.disconnect();
+                await delay(NETWORK_STABILIZE_DELAY_MS);
+            }
+            if (!this.client.isConnected()) {
+                await this.client.connect();
+            }
+            await this.client.recoverRoom(code, getRecoverTimeoutMs(this.recoverBudget));
+            this.recoverAttempt = 0;
+            this.emit('recoveryStatus', { phase: 'idle' });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`[RoomRecovery] Recover failed: ${message}`);
+            // Only TERMINAL failure: server explicitly says the room is gone.
+            // Anything else (timeouts, dropped sockets) is transient.
+            if (message === 'Room expired' || message === 'Room not found') {
+                const reason = message === 'Room expired' ? 'expired' : 'not-found';
+                this.stop();
+                this.emit('roomTerminated', { reason });
+                return;
+            }
+            this.recoverAttempt += 1;
+            if (this.recoverAttempt >= this.maxRecoverAttempts) {
+                this.recoverAttempt = 0;
+                this.emit('recoveryStatus', { phase: 'gave-up' });
+                // Don't redirect — game's UI should still expose a manual cancel.
+                return;
+            }
+            const retryDelay = Math.min(2_000 * 2 ** (this.recoverAttempt - 1), 30_000);
+            this.emit('recoveryStatus', {
+                phase: 'retrying',
+                attempt: this.recoverAttempt,
+                nextRetryMs: retryDelay,
+            });
+            this.recoverRetryTimer = setTimeout(() => {
+                this.recoverRetryTimer = null;
+                void this.tryRecover();
+            }, retryDelay);
+        }
+        finally {
+            this.isRecovering = false;
+            if (this.pendingRecoverRequested &&
+                this.activeRoomCode &&
+                !this.recoverRetryTimer) {
+                this.scheduleRecover(NETWORK_STABILIZE_DELAY_MS);
+            }
+        }
+    }
+    // ── Pre-game stall watchdog ─────────────────────────────────────
+    /**
+     * Arm a one-shot timer: if `gameStart` doesn't arrive within
+     * `preGameStallMs` we proactively `forceRecover` because the most
+     * likely explanation is that the host's socket silently died mid-
+     * countdown. Auto-armed on `matchFound` / `countdown` events when
+     * `preGameStallWatchdog` is enabled — games rarely need to call this
+     * directly.
+     */
+    armPreGameStallWatchdog(reason) {
+        if (!this.preGameStallEnabled)
+            return;
+        if (this.hasGameStartedSinceTracking)
+            return;
+        this.clearPreGameStallWatchdog();
+        this.preGameStallTimer = setTimeout(() => {
+            this.preGameStallTimer = null;
+            if (this.hasGameStartedSinceTracking)
+                return;
+            if (!this.activeRoomCode)
+                return;
+            this.forceRecover(reason);
+        }, this.preGameStallMs);
+    }
+    clearPreGameStallWatchdog() {
+        if (!this.preGameStallTimer)
+            return;
+        clearTimeout(this.preGameStallTimer);
+        this.preGameStallTimer = null;
+    }
+    // ── Internal arming/disarming ───────────────────────────────────
+    armHooks() {
+        this.armBrowserLifecycle();
+        this.armClientEventHooks();
+    }
+    disarmHooks() {
+        this.lifecycleHandle?.dispose();
+        this.lifecycleHandle = null;
+        for (const unsub of this.clientEventUnsubs)
+            unsub();
+        this.clientEventUnsubs = [];
+        if (this.recoverRetryTimer) {
+            clearTimeout(this.recoverRetryTimer);
+            this.recoverRetryTimer = null;
+        }
+        if (this.recoverScheduleTimer) {
+            clearTimeout(this.recoverScheduleTimer);
+            this.recoverScheduleTimer = null;
+        }
+    }
+    armBrowserLifecycle() {
+        if (this.lifecycleHandle)
+            return;
+        this.lifecycleHandle = armBrowserLifecycle({
+            onVisible: () => this.scheduleRecover(),
+        });
+    }
+    armClientEventHooks() {
+        if (this.clientEventUnsubs.length > 0)
+            return;
+        // Auto-reconnect produced a fresh socket — claim back the room.
+        this.clientEventUnsubs.push(this.client.on('connected', () => {
+            if (!this.activeRoomCode)
+                return;
+            this.scheduleRecover(CONNECTED_RECOVER_DELAY_MS);
+        }));
+        // Mobile networks can drop the transport during the private-room
+        // countdown before PhalanxClient reaches `playing`. The generic
+        // SocketManager reconnect path intentionally only handles in-game
+        // reconnects, so private rooms must proactively recover themselves
+        // as soon as this pre-game disconnect is observed.
+        this.clientEventUnsubs.push(this.client.on('disconnected', () => {
+            if (!this.activeRoomCode)
+                return;
+            this.scheduleRecover(DISCONNECTED_RECOVER_DELAY_MS);
+        }));
+        this.clientEventUnsubs.push(this.client.on('roomExpired', () => {
+            this.stop();
+            this.emit('roomTerminated', { reason: 'expired' });
+        }));
+        this.clientEventUnsubs.push(this.client.on('roomCancelled', () => {
+            this.stop();
+            this.emit('roomTerminated', { reason: 'cancelled' });
+        }));
+        // Pre-game stall watchdog — auto-armed on the events that lead up
+        // to `gameStart`, auto-cleared once the game actually starts.
+        if (this.preGameStallEnabled) {
+            this.clientEventUnsubs.push(this.client.on('matchFound', () => {
+                this.armPreGameStallWatchdog('game-start missing after match-found');
+            }));
+            this.clientEventUnsubs.push(this.client.on('countdown', (event) => {
+                if (event.seconds > 0) {
+                    this.armPreGameStallWatchdog(`countdown stalled after ${event.seconds}`);
+                }
+            }));
+            this.clientEventUnsubs.push(this.client.on('gameStart', () => {
+                this.hasGameStartedSinceTracking = true;
+                this.clearPreGameStallWatchdog();
+            }));
+        }
+    }
+    scheduleRecover(delayMs = 0) {
+        if (!this.activeRoomCode)
+            return;
+        this.pendingRecoverRequested = true;
+        if (this.isRecovering || this.recoverScheduleTimer)
+            return;
+        this.recoverScheduleTimer = setTimeout(() => {
+            this.recoverScheduleTimer = null;
+            if (!this.pendingRecoverRequested)
+                return;
+            void this.tryRecover();
+        }, delayMs);
+    }
+    async waitForOnlineAndStabilize() {
+        if (!isOnline()) {
+            this.emit('recoveryStatus', { phase: 'waiting-network' });
+            await waitForOnlineEvent(OFFLINE_WAIT_TIMEOUT_MS);
+            if (!isOnline()) {
+                throw new Error('Network offline');
+            }
+        }
+        await delay(NETWORK_STABILIZE_DELAY_MS);
+    }
+}
+//# sourceMappingURL=RoomRecoveryController.js.map

package/dist/recovery/RoomRecoveryController.js.map

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

package/dist/recovery/index.d.ts

@@ -0,0 +1,13 @@
+export { RoomPersistence } from './RoomPersistence.js';
+export type { PersistedRoom, RoomRole, RoomPersistenceConfig, } from './RoomPersistence.js';
+export { RoomRecoveryController, } from './RoomRecoveryController.js';
+export type { RoomRecoveryConfig, RoomRecoveryStatusEvent, RoomRecoveryPhase, RoomTerminatedEvent, RoomRecoveryControllerEvents, RecoveryClientPort, } from './RoomRecoveryController.js';
+export { armBrowserLifecycle, isOnline, waitForOnlineEvent, } from './BrowserLifecycle.js';
+export type { BrowserLifecycleHandle, BrowserLifecycleHandlers } from './BrowserLifecycle.js';
+export { getRecoverTimeoutMs, DEFAULT_RECOVER_TIMEOUT_BUDGET, } from './NetworkQuality.js';
+export type { RecoverTimeoutBudget } from './NetworkQuality.js';
+export { isMobileBrowser, pickMobileFriendlyTransports } from './MobileTransport.js';
+export { loadOrCreateGuestPlayerId } from './GuestPlayerIdStore.js';
+export { LocalStorageAdapter, MemoryKeyValueStorage, defaultKeyValueStorage, } from './KeyValueStorage.js';
+export type { KeyValueStorage } from './KeyValueStorage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/recovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,aAAa,EACb,QAAQ,EACR,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,mBAAmB,EACnB,QAAQ,EACR,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE9F,OAAO,EACL,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/recovery/index.js

@@ -0,0 +1,8 @@
+export { RoomPersistence } from './RoomPersistence.js';
+export { RoomRecoveryController, } from './RoomRecoveryController.js';
+export { armBrowserLifecycle, isOnline, waitForOnlineEvent, } from './BrowserLifecycle.js';
+export { getRecoverTimeoutMs, DEFAULT_RECOVER_TIMEOUT_BUDGET, } from './NetworkQuality.js';
+export { isMobileBrowser, pickMobileFriendlyTransports } from './MobileTransport.js';
+export { loadOrCreateGuestPlayerId } from './GuestPlayerIdStore.js';
+export { LocalStorageAdapter, MemoryKeyValueStorage, defaultKeyValueStorage, } from './KeyValueStorage.js';
+//# sourceMappingURL=index.js.map

package/dist/recovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,OAAO,EACL,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAUrC,OAAO,EACL,mBAAmB,EACnB,QAAQ,EACR,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}