xonecode 0.35.0 → 0.36.3

package/node_modules/@xone/xonecode-remoto/dist/servidor/salas.d.ts

@@ -0,0 +1,46 @@
+import { type SobreDelServidor } from "../index.js";
+export interface Topes {
+    movilesPorSala: number;
+    bytesPorMensaje: number;
+    /** Ritmo sostenido de un MÓVIL (y de toda conexión antes de su primer mensaje). */
+    mensajesPorMinuto: number;
+    /**
+     * Ritmo sostenido de un ANFITRIÓN. xonecode manda una `sustitucion` cada 80 ms mientras el modelo
+     * escribe (unas 750 por minuto, hasta el doble con razonamiento): con el tope del móvil se cortaría.
+     */
+    mensajesPorMinutoAnfitrion: number;
+    graciaMs: number;
+}
+export declare const TOPES_POR_OMISION: Topes;
+type Enviar = (sobre: SobreDelServidor) => void;
+/** Salas en memoria: empareja y enruta. No sabe nada de lo que va dentro de `carga`. */
+export declare class Salas {
+    private readonly topes;
+    private readonly ahora;
+    private readonly nuevoId;
+    private readonly salas;
+    constructor(topes: Topes, ahora?: () => number, nuevoId?: () => string);
+    /** Todo envío pasa por aquí: un socket roto no puede cortar un bucle ni dejar una sala sin borrar. */
+    private emitir;
+    existe(sala: string): boolean;
+    /**
+     * Supuesto: no hay prueba de identidad del anfitrión durante la gracia. El id de sala solo lo
+     * conocen el relé y quien tiene la URL de la sesión, que ya controla la sesión por diseño; el
+     * cifrado extremo a extremo impide leer o falsificar nada. Lo peor es una denegación de servicio
+     * durante la gracia.
+     */
+    abrir(sala: string, enviar: Enviar): boolean;
+    entrar(sala: string, enviar: Enviar): string | undefined;
+    salir(sala: string, id: string): void;
+    datoDelAnfitrion(sala: string, para: string | undefined, carga: string): void;
+    /** Solo de un móvil que SIGUE en la sala: uno de una sala ya cerrada no llega a quien reabra el mismo id. */
+    datoDelMovil(sala: string, id: string, carga: string): void;
+    /** Solo vale si `enviar` es el anfitrión actual: el cierre tardío de uno viejo no echa al nuevo. */
+    anfitrionCaido(sala: string, enviar: Enviar): void;
+    /** Cierre pedido por el anfitrión actual; con otro `enviar` no hace nada. */
+    cerrar(sala: string, enviar: Enviar): void;
+    private expulsar;
+    /** Cierra las salas cuyo anfitrión lleva caído más que la gracia. Se llama periódicamente. */
+    barrer(): void;
+}
+export {};

package/node_modules/@xone/xonecode-remoto/dist/servidor/salas.js

