@carverjs/multiplayer 0.0.1 → 0.0.3

package/dist/strategy.d.mts

@@ -1,5 +1,5 @@
-export { F as FirebaseStrategyConfig, M as MqttStrategyConfig, P as PeerMetadata, R as RoomAnnouncement, S as SignalingStrategy, a as StrategyConfig } from './types-5LHBOW08.mjs';
-export { F as FirebaseStrategy, M as MqttStrategy } from './firebase-PE6MxGdJ.mjs';
+export { F as FirebaseStrategyConfig, M as MqttStrategyConfig, P as PeerMetadata, R as RoomAnnouncement, S as SignalingStrategy, a as StrategyConfig } from './types-hNfCIBzj.mjs';
+export { F as FirebaseStrategy, M as MqttStrategy } from './firebase-GrbVrNgs.mjs';
 
 /** Generate a random peer ID (20 chars, URL-safe) */
 declare function generatePeerId(): string;

package/dist/strategy.d.ts

@@ -1,5 +1,5 @@
-export { F as FirebaseStrategyConfig, M as MqttStrategyConfig, P as PeerMetadata, R as RoomAnnouncement, S as SignalingStrategy, a as StrategyConfig } from './types-5LHBOW08.js';
-export { F as FirebaseStrategy, M as MqttStrategy } from './firebase-CPu87KA0.js';
+export { F as FirebaseStrategyConfig, M as MqttStrategyConfig, P as PeerMetadata, R as RoomAnnouncement, S as SignalingStrategy, a as StrategyConfig } from './types-hNfCIBzj.js';
+export { F as FirebaseStrategy, M as MqttStrategy } from './firebase-B5MgLlHk.js';
 
 /** Generate a random peer ID (20 chars, URL-safe) */
 declare function generatePeerId(): string;

package/dist/strategy.js

@@ -114,6 +114,7 @@ var MqttStrategy = class {
     this._peerExpiryTimer = null;
     this._lobbySubscribed = false;
     this._destroyed = false;
+    this._lastAnnouncement = null;
     this.selfId = generatePeerId();
     this._appId = appId;
     this._config = config;
@@ -179,9 +180,19 @@ var MqttStrategy = class {
       removeFromArray(this._onLobby, cb);
     };
   }
