@swal/edge-mesh 0.0.0-stage → 0.1.0

package/dist/adapters/maloca-xavier/llm-router.js

@@ -0,0 +1,58 @@
+export class LLMRouterAdapter {
+    edgeMesh;
+    PROFILES_MAP_NAME = "xavier:profiles";
+    constructor(edgeMesh) {
+        this.edgeMesh = edgeMesh;
+    }
+    /**
+     * Enruta un prompt al mejor proveedor disponible en el mesh que soporte el modelo requerido.
+     * "Mejor" se define aquí como el de menor latencia entre los que están online.
+     */
+    async routePrompt(prompt, requiredModel) {
+        const profilesMap = this.edgeMesh.yjsAdapter.getMap(this.PROFILES_MAP_NAME);
+        let bestProvider = null;
+        let minLatency = Infinity;
+        for (const [nodeId, profile] of profilesMap.entries()) {
+            const p = profile;
+            if (p.capacidades && p.capacidades.includes(requiredModel)) {
+                const health = this.edgeMesh.presence.obtenerSalud(nodeId);
+                if (health && health.estado === "saludable") {
+                    if (health.latenciaMs < minLatency) {
+                        minLatency = health.latenciaMs;
+                        bestProvider = nodeId;
+                    }
+                }
+            }
+        }
+        if (!bestProvider)
+            return null;
+        // En un escenario real, aquí se enviaría el prompt al proveedor.
+        // Por ahora, simulamos el enrutamiento devolviendo la info del proveedor.
+        await this.edgeMesh.enviar(bestProvider, {
+            tipo: "xavier:prompt",
+            prompt,
+            model: requiredModel,
+        });
+        return {
+            providerId: bestProvider,
+            latencyMs: minLatency,
+        };
+    }
+    /**
+     * Obtiene el estado de un proveedor LLM.
+     */
+    getProviderStatus(providerId) {
+        return this.edgeMesh.presence.obtenerSalud(providerId);
+    }
+    /**
+     * Comparte contexto con un grupo de agentes.
+     */
+    async shareContext(contexto, agentIds) {
+        const promises = agentIds.map((id) => this.edgeMesh.enviar(id, {
+            tipo: "xavier:context",
+            contexto,
+        }));
+        await Promise.allSettled(promises);
+    }
+}
+//# sourceMappingURL=llm-router.js.map

package/dist/adapters/maloca-xavier/llm-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-router.js","sourceRoot":"","sources":["../../../src/adapters/maloca-xavier/llm-router.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,gBAAgB;IACX,QAAQ,CAAW;IACnB,iBAAiB,GAAG,iBAAiB,CAAC;IAEvD,YAAY,QAAkB;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAChB,MAAc,EACd,aAAqB;QAErB,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5E,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAE1B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,OAAuB,CAAC;YAClC,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAgB,CAAC,CAAC;gBACrE,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAC7C,IAAI,MAAM,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC;wBACpC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;wBAC/B,YAAY,GAAG,MAAgB,CAAC;oBACjC,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAE/B,iEAAiE;QACjE,0EAA0E;QAC1E,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE;YACxC,IAAI,EAAE,eAAe;YACrB,MAAM;YACN,KAAK,EAAE,aAAa;SACpB,CAAC,CAAC;QAEH,OAAO;YACN,UAAU,EAAE,YAAY;YACxB,SAAS,EAAE,UAAU;SACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,UAAkB;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CACjB,QAAiB,EACjB,QAA2B;QAE3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE;YACxB,IAAI,EAAE,gBAAgB;YACtB,QAAQ;SACR,CAAC,CACF,CAAC;QACF,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACD"}

package/dist/authz/index.d.ts