@@ -0,0 +1,128 @@
+import { TOPE_DE_SOBRE } from "../index.js";
+export const TOPES_POR_OMISION = {
+    movilesPorSala: 5,
+    bytesPorMensaje: TOPE_DE_SOBRE,
+    mensajesPorMinuto: 600,
+    mensajesPorMinutoAnfitrion: 6000,
+    graciaMs: 300_000,
+};
+/** Salas en memoria: empareja y enruta. No sabe nada de lo que va dentro de `carga`. */
+export class Salas {
+    topes;
+    ahora;
+    nuevoId;
+    salas = new Map();
+    constructor(topes, ahora = Date.now, nuevoId = () => crypto.randomUUID()) {
+        this.topes = topes;
+        this.ahora = ahora;
+        this.nuevoId = nuevoId;
+    }
+    /** Todo envío pasa por aquí: un socket roto no puede cortar un bucle ni dejar una sala sin borrar. */
+    emitir(enviar, sobre) {
+        if (enviar === undefined)
+            return;
+        try {
+            enviar(sobre);
+        }
+        catch {
+            // se ignora: la conexión rota la limpia su propio cierre
+        }
+    }
+    existe(sala) {
+        return this.salas.has(sala);
+    }
+    /**
+     * Supuesto: no hay prueba de identidad del anfitrión durante la gracia. El id de sala solo lo
+     * conocen el relé y quien tiene la URL de la sesión, que ya controla la sesión por diseño; el
+     * cifrado extremo a extremo impide leer o falsificar nada. Lo peor es una denegación de servicio
+     * durante la gracia.
+     */
+    abrir(sala, enviar) {
+        const existente = this.salas.get(sala);
+        if (existente !== undefined && existente.anfitrion !== undefined) {
+            this.emitir(enviar, { t: "error", motivo: "sala-ocupada" });
+            return false;
+        }
+        const s = existente ?? { anfitrion: undefined, caidoDesde: undefined, moviles: new Map() };
+        s.anfitrion = enviar;
+        s.caidoDesde = undefined;
+        this.salas.set(sala, s);
+        this.emitir(enviar, { t: "abierta" });
+        if (s.moviles.size > 0) {
+            this.emitir(enviar, { t: "presencia", moviles: [...s.moviles.keys()] });
+            for (const movil of s.moviles.values())
+                this.emitir(movil, { t: "anfitrion", conectado: true });
+        }
+        return true;
+    }
+    entrar(sala, enviar) {
+        const s = this.salas.get(sala);
+        if (s === undefined) {
+            this.emitir(enviar, { t: "error", motivo: "sala-inexistente" });
+            return undefined;
+        }
+        if (s.moviles.size >= this.topes.movilesPorSala) {
+            this.emitir(enviar, { t: "error", motivo: "tope-de-moviles" });
+            return undefined;
+        }
+        const id = this.nuevoId();
+        s.moviles.set(id, enviar);
+        this.emitir(enviar, { t: "entrada", id });
+        this.emitir(enviar, { t: "anfitrion", conectado: s.anfitrion !== undefined });
+        this.emitir(s.anfitrion, { t: "presencia", moviles: [...s.moviles.keys()] });
+        return id;
+    }
+    salir(sala, id) {
+        const s = this.salas.get(sala);
+        if (s === undefined || !s.moviles.delete(id))
+            return;
+        this.emitir(s.anfitrion, { t: "presencia", moviles: [...s.moviles.keys()] });
+    }
+    datoDelAnfitrion(sala, para, carga) {
+        const s = this.salas.get(sala);
+        if (s === undefined)
+            return;
+        if (para !== undefined) {
+            this.emitir(s.moviles.get(para), { t: "dato", carga });
+            return;
+        }
+        for (const movil of s.moviles.values())
+            this.emitir(movil, { t: "dato", carga });
+    }
+    /** Solo de un móvil que SIGUE en la sala: uno de una sala ya cerrada no llega a quien reabra el mismo id. */
+    datoDelMovil(sala, id, carga) {
+        const s = this.salas.get(sala);
+        if (s === undefined || !s.moviles.has(id))
+            return;
+        this.emitir(s.anfitrion, { t: "dato", de: id, carga });
+    }
+    /** Solo vale si `enviar` es el anfitrión actual: el cierre tardío de uno viejo no echa al nuevo. */
+    anfitrionCaido(sala, enviar) {
+        const s = this.salas.get(sala);
+        if (s === undefined || s.anfitrion !== enviar)
+            return;
+        s.anfitrion = undefined;
+        s.caidoDesde = this.ahora();
+        for (const movil of s.moviles.values())
+            this.emitir(movil, { t: "anfitrion", conectado: false });
+    }
+    /** Cierre pedido por el anfitrión actual; con otro `enviar` no hace nada. */
+    cerrar(sala, enviar) {
+        const s = this.salas.get(sala);
+        if (s === undefined || s.anfitrion !== enviar)
+            return;
+        this.expulsar(sala, s);
+    }
+    expulsar(sala, s) {
+        for (const movil of s.moviles.values())
+            this.emitir(movil, { t: "cerrada" });
+        this.salas.delete(sala);
+    }
+    /** Cierra las salas cuyo anfitrión lleva caído más que la gracia. Se llama periódicamente. */
+    barrer() {
+        for (const [sala, s] of this.salas) {
+            if (s.caidoDesde !== undefined && this.ahora() - s.caidoDesde > this.topes.graciaMs)
+                this.expulsar(sala, s);
+        }
+    }
+}

package/node_modules/@xone/xonecode-remoto/dist/servidor/servidor.d.ts

@@ -0,0 +1,31 @@
+import { type Topes } from "./salas.js";
+export interface OpcionesDelServidor {
+    puerto: number;
+    /** Dirección de escucha; por omisión solo loopback. */
+    host?: string;
+    /** La web móvil; por omisión la que viaja en el paquete (`web/`, relativa a este módulo). */
+    carpetaWeb?: string;
+    topes?: Topes;
+    /** Periodo del barrido y del ping de latido; por omisión 10 s. */
+    latidoMs?: number;
+    /** Plazo para el primer `abrir`/`entrar` válido; por omisión `PLAZO_PRIMER_MENSAJE_MS`. */
+    plazoPrimerMensajeMs?: number;
+    /** El reloj (ms) del ritmo y de la gracia de las salas; por omisión `Date.now`. Solo para los tests. */
+    ahora?: () => number;
+}
+/**
+ * Un cubo de fichas por conexión: cabe un minuto de ritmo y se rellena a ese ritmo, sin ventanas
+ * fijas que dejen pasar el doble a caballo del cambio de minuto. El tope lo da el papel de la
+ * conexión en cada mensaje, así que al pasar a anfitrión se rellena a su ritmo.
+ */
+export declare function crearCubo(ahora: () => number, inicial: number): {
+    /** Gasta una ficha si la hay; `false` es que se ha pasado del ritmo. */
+    gastar(porMinuto: number): boolean;
+};
+export declare const PLAZO_PRIMER_MENSAJE_MS = 10000;
+export interface ServidorEnMarcha {
+    urlHttp: string;
+    urlWs: string;
+    cerrar(): Promise<void>;
+}
+export declare function arrancarServidor(opciones: OpcionesDelServidor): Promise<ServidorEnMarcha>;

