@colyseus/core 0.17.0 → 0.17.1

package/src/presence/Presence.ts

@@ -0,0 +1,263 @@
+import type { Room } from "../Room.ts";
+
+/**
+ * When you need to scale your server on multiple processes and/or machines, you'd need to provide
+ * the Presence option to the Server. The purpose of Presence is to allow communicating and
+ * sharing data between different processes, specially during match-making.
+ *
+ * - Local presence - This is the default option. It's meant to be used when you're running Colyseus in
+ *  a single process.
+ * - Redis presence - Use this option when you're running Colyseus on multiple processes and/or machines.
+ *
+ * @default Local presence
+ */
+export interface Presence {
+    /**
+     * Subscribes to the given topic. The callback will be triggered whenever a message is published on topic.
+     *
+     * @param topic - Topic name.
+     * @param callback - Callback to trigger on subscribing.
+     */
+    subscribe(topic: string, callback: Function): Promise<this>;
+
+    /**
+     * Unsubscribe from given topic.
+     *
+     * @param topic - Topic name.
+     * @param callback - Callback to trigger on topic unsubscribing.
+     */
+    unsubscribe(topic: string, callback?: Function);
+
+    /**
+     * Lists the currently active channels / subscriptions
+     * @param pattern
+     */
+    channels(pattern?: string): Promise<string[]>;
+
+    /**
+     * Posts a message to given topic.
+     *
+     * @param topic - Topic name.
+     * @param data - Message body/object.
+     */
+    publish(topic: string, data: any);
+
+    /**
+     * Returns if key exists.
+     *
+     * @param key
+     */
+    exists(key: string): Promise<boolean>;
+
+    /**
+     * Set key to hold the string value.
+     *
+     * @param key - Identifier.
+     * @param value - Message body/object.
+     */
+    set(key: string, value: string);
+
+    /**
+     * Set key to hold the string value and set key to timeout after a given number of seconds.
+     *
+     * @param key - Identifier.
+     * @param value - Message body/object.
+     * @param seconds - Timeout value.
+     */
+    setex(key: string, value: string, seconds: number);
+
+    /**
+     * Expire the key in seconds.
+     *
+     * @param key - Identifier.
+     * @param seconds - Seconds to expire the key.
+     */
+    expire(key: string, seconds: number);
+
+    /**
+     * Get the value of key.
+     *
+     * @param key - Identifier.
+     */
+    get(key: string);
+
+    /**
+     * Removes the specified key.
+     *
+     * @param key - Identifier of the object to removed.
+     */
+    del(key: string): void;
+
+    /**
+     * Add the specified members to the set stored at key. Specified members that are already
+     * a member of this set are ignored. If key does not exist, a new set is created before
+     * adding the specified members.
+     *
+     * @param key - Name/Identifier of the set.
+     * @param value - Message body/object.
+     */
+    sadd(key: string, value: any);
+
+    /**
+     * Returns all the members of the set value stored at key.
+     *
+     * @param key - Name/Identifier of the set.
+     */
+    smembers(key: string): Promise<string[]>;
+
+    /**
+     * Returns if member is a member of the set stored at key.
+     *
+     * @param key - Name/Identifier of the set.
+     * @param field - Key value within the set.
+     * @returns `1` if the element is a member of the set else `0`.
+     */
+    sismember(key: string, field: string);
+
+    /**
+     * Remove the specified members from the set stored at key. Specified members that are not a
+     * member of this set are ignored. If key does not exist, it is treated as an empty set
+     * and this command returns 0.
+     *
+     * @param key -  Name/Identifier of the set.
+     * @param value - Key value within the set.
+     */
+    srem(key: string, value: any);
+
+    /**
+     * Returns the set cardinality (number of elements) of the set stored at key.
+     *
+     * @param key -  Name/Identifier of the set.
+     */
+    scard(key: string);
+
+    /**
+     * Returns the members of the set resulting from the intersection of all the given sets.
+     *
+     * @param keys - Key values within the set.
+     */
+    sinter(...keys: string[]): Promise<string[]>;
+
+    /**
+     * Sets field in the hash stored at key to value. If key does not exist, a new key holding a hash is created.
+     * If field already exists in the hash, it is overwritten.
+     */
+    hset(key: string, field: string, value: string): Promise<boolean>;
+
+    /**
+     * Increments the number stored at field in the hash stored at key by increment. If key does not exist, a new key
+     * holding a hash is created. If field does not exist the value is set to 0 before the operation is performed.
+     */
+    hincrby(key: string, field: string, value: number): Promise<number>;
+
+    /**
+     * WARNING: DO NOT USE THIS METHOD. It is meant for internal use only.
+     * @private
+     */
+    hincrbyex(key: string, field: string, value: number, expireInSeconds: number): Promise<number>;
+
+    /**
+     * Returns the value associated with field in the hash stored at key.
+     */
+    hget(key: string, field: string): Promise<string | null>;
+
+    /**
+     * Returns all fields and values of the hash stored at key.
+     */
+    hgetall(key: string): Promise<{ [key: string]: string }>;
+
+    /**
+     * Removes the specified fields from the hash stored at key. Specified fields that do not exist within
+     * this hash are ignored. If key does not exist, it is treated as an empty hash and this command returns 0.
+     */
+    hdel(key: string, field: string): Promise<boolean>;
+
+    /**
+     * Returns the number of fields contained in the hash stored at key
+     */
+    hlen(key: string): Promise<number>;
+
+    /**
+     * Increments the number stored at key by one. If the key does not exist, it is set to 0 before performing
+     * the operation. An error is returned if the key contains a value of the wrong type or
+     * contains a string that can not be represented as integer. This operation is limited to 64-bit signed integers.
+     */
+    incr(key: string): Promise<number>;
+
+    /**
+     * Decrements the number stored at key by one. If the key does not exist, it is set to 0 before performing
+     * the operation. An error is returned if the key contains a value of the wrong type or contains a string
+     * that can not be represented as integer. This operation is limited to 64-bit signed integers.
+     */
+    decr(key: string): Promise<number>;
+
+    /**
+     * Returns the length of the list stored at key.
+     */
+    llen(key: string): Promise<number>;
+
+    /**
+     * Adds the string value to the end of the list stored at key. If key does not exist, it is created as empty list before performing the push operation.
+     */
+    rpush(key: string, ...values: string[]): Promise<number>;
+
+    /**
+     * Adds the string value to the begginning of the list stored at key. If key does not exist, it is created as empty list before performing the push operation.
+     */
+    lpush(key: string, ...values: string[]): Promise<number>;
+
+    /**
+     * Removes and returns the last element of the list stored at key.
+     */
+    rpop(key: string): Promise<string | null>;
+
+    /**
+     * Removes and returns the first element of the list stored at key.
+     */
+    lpop(key: string): Promise<string | null>;
+
+    /**
+     * Removes and returns the last element of the list stored at key. If the list is empty, the execution is halted until an element is available or the timeout is reached.
+     */
+    brpop(...args: [...keys: string[], timeoutInSeconds: number]): Promise<[string, string] | null>;
+
+    setMaxListeners(number: number): void;
+
+    shutdown(): void;
+}
+
+export function createScopedPresence(room: Room, presence: Presence): Presence {
+  // Keep a local copy of all subscriptions made through this scoped presence
+  const subscriptions: Array<{ topic: string; callback: Function }> = [];
+
+  // Create a copy of the presence object
+  const scopedPresence = Object.create(presence) as Presence;
+
+  // Override subscribe method to track subscriptions
+  scopedPresence.subscribe = async function (topic: string, callback: Function): Promise<Presence> {
+    subscriptions.push({ topic, callback });
+    await presence.subscribe(topic, callback);
+    return scopedPresence;
+  };
+
+  // Override unsubscribe method to remove from tracking
+  scopedPresence.unsubscribe = function (topic: string, callback?: Function) {
+    const index = subscriptions.findIndex(
+      (sub) => sub.topic === topic && (!callback || sub.callback === callback)
+    );
+    if (index !== -1) {
+      subscriptions.splice(index, 1);
+    }
+    presence.unsubscribe(topic, callback);
+  };
+
+  // Clean up all subscriptions when the room is disposed
+  room['_events'].on('dispose', () => {
+    for (const { topic, callback } of subscriptions) {
+      presence.unsubscribe(topic, callback);
+    }
+    subscriptions.length = 0;
+  });
+
+  return scopedPresence;
+}