@@ -0,0 +1,81 @@
+import { type IStorage } from "../storage/index.js";
+import type { NamespaceCapabilityGrant, NodoId } from "../types/index.js";
+/** Rol de un sujeto dentro de un namespace (string, consistente con updateRole/revokeRole). */
+export type Role = string;
+export interface RoleAssignment {
+    readonly id: string;
+    readonly rol: string;
+    readonly sujeto: NodoId;
+}
+export interface Capability {
+    readonly nombre: string;
+    readonly descripcion?: string;
+}
+export declare const CAPACIDAD_ESTANDAR: {
+    readonly LEER: "read";
+    readonly ESCRIBIR: "write";
+    readonly ADMIN: "admin";
+    readonly SINC: "sync";
+    readonly PRESENCIA: "presence";
+    readonly GOBERNANZA: "governance";
+};
+export type CapacidadEstandar = (typeof CAPACIDAD_ESTANDAR)[keyof typeof CAPACIDAD_ESTANDAR];
+export interface AuthzEventMap {
+    capacidadConcedida: CustomEvent<{
+        readonly grant: NamespaceCapabilityGrant;
+    }>;
+    capacidadRevocada: CustomEvent<{
+        readonly id: string;
+        readonly espacio: string;
+        readonly sujeto: NodoId;
+    }>;
+    autorizacionFallida: CustomEvent<{
+        readonly espacio: string;
+        readonly sujeto: NodoId;
+        readonly capacidad: string;
+        readonly razon: string;
+    }>;
+}
+export declare class NamespaceAuthorizer {
+    readonly eventTarget: EventTarget;
+    private grants;
+    private readonly reglasLocales;
+    private roleAssignments;
+    private capabilities;
+    private readonly storage;
+    constructor(storage?: IStorage);
+    saveGrants(): Promise<void>;
+    loadGrants(): Promise<void>;
+    saveRoleAssignments(): Promise<void>;
+    loadRoleAssignments(): Promise<void>;
+    saveCapabilities(): Promise<void>;
+    loadCapabilities(): Promise<void>;
+    concederCapacidad(espacio: string, sujeto: NodoId, capacidad: string, expiracionMs?: number, firma?: Uint8Array): NamespaceCapabilityGrant;
+    grant(espacio: string, sujeto: NodoId, capacidad: string, expiracionMs?: number, firma?: Uint8Array): NamespaceCapabilityGrant;
+    revocarCapacidad(espacio: string, sujeto: NodoId, capacidad: string): boolean;
+    revoke(espacio: string, sujeto: NodoId, capacidad: string): boolean;
+    verificarCapacidad(espacio: string, sujeto: NodoId, capacidad: string): boolean;
+    private verificarGrant;
+    agregarReglaLocal(espacio: string, regla: string): void;
+    removerReglaLocal(espacio: string, regla: string): boolean;
+    verificarReglaLocal(espacio: string, regla: string): boolean;
+    obtenerGrantsDeNodo(sujeto: NodoId): readonly NamespaceCapabilityGrant[];
+    obtenerGrantsDeEspacio(espacio: string): readonly NamespaceCapabilityGrant[];
+    obtenerTodosLosGrants(): readonly NamespaceCapabilityGrant[];
+    limpiarGrantsExpirados(): number;
+    updateRole(sujeto: NodoId, rol: string): void;
+    obtenerRoles(): Map<string, RoleAssignment>;
+    revokeRole(sujeto: NodoId): boolean;
+    concederCapacidades(espacio: string, caps: Capability[]): void;
+    obtenerCapacidades(espacio: string): Capability[] | undefined;
+    obtenerGrantsMap(): Map<string, NamespaceCapabilityGrant>;
+    obtenerRoleAssignmentsMap(): Map<string, RoleAssignment>;
+    cargarGrantsMap(grants: [string, NamespaceCapabilityGrant][]): void;
+    cargarRoleAssignmentsMap(roleAssignments: [string, RoleAssignment][]): void;
+    on<K extends keyof AuthzEventMap>(tipo: K, handler: (ev: AuthzEventMap[K]) => void): void;
+    off<K extends keyof AuthzEventMap>(tipo: K, handler: (ev: AuthzEventMap[K]) => void): void;
+    private emit;
+    private crearClave;
+}
+export declare function createNamespaceAuthorizer(storage?: IStorage): NamespaceAuthorizer;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/authz/index.js