package/node_modules/@xone/xonecode-remoto/dist/servidor/servidor.js

@@ -0,0 +1,198 @@
+import { createServer } from "node:http";
+import { readFile } from "node:fs/promises";
+import { extname, join, normalize } from "node:path";
+import { fileURLToPath } from "node:url";
+import { WebSocketServer } from "ws";
+import { FORMA_DE_SALA, VERSION_DEL_PROTOCOLO, interpretarSobre } from "../index.js";
+import { Salas, TOPES_POR_OMISION } from "./salas.js";
+/** `dist/servidor/` y `src/servidor/` están a la misma profundidad de `web/`, que `npm run build` copia de la web. */
+const CARPETA_WEB_DEL_PAQUETE = fileURLToPath(new URL("../../web/", import.meta.url));
+/**
+ * Un cubo de fichas por conexión: cabe un minuto de ritmo y se rellena a ese ritmo, sin ventanas
+ * fijas que dejen pasar el doble a caballo del cambio de minuto. El tope lo da el papel de la
+ * conexión en cada mensaje, así que al pasar a anfitrión se rellena a su ritmo.
+ */
+export function crearCubo(ahora, inicial) {
+    let fichas = inicial;
+    let desde = ahora();
+    return {
+        /** Gasta una ficha si la hay; `false` es que se ha pasado del ritmo. */
+        gastar(porMinuto) {
+            const t = ahora();
+            fichas = Math.min(porMinuto, fichas + (Math.max(0, t - desde) * porMinuto) / 60_000);
+            desde = t;
+            if (fichas < 1)
+                return false;
+            fichas -= 1;
+            return true;
+        },
+    };
+}
+export const PLAZO_PRIMER_MENSAJE_MS = 10_000;
+const TIPOS = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".woff2": "font/woff2",
+    ".json": "application/json",
+};
+async function servirEstatico(carpeta, peticion, respuesta) {
+    const ruta = new URL(peticion.url ?? "/", "http://x").pathname;
+    if (ruta === "/salud") {
+        respuesta.writeHead(200, { "content-type": "text/plain" }).end("ok");
+        return;
+    }
+    // Toda URL de sesión sirve la misma página: la sala la lee la web, el secreto está en el fragmento.
+    const relativa = ruta === "/" || ruta.startsWith("/r/") ? "index.html" : normalize(ruta).replace(/^(\.\.[/\\])+/, "").replace(/^[/\\]+/, "");
+    try {
+        const cuerpo = await readFile(join(carpeta, relativa));
+        respuesta.writeHead(200, {
+            "content-type": TIPOS[extname(relativa)] ?? "application/octet-stream",
+            "x-content-type-options": "nosniff",
+            "referrer-policy": "no-referrer",
+            ...(relativa === "index.html" ? { "cache-control": "no-store" } : {}),
+        });
+        respuesta.end(cuerpo);
+    }
+    catch {
+        respuesta.writeHead(404).end();
+    }
+}
+export async function arrancarServidor(opciones) {
+    const topes = opciones.topes ?? TOPES_POR_OMISION;
+    const ahora = opciones.ahora ?? Date.now;
+    const salas = new Salas(topes, ahora);
+    const carpetaWeb = opciones.carpetaWeb ?? CARPETA_WEB_DEL_PAQUETE;
+    const http = createServer((peticion, respuesta) => void servirEstatico(carpetaWeb, peticion, respuesta));
+    const wss = new WebSocketServer({ server: http, path: "/ws", maxPayload: topes.bytesPorMensaje });
+    const vivos = new WeakMap();
+    const barrido = setInterval(() => {
+        salas.barrer();
+        for (const c of wss.clients) {
+            if (vivos.get(c) === false)
+                c.terminate();
+            else {
+                vivos.set(c, false);
+                c.ping();
+            }
+        }
+    }, opciones.latidoMs ?? 10_000);
+    barrido.unref();
+    wss.on("connection", (ws) => {
+        let papel;
+        let cerrando = false;
+        const cortar = () => {
+            cerrando = true;
+            ws.close();
+        };
+        const enviar = (s) => {
+            if (ws.readyState === ws.OPEN)
+                ws.send(JSON.stringify(s));
+            // `cerrada` es lo último que oye un móvil: su sala ya no existe, y un socket que sigue abierto es un zombi.
+            if (s.t === "cerrada")
+                cortar();
+        };
+        vivos.set(ws, true);
+        ws.on("pong", () => vivos.set(ws, true));
+        const plazo = setTimeout(() => {
+            if (papel === undefined)
+                ws.terminate();
+        }, opciones.plazoPrimerMensajeMs ?? PLAZO_PRIMER_MENSAJE_MS);
+        plazo.unref();
+        // Hasta su primer mensaje nadie sabe qué es: va con el tope del móvil, el más estrecho.
+        const cubo = crearCubo(ahora, topes.mensajesPorMinuto);
+        ws.on("message", (datos) => {
+            if (cerrando || ws.readyState !== ws.OPEN)
+                return;
+            if (!cubo.gastar(papel?.tipo === "anfitrion" ? topes.mensajesPorMinutoAnfitrion : topes.mensajesPorMinuto)) {
+                enviar({ t: "error", motivo: "ritmo" });
+                cortar();
+                return;
+            }
+            const texto = String(datos);
+            if (papel === undefined) {
+                const comoAnfitrion = interpretarSobre(texto, "anfitrion");
+                const comoMovil = interpretarSobre(texto, "movil");
+                const inicio = comoAnfitrion?.t === "abrir" ? comoAnfitrion : comoMovil?.t === "entrar" ? comoMovil : undefined;
+                if (inicio === undefined) {
+                    enviar({ t: "error", motivo: "mensaje-ilegible" });
+                    return;
+                }
+                if (inicio.v !== VERSION_DEL_PROTOCOLO) {
+                    enviar({ t: "error", motivo: "version" });
+                    cortar();
+                    return;
+                }
+                if (!FORMA_DE_SALA.test(inicio.sala)) {
+                    enviar({ t: "error", motivo: "mensaje-ilegible" });
+                    cortar();
+                    return;
+                }
+                if (inicio.t === "abrir") {
+                    if (salas.abrir(inicio.sala, enviar))
+                        papel = { tipo: "anfitrion", sala: inicio.sala };
+                    else
+                        cortar();
+                }
+                else {
+                    const id = salas.entrar(inicio.sala, enviar);
+                    if (id !== undefined)
+                        papel = { tipo: "movil", sala: inicio.sala, id };
+                    else
+                        cortar();
+                }
+                return;
+            }
+            if (papel.tipo === "anfitrion") {
+                const s = interpretarSobre(texto, "anfitrion");
+                if (s?.t === "dato")
+                    salas.datoDelAnfitrion(papel.sala, s.para, s.carga);
+                else if (s?.t === "cerrar") {
+                    salas.cerrar(papel.sala, enviar);
+                    papel = undefined;
+                    cortar();
+                }
+                else
+                    enviar({ t: "error", motivo: "mensaje-ilegible" });
+                return;
+            }
+            const s = interpretarSobre(texto, "movil");
+            if (s?.t === "dato")
+                salas.datoDelMovil(papel.sala, papel.id, s.carga);
+            else
+                enviar({ t: "error", motivo: "mensaje-ilegible" });
+        });
+        // Un mensaje mayor que el tope emite `error` en el socket del servidor; sin oyente tumbaría el proceso.
+        // `ws` ya ha empezado el cierre con su código (1009 para el tamaño, `TOPE_DE_SOBRE`): terminar aquí
+        // cortaría el TCP antes de mandar ese marco y el cliente vería un 1006 sin motivo. Solo se termina
+        // lo que siga abierto; el cierre en curso lo remata el propio plazo de `ws`.
+        ws.on("error", () => {
+            cerrando = true;
+            if (ws.readyState === ws.OPEN)
+                ws.terminate();
+        });
+        ws.on("close", () => {
+            clearTimeout(plazo);
+            if (papel?.tipo === "anfitrion")
+                salas.anfitrionCaido(papel.sala, enviar);
+            if (papel?.tipo === "movil")
+                salas.salir(papel.sala, papel.id);
+        });
+    });
+    await new Promise((resolver) => http.listen(opciones.puerto, opciones.host ?? "127.0.0.1", resolver));
+    const direccion = http.address();
+    const puerto = typeof direccion === "object" && direccion !== null ? direccion.port : opciones.puerto;
+    return {
+        urlHttp: `http://127.0.0.1:${puerto}`,
+        urlWs: `ws://127.0.0.1:${puerto}/ws`,
+        cerrar: async () => {
+            clearInterval(barrido);
+            for (const c of wss.clients)
+                c.terminate();
+            await new Promise((r) => wss.close(() => r()));
+            await new Promise((r) => http.close(() => r()));
+        },
+    };
+}

