@swal/edge-mesh 0.0.0-stage → 0.1.0

package/dist/governance/index.js

@@ -0,0 +1,210 @@
+import { hexABytes } from "../protocol/utils.js";
+import { POLITICA_GOBERNANZA } from "../types/index.js";
+// ─── CONSTANTS ─────────────────────────────────────────────────────────────
+const POLITICA_POR_DEFECTO = {
+    politica: POLITICA_GOBERNANZA.DEMOCRATICA,
+    umbral: 0.51,
+    ventanaMs: 30_000,
+    pesoNodo: {},
+    reglas: [],
+};
+export const ESTADO_PROPUESTA = {
+    ABIERTA: "abierta",
+    APROBADA: "aprobada",
+    RECHAZADA: "rechazada",
+    EXPIRADA: "expirada",
+};
+export class GovernanceManager {
+    eventTarget;
+    politica;
+    propuestas;
+    timers;
+    verificador;
+    requireSignedVotes;
+    constructor(politica, verificador, options) {
+        this.eventTarget = new EventTarget();
+        this.politica = { ...POLITICA_POR_DEFECTO, ...politica };
+        this.propuestas = new Map();
+        this.timers = new Map();
+        this.verificador = verificador;
+        this.requireSignedVotes = options?.requireSignedVotes ?? false;
+    }
+    // ─── PROPUESTAS ───────────────────────────────────────────────────────
+    crearPropuesta(id, tipo, proponente, datos, expiracionMs) {
+        const expiracion = expiracionMs ?? this.politica.ventanaMs;
+        const propuesta = {
+            id,
+            tipo,
+            proponente,
+            datos,
+            timestamp: Date.now(),
+            expiracion: Date.now() + expiracion,
+            votos: [],
+            estado: ESTADO_PROPUESTA.ABIERTA,
+        };
+        this.propuestas.set(id, propuesta);
+        const timer = setTimeout(() => {
+            this.cerrarPropuesta(id);
+        }, expiracion);
+        this.timers.set(id, timer);
+        this.emit("propuestaCreada", { propuesta });
+        return propuesta;
+    }
+    votar(id, voto) {
+        const propuesta = this.propuestas.get(id);
+        if (propuesta === undefined)
+            return false;
+        if (propuesta.estado !== ESTADO_PROPUESTA.ABIERTA)
+            return false;
+        if (Date.now() > propuesta.expiracion)
+            return false;
+        // Requerir firma estricta si configurado
+        if (this.requireSignedVotes && !voto.firma) {
+            return false;
+        }
+        // Verificación criptográfica si hay verificador y firma
+        if (this.verificador && voto.firma) {
+            const clavePublica = this.verificador.obtenerClavePublica(voto.nodoId);
+            if (!clavePublica)
+                return false;
+            const mensajeBytes = new TextEncoder().encode(JSON.stringify({
+                propuestaId: id,
+                nodoId: voto.nodoId,
+                voto: voto.voto,
+                timestamp: voto.timestamp,
+            }));
+            const firmaBytes = typeof voto.firma === "string"
+                ? hexABytes(voto.firma)
+                : voto.firma instanceof Uint8Array
+                    ? voto.firma
+                    : new Uint8Array(voto.firma);
+            const valido = this.verificador.verificarFirma(mensajeBytes, firmaBytes, clavePublica);
+            if (!valido)
+                return false;
+        }
+        // Evitar voto duplicado del mismo nodo
+        const yaVoto = propuesta.votos.some((v) => v.nodoId === voto.nodoId);
+        if (yaVoto)
+            return false;
+        const nuevosVotos = [...propuesta.votos, voto];
+        propuesta.votos = nuevosVotos;
+        this.propuestas.set(id, propuesta);
+        this.emit("votoRecibido", { propuesta: id, voto });
+        // Verificar si ya se alcanzó el umbral
+        if (this.verificarUmbral(propuesta)) {
+            this.cerrarPropuesta(id, ESTADO_PROPUESTA.APROBADA);
+        }
+        return true;
+    }
+    cerrarPropuesta(id, forzar) {
+        const propuesta = this.propuestas.get(id);
+        if (propuesta === undefined)
+            return;
+        const timer = this.timers.get(id);
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            this.timers.delete(id);
+        }
+        let resultado;
+        if (forzar !== undefined) {
+            resultado = forzar;
+        }
+        else {
+            resultado = this.verificarUmbral(propuesta)
+                ? ESTADO_PROPUESTA.APROBADA
+                : ESTADO_PROPUESTA.RECHAZADA;
+        }
+        propuesta.estado = resultado;
+        this.propuestas.set(id, propuesta);
+        this.emit("propuestaResultado", { propuesta: id, resultado });
+    }
+    verificarUmbral(propuesta) {
+        const pesoTotal = this.calcularPesoTotal(propuesta);
+        return pesoTotal >= this.politica.umbral;
+    }
+    calcularPesoTotal(propuesta) {
+        return propuesta.votos.reduce((total, voto) => {
+            const peso = this.politica.pesoNodo[voto.nodoId] ?? 1;
+            return voto.voto === "a_favor" ? total + peso : total;
+        }, 0);
+    }
+    // ─── POLITICA ─────────────────────────────────────────────────────────
+    actualizarPolitica(politica) {
+        this.politica = { ...this.politica, ...politica };
+        this.emit("politicaCambiada", { politica: this.politica });
+    }
+    obtenerPolitica() {
+        return { ...this.politica };
+    }
+    obtenerPropuestas(estado) {
+        const todas = Array.from(this.propuestas.values());
+        if (estado === undefined)
+            return todas;
+        return todas.filter((p) => p.estado === estado);
+    }
+    obtenerPropuesta(id) {
+        return this.propuestas.get(id) ?? null;
+    }
+    importarPropuestas(propuestas) {
+        for (const prop of propuestas) {
+            this.propuestas.set(prop.id, { ...prop });
+            if (prop.estado === ESTADO_PROPUESTA.ABIERTA) {
+                const expiracionRestante = prop.expiracion - Date.now();
+                const timerExistente = this.timers.get(prop.id);
+                if (timerExistente) {
+                    clearTimeout(timerExistente);
+                }
+                if (expiracionRestante > 0) {
+                    const timer = setTimeout(() => {
+                        this.cerrarPropuesta(prop.id);
+                    }, expiracionRestante);
+                    this.timers.set(prop.id, timer);
+                }
+                else {
+                    this.cerrarPropuesta(prop.id);
+                }
+            }
+            else {
+                const timerExistente = this.timers.get(prop.id);
+                if (timerExistente) {
+                    clearTimeout(timerExistente);
+                    this.timers.delete(prop.id);
+                }
+            }
+        }
+    }
+    // ─── 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);
+    }
+    // ─── LIMPIEZA ─────────────────────────────────────────────────────────
+    limpiarPropuestasExpiradas() {
+        const ahora = Date.now();
+        for (const [id, propuesta] of this.propuestas) {
+            if (propuesta.expiracion < ahora) {
+                this.cerrarPropuesta(id);
+            }
+        }
+    }
+    destruir() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        this.propuestas.clear();
+    }
+}
+// ─── FACTORY ───────────────────────────────────────────────────────────────
+export function createGovernanceManager(politica, verificador, options) {
+    return new GovernanceManager(politica, verificador, options);
+}
+export * from "./authority.js";
+export * from "./merge.js";
+//# sourceMappingURL=index.js.map

