@colyseus/core 0.18.15 → 0.18.17

package/src/matchmaker/driver.ts

@@ -186,6 +186,18 @@ export interface MatchMakerDriver {
    */
   persist(room: IRoomCache, create?: boolean): Promise<boolean> | boolean;
 
+  /**
+   * Record a room, unless its `roomId` is already recorded. Must be atomic, and
+   * must return false rather than throwing when the `roomId` is taken.
+   *
+   * Matchmaking uses this to settle which process owns a room when one create
+   * request is answered twice. Drivers that don't implement it fall back to
+   * `persist(room, true)`, where the second write silently wins.
+   *
+   * TODO: required on 1.0, replacing `persist()`'s `create` flag.
+   */
+  insert?(room: IRoomCache): Promise<boolean>;
+
   /**
    * Empty the room cache. Used for testing purposes only.
    * May be asynchronous — callers must await it.

package/src/presence/LocalPresence.ts

@@ -107,6 +107,8 @@ export class LocalPresence implements Presence {
     }
 
     public del(key: string) {
+        clearTimeout(this.timeouts[key]); // a pending expiry would wipe whatever is set next
+        delete this.timeouts[key];
         delete this.keys[key];
         delete this.data[key];
         delete this.hash[key];

package/src/utils/DevMode.ts

@@ -3,7 +3,7 @@ import path from 'path';
 import { type Schema, MapSchema, ArraySchema, SetSchema, CollectionSchema, $childType, $changes } from '@colyseus/schema';
 import { logger } from '../Logger.ts';
 import { debugAndPrintError, debugDevMode } from '../Debug.ts';
-import { getLocalRoomById, handleCreateRoom, presence, remoteRoomCall } from '../MatchMaker.ts';
+import { getLocalRoomById, handleCreateRoom, MatchMakerState, presence, remoteRoomCall, state } from '../MatchMaker.ts';
 import type { Room } from '../Room.ts';
 
 const DEVMODE_CACHE_FILE_PATH = path.resolve(".devmode.json");
@@ -49,6 +49,9 @@ export async function reloadFromCache() {
       recreatedRoom = getLocalRoomById(recreatedRoomListing.roomId);
 
     } catch (e: any) {
+      // shutdown interrupted the restore: keep the remaining entries for the next boot
+      if (state === MatchMakerState.SHUTTING_DOWN) { break; }
+
       // unrestorable entry (e.g. room type renamed/removed) — drop it
       // instead of wedging the boot
       debugAndPrintError(`❌ couldn't restore room '${roomId}':\n${e.stack}`);

package/src/utils/Utils.ts

@@ -44,6 +44,12 @@ export type RemoteRoomCallReturn<
 export const REMOTE_ROOM_SHORT_TIMEOUT = Number(process.env.COLYSEUS_PRESENCE_SHORT_TIMEOUT || 2000);
 export const MAX_CONCURRENT_CREATE_ROOM_WAIT_TIME = Number(process.env.COLYSEUS_MAX_CONCURRENT_CREATE_ROOM_WAIT_TIME || 0.5);
 
+// a peer that removes this process's room listings leaves a receipt. this
+// process looks for it every INTERVAL (ms) and restores them. the TTL (seconds)
+// only bounds what dead processes leave behind.
+export const SWEPT_CHECK_INTERVAL = Number(process.env.COLYSEUS_SWEPT_CHECK_INTERVAL || 5000);
+export const SWEPT_RECEIPT_TTL = Number(process.env.COLYSEUS_SWEPT_RECEIPT_TTL || 600);
+
 /**
  * The well-known `Symbol.metadata` (TC39 decorator metadata), falling back to the
  * registered symbol on runtimes that don't expose it globally yet. `@colyseus/schema`