package/node_modules/@xone/xonecode-remoto/dist/sobre.d.ts

@@ -0,0 +1,53 @@
+/**
+ * El tope de un sobre en BYTES, tal como viaja (el JSON entero del sobre). Quien manda tiene que
+ * mantener cada sobre por debajo: la carga va cifrada (AES-GCM) y en base64url, que suman en torno a
+ * un 33 % al contenido en claro. Por encima, el relé no contesta con un `error`: cierra el socket con
+ * el código 1009 de WebSocket (mensaje demasiado grande).
+ */
+export declare const TOPE_DE_SOBRE = 1000000;
+export type MotivoDeError = "version" | "sala-inexistente" | "sala-ocupada" | "tope-de-moviles" | "ritmo" | "mensaje-ilegible";
+export type SobreDelAnfitrion = {
+    t: "abrir";
+    sala: string;
+    v: number;
+} | {
+    t: "dato";
+    para?: string;
+    carga: string;
+} | {
+    t: "cerrar";
+};
+export type SobreDelMovil = {
+    t: "entrar";
+    sala: string;
+    v: number;
+} | {
+    t: "dato";
+    carga: string;
+};
+export type SobreDelServidor = {
+    t: "abierta";
+} | {
+    t: "entrada";
+    id: string;
+} | {
+    t: "presencia";
+    moviles: string[];
+} | {
+    t: "anfitrion";
+    conectado: boolean;
+} | {
+    t: "dato";
+    de?: string;
+    carga: string;
+} | {
+    t: "error";
+    motivo: MotivoDeError;
+} | {
+    t: "cerrada";
+};
+type Lado = "anfitrion" | "movil" | "servidor";
+type SobreDe<L extends Lado> = L extends "anfitrion" ? SobreDelAnfitrion : L extends "movil" ? SobreDelMovil : SobreDelServidor;
+/** Lee un sobre de un lado. Lo que no tiene exactamente una forma permitida es `undefined`. */
+export declare function interpretarSobre<L extends Lado>(texto: string, lado: L): SobreDe<L> | undefined;
+export {};

