@swal/edge-mesh 0.0.0-stage → 0.1.0

package/dist/presence/index.js

@@ -0,0 +1,255 @@
+import { createPostQuantumIdentity, generateKeypair, } from "../identity/index.js";
+import { canonicalStringify } from "../protocol/canonical.js";
+import { HealthChecker } from "./health.js";
+// ─── CONSTANTS ─────────────────────────────────────────────────────────────
+const CONFIG_POR_DEFECTO = {
+    heartbeatIntervalMs: 5_000,
+    timeoutMs: 15_000,
+    maxFallosConsecutivos: 3,
+    latenciaAltaMs: 500,
+    anuncioIntervalMs: 30_000,
+};
+export class MeshPresence {
+    static onlineNodes = new Set();
+    static isOnline(peerId) {
+        return MeshPresence.onlineNodes.has(peerId);
+    }
+    static setOnline(peerId, online) {
+        if (online) {
+            MeshPresence.onlineNodes.add(peerId);
+        }
+        else {
+            MeshPresence.onlineNodes.delete(peerId);
+        }
+    }
+    static clear() {
+        MeshPresence.onlineNodes.clear();
+    }
+}
+export class PresenceManager {
+    eventTarget;
+    healthChecker;
+    config;
+    nodosConocidos;
+    nodosAparecieron;
+    transmitirHandler = null;
+    intervaloAnuncio = null;
+    onOnlineCallbacks = new Set();
+    peerId;
+    localIdentity;
+    publicKeys = new Map();
+    defaultIdentityValue;
+    mesh = {
+        broadcast: async (topic, payload) => {
+            if (this.transmitirHandler) {
+                await this.transmitirHandler(payload);
+            }
+        },
+    };
+    constructor(config = {}) {
+        this.eventTarget = new EventTarget();
+        this.config = { ...CONFIG_POR_DEFECTO, ...config };
+        this.nodosConocidos = new Set();
+        this.nodosAparecieron = new Set();
+        const healthConfig = {
+            heartbeatIntervalMs: this.config.heartbeatIntervalMs,
+            timeoutMs: this.config.timeoutMs,
+            maxFallosConsecutivos: this.config.maxFallosConsecutivos,
+            latenciaAltaMs: this.config.latenciaAltaMs,
+        };
+        this.healthChecker = new HealthChecker(healthConfig);
+        this.healthChecker.on("nodoCaido", (ev) => {
+            this.nodosConocidos.delete(ev.detail.nodoId);
+            this.emit("nodoDesaparecio", { nodoId: ev.detail.nodoId });
+            MeshPresence.setOnline(ev.detail.nodoId, false);
+        });
+        this.healthChecker.on("saludCambiada", (ev) => {
+            this.emit("estadoSaludCambiado", {
+                nodoId: ev.detail.nodoId,
+                estado: ev.detail.estadoNuevo,
+            });
+        });
+        this.healthChecker.on("heartbeatRecibido", (ev) => {
+            if (!this.nodosAparecieron.has(ev.detail.nodoId)) {
+                this.nodosAparecieron.add(ev.detail.nodoId);
+                if (!this.nodosConocidos.has(ev.detail.nodoId)) {
+                    this.nodosConocidos.add(ev.detail.nodoId);
+                    this.emit("nodoAparecio", { nodoId: ev.detail.nodoId });
+                }
+            }
+            this.emit("latenciaActualizada", {
+                nodoId: ev.detail.nodoId,
+                latenciaMs: ev.detail.latenciaMs,
+            });
+            MeshPresence.setOnline(ev.detail.nodoId, true);
+            this.onOnline(ev.detail.nodoId);
+        });
+    }
+    // ─── INICIO / DETENCION ──────────────────────────────────────────────
+    async iniciar(nodoId, transmitir, identity) {
+        this.peerId = nodoId;
+        this.transmitirHandler = transmitir;
+        if (identity) {
+            this.localIdentity = identity;
+            this.registrarClavePublica(nodoId, identity.exportarPublico());
+        }
+        this.healthChecker.iniciar();
+        this.intervaloAnuncio = setInterval(() => {
+            this.anunciarPresencia(nodoId);
+        }, this.config.anuncioIntervalMs);
+        // Anuncio inicial
+        this.anunciarPresencia(nodoId);
+    }
+    detener() {
+        this.healthChecker.detener();
+        if (this.intervaloAnuncio !== null) {
+            clearInterval(this.intervaloAnuncio);
+            this.intervaloAnuncio = null;
+        }
+        this.nodosConocidos.clear();
+        this.nodosAparecieron.clear();
+        this.transmitirHandler = null;
+    }
+    registrarClavePublica(nodoId, parPublico) {
+        this.publicKeys.set(nodoId, parPublico);
+    }
+    getPublicKey(peerId) {
+        return this.publicKeys.get(peerId);
+    }
+    get defaultIdentity() {
+        if (!this.defaultIdentityValue) {
+            this.defaultIdentityValue = createPostQuantumIdentity("default-presence", generateKeypair("ephemera"));
+            // Also register its public key
+            this.registrarClavePublica("default-presence", this.defaultIdentityValue.exportarPublico());
+        }
+        return this.defaultIdentityValue;
+    }
+    async sendHeartbeat(identity) {
+        const payload = {
+            peerId: this.peerId,
+            timestamp: Date.now(),
+            status: "online",
+        };
+        const canonical = canonicalStringify(payload);
+        payload.signature = await identity.sign(canonical);
+        await this.mesh.broadcast("presence:heartbeat", payload);
+    }
+    async onHeartbeat(peerId, signed, identity) {
+        // Verify timestamp is within 30s window (A-03 / replay defense)
+        const ahora = Date.now();
+        if (Math.abs(ahora - signed.timestamp) > 30_000) {
+            return false;
+        }
+        const payload = {
+            peerId: signed.peerId,
+            timestamp: signed.timestamp,
+            status: signed.status,
+        };
+        const publicKey = this.getPublicKey(peerId);
+        if (!publicKey) {
+            return false;
+        }
+        return identity.verify(canonicalStringify(payload), signed.signature, publicKey);
+    }
+    async anunciarPresencia(nodoId) {
+        if (this.transmitirHandler === null)
+            return;
+        if (this.localIdentity) {
+            await this.sendHeartbeat(this.localIdentity).catch(() => {
+                // Ignorar errores de transmision
+            });
+        }
+        else {
+            const heartbeat = this.healthChecker.generarHeartbeat(nodoId);
+            await this.transmitirHandler(heartbeat).catch(() => {
+                // Ignorar errores de transmision
+            });
+        }
+    }
+    // ─── PROCESAR PRESENCIA ──────────────────────────────────────────────
+    async procesarHeartbeat(datos) {
+        if (esSignedHeartbeat(datos)) {
+            const identityToUse = this.localIdentity || this.defaultIdentity;
+            const ok = await this.onHeartbeat(datos.peerId, datos, identityToUse);
+            if (ok) {
+                this.healthChecker.recibirHeartbeat(datos.peerId, datos.timestamp);
+            }
+        }
+        else if (esHeartbeatValido(datos)) {
+            this.healthChecker.recibirHeartbeat(datos.nodoId, datos.timestamp);
+        }
+    }
+    // ─── CONSULTAS ───────────────────────────────────────────────────────
+    obtenerNodosActivos() {
+        return this.healthChecker.obtenerNodosActivos();
+    }
+    obtenerNodosConocidos() {
+        return Array.from(this.nodosConocidos);
+    }
+    obtenerSalud(nodoId) {
+        return this.healthChecker.obtenerSalud(nodoId);
+    }
+    obtenerLatencia(nodoId) {
+        return this.healthChecker.obtenerLatencia(nodoId);
+    }
+    obtenerTotalNodos() {
+        return this.nodosConocidos.size;
+    }
+    onOnline(peerId, callback) {
+        if (callback) {
+            this.onOnlineCallbacks.add(callback);
+        }
+        else {
+            for (const cb of this.onOnlineCallbacks) {
+                try {
+                    cb(peerId);
+                }
+                catch (e) {
+                    console.error("Error in onOnline callback:", e);
+                }
+            }
+        }
+    }
+    /**
+     * Registra un listener global que se invoca con el peerId cuando un nodo
+     * pasa a online (sin requerir el peerId en la llamada).
+     */
+    addOnlineListener(callback) {
+        this.onOnlineCallbacks.add(callback);
+    }
+    // ─── EVENTOS ─────────────────────────────────────────────────────────
+    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);
+    }
+    reiniciar() {
+        this.detener();
+        this.healthChecker.reiniciar();
+        this.nodosConocidos.clear();
+        this.nodosAparecieron.clear();
+    }
+}
+function esHeartbeatValido(valor) {
+    if (typeof valor !== "object" || valor === null)
+        return false;
+    const hb = valor;
+    return (typeof hb.nodoId === "string" &&
+        typeof hb.timestamp === "number" &&
+        typeof hb.secuencia === "number");
+}
+function esSignedHeartbeat(valor) {
+    if (typeof valor !== "object" || valor === null)
+        return false;
+    const hb = valor;
+    return (typeof hb.peerId === "string" &&
+        typeof hb.timestamp === "number" &&
+        (hb.status === "online" || hb.status === "away" || hb.status === "busy") &&
+        typeof hb.signature === "string");
+}
+//# sourceMappingURL=index.js.map

