@swal/edge-mesh 0.0.0-stage → 0.1.0

package/dist/transport/tor.js

@@ -0,0 +1,158 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createEnvelope, MessageDeduplicator } from "../protocol/index.js";
+import { TIPO_MENSAJE, TIPO_TRANSPORTE } from "../types/index.js";
+export const DEFAULT_TOR_CONFIG = {
+    enabled: false,
+    localPort: 8080,
+    socksPort: 9050,
+    controlPort: 9051,
+    torBinary: "tor",
+};
+/**
+ * Resolve data directory for Tor state and hidden service keys.
+ */
+export function getTorDataDir(customPath) {
+    if (customPath)
+        return customPath;
+    const home = os.homedir();
+    if (process.platform === "win32") {
+        return path.join(process.env.APPDATA || path.join(home, "AppData", "Roaming"), "edge-mesh", "tor");
+    }
+    if (process.platform === "darwin") {
+        return path.join(home, "Library", "Application Support", "edge-mesh", "tor");
+    }
+    return path.join(home, ".local", "share", "edge-mesh", "tor");
+}
+/**
+ * Generate standard torrc configuration for an Onion v3 Hidden Service.
+ */
+export function generateTorrc(config, dataDir) {
+    const hiddenServiceDir = path.join(dataDir, "onion");
+    const localPort = config.localPort ?? 8080;
+    const socksPort = config.socksPort ?? 9050;
+    const controlPort = config.controlPort ?? 9051;
+    return [
+        `DataDirectory ${dataDir}`,
+        `SocksPort ${socksPort}`,
+        `ControlPort ${controlPort}`,
+        `HiddenServiceDir ${hiddenServiceDir}`,
+        `HiddenServicePort ${localPort} 127.0.0.1:${localPort}`,
+        `HiddenServiceVersion 3`,
+        "",
+    ].join("\n");
+}
+/**
+ * TorOnionTransport provides opt-in Tor Onion v3 Hidden Service connectivity.
+ */
+export class TorOnionTransport {
+    tipo = TIPO_TRANSPORTE.TOR;
+    eventTarget;
+    nodoId;
+    config;
+    deduplicator;
+    torProcess = null;
+    onionAddress = null;
+    conectado = false;
+    dataDir;
+    constructor(nodoId, config = {}) {
+        this.nodoId = nodoId;
+        this.eventTarget = new EventTarget();
+        this.deduplicator = new MessageDeduplicator();
+        this.config = { ...DEFAULT_TOR_CONFIG, ...config };
+        this.dataDir = getTorDataDir(this.config.dataDir);
+    }
+    async start(localPort) {
+        if (!this.config.enabled) {
+            return null;
+        }
+        const port = localPort ?? this.config.localPort ?? 8080;
+        const hiddenServiceDir = path.join(this.dataDir, "onion");
+        try {
+            fs.mkdirSync(hiddenServiceDir, { recursive: true, mode: 0o700 });
+        }
+        catch (err) {
+            console.warn(`[TorTransport] Failed to create data dir: ${err.message}`);
+            return null;
+        }
+        const torrcPath = path.join(this.dataDir, "torrc");
+        const torrcContent = generateTorrc({ ...this.config, localPort: port }, this.dataDir);
+        fs.writeFileSync(torrcPath, torrcContent, { mode: 0o600 });
+        const hostnamePath = path.join(hiddenServiceDir, "hostname");
+        if (fs.existsSync(hostnamePath)) {
+            this.onionAddress = fs.readFileSync(hostnamePath, "utf8").trim();
+        }
+        const torBin = this.config.torBinary ?? "tor";
+        try {
+            this.torProcess = spawn(torBin, ["-f", torrcPath], {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            this.torProcess.on("error", (err) => {
+                console.warn(`[TorTransport] Tor binary execution error: ${err.message}`);
+                this.conectado = false;
+            });
+            this.torProcess.on("exit", () => {
+                this.conectado = false;
+            });
+            this.conectado = true;
+        }
+        catch (err) {
+            console.warn(`[TorTransport] Failed to spawn Tor process: ${err.message}`);
+            this.conectado = false;
+        }
+        return this.getOnionAddress();
+    }
+    getOnionAddress() {
+        if (this.onionAddress)
+            return this.onionAddress;
+        const hostnamePath = path.join(this.dataDir, "onion", "hostname");
+        if (fs.existsSync(hostnamePath)) {
+            this.onionAddress = fs.readFileSync(hostnamePath, "utf8").trim();
+        }
+        return this.onionAddress;
+    }
+    async conectar(_peerId) {
+        this.conectado = true;
+    }
+    async desconectar() {
+        this.conectado = false;
+        if (this.torProcess) {
+            this.torProcess.kill("SIGTERM");
+            this.torProcess = null;
+        }
+    }
+    async transmitir(datos, tipo) {
+        if (!this.conectado)
+            return;
+        const env = createEnvelope(tipo ?? TIPO_MENSAJE.SYNC, this.nodoId, "todos", datos);
+        this.emit("mensaje", { envolvente: env });
+    }
+    async enviar(destino, datos, tipo) {
+        if (!this.conectado)
+            return;
+        const env = createEnvelope(tipo ?? TIPO_MENSAJE.SYNC, this.nodoId, destino, datos);
+        this.emit("mensaje", { envolvente: env });
+    }
+    obtenerConexiones() {
+        return this.conectado && this.onionAddress ? [this.onionAddress] : [];
+    }
+    estaConectado() {
+        return this.conectado;
+    }
+    async cerrar() {
+        await this.desconectar();
+    }
+    on(tipo, handler) {
+        this.eventTarget.addEventListener(tipo, handler);
+    }
+    off(tipo, handler) {
+        this.eventTarget.removeEventListener(tipo, handler);
+    }
+    emit(tipo, detalle) {
+        const evento = new CustomEvent(tipo, { detail: detalle });
+        this.eventTarget.dispatchEvent(evento);
+    }
+}
+//# sourceMappingURL=tor.js.map

package/dist/transport/tor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tor.js","sourceRoot":"","sources":["../../src/transport/tor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAO3E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYlE,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC5C,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,KAAK;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,UAAmB;IAChD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CACf,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAC5D,WAAW,EACX,KAAK,CACL,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,IAAI,CACf,IAAI,EACJ,SAAS,EACT,qBAAqB,EACrB,WAAW,EACX,KAAK,CACL,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,OAAe;IAC/D,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;IAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC;IAE/C,OAAO;QACN,iBAAiB,OAAO,EAAE;QAC1B,aAAa,SAAS,EAAE;QACxB,eAAe,WAAW,EAAE;QAC5B,oBAAoB,gBAAgB,EAAE;QACtC,qBAAqB,SAAS,cAAc,SAAS,EAAE;QACvD,wBAAwB;QACxB,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,IAAI,GAAmB,eAAe,CAAC,GAAG,CAAC;IAC3C,WAAW,CAAc;IACzB,MAAM,CAAS;IACf,MAAM,CAAY;IAEV,YAAY,CAAsB;IAC3C,UAAU,GAAwB,IAAI,CAAC;IACvC,YAAY,GAAkB,IAAI,CAAC;IACnC,SAAS,GAAY,KAAK,CAAC;IAClB,OAAO,CAAS;IAEjC,YAAY,MAAc,EAAE,MAAM,GAAuB,EAAE;QAC1D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAkB;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QACxD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE1D,IAAI,CAAC;YACJ,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CACX,6CAA8C,GAAa,CAAC,OAAO,EAAE,CACrE,CAAC;YACF,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,aAAa,CACjC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EACnC,IAAI,CAAC,OAAO,CACZ,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAE3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;QAC9C,IAAI,CAAC;YACJ,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE;gBAClD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aACjC,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACnC,OAAO,CAAC,IAAI,CACX,8CAA8C,GAAG,CAAC,OAAO,EAAE,CAC3D,CAAC;gBACF,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CACX,+CAAgD,GAAa,CAAC,OAAO,EAAE,CACvE,CAAC;YACF,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAC/B,CAAC;IAED,eAAe;QACd,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAClE,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,WAAW;QAChB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,CAAC;IACF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAc,EAAE,IAAkB;QAClD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,MAAM,GAAG,GAAG,cAAc,CACzB,IAAI,IAAI,YAAY,CAAC,IAAI,EACzB,IAAI,CAAC,MAAM,EACX,OAAiB,EACjB,KAAK,CACL,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,MAAM,CACX,OAAe,EACf,KAAc,EACd,IAAkB;QAElB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,MAAM,GAAG,GAAG,cAAc,CACzB,IAAI,IAAI,YAAY,CAAC,IAAI,EACzB,IAAI,CAAC,MAAM,EACX,OAAO,EACP,KAAK,CACL,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,iBAAiB;QAChB,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM;QACX,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC;IAED,EAAE,CACD,IAAO,EACP,OAA2C;QAE3C,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAc,EAAE,OAAwB,CAAC,CAAC;IAC7E,CAAC;IAED,GAAG,CACF,IAAO,EACP,OAA2C;QAE3C,IAAI,CAAC,WAAW,CAAC,mBAAmB,CACnC,IAAc,EACd,OAAwB,CACxB,CAAC;IACH,CAAC;IAEO,IAAI,CACX,IAAO,EACP,OAAuC;QAEvC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;CACD"}

package/dist/transport/types.d.ts

@@ -0,0 +1,34 @@
+import type { Envolvente, NodoId, TipoTransporte } from "../types/index.js";
+export interface TransportEventMap {
+    conectado: CustomEvent<{
+        readonly nodoId: NodoId;
+    }>;
+    desconectado: CustomEvent<{
+        readonly nodoId: NodoId;
+    }>;
+    mensaje: CustomEvent<{
+        readonly envolvente: Envolvente;
+        readonly from?: NodoId;
+    }>;
+    error: CustomEvent<{
+        readonly mensaje: string;
+        readonly error?: Error;
+    }>;
+}
+/**
+ * Minimal transport port used by EdgeMesh.
+ * PeerJS and Memory transports implement this surface.
+ */
+export interface ITransport {
+    readonly tipo: TipoTransporte;
+    readonly eventTarget: EventTarget;
+    readonly nodoId: NodoId;
+    on<K extends keyof TransportEventMap>(tipo: K, handler: (ev: TransportEventMap[K]) => void): void;
+    off<K extends keyof TransportEventMap>(tipo: K, handler: (ev: TransportEventMap[K]) => void): void;
+    enviar(destino: NodoId, payload: unknown, tipoMensaje?: string): Promise<void>;
+    transmitir(payload: unknown, tipoMensaje?: string): Promise<void>;
+    estaConectado(): boolean;
+    obtenerConexiones(): readonly string[];
+    cerrar(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,WAAW,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,YAAY,EAAE,WAAW,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,OAAO,EAAE,WAAW,CAAC;QACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,EAAE,WAAW,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACnC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI,CAAC;IACR,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACpC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI,CAAC;IAER,MAAM,CACL,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,aAAa,IAAI,OAAO,CAAC;IACzB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAAC;IACvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/transport/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,293 @@
+export declare const TIPO_MENSAJE: {
+    readonly SYNC: "sync";
+    readonly ACK: "ack";
+    readonly HEARTBEAT: "heartbeat";
+    readonly HALLAZGO: "hallazgo";
+    readonly VOTACION: "votacion";
+    readonly SNAPSHOT: "snapshot";
+    readonly OP_LOG: "op_log";
+    readonly AUTHZ: "authz";
+    readonly NAMESPACE: "namespace";
+    readonly GOVERNANCE: "governance";
+    readonly IDENTITY: "identity";
+    readonly ERROR: "error";
+    /** Presentación, solicitud y respuesta de una `CredencialMedica`. */
+    readonly CREDENCIAL: "credencial";
+    /** Aval de un par (`Aval`) y su revocación. */
+    readonly AVAL: "aval";
+    /** Instantánea de un registro nacional, direccionada por hash. */
+    readonly REGISTRO: "registro";
+    readonly PQC_HANDSHAKE: "pqc_handshake";
+    readonly KEM_REPLY: "kem_reply";
+    readonly PQC_ACK: "pqc_ack";
+    readonly PEER_LIST_UPDATE: "peer_list_update";
+    readonly GOSSIP: "gossip";
+};
+export type TipoMensaje = (typeof TIPO_MENSAJE)[keyof typeof TIPO_MENSAJE];
+export declare const ESTADO_NODO: {
+    readonly OFFLINE: "offline";
+    readonly CONECTANDO: "conectando";
+    readonly ONLINE: "online";
+    readonly SUSPENDIDO: "suspendido";
+    readonly RECONECTANDO: "reconectando";
+    readonly ELIMINADO: "eliminado";
+};
+export type EstadoNodo = (typeof ESTADO_NODO)[keyof typeof ESTADO_NODO];
+export declare const ESTADO_SALUD: {
+    readonly SALUDABLE: "saludable";
+    readonly LENTO: "lento";
+    readonly FALLANDO: "fallando";
+    readonly DESCONOCIDO: "desconocido";
+};
+export type EstadoSalud = (typeof ESTADO_SALUD)[keyof typeof ESTADO_SALUD];
+export declare const POLITICA_GOBERNANZA: {
+    readonly DEMOCRATICA: "democratica";
+    readonly AUTORITARIA: "autoritaria";
+    readonly CONSENSO: "consenso";
+    readonly PLURALIDAD: "pluralidad";
+};
+export type PoliticaGobernanza = (typeof POLITICA_GOBERNANZA)[keyof typeof POLITICA_GOBERNANZA];
+export declare const TIPO_TRANSPORTE: {
+    readonly PEERJS: "peerjs";
+    readonly WEBSOCKET: "websocket";
+    readonly MEMORIA: "memoria";
+    readonly TOR: "tor";
+};
+export type TipoTransporte = (typeof TIPO_TRANSPORTE)[keyof typeof TIPO_TRANSPORTE];
+export declare function isTipoMensaje(valor: unknown): valor is TipoMensaje;
+export declare function isEstadoNodo(valor: unknown): valor is EstadoNodo;
+export type NodoId = string & {
+    readonly __brand: "NodoId";
+};
+export type ParPublico = Uint8Array;
+export interface Envolvente {
+    readonly id: string;
+    readonly tipo: TipoMensaje;
+    readonly origen: NodoId;
+    readonly destino: NodoId | "*";
+    readonly timestamp: number;
+    readonly firma: Uint8Array | null;
+    readonly payload: unknown;
+    readonly version: number;
+    readonly nonce: string;
+}
+export type PayloadSync = {
+    readonly tipoSync: "estado" | "delta" | "solicitud";
+    readonly docId: string;
+    readonly datos: Uint8Array;
+    readonly clock: number;
+};
+export type PayloadHeartbeat = {
+    readonly nodoId: NodoId;
+    readonly timestamp: number;
+    readonly secuencia: number;
+};
+export type PayloadHallazgo = {
+    readonly id: string;
+    readonly tipo: string;
+    readonly datos: unknown;
+    readonly nodoOrigen: NodoId;
+    readonly ttl: number;
+};
+export type PayloadVotacion = {
+    readonly propuesta: string;
+    readonly voto: "a_favor" | "en_contra" | "abstencion";
+    readonly nodoId: NodoId;
+    readonly peso: number;
+    readonly justificacion: string | null;
+    readonly firma?: Uint8Array | number[] | string | null;
+    readonly timestamp?: number;
+};
+export interface VerificadorVotos {
+    obtenerClavePublica(nodoId: NodoId): ParPublico | Uint8Array | undefined | null;
+    verificarFirma(mensaje: Uint8Array, firma: Uint8Array, clave: ParPublico | Uint8Array): boolean | Promise<boolean>;
+}
+export type PayloadSnapshot = {
+    readonly docId: string;
+    readonly version: number;
+    readonly datos: Uint8Array;
+    readonly nodosConfirmados: readonly NodoId[];
+};
+export type PayloadOpLog = {
+    readonly docId: string;
+    readonly operaciones: readonly Operacion[];
+    readonly desde: number;
+    readonly hasta: number;
+};
+export type PayloadAuthz = {
+    readonly accion: "conceder" | "revocar" | "verificar";
+    readonly espacio: string;
+    readonly sujeto: NodoId;
+    readonly capacidad: string;
+};
+export type PayloadNamespace = {
+    readonly accion: "crear" | "unir" | "abandonar" | "listar";
+    readonly espacio: string;
+    readonly nodoId: NodoId;
+};
+export type PayloadIdentity = {
+    readonly nodoId: NodoId;
+    readonly parPublico: ParPublico;
+    readonly algoritmo: string;
+    readonly prueba: Uint8Array;
+};
+export type PayloadError = {
+    readonly codigo: number;
+    readonly mensaje: string;
+    readonly origen: NodoId | null;
+    readonly idMensajeOriginal: string | null;
+};
+export interface Operacion {
+    readonly id: string;
+    readonly tipo: string;
+    readonly datos: unknown;
+    readonly timestamp: number;
+    readonly autor: NodoId;
+    readonly secuencia: number;
+}
+export interface GovernancePolicy {
+    readonly politica: PoliticaGobernanza;
+    readonly umbral: number;
+    readonly ventanaMs: number;
+    readonly pesoNodo: Readonly<Record<string, number>>;
+    readonly reglas: readonly string[];
+}
+export interface NamespacePartition {
+    readonly id: string;
+    readonly nombre: string;
+    readonly nodos: readonly NodoId[];
+    readonly fechaCreacion: number;
+    readonly metadatos: Readonly<Record<string, string>>;
+}
+export interface NamespaceCapabilityGrant {
+    readonly id: string;
+    readonly espacio: string;
+    readonly sujeto: NodoId;
+    readonly capacidad: string;
+    readonly fechaEmision: number;
+    readonly fechaExpiracion: number;
+    readonly firma: Uint8Array;
+}
+export interface HealthStatus {
+    readonly nodoId: NodoId;
+    readonly estado: EstadoSalud;
+    readonly ultimoHeartbeat: number;
+    readonly latenciaMs: number;
+    readonly fallosConsecutivos: number;
+}
+export interface EdgeMeshEventMap {
+    nodoConectado: CustomEvent<{
+        readonly nodoId: NodoId;
+    }>;
+    nodoDesconectado: CustomEvent<{
+        readonly nodoId: NodoId;
+    }>;
+    mensajeRecibido: CustomEvent<{
+        readonly envolvente: Envolvente;
+    }>;
+    syncCompletado: CustomEvent<{
+        readonly docId: string;
+        readonly clock: number;
+    }>;
+    error: CustomEvent<{
+        readonly mensaje: string;
+        readonly error?: Error;
+    }>;
+    estadoCambiado: CustomEvent<{
+        readonly estadoAnterior: EstadoNodo;
+        readonly estadoNuevo: EstadoNodo;
+    }>;
+    hallazgoRecibido: CustomEvent<{
+        readonly hallazgo: PayloadHallazgo;
+    }>;
+    votacionRecibida: CustomEvent<{
+        readonly votacion: PayloadVotacion;
+    }>;
+    saludCambiada: CustomEvent<{
+        readonly nodoId: NodoId;
+        readonly salud: EstadoSalud;
+    }>;
+    failover: CustomEvent<{
+        readonly antiguoMaster: NodoId | null;
+        readonly nuevoMaster: NodoId;
+        readonly razon: "timeout" | "forced" | "manual";
+    }>;
+}
+export type EdgeMeshEvent = EdgeMeshEventMap[keyof EdgeMeshEventMap];
+export interface StorageEntry<T = unknown> {
+    readonly key: string;
+    readonly valor: T;
+    readonly timestamp: number;
+    readonly version: number;
+}
+export type StorageFilter = {
+    readonly prefijo?: string;
+    readonly desde?: number;
+    readonly hasta?: number;
+    readonly limite?: number;
+};
+export interface EdgeMeshConfig {
+    readonly nodoId: NodoId;
+    /**
+     * When set, EdgeMesh opens its own PeerJS transport with this id.
+     * Prefer omitting this when the host app already owns PeerJS (e.g. Shelf p2p-mesh-core).
+     */
+    readonly peerId?: string;
+    /** Serialized keypair bytes from `serializeKeypair`, not a raw private key. */
+    readonly identitySecret?: Uint8Array;
+    readonly heartbeatIntervalMs?: number;
+    readonly heartbeatTimeoutMs?: number;
+    readonly snapshotInterval?: number;
+    readonly snapshotConfig?: any;
+    readonly storagePrefix?: string;
+    readonly storageBackend?: "mem" | "idb";
+    readonly governancePolicy?: GovernancePolicy;
+    readonly transportConfig?: Record<string, unknown>;
+    readonly maxReconnectAttempts?: number;
+    readonly logLevel?: "debug" | "info" | "warn" | "error";
+    /**
+     * When true (default), remote SYNC requires write/sync capability for the origin peer.
+     * Remote AUTHZ grants require a valid signature from a registered admin/master key.
+     */
+    readonly requireAuthz?: boolean;
+    /**
+     * When true (default), remote SYNC/AUTHZ envelopes must carry a verifiable ML-DSA signature from a peer
+     * key registered with `registrarClavePublica`. Set to false only for legacy/unsigned deployments.
+     */
+    readonly requireSignedEnvelopes?: boolean;
+    /**
+     * Namespace used when authorizing generic CRDT sync writes.
+     * Defaults to "global".
+     */
+    readonly defaultSyncNamespace?: string;
+    /**
+     * Optional external Yjs document (Phase B: share host app CRDT doc).
+     * When provided, EdgeMesh does **not** destroy it on `detener()`.
+     * Use a structural type to avoid forcing yjs types on pure type consumers.
+     */
+    readonly yDoc?: {
+        on: (...args: never[]) => unknown;
+        off: (...args: never[]) => unknown;
+        getMap: (name: string) => unknown;
+        destroy: () => void;
+        [key: string]: unknown;
+    };
+    /**
+     * When true, local Yjs updates are relayed over the attached ITransport.
+     * Default: `false` if `yDoc` is provided (host app owns YJS broadcast, e.g. p2pManager),
+     * otherwise `true`.
+     */
+    readonly relayLocalYjs?: boolean;
+    /**
+     * When true (or omitted/undefined), PQC Handshake and encryption on SYNC path are enabled.
+     * Set to false to disable/simulate fallback behavior.
+     */
+    readonly enablePqcEncryption?: boolean;
+    readonly initialMaster?: NodoId;
+    readonly authorityTimeoutMs?: number;
+    readonly sybilThreshold?: number;
+    readonly requireSignedVotes?: boolean;
+    readonly gossipFanOut?: number;
+    readonly gossipTTL?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,73 @@
+// ─── CONST OBJECT PATTERNS ────────────────────────────────────────────────
+export const TIPO_MENSAJE = {
+    SYNC: "sync",
+    ACK: "ack",
+    HEARTBEAT: "heartbeat",
+    // La clave estaba mal escrita (`HALLazGO`); el valor de cable nunca lo estuvo,
+    // así que corregirla no rompe a ningún par. Se renombra porque una clave de enum
+    // mal escrita es la clase de defecto que sobrevive años y luego alguien
+    // empareja mal contra ella.
+    HALLAZGO: "hallazgo",
+    VOTACION: "votacion",
+    SNAPSHOT: "snapshot",
+    OP_LOG: "op_log",
+    AUTHZ: "authz",
+    NAMESPACE: "namespace",
+    GOVERNANCE: "governance",
+    IDENTITY: "identity",
+    ERROR: "error",
+    // ── CAPA MÉDICA (docs/medico/protocolo.md §7) ──
+    //
+    // El tráfico de credenciales NO pasa por AUTHZ a propósito: una concesión
+    // authz es estado de *capacidad local*, mientras que una credencial es una
+    // *afirmación replicada*. Confundirlas vuelve ambas inauditables — una
+    // concesión se puede revocar sin tocar el registro que la replicó, y un
+    // registro parece revocable cuando no lo es.
+    /** Presentación, solicitud y respuesta de una `CredencialMedica`. */
+    CREDENCIAL: "credencial",
+    /** Aval de un par (`Aval`) y su revocación. */
+    AVAL: "aval",
+    /** Instantánea de un registro nacional, direccionada por hash. */
+    REGISTRO: "registro",
+    PQC_HANDSHAKE: "pqc_handshake",
+    KEM_REPLY: "kem_reply",
+    PQC_ACK: "pqc_ack",
+    PEER_LIST_UPDATE: "peer_list_update",
+    GOSSIP: "gossip",
+};
+export const ESTADO_NODO = {
+    OFFLINE: "offline",
+    CONECTANDO: "conectando",
+    ONLINE: "online",
+    SUSPENDIDO: "suspendido",
+    RECONECTANDO: "reconectando",
+    ELIMINADO: "eliminado",
+};
+export const ESTADO_SALUD = {
+    SALUDABLE: "saludable",
+    LENTO: "lento",
+    FALLANDO: "fallando",
+    DESCONOCIDO: "desconocido",
+};
+export const POLITICA_GOBERNANZA = {
+    DEMOCRATICA: "democratica",
+    AUTORITARIA: "autoritaria",
+    CONSENSO: "consenso",
+    PLURALIDAD: "pluralidad",
+};
+export const TIPO_TRANSPORTE = {
+    PEERJS: "peerjs",
+    WEBSOCKET: "websocket",
+    MEMORIA: "memoria",
+    TOR: "tor",
+};
+// ─── TYPE GUARDS ───────────────────────────────────────────────────────────
+export function isTipoMensaje(valor) {
+    return (typeof valor === "string" &&
+        Object.values(TIPO_MENSAJE).includes(valor));
+}
+export function isEstadoNodo(valor) {
+    return (typeof valor === "string" &&
+        Object.values(ESTADO_NODO).includes(valor));
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,+EAA+E;IAC/E,iFAAiF;IACjF,wEAAwE;IACxE,4BAA4B;IAC5B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,kDAAkD;IAClD,EAAE;IACF,0EAA0E;IAC1E,2EAA2E;IAC3E,uEAAuE;IACvE,wEAAwE;IACxE,6CAA6C;IAC7C,qEAAqE;IACrE,UAAU,EAAE,YAAY;IACxB,+CAA+C;IAC/C,IAAI,EAAE,MAAM;IACZ,kEAAkE;IAClE,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;IAC9B,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,gBAAgB,EAAE,kBAAkB;IACpC,MAAM,EAAE,QAAQ;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;CACb,CAAC;AAIX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;CACjB,CAAC;AAIX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;CACf,CAAC;AAKX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,KAAK;CACD,CAAC;AAKX,8EAA8E;AAE9E,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,OAAO,CACN,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IAC1C,OAAO,CACN,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAmB,CAAC,CACxD,CAAC;AACH,CAAC"}

package/dist/web/admission.d.ts

@@ -0,0 +1,24 @@
+/** A deviceId is the fingerprint of the device's ML-DSA-65 identity key (`deviceIdOf`): 43 base64url characters. */
+export declare const DEVICE_ID_RE: RegExp;
+export declare const isDeviceId: (x: unknown) => x is string;
+/** True iff `deviceId` is the fingerprint of the base64url identity key `pub` (the binding every check relies on). */
+export declare function idMatchesPub(deviceId: string, pub: string): Promise<boolean>;
+/**
+ * Mesh role of a device: the root of the mesh's web/trust store is the owner; a grant that may delegate
+ * (`delegate >= 1`) makes an admin; any other grant a member.
+ */
+export type Role = "owner" | "admin" | "member";
+/** The locally pinned trust anchor (never read from the shared doc): the mesh owner's identity. */
+export interface TrustRoot {
+    mid: string;
+    deviceId: string;
+    pub: string;
+}
+/** SF1: epochs stay far below any integer edge (u32 on the wire, safe integers in JS). */
+export declare const MAX_EPOCH: number;
+/** SF1: a received rotation may skip at most this many epochs ahead of the local one. */
+export declare const MAX_EPOCH_SKIP = 8;
+export declare const isEpoch: (x: unknown) => x is number;
+/** Who may admit whom: the owner admits admins and members, an admin admits members, members admit nobody. */
+export declare function canIssue(issuer: Role, subject: Role): boolean;
+//# sourceMappingURL=admission.d.ts.map

package/dist/web/admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../src/web/admission.ts"],"names":[],"mappings":"AAKA,oHAAoH;AACpH,eAAO,MAAM,YAAY,QAAwB,CAAC;AAClD,eAAO,MAAM,UAAU,MAAO,OAAO,KAAG,CAAC,IAAI,MACC,CAAC;AAG/C,sHAAsH;AACtH,wBAAsB,YAAY,CACjC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,CAAC,CAelB;AAED;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD,mGAAmG;AACnG,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,0FAA0F;AAC1F,eAAO,MAAM,SAAS,QAAc,CAAC;AACrC,yFAAyF;AACzF,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,OAAO,MAAO,OAAO,KAAG,CAAC,IAAI,MACmC,CAAC;AAE9E,8GAA8G;AAC9G,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAI7D"}