package/node_modules/@xone/xonecode-remoto/dist/sobre.js

@@ -0,0 +1,69 @@
+/**
+ * El tope de un sobre en BYTES, tal como viaja (el JSON entero del sobre). Quien manda tiene que
+ * mantener cada sobre por debajo: la carga va cifrada (AES-GCM) y en base64url, que suman en torno a
+ * un 33 % al contenido en claro. Por encima, el relé no contesta con un `error`: cierra el socket con
+ * el código 1009 de WebSocket (mensaje demasiado grande).
+ */
+export const TOPE_DE_SOBRE = 1_000_000;
+const MOTIVOS = [
+    "version",
+    "sala-inexistente",
+    "sala-ocupada",
+    "tope-de-moviles",
+    "ritmo",
+    "mensaje-ilegible",
+];
+const esTexto = (x) => typeof x === "string" && x.length > 0;
+/** Lee un sobre de un lado. Lo que no tiene exactamente una forma permitida es `undefined`. */
+export function interpretarSobre(texto, lado) {
+    let o;
+    try {
+        const crudo = JSON.parse(texto);
+        if (typeof crudo !== "object" || crudo === null || Array.isArray(crudo))
+            return undefined;
+        o = crudo;
+    }
+    catch {
+        return undefined;
+    }
+    const r = sobreDe(o, lado);
+    return r;
+}
+function sobreDe(o, lado) {
+    if (lado === "anfitrion") {
+        if (o.t === "abrir" && esTexto(o.sala) && typeof o.v === "number")
+            return { t: "abrir", sala: o.sala, v: o.v };
+        if (o.t === "dato" && esTexto(o.carga)) {
+            if (o.para === undefined)
+                return { t: "dato", carga: o.carga };
+            return esTexto(o.para) ? { t: "dato", para: o.para, carga: o.carga } : undefined;
+        }
+        if (o.t === "cerrar")
+            return { t: "cerrar" };
+        return undefined;
+    }
+    if (lado === "movil") {
+        if (o.t === "entrar" && esTexto(o.sala) && typeof o.v === "number")
+            return { t: "entrar", sala: o.sala, v: o.v };
+        if (o.t === "dato" && esTexto(o.carga) && o.para === undefined)
+            return { t: "dato", carga: o.carga };
+        return undefined;
+    }
+    if (o.t === "abierta" || o.t === "cerrada")
+        return { t: o.t };
+    if (o.t === "entrada" && esTexto(o.id))
+        return { t: "entrada", id: o.id };
+    if (o.t === "presencia" && Array.isArray(o.moviles) && o.moviles.every(esTexto))
+        return { t: "presencia", moviles: o.moviles };
+    if (o.t === "anfitrion" && typeof o.conectado === "boolean")
+        return { t: "anfitrion", conectado: o.conectado };
+    if (o.t === "dato" && esTexto(o.carga)) {
+        if (o.de === undefined)
+            return { t: "dato", carga: o.carga };
+        return esTexto(o.de) ? { t: "dato", de: o.de, carga: o.carga } : undefined;
+    }
+    if (o.t === "error" && typeof o.motivo === "string" && MOTIVOS.includes(o.motivo)) {
+        return { t: "error", motivo: o.motivo };
+    }
+    return undefined;
+}