+  updateRoomOccupancy(roomId, playerCount, state) {
+    const ann = this._lastAnnouncement;
+    if (!ann || ann.roomId !== roomId || !this._client) return;
+    ann.playerCount = playerCount;
+    if (state) ann.state = state;
+    ann.lastSeen = Date.now();
+    const topic = mqttTopics(this._appId, roomId, "").roomLobbyEntry;
+    this._client.publish(topic, JSON.stringify(ann), { retain: true, qos: 1 });
+  }
   announceRoom(announcement) {
     if (!this._client) return;
     const topic = mqttTopics(this._appId, announcement.roomId, "").roomLobbyEntry;
+    this._lastAnnouncement = announcement;
     announcement.lastSeen = Date.now();
     this._client.publish(topic, JSON.stringify(announcement), { retain: true, qos: 1 });
     if (this._lobbyAnnounceTimer) clearInterval(this._lobbyAnnounceTimer);
@@ -379,6 +390,8 @@ var FirebaseStrategy = class {
     // State
     this._knownPeers = /* @__PURE__ */ new Set();
     this._lobbyAnnounceTimer = null;
+    this._lastAnnouncement = null;
+    this._lobbyWired = false;
     this._destroyed = false;
     this.selfId = generatePeerId();
     this._appId = appId;
@@ -394,7 +407,7 @@ var FirebaseStrategy = class {
     this._joinGeneration++;
     this._roomId = roomId;
     this._peerMeta = peerMeta;
-    const { ref, set, onChildAdded, onChildRemoved, onDisconnect, remove } = this._fb;
+    const { ref, set, onChildAdded, onChildRemoved, onDisconnect, onValue, remove } = this._fb;
     const paths = firebasePaths(this._appId, roomId, this.selfId);
     await remove(ref(this._db, paths.peerSignalInbox)).catch(() => {
     });
@@ -405,6 +418,18 @@ var FirebaseStrategy = class {
       ts: Date.now()
     });
     onDisconnect(presenceRef).remove();
+    const generation = this._joinGeneration;
+    const connectedRef = ref(this._db, ".info/connected");
+    const connectedUnsub = onValue(connectedRef, (snap) => {
+      if (snap.val() !== true) return;
+      if (this._destroyed || this._joinGeneration !== generation || this._roomId !== roomId) return;
+      onDisconnect(presenceRef).remove().then(() => {
+        if (this._destroyed || this._joinGeneration !== generation || this._roomId !== roomId) return;
+        return set(presenceRef, { peerId: this.selfId, meta: peerMeta, ts: Date.now() });
+      }).catch(() => {
+      });
+    });
+    this._listeners.push(() => connectedUnsub());
     const peersRef = ref(this._db, paths.peers);
     const addedUnsub = onChildAdded(peersRef, (snapshot) => {
       const data = snapshot.val();
@@ -467,6 +492,12 @@ var FirebaseStrategy = class {
   }
   subscribeToLobby(cb) {
     this._onLobby.push(cb);
+    if (this._lobbyWired) {
+      return () => {
+        removeFromArray(this._onLobby, cb);
+      };
+    }
+    this._lobbyWired = true;
     this._ensureInit().then(() => {
       if (!this._db || !this._fb || this._destroyed) return;
       const { ref, onValue } = this._fb;
@@ -494,14 +525,25 @@ var FirebaseStrategy = class {
     if (!this._db || !this._fb) return;
     const { ref, set } = this._fb;
     const paths = firebasePaths(this._appId, announcement.roomId, "");
+    this._lastAnnouncement = announcement;
     announcement.lastSeen = Date.now();
-    set(ref(this._db, paths.roomLobbyEntry), announcement);
+    set(ref(this._db, paths.roomLobbyEntry), sanitizeForFirebase(announcement));
     if (this._lobbyAnnounceTimer) clearInterval(this._lobbyAnnounceTimer);
     this._lobbyAnnounceTimer = setInterval(() => {
       announcement.lastSeen = Date.now();
-      set(ref(this._db, paths.roomLobbyEntry), announcement);
+      set(ref(this._db, paths.roomLobbyEntry), sanitizeForFirebase(announcement));
     }, ROOM_ANNOUNCE_INTERVAL_MS);
   }
+  updateRoomOccupancy(roomId, playerCount, state) {
+    const ann = this._lastAnnouncement;
+    if (!ann || ann.roomId !== roomId || !this._db || !this._fb) return;
+    ann.playerCount = playerCount;
+    if (state) ann.state = state;
+    ann.lastSeen = Date.now();
+    const { ref, set } = this._fb;
+    const paths = firebasePaths(this._appId, roomId, "");
+    set(ref(this._db, paths.roomLobbyEntry), sanitizeForFirebase(ann));
+  }
   removeRoomAnnouncement(roomId) {
     if (!this._db || !this._fb) return;
     const { ref, remove } = this._fb;
@@ -604,6 +646,7 @@ function sanitizeForFirebase(obj) {
   if (typeof obj === "object" && obj !== null) {
     const result = {};
     for (const [key, value] of Object.entries(obj)) {
+      if (value === void 0) continue;
       result[key] = value === null ? "__null__" : sanitizeForFirebase(value);
     }
     return result;

package/dist/strategy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/transport/strategy/index.ts","../src/transport/strategy/utils.ts","../src/transport/strategy/mqtt.ts","../src/transport/strategy/firebase.ts"],"sourcesContent":["export type {\n  SignalingStrategy,\n  PeerMetadata,\n  RoomAnnouncement,\n  StrategyConfig,\n  MqttStrategyConfig,\n  FirebaseStrategyConfig,\n} from \"./types\";\n\nexport { MqttStrategy } from \"./mqtt\";\nexport { FirebaseStrategy } from \"./firebase\";\nexport { generatePeerId } from \"./utils\";\n","/** Generate a random peer ID (20 chars, URL-safe) */\nexport function generatePeerId(): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  const bytes = new Uint8Array(20);\n  crypto.getRandomValues(bytes);\n  let id = '';\n  for (let i = 0; i < 20; i++) {\n    id += chars[bytes[i] % chars.length];\n  }\n  return id;\n}\n\n/** Build MQTT topic paths for a given appId + roomId */\nexport function mqttTopics(appId: string, roomId: string, peerId?: string) {\n  const base = `carver/${appId}`;\n  return {\n    /** Lobby wildcard: subscribe to discover all room announcements */\n    lobbyWildcard: `${base}/lobby/+`,\n    /** Single room lobby entry */\n    roomLobbyEntry: `${base}/lobby/${roomId}`,\n    /** Wildcard for all peer presence in a room */\n    roomPresenceWildcard: `${base}/room/${roomId}/presence/+`,\n    /** This peer's presence topic */\n    peerPresence: peerId ? `${base}/room/${roomId}/presence/${peerId}` : '',\n    /** This peer's signal inbox */\n    peerSignalInbox: peerId ? `${base}/room/${roomId}/signal/${peerId}` : '',\n  };\n}\n\n/** Build Firebase RTDB paths for a given appId + roomId */\nexport function firebasePaths(appId: string, roomId: string, peerId?: string) {\n  const base = `${appId}/__carver__`;\n  return {\n    lobby: `${base}/lobby`,\n    roomLobbyEntry: `${base}/lobby/${roomId}`,\n    peers: `${base}/rooms/${roomId}/peers`,\n    peerPresence: peerId ? `${base}/rooms/${roomId}/peers/${peerId}` : '',\n    peerSignalInbox: peerId ? `${base}/rooms/${roomId}/signals/${peerId}` : '',\n  };\n}\n\n/** Default MQTT brokers (WebSocket endpoints, free/public) */\nexport const DEFAULT_MQTT_BROKERS = [\n  'wss://broker.emqx.io:8084/mqtt',\n  'wss://test.mosquitto.org:8081/mqtt',\n];\n\n/** Room announcement expiry time (30s without heartbeat = stale) */\nexport const ROOM_ANNOUNCE_EXPIRY_MS = 30_000;\n\n/** Room announcement heartbeat interval */\nexport const ROOM_ANNOUNCE_INTERVAL_MS = 10_000;\n\n/** Peer presence heartbeat interval */\nexport const PRESENCE_HEARTBEAT_MS = 5_000;\n\n/** Peer expiry: 3 missed heartbeats */\nexport const PEER_EXPIRY_MS = PRESENCE_HEARTBEAT_MS * 3;\n\n/** Rapid warmup announces for faster initial peer discovery */\nexport const PRESENCE_WARMUP_DELAYS_MS = [200, 500, 1500];\n\n/** Remove an item from an array by reference. Returns true if found. */\nexport function removeFromArray<T>(arr: T[], item: T): boolean {\n  const idx = arr.indexOf(item);\n  if (idx >= 0) {\n    arr.splice(idx, 1);\n    return true;\n  }\n  return false;\n}\n","import type {\n  SignalingStrategy,\n  PeerMetadata,\n  RoomAnnouncement,\n  MqttStrategyConfig,\n} from \"./types\";\nimport {\n  generatePeerId,\n  mqttTopics,\n  removeFromArray,\n  DEFAULT_MQTT_BROKERS,\n  ROOM_ANNOUNCE_EXPIRY_MS,\n  ROOM_ANNOUNCE_INTERVAL_MS,\n  PRESENCE_HEARTBEAT_MS,\n  PEER_EXPIRY_MS,\n  PRESENCE_WARMUP_DELAYS_MS,\n} from \"./utils\";\n\n// mqtt.MqttClient type (avoid hard import at module level)\ntype MqttClient = {\n  on(event: string, cb: (...args: any[]) => void): void;\n  subscribe(topic: string | string[], opts: Record<string, unknown>, cb?: (err: Error | null) => void): void;\n  unsubscribe(topic: string | string[]): void;\n  publish(topic: string, payload: string | Buffer, opts?: Record<string, unknown>): void;\n  end(force?: boolean): void;\n};\n\n/**\n * MQTT-based signaling strategy.\n *\n * Connects to public MQTT brokers over WebSocket. Peer discovery uses\n * retained presence messages with periodic heartbeats. SDP/ICE relay\n * uses per-peer signal topics. Room discovery uses retained lobby topics.\n *\n * Zero infrastructure cost -- uses free public brokers by default.\n */\nexport class MqttStrategy implements SignalingStrategy {\n  readonly selfId: string;\n\n  private _appId: string;\n  private _config: MqttStrategyConfig;\n  private _client: MqttClient | null = null;\n  private _roomId: string | null = null;\n  private _peerMeta: PeerMetadata = {};\n  /** Monotonic counter to detect stale leaveRoom completions */\n  private _joinGeneration = 0;\n\n  // Lazy init\n  private _initPromise: Promise<void> | null = null;\n\n  // Callbacks\n  private _onPeerDiscovered: ((peerId: string, meta: PeerMetadata) => void)[] = [];\n  private _onPeerLeft: ((peerId: string) => void)[] = [];\n  private _onSignal: ((fromPeerId: string, data: unknown) => void)[] = [];\n  private _onLobby: ((rooms: RoomAnnouncement[]) => void)[] = [];\n\n  // State\n  private _knownPeers = new Map<string, { meta: PeerMetadata; lastSeen: number }>();\n  private _lobbyRooms = new Map<string, RoomAnnouncement>();\n  private _presenceTimer: ReturnType<typeof setInterval> | null = null;\n  private _warmupTimers: ReturnType<typeof setTimeout>[] = [];\n  private _lobbyAnnounceTimer: ReturnType<typeof setInterval> | null = null;\n  private _peerExpiryTimer: ReturnType<typeof setInterval> | null = null;\n  private _lobbySubscribed = false;\n  private _destroyed = false;\n\n  constructor(appId: string, config: MqttStrategyConfig = { type: 'mqtt' }) {\n    this.selfId = generatePeerId();\n    this._appId = appId;\n    this._config = config;\n  }\n\n  // ── Public API ──\n\n  async init(): Promise<void> {\n    return this._ensureInit();\n  }\n\n  async joinRoom(roomId: string, peerMeta: PeerMetadata): Promise<void> {\n    await this._ensureInit();\n    if (!this._client) throw new Error('MQTT client not available');\n\n    this._joinGeneration++;\n    this._roomId = roomId;\n    this._peerMeta = peerMeta;\n\n    const topics = mqttTopics(this._appId, roomId, this.selfId);\n\n    // Subscribe to room presence (discover peers) and own signal inbox\n    await new Promise<void>((resolve, reject) => {\n      this._client!.subscribe(\n        [topics.roomPresenceWildcard, topics.peerSignalInbox],\n        { qos: 1 },\n        (err: Error | null) => (err ? reject(err) : resolve()),\n      );\n    });\n\n    // Publish retained presence\n    this._publishPresence();\n\n    // Rapid warmup announces for fast peer discovery\n    for (const delay of PRESENCE_WARMUP_DELAYS_MS) {\n      this._warmupTimers.push(setTimeout(() => this._publishPresence(), delay));\n    }\n\n    // Periodic heartbeat\n    this._presenceTimer = setInterval(() => this._publishPresence(), PRESENCE_HEARTBEAT_MS);\n\n    // Periodic peer expiry check\n    this._peerExpiryTimer = setInterval(() => this._checkPeerExpiry(), PRESENCE_HEARTBEAT_MS);\n  }\n\n  async leaveRoom(): Promise<void> {\n    if (!this._client || !this._roomId) return;\n\n    const generation = this._joinGeneration;\n    const topics = mqttTopics(this._appId, this._roomId, this.selfId);\n    this._clearRoomTimers();\n\n    // Clear retained presence\n    this._client.publish(topics.peerPresence, '', { retain: true, qos: 1 });\n\n    // Unsubscribe from room topics\n    this._client.unsubscribe([topics.roomPresenceWildcard, topics.peerSignalInbox]);\n\n    this._knownPeers.clear();\n\n    // Only null out _roomId if no new joinRoom() has run since we started.\n    if (this._joinGeneration === generation) {\n      this._roomId = null;\n    }\n  }\n\n  signal(targetPeerId: string, data: unknown): void {\n    if (!this._client || !this._roomId) return;\n    const targetTopic = `carver/${this._appId}/room/${this._roomId}/signal/${targetPeerId}`;\n    this._client.publish(\n      targetTopic,\n      JSON.stringify({ from: this.selfId, data, ts: Date.now() }),\n      { qos: 1 },\n    );\n  }\n\n  subscribeToLobby(cb: (rooms: RoomAnnouncement[]) => void): () => void {\n    this._onLobby.push(cb);\n\n    // Subscribe to lobby topic (lazy -- waits for init)\n    if (!this._lobbySubscribed) {\n      this._lobbySubscribed = true;\n      this._ensureInit().then(() => {\n        if (this._client && !this._destroyed) {\n          const lobbyTopic = mqttTopics(this._appId, '', '').lobbyWildcard;\n          this._client.subscribe(lobbyTopic, { qos: 0 });\n        }\n      });\n    }\n\n    return () => {\n      removeFromArray(this._onLobby, cb);\n    };\n  }\n\n  announceRoom(announcement: RoomAnnouncement): void {\n    if (!this._client) return;\n    const topic = mqttTopics(this._appId, announcement.roomId, '').roomLobbyEntry;\n\n    announcement.lastSeen = Date.now();\n    this._client.publish(topic, JSON.stringify(announcement), { retain: true, qos: 1 });\n\n    // Periodic heartbeat\n    if (this._lobbyAnnounceTimer) clearInterval(this._lobbyAnnounceTimer);\n    this._lobbyAnnounceTimer = setInterval(() => {\n      announcement.lastSeen = Date.now();\n      this._client?.publish(topic, JSON.stringify(announcement), { retain: true, qos: 1 });\n    }, ROOM_ANNOUNCE_INTERVAL_MS);\n  }\n\n  removeRoomAnnouncement(roomId: string): void {\n    if (!this._client) return;\n    const topic = mqttTopics(this._appId, roomId, '').roomLobbyEntry;\n    this._client.publish(topic, '', { retain: true, qos: 1 });\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n  }\n\n  onPeerDiscovered(cb: (peerId: string, meta: PeerMetadata) => void): () => void {\n    this._onPeerDiscovered.push(cb);\n    return () => { removeFromArray(this._onPeerDiscovered, cb); };\n  }\n\n  onPeerLeft(cb: (peerId: string) => void): () => void {\n    this._onPeerLeft.push(cb);\n    return () => { removeFromArray(this._onPeerLeft, cb); };\n  }\n\n  onSignal(cb: (fromPeerId: string, data: unknown) => void): () => void {\n    this._onSignal.push(cb);\n    return () => { removeFromArray(this._onSignal, cb); };\n  }\n\n  destroy(): void {\n    this._destroyed = true;\n    this._clearRoomTimers();\n\n    // Clean up retained presence\n    if (this._client && this._roomId) {\n      const topics = mqttTopics(this._appId, this._roomId, this.selfId);\n      this._client.publish(topics.peerPresence, '', { retain: true, qos: 1 });\n    }\n\n    this._client?.end(true);\n    this._client = null;\n    this._knownPeers.clear();\n    this._lobbyRooms.clear();\n    this._onPeerDiscovered = [];\n    this._onPeerLeft = [];\n    this._onSignal = [];\n    this._onLobby = [];\n  }\n\n  // ── Private ──\n\n  private _ensureInit(): Promise<void> {\n    if (!this._initPromise) {\n      this._initPromise = this._doInit();\n    }\n    return this._initPromise;\n  }\n\n  private async _doInit(): Promise<void> {\n    const mqtt = await import('mqtt');\n    const brokers = this._config.brokerUrls ?? DEFAULT_MQTT_BROKERS;\n    // Pick a random broker from the available pool\n    const brokerUrl = brokers[Math.floor(Math.random() * brokers.length)];\n\n    return new Promise<void>((resolve, reject) => {\n      const connectFn = mqtt.default?.connect ?? mqtt.connect;\n      this._client = connectFn(brokerUrl, {\n        clientId: `carver_${this.selfId}`,\n        clean: true,\n        connectTimeout: 10_000,\n        keepalive: 30,\n      }) as MqttClient;\n\n      this._client.on('connect', () => {\n        if (!this._destroyed) resolve();\n      });\n\n      this._client.on('error', (err: Error) => {\n        if (!this._initPromise) return; // already resolved\n        reject(err);\n      });\n\n      this._client.on('message', (topic: string, payload: Buffer) => {\n        this._handleMessage(topic, payload);\n      });\n    });\n  }\n\n  private _publishPresence(): void {\n    if (!this._client || !this._roomId) return;\n    const topics = mqttTopics(this._appId, this._roomId, this.selfId);\n    this._client.publish(\n      topics.peerPresence,\n      JSON.stringify({ peerId: this.selfId, meta: this._peerMeta, ts: Date.now() }),\n      { retain: true, qos: 1 },\n    );\n  }\n\n  private _handleMessage(topic: string, payload: Buffer): void {\n    const raw = payload.toString();\n\n    // ── Presence message ──\n    const presenceMatch = topic.match(/\\/room\\/[^/]+\\/presence\\/([^/]+)$/);\n    if (presenceMatch) {\n      const peerId = presenceMatch[1];\n      if (peerId === this.selfId) return;\n\n      if (!raw) {\n        // Empty retained = peer left\n        if (this._knownPeers.has(peerId)) {\n          this._knownPeers.delete(peerId);\n          for (const cb of this._onPeerLeft) cb(peerId);\n        }\n        return;\n      }\n      try {\n        const msg = JSON.parse(raw);\n        const isNew = !this._knownPeers.has(peerId);\n        this._knownPeers.set(peerId, { meta: msg.meta ?? {}, lastSeen: msg.ts ?? Date.now() });\n        if (isNew) {\n          for (const cb of this._onPeerDiscovered) cb(peerId, msg.meta ?? {});\n        }\n      } catch { /* ignore malformed */ }\n      return;\n    }\n\n    // ── Signal message (SDP / ICE) ──\n    const signalMatch = topic.match(/\\/room\\/[^/]+\\/signal\\/([^/]+)$/);\n    if (signalMatch) {\n      try {\n        const msg = JSON.parse(raw);\n        if (msg.from && msg.from !== this.selfId) {\n          for (const cb of this._onSignal) cb(msg.from, msg.data);\n        }\n      } catch { /* ignore malformed */ }\n      return;\n    }\n\n    // ── Lobby announcement ──\n    const lobbyMatch = topic.match(/\\/lobby\\/([^/]+)$/);\n    if (lobbyMatch) {\n      const roomId = lobbyMatch[1];\n      if (!raw) {\n        this._lobbyRooms.delete(roomId);\n      } else {\n        try {\n          const ann = JSON.parse(raw) as RoomAnnouncement;\n          if (Date.now() - ann.lastSeen < ROOM_ANNOUNCE_EXPIRY_MS) {\n            this._lobbyRooms.set(roomId, ann);\n          } else {\n            this._lobbyRooms.delete(roomId);\n          }\n        } catch { /* ignore */ }\n      }\n      const rooms = Array.from(this._lobbyRooms.values());\n      for (const cb of this._onLobby) cb(rooms);\n    }\n  }\n\n  private _checkPeerExpiry(): void {\n    const now = Date.now();\n    for (const [peerId, data] of this._knownPeers) {\n      if (now - data.lastSeen > PEER_EXPIRY_MS) {\n        this._knownPeers.delete(peerId);\n        for (const cb of this._onPeerLeft) cb(peerId);\n      }\n    }\n  }\n\n  private _clearRoomTimers(): void {\n    if (this._presenceTimer) { clearInterval(this._presenceTimer); this._presenceTimer = null; }\n    for (const t of this._warmupTimers) clearTimeout(t);\n    this._warmupTimers = [];\n    if (this._lobbyAnnounceTimer) { clearInterval(this._lobbyAnnounceTimer); this._lobbyAnnounceTimer = null; }\n    if (this._peerExpiryTimer) { clearInterval(this._peerExpiryTimer); this._peerExpiryTimer = null; }\n  }\n}\n","import type {\n  SignalingStrategy,\n  PeerMetadata,\n  RoomAnnouncement,\n  FirebaseStrategyConfig,\n} from \"./types\";\nimport {\n  generatePeerId,\n  firebasePaths,\n  removeFromArray,\n  ROOM_ANNOUNCE_EXPIRY_MS,\n  ROOM_ANNOUNCE_INTERVAL_MS,\n} from \"./utils\";\n\n/**\n * Firebase Realtime Database signaling strategy.\n *\n * Requires the `firebase` package as a peer dependency.\n * Pass either a `databaseURL` (auto-creates a namespaced Firebase app)\n * or an existing `firebaseApp` instance.\n *\n * Presence cleanup is automatic via Firebase onDisconnect().\n */\nexport class FirebaseStrategy implements SignalingStrategy {\n  readonly selfId: string;\n\n  private _appId: string;\n  private _config: FirebaseStrategyConfig;\n  private _db: any = null;\n  private _firebaseApp: any = null;\n  private _ownApp = false;\n  private _roomId: string | null = null;\n  private _peerMeta: PeerMetadata = {};\n  /** Monotonic counter to detect stale leaveRoom completions */\n  private _joinGeneration = 0;\n\n  // Lazy init\n  private _initPromise: Promise<void> | null = null;\n\n  // Firebase module references (filled after dynamic import)\n  private _fb: {\n    ref: any;\n    set: any;\n    push: any;\n    remove: any;\n    onValue: any;\n    onChildAdded: any;\n    onChildRemoved: any;\n    onDisconnect: any;\n  } | null = null;\n\n  // Unsubscribe handles for Firebase listeners\n  private _listeners: (() => void)[] = [];\n\n  // Callbacks\n  private _onPeerDiscovered: ((peerId: string, meta: PeerMetadata) => void)[] = [];\n  private _onPeerLeft: ((peerId: string) => void)[] = [];\n  private _onSignal: ((fromPeerId: string, data: unknown) => void)[] = [];\n  private _onLobby: ((rooms: RoomAnnouncement[]) => void)[] = [];\n\n  // State\n  private _knownPeers = new Set<string>();\n  private _lobbyAnnounceTimer: ReturnType<typeof setInterval> | null = null;\n  private _destroyed = false;\n\n  constructor(appId: string, config: FirebaseStrategyConfig) {\n    this.selfId = generatePeerId();\n    this._appId = appId;\n    this._config = config;\n  }\n\n  // ── Public API ──\n\n  async init(): Promise<void> {\n    return this._ensureInit();\n  }\n\n  async joinRoom(roomId: string, peerMeta: PeerMetadata): Promise<void> {\n    await this._ensureInit();\n    if (!this._db || !this._fb) throw new Error('Firebase not initialized');\n\n    // Bump generation so any in-flight leaveRoom from a prior call won't\n    // null out _roomId after we set it here (React StrictMode race fix).\n    this._joinGeneration++;\n\n    this._roomId = roomId;\n    this._peerMeta = peerMeta;\n    const { ref, set, onChildAdded, onChildRemoved, onDisconnect, remove } = this._fb;\n    const paths = firebasePaths(this._appId, roomId, this.selfId);\n\n    // Clean stale signals from our inbox before listening (prevents\n    // replaying SDP from a previous session that wasn't cleaned up).\n    await remove(ref(this._db, paths.peerSignalInbox)).catch(() => {});\n\n    // 1. Write presence with auto-cleanup on disconnect\n    const presenceRef = ref(this._db, paths.peerPresence);\n    await set(presenceRef, {\n      peerId: this.selfId,\n      meta: peerMeta,\n      ts: Date.now(),\n    });\n    onDisconnect(presenceRef).remove();\n\n    // 2. Listen for peers joining\n    const peersRef = ref(this._db, paths.peers);\n    const addedUnsub = onChildAdded(peersRef, (snapshot: any) => {\n      const data = snapshot.val();\n      if (!data || data.peerId === this.selfId) return;\n      if (!this._knownPeers.has(data.peerId)) {\n        this._knownPeers.add(data.peerId);\n        for (const cb of this._onPeerDiscovered) cb(data.peerId, data.meta ?? {});\n      }\n    });\n    this._listeners.push(() => addedUnsub());\n\n    // 3. Listen for peers leaving\n    const removedUnsub = onChildRemoved(peersRef, (snapshot: any) => {\n      const data = snapshot.val();\n      const peerId = data?.peerId ?? snapshot.key;\n      if (peerId && this._knownPeers.has(peerId)) {\n        this._knownPeers.delete(peerId);\n        for (const cb of this._onPeerLeft) cb(peerId);\n      }\n    });\n    this._listeners.push(() => removedUnsub());\n\n    // 4. Listen for signals addressed to us\n    const signalRef = ref(this._db, paths.peerSignalInbox);\n    const signalUnsub = onChildAdded(signalRef, (snapshot: any) => {\n      const msg = snapshot.val();\n      if (!msg || msg.from === this.selfId) return;\n      for (const cb of this._onSignal) cb(msg.from, msg.data);\n      // Remove processed signal to keep the inbox clean\n      remove(snapshot.ref);\n    });\n    this._listeners.push(() => signalUnsub());\n  }\n\n  async leaveRoom(): Promise<void> {\n    if (!this._db || !this._fb || !this._roomId) return;\n\n    // Capture current state so async cleanup targets the correct room\n    // even if joinRoom() is called concurrently (React StrictMode).\n    const leavingRoomId = this._roomId;\n    const generation = this._joinGeneration;\n\n    const { ref, remove } = this._fb;\n    const paths = firebasePaths(this._appId, leavingRoomId, this.selfId);\n\n    // Detach listeners\n    for (const unsub of this._listeners) unsub();\n    this._listeners = [];\n\n    // Remove presence and signal inbox\n    await Promise.all([\n      remove(ref(this._db, paths.peerPresence)),\n      remove(ref(this._db, paths.peerSignalInbox)),\n    ]).catch(() => {});\n\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n\n    this._knownPeers.clear();\n\n    // Only null out _roomId if no new joinRoom() has run since we started.\n    // This prevents the StrictMode race: old leaveRoom completing after\n    // new joinRoom already set _roomId to the fresh value.\n    if (this._joinGeneration === generation) {\n      this._roomId = null;\n    }\n  }\n\n  signal(targetPeerId: string, data: unknown): void {\n    if (!this._db || !this._fb || !this._roomId) return;\n    const { ref, push } = this._fb;\n\n    // Atomic push: single operation writes the key + data together.\n    // Avoids the push() + set() two-step that can cause onChildAdded to\n    // fire with null if the listener catches the intermediate state.\n    const inboxPath = firebasePaths(this._appId, this._roomId, targetPeerId).peerSignalInbox;\n    push(ref(this._db, inboxPath), {\n      from: this.selfId,\n      data: sanitizeForFirebase(data),\n      ts: Date.now(),\n    });\n  }\n\n  subscribeToLobby(cb: (rooms: RoomAnnouncement[]) => void): () => void {\n    this._onLobby.push(cb);\n\n    this._ensureInit().then(() => {\n      if (!this._db || !this._fb || this._destroyed) return;\n      const { ref, onValue } = this._fb;\n      const paths = firebasePaths(this._appId, '', '');\n      const lobbyRef = ref(this._db, paths.lobby);\n\n      const unsub = onValue(lobbyRef, (snapshot: any) => {\n        const data = snapshot.val();\n        if (!data) {\n          for (const lcb of this._onLobby) lcb([]);\n          return;\n        }\n        const now = Date.now();\n        const rooms: RoomAnnouncement[] = Object.values(data).filter(\n          (r: any) => r && now - (r.lastSeen ?? 0) < ROOM_ANNOUNCE_EXPIRY_MS,\n        ) as RoomAnnouncement[];\n        for (const lcb of this._onLobby) lcb(rooms);\n      });\n      this._listeners.push(() => unsub());\n    });\n\n    return () => {\n      removeFromArray(this._onLobby, cb);\n    };\n  }\n\n  announceRoom(announcement: RoomAnnouncement): void {\n    if (!this._db || !this._fb) return;\n    const { ref, set } = this._fb;\n    const paths = firebasePaths(this._appId, announcement.roomId, '');\n\n    announcement.lastSeen = Date.now();\n    set(ref(this._db, paths.roomLobbyEntry), announcement);\n\n    // Periodic heartbeat\n    if (this._lobbyAnnounceTimer) clearInterval(this._lobbyAnnounceTimer);\n    this._lobbyAnnounceTimer = setInterval(() => {\n      announcement.lastSeen = Date.now();\n      set(ref(this._db, paths.roomLobbyEntry), announcement);\n    }, ROOM_ANNOUNCE_INTERVAL_MS);\n  }\n\n  removeRoomAnnouncement(roomId: string): void {\n    if (!this._db || !this._fb) return;\n    const { ref, remove } = this._fb;\n    remove(ref(this._db, firebasePaths(this._appId, roomId, '').roomLobbyEntry));\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n  }\n\n  onPeerDiscovered(cb: (peerId: string, meta: PeerMetadata) => void): () => void {\n    this._onPeerDiscovered.push(cb);\n    return () => { removeFromArray(this._onPeerDiscovered, cb); };\n  }\n\n  onPeerLeft(cb: (peerId: string) => void): () => void {\n    this._onPeerLeft.push(cb);\n    return () => { removeFromArray(this._onPeerLeft, cb); };\n  }\n\n  onSignal(cb: (fromPeerId: string, data: unknown) => void): () => void {\n    this._onSignal.push(cb);\n    return () => { removeFromArray(this._onSignal, cb); };\n  }\n\n  destroy(): void {\n    this._destroyed = true;\n    for (const unsub of this._listeners) unsub();\n    this._listeners = [];\n\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n\n    // Best-effort cleanup\n    if (this._db && this._fb && this._roomId) {\n      const { ref, remove } = this._fb;\n      const paths = firebasePaths(this._appId, this._roomId, this.selfId);\n      remove(ref(this._db, paths.peerPresence)).catch(() => {});\n      remove(ref(this._db, paths.peerSignalInbox)).catch(() => {});\n    }\n\n    // Delete own Firebase app if we created it\n    if (this._ownApp && this._firebaseApp) {\n      import('firebase/app').then(({ deleteApp }) => {\n        deleteApp(this._firebaseApp).catch(() => {});\n      });\n    }\n\n    this._db = null;\n    this._firebaseApp = null;\n    this._fb = null;\n    this._knownPeers.clear();\n    this._onPeerDiscovered = [];\n    this._onPeerLeft = [];\n    this._onSignal = [];\n    this._onLobby = [];\n  }\n\n  // ── Private ──\n\n  private _ensureInit(): Promise<void> {\n    if (!this._initPromise) {\n      this._initPromise = this._doInit();\n    }\n    return this._initPromise;\n  }\n\n  private async _doInit(): Promise<void> {\n    const { initializeApp, getApps } = await import('firebase/app');\n    const {\n      getDatabase,\n      ref,\n      set,\n      push,\n      remove,\n      onValue,\n      onChildAdded,\n      onChildRemoved,\n      onDisconnect,\n    } = await import('firebase/database');\n\n    this._fb = { ref, set, push, remove, onValue, onChildAdded, onChildRemoved, onDisconnect };\n\n    if (this._config.firebaseApp) {\n      this._firebaseApp = this._config.firebaseApp;\n      this._ownApp = false;\n    } else {\n      const appName = `carver_${this._appId}`;\n      const existing = getApps().find((a: any) => a.name === appName);\n      if (existing) {\n        this._firebaseApp = existing;\n        this._ownApp = false;\n      } else {\n        this._firebaseApp = initializeApp({ databaseURL: this._config.databaseURL }, appName);\n        this._ownApp = true;\n      }\n    }\n\n    this._db = getDatabase(this._firebaseApp);\n  }\n}\n\n/**\n * Firebase RTDB deletes any key whose value is `null` (treats null as \"remove\").\n * ICE candidates from `toJSON()` can contain `null` fields (e.g. usernameFragment).\n * We recursively replace `null` with a sentinel so Firebase preserves the key.\n * On the receiving end, `_handleSignal` doesn't need to reverse this because\n * `new RTCIceCandidate()` / `new RTCSessionDescription()` accept missing fields.\n */\nfunction sanitizeForFirebase(obj: unknown): unknown {\n  if (obj === null) return '__null__';\n  if (Array.isArray(obj)) return obj.map(sanitizeForFirebase);\n  if (typeof obj === 'object' && obj !== null) {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      result[key] = value === null ? '__null__' : sanitizeForFirebase(value);\n    }\n    return result;\n  }\n  return obj;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/transport/strategy/index.ts","../src/transport/strategy/utils.ts","../src/transport/strategy/mqtt.ts","../src/transport/strategy/firebase.ts"],"sourcesContent":["export type {\n  SignalingStrategy,\n  PeerMetadata,\n  RoomAnnouncement,\n  StrategyConfig,\n  MqttStrategyConfig,\n  FirebaseStrategyConfig,\n} from \"./types\";\n\nexport { MqttStrategy } from \"./mqtt\";\nexport { FirebaseStrategy } from \"./firebase\";\nexport { generatePeerId } from \"./utils\";\n","/** Generate a random peer ID (20 chars, URL-safe) */\nexport function generatePeerId(): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  const bytes = new Uint8Array(20);\n  crypto.getRandomValues(bytes);\n  let id = '';\n  for (let i = 0; i < 20; i++) {\n    id += chars[bytes[i] % chars.length];\n  }\n  return id;\n}\n\n/** Build MQTT topic paths for a given appId + roomId */\nexport function mqttTopics(appId: string, roomId: string, peerId?: string) {\n  const base = `carver/${appId}`;\n  return {\n    /** Lobby wildcard: subscribe to discover all room announcements */\n    lobbyWildcard: `${base}/lobby/+`,\n    /** Single room lobby entry */\n    roomLobbyEntry: `${base}/lobby/${roomId}`,\n    /** Wildcard for all peer presence in a room */\n    roomPresenceWildcard: `${base}/room/${roomId}/presence/+`,\n    /** This peer's presence topic */\n    peerPresence: peerId ? `${base}/room/${roomId}/presence/${peerId}` : '',\n    /** This peer's signal inbox */\n    peerSignalInbox: peerId ? `${base}/room/${roomId}/signal/${peerId}` : '',\n  };\n}\n\n/** Build Firebase RTDB paths for a given appId + roomId */\nexport function firebasePaths(appId: string, roomId: string, peerId?: string) {\n  const base = `${appId}/__carver__`;\n  return {\n    lobby: `${base}/lobby`,\n    roomLobbyEntry: `${base}/lobby/${roomId}`,\n    peers: `${base}/rooms/${roomId}/peers`,\n    peerPresence: peerId ? `${base}/rooms/${roomId}/peers/${peerId}` : '',\n    peerSignalInbox: peerId ? `${base}/rooms/${roomId}/signals/${peerId}` : '',\n  };\n}\n\n/** Default MQTT brokers (WebSocket endpoints, free/public) */\nexport const DEFAULT_MQTT_BROKERS = [\n  'wss://broker.emqx.io:8084/mqtt',\n  'wss://test.mosquitto.org:8081/mqtt',\n];\n\n/** Room announcement expiry time (30s without heartbeat = stale) */\nexport const ROOM_ANNOUNCE_EXPIRY_MS = 30_000;\n\n/** Room announcement heartbeat interval */\nexport const ROOM_ANNOUNCE_INTERVAL_MS = 10_000;\n\n/** Peer presence heartbeat interval */\nexport const PRESENCE_HEARTBEAT_MS = 5_000;\n\n/** Peer expiry: 3 missed heartbeats */\nexport const PEER_EXPIRY_MS = PRESENCE_HEARTBEAT_MS * 3;\n\n/** Rapid warmup announces for faster initial peer discovery */\nexport const PRESENCE_WARMUP_DELAYS_MS = [200, 500, 1500];\n\n/** Remove an item from an array by reference. Returns true if found. */\nexport function removeFromArray<T>(arr: T[], item: T): boolean {\n  const idx = arr.indexOf(item);\n  if (idx >= 0) {\n    arr.splice(idx, 1);\n    return true;\n  }\n  return false;\n}\n","import type {\n  SignalingStrategy,\n  PeerMetadata,\n  RoomAnnouncement,\n  MqttStrategyConfig,\n} from \"./types\";\nimport {\n  generatePeerId,\n  mqttTopics,\n  removeFromArray,\n  DEFAULT_MQTT_BROKERS,\n  ROOM_ANNOUNCE_EXPIRY_MS,\n  ROOM_ANNOUNCE_INTERVAL_MS,\n  PRESENCE_HEARTBEAT_MS,\n  PEER_EXPIRY_MS,\n  PRESENCE_WARMUP_DELAYS_MS,\n} from \"./utils\";\n\n// mqtt.MqttClient type (avoid hard import at module level)\ntype MqttClient = {\n  on(event: string, cb: (...args: any[]) => void): void;\n  subscribe(topic: string | string[], opts: Record<string, unknown>, cb?: (err: Error | null) => void): void;\n  unsubscribe(topic: string | string[]): void;\n  publish(topic: string, payload: string | Buffer, opts?: Record<string, unknown>): void;\n  end(force?: boolean): void;\n};\n\n/**\n * MQTT-based signaling strategy.\n *\n * Connects to public MQTT brokers over WebSocket. Peer discovery uses\n * retained presence messages with periodic heartbeats. SDP/ICE relay\n * uses per-peer signal topics. Room discovery uses retained lobby topics.\n *\n * Zero infrastructure cost -- uses free public brokers by default.\n */\nexport class MqttStrategy implements SignalingStrategy {\n  readonly selfId: string;\n\n  private _appId: string;\n  private _config: MqttStrategyConfig;\n  private _client: MqttClient | null = null;\n  private _roomId: string | null = null;\n  private _peerMeta: PeerMetadata = {};\n  /** Monotonic counter to detect stale leaveRoom completions */\n  private _joinGeneration = 0;\n\n  // Lazy init\n  private _initPromise: Promise<void> | null = null;\n\n  // Callbacks\n  private _onPeerDiscovered: ((peerId: string, meta: PeerMetadata) => void)[] = [];\n  private _onPeerLeft: ((peerId: string) => void)[] = [];\n  private _onSignal: ((fromPeerId: string, data: unknown) => void)[] = [];\n  private _onLobby: ((rooms: RoomAnnouncement[]) => void)[] = [];\n\n  // State\n  private _knownPeers = new Map<string, { meta: PeerMetadata; lastSeen: number }>();\n  private _lobbyRooms = new Map<string, RoomAnnouncement>();\n  private _presenceTimer: ReturnType<typeof setInterval> | null = null;\n  private _warmupTimers: ReturnType<typeof setTimeout>[] = [];\n  private _lobbyAnnounceTimer: ReturnType<typeof setInterval> | null = null;\n  private _peerExpiryTimer: ReturnType<typeof setInterval> | null = null;\n  private _lobbySubscribed = false;\n  private _destroyed = false;\n\n  constructor(appId: string, config: MqttStrategyConfig = { type: 'mqtt' }) {\n    this.selfId = generatePeerId();\n    this._appId = appId;\n    this._config = config;\n  }\n\n  // ── Public API ──\n\n  async init(): Promise<void> {\n    return this._ensureInit();\n  }\n\n  async joinRoom(roomId: string, peerMeta: PeerMetadata): Promise<void> {\n    await this._ensureInit();\n    if (!this._client) throw new Error('MQTT client not available');\n\n    this._joinGeneration++;\n    this._roomId = roomId;\n    this._peerMeta = peerMeta;\n\n    const topics = mqttTopics(this._appId, roomId, this.selfId);\n\n    // Subscribe to room presence (discover peers) and own signal inbox\n    await new Promise<void>((resolve, reject) => {\n      this._client!.subscribe(\n        [topics.roomPresenceWildcard, topics.peerSignalInbox],\n        { qos: 1 },\n        (err: Error | null) => (err ? reject(err) : resolve()),\n      );\n    });\n\n    // Publish retained presence\n    this._publishPresence();\n\n    // Rapid warmup announces for fast peer discovery\n    for (const delay of PRESENCE_WARMUP_DELAYS_MS) {\n      this._warmupTimers.push(setTimeout(() => this._publishPresence(), delay));\n    }\n\n    // Periodic heartbeat\n    this._presenceTimer = setInterval(() => this._publishPresence(), PRESENCE_HEARTBEAT_MS);\n\n    // Periodic peer expiry check\n    this._peerExpiryTimer = setInterval(() => this._checkPeerExpiry(), PRESENCE_HEARTBEAT_MS);\n  }\n\n  async leaveRoom(): Promise<void> {\n    if (!this._client || !this._roomId) return;\n\n    const generation = this._joinGeneration;\n    const topics = mqttTopics(this._appId, this._roomId, this.selfId);\n    this._clearRoomTimers();\n\n    // Clear retained presence\n    this._client.publish(topics.peerPresence, '', { retain: true, qos: 1 });\n\n    // Unsubscribe from room topics\n    this._client.unsubscribe([topics.roomPresenceWildcard, topics.peerSignalInbox]);\n\n    this._knownPeers.clear();\n\n    // Only null out _roomId if no new joinRoom() has run since we started.\n    if (this._joinGeneration === generation) {\n      this._roomId = null;\n    }\n  }\n\n  signal(targetPeerId: string, data: unknown): void {\n    if (!this._client || !this._roomId) return;\n    const targetTopic = `carver/${this._appId}/room/${this._roomId}/signal/${targetPeerId}`;\n    this._client.publish(\n      targetTopic,\n      JSON.stringify({ from: this.selfId, data, ts: Date.now() }),\n      { qos: 1 },\n    );\n  }\n\n  subscribeToLobby(cb: (rooms: RoomAnnouncement[]) => void): () => void {\n    this._onLobby.push(cb);\n\n    // Subscribe to lobby topic (lazy -- waits for init)\n    if (!this._lobbySubscribed) {\n      this._lobbySubscribed = true;\n      this._ensureInit().then(() => {\n        if (this._client && !this._destroyed) {\n          const lobbyTopic = mqttTopics(this._appId, '', '').lobbyWildcard;\n          this._client.subscribe(lobbyTopic, { qos: 0 });\n        }\n      });\n    }\n\n    return () => {\n      removeFromArray(this._onLobby, cb);\n    };\n  }\n\n  private _lastAnnouncement: RoomAnnouncement | null = null;\n\n  updateRoomOccupancy(roomId: string, playerCount: number, state?: 'lobby' | 'playing' | 'ended'): void {\n    const ann = this._lastAnnouncement;\n    if (!ann || ann.roomId !== roomId || !this._client) return;\n    ann.playerCount = playerCount;\n    if (state) ann.state = state;\n    ann.lastSeen = Date.now();\n    const topic = mqttTopics(this._appId, roomId, '').roomLobbyEntry;\n    this._client.publish(topic, JSON.stringify(ann), { retain: true, qos: 1 });\n  }\n\n  announceRoom(announcement: RoomAnnouncement): void {\n    if (!this._client) return;\n    const topic = mqttTopics(this._appId, announcement.roomId, '').roomLobbyEntry;\n\n    this._lastAnnouncement = announcement;\n    announcement.lastSeen = Date.now();\n    this._client.publish(topic, JSON.stringify(announcement), { retain: true, qos: 1 });\n\n    // Periodic heartbeat\n    if (this._lobbyAnnounceTimer) clearInterval(this._lobbyAnnounceTimer);\n    this._lobbyAnnounceTimer = setInterval(() => {\n      announcement.lastSeen = Date.now();\n      this._client?.publish(topic, JSON.stringify(announcement), { retain: true, qos: 1 });\n    }, ROOM_ANNOUNCE_INTERVAL_MS);\n  }\n\n  removeRoomAnnouncement(roomId: string): void {\n    if (!this._client) return;\n    const topic = mqttTopics(this._appId, roomId, '').roomLobbyEntry;\n    this._client.publish(topic, '', { retain: true, qos: 1 });\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n  }\n\n  onPeerDiscovered(cb: (peerId: string, meta: PeerMetadata) => void): () => void {\n    this._onPeerDiscovered.push(cb);\n    return () => { removeFromArray(this._onPeerDiscovered, cb); };\n  }\n\n  onPeerLeft(cb: (peerId: string) => void): () => void {\n    this._onPeerLeft.push(cb);\n    return () => { removeFromArray(this._onPeerLeft, cb); };\n  }\n\n  onSignal(cb: (fromPeerId: string, data: unknown) => void): () => void {\n    this._onSignal.push(cb);\n    return () => { removeFromArray(this._onSignal, cb); };\n  }\n\n  destroy(): void {\n    this._destroyed = true;\n    this._clearRoomTimers();\n\n    // Clean up retained presence\n    if (this._client && this._roomId) {\n      const topics = mqttTopics(this._appId, this._roomId, this.selfId);\n      this._client.publish(topics.peerPresence, '', { retain: true, qos: 1 });\n    }\n\n    this._client?.end(true);\n    this._client = null;\n    this._knownPeers.clear();\n    this._lobbyRooms.clear();\n    this._onPeerDiscovered = [];\n    this._onPeerLeft = [];\n    this._onSignal = [];\n    this._onLobby = [];\n  }\n\n  // ── Private ──\n\n  private _ensureInit(): Promise<void> {\n    if (!this._initPromise) {\n      this._initPromise = this._doInit();\n    }\n    return this._initPromise;\n  }\n\n  private async _doInit(): Promise<void> {\n    const mqtt = await import('mqtt');\n    const brokers = this._config.brokerUrls ?? DEFAULT_MQTT_BROKERS;\n    // Pick a random broker from the available pool\n    const brokerUrl = brokers[Math.floor(Math.random() * brokers.length)];\n\n    return new Promise<void>((resolve, reject) => {\n      const connectFn = mqtt.default?.connect ?? mqtt.connect;\n      this._client = connectFn(brokerUrl, {\n        clientId: `carver_${this.selfId}`,\n        clean: true,\n        connectTimeout: 10_000,\n        keepalive: 30,\n      }) as MqttClient;\n\n      this._client.on('connect', () => {\n        if (!this._destroyed) resolve();\n      });\n\n      this._client.on('error', (err: Error) => {\n        if (!this._initPromise) return; // already resolved\n        reject(err);\n      });\n\n      this._client.on('message', (topic: string, payload: Buffer) => {\n        this._handleMessage(topic, payload);\n      });\n    });\n  }\n\n  private _publishPresence(): void {\n    if (!this._client || !this._roomId) return;\n    const topics = mqttTopics(this._appId, this._roomId, this.selfId);\n    this._client.publish(\n      topics.peerPresence,\n      JSON.stringify({ peerId: this.selfId, meta: this._peerMeta, ts: Date.now() }),\n      { retain: true, qos: 1 },\n    );\n  }\n\n  private _handleMessage(topic: string, payload: Buffer): void {\n    const raw = payload.toString();\n\n    // ── Presence message ──\n    const presenceMatch = topic.match(/\\/room\\/[^/]+\\/presence\\/([^/]+)$/);\n    if (presenceMatch) {\n      const peerId = presenceMatch[1];\n      if (peerId === this.selfId) return;\n\n      if (!raw) {\n        // Empty retained = peer left\n        if (this._knownPeers.has(peerId)) {\n          this._knownPeers.delete(peerId);\n          for (const cb of this._onPeerLeft) cb(peerId);\n        }\n        return;\n      }\n      try {\n        const msg = JSON.parse(raw);\n        const isNew = !this._knownPeers.has(peerId);\n        this._knownPeers.set(peerId, { meta: msg.meta ?? {}, lastSeen: msg.ts ?? Date.now() });\n        if (isNew) {\n          for (const cb of this._onPeerDiscovered) cb(peerId, msg.meta ?? {});\n        }\n      } catch { /* ignore malformed */ }\n      return;\n    }\n\n    // ── Signal message (SDP / ICE) ──\n    const signalMatch = topic.match(/\\/room\\/[^/]+\\/signal\\/([^/]+)$/);\n    if (signalMatch) {\n      try {\n        const msg = JSON.parse(raw);\n        if (msg.from && msg.from !== this.selfId) {\n          for (const cb of this._onSignal) cb(msg.from, msg.data);\n        }\n      } catch { /* ignore malformed */ }\n      return;\n    }\n\n    // ── Lobby announcement ──\n    const lobbyMatch = topic.match(/\\/lobby\\/([^/]+)$/);\n    if (lobbyMatch) {\n      const roomId = lobbyMatch[1];\n      if (!raw) {\n        this._lobbyRooms.delete(roomId);\n      } else {\n        try {\n          const ann = JSON.parse(raw) as RoomAnnouncement;\n          if (Date.now() - ann.lastSeen < ROOM_ANNOUNCE_EXPIRY_MS) {\n            this._lobbyRooms.set(roomId, ann);\n          } else {\n            this._lobbyRooms.delete(roomId);\n          }\n        } catch { /* ignore */ }\n      }\n      const rooms = Array.from(this._lobbyRooms.values());\n      for (const cb of this._onLobby) cb(rooms);\n    }\n  }\n\n  private _checkPeerExpiry(): void {\n    const now = Date.now();\n    for (const [peerId, data] of this._knownPeers) {\n      if (now - data.lastSeen > PEER_EXPIRY_MS) {\n        this._knownPeers.delete(peerId);\n        for (const cb of this._onPeerLeft) cb(peerId);\n      }\n    }\n  }\n\n  private _clearRoomTimers(): void {\n    if (this._presenceTimer) { clearInterval(this._presenceTimer); this._presenceTimer = null; }\n    for (const t of this._warmupTimers) clearTimeout(t);\n    this._warmupTimers = [];\n    if (this._lobbyAnnounceTimer) { clearInterval(this._lobbyAnnounceTimer); this._lobbyAnnounceTimer = null; }\n    if (this._peerExpiryTimer) { clearInterval(this._peerExpiryTimer); this._peerExpiryTimer = null; }\n  }\n}\n","import type {\n  SignalingStrategy,\n  PeerMetadata,\n  RoomAnnouncement,\n  FirebaseStrategyConfig,\n} from \"./types\";\nimport {\n  generatePeerId,\n  firebasePaths,\n  removeFromArray,\n  ROOM_ANNOUNCE_EXPIRY_MS,\n  ROOM_ANNOUNCE_INTERVAL_MS,\n} from \"./utils\";\n\n/**\n * Firebase Realtime Database signaling strategy.\n *\n * Requires the `firebase` package as a peer dependency.\n * Pass either a `databaseURL` (auto-creates a namespaced Firebase app)\n * or an existing `firebaseApp` instance.\n *\n * Presence cleanup is automatic via Firebase onDisconnect().\n */\nexport class FirebaseStrategy implements SignalingStrategy {\n  readonly selfId: string;\n\n  private _appId: string;\n  private _config: FirebaseStrategyConfig;\n  private _db: any = null;\n  private _firebaseApp: any = null;\n  private _ownApp = false;\n  private _roomId: string | null = null;\n  private _peerMeta: PeerMetadata = {};\n  /** Monotonic counter to detect stale leaveRoom completions */\n  private _joinGeneration = 0;\n\n  // Lazy init\n  private _initPromise: Promise<void> | null = null;\n\n  // Firebase module references (filled after dynamic import)\n  private _fb: {\n    ref: any;\n    set: any;\n    push: any;\n    remove: any;\n    onValue: any;\n    onChildAdded: any;\n    onChildRemoved: any;\n    onDisconnect: any;\n  } | null = null;\n\n  // Unsubscribe handles for Firebase listeners\n  private _listeners: (() => void)[] = [];\n\n  // Callbacks\n  private _onPeerDiscovered: ((peerId: string, meta: PeerMetadata) => void)[] = [];\n  private _onPeerLeft: ((peerId: string) => void)[] = [];\n  private _onSignal: ((fromPeerId: string, data: unknown) => void)[] = [];\n  private _onLobby: ((rooms: RoomAnnouncement[]) => void)[] = [];\n\n  // State\n  private _knownPeers = new Set<string>();\n  private _lobbyAnnounceTimer: ReturnType<typeof setInterval> | null = null;\n  private _lastAnnouncement: RoomAnnouncement | null = null;\n  private _lobbyWired = false;\n  private _destroyed = false;\n\n  constructor(appId: string, config: FirebaseStrategyConfig) {\n    this.selfId = generatePeerId();\n    this._appId = appId;\n    this._config = config;\n  }\n\n  // ── Public API ──\n\n  async init(): Promise<void> {\n    return this._ensureInit();\n  }\n\n  async joinRoom(roomId: string, peerMeta: PeerMetadata): Promise<void> {\n    await this._ensureInit();\n    if (!this._db || !this._fb) throw new Error('Firebase not initialized');\n\n    // Bump generation so any in-flight leaveRoom from a prior call won't\n    // null out _roomId after we set it here (React StrictMode race fix).\n    this._joinGeneration++;\n\n    this._roomId = roomId;\n    this._peerMeta = peerMeta;\n    const { ref, set, onChildAdded, onChildRemoved, onDisconnect, onValue, remove } = this._fb;\n    const paths = firebasePaths(this._appId, roomId, this.selfId);\n\n    // Clean stale signals from our inbox before listening (prevents\n    // replaying SDP from a previous session that wasn't cleaned up).\n    await remove(ref(this._db, paths.peerSignalInbox)).catch(() => {});\n\n    // 1. Write presence with auto-cleanup on disconnect\n    const presenceRef = ref(this._db, paths.peerPresence);\n    await set(presenceRef, {\n      peerId: this.selfId,\n      meta: peerMeta,\n      ts: Date.now(),\n    });\n    onDisconnect(presenceRef).remove();\n\n    // 1b. Re-establish presence on EVERY reconnection to the RTDB. Firebase\n    // onDisconnect handlers fire only once and remove our presence node; the\n    // SDK does NOT re-create the value when it reconnects. Without this, a\n    // transient RTDB disconnect (tab backgrounding, network handoff, server\n    // recycling) permanently deletes our presence even though the P2P WebRTC\n    // links stay healthy — every other peer then sees onChildRemoved, tears\n    // down our connection, and the room fragments into isolated single-player\n    // sessions. Canonical presence pattern: re-arm onDisconnect BEFORE\n    // re-writing the value, on every transition to connected.\n    const generation = this._joinGeneration;\n    const connectedRef = ref(this._db, '.info/connected');\n    const connectedUnsub = onValue(connectedRef, (snap: any) => {\n      if (snap.val() !== true) return;\n      if (this._destroyed || this._joinGeneration !== generation || this._roomId !== roomId) return;\n      onDisconnect(presenceRef).remove()\n        .then(() => {\n          if (this._destroyed || this._joinGeneration !== generation || this._roomId !== roomId) return;\n          return set(presenceRef, { peerId: this.selfId, meta: peerMeta, ts: Date.now() });\n        })\n        .catch(() => {});\n    });\n    this._listeners.push(() => connectedUnsub());\n\n    // 2. Listen for peers joining\n    const peersRef = ref(this._db, paths.peers);\n    const addedUnsub = onChildAdded(peersRef, (snapshot: any) => {\n      const data = snapshot.val();\n      if (!data || data.peerId === this.selfId) return;\n      if (!this._knownPeers.has(data.peerId)) {\n        this._knownPeers.add(data.peerId);\n        for (const cb of this._onPeerDiscovered) cb(data.peerId, data.meta ?? {});\n      }\n    });\n    this._listeners.push(() => addedUnsub());\n\n    // 3. Listen for peers leaving\n    const removedUnsub = onChildRemoved(peersRef, (snapshot: any) => {\n      const data = snapshot.val();\n      const peerId = data?.peerId ?? snapshot.key;\n      if (peerId && this._knownPeers.has(peerId)) {\n        this._knownPeers.delete(peerId);\n        for (const cb of this._onPeerLeft) cb(peerId);\n      }\n    });\n    this._listeners.push(() => removedUnsub());\n\n    // 4. Listen for signals addressed to us\n    const signalRef = ref(this._db, paths.peerSignalInbox);\n    const signalUnsub = onChildAdded(signalRef, (snapshot: any) => {\n      const msg = snapshot.val();\n      if (!msg || msg.from === this.selfId) return;\n      for (const cb of this._onSignal) cb(msg.from, msg.data);\n      // Remove processed signal to keep the inbox clean\n      remove(snapshot.ref);\n    });\n    this._listeners.push(() => signalUnsub());\n  }\n\n  async leaveRoom(): Promise<void> {\n    if (!this._db || !this._fb || !this._roomId) return;\n\n    // Capture current state so async cleanup targets the correct room\n    // even if joinRoom() is called concurrently (React StrictMode).\n    const leavingRoomId = this._roomId;\n    const generation = this._joinGeneration;\n\n    const { ref, remove } = this._fb;\n    const paths = firebasePaths(this._appId, leavingRoomId, this.selfId);\n\n    // Detach listeners\n    for (const unsub of this._listeners) unsub();\n    this._listeners = [];\n\n    // Remove presence and signal inbox\n    await Promise.all([\n      remove(ref(this._db, paths.peerPresence)),\n      remove(ref(this._db, paths.peerSignalInbox)),\n    ]).catch(() => {});\n\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n\n    this._knownPeers.clear();\n\n    // Only null out _roomId if no new joinRoom() has run since we started.\n    // This prevents the StrictMode race: old leaveRoom completing after\n    // new joinRoom already set _roomId to the fresh value.\n    if (this._joinGeneration === generation) {\n      this._roomId = null;\n    }\n  }\n\n  signal(targetPeerId: string, data: unknown): void {\n    if (!this._db || !this._fb || !this._roomId) return;\n    const { ref, push } = this._fb;\n\n    // Atomic push: single operation writes the key + data together.\n    // Avoids the push() + set() two-step that can cause onChildAdded to\n    // fire with null if the listener catches the intermediate state.\n    const inboxPath = firebasePaths(this._appId, this._roomId, targetPeerId).peerSignalInbox;\n    push(ref(this._db, inboxPath), {\n      from: this.selfId,\n      data: sanitizeForFirebase(data),\n      ts: Date.now(),\n    });\n  }\n\n  subscribeToLobby(cb: (rooms: RoomAnnouncement[]) => void): () => void {\n    this._onLobby.push(cb);\n\n    // Wire the underlying RTDB listener exactly once — repeated subscribe/\n    // unsubscribe cycles (React StrictMode, route changes) must not stack\n    // duplicate onValue listeners.\n    if (this._lobbyWired) {\n      return () => {\n        removeFromArray(this._onLobby, cb);\n      };\n    }\n    this._lobbyWired = true;\n\n    this._ensureInit().then(() => {\n      if (!this._db || !this._fb || this._destroyed) return;\n      const { ref, onValue } = this._fb;\n      const paths = firebasePaths(this._appId, '', '');\n      const lobbyRef = ref(this._db, paths.lobby);\n\n      const unsub = onValue(lobbyRef, (snapshot: any) => {\n        const data = snapshot.val();\n        if (!data) {\n          for (const lcb of this._onLobby) lcb([]);\n          return;\n        }\n        const now = Date.now();\n        const rooms: RoomAnnouncement[] = Object.values(data).filter(\n          (r: any) => r && now - (r.lastSeen ?? 0) < ROOM_ANNOUNCE_EXPIRY_MS,\n        ) as RoomAnnouncement[];\n        for (const lcb of this._onLobby) lcb(rooms);\n      });\n      this._listeners.push(() => unsub());\n    });\n\n    return () => {\n      removeFromArray(this._onLobby, cb);\n    };\n  }\n\n  announceRoom(announcement: RoomAnnouncement): void {\n    if (!this._db || !this._fb) return;\n    const { ref, set } = this._fb;\n    const paths = firebasePaths(this._appId, announcement.roomId, '');\n\n    this._lastAnnouncement = announcement;\n    announcement.lastSeen = Date.now();\n    set(ref(this._db, paths.roomLobbyEntry), sanitizeForFirebase(announcement));\n\n    // Periodic heartbeat\n    if (this._lobbyAnnounceTimer) clearInterval(this._lobbyAnnounceTimer);\n    this._lobbyAnnounceTimer = setInterval(() => {\n      announcement.lastSeen = Date.now();\n      set(ref(this._db, paths.roomLobbyEntry), sanitizeForFirebase(announcement));\n    }, ROOM_ANNOUNCE_INTERVAL_MS);\n  }\n\n  updateRoomOccupancy(roomId: string, playerCount: number, state?: 'lobby' | 'playing' | 'ended'): void {\n    const ann = this._lastAnnouncement;\n    if (!ann || ann.roomId !== roomId || !this._db || !this._fb) return;\n    ann.playerCount = playerCount;\n    if (state) ann.state = state;\n    ann.lastSeen = Date.now();\n    const { ref, set } = this._fb;\n    const paths = firebasePaths(this._appId, roomId, '');\n    set(ref(this._db, paths.roomLobbyEntry), sanitizeForFirebase(ann));\n  }\n\n  removeRoomAnnouncement(roomId: string): void {\n    if (!this._db || !this._fb) return;\n    const { ref, remove } = this._fb;\n    remove(ref(this._db, firebasePaths(this._appId, roomId, '').roomLobbyEntry));\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n  }\n\n  onPeerDiscovered(cb: (peerId: string, meta: PeerMetadata) => void): () => void {\n    this._onPeerDiscovered.push(cb);\n    return () => { removeFromArray(this._onPeerDiscovered, cb); };\n  }\n\n  onPeerLeft(cb: (peerId: string) => void): () => void {\n    this._onPeerLeft.push(cb);\n    return () => { removeFromArray(this._onPeerLeft, cb); };\n  }\n\n  onSignal(cb: (fromPeerId: string, data: unknown) => void): () => void {\n    this._onSignal.push(cb);\n    return () => { removeFromArray(this._onSignal, cb); };\n  }\n\n  destroy(): void {\n    this._destroyed = true;\n    for (const unsub of this._listeners) unsub();\n    this._listeners = [];\n\n    if (this._lobbyAnnounceTimer) {\n      clearInterval(this._lobbyAnnounceTimer);\n      this._lobbyAnnounceTimer = null;\n    }\n\n    // Best-effort cleanup\n    if (this._db && this._fb && this._roomId) {\n      const { ref, remove } = this._fb;\n      const paths = firebasePaths(this._appId, this._roomId, this.selfId);\n      remove(ref(this._db, paths.peerPresence)).catch(() => {});\n      remove(ref(this._db, paths.peerSignalInbox)).catch(() => {});\n    }\n\n    // Delete own Firebase app if we created it\n    if (this._ownApp && this._firebaseApp) {\n      import('firebase/app').then(({ deleteApp }) => {\n        deleteApp(this._firebaseApp).catch(() => {});\n      });\n    }\n\n    this._db = null;\n    this._firebaseApp = null;\n    this._fb = null;\n    this._knownPeers.clear();\n    this._onPeerDiscovered = [];\n    this._onPeerLeft = [];\n    this._onSignal = [];\n    this._onLobby = [];\n  }\n\n  // ── Private ──\n\n  private _ensureInit(): Promise<void> {\n    if (!this._initPromise) {\n      this._initPromise = this._doInit();\n    }\n    return this._initPromise;\n  }\n\n  private async _doInit(): Promise<void> {\n    const { initializeApp, getApps } = await import('firebase/app');\n    const {\n      getDatabase,\n      ref,\n      set,\n      push,\n      remove,\n      onValue,\n      onChildAdded,\n      onChildRemoved,\n      onDisconnect,\n    } = await import('firebase/database');\n\n    this._fb = { ref, set, push, remove, onValue, onChildAdded, onChildRemoved, onDisconnect };\n\n    if (this._config.firebaseApp) {\n      this._firebaseApp = this._config.firebaseApp;\n      this._ownApp = false;\n    } else {\n      const appName = `carver_${this._appId}`;\n      const existing = getApps().find((a: any) => a.name === appName);\n      if (existing) {\n        this._firebaseApp = existing;\n        this._ownApp = false;\n      } else {\n        this._firebaseApp = initializeApp({ databaseURL: this._config.databaseURL }, appName);\n        this._ownApp = true;\n      }\n    }\n\n    this._db = getDatabase(this._firebaseApp);\n  }\n}\n\n/**\n * Firebase RTDB deletes any key whose value is `null` (treats null as \"remove\").\n * ICE candidates from `toJSON()` can contain `null` fields (e.g. usernameFragment).\n * We recursively replace `null` with a sentinel so Firebase preserves the key.\n * On the receiving end, `_handleSignal` doesn't need to reverse this because\n * `new RTCIceCandidate()` / `new RTCSessionDescription()` accept missing fields.\n */\nfunction sanitizeForFirebase(obj: unknown): unknown {\n  if (obj === null) return '__null__';\n  if (Array.isArray(obj)) return obj.map(sanitizeForFirebase);\n  if (typeof obj === 'object' && obj !== null) {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      if (value === undefined) continue; // RTDB rejects undefined anywhere in the payload\n      result[key] = value === null ? '__null__' : sanitizeForFirebase(value);\n    }\n    return result;\n  }\n  return obj;\n}\n"],"mappings":"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","names":[]}

package/dist/strategy.mjs

@@ -2,7 +2,7 @@ import {
   FirebaseStrategy,
   MqttStrategy,
   generatePeerId
-} from "./chunk-UD6FDZMX.mjs";
+} from "./chunk-GOTAQDBJ.mjs";
 export {
   FirebaseStrategy,
   MqttStrategy,

package/dist/sync.d.mts

@@ -1,6 +1,7 @@
-import { C as CarverTransport, d as Codec, S as SnapshotBuffer, E as EntityState, N as NetworkQuality, e as TickKeeper } from './NetworkManager-DrKM2tEx.mjs';
-export { f as EntityState2D, g as EntityState3D, h as EventPacket, I as InputPacket, i as SnapshotPacket, j as SyncMode } from './NetworkManager-DrKM2tEx.mjs';
-import './types-5LHBOW08.mjs';
+import { C as CarverTransport, e as Codec, S as SnapshotBuffer, E as EntityState, P as PlayerInput, N as NetworkQuality, f as SnapshotListener, g as SnapshotSource, h as TickKeeper, i as PredictionSyncOptions, j as PhysicsStepCallback, k as PredictionWorldDriver, l as ErrorOffset } from './NetworkManager-D-DxFgdM.mjs';
+export { m as EntityState2D, n as EntityState3D, o as EventPacket, I as InputPacket, p as SnapshotPacket, q as SyncMode } from './NetworkManager-D-DxFgdM.mjs';
+import { I as InputBuffer } from './InputBuffer-J6XT_Tt0.mjs';
+import './types-hNfCIBzj.mjs';
 
 /**
  * Layer 1: Event-based messaging over a reliable+ordered channel.
@@ -59,10 +60,11 @@ declare class HostAuthority {
     /**
      * Called every fixed tick by the sync engine.
      * Collects entity states and decides whether to broadcast.
+     * `hostInput` (prediction mode) is embedded in the snapshot packet as `hi`.
      */
-    tick(currentTick: number, entities: Map<string, EntityState>, delta: number): void;
+    tick(currentTick: number, entities: Map<string, EntityState>, delta: number, hostInput?: PlayerInput): void;
     /** Force a keyframe broadcast to all clients (e.g., after host migration) */
-    forceKeyframe(currentTick: number, entities: Map<string, EntityState>): void;
+    forceKeyframe(currentTick: number, entities: Map<string, EntityState>, hostInput?: PlayerInput): void;
     destroy(): void;
     private _broadcastToClient;
 }
@@ -87,6 +89,7 @@ declare class ClientReceiver {
     private _packetCount;
     private _is2D;
     private _fullState;
+    private _snapshotListeners;
     constructor(transport: CarverTransport, codec: Codec, options?: {
         bufferSize?: number;
         method?: "hermite" | "linear";
@@ -103,6 +106,8 @@ declare class ClientReceiver {
     interpolate(renderTime: number): Map<string, EntityState>;
     /** Request a keyframe from the host */
     requestKeyframe(): void;
+    /** Register a listener fired after each snapshot is merged into the full world state */
+    onSnapshot(cb: SnapshotListener): void;
     destroy(): void;
     private _handleSnapshot;
     private _interpolateEntity;
@@ -123,18 +128,21 @@ interface SnapshotSyncOptions {
  * Layer 2: Snapshot interpolation sync engine.
  * Host broadcasts state at fixed intervals, clients interpolate.
  */
-declare class SnapshotSync {
+declare class SnapshotSync implements SnapshotSource {
     private _transport;
     private _hostAuthority;
     private _clientReceiver;
     private _codec;
     private _snapshotBuffer;
+    private _snapshotListeners;
     constructor(transport: CarverTransport, codec: Codec, snapshotBuffer: SnapshotBuffer, options?: SnapshotSyncOptions);
     get isHost(): boolean;
     get hostAuthority(): HostAuthority | null;
     get clientReceiver(): ClientReceiver | null;
     /** Host: called every fixed tick to potentially broadcast state */
-    hostTick(tick: number, entities: Map<string, EntityState>, delta: number): void;
+    hostTick(tick: number, entities: Map<string, EntityState>, delta: number, hostInput?: PlayerInput): void;
+    /** Register a listener fired after each merged snapshot (client side). */
+    onSnapshot(cb: SnapshotListener): void;
     /** Client: called every render frame to interpolate */
     clientInterpolate(renderTime: number): Map<string, EntityState>;
     /** Set interest filter on host authority */
@@ -144,69 +152,145 @@ declare class SnapshotSync {
     /** Handle host migration: switch from host to client mode */
     demoteToClient(options?: SnapshotSyncOptions): void;
     destroy(): void;
+    /** Forward receiver snapshots to registered listeners (survives host migration). */
+    private _attachSnapshotForwarder;
 }
 
-interface PredictionOptions {
-    maxRewindTicks: number;
-    errorSmoothingDecay: number;
-    maxErrorPerFrame: number;
-    snapThreshold: number;
-    lagCompensation: boolean;
-}
 /**
- * Layer 3: Client-side prediction with server reconciliation.
- * Builds on top of Layer 2 (SnapshotSync).
+ * Layer 3: Full-world prediction with full-world rollback.
+ * Ported from LumberNet, built on top of Layer 2 (SnapshotSync) as the
+ * authoritative state channel.
  *
  * Flow:
- *   Client: input -> apply locally (predict) -> store in buffer -> send to host
- *   Host: receive input -> apply to simulation -> broadcast state + lastProcessedInputTick
- *   Client: receive state -> compare with prediction ->
- *           if mismatch: reset to server state + replay unacked inputs -> visual smoothing
+ *   Every peer (host included): broadcast tick-stamped input to ALL peers each
+ *   fixed tick on carver:inputs, simulate EVERY networked entity forward with
+ *   last-known remote inputs (hold-last-input extrapolation).
+ *
+ *   Host: stays authoritative; SnapshotSync broadcasts delta-compressed,
+ *   ACK-driven snapshots with the host's own input embedded (`hi`).
+ *
+ *   Client: on each accepted snapshot, reset ALL networked entities to server
+ *   state, resimulate from serverTick + 1 to localTick replaying per-tick
+ *   inputs for every peer, and convert the visual discontinuity into
+ *   per-entity error offsets decayed per render frame.
+ *
+ * Role is checked dynamically via transport.isHost at every use site (host
+ * migration is best-effort).
  */
+
 declare class PredictionSync {
     private _transport;
-    private _codec;
     private _tickKeeper;
     private _options;
     private _inputChannel;
-    private _stateChannel;
-    private _ackChannel;
-    private _inputBuffer;
-    private _clientLastProcessedTick;
-    private _predictedState;
-    private _errorCorrections;
-    private _serverState;
+    private _inputs;
+    private _currentInput;
+    private _pending;
+    private _errors;
     private _serverTick;
+    private _lastAppliedServerTick;
+    private _worldDriver;
     private _onPhysicsStep;
-    private _currentInput;
-    private _isHost;
-    constructor(transport: CarverTransport, codec: Codec, tickKeeper: TickKeeper, options?: Partial<PredictionOptions>);
-    /** Set the physics step callback (required for rollback re-simulation) */
-    setPhysicsStep(cb: (inputs: Map<string, unknown>, tick: number, isRollback: boolean) => void): void;
-    /** Set the current input for this tick (client-side) */
-    setInput(input: unknown): void;
+    constructor(transport: CarverTransport, tickKeeper: TickKeeper, snapshots: SnapshotSource, options?: PredictionSyncOptions);
+    /** Set the game simulation callback (forward sim + rollback resim). */
+    setPhysicsStep(cb: PhysicsStepCallback): void;
+    /** Set the world driver used for forward stepping and rollback. */
+    setWorldDriver(driver: PredictionWorldDriver): void;
+    /** Set the local player's input. PERSISTS across ticks until replaced. */
+    setInput(input: PlayerInput): void;
+    /** Local input stored at the given tick (neutral fallback). Used by the host to embed `hi`. */
+    getLocalInput(tick: number): PlayerInput;
     /**
-     * Called every fixed tick on the client.
-     * Applies input locally (prediction), buffers it, and sends to host.
+     * Apply the newest pending server snapshot (full-world rollback).
+     * Call once per render frame BEFORE tickKeeper.update().
+     * No-op on host or when nothing is pending.
      */
-    clientTick(tick: number): void;
+    beginFrame(): void;
     /**
-     * Called every fixed tick on the host.
-     * Processes received inputs and broadcasts authoritative state.
+     * Run one forward fixed tick (host AND client): store + broadcast input,
+     * build per-tick input maps, invoke the callback, then step the world.
      */
-    hostTick(tick: number, entities: Map<string, EntityState>, _delta: number): void;
+    tick(tick: number): void;
     /**
-     * Called every render frame on the client to apply visual error smoothing.
-     * Returns the corrected entity states.
+     * Decay stored error offsets and return the portion to ADD to rendered
+     * transforms this frame. Call exactly once per render frame.
      */
-    applyErrorSmoothing(entities: Map<string, EntityState>): Map<string, EntityState>;
-    get predictedState(): Map<string, EntityState>;
+    getRenderErrorOffsets(): Map<string, ErrorOffset>;
+    /** Tick of the newest RECEIVED snapshot. */
     get serverTick(): number;
+    /** Tick of the newest APPLIED (rolled-back) snapshot, 0 initially. */
+    get lastAppliedServerTick(): number;
     destroy(): void;
-    private _setupHostListeners;
-    private _setupClientListeners;
-    private _reconcile;
-    private _computeError;
 }
 
-export { EntityState, EventSync, PredictionSync, SnapshotSync, type SnapshotSyncOptions };
+/**
+ * Rollback — full-world rollback for prediction mode.
+ *
+ * Ported from LumberNet's LumberRollback, adapted to CarverJS entity state
+ * (2D and 3D). On each accepted server snapshot the client:
+ *   1. captures the pre-rollback visual pose (raw physics + accumulated error),
+ *   2. hard-applies server state to EVERY networked entity,
+ *   3. resimulates from serverTick + 1 to localTick replaying per-tick inputs
+ *      (or hard-snaps the tick when drift exceeds maxRewindTicks),
+ *   4. converts the visual discontinuity into per-entity error offsets.
+ *
+ * Pure module: no transport, no React, no three.js. Quaternion math is
+ * hand-rolled below.
+ */
+
+interface Quat {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+/** Hamilton product (a ⊗ b). */
+declare function quatMultiply(a: Quat, b: Quat): Quat;
+/** Conjugate (inputs assumed normalized). */
+declare function quatInvert(q: Quat): Quat;
+/** Normalize; degenerate (near-zero) quaternions return identity. */
+declare function quatNormalize(q: Quat): Quat;
+/** Rotation angle in radians: 2*acos(clamp(|w|, 0, 1)). */
+declare function quatAngle(q: Quat): number;
+/** Scale the rotation angle toward identity by `factor`, preserving the axis. */
+declare function quatScaleAngle(q: Quat, factor: number): Quat;
+interface RollbackParams {
+    /** Tick embedded in the accepted server snapshot. */
+    serverTick: number;
+    /** Authoritative full-world state from the snapshot. */
+    serverState: ReadonlyMap<string, EntityState>;
+    /** Client's current simulation tick. */
+    localTick: number;
+    /** This peer's id (local inputs are replayed from the local ring buffer). */
+    localPeerId: string;
+    /** Input buffer holding local and per-peer tick history. */
+    inputs: InputBuffer;
+    /** Currently accumulated visual error offsets (kept continuous across rollbacks). */
+    currentErrors: ReadonlyMap<string, ErrorOffset>;
+    /** World access for capture/apply/step. */
+    driver: PredictionWorldDriver;
+    /** Game physics-step callback, re-invoked during resimulation. */
+    callback: PhysicsStepCallback | null;
+    /** Fixed timestep in seconds. */
+    dt: number;
+    /** Snap target offset: snap target = serverTick + driftTargetTicks. */
+    driftTargetTicks: number;
+    /** Max |localTick - (serverTick + driftTargetTicks)| before hard tick snap. */
+    maxRewindTicks: number;
+    /** Per-axis positional jump above which correction is suppressed (teleport). */
+    snapThreshold: number;
+}
+interface RollbackResult {
+    /** New local tick (differs from localTick only when a hard snap occurred). */
+    newLocalTick: number;
+    snapped: boolean;
+    /** Per-entity visual error offsets (pre-visual minus post-resim). */
+    errors: Map<string, ErrorOffset>;
+}
+/**
+ * Apply a server snapshot to the whole world and resimulate forward.
+ * Returns the new local tick and per-entity visual error offsets.
+ */
+declare function applyRollback(params: RollbackParams): RollbackResult;
+
+export { EntityState, ErrorOffset, EventSync, PhysicsStepCallback, PlayerInput, PredictionSync, PredictionSyncOptions, PredictionWorldDriver, type Quat, type RollbackParams, type RollbackResult, SnapshotListener, SnapshotSource, SnapshotSync, type SnapshotSyncOptions, applyRollback, quatAngle, quatInvert, quatMultiply, quatNormalize, quatScaleAngle };