package/src/rooms/LobbyRoom.ts

@@ -0,0 +1,135 @@
+
+import * as matchMaker from '../MatchMaker.ts';
+import type { IRoomCache } from '../matchmaker/LocalDriver/LocalDriver.ts';
+import type { Client } from '../Transport.ts';
+import { subscribeLobby } from '../matchmaker/Lobby.ts';
+import { Room } from '../Room.ts';
+
+// TODO: use Schema state & filters on version 1.0.0
+
+// class DummyLobbyState extends Schema { // tslint:disable-line
+//   @type("number") public _: number;
+// }
+
+export interface FilterInput {
+  name?: string;
+  metadata?: any;
+}
+
+export interface LobbyOptions {
+  filter?: FilterInput;
+}
+
+export class LobbyRoom extends Room {
+  public rooms: IRoomCache[] = [];
+  public unsubscribeLobby: () => void;
+
+  public clientOptions: { [sessionId: string]: LobbyOptions } = {};
+
+  public async onCreate(options: any) {
+    // prevent LobbyRoom to notify itself
+    this['_listing'].unlisted = true;
+
+    this.unsubscribeLobby = await subscribeLobby((roomId, data) => {
+      const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);
+      const clients = this.clients.filter((client) => this.clientOptions[client.sessionId]);
+
+      if (!data) {
+        // remove room listing data
+        if (roomIndex !== -1) {
+          const previousData = this.rooms[roomIndex];
+
+          this.rooms.splice(roomIndex, 1);
+
+          clients.forEach((client) => {
+            if (this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter)) {
+              client.send('-', roomId);
+            }
+          });
+        }
+
+      } else if (roomIndex === -1) {
+        // append room listing data
+        this.rooms.push(data);
+
+        clients.forEach((client) => {
+          if (this.filterItemForClient(data, this.clientOptions[client.sessionId].filter)) {
+            client.send('+', [roomId, data]);
+          }
+        });
+
+      } else {
+        const previousData = this.rooms[roomIndex];
+
+        // replace room listing data
+        this.rooms[roomIndex] = data;
+
+        clients.forEach((client) => {
+          const hadData = this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter);
+          const hasData = this.filterItemForClient(data, this.clientOptions[client.sessionId].filter);
+
+          if (hadData && !hasData) {
+            client.send('-', roomId);
+
+          } else if (hasData) {
+            client.send('+', [roomId, data]);
+          }
+        });
+      }
+    });
+
+    this.rooms = await matchMaker.query({ private: false, unlisted: false });
+
+    this.onMessage('filter', (client: Client, filter: FilterInput) => {
+      this.clientOptions[client.sessionId].filter = filter;
+      client.send('rooms', this.filterItemsForClient(this.clientOptions[client.sessionId]));
+    });
+  }
+
+  public onJoin(client: Client, options: LobbyOptions) {
+    this.clientOptions[client.sessionId] = options || {};
+    client.send('rooms', this.filterItemsForClient(this.clientOptions[client.sessionId]));
+  }
+
+  public onLeave(client: Client) {
+    delete this.clientOptions[client.sessionId];
+  }
+
+  public onDispose() {
+    if (this.unsubscribeLobby) {
+      this.unsubscribeLobby();
+    }
+  }
+
+  protected filterItemsForClient(options: LobbyOptions) {
+    const filter = options.filter;
+
+    return (filter)
+      ? this.rooms.filter((room) => this.filterItemForClient(room, filter))
+      : this.rooms;
+  }
+
+  protected filterItemForClient(room: IRoomCache, filter?: LobbyOptions['filter']) {
+    if (!filter) {
+      return true;
+    }
+
+    let isAllowed = true;
+
+    if (filter.name !== room.name) {
+      isAllowed = false;
+    }
+
+    if (filter.metadata) {
+      for (const field in filter.metadata) {
+        if (room.metadata[field] !== filter.metadata[field]) {
+          isAllowed = false;
+          break;
+        }
+      }
+    }
+
+    return isAllowed;
+  }
+
+}