package/node_modules/@xone/xonecode-remoto/dist/url.d.ts

@@ -0,0 +1,12 @@
+/** La forma de un id de sala: 16 bytes aleatorios en base64url. La comprueban la URL y el relé. */
+export declare const FORMA_DE_SALA: RegExp;
+export interface Credenciales {
+    sala: string;
+    secreto: string;
+}
+export declare function generarCredenciales(): Credenciales;
+/** `https://<host>/r/<sala>#<secreto>`: el secreto en el FRAGMENTO, que el navegador nunca envía. */
+export declare function urlDeSesion(baseHttp: string, sala: string, secreto: string): string;
+export declare function leerUrlDeSesion(href: string): Credenciales | undefined;
+/** La base http(s) que sirve la web, a partir de la dirección ws(s) del puente. */
+export declare function baseHttpDe(servidorWs: string): string;

package/node_modules/@xone/xonecode-remoto/dist/url.js

@@ -0,0 +1,35 @@
+import { aBase64url } from "./base64url.js";
+const BYTES_DE_SALA = 16;
+const BYTES_DE_SECRETO = 32;
+/** La forma de un id de sala: 16 bytes aleatorios en base64url. La comprueban la URL y el relé. */
+export const FORMA_DE_SALA = /^[A-Za-z0-9_-]{22}$/;
+const SECRETO = /^[A-Za-z0-9_-]{43}$/;
+export function generarCredenciales() {
+    const sala = crypto.getRandomValues(new Uint8Array(BYTES_DE_SALA));
+    const secreto = crypto.getRandomValues(new Uint8Array(BYTES_DE_SECRETO));
+    return { sala: aBase64url(sala), secreto: aBase64url(secreto) };
+}
+/** `https://<host>/r/<sala>#<secreto>`: el secreto en el FRAGMENTO, que el navegador nunca envía. */
+export function urlDeSesion(baseHttp, sala, secreto) {
+    return `${baseHttp.replace(/\/+$/, "")}/r/${sala}#${secreto}`;
+}
+export function leerUrlDeSesion(href) {
+    let url;
+    try {
+        url = new URL(href);
+    }
+    catch {
+        return undefined;
+    }
+    const sala = /^\/r\/([^/]+)\/?$/.exec(url.pathname)?.[1];
+    const secreto = url.hash.replace(/^#/, "");
+    if (sala === undefined || !FORMA_DE_SALA.test(sala) || !SECRETO.test(secreto))
+        return undefined;
+    return { sala, secreto };
+}
+/** La base http(s) que sirve la web, a partir de la dirección ws(s) del puente. */
+export function baseHttpDe(servidorWs) {
+    const url = new URL(servidorWs);
+    const protocolo = url.protocol === "wss:" ? "https:" : "http:";
+    return `${protocolo}//${url.host}`;
+}

package/node_modules/@xone/xonecode-remoto/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** La versión del PROTOCOLO (lo que viaja), no la del paquete. Solo sube cuando cambia el sobre o el contenido. */
+export declare const VERSION_DEL_PROTOCOLO = 1;

package/node_modules/@xone/xonecode-remoto/dist/version.js

@@ -0,0 +1,2 @@
+/** La versión del PROTOCOLO (lo que viaja), no la del paquete. Solo sube cuando cambia el sobre o el contenido. */
+export const VERSION_DEL_PROTOCOLO = 1;

package/node_modules/@xone/xonecode-remoto/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@xone/xonecode-remoto",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./servidor": {
+      "types": "./dist/servidor/servidor.d.ts",
+      "import": "./dist/servidor/servidor.js"
+    }
+  },
+  "files": [
+    "dist",
+    "web"
+  ],
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.12"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "copiar-web": "node scripts/copiar-web.mjs",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sleiva/xonecode-server.git",
+    "directory": "packages/remoto"
+  }
+}

package/node_modules/@xone/xonecode-remoto/web/assets/index-Bfa2gK3J.css