@@ -0,0 +1,271 @@
+import { generarNonce } from "../protocol/utils.js";
+import { InMemoryStorage } from "../storage/index.js";
+// ─── CONSTANTS ─────────────────────────────────────────────────────────────
+const EXPIRACION_POR_DEFECTO_MS = 86_400_000; // 24h
+export const CAPACIDAD_ESTANDAR = {
+    LEER: "read",
+    ESCRIBIR: "write",
+    ADMIN: "admin",
+    SINC: "sync",
+    PRESENCIA: "presence",
+    GOBERNANZA: "governance",
+};
+export class NamespaceAuthorizer {
+    eventTarget;
+    grants;
+    reglasLocales;
+    roleAssignments;
+    capabilities;
+    storage;
+    constructor(storage) {
+        this.eventTarget = new EventTarget();
+        this.grants = new Map();
+        this.reglasLocales = new Map();
+        this.roleAssignments = new Map();
+        this.capabilities = new Map();
+        this.storage = storage ?? new InMemoryStorage();
+        // Background loading during construction
+        void this.loadGrants();
+        void this.loadRoleAssignments();
+        void this.loadCapabilities();
+    }
+    // ─── PERSISTENCE ─────────────────────────────────────────────────────
+    async saveGrants() {
+        await this.storage.put("authz:grants", Array.from(this.grants.entries()));
+    }
+    async loadGrants() {
+        const data = await this.storage.get("authz:grants");
+        if (data) {
+            let loadedMap;
+            if (Array.isArray(data)) {
+                loadedMap = new Map(data);
+            }
+            else if (typeof data === "object" && data !== null && "valor" in data) {
+                loadedMap = new Map(data.valor);
+            }
+            else {
+                return;
+            }
+            for (const [key, value] of loadedMap) {
+                if (!this.grants.has(key)) {
+                    this.grants.set(key, value);
+                }
+            }
+        }
+    }
+    async saveRoleAssignments() {
+        await this.storage.put("authz:roleAssignments", Array.from(this.roleAssignments.entries()));
+    }
+    async loadRoleAssignments() {
+        const data = await this.storage.get("authz:roleAssignments");
+        if (data) {
+            let loadedMap;
+            if (Array.isArray(data)) {
+                loadedMap = new Map(data);
+            }
+            else if (typeof data === "object" && data !== null && "valor" in data) {
+                loadedMap = new Map(data.valor);
+            }
+            else {
+                return;
+            }
+            for (const [key, value] of loadedMap) {
+                if (!this.roleAssignments.has(key)) {
+                    this.roleAssignments.set(key, value);
+                }
+            }
+        }
+    }
+    async saveCapabilities() {
+        await this.storage.put("authz:capabilities", Array.from(this.capabilities.entries()));
+    }
+    async loadCapabilities() {
+        const data = await this.storage.get("authz:capabilities");
+        if (data) {
+            let loadedMap;
+            if (Array.isArray(data)) {
+                loadedMap = new Map(data);
+            }
+            else if (typeof data === "object" && data !== null && "valor" in data) {
+                loadedMap = new Map(data.valor);
+            }
+            else {
+                return;
+            }
+            for (const [key, value] of loadedMap) {
+                if (!this.capabilities.has(key)) {
+                    this.capabilities.set(key, value);
+                }
+            }
+        }
+    }
+    // ─── GRANTS ──────────────────────────────────────────────────────────
+    concederCapacidad(espacio, sujeto, capacidad, expiracionMs = EXPIRACION_POR_DEFECTO_MS, firma) {
+        const grant = {
+            id: generarNonce(),
+            espacio,
+            sujeto,
+            capacidad,
+            fechaEmision: Date.now(),
+            fechaExpiracion: Date.now() + expiracionMs,
+            firma: firma ?? new Uint8Array(0),
+        };
+        const clave = this.crearClave(espacio, sujeto, capacidad);
+        this.grants.set(clave, grant);
+        this.emit("capacidadConcedida", { grant });
+        void this.saveGrants();
+        return grant;
+    }
+    grant(espacio, sujeto, capacidad, expiracionMs, firma) {
+        return this.concederCapacidad(espacio, sujeto, capacidad, expiracionMs, firma);
+    }
+    revocarCapacidad(espacio, sujeto, capacidad) {
+        const clave = this.crearClave(espacio, sujeto, capacidad);
+        const grant = this.grants.get(clave);
+        if (grant === undefined)
+            return false;
+        this.grants.delete(clave);
+        this.emit("capacidadRevocada", {
+            id: grant.id,
+            espacio,
+            sujeto,
+        });
+        void this.saveGrants();
+        return true;
+    }
+    revoke(espacio, sujeto, capacidad) {
+        return this.revocarCapacidad(espacio, sujeto, capacidad);
+    }
+    verificarCapacidad(espacio, sujeto, capacidad) {
+        // Siempre verificar admin
+        if (this.verificarGrant(espacio, sujeto, "admin"))
+            return true;
+        return this.verificarGrant(espacio, sujeto, capacidad);
+    }
+    verificarGrant(espacio, sujeto, capacidad) {
+        const clave = this.crearClave(espacio, sujeto, capacidad);
+        const grant = this.grants.get(clave);
+        if (grant === undefined) {
+            this.emit("autorizacionFallida", {
+                espacio,
+                sujeto,
+                capacidad,
+                razon: "Sin permiso concedido",
+            });
+            return false;
+        }
+        if (Date.now() > grant.fechaExpiracion) {
+            this.grants.delete(clave);
+            this.emit("autorizacionFallida", {
+                espacio,
+                sujeto,
+                capacidad,
+                razon: "Permiso expirado",
+            });
+            void this.saveGrants();
+            return false;
+        }
+        return true;
+    }
+    // ─── REGLAS LOCALES ──────────────────────────────────────────────────
+    agregarReglaLocal(espacio, regla) {
+        const reglas = this.reglasLocales.get(espacio) ?? new Set();
+        reglas.add(regla);
+        this.reglasLocales.set(espacio, reglas);
+    }
+    removerReglaLocal(espacio, regla) {
+        const reglas = this.reglasLocales.get(espacio);
+        if (reglas === undefined)
+            return false;
+        const resultado = reglas.delete(regla);
+        if (reglas.size === 0) {
+            this.reglasLocales.delete(espacio);
+        }
+        return resultado;
+    }
+    verificarReglaLocal(espacio, regla) {
+        return this.reglasLocales.get(espacio)?.has(regla) ?? false;
+    }
+    // ─── CONSULTAS ───────────────────────────────────────────────────────
+    obtenerGrantsDeNodo(sujeto) {
+        return Array.from(this.grants.values()).filter((g) => g.sujeto === sujeto);
+    }
+    obtenerGrantsDeEspacio(espacio) {
+        return Array.from(this.grants.values()).filter((g) => g.espacio === espacio);
+    }
+    obtenerTodosLosGrants() {
+        return Array.from(this.grants.values());
+    }
+    limpiarGrantsExpirados() {
+        const ahora = Date.now();
+        let eliminados = 0;
+        for (const [clave, grant] of this.grants) {
+            if (ahora > grant.fechaExpiracion) {
+                this.grants.delete(clave);
+                eliminados++;
+            }
+        }
+        if (eliminados > 0) {
+            void this.saveGrants();
+        }
+        return eliminados;
+    }
+    // ─── ROLES & CAPABILITIES HELPER METHODS ─────────────────────────────
+    updateRole(sujeto, rol) {
+        const id = generarNonce();
+        const assignment = { id, rol, sujeto };
+        this.roleAssignments.set(sujeto, assignment);
+        void this.saveRoleAssignments();
+    }
+    obtenerRoles() {
+        return this.roleAssignments;
+    }
+    revokeRole(sujeto) {
+        const res = this.roleAssignments.delete(sujeto);
+        if (res) {
+            void this.saveRoleAssignments();
+        }
+        return res;
+    }
+    concederCapacidades(espacio, caps) {
+        this.capabilities.set(espacio, caps);
+        void this.saveCapabilities();
+    }
+    obtenerCapacidades(espacio) {
+        return this.capabilities.get(espacio);
+    }
+    obtenerGrantsMap() {
+        return this.grants;
+    }
+    obtenerRoleAssignmentsMap() {
+        return this.roleAssignments;
+    }
+    cargarGrantsMap(grants) {
+        this.grants = new Map(grants);
+        void this.saveGrants();
+    }
+    cargarRoleAssignmentsMap(roleAssignments) {
+        this.roleAssignments = new Map(roleAssignments);
+        void this.saveRoleAssignments();
+    }
+    // ─── 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);
+    }
+    // ─── UTILIDADES ──────────────────────────────────────────────────────
+    crearClave(espacio, sujeto, capacidad) {
+        return `${espacio}::${sujeto}::${capacidad}`;
+    }
+}
+// ─── FACTORY ───────────────────────────────────────────────────────────────
+export function createNamespaceAuthorizer(storage) {
+    return new NamespaceAuthorizer(storage);
+}
+//# sourceMappingURL=index.js.map

