@swal/edge-mesh 0.0.0-stage → 0.1.0

package/dist/security/rate-limiter.js

@@ -0,0 +1,32 @@
+export class TokenBucketRateLimiter {
+    config;
+    buckets = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    consume(key, tokens = 1) {
+        const now = Date.now();
+        let bucket = this.buckets.get(key);
+        if (!bucket) {
+            bucket = { tokens: this.config.maxTokens, lastRefill: now };
+            this.buckets.set(key, bucket);
+        }
+        else {
+            const elapsed = now - bucket.lastRefill;
+            if (elapsed > 0) {
+                const tokensToAdd = elapsed * (this.config.tokensPerInterval / this.config.intervalMs);
+                bucket.tokens = Math.min(this.config.maxTokens, bucket.tokens + tokensToAdd);
+                bucket.lastRefill = now;
+            }
+        }
+        if (bucket.tokens >= tokens) {
+            bucket.tokens -= tokens;
+            return true;
+        }
+        return false;
+    }
+    reset(key) {
+        this.buckets.delete(key);
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/security/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/security/rate-limiter.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,sBAAsB;IAId,MAAM;IAHlB,OAAO,GACd,IAAI,GAAG,EAAE,CAAC;IAEX,YAAoB,MAAyB;sBAAzB,MAAM;IAAsB,CAAC;IAEjD,OAAO,CAAC,GAAW,EAAE,MAAM,GAAG,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;YAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACP,MAAM,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC;YACxC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,WAAW,GAChB,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACpE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CACvB,IAAI,CAAC,MAAM,CAAC,SAAS,EACrB,MAAM,CAAC,MAAM,GAAG,WAAW,CAC3B,CAAC;gBACF,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC;YACzB,CAAC;QACF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;YACxB,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAW;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD"}

package/dist/snapshot/index.d.ts

@@ -0,0 +1,90 @@
+import type { RoleAssignment } from "../authz/index.js";
+import type { GovernanceSnapshot } from "../governance/merge.js";
+import type { MerkleTree } from "../maloca/evidentia.js";
+import type { Perfil as Profile } from "../maloca/perfil.js";
+import { type IStorage } from "../storage/index.js";
+import type { NamespaceCapabilityGrant, NodoId, PayloadSnapshot } from "../types/index.js";
+export type Grant = NamespaceCapabilityGrant;
+export interface Subscription {
+    id: string;
+    topic: string;
+    subscriber: string;
+    timestamp: number;
+}
+export interface SnapshotConfig {
+    intervalMs: number;
+    maxSnapshots: number;
+    include: string[];
+}
+export interface Snapshot {
+    id: string;
+    timestamp: number;
+    state: {
+        grants: [string, Grant][];
+        roleAssignments: [string, RoleAssignment][];
+        profiles: [string, Profile][];
+        merkleTree: MerkleTree;
+        governance: GovernanceSnapshot;
+        subscriptions: [string, Subscription][];
+        lastOpSequence?: number;
+    };
+    signature?: string;
+    prevSnapshotId?: string;
+}
+export interface SnapshotManagerConfig {
+    readonly docId: string;
+    readonly interval?: number;
+    readonly storage?: IStorage;
+    readonly maxSnapshots?: number;
+}
+export interface SnapshotMetadata {
+    readonly version: number;
+    readonly timestamp: number;
+    readonly nodos: readonly NodoId[];
+    readonly tamanio: number;
+    readonly hash: string;
+}
+export interface SnapshotEventMap {
+    snapshotCreado: CustomEvent<{
+        readonly snapshot: SnapshotMetadata;
+        readonly docId: string;
+    }>;
+    snapshotRestaurado: CustomEvent<{
+        readonly version: number;
+        readonly docId: string;
+    }>;
+    snapshotCompartido: CustomEvent<{
+        readonly snapshot: PayloadSnapshot;
+    }>;
+}
+export declare class SnapshotManager {
+    readonly eventTarget: EventTarget;
+    readonly docId: string;
+    private readonly interval;
+    private readonly storage;
+    private readonly maxSnapshots;
+    private contadorOperaciones;
+    private versionActual;
+    private datosActuales;
+    private readonly nodosConfirmados;
+    constructor(config: SnapshotManagerConfig);
+    incrementarOperaciones(): boolean;
+    crearSnapshot(datos?: Uint8Array, nodos?: readonly NodoId[]): Promise<boolean>;
+    restaurarSnapshot(version: number): Promise<Uint8Array | null>;
+    restaurarUltimoSnapshot(): Promise<Uint8Array | null>;
+    prepararSnapshotCompartido(): Promise<PayloadSnapshot | null>;
+    recibirSnapshot(snapshot: PayloadSnapshot): Promise<boolean>;
+    confirmarNodo(nodoId: NodoId): void;
+    obtenerNodosConfirmados(): readonly NodoId[];
+    obtenerVersionActual(): number;
+    obtenerContadorOperaciones(): number;
+    obtenerSnapshotsDisponibles(): Promise<readonly SnapshotMetadata[]>;
+    private limpiarSnapshotsViejos;
+    on<K extends keyof SnapshotEventMap>(tipo: K, handler: (ev: SnapshotEventMap[K]) => void): void;
+    off<K extends keyof SnapshotEventMap>(tipo: K, handler: (ev: SnapshotEventMap[K]) => void): void;
+    private emit;
+    private calcularHash;
+    reiniciar(): void;
+}
+export declare function createSnapshotManager(config: SnapshotManagerConfig): SnapshotManager;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/snapshot/index.js

@@ -0,0 +1,189 @@
+import { InMemoryStorage } from "../storage/index.js";
+// ─── CONSTANTS ─────────────────────────────────────────────────────────────
+const SNAPSHOT_POR_DEFECTO_CADA = 100;
+export class SnapshotManager {
+    eventTarget;
+    docId;
+    interval;
+    storage;
+    maxSnapshots;
+    contadorOperaciones = 0;
+    versionActual = 0;
+    datosActuales = null;
+    nodosConfirmados;
+    constructor(config) {
+        this.eventTarget = new EventTarget();
+        this.docId = config.docId;
+        this.interval = config.interval ?? SNAPSHOT_POR_DEFECTO_CADA;
+        this.storage = config.storage ?? new InMemoryStorage();
+        this.maxSnapshots = config.maxSnapshots ?? 10;
+        this.nodosConfirmados = new Set();
+    }
+    // ─── CREACION ────────────────────────────────────────────────────────
+    incrementarOperaciones() {
+        this.contadorOperaciones++;
+        if (this.contadorOperaciones >= this.interval) {
+            void this.crearSnapshot();
+            return true;
+        }
+        return false;
+    }
+    async crearSnapshot(datos, nodos) {
+        if (datos !== undefined) {
+            this.datosActuales = datos;
+        }
+        if (this.datosActuales === null)
+            return false;
+        this.versionActual++;
+        if (nodos !== undefined) {
+            this.nodosConfirmados.clear();
+            for (const n of nodos) {
+                this.nodosConfirmados.add(n);
+            }
+        }
+        // Guardar snapshot
+        const clave = `snapshot:${this.docId}:${this.versionActual}`;
+        await this.storage.set(clave, {
+            datos: this.datosActuales,
+            version: this.versionActual,
+            timestamp: Date.now(),
+            nodos: Array.from(this.nodosConfirmados),
+        });
+        // Limpiar snapshots viejos
+        await this.limpiarSnapshotsViejos();
+        this.contadorOperaciones = 0;
+        const metadata = {
+            version: this.versionActual,
+            timestamp: Date.now(),
+            nodos: Array.from(this.nodosConfirmados),
+            tamanio: this.datosActuales.length,
+            hash: await this.calcularHash(this.datosActuales),
+        };
+        this.emit("snapshotCreado", { snapshot: metadata, docId: this.docId });
+        return true;
+    }
+    // ─── RESTAURACION ────────────────────────────────────────────────────
+    async restaurarSnapshot(version) {
+        const clave = `snapshot:${this.docId}:${version}`;
+        const entry = await this.storage.get(clave);
+        if (entry === null)
+            return null;
+        this.datosActuales = entry.valor.datos;
+        this.versionActual = entry.valor.version;
+        this.emit("snapshotRestaurado", { version, docId: this.docId });
+        return this.datosActuales;
+    }
+    async restaurarUltimoSnapshot() {
+        if (this.versionActual === 0)
+            return null;
+        return this.restaurarSnapshot(this.versionActual);
+    }
+    // ─── COMPARTIR ───────────────────────────────────────────────────────
+    async prepararSnapshotCompartido() {
+        if (this.datosActuales === null)
+            return null;
+        const snapshot = {
+            docId: this.docId,
+            version: this.versionActual,
+            datos: this.datosActuales,
+            nodosConfirmados: Array.from(this.nodosConfirmados),
+        };
+        this.emit("snapshotCompartido", { snapshot });
+        return snapshot;
+    }
+    async recibirSnapshot(snapshot) {
+        if (snapshot.docId !== this.docId)
+            return false;
+        if (snapshot.version <= this.versionActual)
+            return false;
+        const clave = `snapshot:${this.docId}:${snapshot.version}`;
+        await this.storage.set(clave, {
+            datos: snapshot.datos,
+            version: snapshot.version,
+            timestamp: Date.now(),
+            nodos: snapshot.nodosConfirmados,
+        });
+        this.datosActuales = snapshot.datos;
+        this.versionActual = snapshot.version;
+        this.nodosConfirmados.clear();
+        for (const n of snapshot.nodosConfirmados) {
+            this.nodosConfirmados.add(n);
+        }
+        this.emit("snapshotRestaurado", {
+            version: snapshot.version,
+            docId: this.docId,
+        });
+        return true;
+    }
+    // ─── CONFIRMACION ────────────────────────────────────────────────────
+    confirmarNodo(nodoId) {
+        this.nodosConfirmados.add(nodoId);
+    }
+    obtenerNodosConfirmados() {
+        return Array.from(this.nodosConfirmados);
+    }
+    // ─── CONSULTAS ───────────────────────────────────────────────────────
+    obtenerVersionActual() {
+        return this.versionActual;
+    }
+    obtenerContadorOperaciones() {
+        return this.contadorOperaciones;
+    }
+    async obtenerSnapshotsDisponibles() {
+        const entries = await this.storage.list({
+            prefijo: `snapshot:${this.docId}:`,
+        });
+        return entries.map((e) => {
+            const valor = e.valor;
+            return {
+                version: valor.version,
+                timestamp: valor.timestamp,
+                nodos: valor.nodos,
+                tamanio: valor.datos.length,
+                hash: "",
+            };
+        });
+    }
+    // ─── LIMPIEZA ────────────────────────────────────────────────────────
+    async limpiarSnapshotsViejos() {
+        const disponibles = await this.obtenerSnapshotsDisponibles();
+        if (disponibles.length <= this.maxSnapshots)
+            return;
+        const ordenados = [...disponibles].sort((a, b) => a.version - b.version);
+        const aEliminar = ordenados.slice(0, ordenados.length - this.maxSnapshots);
+        for (const snap of aEliminar) {
+            const clave = `snapshot:${this.docId}:${snap.version}`;
+            await this.storage.delete(clave);
+        }
+    }
+    // ─── 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 ──────────────────────────────────────────────────────
+    async calcularHash(datos) {
+        const hashBuffer = await crypto.subtle.digest("SHA-256", datos.buffer);
+        const hashArray = new Uint8Array(hashBuffer);
+        return Array.from(hashArray)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    reiniciar() {
+        this.contadorOperaciones = 0;
+        this.versionActual = 0;
+        this.datosActuales = null;
+        this.nodosConfirmados.clear();
+    }
+}
+// ─── FACTORY ───────────────────────────────────────────────────────────────
+export function createSnapshotManager(config) {
+    return new SnapshotManager(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,49 @@
+import type { StorageEntry, StorageFilter } from "../types/index.js";
+export interface IStorage {
+    get<T>(key: string): Promise<StorageEntry<T> | null>;
+    set<T>(key: string, valor: T): Promise<void>;
+    put<T>(key: string, valor: T): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    list(filter?: StorageFilter): Promise<readonly StorageEntry<unknown>[]>;
+    clear(prefijo?: string): Promise<void>;
+    size(): Promise<number>;
+}
+export declare class StorageError extends Error {
+    readonly codigo: string;
+    constructor(mensaje: string, codigo?: string);
+}
+export declare class InMemoryStorage implements IStorage {
+    private readonly datos;
+    constructor();
+    get<T>(key: string): Promise<StorageEntry<T> | null>;
+    set<T>(key: string, valor: T): Promise<void>;
+    put<T>(key: string, valor: T): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    list(filter?: StorageFilter): Promise<readonly StorageEntry<unknown>[]>;
+    clear(prefijo?: string): Promise<void>;
+    size(): Promise<number>;
+}
+export interface StorageManagerConfig {
+    readonly dbName: string;
+    readonly storeName: string;
+    readonly version: number;
+}
+export declare class StorageManager implements IStorage {
+    private readonly config;
+    private db;
+    private readonly initPromise;
+    constructor(config?: Partial<StorageManagerConfig>);
+    private inicializar;
+    private obtenerDb;
+    get<T>(key: string): Promise<StorageEntry<T> | null>;
+    set<T>(key: string, valor: T): Promise<void>;
+    put<T>(key: string, valor: T): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    list(filter?: StorageFilter): Promise<readonly StorageEntry<unknown>[]>;
+    clear(prefijo?: string): Promise<void>;
+    size(): Promise<number>;
+    cerrar(): Promise<void>;
+}
+export { PayloadOptimizer } from "./optimizer.js";
+export { YDocPersistence, type YDocPersistenceOptions, } from "./ydoc-persistence.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/storage/index.js

@@ -0,0 +1,176 @@
+import { openDB } from "idb";
+// ─── ERROR TYPES ───────────────────────────────────────────────────────────
+export class StorageError extends Error {
+    codigo;
+    constructor(mensaje, codigo = "STORAGE_ERROR") {
+        super(mensaje);
+        this.name = "StorageError";
+        this.codigo = codigo;
+    }
+}
+// ─── IN-MEMORY STORAGE ─────────────────────────────────────────────────────
+export class InMemoryStorage {
+    datos;
+    constructor() {
+        this.datos = new Map();
+    }
+    async get(key) {
+        const entry = this.datos.get(key);
+        if (entry === undefined)
+            return null;
+        return entry;
+    }
+    async set(key, valor) {
+        const existente = this.datos.get(key);
+        this.datos.set(key, {
+            key,
+            valor,
+            timestamp: Date.now(),
+            version: (existente?.version ?? 0) + 1,
+        });
+    }
+    async put(key, valor) {
+        return this.set(key, valor);
+    }
+    async delete(key) {
+        return this.datos.delete(key);
+    }
+    async list(filter) {
+        let entries = Array.from(this.datos.values());
+        if (filter?.prefijo !== undefined) {
+            entries = entries.filter((e) => e.key.startsWith(filter.prefijo));
+        }
+        if (filter?.desde !== undefined) {
+            entries = entries.filter((e) => e.timestamp >= filter.desde);
+        }
+        if (filter?.hasta !== undefined) {
+            entries = entries.filter((e) => e.timestamp <= filter.hasta);
+        }
+        entries.sort((a, b) => a.timestamp - b.timestamp);
+        if (filter?.limite !== undefined && filter.limite > 0) {
+            entries = entries.slice(0, filter.limite);
+        }
+        return entries;
+    }
+    async clear(prefijo) {
+        if (prefijo === undefined) {
+            this.datos.clear();
+            return;
+        }
+        for (const key of this.datos.keys()) {
+            if (key.startsWith(prefijo)) {
+                this.datos.delete(key);
+            }
+        }
+    }
+    async size() {
+        return this.datos.size;
+    }
+}
+const CONFIG_POR_DEFECTO = {
+    dbName: "edge-mesh",
+    storeName: "kv",
+    version: 1,
+};
+export class StorageManager {
+    config;
+    db = null;
+    initPromise;
+    constructor(config = {}) {
+        this.config = { ...CONFIG_POR_DEFECTO, ...config };
+        this.initPromise = this.inicializar();
+    }
+    async inicializar() {
+        const storeName = this.config.storeName;
+        const db = await openDB(this.config.dbName, this.config.version, {
+            upgrade(db) {
+                if (!db.objectStoreNames.contains(storeName)) {
+                    db.createObjectStore(storeName, { keyPath: "key" });
+                }
+            },
+        });
+        this.db = db;
+        return db;
+    }
+    async obtenerDb() {
+        if (this.db !== null)
+            return this.db;
+        return this.initPromise;
+    }
+    async get(key) {
+        const db = await this.obtenerDb();
+        const result = await db.get(this.config.storeName, key);
+        if (result === undefined)
+            return null;
+        return result;
+    }
+    async set(key, valor) {
+        const db = await this.obtenerDb();
+        const existente = await this.get(key);
+        const entry = {
+            key,
+            valor,
+            timestamp: Date.now(),
+            version: (existente?.version ?? 0) + 1,
+        };
+        await db.put(this.config.storeName, entry);
+    }
+    async put(key, valor) {
+        return this.set(key, valor);
+    }
+    async delete(key) {
+        const db = await this.obtenerDb();
+        const existente = await this.get(key);
+        if (existente === null)
+            return false;
+        await db.delete(this.config.storeName, key);
+        return true;
+    }
+    async list(filter) {
+        const db = await this.obtenerDb();
+        const all = await db.getAll(this.config.storeName);
+        let entries = all;
+        if (filter?.prefijo !== undefined) {
+            entries = entries.filter((e) => e.key.startsWith(filter.prefijo));
+        }
+        if (filter?.desde !== undefined) {
+            entries = entries.filter((e) => e.timestamp >= filter.desde);
+        }
+        if (filter?.hasta !== undefined) {
+            entries = entries.filter((e) => e.timestamp <= filter.hasta);
+        }
+        entries.sort((a, b) => a.timestamp - b.timestamp);
+        if (filter?.limite !== undefined && filter.limite > 0) {
+            entries = entries.slice(0, filter.limite);
+        }
+        return entries;
+    }
+    async clear(prefijo) {
+        const db = await this.obtenerDb();
+        if (prefijo === undefined) {
+            await db.clear(this.config.storeName);
+            return;
+        }
+        const all = await db.getAll(this.config.storeName);
+        for (const entry of all) {
+            if (entry.key.startsWith(prefijo)) {
+                await db.delete(this.config.storeName, entry.key);
+            }
+        }
+    }
+    async size() {
+        const db = await this.obtenerDb();
+        const all = await db.getAll(this.config.storeName);
+        return all.length;
+    }
+    async cerrar() {
+        if (this.db !== null) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+}
+// ─── Y.DOC PERSISTENCE ─────────────────────────────────────────────────────
+export { PayloadOptimizer } from "./optimizer.js";
+export { YDocPersistence, } from "./ydoc-persistence.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

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

package/dist/storage/optimizer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Initializes the WASM module for Zstd.
+ * Must be called once before compressing or decompressing.
+ */
+export declare function initializeOptimizer(): Promise<void>;
+/**
+ * Utility class to compress large payloads before storing them in local databases (IndexedDB/OPFS)
+ * or broadcasting them across the P2P network.
+ *
+ * It serializes objects to CBOR (Concise Binary Object Representation) and then compresses
+ * the binary stream using Zstandard (Zstd), significantly reducing the required space.
+ */
+export declare class PayloadOptimizer {
+    /**
+     * Serializes an object to CBOR and compresses it with Zstd.
+     * @param payload Any serializable JavaScript object.
+     * @param level Compression level (default 10).
+     * @returns A Uint8Array containing the compressed binary data.
+     */
+    static compressPayload<T>(payload: T, level?: number): Promise<Uint8Array>;
+    /**
+     * Decompresses Zstd data and deserializes it from CBOR back to the original object.
+     * @param buffer The compressed binary data (Uint8Array).
+     * @returns The original parsed object.
+     */
+    static decompressPayload<T>(buffer: Uint8Array): Promise<T>;
+}
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/storage/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../src/storage/optimizer.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKzD;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC5B;;;;;OAKG;IACH,OAAa,eAAe,CAAC,CAAC,EAC7B,OAAO,EAAE,CAAC,EACV,KAAK,GAAE,MAAW,GAChB,OAAO,CAAC,UAAU,CAAC,CAUrB;IAED;;;;OAIG;IACH,OAAa,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAUhE;CACD"}