@swal/edge-mesh 0.0.0-stage → 0.1.1

package/dist/transport/TorTransportAdapter.js

@@ -0,0 +1,192 @@
+import { createEnvelope, MessageDeduplicator } from "../protocol/index.js";
+import { TIPO_MENSAJE, TIPO_TRANSPORTE } from "../types/index.js";
+/**
+ * TorTransportAdapter provides hidden service proxy tunnel fallback for NAT traversal
+ * when direct WebRTC or TCP connections fail behind severe CGNAT.
+ */
+export class TorTransportAdapter {
+    tipo = TIPO_TRANSPORTE.TOR;
+    eventTarget;
+    nodoId;
+    options;
+    deduplicator;
+    onionPeerMap; // peerId -> onionAddress
+    activeConnections; // set of remote peerIds/onionAddresses
+    onionAddress;
+    conectado = false;
+    tunnelActive = false;
+    constructor(nodoId, options = {}) {
+        this.nodoId = nodoId;
+        this.eventTarget = new EventTarget();
+        this.deduplicator = new MessageDeduplicator();
+        this.options = options;
+        this.onionPeerMap = new Map();
+        this.activeConnections = new Set();
+        this.onionAddress =
+            options.onionAddress ??
+                `${nodoId
+                    .toLowerCase()
+                    .replace(/[^a-z0-9]/g, "")
+                    .slice(0, 16)}.onion`;
+        if (options.autoConnect) {
+            void this.conectar();
+        }
+    }
+    on(tipo, handler) {
+        this.eventTarget.addEventListener(tipo, handler);
+    }
+    off(tipo, handler) {
+        this.eventTarget.removeEventListener(tipo, handler);
+    }
+    emit(tipo, detalle) {
+        this.eventTarget.dispatchEvent(new CustomEvent(tipo, { detail: detalle }));
+    }
+    /**
+     * Establish Tor onion hidden service proxy tunnel.
+     */
+    async conectar() {
+        if (this.conectado)
+            return;
+        this.conectado = true;
+        this.tunnelActive = true;
+        this.emit("conectado", { nodoId: this.nodoId });
+        // Forward underlying fallback transport events if provided
+        if (this.options.fallbackTransport) {
+            if (!this.options.fallbackTransport.estaConectado()) {
+                try {
+                    if ("conectar" in this.options.fallbackTransport &&
+                        typeof this.options.fallbackTransport.conectar ===
+                            "function") {
+                        await this.options.fallbackTransport.conectar();
+                    }
+                }
+                catch (err) {
+                    this.emit("error", {
+                        mensaje: `Fallback transport connection error: ${err?.message ?? err}`,
+                        error: err,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Register remote peer's onion hidden service address for proxy routing.
+     */
+    registerOnionPeer(peerId, onionAddress) {
+        this.onionPeerMap.set(peerId, onionAddress);
+        this.activeConnections.add(peerId);
+    }
+    /**
+     * Get node's local onion hidden service address.
+     */
+    getOnionAddress() {
+        return this.onionAddress;
+    }
+    /**
+     * Returns true if the proxy tunnel is established and active.
+     */
+    isTunnelActive() {
+        return this.conectado && this.tunnelActive;
+    }
+    /**
+     * Send envelope or payload to a remote node via Tor hidden service proxy tunnel.
+     */
+    async enviar(destino, payload, tipoMensaje = TIPO_MENSAJE.SYNC) {
+        if (!this.conectado) {
+            throw new Error("TorTransportAdapter no conectado");
+        }
+        const env = esEnvolvente(payload)
+            ? payload
+            : createEnvelope(tipoMensaje, this.nodoId, destino, payload);
+        const targetOnion = this.onionPeerMap.get(destino);
+        try {
+            if (this.options.tunnelHandler) {
+                await this.options.tunnelHandler(env, targetOnion);
+            }
+            else if (this.options.fallbackTransport) {
+                await this.options.fallbackTransport.enviar(destino, env, tipoMensaje);
+            }
+            else {
+                // Simulated hidden service proxy tunnel transmission
+                this.activeConnections.add(destino);
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit("error", {
+                mensaje: `Tor proxy tunnel error sending to ${destino}: ${error.message}`,
+                error,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Broadcast envelope or payload across all connected onion hidden service peers.
+     */
+    async transmitir(payload, tipoMensaje = TIPO_MENSAJE.SYNC) {
+        if (!this.conectado)
+            return;
+        const env = esEnvolvente(payload)
+            ? payload
+            : createEnvelope(tipoMensaje, this.nodoId, "*", payload);
+        const peers = this.obtenerConexiones();
+        const promises = peers.map(async (peer) => {
+            try {
+                await this.enviar(peer, env, tipoMensaje);
+            }
+            catch {
+                // Ignore individual peer errors during broadcast
+            }
+        });
+        await Promise.all(promises);
+    }
+    /**
+     * Helper method to process incoming proxy tunnel payloads into the adapter.
+     */
+    receivePayload(datos, from) {
+        if (!esEnvolvente(datos))
+            return;
+        if (this.deduplicator.esDuplicado(datos))
+            return;
+        if (from) {
+            this.activeConnections.add(from);
+        }
+        else if (datos.origen) {
+            this.activeConnections.add(datos.origen);
+        }
+        this.emit("mensaje", { envolvente: datos, from });
+    }
+    estaConectado() {
+        return this.conectado;
+    }
+    obtenerConexiones() {
+        return Array.from(this.activeConnections.keys());
+    }
+    async cerrar() {
+        this.conectado = false;
+        this.tunnelActive = false;
+        this.activeConnections.clear();
+        this.deduplicator.reiniciar();
+        if (this.options.fallbackTransport) {
+            try {
+                await this.options.fallbackTransport.cerrar();
+            }
+            catch {
+                // Ignore errors on closing fallback transport
+            }
+        }
+        this.emit("desconectado", { nodoId: this.nodoId });
+    }
+}
+function esEnvolvente(valor) {
+    if (typeof valor !== "object" || valor === null)
+        return false;
+    const candidate = valor;
+    return (typeof candidate.id === "string" &&
+        typeof candidate.tipo === "string" &&
+        typeof candidate.origen === "string" &&
+        typeof candidate.destino === "string" &&
+        typeof candidate.timestamp === "number" &&
+        candidate.payload !== undefined);
+}
+//# sourceMappingURL=TorTransportAdapter.js.map

package/dist/transport/TorTransportAdapter.js.map

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

package/dist/transport/memory.d.ts

@@ -0,0 +1,31 @@
+import type { NodoId } from "../types/index.js";
+import type { ITransport, TransportEventMap } from "./types.js";
+export interface MemoryTransportOptions {
+    /** Shared room id so multiple MemoryTransport instances can find each other. */
+    readonly roomId?: string;
+}
+/**
+ * Deterministic multi-node transport for unit/integration tests (no WebRTC).
+ */
+export declare class MemoryTransport implements ITransport {
+    readonly tipo: "memoria";
+    readonly eventTarget: EventTarget;
+    readonly nodoId: NodoId;
+    private readonly roomId;
+    private readonly deduplicator;
+    private conectado;
+    constructor(nodoId: NodoId, options?: MemoryTransportOptions);
+    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;
+    private emit;
+    conectar(): Promise<void>;
+    enviar(destino: NodoId, payload: unknown, tipoMensaje?: string): Promise<void>;
+    transmitir(payload: unknown, tipoMensaje?: string): Promise<void>;
+    private recibir;
+    estaConectado(): boolean;
+    obtenerConexiones(): readonly string[];
+    cerrar(): Promise<void>;
+    /** Test helper: wipe all rooms (avoid cross-test pollution). */
+    static resetAll(): void;
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/transport/memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAe,MAAM,mBAAmB,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhE,MAAM,WAAW,sBAAsB;IACtC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,UAAU;IACjD,QAAQ,CAAC,IAAI,YAA2B;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,EAI/D;IAED,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACnC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI,CAEN;IAED,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACpC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI,CAKN;IAED,OAAO,CAAC,IAAI;IASN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAa9B;IAEK,MAAM,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,WAAW,GAAE,MAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CAgBf;IAEK,UAAU,CACf,OAAO,EAAE,OAAO,EAChB,WAAW,GAAE,MAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CAYf;IAED,OAAO,CAAC,OAAO;IAKf,aAAa,IAAI,OAAO,CAEvB;IAED,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAMrC;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAY5B;IAED,gEAAgE;IAChE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAEtB;CACD"}

package/dist/transport/memory.js

@@ -0,0 +1,114 @@
+import { createEnvelope, MessageDeduplicator } from "../protocol/index.js";
+import { TIPO_MENSAJE, TIPO_TRANSPORTE } from "../types/index.js";
+// ─── IN-PROCESS MESH BUS ───────────────────────────────────────────────────
+const busPorSala = new Map();
+/**
+ * Deterministic multi-node transport for unit/integration tests (no WebRTC).
+ */
+export class MemoryTransport {
+    tipo = TIPO_TRANSPORTE.MEMORIA;
+    eventTarget;
+    nodoId;
+    roomId;
+    deduplicator = new MessageDeduplicator();
+    conectado = false;
+    constructor(nodoId, options = {}) {
+        this.nodoId = nodoId;
+        this.eventTarget = new EventTarget();
+        this.roomId = options.roomId ?? "default";
+    }
+    on(tipo, handler) {
+        this.eventTarget.addEventListener(tipo, handler);
+    }
+    off(tipo, handler) {
+        this.eventTarget.removeEventListener(tipo, handler);
+    }
+    emit(tipo, detalle) {
+        this.eventTarget.dispatchEvent(new CustomEvent(tipo, { detail: detalle }));
+    }
+    async conectar() {
+        const room = busPorSala.get(this.roomId) ?? new Set();
+        room.add(this);
+        busPorSala.set(this.roomId, room);
+        this.conectado = true;
+        this.emit("conectado", { nodoId: this.nodoId });
+        // Announce presence to peers already in the room
+        for (const peer of room) {
+            if (peer === this)
+                continue;
+            peer.emit("conectado", { nodoId: this.nodoId });
+            this.emit("conectado", { nodoId: peer.nodoId });
+        }
+    }
+    async enviar(destino, payload, tipoMensaje = TIPO_MENSAJE.SYNC) {
+        const room = busPorSala.get(this.roomId);
+        if (!room)
+            throw new Error("MemoryTransport no conectado");
+        const target = Array.from(room).find((t) => t.nodoId === destino);
+        if (!target)
+            throw new Error(`No hay conexion con el nodo ${destino}`);
+        const env = esEnvolvente(payload)
+            ? payload
+            : createEnvelope(tipoMensaje, this.nodoId, destino, payload);
+        target.recibir(env, this.nodoId);
+    }
+    async transmitir(payload, tipoMensaje = TIPO_MENSAJE.SYNC) {
+        const room = busPorSala.get(this.roomId);
+        if (!room)
+            return;
+        const env = esEnvolvente(payload)
+            ? payload
+            : createEnvelope(tipoMensaje, this.nodoId, "*", payload);
+        for (const peer of room) {
+            if (peer === this)
+                continue;
+            peer.recibir(env, this.nodoId);
+        }
+    }
+    recibir(env, from) {
+        if (this.deduplicator.esDuplicado(env))
+            return;
+        this.emit("mensaje", { envolvente: env, from });
+    }
+    estaConectado() {
+        return this.conectado;
+    }
+    obtenerConexiones() {
+        const room = busPorSala.get(this.roomId);
+        if (!room)
+            return [];
+        return Array.from(room)
+            .filter((t) => t !== this)
+            .map((t) => t.nodoId);
+    }
+    async cerrar() {
+        const room = busPorSala.get(this.roomId);
+        if (room) {
+            room.delete(this);
+            for (const peer of room) {
+                peer.emit("desconectado", { nodoId: this.nodoId });
+            }
+            if (room.size === 0)
+                busPorSala.delete(this.roomId);
+        }
+        this.conectado = false;
+        this.deduplicator.reiniciar();
+        this.emit("desconectado", { nodoId: this.nodoId });
+    }
+    /** Test helper: wipe all rooms (avoid cross-test pollution). */
+    static resetAll() {
+        busPorSala.clear();
+    }
+}
+function esEnvolvente(valor) {
+    if (typeof valor !== "object" || valor === null)
+        return false;
+    const candidate = valor;
+    return (typeof candidate.id === "string" &&
+        typeof candidate.tipo === "string" &&
+        typeof candidate.origen === "string" &&
+        typeof candidate.destino === "string" &&
+        typeof candidate.timestamp === "number" &&
+        candidate.payload !== undefined);
+}
+//# sourceMappingURL=memory.js.map

package/dist/transport/memory.js.map

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

package/dist/transport/peerjs.d.ts

@@ -0,0 +1,52 @@
+import type { NodoId, TipoTransporte } from "../types/index.js";
+import type { ITransport, TransportEventMap } from "./types.js";
+export interface PeerJSTransportOptions {
+    readonly peerId: string;
+    readonly host?: string;
+    readonly port?: number;
+    readonly path?: string;
+    readonly key?: string;
+    readonly debug?: number;
+    readonly config?: RTCConfiguration;
+    readonly relayUrl?: string;
+    readonly secure?: boolean;
+}
+export type { TransportEventMap };
+export declare class PeerJSTransport implements ITransport {
+    readonly tipo: TipoTransporte;
+    readonly eventTarget: EventTarget;
+    readonly nodoId: NodoId;
+    private peer;
+    /** Resolves when the underlying PeerJS peer exists (peerjs loads lazily). */
+    private readonly peerReady;
+    private readonly opciones;
+    private readonly conexiones;
+    private readonly deduplicator;
+    private conectado;
+    private reconnectAttempts;
+    private reconnectTimer?;
+    private pendingConnectionRequests;
+    constructor(nodoId: NodoId, options: PeerJSTransportOptions);
+    private iniciarPeer;
+    private programarReconexion;
+    private programarReinit;
+    private flushPendingConnections;
+    private broadcastPeerList;
+    /**
+     * Resolves when the lazily-loaded PeerJS peer has been created.
+     * Useful to wait for effective connectivity after construction.
+     */
+    whenReady(): Promise<void>;
+    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;
+    private emit;
+    private manejarConexion;
+    private manejarDatos;
+    enviar(destino: NodoId, payload: unknown, tipoMensaje?: string): Promise<void>;
+    transmitir(payload: unknown, tipoMensaje?: string): Promise<void>;
+    conectarRemoto(remotoId: string): Promise<void>;
+    estaConectado(): boolean;
+    obtenerConexiones(): readonly string[];
+    cerrar(): Promise<void>;
+}
+//# sourceMappingURL=peerjs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"peerjs.d.ts","sourceRoot":"","sources":["../../src/transport/peerjs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEX,MAAM,EAEN,cAAc,EACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIhE,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAC;AA0BlC,qBAAa,eAAgB,YAAW,UAAU;IACjD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAA0B;IACvD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,IAAI,CAAQ;IACpB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,SAAS,CAAkB;IAGnC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAM;IAC7B,OAAO,CAAC,yBAAyB,CAAqB;IAEtD,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAQ1D;YAEa,WAAW;IA8EzB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,iBAAiB;IAUzB;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/B;IAID,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACnC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI,CAEN;IAED,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACpC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI,CAKN;IAED,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,YAAY;IA+Bd,MAAM,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,WAAW,GAAE,MAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CAoBf;IAEK,UAAU,CACf,OAAO,EAAE,OAAO,EAChB,WAAW,GAAE,MAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CAoBf;IAEK,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpD;IAID,aAAa,IAAI,OAAO,CAEvB;IAED,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAErC;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B5B;CACD"}