package/dist/governance/index.js.map

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

package/dist/governance/merge.d.ts

@@ -0,0 +1,31 @@
+import type { ParPublico, PostQuantumIdentity } from "../identity/index.js";
+import type { NodoId, PayloadVotacion } from "../types/index.js";
+import { type Propuesta } from "./index.js";
+export type Proposal = Propuesta;
+export type Vote = PayloadVotacion;
+export interface GovernanceEvent {
+    readonly id: string;
+    readonly tipo: string;
+    readonly timestamp: number;
+    readonly payload: unknown;
+}
+export interface GovernanceSnapshot {
+    readonly propuestas: Proposal[];
+    readonly timestamp: number;
+    readonly firma?: Uint8Array;
+    readonly publicNodeId?: NodoId;
+}
+export interface GovernanceMerge {
+    resolveProposalConflicts(local: Proposal[], remote: Proposal[]): Promise<Proposal[]>;
+    resolveVoteConflicts(local: Vote[], remote: Vote[]): Promise<Vote[]>;
+    detectGovernanceFork(localEvents: GovernanceEvent[], remoteEvents: GovernanceEvent[]): Promise<boolean>;
+}
+export declare function stableStringify(val: unknown): string;
+export declare function signGovernanceSnapshot(snapshot: Omit<GovernanceSnapshot, "firma" | "publicNodeId">, identity: PostQuantumIdentity): Promise<GovernanceSnapshot>;
+export declare function verifyGovernanceSnapshot(snapshot: GovernanceSnapshot, parPublico: ParPublico, identity: PostQuantumIdentity): Promise<boolean>;
+export declare class GovernanceMerger implements GovernanceMerge {
+    resolveProposalConflicts(local: Proposal[], remote: Proposal[]): Promise<Proposal[]>;
+    resolveVoteConflicts(local: Vote[], remote: Vote[]): Promise<Vote[]>;
+    detectGovernanceFork(localEvents: GovernanceEvent[], remoteEvents: GovernanceEvent[]): Promise<boolean>;
+}
+//# sourceMappingURL=merge.d.ts.map

