@swal/edge-mesh 0.0.0-stage → 0.1.0

package/dist/maloca/backoffice.js

@@ -0,0 +1,40 @@
+import { createNodeMemory } from "../node-memory/index.js";
+/**
+ * Maloca Backoffice unificado que adopta edge-mesh, Xavier y node-memory.
+ */
+export class MalocaBackoffice {
+    mesh;
+    nodeMemory;
+    instanceId;
+    constructor(opts) {
+        this.mesh = opts.mesh;
+        this.instanceId = opts.instanceId;
+        this.nodeMemory = createNodeMemory({
+            mesh: opts.mesh,
+            appId: "maloca",
+            instanceId: opts.instanceId,
+            xavierUrl: opts.xavierUrl,
+            xavierToken: opts.xavierToken,
+            ttlMs: opts.ttlMs,
+        });
+    }
+    /**
+     * Persiste una sesión o decisión como un documento Y.Doc
+     */
+    async registrarSesion(doc, tipo = "sesion") {
+        await this.nodeMemory.persistYDoc(doc, tipo);
+    }
+    /**
+     * Guarda una decisión o evento semántico en la memoria del agente (Xavier)
+     */
+    async registrarDecision(descripcion, titulo) {
+        await this.nodeMemory.saveMemory(descripcion, titulo, "decisiones");
+    }
+    /**
+     * Recupera RAG/decisiones desde Xavier
+     */
+    async buscarDecisiones(query, limit) {
+        return this.nodeMemory.loadFromXavier(`app/maloca/instance/${this.instanceId}`, query, limit);
+    }
+}
+//# sourceMappingURL=backoffice.js.map

package/dist/maloca/backoffice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoffice.js","sourceRoot":"","sources":["../../src/maloca/backoffice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,yBAAyB,CAAC;AAU5E;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAW;IACf,UAAU,CAAa;IACvB,UAAU,CAAS;IAE5B,YAAY,IAA6B;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAElC,IAAI,CAAC,UAAU,GAAG,gBAAgB,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,GAAQ,EAAE,IAAI,GAAG,QAAQ;QAC9C,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,WAAmB,EAAE,MAAc;QAC1D,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,KAAc;QACnD,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CACpC,uBAAuB,IAAI,CAAC,UAAU,EAAE,EACxC,KAAK,EACL,KAAK,CACL,CAAC;IACH,CAAC;CACD"}

package/dist/maloca/event-bus.d.ts