package/dist/presence/index.js.map

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

package/dist/presence/peer-health.d.ts

@@ -0,0 +1,40 @@
+export type PeerHealthStatus = "healthy" | "stale" | "offline";
+export interface PeerHealthState {
+    readonly peerId: string;
+    readonly status: PeerHealthStatus;
+    readonly lastSeen: number;
+    readonly lastPingAt?: number;
+    readonly lastPongAt?: number;
+}
+export interface PeerHealthMonitorOptions {
+    readonly staleAfterMs?: number;
+    readonly offlineAfterMs?: number;
+    readonly now?: () => number;
+}
+export interface ReconnectDelayOptions {
+    readonly initialDelayMs?: number;
+    readonly maxDelayMs?: number;
+    readonly jitterRatio?: number;
+    readonly random?: () => number;
+}
+type HealthEventName = "peer:healthy" | "peer:stale" | "peer:offline" | "sync:error";
+export type PeerHealthEventPayload = PeerHealthState | {
+    peerId: string;
+    error: unknown;
+};
+export interface PeerHealthMonitor {
+    on(eventName: HealthEventName, listener: (...args: never[]) => void): PeerHealthMonitor;
+    off(eventName: HealthEventName, listener: (...args: never[]) => void): PeerHealthMonitor;
+    markConnected(peerId: string): PeerHealthState;
+    markPing(peerId: string): PeerHealthState;
+    markPong(peerId: string): PeerHealthState;
+    markOffline(peerId: string): PeerHealthState;
+    reportSyncError(peerId: string, error: unknown): void;
+    sweep(): PeerHealthState[];
+    get(peerId: string): PeerHealthState | undefined;
+    list(): PeerHealthState[];
+}
+export declare function getReconnectDelay(attempt: number, options?: ReconnectDelayOptions): number;
+export declare function createPeerHealthMonitor(options?: PeerHealthMonitorOptions): PeerHealthMonitor;
+export {};
+//# sourceMappingURL=peer-health.d.ts.map