package/dist/authz/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authz/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AAiBrE,8EAA8E;AAE9E,MAAM,yBAAyB,GAAG,UAAU,CAAC,CAAC,MAAM;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,UAAU;IACrB,UAAU,EAAE,YAAY;CACf,CAAC;AAsBX,MAAM,OAAO,mBAAmB;IACtB,WAAW,CAAc;IAC1B,MAAM,CAAwC;IACrC,aAAa,CAA2B;IACjD,eAAe,CAA8B;IAC7C,YAAY,CAA4B;IAC/B,OAAO,CAAW;IAEnC,YAAY,OAAkB;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,eAAe,EAAE,CAAC;QAEhD,yCAAyC;QACzC,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC9B,CAAC;IAED,wEAAwE;IAExE,KAAK,CAAC,UAAU;QACf,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,UAAU;QACf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACpD,IAAI,IAAI,EAAE,CAAC;YACV,IAAI,SAAgD,CAAC;YACrD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACzE,SAAS,GAAG,IAAI,GAAG,CAAE,IAAY,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACP,OAAO;YACR,CAAC;YACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC7B,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,KAAK,CAAC,mBAAmB;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB,uBAAuB,EACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAC1C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAC7D,IAAI,IAAI,EAAE,CAAC;YACV,IAAI,SAAsC,CAAC;YAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACzE,SAAS,GAAG,IAAI,GAAG,CAAE,IAAY,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACP,OAAO;YACR,CAAC;YACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACtC,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,KAAK,CAAC,gBAAgB;QACrB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB,oBAAoB,EACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CACvC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB;QACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC1D,IAAI,IAAI,EAAE,CAAC;YACV,IAAI,SAAoC,CAAC;YACzC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACzE,SAAS,GAAG,IAAI,GAAG,CAAE,IAAY,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACP,OAAO;YACR,CAAC;YACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,wEAAwE;IAExE,iBAAiB,CAChB,OAAe,EACf,MAAc,EACd,SAAiB,EACjB,YAAY,GAAW,yBAAyB,EAChD,KAAkB;QAElB,MAAM,KAAK,GAA6B;YACvC,EAAE,EAAE,YAAY,EAAE;YAClB,OAAO;YACP,MAAM;YACN,SAAS;YACT,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY;YAC1C,KAAK,EAAE,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC;SACjC,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE9B,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CACJ,OAAe,EACf,MAAc,EACd,SAAiB,EACjB,YAAqB,EACrB,KAAkB;QAElB,OAAO,IAAI,CAAC,iBAAiB,CAC5B,OAAO,EACP,MAAM,EACN,SAAS,EACT,YAAY,EACZ,KAAK,CACL,CAAC;IACH,CAAC;IAED,gBAAgB,CACf,OAAe,EACf,MAAc,EACd,SAAiB;QAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAC9B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,OAAO;YACP,MAAM;SACN,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,CAAC,OAAe,EAAE,MAAc,EAAE,SAAiB;QACxD,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,kBAAkB,CACjB,OAAe,EACf,MAAc,EACd,SAAiB;QAEjB,0BAA0B;QAC1B,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAE/D,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAEO,cAAc,CACrB,OAAe,EACf,MAAc,EACd,SAAiB;QAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAErC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE;gBAChC,OAAO;gBACP,MAAM;gBACN,SAAS;gBACT,KAAK,EAAE,uBAAuB;aAC9B,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE;gBAChC,OAAO;gBACP,MAAM;gBACN,SAAS;gBACT,KAAK,EAAE,kBAAkB;aACzB,CAAC,CAAC;YACH,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED,wEAAwE;IAExE,iBAAiB,CAAC,OAAe,EAAE,KAAa;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,iBAAiB,CAAC,OAAe,EAAE,KAAa;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,mBAAmB,CAAC,OAAe,EAAE,KAAa;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAC7D,CAAC;IAED,wEAAwE;IAExE,mBAAmB,CAAC,MAAc;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED,sBAAsB,CAAC,OAAe;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAC5B,CAAC;IACH,CAAC;IAED,qBAAqB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,sBAAsB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,KAAK,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1B,UAAU,EAAE,CAAC;YACd,CAAC;QACF,CAAC;QACD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,wEAAwE;IAExE,UAAU,CAAC,MAAc,EAAE,GAAW;QACrC,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAmB,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACvD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACjC,CAAC;IAED,YAAY;QACX,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,MAAc;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,GAAG,EAAE,CAAC;YACT,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,mBAAmB,CAAC,OAAe,EAAE,IAAkB;QACtD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC9B,CAAC;IAED,kBAAkB,CAAC,OAAe;QACjC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,gBAAgB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,yBAAyB;QACxB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED,eAAe,CAAC,MAA4C;QAC3D,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;IAED,wBAAwB,CAAC,eAA2C;QACnE,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;QAChD,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACjC,CAAC;IAED,wEAAwE;IAExE,EAAE,CACD,IAAO,EACP,OAAuC;QAEvC,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAc,EAAE,OAAwB,CAAC,CAAC;IAC7E,CAAC;IAED,GAAG,CACF,IAAO,EACP,OAAuC;QAEvC,IAAI,CAAC,WAAW,CAAC,mBAAmB,CACnC,IAAc,EACd,OAAwB,CACxB,CAAC;IACH,CAAC;IAEO,IAAI,CACX,IAAO,EACP,OAAmC;QAEnC,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;IAED,wEAAwE;IAEhE,UAAU,CACjB,OAAe,EACf,MAAc,EACd,SAAiB;QAEjB,OAAO,GAAG,OAAO,KAAK,MAAM,KAAK,SAAS,EAAE,CAAC;IAC9C,CAAC;CACD;AAED,8EAA8E;AAE9E,MAAM,UAAU,yBAAyB,CACxC,OAAkB;IAElB,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/chat/index.d.ts

