@quereus/sync-coordinator 0.3.5 → 0.3.7

package/dist/src/server/server.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Fastify server setup for sync-coordinator.
+ */
+import { type FastifyInstance } from 'fastify';
+import type { CoordinatorConfig } from '../config/types.js';
+import { CoordinatorService } from '../service/coordinator-service.js';
+import type { CoordinatorHooks } from '../service/types.js';
+/**
+ * Options for creating a coordinator server.
+ */
+export interface CoordinatorServerOptions {
+    /** Full configuration */
+    config: CoordinatorConfig;
+    /** Custom hooks for validation/auth */
+    hooks?: CoordinatorHooks;
+}
+/**
+ * Coordinator server instance.
+ */
+export interface CoordinatorServer {
+    /** The Fastify instance */
+    app: FastifyInstance;
+    /** The coordinator service */
+    service: CoordinatorService;
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+}
+/**
+ * Create a coordinator server.
+ */
+export declare function createCoordinatorServer(options: CoordinatorServerOptions): Promise<CoordinatorServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAkC,MAAM,mCAAmC,CAAC;AACvG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yBAAyB;IACzB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,uCAAuC;IACvC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,8BAA8B;IAC9B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,uBAAuB;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sBAAsB;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAqD5B"}

package/dist/src/server/server.js