package/dist/presence/peer-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-health.d.ts","sourceRoot":"","sources":["../../src/presence/peer-health.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,KAAK,eAAe,GACjB,cAAc,GACd,YAAY,GACZ,cAAc,GACd,YAAY,CAAC;AAEhB,MAAM,MAAM,sBAAsB,GAC/B,eAAe,GACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IAGjC,EAAE,CACD,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAClC,iBAAiB,CAAC;IACrB,GAAG,CACF,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAClC,iBAAiB,CAAC;IACrB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAC1C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAC7C,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtD,KAAK,IAAI,eAAe,EAAE,CAAC;IAC3B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACjD,IAAI,IAAI,eAAe,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAA0B,GACjC,MAAM,CAYR;AAiID,wBAAgB,uBAAuB,CACtC,OAAO,GAAE,wBAA6B,GACpC,iBAAiB,CAEnB"}

package/dist/presence/peer-health.js

@@ -0,0 +1,118 @@
+// ─── PEER HEALTH MONITOR + RECONNECT BACKOFF ───────────────────────────────
+// Lightweight helpers used by app-layer transports (e.g. p2p-mesh-core).
+export function getReconnectDelay(attempt, options = {}) {
+    const initialDelayMs = options.initialDelayMs ?? 1_000;
+    const maxDelayMs = options.maxDelayMs ?? 30_000;
+    const jitterRatio = options.jitterRatio ?? 0;
+    const baseDelay = Math.min(initialDelayMs * 2 ** Math.max(0, attempt), maxDelayMs);
+    if (jitterRatio <= 0)
+        return baseDelay;
+    const random = options.random ?? Math.random;
+    const jitter = baseDelay * jitterRatio * random();
+    return Math.min(Math.round(baseDelay + jitter), maxDelayMs);
+}
+class PeerHealthMonitorImpl {
+    peers = new Map();
+    listeners = new Map();
+    now;
+    staleAfterMs;
+    offlineAfterMs;
+    constructor(options = {}) {
+        this.now = options.now ?? (() => Date.now());
+        this.staleAfterMs = options.staleAfterMs ?? 30_000;
+        this.offlineAfterMs = options.offlineAfterMs ?? 60_000;
+    }
+    on(eventName, listener) {
+        const set = this.listeners.get(eventName) ?? new Set();
+        set.add(listener);
+        this.listeners.set(eventName, set);
+        return this;
+    }
+    off(eventName, listener) {
+        this.listeners
+            .get(eventName)
+            ?.delete(listener);
+        return this;
+    }
+    emit(eventName, payload) {
+        const set = this.listeners.get(eventName);
+        if (!set)
+            return;
+        for (const listener of set)
+            listener(payload);
+    }
+    markConnected(peerId) {
+        return this.setStatus(peerId, "healthy", { lastSeen: this.now() });
+    }
+    markPing(peerId) {
+        const current = this.getOrCreate(peerId);
+        return this.setStatus(peerId, current.status, { lastPingAt: this.now() });
+    }
+    markPong(peerId) {
+        return this.setStatus(peerId, "healthy", {
+            lastSeen: this.now(),
+            lastPongAt: this.now(),
+        });
+    }
+    markOffline(peerId) {
+        return this.setStatus(peerId, "offline", {
+            lastSeen: this.getOrCreate(peerId).lastSeen,
+        });
+    }
+    reportSyncError(peerId, error) {
+        this.emit("sync:error", { peerId, error });
+    }
+    sweep() {
+        const now = this.now();
+        const changed = [];
+        for (const state of this.peers.values()) {
+            if (state.status === "offline")
+                continue;
+            const age = now - state.lastSeen;
+            if (age >= this.offlineAfterMs) {
+                changed.push(this.setStatus(state.peerId, "offline"));
+            }
+            else if (age >= this.staleAfterMs && state.status !== "stale") {
+                changed.push(this.setStatus(state.peerId, "stale"));
+            }
+        }
+        return changed;
+    }
+    get(peerId) {
+        const state = this.peers.get(peerId);
+        return state ? { ...state } : undefined;
+    }
+    list() {
+        return Array.from(this.peers.values()).map((state) => ({ ...state }));
+    }
+    getOrCreate(peerId) {
+        const existing = this.peers.get(peerId);
+        if (existing)
+            return existing;
+        const state = {
+            peerId,
+            status: "healthy",
+            lastSeen: this.now(),
+        };
+        this.peers.set(peerId, state);
+        return state;
+    }
+    setStatus(peerId, status, patch = {}) {
+        const previous = this.getOrCreate(peerId);
+        const next = {
+            ...previous,
+            ...patch,
+            peerId,
+            status,
+        };
+        this.peers.set(peerId, next);
+        if (previous.status !== next.status || status === "healthy") {
+            this.emit(`peer:${status}`, { ...next });
+        }
+        return { ...next };
+    }
+}
+export function createPeerHealthMonitor(options = {}) {
+    return new PeerHealthMonitorImpl(options);
+}
+//# sourceMappingURL=peer-health.js.map

