@dotrino/lobby 0.1.5 → 0.3.0

package/README.md

@@ -1,5 +1,7 @@
 # @dotrino/lobby
 
+> **Parte del ecosistema [Dotrino](https://dotrino.com).** Dotrino es un ecosistema de aplicaciones centradas en la privacidad de los datos: tu información es tuya, y las decisiones sobre ella también — qué compartes, con quién, cuándo y por qué. Sin anuncios, sin cookies, sin rastreo de datos, sin vender tu identidad a nadie.
+
 **Lobby + matchmaking reciclable para cualquier juego del ecosistema Dotrino.**
 
 Resuelve, una sola vez y para todos los juegos, lo que el ajedrez, el chat y

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/lobby",
-  "version": "0.1.5",
+  "version": "0.3.0",
   "description": "Lobby + matchmaking reciclable para juegos del ecosistema Dotrino: salas, asientos, espectadores, motor de turnos autoritativo, reputación y contactos sobre el proxy/identity/reputation compartidos",
   "type": "module",
   "main": "src/index.js",
@@ -36,7 +36,9 @@
     "@dotrino/reputation": ">=0.3.0"
   },
   "peerDependenciesMeta": {
-    "@dotrino/reputation": { "optional": true }
+    "@dotrino/reputation": {
+      "optional": true
+    }
   },
   "author": "seyacat",
   "license": "MIT",

package/src/index.js

@@ -11,5 +11,5 @@ export {
   createRepGate, rankRooms, ratePlayer,
   receiptPayload, signReceiptHalf
 } from './reputation.js'
-export { K, discoveryChannel, roomChannel, envelope, parseEnvelope } from './protocol.js'
+export { K, discoveryChannel, roomChannel, setLobbyHomeNode, envelope, parseEnvelope } from './protocol.js'
 export { Emitter, mulberry32, hashSeed, shuffle, normalizeSeats, samePubkey } from './util.js'

package/src/protocol.js

@@ -46,10 +46,51 @@ export const K = {
   PONG: 'pong'              // { ts }
 }
 
-/** Canal de descubrimiento de salas de un juego (lista tokens de hosts). */
-export const discoveryChannel = (gameId) => `cclobby/${gameId}`
-/** Canal de presencia de una sala concreta (host + guests publican aquí). */
-export const roomChannel = (gameId, roomId) => `ccroom/${gameId}/${roomId}`
+/**
+ * NODO DUEÑO DE LOS CANALES.
+ *
+ * Un canal del proxio puede llevar delante el prefijo del nodo que lo hospeda
+ * (`<id de 12>/loquesea`). Ese nodo guarda la membresía y los demás le pasan las
+ * operaciones. Sin prefijo, cada proxio tiene su propia copia del canal — que es
+ * lo que hacía que dos personas en proxios distintos NO se vieran en la misma
+ * lista de salas, aunque los mensajes entre ellas sí cruzaran.
+ *
+ * El **canal de descubrimiento** es uno solo para todo el ecosistema, así que
+ * tiene que vivir en un nodo fijo: si cada quien lo publicara en el suyo,
+ * habría tantas listas de salas como proxios. Se fija con `setLobbyHomeNode()`
+ * pasándole el id del proxio elegido (se lee de `client.node`). Mientras no se
+ * fije, el descubrimiento es local a cada proxio.
+ */
+const NODE_ID_LEN = 12
+const isNodeId = (s) => new RegExp(`^[1-9A-Z]{${NODE_ID_LEN}}$`).test(String(s || ''))
+
+// Sin valor por defecto: el id de un proxio se DERIVA de su llave, así que no
+// hay ninguno que se pueda escribir aquí de antemano. Mientras no se fije, el
+// canal de descubrimiento es local a cada proxio (comportamiento de siempre).
+let LOBBY_HOME_NODE = null
+
+/** Fija en qué proxio vive el canal de descubrimiento de salas. */
+export function setLobbyHomeNode (nodeId) {
+  LOBBY_HOME_NODE = isNodeId(nodeId) ? nodeId : null
+}
+
+const withNode = (prefix, name) => (prefix ? `${prefix}/${name}` : name)
+
+/** Canal de descubrimiento de salas de un juego (lista instancias de hosts). */
+export const discoveryChannel = (gameId) => withNode(LOBBY_HOME_NODE, `cclobby/${gameId}`)
+
+/**
+ * Canal de presencia de una sala concreta (host + guests publican aquí).
+ *
+ * Vive en el proxio DEL HOST, que se lee del propio `roomId`: el roomId es la
+ * instancia del host y las instancias llevan delante el prefijo de su nodo. Así
+ * la sala se hospeda donde está quien la abrió, sin que nadie tenga que
+ * declararlo ni acordarlo.
+ */
+export const roomChannel = (gameId, roomId) => {
+  const id = String(roomId || '').slice(0, NODE_ID_LEN)
+  return withNode(isNodeId(id) ? id : null, `ccroom/${gameId}/${roomId}`)
+}
 
 /**
  * Construye un sobre.