@@ -0,0 +1,57 @@
+/**
+ * Fastify server setup for sync-coordinator.
+ */
+import Fastify from 'fastify';
+import fastifyCors from '@fastify/cors';
+import fastifyWebsocket from '@fastify/websocket';
+import { CoordinatorService } from '../service/coordinator-service.js';
+import { registerRoutes } from './routes.js';
+import { registerWebSocket } from './websocket.js';
+import { serverLog } from '../common/logger.js';
+/**
+ * Create a coordinator server.
+ */
+export async function createCoordinatorServer(options) {
+    const { config, hooks } = options;
+    serverLog('Creating coordinator server');
+    // Create Fastify instance
+    const app = Fastify({
+        logger: config.logging.level === 'debug',
+    });
+    // Register CORS
+    await app.register(fastifyCors, {
+        origin: config.cors.origin,
+        credentials: config.cors.credentials,
+    });
+    // Register WebSocket support
+    await app.register(fastifyWebsocket);
+    // Create service
+    const serviceOptions = {
+        config,
+        hooks,
+    };
+    const service = new CoordinatorService(serviceOptions);
+    // Initialize service
+    await service.initialize();
+    // Register routes
+    registerRoutes(app, service, config.basePath);
+    registerWebSocket(app, service, config.basePath);
+    serverLog('Routes registered at %s', config.basePath);
+    // Server control
+    const start = async () => {
+        const address = await app.listen({
+            host: config.host,
+            port: config.port,
+        });
+        serverLog('Server listening at %s', address);
+        console.log(`Sync coordinator listening at ${address}${config.basePath}`);
+    };
+    const stop = async () => {
+        serverLog('Stopping server');
+        await app.close();
+        await service.shutdown();
+        serverLog('Server stopped');
+    };
+    return { app, service, start, stop };
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/server/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAiC,MAAM,SAAS,CAAC;AACxD,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAkC,MAAM,mCAAmC,CAAC;AAEvG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA0BhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAiC;IAEjC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAElC,SAAS,CAAC,6BAA6B,CAAC,CAAC;IAEzC,0BAA0B;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO;KACzC,CAAC,CAAC;IAEH,gBAAgB;IAChB,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW;KACrC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAErC,iBAAiB;IACjB,MAAM,cAAc,GAA8B;QAChD,MAAM;QACN,KAAK;KACN,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAEvD,qBAAqB;IACrB,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAE3B,kBAAkB;IAClB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEjD,SAAS,CAAC,yBAAyB,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEtD,iBAAiB;IACjB,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;QACH,SAAS,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,iCAAiC,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/src/server/websocket.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WebSocket handler for real-time sync.
+ */
+import type { FastifyInstance } from 'fastify';
+import type { CoordinatorService } from '../service/coordinator-service.js';
+/**
+ * Register WebSocket handler.
+ */
+export declare function registerWebSocket(app: FastifyInstance, service: CoordinatorService, basePath: string): void;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/src/server/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/server/websocket.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAW/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAoD5E;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,GACf,IAAI,CA+IN"}

package/dist/src/server/websocket.js

@@ -0,0 +1,167 @@
+/**
+ * WebSocket handler for real-time sync.
+ */
+import { siteIdFromBase64, siteIdToBase64, deserializeHLC, serializeHLC, } from '@quereus/sync';
+import { wsLog } from '../common/logger.js';
+// ============================================================================
+// WebSocket Handler
+// ============================================================================
+/**
+ * Register WebSocket handler.
+ */
+export function registerWebSocket(app, service, basePath) {
+    app.get(`${basePath}/ws`, { websocket: true }, (socket, request) => {
+        wsLog('New WebSocket connection from %s', request.ip);
+        let session = null;
+        const sendError = (code, message) => {
+            socket.send(JSON.stringify({ type: 'error', code, message }));
+        };
+        const sendMessage = (msg) => {
+            socket.send(JSON.stringify(msg));
+        };
+        socket.on('message', async (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                wsLog('Received message: %s', message.type);
+                switch (message.type) {
+                    case 'handshake':
+                        await handleHandshake(message);
+                        break;
+                    case 'get_changes':
+                        await handleGetChanges(message);
+                        break;
+                    case 'apply_changes':
+                        await handleApplyChanges(message);
+                        break;
+                    case 'get_snapshot':
+                        await handleGetSnapshot();
+                        break;
+                    case 'ping':
+                        sendMessage({ type: 'pong' });
+                        break;
+                    default:
+                        sendError('UNKNOWN_MESSAGE', `Unknown message type: ${message.type}`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : 'Message processing failed';
+                wsLog('Message error: %s', msg);
+                sendError('MESSAGE_ERROR', msg);
+            }
+        });
+        socket.on('close', () => {
+            wsLog('WebSocket closed: %s', session?.connectionId?.slice(0, 8) || 'no-session');
+            if (session) {
+                service.unregisterSession(session.connectionId);
+            }
+        });
+        socket.on('error', (err) => {
+            wsLog('WebSocket error: %O', err);
+        });
+        // Handler functions
+        async function handleHandshake(msg) {
+            if (session) {
+                sendError('ALREADY_AUTHENTICATED', 'Already authenticated');
+                return;
+            }
+            if (!msg.databaseId) {
+                sendError('MISSING_DATABASE_ID', 'databaseId is required');
+                socket.close(4002, 'Missing databaseId');
+                return;
+            }
+            try {
+                const identity = await service.authenticate({
+                    databaseId: msg.databaseId,
+                    token: msg.token,
+                    siteIdRaw: msg.siteId,
+                    siteId: siteIdFromBase64(msg.siteId),
+                    socket,
+                });
+                session = await service.registerSession(msg.databaseId, socket, identity);
+                const serverSiteId = await service.getSiteId(msg.databaseId);
+                sendMessage({
+                    type: 'handshake_ack',
+                    databaseId: msg.databaseId,
+                    serverSiteId: siteIdToBase64(serverSiteId),
+                    connectionId: session.connectionId,
+                });
+                wsLog('Handshake complete: %s (db: %s)', session.connectionId.slice(0, 8), msg.databaseId);
+            }
+            catch (err) {
+                const errMsg = err instanceof Error ? err.message : 'Authentication failed';
+                sendError('AUTH_FAILED', errMsg);
+                socket.close(4001, 'Authentication failed');
+            }
+        }
+        async function handleGetChanges(msg) {
+            if (!session) {
+                sendError('NOT_AUTHENTICATED', 'Must handshake first');
+                return;
+            }
+            let sinceHLC;
+            if (msg.sinceHLC) {
+                sinceHLC = deserializeHLC(Buffer.from(msg.sinceHLC, 'base64'));
+            }
+            const changes = await service.getChangesSince(session.databaseId, session.identity, sinceHLC);
+            // Serialize for JSON transport
+            const serializedChanges = changes.map(cs => serializeChangeSet(cs));
+            sendMessage({ type: 'changes', changeSets: serializedChanges });
+        }
+        async function handleApplyChanges(msg) {
+            if (!session) {
+                sendError('NOT_AUTHENTICATED', 'Must handshake first');
+                return;
+            }
+            // Deserialize from JSON transport
+            const changes = msg.changes.map(cs => deserializeChangeSet(cs));
+            const result = await service.applyChanges(session.databaseId, session.identity, changes);
+            sendMessage({ type: 'apply_result', ...result });
+        }
+        async function handleGetSnapshot() {
+            if (!session) {
+                sendError('NOT_AUTHENTICATED', 'Must handshake first');
+                return;
+            }
+            // Stream snapshot chunks
+            for await (const chunk of service.getSnapshotStream(session.databaseId, session.identity)) {
+                sendMessage({ ...chunk, type: 'snapshot_chunk' });
+            }
+            sendMessage({ type: 'snapshot_complete' });
+        }
+    });
+}
+// ============================================================================
+// Serialization Helpers
+// ============================================================================
+function serializeChangeSet(cs) {
+    return {
+        siteId: siteIdToBase64(cs.siteId),
+        transactionId: cs.transactionId,
+        hlc: Buffer.from(serializeHLC(cs.hlc)).toString('base64'),
+        changes: cs.changes.map(c => ({
+            ...c,
+            hlc: Buffer.from(serializeHLC(c.hlc)).toString('base64'),
+        })),
+        schemaMigrations: cs.schemaMigrations.map(m => ({
+            ...m,
+            hlc: Buffer.from(serializeHLC(m.hlc)).toString('base64'),
+        })),
+    };
+}
+function deserializeChangeSet(cs) {
+    const obj = cs;
+    return {
+        siteId: siteIdFromBase64(obj.siteId),
+        transactionId: obj.transactionId,
+        hlc: deserializeHLC(Buffer.from(obj.hlc, 'base64')),
+        changes: obj.changes.map(c => ({
+            ...c,
+            hlc: deserializeHLC(Buffer.from(c.hlc, 'base64')),
+        })),
+        schemaMigrations: (obj.schemaMigrations || []).map(m => ({
+            ...m,
+            hlc: deserializeHLC(Buffer.from(m.hlc, 'base64')),
+        })),
+    };
+}
+//# sourceMappingURL=websocket.js.map

package/dist/src/server/websocket.js.map

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

package/dist/src/service/coordinator-service.d.ts

@@ -0,0 +1,122 @@
+/**
+ * CoordinatorService - Main service layer for multi-tenant sync coordination.
+ *
+ * Manages multiple database stores with lazy loading and provides
+ * sync operations with validation hooks and client session management.
+ */
+import type { WebSocket } from 'ws';
+import { type HLC, type SiteId, type ChangeSet, type ApplyResult, type SnapshotChunk } from '@quereus/sync';
+import type { CoordinatorConfig } from '../config/types.js';
+import { type CoordinatorMetrics } from '../metrics/index.js';
+import type { ClientIdentity, ClientSession, AuthContext, SyncOperation, CoordinatorHooks } from './types.js';
+/**
+ * Options for creating a CoordinatorService.
+ */
+export interface CoordinatorServiceOptions {
+    /** Full configuration */
+    config: CoordinatorConfig;
+    /** Custom hooks for validation/auth */
+    hooks?: CoordinatorHooks;
+    /** Custom metrics (uses global registry if not provided) */
+    metrics?: CoordinatorMetrics;
+}
+/**
+ * Multi-tenant coordinator service that manages sync operations with hooks.
+ */
+export declare class CoordinatorService {
+    private readonly config;
+    private readonly hooks;
+    private readonly metrics;
+    private readonly storeManager;
+    /** Active WebSocket sessions by connection ID */
+    private readonly sessions;
+    /** Connection IDs by database ID for broadcasting */
+    private readonly databaseToConnections;
+    private initialized;
+    constructor(options: CoordinatorServiceOptions);
+    /**
+     * Initialize the service.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown the service.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get a store entry for a database, acquiring if needed.
+     */
+    private getStore;
+    /**
+     * Release a store reference.
+     */
+    private releaseStore;
+    /**
+     * Authenticate a request/connection.
+     */
+    authenticate(context: AuthContext): Promise<ClientIdentity>;
+    /**
+     * Authorize an operation for a client.
+     */
+    authorize(client: ClientIdentity, operation: SyncOperation): Promise<boolean>;
+    /**
+     * Get the coordinator's site ID for a specific database.
+     */
+    getSiteId(databaseId: string): Promise<SiteId>;
+    /**
+     * Get current HLC for a specific database.
+     */
+    getCurrentHLC(databaseId: string): Promise<HLC>;
+    /**
+     * Get changes since a given HLC for a client.
+     */
+    getChangesSince(databaseId: string, client: ClientIdentity, sinceHLC?: HLC): Promise<ChangeSet[]>;
+    /**
+     * Apply changes from a client.
+     */
+    applyChanges(databaseId: string, client: ClientIdentity, changes: ChangeSet[]): Promise<ApplyResult>;
+    /**
+     * Stream a full snapshot.
+     */
+    getSnapshotStream(databaseId: string, client: ClientIdentity, chunkSize?: number): AsyncIterable<SnapshotChunk>;
+    /**
+     * Check if delta sync is possible.
+     */
+    canDeltaSync(databaseId: string, client: ClientIdentity, sinceHLC: HLC): Promise<boolean>;
+    /**
+     * Register a new WebSocket client session.
+     */
+    registerSession(databaseId: string, socket: WebSocket, identity: ClientIdentity): Promise<ClientSession>;
+    /**
+     * Unregister a WebSocket client session.
+     */
+    unregisterSession(connectionId: string): void;
+    /**
+     * Get a session by connection ID.
+     */
+    getSession(connectionId: string): ClientSession | undefined;
+    /**
+     * Update the last sync HLC for a session.
+     */
+    updateSessionSyncState(connectionId: string, hlc: HLC): void;
+    /**
+     * Broadcast changes to all connected clients on the same database except the sender.
+     */
+    private broadcastChanges;
+    /**
+     * Serialize a ChangeSet for JSON transport.
+     */
+    private serializeChangeSet;
+    /**
+     * Get server status and stats.
+     */
+    getStatus(): {
+        openStores: number;
+        connectedClients: number;
+        uptime: number;
+    };
+    /**
+     * Get the metrics registry for this service.
+     */
+    getMetrics(): CoordinatorMetrics;
+}
+//# sourceMappingURL=coordinator-service.d.ts.map

package/dist/src/service/coordinator-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-service.d.ts","sourceRoot":"","sources":["../../../src/service/coordinator-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EACL,KAAK,GAAG,EACR,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,EAKnB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,yBAAyB;IACzB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,uCAAuC;IACvC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IAExE,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,yBAAyB;IAgB9C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB/B;;OAEG;YACW,QAAQ;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAmCjE;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBnF;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASpD;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASrD;;OAEG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,GAAG,GACb,OAAO,CAAC,SAAS,EAAE,CAAC;IAsBvB;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,EAAE,GACnB,OAAO,CAAC,WAAW,CAAC;IAwEvB;;OAEG;IACI,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,CAAC,aAAa,CAAC;IAuB/B;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAa/F;;OAEG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;IAiDzB;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IA+B7C;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI3D;;OAEG;IACH,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAO5D;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,SAAS,IAAI;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;KAChB;IAQD;;OAEG;IACH,UAAU,IAAI,kBAAkB;CAGjC"}