@@ -0,0 +1,138 @@
+import type { YjsAdapter } from "../edge-mesh.js";
+import type { NodoId } from "../types/index.js";
+import { type ChatMessage, type OfflineMessageQueue } from "./offline-queue.js";
+export declare const TIPO_MENSAJE_CHAT: {
+    readonly TEXTO: "texto";
+    readonly SISTEMA: "sistema";
+    readonly ARCHIVO: "archivo";
+    readonly EXAMEN: "examen";
+    readonly SALON: "salon";
+};
+export type TipoMensajeChat = (typeof TIPO_MENSAJE_CHAT)[keyof typeof TIPO_MENSAJE_CHAT];
+export declare const TIPO_CANAL: {
+    readonly PUBLICO: "publico";
+    readonly PRIVADO: "privado";
+    readonly SALON_VIRTUAL: "salon_virtual";
+};
+export type TipoCanal = (typeof TIPO_CANAL)[keyof typeof TIPO_CANAL];
+export declare const TIPO_PREGUNTA: {
+    readonly OPCION_MULTIPLE: "opcion_multiple";
+    readonly VERDADERO_FALSO: "verdadero_falso";
+    readonly RESPUESTA_CORTA: "respuesta_corta";
+    readonly ENSAYO: "ensayo";
+};
+export type TipoPregunta = (typeof TIPO_PREGUNTA)[keyof typeof TIPO_PREGUNTA];
+export interface Mensaje {
+    readonly id: string;
+    readonly sender: string;
+    readonly text: string;
+    readonly timestamp: number;
+    readonly type: TipoMensajeChat;
+    readonly canal: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface Pregunta {
+    readonly id: string;
+    readonly tipo: TipoPregunta;
+    readonly enunciado: string;
+    readonly opciones?: readonly string[];
+    readonly respuestaCorrecta?: unknown;
+    readonly puntaje: number;
+}
+export interface ChatEventMap {
+    mensaje: CustomEvent<{
+        readonly mensaje: Mensaje;
+    }>;
+    historial: CustomEvent<{
+        readonly mensajes: readonly Mensaje[];
+    }>;
+    usuarioConectado: CustomEvent<{
+        readonly usuarioId: string;
+        readonly canal: string;
+    }>;
+    usuarioDesconectado: CustomEvent<{
+        readonly usuarioId: string;
+        readonly canal: string;
+    }>;
+    error: CustomEvent<{
+        readonly mensaje: string;
+        readonly error?: Error;
+    }>;
+    rate_limited: CustomEvent<{
+        readonly peerId: string;
+        readonly resource: string;
+    }>;
+}
+export interface ExamenEventMap {
+    preguntaAgregada: CustomEvent<{
+        readonly pregunta: Pregunta;
+    }>;
+    preguntaCambiada: CustomEvent<{
+        readonly preguntaId: string;
+        readonly cambios: Partial<Pregunta>;
+    }>;
+    respuestaNueva: CustomEvent<{
+        readonly estudianteId: string;
+        readonly preguntaId: string;
+        readonly respuesta: unknown;
+    }>;
+    examenIniciado: CustomEvent<{
+        readonly examenId: string;
+    }>;
+    examenFinalizado: CustomEvent<{
+        readonly examenId: string;
+    }>;
+}
+export declare class ChatChannel extends EventTarget {
+    readonly nodoId: NodoId;
+    readonly nombreCanal: string;
+    readonly tipoCanal: TipoCanal;
+    readonly yjsAdapter: YjsAdapter;
+    readonly offlineQueue?: OfflineMessageQueue;
+    peerId?: string;
+    private readonly yjsText;
+    private readonly yjsMeta;
+    private readonly yjsUsuarios;
+    private readonly yjsMensajes;
+    private historialCache;
+    private usuariosConectados;
+    private readonly rateLimiter;
+    constructor(nodoId: NodoId, nombreCanal: string, yjsAdapter: YjsAdapter, tipoCanal?: TipoCanal, offlineQueue?: OfflineMessageQueue);
+    private inicializar;
+    private cargarHistorialInicial;
+    private actualizarDesdeYjs;
+    private actualizarUsuarios;
+    setPeerId(peerId: string): void;
+    enviarMensajeDirecto(mensaje: ChatMessage): Promise<void>;
+    sendMessage(texto: string, tipo?: TipoMensajeChat, metadata?: Readonly<Record<string, unknown>>): Promise<string>;
+    enviarMensaje(texto: string, tipo?: TipoMensajeChat, metadata?: Readonly<Record<string, unknown>>): Promise<string>;
+    unirseAlCanal(): Promise<void>;
+    abandonarCanal(): Promise<void>;
+    obtenerHistorial(limite?: number): Promise<readonly Mensaje[]>;
+    obtenerUsuariosConectados(): readonly string[];
+    limpiarHistorial(): Promise<void>;
+}
+export declare class ExamenCompartido extends EventTarget {
+    readonly examenId: string;
+    readonly yjsAdapter: YjsAdapter;
+    private readonly yjsPreguntas;
+    private readonly yjsRespuestas;
+    private readonly yjsEstado;
+    private cachePreguntas;
+    private cacheRespuestas;
+    constructor(examenId: string, yjsAdapter: YjsAdapter);
+    private inicializar;
+    private sincronizarPreguntas;
+    cargarPreguntas(preguntas: readonly Pregunta[]): Promise<void>;
+    agregarPregunta(pregunta: Pregunta): Promise<void>;
+    actualizarPregunta(preguntaId: string, cambios: Partial<Pregunta>): Promise<void>;
+    enviarRespuesta(estudianteId: string, preguntaId: string, respuesta: unknown): Promise<void>;
+    obtenerRespuestas(): Promise<ReadonlyMap<string, unknown>>;
+    obtenerRespuestasDeEstudiante(estudianteId: string): Promise<ReadonlyMap<string, unknown>>;
+    obtenerPreguntas(): readonly Pregunta[];
+    iniciarExamen(): Promise<void>;
+    finalizarExamen(): Promise<void>;
+    obtenerEstado(): Promise<Record<string, unknown>>;
+}
+export * from "./offline-queue.js";
+//# sourceMappingURL=index.d.ts.map

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

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