@@ -0,0 +1,60 @@
+import type { MeshManager } from "../mesh/index.js";
+import type { OpLog } from "../op-log/index.js";
+import { type IStorage } from "../storage/index.js";
+import type { NodoId } from "../types/index.js";
+export declare const TIPO_EVENTO_MALOCA: {
+    readonly NODE_CONNECT: "NODE_CONNECT";
+    readonly NODE_DISCONNECT: "NODE_DISCONNECT";
+    readonly PROFILE_CREATED: "PROFILE_CREATED";
+    readonly PROFILE_UPDATED: "PROFILE_UPDATED";
+    readonly KARMA_TRANSACTION: "KARMA_TRANSACTION";
+    readonly PLUGIN_REGISTERED: "PLUGIN_REGISTERED";
+    readonly PLUGIN_DISCOVERED: "PLUGIN_DISCOVERED";
+    readonly DOC_NOTARIZED: "DOC_NOTARIZED";
+    readonly MESH_HEARTBEAT: "MESH_HEARTBEAT";
+};
+export type TipoEventoMaloca = (typeof TIPO_EVENTO_MALOCA)[keyof typeof TIPO_EVENTO_MALOCA];
+export interface EventoMaloca {
+    readonly tipo: TipoEventoMaloca | string;
+    readonly origen: NodoId;
+    readonly destino?: NodoId | "*";
+    readonly payload: unknown;
+    readonly firma?: Uint8Array;
+    readonly timestamp: number;
+}
+export interface MeshEvent extends EventoMaloca {
+}
+export interface PersistentEventQueue {
+    enqueue(event: MeshEvent): Promise<void>;
+    dequeueAll(): Promise<MeshEvent[]>;
+    replay(namespace: string): Promise<MeshEvent[]>;
+    clear(): Promise<void>;
+    size(): Promise<number>;
+}
+export declare class PersistentEventQueueImpl implements PersistentEventQueue {
+    private readonly storage;
+    private readonly namespace;
+    constructor(storage: IStorage, namespace: string);
+    enqueue(event: MeshEvent): Promise<void>;
+    dequeueAll(): Promise<MeshEvent[]>;
+    replay(namespace: string): Promise<MeshEvent[]>;
+    clear(): Promise<void>;
+    size(): Promise<number>;
+}
+export declare class EventBus extends EventTarget {
+    private readonly mesh;
+    private readonly opLog;
+    private readonly handlers;
+    private readonly NAMESPACE;
+    readonly queue: PersistentEventQueue;
+    constructor(mesh: MeshManager, opLog: OpLog, storage?: IStorage);
+    emit(tipo: TipoEventoMaloca | string, payload: unknown, destino?: NodoId | "*"): Promise<void>;
+    subscribe(tipo: TipoEventoMaloca | string, handler: (evento: EventoMaloca) => void): void;
+    unsubscribe(tipo: TipoEventoMaloca | string, handler: (evento: EventoMaloca) => void): void;
+    broadcastToPlugin(_pluginId: string, evento: Omit<EventoMaloca, "origen" | "timestamp" | "destino">): Promise<void>;
+    getEventLog(): Promise<readonly EventoMaloca[]>;
+    private reconnectHandler;
+    private procesarEventoRemoto;
+    private notificarHandlers;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/maloca/event-bus.d.ts.map

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

package/dist/maloca/event-bus.js

@@ -0,0 +1,175 @@
+import { InMemoryStorage } from "../storage/index.js";
+// ─── EVENT TYPES ───────────────────────────────────────────────────────────
+export const TIPO_EVENTO_MALOCA = {
+    NODE_CONNECT: "NODE_CONNECT",
+    NODE_DISCONNECT: "NODE_DISCONNECT",
+    PROFILE_CREATED: "PROFILE_CREATED",
+    PROFILE_UPDATED: "PROFILE_UPDATED",
+    KARMA_TRANSACTION: "KARMA_TRANSACTION",
+    PLUGIN_REGISTERED: "PLUGIN_REGISTERED",
+    PLUGIN_DISCOVERED: "PLUGIN_DISCOVERED",
+    DOC_NOTARIZED: "DOC_NOTARIZED",
+    MESH_HEARTBEAT: "MESH_HEARTBEAT",
+};
+export class PersistentEventQueueImpl {
+    storage;
+    namespace;
+    constructor(storage, namespace) {
+        this.storage = storage;
+        this.namespace = namespace;
+    }
+    async enqueue(event) {
+        const key = `events:bus:${this.namespace}:${event.timestamp}:${Math.random().toString(36).substring(2, 9)}`;
+        await this.storage.set(key, event);
+    }
+    async dequeueAll() {
+        return this.replay(this.namespace);
+    }
+    async replay(namespace) {
+        const prefix = `events:bus:${namespace}`;
+        const entries = await this.storage.list({ prefijo: prefix });
+        const now = Date.now();
+        const validEvents = [];
+        for (const entry of entries) {
+            const event = entry.valor;
+            if (now - event.timestamp < 3600000) {
+                validEvents.push(event);
+            }
+            await this.storage.delete(entry.key);
+        }
+        return validEvents;
+    }
+    async clear() {
+        const prefix = `events:bus:${this.namespace}`;
+        await this.storage.clear(prefix);
+    }
+    async size() {
+        const prefix = `events:bus:${this.namespace}`;
+        const entries = await this.storage.list({ prefijo: prefix });
+        const now = Date.now();
+        let count = 0;
+        for (const entry of entries) {
+            const event = entry.valor;
+            if (now - event.timestamp < 3600000) {
+                count++;
+            }
+            else {
+                await this.storage.delete(entry.key);
+            }
+        }
+        return count;
+    }
+}
+// ─── EVENT BUS ─────────────────────────────────────────────────────────────
+export class EventBus extends EventTarget {
+    mesh;
+    opLog;
+    handlers;
+    NAMESPACE = "_maloca:events";
+    queue;
+    constructor(mesh, opLog, storage) {
+        super();
+        this.mesh = mesh;
+        this.opLog = opLog;
+        this.handlers = new Map();
+        const actualStorage = storage ??
+            opLog.storage ??
+            new InMemoryStorage();
+        this.queue = new PersistentEventQueueImpl(actualStorage, this.NAMESPACE);
+        // Unir a namespace para ruteo de gossip
+        void this.mesh.unirANamespace(this.NAMESPACE);
+        // Escuchar eventos de la red
+        this.mesh.addEventListener("gossipRecibido", (ev) => {
+            const customEv = ev;
+            const { mensaje } = customEv.detail;
+            if (mensaje.namespace === this.NAMESPACE) {
+                this.procesarEventoRemoto(mensaje.payload);
+            }
+        });
+        // Replay automático al reconectar
+        this.mesh.addEventListener("peerConectado", () => {
+            void this.reconnectHandler();
+        });
+    }
+    async emit(tipo, payload, destino = "*") {
+        const evento = {
+            tipo,
+            origen: this.mesh.config.nodoId,
+            destino,
+            payload,
+            timestamp: Date.now(),
+        };
+        // Registrar en OpLog local
+        await this.opLog.append(`event:${tipo}`, evento, this.mesh.config.nodoId);
+        // Emitir localmente
+        this.notificarHandlers(evento);
+        // Si es para toda la red o un nodo remoto
+        if (destino === "*" || destino !== this.mesh.config.nodoId) {
+            const peers = this.mesh.obtenerPeersEnNamespace(this.NAMESPACE);
+            if (peers.length === 0) {
+                await this.queue.enqueue(evento);
+            }
+            else {
+                await this.mesh.transmitirConGossip(this.NAMESPACE, evento);
+            }
+        }
+    }
+    subscribe(tipo, handler) {
+        const tipoStr = tipo;
+        let set = this.handlers.get(tipoStr);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(tipoStr, set);
+        }
+        set.add(handler);
+    }
+    unsubscribe(tipo, handler) {
+        const set = this.handlers.get(tipo);
+        if (set) {
+            set.delete(handler);
+        }
+    }
+    async broadcastToPlugin(_pluginId, evento) {
+        await this.emit(evento.tipo, evento.payload);
+    }
+    async getEventLog() {
+        const ops = await this.opLog.obtenerTodas();
+        return ops
+            .filter((op) => op.tipo.startsWith("event:"))
+            .map((op) => op.datos);
+    }
+    async reconnectHandler() {
+        const peers = this.mesh.obtenerPeersEnNamespace(this.NAMESPACE);
+        if (peers.length > 0) {
+            const eventsToReplay = await this.queue.dequeueAll();
+            for (const event of eventsToReplay) {
+                await this.mesh.transmitirConGossip(this.NAMESPACE, event);
+            }
+        }
+    }
+    procesarEventoRemoto(evento) {
+        // Evitar procesar eventos propios que vuelvan por gossip (aunque MeshManager ya lo hace)
+        if (evento.origen === this.mesh.config.nodoId)
+            return;
+        // Verificar si es para nosotros o broadcast
+        if (evento.destino === "*" || evento.destino === this.mesh.config.nodoId) {
+            this.notificarHandlers(evento);
+        }
+    }
+    notificarHandlers(evento) {
+        const handlers = this.handlers.get(evento.tipo);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(evento);
+                }
+                catch (err) {
+                    console.error(`Error en handler de evento ${evento.tipo}:`, err);
+                }
+            }
+        }
+        // También emitir vía EventTarget estándar
+        this.dispatchEvent(new CustomEvent(evento.tipo, { detail: evento }));
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/maloca/event-bus.js.map

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

