@risingwave/wavelet-server 0.2.4 → 0.2.5

package/dist/__tests__/ws-fanout.test.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_events_1 = require("node:events");
+const vitest_1 = require("vitest");
+const ws_1 = require("ws");
+const ws_fanout_js_1 = require("../ws-fanout.js");
+class MockSocket extends node_events_1.EventEmitter {
+    readyState = ws_1.WebSocket.OPEN;
+    sent = [];
+    send(message) {
+        this.sent.push(message);
+    }
+    ping() { }
+    close() {
+        this.readyState = ws_1.WebSocket.CLOSED;
+        this.emit('close');
+    }
+}
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve, reject };
+}
+(0, vitest_1.describe)('WebSocketFanout', () => {
+    (0, vitest_1.it)('drops queued shared diffs that are already covered by bootstrap', async () => {
+        const bootstrapDeferred = deferred();
+        const cursorManager = {
+            bootstrap: vitest_1.vi.fn().mockReturnValue(bootstrapDeferred.promise),
+        };
+        const jwt = {
+            isConfigured: () => false,
+        };
+        const fanout = new ws_fanout_js_1.WebSocketFanout(cursorManager, jwt, {
+            leaderboard: {},
+        });
+        const ws = new MockSocket();
+        const req = {
+            url: '/subscribe/leaderboard',
+            headers: { host: 'localhost' },
+        };
+        const connectionPromise = fanout.handleConnection(ws, req);
+        fanout.broadcast('leaderboard', {
+            cursor: '150',
+            inserted: [{ player_id: 'alice', score: 10 }],
+            updated: [],
+            deleted: [],
+        });
+        fanout.broadcast('leaderboard', {
+            cursor: '300',
+            inserted: [{ player_id: 'bob', score: 20 }],
+            updated: [],
+            deleted: [],
+        });
+        bootstrapDeferred.resolve({
+            snapshotRows: [{ player_id: 'alice', score: 10 }],
+            diffs: [{
+                    cursor: '200',
+                    inserted: [],
+                    updated: [{ player_id: 'alice', score: 15 }],
+                    deleted: [],
+                }],
+            lastCursor: '200',
+        });
+        await connectionPromise;
+        const messages = ws.sent.map((message) => JSON.parse(message));
+        (0, vitest_1.expect)(messages).toEqual([
+            { type: 'connected', query: 'leaderboard' },
+            {
+                type: 'snapshot',
+                query: 'leaderboard',
+                rows: [{ player_id: 'alice', score: 10 }],
+            },
+            {
+                type: 'diff',
+                query: 'leaderboard',
+                cursor: '200',
+                inserted: [],
+                updated: [{ player_id: 'alice', score: 15 }],
+                deleted: [],
+            },
+            {
+                type: 'diff',
+                query: 'leaderboard',
+                cursor: '300',
+                inserted: [{ player_id: 'bob', score: 20 }],
+                updated: [],
+                deleted: [],
+            },
+        ]);
+    });
+    (0, vitest_1.it)('filters snapshot rows with the same claim rule as diffs', async () => {
+        const cursorManager = {
+            bootstrap: vitest_1.vi.fn().mockResolvedValue({
+                snapshotRows: [
+                    { user_id: 'u1', total: 10 },
+                    { user_id: 'u2', total: 20 },
+                ],
+                diffs: [],
+                lastCursor: null,
+            }),
+        };
+        const jwt = {
+            isConfigured: () => true,
+            verify: vitest_1.vi.fn().mockResolvedValue({ user_id: 'u1' }),
+        };
+        const fanout = new ws_fanout_js_1.WebSocketFanout(cursorManager, jwt, {
+            totals: { filterBy: 'user_id' },
+        });
+        const ws = new MockSocket();
+        const req = {
+            url: '/subscribe/totals?token=test-token',
+            headers: { host: 'localhost' },
+        };
+        await fanout.handleConnection(ws, req);
+        const snapshotMessage = JSON.parse(ws.sent[1]);
+        (0, vitest_1.expect)(snapshotMessage).toEqual({
+            type: 'snapshot',
+            query: 'totals',
+            rows: [{ user_id: 'u1', total: 10 }],
+        });
+    });
+});
+//# sourceMappingURL=ws-fanout.test.js.map