@@ -0,0 +1 @@
+@font-face{font-family:Inter Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2) format("woff2-variations");unicode-range:U+0460-052F,U+1C80-1C8A,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2) format("woff2-variations");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2) format("woff2-variations");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/assets/inter-greek-wght-normal-CkhJZR-_.woff2) format("woff2-variations");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2) format("woff2-variations");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2) format("woff2-variations");unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/assets/inter-latin-wght-normal-Dx4kXJAl.woff2) format("woff2-variations");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}:root{--azul: #0c3c60;--azul-hondo: #05263a;--sobre-azul: #ffffff;--sobre-azul-suave: rgba(224, 242, 254, .75);--cian: #00a3e0;--cian-oscuro: #0284c7;--verde: #10b981;--ambar: #f59e0b;--rojo: #ef4444;--fondo: #ffffff;--superficie: #f4f6f9;--texto: #1b1f24;--tenue: #5b6470;--borde: #dfe3e8;--codigo: #eef1f5;--anadido: #e7f6ec;--quitado: #fdecec;--sombra: 0 1px 2px rgba(5, 38, 58, .06), 0 4px 16px rgba(5, 38, 58, .08);color-scheme:light}@media(prefers-color-scheme:dark){:root{--verde: #34d399;--rojo: #f87171;--fondo: #111418;--superficie: #1a1f25;--texto: #e6e9ee;--tenue: #9aa3ad;--borde: #2a3038;--codigo: #1f252c;--anadido: #12301d;--quitado: #3a1616;--sombra: 0 1px 2px rgba(0, 0, 0, .4), 0 4px 16px rgba(0, 0, 0, .35);color-scheme:dark}}*{box-sizing:border-box}html,body{margin:0}body{background:var(--fondo);color:var(--texto);font:15px/1.5 Inter Variable,system-ui,-apple-system,sans-serif;-webkit-font-smoothing:antialiased;-webkit-tap-highlight-color:transparent}button{font:inherit;cursor:pointer}button:disabled{opacity:.5;cursor:default}a{color:var(--cian-oscuro)}.pantalla{display:flex;flex-direction:column;min-height:100dvh;padding:0 16px env(safe-area-inset-bottom)}.cabecera{position:sticky;top:0;z-index:2;display:flex;flex-wrap:wrap;align-items:center;gap:8px;margin:0 -16px;padding:calc(10px + env(safe-area-inset-top)) 16px 10px;background:var(--azul);color:var(--sobre-azul);border-bottom:1px solid var(--azul-hondo)}.marca{font-weight:700;letter-spacing:-.01em}.punto{width:9px;height:9px;border-radius:50%;flex:none;box-shadow:0 0 0 2px #ffffff2e}.punto.verde{background:var(--verde)}.punto.ambar{background:var(--ambar)}.punto.rojo{background:var(--rojo)}.donde{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--sobre-azul-suave);font-size:14px}.trabajando{color:var(--sobre-azul-suave);font-size:13px}.parar{background:var(--rojo);color:#fff;border:0;border-radius:8px;padding:5px 12px;font-size:13px;font-weight:600}.aviso-de-conexion{width:100%;margin:0;color:var(--sobre-azul-suave);font-size:13px}.chat{list-style:none;margin:0;padding:16px 0;flex:1;display:flex;flex-direction:column;gap:12px}.chat .usuario{align-self:flex-end;max-width:85%;background:var(--superficie);border:1px solid var(--borde);border-radius:16px 16px 4px;padding:8px 12px;white-space:pre-wrap;overflow-wrap:anywhere}.chat .asistente{min-width:0;max-width:100%;overflow-wrap:anywhere}.chat .sistema,.chat .herramientas{color:var(--tenue);font-size:13px}.chat .herramientas{padding-left:10px;border-left:2px solid var(--borde)}.consulta p{margin:0 0 4px}.consulta button,.pregunta button{margin:4px 6px 0 0;border:1px solid var(--borde);border-radius:999px;padding:7px 14px;background:var(--fondo);color:var(--texto)}.markdown>:first-child{margin-top:0}.markdown>:last-child{margin-bottom:0}.markdown p,.markdown ul,.markdown ol,.markdown pre,.markdown blockquote,.markdown .tabla{margin:0 0 10px}.markdown h1,.markdown h2,.markdown h3,.markdown h4{line-height:1.3;margin:16px 0 6px}.markdown h1{font-size:20px}.markdown h2{font-size:18px}.markdown h3{font-size:16px}.markdown h4{font-size:15px}.markdown ul,.markdown ol{padding-left:22px}.markdown ul{list-style:disc}.markdown li{margin:2px 0}.markdown li>p{margin:0}.markdown code{font:13px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace;background:var(--codigo);border-radius:4px;padding:1px 4px}.markdown pre{background:var(--codigo);border-radius:10px;padding:10px 12px;overflow-x:auto}.markdown pre code{background:none;padding:0}.markdown blockquote{border-left:3px solid var(--cian);padding-left:10px;color:var(--tenue)}.markdown hr{border:0;border-top:1px solid var(--borde);margin:14px 0}.markdown .tabla{overflow-x:auto}.markdown table{border-collapse:collapse;font-size:13px}.markdown th,.markdown td{border:1px solid var(--borde);padding:5px 8px;text-align:left;vertical-align:top}.markdown th{background:var(--superficie)}.imagen-omitida{color:var(--tenue)}.aprobacion,.tarea-que-espera{border:1px solid var(--borde);border-radius:14px;padding:12px;margin:12px 0;background:var(--fondo);box-shadow:var(--sombra)}.aprobacion h2{font-size:16px;margin:0 0 8px}.aprobacion h3{font-size:13px;margin:10px 0 0;word-break:break-all;font-family:ui-monospace,Menlo,monospace}.origen{color:var(--tenue);font-size:13px;margin:0}.diff{overflow-x:auto;font:12px/1.45 ui-monospace,Menlo,monospace;margin:6px 0;background:var(--superficie);border-radius:8px;padding:6px 0}.diff .anadido{background:var(--anadido)}.diff .quitado{background:var(--quitado)}.acciones{display:flex;gap:8px;justify-content:flex-end;margin-top:8px}.acciones button{border-radius:10px;padding:9px 16px;border:1px solid var(--borde);background:var(--fondo);color:var(--texto);font-weight:500}.acciones .primario{background:var(--azul);color:var(--sobre-azul);border-color:var(--azul)}.fallo{color:var(--rojo);font-size:13px;margin:0}.aviso-de-pregunta{border:1px solid var(--ambar);border-radius:14px;padding:10px 12px;margin:12px 0}.tarea-que-espera h3{font-size:16px;margin:0}.tarea-que-espera .motivo{margin:6px 0;overflow-wrap:anywhere}.tarea-que-espera textarea{width:100%;resize:vertical;border:1px solid var(--borde);border-radius:10px;padding:8px 10px;font:inherit;background:var(--fondo);color:var(--texto);margin-bottom:8px}.compositor{position:sticky;bottom:0;z-index:1;display:flex;flex-wrap:wrap;align-items:flex-end;gap:8px;margin:0 -8px;padding:8px 8px 12px;background:linear-gradient(to bottom,transparent,var(--fondo) 12px)}.compositor .fallo{flex:1 1 100%;padding:0 4px}.compositor textarea{flex:1;min-width:0;resize:none;max-height:40dvh;field-sizing:content;min-height:44px;border:1px solid var(--borde);border-radius:22px;padding:11px 16px;font:inherit;background:var(--fondo);color:var(--texto);box-shadow:var(--sombra)}.compositor textarea:focus{outline:none;border-color:var(--cian)}.compositor textarea::placeholder{color:var(--tenue)}.compositor .enviar{flex:none;width:44px;height:44px;border:0;border-radius:50%;display:inline-flex;align-items:center;justify-content:center;background:var(--azul);color:var(--sobre-azul)}.compositor .enviar:active{background:var(--cian)}.pantalla.con-pestanas{--alto-pestanas: 56px}.pantalla.con-pestanas .compositor{bottom:var(--alto-pestanas)}.pestanas{position:sticky;bottom:0;z-index:2;display:flex;margin:0 -16px;background:var(--fondo);border-top:1px solid var(--borde)}.pestanas button{flex:1;height:var(--alto-pestanas, 56px);border:0;background:transparent;color:var(--tenue);display:flex;align-items:center;justify-content:center;gap:6px;font-weight:500}.pestanas button.activa{color:var(--azul);font-weight:600;box-shadow:inset 0 2px 0 var(--azul)}@media(prefers-color-scheme:dark){.pestanas button.activa{color:var(--cian);box-shadow:inset 0 2px 0 var(--cian)}}.insignia{min-width:20px;padding:0 6px;border-radius:10px;background:var(--rojo);color:#fff;font-size:12px;line-height:20px;text-align:center}.panel{flex:1;padding:4px 0 12px}.panel h2{font-size:12px;text-transform:uppercase;letter-spacing:.06em;color:var(--tenue);margin:18px 0 6px}.panel .aprobacion h2{font-size:16px;text-transform:none;letter-spacing:0;color:var(--texto);margin:0 0 8px}.tenue{color:var(--tenue);font-size:14px;margin:4px 0}.filas{list-style:none;margin:0;padding:0;border:1px solid var(--borde);border-radius:14px;overflow:hidden}.filas li{display:flex;flex-wrap:wrap;align-items:baseline;gap:4px 10px;padding:10px 12px;border-bottom:1px solid var(--borde)}.filas li:last-child{border-bottom:0}.fila-titulo{font-weight:600;flex:1 1 100%;overflow-wrap:anywhere}.estado{font-size:12px;font-weight:500;border-radius:10px;padding:0 8px;border:1px solid currentColor}.estado.rojo{color:var(--rojo)}.estado.ambar{color:var(--ambar)}.estado.verde{color:var(--verde)}.estado.gris{color:var(--tenue)}