package/dist/governance/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/governance/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAI9D,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC;AACjC,MAAM,MAAM,IAAI,GAAG,eAAe,CAAC;AAInC,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAID,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAID,MAAM,WAAW,eAAe;IAC/B,wBAAwB,CACvB,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,oBAAoB,CACnB,WAAW,EAAE,eAAe,EAAE,EAC9B,YAAY,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;CACpB;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAapD;AAID,wBAAsB,sBAAsB,CAC3C,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,cAAc,CAAC,EAC5D,QAAQ,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED,wBAAsB,wBAAwB,CAC7C,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,mBAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAID,qBAAa,gBAAiB,YAAW,eAAe;IACjD,wBAAwB,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoDrB;IAEK,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAezE;IAEK,oBAAoB,CACzB,WAAW,EAAE,eAAe,EAAE,EAC9B,YAAY,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC,OAAO,CAAC,CAyElB;CACD"}

package/dist/governance/merge.js

@@ -0,0 +1,167 @@
+import { ESTADO_PROPUESTA } from "./index.js";
+// ─── STABLE STRINGIFY ──────────────────────────────────────────────────────
+export function stableStringify(val) {
+    if (typeof val !== "object" || val === null) {
+        return JSON.stringify(val);
+    }
+    if (Array.isArray(val)) {
+        return `[${val.map(stableStringify).join(",")}]`;
+    }
+    const keys = Object.keys(val).sort();
+    const parts = keys.map((k) => `${JSON.stringify(k)}:${stableStringify(val[k])}`);
+    return `{${parts.join(",")}}`;
+}
+// ─── SIGN & VERIFY SNAPSHOT ───────────────────────────────────────────────
+export async function signGovernanceSnapshot(snapshot, identity) {
+    const encoder = new TextEncoder();
+    const serialized = encoder.encode(stableStringify(snapshot));
+    const firma = await identity.firmar(serialized);
+    return {
+        ...snapshot,
+        firma,
+        publicNodeId: identity.nodoId,
+    };
+}
+export async function verifyGovernanceSnapshot(snapshot, parPublico, identity) {
+    if (!snapshot.firma)
+        return false;
+    const { firma, publicNodeId, ...rest } = snapshot;
+    const encoder = new TextEncoder();
+    const serialized = encoder.encode(stableStringify(rest));
+    return identity.verificar(serialized, firma, parPublico);
+}
+// ─── GOVERNANCE MERGER IMPLEMENTATION ─────────────────────────────────────
+export class GovernanceMerger {
+    async resolveProposalConflicts(local, remote) {
+        const merged = [];
+        const remoteMap = new Map();
+        for (const p of remote) {
+            remoteMap.set(p.id, p);
+        }
+        for (const localProp of local) {
+            const remoteProp = remoteMap.get(localProp.id);
+            if (!remoteProp) {
+                // Propuestas con id único: ambas sobreviven
+                merged.push({ ...localProp });
+            }
+            else {
+                // Propuestas con mismo id
+                if (localProp.tipo === "expulsion" || remoteProp.tipo === "expulsion") {
+                    // Expulsiones: la expulsión más reciente gana (por timestamp)
+                    if (localProp.timestamp >= remoteProp.timestamp) {
+                        merged.push({ ...localProp });
+                    }
+                    else {
+                        merged.push({ ...remoteProp });
+                    }
+                }
+                else if (localProp.estado !== remoteProp.estado) {
+                    // Propuestas con mismo id pero diferente resultado: se re-votan con todos los peers
+                    merged.push({
+                        ...localProp,
+                        estado: ESTADO_PROPUESTA.ABIERTA,
+                        votos: [], // Reset votos to re-vote
+                        expiracion: Date.now() + 30_000, // Extend expiration
+                    });
+                }
+                else {
+                    // Same result: no conflict, merge votes cleanly
+                    const allVotes = [...localProp.votos];
+                    for (const rv of remoteProp.votos) {
+                        if (!allVotes.some((lv) => lv.nodoId === rv.nodoId)) {
+                            allVotes.push(rv);
+                        }
+                    }
+                    merged.push({
+                        ...localProp,
+                        votos: allVotes,
+                    });
+                }
+                remoteMap.delete(localProp.id);
+            }
+        }
+        // Add remaining remote proposals (id único)
+        for (const remoteProp of remoteMap.values()) {
+            merged.push({ ...remoteProp });
+        }
+        return merged;
+    }
+    async resolveVoteConflicts(local, remote) {
+        const merged = [...local];
+        for (const rVote of remote) {
+            const exists = merged.find((lVote) => lVote.propuesta === rVote.propuesta && lVote.nodoId === rVote.nodoId);
+            if (!exists) {
+                merged.push(rVote);
+            }
+            else {
+                // If they exist but differ, we can deterministically keep the local one.
+                // (No changes needed since it's already in merged)
+            }
+        }
+        return merged;
+    }
+    async detectGovernanceFork(localEvents, remoteEvents) {
+        const localProps = new Map();
+        const remoteProps = new Map();
+        const localExpulsions = new Map();
+        const remoteExpulsions = new Map();
+        // Helper to extract proposal
+        const extractProp = (ev) => {
+            const payload = ev.payload;
+            if (payload && typeof payload === "object") {
+                if (payload.propuesta && typeof payload.propuesta === "object") {
+                    return payload.propuesta;
+                }
+            }
+            return null;
+        };
+        for (const ev of localEvents) {
+            const prop = extractProp(ev);
+            if (prop?.id) {
+                localProps.set(prop.id, prop);
+            }
+            if (ev.tipo === "expulsion") {
+                const pp = ev.payload;
+                const target = (pp?.target ?? pp?.nodoId ?? ev.id);
+                localExpulsions.set(target, ev);
+            }
+        }
+        for (const ev of remoteEvents) {
+            const prop = extractProp(ev);
+            if (prop?.id) {
+                remoteProps.set(prop.id, prop);
+            }
+            if (ev.tipo === "expulsion") {
+                const pp = ev.payload;
+                const target = (pp?.target ?? pp?.nodoId ?? ev.id);
+                remoteExpulsions.set(target, ev);
+            }
+        }
+        // Check proposal conflicts
+        for (const [id, localProp] of localProps) {
+            const remoteProp = remoteProps.get(id);
+            if (remoteProp) {
+                if (localProp.estado !== remoteProp.estado) {
+                    return true;
+                }
+                // Check if vote sets are different
+                if (stableStringify(localProp.votos) !== stableStringify(remoteProp.votos)) {
+                    return true;
+                }
+            }
+        }
+        // Check expulsion conflicts
+        for (const [target, localExp] of localExpulsions) {
+            const remoteExp = remoteExpulsions.get(target);
+            if (remoteExp) {
+                if (localExp.timestamp !== remoteExp.timestamp ||
+                    localExp.payload?.resultado !==
+                        remoteExp.payload?.resultado) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=merge.js.map

package/dist/governance/merge.js.map

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

package/dist/identity/index.d.ts

@@ -0,0 +1,199 @@
+import type { NodoId, ParPublico } from "../types/index.js";
+export type { ParPublico };
+/** Prefijo de un identificador de nodo derivado criptograficamente. */
+export declare const PREFIJO_NODO_DERIVADO = "mlkem";
+export declare const TIPO_IDENTIDAD: {
+    readonly MAESTRA: "maestra";
+    readonly EPHEMERA: "ephemera";
+    readonly SERVICIO: "servicio";
+};
+export type TipoIdentidad = (typeof TIPO_IDENTIDAD)[keyof typeof TIPO_IDENTIDAD];
+/**
+ * QUE PRUEBA ML-DSA-65 Y QUE PROTEGE ML-KEM-768: son garantias distintas y
+ * ninguna sustituye a la otra.
+ *
+ * - ML-DSA-65 (firma, `firmar` / `verificar`): **autenticidad + integridad**.
+ *   Prueba que el tenedor de la clave privada escribio esos bytes exactos y que
+ *   no fueron alterados en transito. No revela nada: cualquiera puede verificar.
+ *
+ * - ML-KEM-768 (encapsulacion, `encapsular` / `decapsular`): **confidencialidad
+ *   del secreto compartido**. Solo el dueno de la clave privada correspondiente
+ *   puede recuperarlo; el ciphertext que viaja es inservible para cualquier otro.
+ *   No dice NADA sobre quien envio el mensaje.
+ *
+ * Un envolvente correcto necesita ambos: ML-KEM para que solo el destinatario
+ * lea el payload, ML-DSA para que el destinatario pruebe quien lo envio.
+ */
+export declare const ALGORITMOS: {
+    readonly FIRMA: "ML-DSA-65";
+    readonly KEM: "ML-KEM-768";
+};
+export interface PostQuantumKeypair {
+    readonly parPrivado: Uint8Array;
+    readonly parPublico: ParPublico;
+    /**
+     * Clave de desencapsulacion ML-KEM-768. Ausente solo para keypairs restaurados
+     * de la serializacion legacy (pre-KEM); en ese caso se genera una nueva.
+     */
+    readonly kemPrivado?: Uint8Array;
+    /** Clave de encapsulacion ML-KEM-768. Esto es lo que viaja por el cable. */
+    readonly kemPublico?: Uint8Array;
+    readonly algoritmo: string;
+    readonly tipo: TipoIdentidad;
+    readonly fechaCreacion: number;
+}
+export interface IdentityProvider {
+    sign(data: string): Promise<string>;
+    verify(data: string, signature: string, publicKey: Uint8Array): Promise<boolean>;
+}
+/** Resultado de `encapsular`: el ciphertext a enviar mas el secreto local. */
+export interface SobreKem {
+    readonly cipherText: Uint8Array;
+    readonly claveCompartida: Uint8Array;
+}
+export interface PostQuantumIdentity extends IdentityProvider {
+    readonly nodoId: NodoId;
+    readonly keypair: PostQuantumKeypair;
+    firmar(datos: Uint8Array): Promise<Uint8Array>;
+    verificar(datos: Uint8Array, firma: Uint8Array, parPublico: ParPublico): Promise<boolean>;
+    exportarPublico(): ParPublico;
+    obtenerAlgoritmo(): string;
+    /** Clave publica ML-KEM-768 de este nodo. Segura para poner en el cable. */
+    exportarKemPublico(): ParPublico;
+    /**
+     * Clave publica ML-KEM del destinatario, recuperada de nuestra clave de
+     * desencapsulacion. Esto contrasta el par almacenado, de modo que una
+     * serializacion manipulada o incoherente se detecta antes de que alguien
+     * intente cifrar hacia nosotros.
+     */
+    obtenerKemPublico(): ParPublico;
+    /** Sella un secreto compartido para el dueno de `kemPublicoReceptor`. */
+    encapsular(kemPublicoReceptor: ParPublico): SobreKem;
+    /** Recupera el secreto compartido de un ciphertext dirigido a nosotros. */
+    decapsular(cipherText: Uint8Array): Uint8Array;
+    /** Deriva la clave simetrica de 32 bytes de un ciphertext dirigido a nosotros. */
+    derivarClaveSimetricaDesde(cipherText: Uint8Array): Promise<Uint8Array>;
+}
+/**
+ * Genera un keypair de nodo: un par de firma ML-DSA-65 **y** un par de
+ * encapsulacion ML-KEM-768. Ambos hacen falta para una identidad de malla
+ * utilizable: el par de firma prueba quien eres, el par KEM permite que otros
+ * te hablen en privado.
+ */
+export declare function generateKeypair(tipo?: TipoIdentidad): PostQuantumKeypair;
+/**
+ * Deriva un identificador de nodo de forma determinista desde una clave publica
+ * ML-KEM-768.
+ *
+ * Esta es la correccion anti-suplantacion: un nodo no puede elegir, heredar ni
+ * adivinar el id de otro, porque el id *es* el hash de la clave que ese nodo debe
+ * presentar para probar posesion. Dos claves distintas nunca producen el mismo id
+ * con probabilidad significativa, y ninguna clave produce el id de otro.
+ *
+ * Formato: `mlkem<32 hex>` (primeros 16 bytes de SHA-256, con separacion de
+ * dominio).
+ */
+export declare function derivarNodoId(kemPublico: ParPublico): Promise<NodoId>;
+/** True cuando `nodoId` tiene la forma de un id derivado. Filtro barato. */
+export declare function esNodoIdDerivado(nodoId: string): boolean;
+/**
+ * Verifica que `nodoId` sea realmente el id derivado de la clave ML-KEM de este
+ * nodo.
+ *
+ * Nodos legacy (ids asignados antes de esta correccion, p. ej. `'doctor-01'`)
+ * devuelven `false` aqui y los maneja la ruta de migracion de abajo, no un
+ * rechazo.
+ */
+export declare function verificarNodoIdVinculado(nodoId: NodoId, kemPublico: ParPublico): Promise<boolean>;
+export type EstadoVinculoNodoId = 
+/** el id es el hash de la clave ML-KEM: ligado criptograficamente, nada que hacer. */
+{
+    readonly estado: "vinculado";
+}
+/** id libre legacy de antes de existir los ids derivados; se acepta y se fija. */
+ | {
+    readonly estado: "heredado";
+    readonly idEsperado: NodoId;
+}
+/** id legacy que no es el derivado, y el llamador no dio opt-in. */
+ | {
+    readonly estado: "conflicto";
+    idEsperado: NodoId;
+};
+/**
+ * Decide que hacer con un nodo id configurado antes de que existieran los ids
+ * derivados. **Nunca se sobrescribe nada en silencio.**
+ *
+ * - Id derivado que coincide con la clave → `vinculado`.
+ * - Id no derivado (libre) → `heredado`: el nodo sigue funcionando con su id
+ *   configurado, y fijamos ese id en el almacen de confianza para que una
+ *   rotacion posterior de identidad no pueda moverlo. `idEsperado` es el id
+ *   derivado a adoptar cuando el nodo rote su clave.
+ * - Id con forma derivada que NO coincide con la clave → `conflicto`: eso es un
+ *   intento de suplantacion (reclamar el id derivado de otro nodo), y el
+ *   llamador debe negarse.
+ *
+ * @param permitirHeredado opt-in para nodos legacy. Los llamadores legacy que
+ *   pasan un id configurado (la forma previa `createPostQuantumIdentity(nodoId)`)
+ *   deben ponerlo en `true`; el default es `false`, es decir, fallar cerrado.
+ */
+export declare function evaluarVinculoNodoId(nodoId: NodoId, kemPublico: ParPublico, permitirHeredado?: boolean): Promise<EstadoVinculoNodoId>;
+/**
+ * Convierte un secreto compartido ML-KEM-768 en una clave simetrica de 32 bytes
+ * apta para AEAD (AES-GCM / ChaCha20-Poly1305).
+ *
+ * El secreto compartido crudo de ML-KEM son 32 bytes de material de clave;
+ * hashearlo con un separador de dominio evita que se use directamente como clave
+ * de AEAD sin este paso, y lo mantiene distinto de cualquier otro valor derivado.
+ *
+ * Exportado para la capa de cifrado: este es el unico lugar donde el secreto
+ * ML-KEM de un nodo se vuelve material de cifrado.
+ */
+export declare function derivarClaveSimetrica(sharedSecret: Uint8Array): Promise<Uint8Array>;
+/**
+ * Crea una identidad para un nodo.
+ *
+ * El argumento `nodoId` se conserva por compatibilidad de cable y almacen. Para
+ * nodos NUEVOS prefiere `crearIdentidadVinculada(keypair)`, que deriva el id de
+ * la clave ML-KEM para que no pueda suplantarse. Un `nodoId` pasado aqui es
+ * siempre un id legacy; llama a `evaluarVinculoNodoId` para comprobarlo y fija el
+ * resultado en el almacen de confianza.
+ */
+export declare function createPostQuantumIdentity(nodoId: NodoId, keypair?: PostQuantumKeypair): PostQuantumIdentity;
+/**
+ * Crea una identidad cuyo `nodoId` ES el hash de su propia clave publica
+ * ML-KEM-768. Este es el constructor recomendado: el nodo puede probar que posee
+ * el id y nadie mas puede acuñarlo.
+ *
+ * @throws si el `nodoId` del keypair (si lo hay) conflicto con el derivado — un
+ *   id derivado reclamado que no coincide con la clave es un intento de
+ *   suplantacion y no debe emparentarse.
+ */
+export declare function crearIdentidadVinculada(keypair?: PostQuantumKeypair): Promise<PostQuantumIdentity>;
+/**
+ * Restaura una identidad desde un **keypair serializado** producido por
+ * `serializeKeypair`. Pasar solo una clave privada cruda e incoherente es
+ * inseguro y ya no se soporta.
+ *
+ * Para una identidad aleatoria nueva usa `createPostQuantumIdentity(nodoId)`, o
+ * `crearIdentidadVinculada()` para obtener un id que no se pueda suplantar.
+ */
+export declare function identityFromSecret(nodoId: NodoId, semilla: Uint8Array, tipo?: TipoIdentidad): PostQuantumIdentity;
+declare function bytesToBase64(bytes: Uint8Array): string;
+declare function base64ToBytes(b64: string): Uint8Array;
+export { base64ToBytes, bytesToBase64 };
+/**
+ * Serializa un keypair a un unico string. Layout v2:
+ *
+ *   u32 privLen | u32 pubLen | u32 kemPrivLen | priv | pub | kemPriv
+ *
+ * La clave publica ML-KEM NO se almacena: se recupera de `kemPriv` via
+ * `ml_kem768.getPublicKey`, de modo que las dos nunca pueden discrepar en disco.
+ *
+ * El layout v1 (solo claves de firma, 8 bytes de cabecera) sigue siendo legible:
+ * `deserializeKeypair` lo detecta y genera un par KEM nuevo, igual que
+ * `conKem`. Un despliegue existente no pierde su identidad de firma al migrar.
+ */
+export declare function serializeKeypair(keypair: PostQuantumKeypair): string;
+export declare function deserializeKeypair(serializada: string): PostQuantumKeypair;
+//# sourceMappingURL=index.d.ts.map

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

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