package/dist/__tests__/ws-fanout.test.js.map

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

package/dist/config-loader.d.ts

@@ -0,0 +1,3 @@
+import type { WaveletConfig } from '@risingwave/wavelet';
+export declare function loadConfig(configPath: string): Promise<WaveletConfig>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAuB3E"}

package/dist/config-loader.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const node_url_1 = require("node:url");
+const node_path_1 = require("node:path");
+async function loadConfig(configPath) {
+    const abs = (0, node_path_1.resolve)(configPath);
+    const mod = await import((0, node_url_1.pathToFileURL)(abs).href);
+    // Handle various module formats:
+    // - ESM: mod.default is the config
+    // - CJS interop: mod.default.default is the config
+    // - Plain object: mod itself is the config
+    let config = mod.default ?? mod;
+    if (config && typeof config === 'object' && 'default' in config) {
+        config = config.default;
+    }
+    if (!config || !config.database) {
+        throw new Error(`wavelet.config.ts must export a config with a 'database' field.\n` +
+            `Example:\n` +
+            `  import { defineConfig } from '@risingwave/wavelet'\n` +
+            `  export default defineConfig({ database: 'postgres://...' })`);
+    }
+    return config;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":";;AAIA,gCAuBC;AA3BD,uCAAwC;AACxC,yCAAmC;AAG5B,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,MAAM,GAAG,GAAG,IAAA,mBAAO,EAAC,UAAU,CAAC,CAAA;IAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAA,wBAAa,EAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;IAEjD,iCAAiC;IACjC,mCAAmC;IACnC,mDAAmD;IACnD,2CAA2C;IAC3C,IAAI,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAA;IAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QAChE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAA;IACzB,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,mEAAmE;YACnE,YAAY;YACZ,wDAAwD;YACxD,+DAA+D,CAChE,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/cursor-manager.d.ts

@@ -0,0 +1,54 @@
+import type { SqlFragment, QueryDef } from '@risingwave/wavelet';
+export interface DiffRow {
+    op: 'insert' | 'update_insert' | 'update_delete' | 'delete';
+    row: Record<string, unknown>;
+    rw_timestamp: string;
+}
+export interface ViewDiff {
+    cursor: string;
+    inserted: Record<string, unknown>[];
+    updated: Record<string, unknown>[];
+    deleted: Record<string, unknown>[];
+}
+export interface BootstrapResult {
+    snapshotRows: Record<string, unknown>[];
+    diffs: ViewDiff[];
+    lastCursor: string | null;
+}
+type DiffCallback = (queryName: string, diff: ViewDiff) => void;
+/**
+ * Manages persistent subscription cursors against RisingWave.
+ *
+ * Each query gets its own dedicated pg connection and a persistent cursor.
+ * Uses blocking FETCH (WITH timeout) so there is no polling interval -
+ * diffs are dispatched as soon as RisingWave produces them.
+ */
+export declare class CursorManager {
+    private connectionString;
+    private queries;
+    private client;
+    private queryConnections;
+    private cursorNames;
+    private subscriptions;
+    private running;
+    constructor(connectionString: string, queries: Record<string, QueryDef | SqlFragment>);
+    initialize(): Promise<void>;
+    /**
+     * Start listening for diffs on all queries.
+     * Each query runs its own async loop with blocking FETCH.
+     * No polling interval - FETCH blocks until data arrives or timeout.
+     */
+    startPolling(callback: DiffCallback): void;
+    stopPolling(): void;
+    private listenLoop;
+    parseDiffs(rows: any[]): ViewDiff;
+    parseDiffBatches(rows: any[]): ViewDiff[];
+    bootstrap(queryName: string): Promise<BootstrapResult>;
+    query(sql: string): Promise<any[]>;
+    execute(sql: string): Promise<void>;
+    close(): Promise<void>;
+    private stripSubscriptionMetadata;
+    private normalizeCursor;
+}
+export {};
+//# sourceMappingURL=cursor-manager.d.ts.map

package/dist/cursor-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-manager.d.ts","sourceRoot":"","sources":["../src/cursor-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAIhE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,QAAQ,GAAG,eAAe,GAAG,eAAe,GAAG,QAAQ,CAAA;IAC3D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IACvC,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,KAAK,YAAY,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;AAE/D;;;;;;GAMG;AACH,qBAAa,aAAa;IAWtB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,OAAO;IAVjB,OAAO,CAAC,MAAM,CAA2C;IAGzD,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,OAAO,CAAQ;gBAGb,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAGnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCjC;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAQ1C,WAAW,IAAI,IAAI;YAIL,UAAU;IA6CxB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ;IAqCjC,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE;IAyBnC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAyDtD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAMlC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,eAAe;CAKxB"}

package/dist/cursor-manager.js

@@ -0,0 +1,263 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorManager = void 0;
+const pg_1 = __importDefault(require("pg"));
+const { Client } = pg_1.default;
+/**
+ * Manages persistent subscription cursors against RisingWave.
+ *
+ * Each query gets its own dedicated pg connection and a persistent cursor.
+ * Uses blocking FETCH (WITH timeout) so there is no polling interval -
+ * diffs are dispatched as soon as RisingWave produces them.
+ */
+class CursorManager {
+    connectionString;
+    queries;
+    // Shared connection for DDL (CREATE SUBSCRIPTION) and ad-hoc queries
+    client = null;
+    // Per-query dedicated connections for blocking FETCH
+    queryConnections = new Map();
+    cursorNames = new Map();
+    subscriptions = new Map();
+    running = false;
+    constructor(connectionString, queries) {
+        this.connectionString = connectionString;
+        this.queries = queries;
+    }
+    async initialize() {
+        this.client = new Client({ connectionString: this.connectionString });
+        await this.client.connect();
+        console.log('Connected to RisingWave');
+        for (const [queryName] of Object.entries(this.queries)) {
+            const subName = `wavelet_sub_${queryName}`;
+            // Create subscription if not exists (idempotent)
+            try {
+                await this.client.query(`CREATE SUBSCRIPTION ${subName} FROM ${queryName} WITH (retention = '24h')`);
+                console.log(`Created subscription: ${subName}`);
+            }
+            catch (err) {
+                if (err.message?.includes('exists')) {
+                    console.log(`Subscription exists: ${subName}`);
+                }
+                else {
+                    throw err;
+                }
+            }
+            this.subscriptions.set(queryName, subName);
+            // Create dedicated connection and persistent cursor for this query
+            const conn = new Client({ connectionString: this.connectionString });
+            await conn.connect();
+            const cursorName = `wavelet_cur_${queryName}`;
+            await conn.query(`DECLARE ${cursorName} SUBSCRIPTION CURSOR FOR ${subName}`);
+            console.log(`Opened persistent cursor: ${cursorName}`);
+            this.queryConnections.set(queryName, conn);
+            this.cursorNames.set(queryName, cursorName);
+        }
+    }
+    /**
+     * Start listening for diffs on all queries.
+     * Each query runs its own async loop with blocking FETCH.
+     * No polling interval - FETCH blocks until data arrives or timeout.
+     */
+    startPolling(callback) {
+        this.running = true;
+        for (const [queryName] of this.subscriptions.entries()) {
+            this.listenLoop(queryName, callback);
+        }
+    }
+    stopPolling() {
+        this.running = false;
+    }
+    async listenLoop(queryName, callback) {
+        const conn = this.queryConnections.get(queryName);
+        const cursorName = this.cursorNames.get(queryName);
+        if (!conn || !cursorName)
+            return;
+        while (this.running) {
+            try {
+                // Blocking FETCH: waits up to 5s for new data, returns immediately when data arrives
+                const result = await conn.query(`FETCH NEXT FROM ${cursorName} WITH (timeout = '5s')`);
+                if (result.rows.length === 0)
+                    continue;
+                // Got at least one row. Drain any remaining rows with timeout.
+                const allRows = [...result.rows];
+                let more = true;
+                while (more) {
+                    const batch = await conn.query(`FETCH 100 FROM ${cursorName} WITH (timeout = '1s')`);
+                    if (batch.rows.length > 0) {
+                        allRows.push(...batch.rows);
+                    }
+                    else {
+                        more = false;
+                    }
+                }
+                const diffs = this.parseDiffBatches(allRows);
+                for (const diff of diffs) {
+                    if (diff.inserted.length === 0 && diff.updated.length === 0 && diff.deleted.length === 0) {
+                        continue;
+                    }
+                    callback(queryName, diff);
+                }
+            }
+            catch (err) {
+                if (!this.running)
+                    return;
+                console.error(`[cursor-manager] Error fetching ${queryName}:`, err.message);
+                // Back off on error, then retry
+                await new Promise(r => setTimeout(r, 1000));
+            }
+        }
+    }
+    parseDiffs(rows) {
+        const diff = {
+            cursor: '',
+            inserted: [],
+            updated: [],
+            deleted: [],
+        };
+        for (const row of rows) {
+            const { op, rw_timestamp, ...data } = row;
+            diff.cursor = rw_timestamp ?? diff.cursor;
+            // RisingWave returns op as a string: "Insert", "Delete", "UpdateInsert", "UpdateDelete"
+            const opStr = String(op);
+            switch (opStr) {
+                case 'Insert':
+                case '1':
+                    diff.inserted.push(data);
+                    break;
+                case 'Delete':
+                case '2':
+                    diff.deleted.push(data);
+                    break;
+                case 'UpdateDelete':
+                case '3':
+                    diff.deleted.push(data);
+                    break;
+                case 'UpdateInsert':
+                case '4':
+                    diff.updated.push(data);
+                    break;
+            }
+        }
+        return diff;
+    }
+    parseDiffBatches(rows) {
+        const diffs = [];
+        let currentRows = [];
+        let currentCursor = null;
+        for (const row of rows) {
+            const cursor = this.normalizeCursor(row.rw_timestamp);
+            if (!cursor)
+                continue;
+            if (currentCursor !== null && cursor !== currentCursor) {
+                diffs.push(this.parseDiffs(currentRows));
+                currentRows = [];
+            }
+            currentCursor = cursor;
+            currentRows.push(row);
+        }
+        if (currentRows.length > 0) {
+            diffs.push(this.parseDiffs(currentRows));
+        }
+        return diffs;
+    }
+    async bootstrap(queryName) {
+        const subName = this.subscriptions.get(queryName);
+        if (!subName) {
+            throw new Error(`Subscription for query '${queryName}' is not initialized. Start the server before accepting WebSocket clients.`);
+        }
+        const conn = new Client({ connectionString: this.connectionString });
+        await conn.connect();
+        const cursorName = `wavelet_boot_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        try {
+            await conn.query(`DECLARE ${cursorName} SUBSCRIPTION CURSOR FOR ${subName} FULL`);
+            const snapshotRows = [];
+            const incrementalRows = [];
+            let readingSnapshot = true;
+            while (readingSnapshot) {
+                const result = await conn.query(`FETCH 1000 FROM ${cursorName}`);
+                if (result.rows.length === 0)
+                    break;
+                let firstIncrementalIndex = result.rows.findIndex((row) => this.normalizeCursor(row.rw_timestamp) !== null);
+                if (firstIncrementalIndex === -1)
+                    firstIncrementalIndex = result.rows.length;
+                for (const row of result.rows.slice(0, firstIncrementalIndex)) {
+                    snapshotRows.push(this.stripSubscriptionMetadata(row));
+                }
+                if (firstIncrementalIndex < result.rows.length) {
+                    incrementalRows.push(...result.rows.slice(firstIncrementalIndex));
+                    readingSnapshot = false;
+                }
+            }
+            while (true) {
+                const result = await conn.query(`FETCH 1000 FROM ${cursorName}`);
+                if (result.rows.length === 0)
+                    break;
+                incrementalRows.push(...result.rows);
+            }
+            const diffs = this.parseDiffBatches(incrementalRows);
+            const lastCursor = diffs.length > 0 ? diffs[diffs.length - 1].cursor : null;
+            return { snapshotRows, diffs, lastCursor };
+        }
+        finally {
+            try {
+                await conn.query(`CLOSE ${cursorName}`);
+            }
+            catch { }
+            try {
+                await conn.end();
+            }
+            catch { }
+        }
+    }
+    async query(sql) {
+        if (!this.client)
+            throw new Error('Not connected');
+        const result = await this.client.query(sql);
+        return result.rows;
+    }
+    async execute(sql) {
+        if (!this.client)
+            throw new Error('Not connected');
+        await this.client.query(sql);
+    }
+    async close() {
+        this.running = false;
+        // Close per-query connections
+        for (const [queryName, conn] of this.queryConnections) {
+            const cursorName = this.cursorNames.get(queryName);
+            try {
+                if (cursorName)
+                    await conn.query(`CLOSE ${cursorName}`);
+            }
+            catch { }
+            try {
+                await conn.end();
+            }
+            catch { }
+        }
+        this.queryConnections.clear();
+        this.cursorNames.clear();
+        // Close shared connection
+        try {
+            await this.client?.end();
+        }
+        catch { }
+        this.client = null;
+    }
+    stripSubscriptionMetadata(row) {
+        const { op: _op, rw_timestamp: _rwTimestamp, ...data } = row;
+        return data;
+    }
+    normalizeCursor(value) {
+        if (value === null || value === undefined)
+            return null;
+        const cursor = String(value).trim();
+        return cursor === '' ? null : cursor;
+    }
+}
+exports.CursorManager = CursorManager;
+//# sourceMappingURL=cursor-manager.js.map

package/dist/cursor-manager.js.map

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

package/dist/ddl-manager.d.ts

@@ -0,0 +1,33 @@
+import type { WaveletConfig } from '@risingwave/wavelet';
+export interface DdlAction {
+    type: 'create' | 'update' | 'delete' | 'unchanged';
+    resource: 'event' | 'source' | 'query' | 'subscription';
+    name: string;
+    detail?: string;
+}
+export declare class DdlManager {
+    private connectionString;
+    private client;
+    constructor(connectionString: string);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Sync all events, queries, and subscriptions to match the config.
+     * Returns a list of actions taken.
+     * Idempotent - safe to call multiple times.
+     */
+    sync(config: WaveletConfig): Promise<DdlAction[]>;
+    private getExistingTables;
+    private getExistingMaterializedViews;
+    private getExistingSources;
+    private getExistingSubscriptions;
+    private tableHasDependentMVs;
+    private createTable;
+    private dropTable;
+    private createMaterializedView;
+    private dropMaterializedView;
+    private createSubscription;
+    private dropSubscription;
+    private createCdcSource;
+}
+//# sourceMappingURL=ddl-manager.d.ts.map

package/dist/ddl-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl-manager.d.ts","sourceRoot":"","sources":["../src/ddl-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAsD,MAAM,qBAAqB,CAAA;AAI5G,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAA;IAClD,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CAAA;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAkCD,qBAAa,UAAU;IAGT,OAAO,CAAC,gBAAgB;IAFpC,OAAO,CAAC,MAAM,CAA2C;gBAErC,gBAAgB,EAAE,MAAM;IAEtC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YA8IzC,iBAAiB;YAOjB,4BAA4B;YAW5B,kBAAkB;YAYlB,wBAAwB;YAOxB,oBAAoB;YAUpB,WAAW;YAcX,SAAS;YAaT,sBAAsB;YAatB,oBAAoB;YAapB,kBAAkB;YAelB,gBAAgB;YAahB,eAAe;CAmD9B"}