package/dist/maloca/evidentia.d.ts

@@ -0,0 +1,136 @@
+import type { PostQuantumIdentity } from "../identity/index.js";
+import type { MeshManager } from "../mesh/index.js";
+import type { NodoId, ParPublico } from "../types/index.js";
+import type { PolygonBridge } from "./polygon-bridge.js";
+/**
+ * Bloque de procedencia: quien emitio la evidencia, cuando, y QUE respalda.
+ *
+ * Sin el, una notarizacion es solo una afirmacion firmada: la firma prueba que
+ * alguna clave dijo algo, pero no sobre que se estaba atestiguando. En el mesh
+ * medico (medicos verificados) el sujeto de la atestiguacion es justamente el
+ * punto: "un medico acreditado atestigua que este registro de vacunacion es
+ * cierto" debe ser distinguible de "un nodo dijo algo sobre un documento".
+ */
+export interface Procedencia {
+    /** Fecha de emision (epoch ms). */
+    readonly fechaEmision: number;
+    /** Nodo emisor. Debe coincidir con `Evidentia.emisor` (se comprueba al verificar). */
+    readonly emisor: NodoId;
+    /** Que respalda realmente la evidencia, en palabras del emisor. */
+    readonly queRespalda: string;
+    /** Etiqueta legible del emisor (p. ej. "Cardenal XYZ, licencia 1234"). */
+    readonly descripcionEmisor?: string;
+    /** Puntero opcional a la prueba subyacente (id externo, hash, URL). */
+    readonly referencia?: string;
+}
+export interface Evidentia {
+    readonly hash: string;
+    readonly tipo: string;
+    readonly contenidoHash: string;
+    readonly emisor: NodoId;
+    readonly firmaPQC: string;
+    readonly red: string;
+    readonly confirmaciones: number;
+    readonly timestamp: number;
+    /** Bloque de procedencia firmado. Obligatorio: una evidencia sin el se rechaza. */
+    readonly procedencia: Procedencia;
+}
+/** Resultado de una verificacion completa, con el motivo del rechazo. */
+export interface VerificacionEvidencia {
+    readonly valido: boolean;
+    readonly motivo: string;
+}
+/**
+ * Campos exactos cubiertos por la firma ML-DSA-65.
+ *
+ * `hash`, `firmaPQC`, `confirmaciones` y `red` se excluyen a proposito: son
+ * derivados, mutables o metadatos de transporte. Todo lo que aporta significado
+ * (que, quien, cuando, que prueba) SI va firmado.
+ */
+export interface EvidentiaFirmada {
+    readonly version: 1;
+    readonly tipo: string;
+    readonly contenidoHash: string;
+    readonly emisor: NodoId;
+    readonly timestamp: number;
+    readonly procedencia: Procedencia;
+}
+/** Serializacion canonica de bytes del cuerpo firmado (mensaje ML-DSA). */
+export declare function canonicalEvidentiaBytes(cuerpo: EvidentiaFirmada): Uint8Array;
+/** Construye el cuerpo firmado a partir de una Evidentia completa. */
+export declare function cuerpoFirmado(ev: Evidentia): EvidentiaFirmada;
+export declare class EvidentiaManager extends EventTarget {
+    private readonly identity;
+    private readonly mesh;
+    private readonly evidentias;
+    private readonly NAMESPACE;
+    private readonly bridge?;
+    /** Claves publicas de emisores conocidas fuera de banda. Nunca se leen de una evidencia. */
+    private readonly clavesPublicas;
+    constructor(identity: PostQuantumIdentity, mesh: MeshManager, bridge?: PolygonBridge);
+    /**
+     * Registra una clave publica de emisor. Solo pueden registrarse aqui claves
+     * obtenidas por un canal de confianza (handshake de identidad, roster de
+     * administracion) — `verify()` se niega a confiar en una pubkey que viaje
+     * dentro de la misma evidencia que se le pide validar.
+     */
+    registrarEmisor(emisor: NodoId | string, parPublico: ParPublico): void;
+    clavePublicaDe(emisor: NodoId | string): ParPublico | undefined;
+    notarize(contenido: unknown, tipo: string, procedencia?: Partial<Procedencia>): Promise<Evidentia>;
+    /**
+     * Verificacion completa de una evidencia conocida localmente.
+     *
+     * Devuelve false (y emite `evidenciaRechazada`) salvo que pase TODAS las
+     * comprobaciones: integridad del id, coherencia de la procedencia, clave de
+     * emisor registrada, y una firma ML-DSA-65 valida sobre el cuerpo canonico.
+     *
+     * La verificacion on-chain del bridge, cuando existe, sigue siendo una fuente
+     * valida: un anchor confirmado en cadena prueba que el hash quedo anclado. Pero
+     * ya no es la UNICA via — antes, si el bridge fallaba, caia a `return true`, es
+     * decir: verificacion que en realidad no verificaba nada.
+     */
+    verify(hash: string): Promise<boolean>;
+    /**
+     * Verifica una evidencia recibida de la red (aun no confiable localmente).
+     * Mismas comprobaciones que `verify()`; la usan quienes ingieren pruebas
+     * gosseadas y deben rechazar todo lo que no puedan atribuir criptograficamente.
+     */
+    verificarEvidentia(ev: Evidentia): Promise<VerificacionEvidencia>;
+    getProof(hash: string): Evidentia | null;
+    getBridge(): PolygonBridge | undefined;
+    private calcularHashNotarizacion;
+    broadcastToBlockchain(evidentia: Evidentia): Promise<void>;
+}
+export interface Leaf {
+    readonly id: string;
+    readonly hash: string;
+    readonly timestamp: number;
+    readonly data?: unknown;
+}
+export declare class MerkleTree {
+    private leaves;
+    private root;
+    private buildPromise;
+    private buildGeneration;
+    signature?: string;
+    constructor(leaves?: Leaf[]);
+    getLeaves(): Leaf[];
+    toJSON(): {
+        leaves: Leaf[];
+        signature?: string;
+    };
+    add(leaf: Leaf): Promise<void>;
+    getRoot(): Promise<string>;
+    private rebuild;
+    verify(leaf: Leaf, proof: string[]): Promise<boolean>;
+    getProof(leaf: Leaf): Promise<string[]>;
+}
+export declare function hashLeaf(leaf: Leaf): Promise<string>;
+export interface MerkleMergeResult {
+    mergedTree: MerkleTree;
+    conflictCount: number;
+    resolvedLeaves: Leaf[];
+    pendingLeaves: Leaf[];
+}
+export declare function mergeMerkleTrees(treeA: MerkleTree, treeB: MerkleTree, identity?: PostQuantumIdentity): Promise<MerkleMergeResult>;
+//# sourceMappingURL=evidentia.d.ts.map

package/dist/maloca/evidentia.d.ts.map

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