@edryslabs/genericprovider 1.0.1

package/dist/providers/trystero/index.js

@@ -0,0 +1,187 @@
+/**
+ * Trystero Transport Provider
+ *
+ * Serverless peer-to-peer transport using Trystero with multiple strategies.
+ * Trystero uses decentralized infrastructure for peer discovery while keeping
+ * all data transmission direct and end-to-end encrypted.
+ *
+ * Features:
+ * - Zero server setup required
+ * - Multiple strategies: Nostr, BitTorrent, MQTT, Supabase, Firebase, IPFS
+ * - End-to-end encrypted P2P connections
+ * - Automatic chunking and serialization
+ * - Session encryption via AES-GCM
+ * - Optional TURN server support
+ *
+ * @example
+ * ```typescript
+ * import { GenericProvider } from 'y-generic'
+ * import { TrysteroTransport } from 'y-generic/providers/trystero'
+ * import { joinRoom } from 'trystero/nostr' // or other strategy
+ *
+ * const doc = new Y.Doc()
+ * const transport = new TrysteroTransport({
+ *   joinRoom,
+ *   appId: 'my-unique-app-id'
+ * })
+ * const provider = new GenericProvider(doc, transport)
+ * await provider.connect({ room: 'my-room' })
+ * ```
+ */
+/**
+ * Trystero transport implementation.
+ * Creates serverless P2P connections using Trystero library.
+ */
+export class TrysteroTransport {
+    constructor(options) {
+        this._connected = false;
+        this._room = '';
+        this.room = null;
+        this.sendUpdate = null;
+        this.peers = new Set();
+        this.options = {
+            debug: false,
+            ...options,
+        };
+    }
+    log(message, level = 'info') {
+        if (this.options.debug) {
+            const prefix = '[TrysteroTransport]';
+            switch (level) {
+                case 'error':
+                    console.error(prefix, message);
+                    break;
+                case 'warn':
+                    console.warn(prefix, message);
+                    break;
+                default:
+                    console.log(prefix, message);
+            }
+        }
+    }
+    get isConnected() {
+        return this._connected;
+    }
+    async connect(config) {
+        if (this._connected) {
+            this.log('Already connected, disconnecting first...');
+            this.disconnect();
+        }
+        const room = config.room;
+        if (!room) {
+            throw new Error('Room ID is required');
+        }
+        this._room = room;
+        this.log(`Connecting to room: ${room}`);
+        // Build Trystero config
+        const trysteroConfig = {
+            appId: this.options.appId,
+        };
+        // Add optional config
+        if (this.options.password)
+            trysteroConfig.password = this.options.password;
+        if (this.options.relayUrls)
+            trysteroConfig.relayUrls = this.options.relayUrls;
+        if (this.options.relayRedundancy)
+            trysteroConfig.relayRedundancy = this.options.relayRedundancy;
+        if (this.options.rtcConfig)
+            trysteroConfig.rtcConfig = this.options.rtcConfig;
+        if (this.options.turnConfig)
+            trysteroConfig.turnConfig = this.options.turnConfig;
+        if (this.options.rtcPolyfill)
+            trysteroConfig.rtcPolyfill = this.options.rtcPolyfill;
+        if (this.options.supabaseKey)
+            trysteroConfig.supabaseKey = this.options.supabaseKey;
+        if (this.options.firebaseApp)
+            trysteroConfig.firebaseApp = this.options.firebaseApp;
+        if (this.options.rootPath)
+            trysteroConfig.rootPath = this.options.rootPath;
+        if (this.options.manualRelayReconnection !== undefined) {
+            trysteroConfig.manualRelayReconnection =
+                this.options.manualRelayReconnection;
+        }
+        // Join room with error handler
+        this.room = this.options.joinRoom(trysteroConfig, room, (details) => {
+            this.log(`Join error: ${details.error}`, 'error');
+            if (this.onJoinErrorCallback) {
+                this.onJoinErrorCallback(details);
+            }
+        });
+        // Create action for Yjs updates
+        const [send, receive] = this.room.makeAction('yjs-update');
+        this.sendUpdate = send;
+        // Listen for incoming updates
+        receive((data, peerId) => {
+            this.log(`Received update from ${peerId} (${data.byteLength} bytes)`);
+            if (this._callback) {
+                // Convert ArrayBuffer to Uint8Array
+                this._callback(new Uint8Array(data));
+            }
+        });
+        // Track peers
+        this.room.onPeerJoin((peerId) => {
+            this.peers.add(peerId);
+            this.log(`Peer joined: ${peerId} (${this.peers.size} total)`);
+        });
+        this.room.onPeerLeave((peerId) => {
+            this.peers.delete(peerId);
+            this.log(`Peer left: ${peerId} (${this.peers.size} remaining)`);
+        });
+        this._connected = true;
+        this.log(`✅ Connected to room: ${room}`);
+    }
+    disconnect() {
+        if (!this._connected) {
+            return;
+        }
+        this.log('Disconnecting...');
+        if (this.room) {
+            this.room.leave();
+            this.room = null;
+        }
+        this.sendUpdate = null;
+        this._callback = undefined;
+        this._connected = false;
+        this.peers.clear();
+        this.log('✅ Disconnected');
+    }
+    async send(data) {
+        if (!this._connected || !this.sendUpdate) {
+            this.log('⚠️ Not connected, cannot send', 'warn');
+            return;
+        }
+        // Send to all peers (null = broadcast)
+        this.log(`Sending update (${data.byteLength} bytes) to ${this.peers.size} peers`);
+        await this.sendUpdate(data, null);
+    }
+    onMessage(callback) {
+        this._callback = callback;
+        this.log('Message callback registered');
+        return () => {
+            this._callback = undefined;
+            this.log('Message callback unregistered');
+        };
+    }
+    /**
+     * Set a callback for join errors (optional).
+     */
+    onJoinError(callback) {
+        this.onJoinErrorCallback = callback;
+    }
+    /**
+     * Get the set of connected peer IDs.
+     */
+    getPeers() {
+        return new Set(this.peers);
+    }
+    /**
+     * Ping a peer and get round-trip time in ms.
+     */
+    async ping(peerId) {
+        if (!this.room) {
+            throw new Error('Not connected to a room');
+        }
+        return await this.room.ping(peerId);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/trystero/index.js.map

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

package/dist/providers/websocket/index.d.ts

@@ -0,0 +1,92 @@
+import type { Transport, ConnectionConfig } from '../../transport';
+/**
+ * WebSocket transport configuration
+ */
+export interface WebSocketConfig extends ConnectionConfig {
+    /** WebSocket server URL (required) e.g., 'ws://localhost:1234' or 'wss://example.com' */
+    serverUrl: string;
+    /** Enable automatic reconnection on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnection delay in milliseconds (default: 2000) */
+    reconnectDelay?: number;
+    /** Maximum reconnection attempts (0 = infinite, default: 0) */
+    maxReconnectAttempts?: number;
+    /** WebSocket protocols (optional) */
+    protocols?: string | string[];
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * WebSocket Transport for Yjs
+ *
+ * Provides real-time synchronization using WebSocket connections.
+ *
+ * Features:
+ * - Direct WebSocket connection to server
+ * - Room-based collaboration
+ * - Automatic reconnection
+ * - Binary message support
+ * - Low latency real-time sync
+ *
+ * @example
+ * ```ts
+ * import * as Y from 'yjs'
+ * import { GenericProvider } from 'y-generic'
+ * import { WebSocketTransport } from 'y-generic/providers/websocket'
+ *
+ * const doc = new Y.Doc()
+ * const transport = new WebSocketTransport()
+ *
+ * const provider = new GenericProvider(doc, transport)
+ * await provider.connect({
+ *   serverUrl: 'ws://localhost:1234',
+ *   room: 'my-room'
+ * })
+ * ```
+ */
+export declare class WebSocketTransport implements Transport {
+    private ws;
+    private config;
+    private messageCallback?;
+    private _isConnected;
+    private debug;
+    private reconnectAttempts;
+    private reconnectTimer?;
+    private intentionalDisconnect;
+    private messageQueue;
+    private receivedBuffer;
+    get isConnected(): boolean;
+    /**
+     * Connect to WebSocket server
+     */
+    connect(config: WebSocketConfig): Promise<void>;
+    /**
+     * Disconnect from WebSocket server
+     */
+    disconnect(): void;
+    /**
+     * Send data to server
+     */
+    send(data: Uint8Array): void;
+    /**
+     * Register message callback
+     */
+    onMessage(callback: (data: Uint8Array) => void): () => void;
+    /**
+     * Handle incoming WebSocket message
+     */
+    private handleMessage;
+    /**
+     * Flush queued messages
+     */
+    private flushMessageQueue;
+    /**
+     * Attempt to reconnect
+     */
+    private attemptReconnect;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AA6ClE;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC7B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,eAAe,CAAC,CAA4B;IACpD,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,cAAc,CAAC,CAA+B;IACtD,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,cAAc,CAAmB;IAEzC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAgFrD;;OAEG;IACH,UAAU,IAAI,IAAI;IAiBlB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAiB5B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAmB3D;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/providers/websocket/index.js

@@ -0,0 +1,272 @@
+// ---------------------------------------------------------------------------
+// CRC32 translation helpers
+//
+// GenericProvider wraps every message as [CRC32 (4 bytes)][payload] before
+// calling transport.send(), and expects the same format from onMessage().
+// The y-websocket server however speaks plain Yjs wire format (no header).
+// These helpers translate between the two worlds at the transport boundary.
+// ---------------------------------------------------------------------------
+const _CRC32_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let c = i;
+        for (let j = 0; j < 8; j++)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        table[i] = c;
+    }
+    return table;
+})();
+function _crc32(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++)
+        crc = (crc >>> 8) ^ _CRC32_TABLE[(crc ^ data[i]) & 0xff];
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Strip the 4-byte CRC32 header that GenericProvider prepends. */
+function stripCRC32Header(data) {
+    return data.length >= 4 ? data.subarray(4) : data;
+}
+/** Add a valid CRC32 header so GenericProvider accepts the message. */
+function addCRC32Header(data) {
+    const crc = _crc32(data);
+    const wrapped = new Uint8Array(4 + data.length);
+    wrapped[0] = (crc >>> 24) & 0xff;
+    wrapped[1] = (crc >>> 16) & 0xff;
+    wrapped[2] = (crc >>> 8) & 0xff;
+    wrapped[3] = crc & 0xff;
+    wrapped.set(data, 4);
+    return wrapped;
+}
+/**
+ * WebSocket Transport for Yjs
+ *
+ * Provides real-time synchronization using WebSocket connections.
+ *
+ * Features:
+ * - Direct WebSocket connection to server
+ * - Room-based collaboration
+ * - Automatic reconnection
+ * - Binary message support
+ * - Low latency real-time sync
+ *
+ * @example
+ * ```ts
+ * import * as Y from 'yjs'
+ * import { GenericProvider } from 'y-generic'
+ * import { WebSocketTransport } from 'y-generic/providers/websocket'
+ *
+ * const doc = new Y.Doc()
+ * const transport = new WebSocketTransport()
+ *
+ * const provider = new GenericProvider(doc, transport)
+ * await provider.connect({
+ *   serverUrl: 'ws://localhost:1234',
+ *   room: 'my-room'
+ * })
+ * ```
+ */
+export class WebSocketTransport {
+    constructor() {
+        this.ws = null;
+        this.config = null;
+        this._isConnected = false;
+        this.debug = false;
+        this.reconnectAttempts = 0;
+        this.intentionalDisconnect = false;
+        this.messageQueue = []; // Queue messages until connected
+        this.receivedBuffer = []; // Buffer messages received before callback registered
+    }
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Connect to WebSocket server
+     */
+    async connect(config) {
+        this.config = config;
+        this.debug = config.debug ?? false;
+        this.intentionalDisconnect = false;
+        if (!config.serverUrl) {
+            throw new Error('WebSocket serverUrl is required');
+        }
+        if (!config.room) {
+            throw new Error('Room name is required');
+        }
+        // Build URL with room (y-websocket compatible)
+        let wsUrl = config.serverUrl;
+        // Remove trailing slash if present
+        if (wsUrl.endsWith('/')) {
+            wsUrl = wsUrl.slice(0, -1);
+        }
+        // Append room name to URL path
+        wsUrl = `${wsUrl}/${encodeURIComponent(config.room)}`;
+        this.log(`Connecting to WebSocket server: ${wsUrl}`);
+        return new Promise((resolve, reject) => {
+            try {
+                // Create WebSocket connection with room in URL (y-websocket style)
+                this.ws = new WebSocket(wsUrl, config.protocols);
+                this.ws.binaryType = 'arraybuffer';
+                const timeout = setTimeout(() => {
+                    if (this.ws && this.ws.readyState !== WebSocket.OPEN) {
+                        this.ws.close();
+                        reject(new Error('WebSocket connection timeout'));
+                    }
+                }, 10000);
+                this.ws.onopen = () => {
+                    clearTimeout(timeout);
+                    this._isConnected = true;
+                    this.reconnectAttempts = 0;
+                    this.log(`✅ WebSocket connected to room: ${config.room}`);
+                    // Flush queued messages
+                    this.flushMessageQueue();
+                    resolve();
+                };
+                this.ws.onmessage = (event) => {
+                    this.handleMessage(event.data);
+                };
+                this.ws.onerror = (error) => {
+                    clearTimeout(timeout);
+                    this.log('❌ WebSocket error:', error);
+                    if (!this._isConnected) {
+                        reject(new Error('WebSocket connection failed'));
+                    }
+                };
+                this.ws.onclose = (event) => {
+                    clearTimeout(timeout);
+                    this._isConnected = false;
+                    this.log(`WebSocket closed: code=${event.code}, reason=${event.reason || 'none'}`);
+                    // Attempt reconnection if not intentional
+                    if (!this.intentionalDisconnect && (config.autoReconnect ?? true)) {
+                        this.attemptReconnect();
+                    }
+                };
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Disconnect from WebSocket server
+     */
+    disconnect() {
+        this.intentionalDisconnect = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.ws) {
+            this.log('Disconnecting from WebSocket...');
+            this.ws.close(1000, 'Client disconnect');
+            this.ws = null;
+        }
+        this._isConnected = false;
+    }
+    /**
+     * Send data to server
+     */
+    send(data) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            this.log('⚠️ WebSocket not ready, queueing message');
+            this.messageQueue.push(data);
+            return;
+        }
+        try {
+            // Strip CRC32 header added by GenericProvider before sending to server
+            const raw = stripCRC32Header(data);
+            this.ws.send(raw);
+            this.log(`📤 Sent ${raw.length} bytes (${data.length} with header)`);
+        }
+        catch (error) {
+            this.log('❌ Send error:', error);
+        }
+    }
+    /**
+     * Register message callback
+     */
+    onMessage(callback) {
+        this.messageCallback = callback;
+        // Flush any buffered messages that arrived before callback was registered
+        if (this.receivedBuffer.length > 0) {
+            this.log(`📦 Flushing ${this.receivedBuffer.length} buffered received messages`);
+            for (const data of this.receivedBuffer) {
+                callback(data);
+            }
+            this.receivedBuffer = [];
+        }
+        return () => {
+            this.messageCallback = undefined;
+        };
+    }
+    /**
+     * Handle incoming WebSocket message
+     */
+    handleMessage(data) {
+        try {
+            if (typeof data === 'string') {
+                // Handle text messages (control messages)
+                this.log('📨 Received text message:', data);
+                return;
+            }
+            // Wrap plain y-websocket message with CRC32 header expected by GenericProvider
+            const uint8Data = addCRC32Header(new Uint8Array(data));
+            this.log(`📨 Received ${uint8Data.length - 4} bytes`);
+            if (this.messageCallback) {
+                this.messageCallback(uint8Data);
+            }
+            else {
+                // Buffer message if callback not registered yet (race condition)
+                this.log('⏳ Buffering message (callback not yet registered)');
+                this.receivedBuffer.push(uint8Data);
+            }
+        }
+        catch (error) {
+            this.log('❌ Error handling message:', error);
+        }
+    }
+    /**
+     * Flush queued messages
+     */
+    flushMessageQueue() {
+        if (this.messageQueue.length === 0)
+            return;
+        this.log(`📦 Flushing ${this.messageQueue.length} queued messages`);
+        for (const data of this.messageQueue) {
+            this.send(data);
+        }
+        this.messageQueue = [];
+    }
+    /**
+     * Attempt to reconnect
+     */
+    attemptReconnect() {
+        if (!this.config)
+            return;
+        const maxAttempts = this.config.maxReconnectAttempts ?? 0;
+        if (maxAttempts > 0 && this.reconnectAttempts >= maxAttempts) {
+            this.log(`❌ Max reconnection attempts (${maxAttempts}) reached`);
+            return;
+        }
+        this.reconnectAttempts++;
+        const delay = this.config.reconnectDelay ?? 2000;
+        this.log(`🔄 Attempting reconnection #${this.reconnectAttempts} in ${delay}ms...`);
+        this.reconnectTimer = setTimeout(async () => {
+            try {
+                await this.connect(this.config);
+                this.log('✅ Reconnected successfully');
+            }
+            catch (error) {
+                this.log('❌ Reconnection failed:', error);
+            }
+        }, delay);
+    }
+    /**
+     * Debug logging
+     */
+    log(message, ...args) {
+        if (this.debug) {
+            console.log(`[WebSocketTransport] ${message}`, ...args);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/websocket/index.js.map

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

package/dist/sync-monitor.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Optional sync monitoring utilities using hash-based detection.
+ *
+ * ⚠️ NOTE: For most use cases, use the BUILT-IN verification instead:
+ *   GenericProvider with verifyUpdates: true (default)
+ *
+ * When to use SyncHealthMonitor:
+ * - You need to monitor sync health across ALL peers simultaneously
+ * - You want periodic pub/sub-based hash broadcasting for diagnostics
+ * - You need alerting/monitoring separate from the core sync mechanism
+ *
+ * When to use built-in verification (recommended):
+ * - Fast desync detection on every update (no waiting)
+ * - Exponential backoff and rate limiting
+ * - Sequence numbers for duplicate detection
+ * - Zero configuration (enabled by default)
+ *
+ * This utility is complementary to Yjs's built-in state vector sync.
+ * Use for monitoring/alerting, not as primary sync mechanism.
+ */
+import * as Y from 'yjs';
+import type { GenericProvider } from '../src/index';
+/**
+ * Compute hash of entire Yjs document state.
+ */
+export declare function computeDocumentHash(doc: Y.Doc): string;
+/**
+ * Sync health monitor that detects divergence using periodic hashing.
+ */
+export declare class SyncHealthMonitor {
+    private options;
+    private provider;
+    private intervalId?;
+    private localHash;
+    private peerHashes;
+    constructor(provider: GenericProvider, options?: {
+        /** How often to check sync health (ms) */
+        checkInterval?: number;
+        /** Callback when desync detected */
+        onDesync?: (details: DesyncDetails) => void;
+    });
+    /**
+     * Start monitoring sync health.
+     */
+    start(): void;
+    /**
+     * Stop monitoring.
+     */
+    stop(): void;
+    /**
+     * Perform a health check.
+     */
+    private checkHealth;
+    /**
+     * Handle hash from peer.
+     */
+    private handlePeerHash;
+    /**
+     * Detect if any peer has different hash.
+     */
+    private detectDivergence;
+}
+export interface DesyncDetails {
+    localHash: string;
+    peerHashes: Map<number, string>;
+    divergentClients: number[];
+    timestamp: number;
+}
+/**
+ * Example usage:
+ *
+ * ```typescript
+ * const provider = new GenericProvider(doc, transport)
+ * await provider.connect({ room: 'my-room' })
+ *
+ * // Start monitoring
+ * const monitor = new SyncHealthMonitor(provider, {
+ *   checkInterval: 5000, // Check every 5 seconds
+ *   onDesync: (details) => {
+ *     console.error('Documents out of sync!', details)
+ *     // Send to error tracking, show warning to user, etc.
+ *   }
+ * })
+ * monitor.start()
+ *
+ * // Stop when done
+ * monitor.stop()
+ * ```
+ */
+//# sourceMappingURL=sync-monitor.d.ts.map

package/dist/sync-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-monitor.d.ts","sourceRoot":"","sources":["../src/sync-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAcnD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAQ1B,OAAO,CAAC,OAAO;IAPjB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAC,CAAK;IACxB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAiC;gBAGjD,QAAQ,EAAE,eAAe,EACjB,OAAO,GAAE;QACf,0CAA0C;QAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,oCAAoC;QACpC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;KACvC;IAMR;;OAEG;IACH,KAAK,IAAI,IAAI;IAiBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiCzB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG"}