@syncular/server 0.0.6-96 → 0.1.0

package/dist/relay/realtime.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @syncular/server/relay - Realtime WebSocket Manager
+ *
+ * Manages WebSocket connections for local clients to receive
+ * instant notifications when data changes.
+ *
+ * Adapted from @syncular/server/hono/ws.ts for relay use.
+ */
+/**
+ * WebSocket event data for sync notifications.
+ */
+export interface RelayWebSocketEvent {
+    event: 'sync' | 'heartbeat' | 'error';
+    data: {
+        cursor?: number;
+        error?: string;
+        timestamp: number;
+    };
+}
+/**
+ * WebSocket connection interface for the relay.
+ */
+export interface RelayWebSocketConnection {
+    sendSync(cursor: number): void;
+    sendHeartbeat(): void;
+    sendError(message: string): void;
+    close(code?: number, reason?: string): void;
+    isOpen: boolean;
+    actorId: string;
+    clientId: string;
+    ownerKey: string;
+}
+/**
+ * Realtime manager for relay WebSocket connections.
+ *
+ * Tracks active connections by client ID and scope key for
+ * efficient notification routing.
+ */
+export declare class RelayRealtime {
+    private readonly registry;
+    constructor(options?: {
+        heartbeatIntervalMs?: number;
+    });
+    /**
+     * Register a connection for a client.
+     * Returns a cleanup function to unregister.
+     */
+    register(connection: RelayWebSocketConnection, initialScopeKeys?: string[]): () => void;
+    /**
+     * Update the effective scopes for an already-connected client.
+     */
+    updateClientScopeKeys(clientId: string, scopeKeys: string[]): void;
+    /**
+     * Notify clients that new data is available for the given scopes.
+     */
+    notifyScopeKeys(scopeKeys: string[], cursor: number, opts?: {
+        excludeClientIds?: string[];
+    }): void;
+    /**
+     * Get the number of active connections for a client.
+     */
+    getConnectionCount(clientId: string): number;
+    /**
+     * Get total number of active connections.
+     */
+    getTotalConnections(): number;
+    /**
+     * Close all connections for a client.
+     */
+    closeClientConnections(clientId: string): void;
+    /**
+     * Close all connections.
+     */
+    closeAll(): void;
+}
+/**
+ * Create a WebSocket connection wrapper.
+ *
+ * Use this with your WebSocket library to create connections
+ * compatible with RelayRealtime.
+ */
+export declare function createRelayWebSocketConnection(ws: {
+    send(message: string): void;
+    close(code?: number, reason?: string): void;
+    readyState: number;
+}, args: {
+    actorId: string;
+    clientId: string;
+}): RelayWebSocketConnection;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/relay/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/relay/realtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IACtC,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,IAAI,IAAI,CAAC;IACtB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuD;IAEhF,YAAY,OAAO,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,EAIrD;IAED;;;OAGG;IACH,QAAQ,CACN,UAAU,EAAE,wBAAwB,EACpC,gBAAgB,GAAE,MAAM,EAAO,GAC9B,MAAM,IAAI,CAEZ;IAED;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAYjE;IAED;;OAEG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACrC,IAAI,CAQN;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3C;IAED;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7C;IAED;;OAEG;IACH,QAAQ,IAAI,IAAI,CAEf;CACF;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE;IACF,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB,EACD,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C,wBAAwB,CA4D1B"}

package/dist/relay/realtime.js