package/dist/presence/peer-health.js.map

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

package/dist/protocol/canonical.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Deterministic stringify of any value by sorting object keys alphabetically.
+ * Uint8Array instances are serialized as their hex representation.
+ */
+export declare function canonicalStringify(val: any): string;
+/**
+ * Returns canonical byte serialization of any value.
+ */
+export declare function canonicalSerialize(val: any): Uint8Array;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/protocol/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/protocol/canonical.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAwBnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAEvD"}

package/dist/protocol/canonical.js

@@ -0,0 +1,32 @@
+import { bytesAHex } from "./utils.js";
+/**
+ * Deterministic stringify of any value by sorting object keys alphabetically.
+ * Uint8Array instances are serialized as their hex representation.
+ */
+export function canonicalStringify(val) {
+    if (val === null || val === undefined) {
+        return "null";
+    }
+    if (val instanceof Uint8Array) {
+        return JSON.stringify(bytesAHex(val));
+    }
+    if (typeof val !== "object") {
+        return JSON.stringify(val);
+    }
+    if (Array.isArray(val)) {
+        return "[" + val.map((v) => canonicalStringify(v)).join(",") + "]";
+    }
+    const keys = Object.keys(val).sort();
+    return ("{" +
+        keys
+            .map((k) => `${JSON.stringify(k)}:${canonicalStringify(val[k])}`)
+            .join(",") +
+        "}");
+}
+/**
+ * Returns canonical byte serialization of any value.
+ */
+export function canonicalSerialize(val) {
+    return new TextEncoder().encode(canonicalStringify(val));
+}
+//# sourceMappingURL=canonical.js.map

package/dist/protocol/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/protocol/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IAC1C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC;IACf,CAAC;IACD,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,CACN,GAAG;QACH,IAAI;aACF,GAAG,CACH,CAAC,CAAC,EAAE,EAAE,CACL,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAE,GAA+B,CAAC,CAAC,CAAC,CAAC,EAAE,CAClF;aACA,IAAI,CAAC,GAAG,CAAC;QACX,GAAG,CACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IAC1C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC"}