@@ -0,0 +1,147 @@
+/**
+ * @syncular/server/relay - Realtime WebSocket Manager
+ *
+ * Manages WebSocket connections for local clients to receive
+ * instant notifications when data changes.
+ *
+ * Adapted from @syncular/server/hono/ws.ts for relay use.
+ */
+import { RealtimeConnectionRegistry } from '@syncular/core';
+function createRelayConnectionOwnerKey(args) {
+    return JSON.stringify([args.actorId, args.clientId]);
+}
+/**
+ * Realtime manager for relay WebSocket connections.
+ *
+ * Tracks active connections by client ID and scope key for
+ * efficient notification routing.
+ */
+export class RelayRealtime {
+    registry;
+    constructor(options) {
+        this.registry = new RealtimeConnectionRegistry({
+            heartbeatIntervalMs: options?.heartbeatIntervalMs,
+        });
+    }
+    /**
+     * Register a connection for a client.
+     * Returns a cleanup function to unregister.
+     */
+    register(connection, initialScopeKeys = []) {
+        return this.registry.register(connection, initialScopeKeys);
+    }
+    /**
+     * Update the effective scopes for an already-connected client.
+     */
+    updateClientScopeKeys(clientId, scopeKeys) {
+        const connections = this.registry.getConnectionsForClient(clientId);
+        if (!connections || connections.size === 0)
+            return;
+        const ownerKeys = new Set();
+        for (const connection of connections) {
+            ownerKeys.add(connection.ownerKey);
+        }
+        for (const ownerKey of ownerKeys) {
+            this.registry.updateOwnerScopeKeys(ownerKey, scopeKeys);
+        }
+    }
+    /**
+     * Notify clients that new data is available for the given scopes.
+     */
+    notifyScopeKeys(scopeKeys, cursor, opts) {
+        this.registry.forEachConnectionInScopeKeys(scopeKeys, (conn) => {
+            conn.sendSync(cursor);
+        }, { excludeClientIds: opts?.excludeClientIds });
+    }
+    /**
+     * Get the number of active connections for a client.
+     */
+    getConnectionCount(clientId) {
+        return this.registry.getConnectionCount(clientId);
+    }
+    /**
+     * Get total number of active connections.
+     */
+    getTotalConnections() {
+        return this.registry.getTotalConnections();
+    }
+    /**
+     * Close all connections for a client.
+     */
+    closeClientConnections(clientId) {
+        this.registry.closeClientConnections(clientId, 1000, 'client closed');
+    }
+    /**
+     * Close all connections.
+     */
+    closeAll() {
+        this.registry.closeAll(1000, 'server shutdown');
+    }
+}
+/**
+ * Create a WebSocket connection wrapper.
+ *
+ * Use this with your WebSocket library to create connections
+ * compatible with RelayRealtime.
+ */
+export function createRelayWebSocketConnection(ws, args) {
+    let closed = false;
+    function safeSend(message) {
+        try {
+            ws.send(message);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    const connection = {
+        get isOpen() {
+            if (closed)
+                return false;
+            return ws.readyState === 1;
+        },
+        actorId: args.actorId,
+        clientId: args.clientId,
+        ownerKey: createRelayConnectionOwnerKey(args),
+        sendSync(cursor) {
+            if (!connection.isOpen)
+                return;
+            const ok = safeSend(JSON.stringify({
+                event: 'sync',
+                data: { cursor, timestamp: Date.now() },
+            }));
+            if (!ok)
+                closed = true;
+        },
+        sendHeartbeat() {
+            if (!connection.isOpen)
+                return;
+            const ok = safeSend(JSON.stringify({ event: 'heartbeat', data: { timestamp: Date.now() } }));
+            if (!ok)
+                closed = true;
+        },
+        sendError(message) {
+            if (connection.isOpen) {
+                safeSend(JSON.stringify({
+                    event: 'error',
+                    data: { error: message, timestamp: Date.now() },
+                }));
+            }
+            connection.close(1011, 'server error');
+        },
+        close(code, reason) {
+            if (closed)
+                return;
+            closed = true;
+            try {
+                ws.close(code, reason);
+            }
+            catch {
+                // ignore
+            }
+        },
+    };
+    return connection;
+}
+//# sourceMappingURL=realtime.js.map

package/dist/relay/realtime.js.map

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

package/dist/relay/relay.d.ts

@@ -0,0 +1,190 @@
+/**
+ * @syncular/server/relay - Relay Server
+ *
+ * An edge relay server that acts as a local server to nearby clients
+ * while simultaneously acting as a client to the main server.
+ *
+ * Enables offline-first architectures where local network devices
+ * continue syncing when internet is lost.
+ */
+import type { ScopeValues, SyncTransport } from '@syncular/core';
+import type { ServerHandlerCollection, ServerSyncDialect, SyncServerAuth } from '@syncular/server';
+import type { Hono } from 'hono';
+import type { Kysely } from 'kysely';
+import { type RelayMode } from './mode-manager';
+import { RelayRealtime } from './realtime';
+import type { ForwardConflictEntry, RelayDatabase } from './schema';
+type RelayAuth = SyncServerAuth;
+/**
+ * Events emitted by the relay server.
+ */
+export interface RelayEvents {
+    modeChange: (mode: RelayMode) => void;
+    forwardConflict: (conflict: ForwardConflictEntry) => void;
+    error: (error: Error) => void;
+}
+/**
+ * Configuration options for creating a relay server.
+ */
+export interface RelayServerOptions<DB extends RelayDatabase = RelayDatabase> {
+    /** Kysely database instance */
+    db: Kysely<DB>;
+    /** Server sync dialect (e.g., SQLite or Postgres) */
+    dialect: ServerSyncDialect;
+    /** Transport for communicating with the main server */
+    mainServerTransport: SyncTransport;
+    /** Client ID used when communicating with the main server */
+    mainServerClientId: string;
+    /** Actor ID used when communicating with the main server */
+    mainServerActorId: string;
+    /** Tables this relay subscribes to from the main server */
+    tables: string[];
+    /** Scope values for subscriptions to the main server */
+    scopes: ScopeValues;
+    /** Handler registry for handling operations */
+    handlers: ServerHandlerCollection<DB, RelayAuth>;
+    /** Optional: WebSocket heartbeat interval in milliseconds (default: 30000) */
+    heartbeatIntervalMs?: number;
+    /** Optional: Forward engine retry interval in milliseconds (default: 5000) */
+    forwardRetryIntervalMs?: number;
+    /** Optional: Pull engine interval in milliseconds (default: 10000) */
+    pullIntervalMs?: number;
+    /** Optional: Health check interval in milliseconds (default: 30000) */
+    healthCheckIntervalMs?: number;
+    /** Optional: Prune interval in milliseconds (default: 3600000 = 1 hour). Set to 0 to disable. */
+    pruneIntervalMs?: number;
+    /** Optional: Maximum age of completed relay data before pruning (default: 604800000 = 7 days) */
+    pruneMaxAgeMs?: number;
+}
+/**
+ * Result of relay data pruning.
+ */
+export interface PruneRelayResult {
+    deletedMappings: number;
+    deletedOutbox: number;
+    deletedConflicts: number;
+}
+type EventHandler<K extends keyof RelayEvents> = RelayEvents[K];
+/**
+ * Relay server that acts as an edge relay between local clients and a main server.
+ *
+ * @example
+ * ```typescript
+ * import { createRelayServer } from '@syncular/server/relay';
+ * import { createSqliteServerDialect } from '@syncular/server/sqlite';
+ *
+ * const relay = createRelayServer({
+ *   db: sqliteDb,
+ *   dialect: createSqliteServerDialect(),
+ *   mainServerTransport: createHttpTransport({ baseUrl: 'https://main.example.com/sync' }),
+ *   mainServerClientId: 'relay-branch-001',
+ *   mainServerActorId: 'relay-service',
+ *   tables: ['tasks', 'projects'],
+ *   scopes: { project_id: 'acme' },
+ *   handlers: shapeRegistry,
+ * });
+ *
+ * // Mount routes for local clients
+ * app.route('/sync', await relay.getRoutes());
+ *
+ * // Start background sync with main
+ * await relay.start();
+ *
+ * // Events
+ * relay.on('modeChange', (mode) => console.log(mode));
+ * relay.on('forwardConflict', (conflict) => handleConflict(conflict));
+ * ```
+ */
+export declare class RelayServer<DB extends RelayDatabase = RelayDatabase> {
+    private readonly db;
+    private readonly dialect;
+    private readonly mainServerTransport;
+    private readonly mainServerClientId;
+    private readonly mainServerActorId;
+    private readonly tables;
+    private readonly scopes;
+    private readonly handlers;
+    private readonly modeManager;
+    private readonly sequenceMapper;
+    private readonly forwardEngine;
+    private readonly pullEngine;
+    private readonly realtime;
+    private readonly eventHandlers;
+    private readonly pruneIntervalMs;
+    private readonly pruneMaxAgeMs;
+    private lastPruneAtMs;
+    private pruneInFlight;
+    private started;
+    private schemaInitialized;
+    private routes;
+    private routesPromise;
+    constructor(options: RelayServerOptions<DB>);
+    /**
+     * Subscribe to relay events.
+     */
+    on<K extends keyof RelayEvents>(event: K, handler: EventHandler<K>): () => void;
+    /**
+     * Get the current mode (online/offline/reconnecting).
+     */
+    getMode(): RelayMode;
+    /**
+     * Get the tables this relay subscribes to.
+     */
+    getTables(): readonly string[];
+    /**
+     * Get the scope values for subscriptions.
+     */
+    getScopes(): ScopeValues;
+    /**
+     * Get the realtime manager for WebSocket connections.
+     */
+    getRealtime(): RelayRealtime;
+    /**
+     * Start the relay server background processes.
+     *
+     * This initializes the database schema and starts:
+     * - Forward engine (sends local commits to main)
+     * - Pull engine (receives changes from main)
+     * - Mode manager (tracks online/offline state)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the relay server background processes.
+     */
+    stop(): Promise<void>;
+    /**
+     * Manually trigger a forward cycle (useful for testing).
+     */
+    forwardOnce(): Promise<boolean>;
+    /**
+     * Manually trigger a pull cycle (useful for testing).
+     */
+    pullOnce(): Promise<boolean>;
+    /**
+     * Prune old relay data (sequence mappings, forwarded outbox, resolved conflicts).
+     */
+    pruneRelay(options?: {
+        maxAgeMs?: number;
+    }): Promise<PruneRelayResult>;
+    /**
+     * Rate-limited pruning. Skips if called within `pruneIntervalMs` of last prune.
+     * Returns zero counts if skipped or if pruning is disabled.
+     */
+    maybePruneRelay(): Promise<PruneRelayResult>;
+    /**
+     * Get Hono routes for local clients.
+     *
+     * Mount these routes to serve local sync clients:
+     * - POST /pull
+     * - POST /push
+     * - GET /realtime (WebSocket)
+     */
+    getRoutes(): Promise<Hono>;
+    private emit;
+}
+/**
+ * Create a new relay server instance.
+ */
+export declare function createRelayServer(options: RelayServerOptions): RelayServer;
+export {};
+//# sourceMappingURL=relay.d.ts.map

package/dist/relay/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/relay/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMrC,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEpE,KAAK,SAAS,GAAG,cAAc,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,eAAe,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,EAAE,SAAS,aAAa,GAAG,aAAa;IAC1E,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,qDAAqD;IACrD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,uDAAuD;IACvD,mBAAmB,EAAE,aAAa,CAAC;IACnC,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,WAAW,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,EAAE,uBAAuB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACjD,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iGAAiG;IACjG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAW,CAAC,EAAE,SAAS,aAAa,GAAG,aAAa;IAC/D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAElE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;IAEJ,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAA0C;IAE/D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAA8B;IAEnD,YAAY,OAAO,EAAE,kBAAkB,CAAC,EAAE,CAAC,EAyD1C;IAED;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAC5B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI,CAWZ;IAED;;OAEG;IACH,OAAO,IAAI,SAAS,CAEnB;IAED;;OAEG;IACH,SAAS,IAAI,SAAS,MAAM,EAAE,CAE7B;IAED;;OAEG;IACH,SAAS,IAAI,WAAW,CAEvB;IAED;;OAEG;IACH,WAAW,IAAI,aAAa,CAE3B;IAED;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B3B;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ1B;IAED;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAEpC;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAEjC;IAED;;OAEG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsB3E;IAED;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAuBjD;IAED;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB/B;IAED,OAAO,CAAC,IAAI;CAeb;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAE1E"}