@uwdata/mosaic-core 0.17.0 → 0.18.0

package/dist/src/connectors/Connector.d.ts

@@ -0,0 +1,26 @@
+import type { Table } from '@uwdata/flechette';
+export interface ConnectorQueryRequest {
+    /** The query type. */
+    type?: string;
+    /** A SQL query string. */
+    sql: string;
+}
+export interface ArrowQueryRequest extends ConnectorQueryRequest {
+    /** The query type. */
+    type?: 'arrow';
+}
+export interface ExecQueryRequest extends ConnectorQueryRequest {
+    /** The query type. */
+    type: 'exec';
+}
+export interface JSONQueryRequest extends ConnectorQueryRequest {
+    /** The query type. */
+    type: 'json';
+}
+export interface Connector {
+    /** Issue a query and return the result. */
+    query(query: ArrowQueryRequest): Promise<Table>;
+    query(query: ExecQueryRequest): Promise<void>;
+    query(query: JSONQueryRequest): Promise<Record<string, unknown>[]>;
+}
+//# sourceMappingURL=Connector.d.ts.map

package/dist/src/connectors/Connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.d.ts","sourceRoot":"","sources":["../../../src/connectors/Connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,sBAAsB;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACpE"}

package/dist/src/connectors/Connector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Connector.js.map

package/dist/src/connectors/Connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.js","sourceRoot":"","sources":["../../../src/connectors/Connector.ts"],"names":[],"mappings":""}

package/dist/src/connectors/rest.d.ts

@@ -0,0 +1,24 @@
+import type { ExtractionOptions, Table } from '@uwdata/flechette';
+import type { ArrowQueryRequest, Connector, ExecQueryRequest, JSONQueryRequest } from './Connector.js';
+interface RestOptions {
+    uri?: string;
+    ipc?: ExtractionOptions;
+}
+/**
+ * Connect to a DuckDB server over an HTTP REST interface.
+ * @param options Connector options.
+ * @param options.uri The URI for the DuckDB REST server.
+ * @param options.ipc Arrow IPC extraction options.
+ * @returns A connector instance.
+ */
+export declare function restConnector(options?: RestOptions): RestConnector;
+export declare class RestConnector implements Connector {
+    private _uri;
+    private _ipc?;
+    constructor({ uri, ipc }?: RestOptions);
+    query(query: ArrowQueryRequest): Promise<Table>;
+    query(query: ExecQueryRequest): Promise<void>;
+    query(query: JSONQueryRequest): Promise<Record<string, unknown>[]>;
+}
+export {};
+//# sourceMappingURL=rest.d.ts.map

package/dist/src/connectors/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../src/connectors/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAG9H,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,iBAElD;AAED,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAC,CAAoB;gBAErB,EACV,GAA8B,EAC9B,GAAe,EAChB,GAAE,WAAgB;IAKb,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/C,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAqBzE"}

package/dist/src/connectors/rest.js

@@ -0,0 +1,37 @@
+import { decodeIPC } from '../util/decode-ipc.js';
+/**
+ * Connect to a DuckDB server over an HTTP REST interface.
+ * @param options Connector options.
+ * @param options.uri The URI for the DuckDB REST server.
+ * @param options.ipc Arrow IPC extraction options.
+ * @returns A connector instance.
+ */
+export function restConnector(options) {
+    return new RestConnector(options);
+}
+export class RestConnector {
+    _uri;
+    _ipc;
+    constructor({ uri = 'http://localhost:3000/', ipc = undefined } = {}) {
+        this._uri = uri;
+        this._ipc = ipc;
+    }
+    async query(query) {
+        const req = fetch(this._uri, {
+            method: 'POST',
+            mode: 'cors',
+            cache: 'no-cache',
+            credentials: 'omit',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(query)
+        });
+        const res = await req;
+        if (!res.ok) {
+            throw new Error(`Query failed with HTTP status ${res.status}: ${await res.text()}`);
+        }
+        return query.type === 'exec' ? req
+            : query.type === 'arrow' ? decodeIPC(await res.arrayBuffer(), this._ipc)
+                : res.json();
+    }
+}
+//# sourceMappingURL=rest.js.map

package/dist/src/connectors/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../../../src/connectors/rest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOlD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAqB;IACjD,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,OAAO,aAAa;IAChB,IAAI,CAAS;IACb,IAAI,CAAqB;IAEjC,YAAY,EACV,GAAG,GAAG,wBAAwB,EAC9B,GAAG,GAAG,SAAS,KACA,EAAE;QACjB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAKD,KAAK,CAAC,KAAK,CAAC,KAA4B;QACtC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC;QAEtB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG;YAChC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;gBACxE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;CACF"}

package/dist/src/connectors/socket.d.ts

@@ -0,0 +1,40 @@
+import type { ExtractionOptions, Table } from '@uwdata/flechette';
+import type { ArrowQueryRequest, Connector, ExecQueryRequest, JSONQueryRequest, ConnectorQueryRequest } from './Connector.js';
+interface SocketOptions {
+    uri?: string;
+    ipc?: ExtractionOptions;
+}
+/**
+ * Connect to a DuckDB server over a WebSocket interface.
+ * @param options Connector options.
+ * @param options.uri The URI for the DuckDB REST server.
+ * @param options.ipc Arrow IPC extraction options.
+ * @returns A connector instance.
+ */
+export declare function socketConnector(options?: SocketOptions): SocketConnector;
+/**
+ * DuckDB socket connector.
+ */
+export declare class SocketConnector implements Connector {
+    private _uri;
+    private _queue;
+    private _connected;
+    private _request;
+    private _ws;
+    private _events;
+    /**
+     * @param options Connector options.
+     * @param options.uri The URI for the DuckDB REST server.
+     * @param options.ipc Arrow IPC extraction options.
+     */
+    constructor({ uri, ipc, }?: SocketOptions);
+    get connected(): boolean;
+    init(): void;
+    enqueue(query: ConnectorQueryRequest, resolve: (value?: unknown) => void, reject: (reason?: unknown) => void): void;
+    next(): void;
+    query(query: ArrowQueryRequest): Promise<Table>;
+    query(query: ExecQueryRequest): Promise<void>;
+    query(query: JSONQueryRequest): Promise<Record<string, unknown>[]>;
+}
+export {};
+//# sourceMappingURL=socket.d.ts.map

package/dist/src/connectors/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/connectors/socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG9H,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAQD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,aAAa,mBAEtD;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,OAAO,CAA4C;IAE3D;;;;OAIG;gBACS,EACV,GAA4B,EAC5B,GAAe,GAChB,GAAE,aAAkB;IA+DrB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,IAAI,IAAI;IAQZ,OAAO,CACL,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,EAClC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,GACjC,IAAI;IAMP,IAAI,IAAI,IAAI;IAOZ,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/C,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAMnE"}

package/dist/src/connectors/socket.js

@@ -0,0 +1,115 @@
+import { decodeIPC } from '../util/decode-ipc.js';
+/**
+ * Connect to a DuckDB server over a WebSocket interface.
+ * @param options Connector options.
+ * @param options.uri The URI for the DuckDB REST server.
+ * @param options.ipc Arrow IPC extraction options.
+ * @returns A connector instance.
+ */
+export function socketConnector(options) {
+    return new SocketConnector(options);
+}
+/**
+ * DuckDB socket connector.
+ */
+export class SocketConnector {
+    _uri;
+    _queue;
+    _connected;
+    _request;
+    _ws;
+    _events;
+    /**
+     * @param options Connector options.
+     * @param options.uri The URI for the DuckDB REST server.
+     * @param options.ipc Arrow IPC extraction options.
+     */
+    constructor({ uri = 'ws://localhost:3000/', ipc = undefined, } = {}) {
+        this._uri = uri;
+        this._queue = [];
+        this._connected = false;
+        this._request = null;
+        this._ws = null;
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const c = this;
+        this._events = {
+            open() {
+                c._connected = true;
+                c.next();
+            },
+            close() {
+                c._connected = false;
+                c._request = null;
+                c._ws = null;
+                while (c._queue.length) {
+                    c._queue.shift().reject('Socket closed');
+                }
+            },
+            error(event) {
+                if (c._request) {
+                    const { reject } = c._request;
+                    c._request = null;
+                    c.next();
+                    reject(event);
+                }
+                else {
+                    console.error('WebSocket error: ', event);
+                }
+            },
+            message(msg) {
+                const { data } = msg;
+                if (c._request) {
+                    const { query, resolve, reject } = c._request;
+                    // clear state, start next request
+                    c._request = null;
+                    c.next();
+                    // process result
+                    if (typeof data === 'string') {
+                        const json = JSON.parse(data);
+                        // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+                        json.error ? reject(json.error) : resolve(json);
+                    }
+                    else if (query.type === 'exec') {
+                        resolve();
+                    }
+                    else if (query.type === 'arrow') {
+                        resolve(decodeIPC(data, ipc));
+                    }
+                    else {
+                        throw new Error(`Unexpected socket data: ${data}`);
+                    }
+                }
+                else {
+                    console.log('WebSocket message: ', data);
+                }
+            }
+        };
+    }
+    get connected() {
+        return this._connected;
+    }
+    init() {
+        this._ws = new WebSocket(this._uri);
+        this._ws.binaryType = 'arraybuffer';
+        for (const type in this._events) {
+            this._ws.addEventListener(type, this._events[type]);
+        }
+    }
+    enqueue(query, resolve, reject) {
+        if (this._ws == null)
+            this.init();
+        this._queue.push({ query, resolve, reject });
+        if (this._connected && !this._request)
+            this.next();
+    }
+    next() {
+        if (this._queue.length) {
+            this._request = this._queue.shift();
+            this._ws.send(JSON.stringify(this._request.query));
+        }
+    }
+    query(query) {
+        return new Promise((resolve, reject) => this.enqueue(query, resolve, reject));
+    }
+}
+//# sourceMappingURL=socket.js.map

package/dist/src/connectors/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../src/connectors/socket.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAalD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAuB;IACrD,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,IAAI,CAAS;IACb,MAAM,CAAc;IACpB,UAAU,CAAU;IACpB,QAAQ,CAAmB;IAC3B,GAAG,CAAmB;IACtB,OAAO,CAA4C;IAE3D;;;;OAIG;IACH,YAAY,EACV,GAAG,GAAG,sBAAsB,EAC5B,GAAG,GAAG,SAAS,MACE,EAAE;QACnB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAEhB,4DAA4D;QAC5D,MAAM,CAAC,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,OAAO,GAAG;YACb,IAAI;gBACF,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;gBACpB,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,CAAC;YAED,KAAK;gBACH,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC;gBACrB,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;gBACb,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACvB,CAAC,CAAC,MAAM,CAAC,KAAK,EAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,KAAK,CAAC,KAAc;gBAClB,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;oBAC9B,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC,CAAC,IAAI,EAAE,CAAC;oBACT,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAY;gBAClB,MAAM,EAAE,IAAI,EAAE,GAAG,GAAwB,CAAC;gBAC1C,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;oBAE9C,kCAAkC;oBAClC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC,CAAC,IAAI,EAAE,CAAC;oBAET,iBAAiB;oBACjB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC9B,oEAAoE;wBACpE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAClD,CAAC;yBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBACjC,OAAO,EAAE,CAAC;oBACZ,CAAC;yBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBAClC,OAAO,CAAC,SAAS,CAAC,IAAkB,EAAE,GAAG,CAAC,CAAC,CAAC;oBAC9C,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,aAAa,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,CACL,KAA4B,EAC5B,OAAkC,EAClC,MAAkC;QAElC,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAG,CAAC;YACrC,IAAI,CAAC,GAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAKD,KAAK,CAAC,KAA4B;QAChC,OAAO,IAAI,OAAO,CAChB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAC1D,CAAC;IACJ,CAAC;CACF"}

package/dist/src/connectors/wasm.d.ts

@@ -0,0 +1,53 @@
+import type { ExtractionOptions, Table } from '@uwdata/flechette';
+import type { ArrowQueryRequest, Connector, ExecQueryRequest, JSONQueryRequest } from './Connector.js';
+import * as duckdb from '@duckdb/duckdb-wasm';
+interface DuckDBWASMOptions {
+    /** Flag to enable logging. */
+    log?: boolean;
+}
+interface DuckDBWASMConnectorOptions extends DuckDBWASMOptions {
+    /** Arrow IPC extraction options. */
+    ipc?: ExtractionOptions;
+    /** Optional pre-existing DuckDB-WASM instance. */
+    duckdb?: duckdb.AsyncDuckDB;
+    /** Optional pre-existing DuckDB-WASM connection. */
+    connection?: duckdb.AsyncDuckDBConnection;
+}
+/**
+ * Connect to a DuckDB-WASM instance.
+ * @param options Connector options.
+ * @returns A connector instance.
+ */
+export declare function wasmConnector(options?: DuckDBWASMConnectorOptions): DuckDBWASMConnector;
+/**
+ * DuckDB-WASM connector.
+ */
+export declare class DuckDBWASMConnector implements Connector {
+    private _ipc?;
+    _options: DuckDBWASMOptions;
+    _db?: duckdb.AsyncDuckDB;
+    _con?: duckdb.AsyncDuckDBConnection;
+    _loadPromise?: Promise<unknown>;
+    /**
+     * Create a new DuckDB-WASM connector instance.
+     * @param options Connector options.
+     */
+    constructor(options?: DuckDBWASMConnectorOptions);
+    /**
+     * Get the backing DuckDB-WASM instance.
+     * Lazily initializes DuckDB-WASM if not already loaded.
+     * @returns The DuckDB-WASM instance.
+     */
+    getDuckDB(): Promise<duckdb.AsyncDuckDB>;
+    /**
+     * Get the backing DuckDB-WASM connection.
+     * Lazily initializes DuckDB-WASM if not already loaded.
+     * @returns The DuckDB-WASM connection.
+     */
+    getConnection(): Promise<duckdb.AsyncDuckDBConnection>;
+    query(query: ArrowQueryRequest): Promise<Table>;
+    query(query: ExecQueryRequest): Promise<void>;
+    query(query: JSONQueryRequest): Promise<Record<string, unknown>[]>;
+}
+export {};
+//# sourceMappingURL=wasm.d.ts.map

package/dist/src/connectors/wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../../../src/connectors/wasm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAC9H,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAG9C,UAAU,iBAAiB;IACzB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,UAAU,0BAA2B,SAAQ,iBAAiB;IAC5D,oCAAoC;IACpC,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC,qBAAqB,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,0BAA+B,GAAG,mBAAmB,CAE3F;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,IAAI,CAAC,CAAoB;IAC1B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,qBAAqB,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;;OAGG;gBACS,OAAO,GAAE,0BAA+B;IAQpD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IAK9C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC;IAKtD,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/C,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CASzE"}

package/dist/src/connectors/wasm.js

@@ -0,0 +1,113 @@
+import * as duckdb from '@duckdb/duckdb-wasm';
+import { decodeIPC } from '../util/decode-ipc.js';
+/**
+ * Connect to a DuckDB-WASM instance.
+ * @param options Connector options.
+ * @returns A connector instance.
+ */
+export function wasmConnector(options = {}) {
+    return new DuckDBWASMConnector(options);
+}
+/**
+ * DuckDB-WASM connector.
+ */
+export class DuckDBWASMConnector {
+    _ipc;
+    _options;
+    _db;
+    _con;
+    _loadPromise;
+    /**
+     * Create a new DuckDB-WASM connector instance.
+     * @param options Connector options.
+     */
+    constructor(options = {}) {
+        const { ipc, duckdb, connection, ...opts } = options;
+        this._ipc = ipc;
+        this._options = opts;
+        this._db = duckdb;
+        this._con = connection;
+    }
+    /**
+     * Get the backing DuckDB-WASM instance.
+     * Lazily initializes DuckDB-WASM if not already loaded.
+     * @returns The DuckDB-WASM instance.
+     */
+    async getDuckDB() {
+        if (!this._db)
+            await connect(this);
+        return this._db;
+    }
+    /**
+     * Get the backing DuckDB-WASM connection.
+     * Lazily initializes DuckDB-WASM if not already loaded.
+     * @returns The DuckDB-WASM connection.
+     */
+    async getConnection() {
+        if (!this._con)
+            await connect(this);
+        return this._con;
+    }
+    async query(query) {
+        const { type, sql } = query;
+        const con = await this.getConnection();
+        const result = await getArrowIPC(con, sql);
+        return type === 'exec' ? undefined
+            : type === 'arrow' ? decodeIPC(result, this._ipc)
+                : decodeIPC(result).toArray();
+    }
+}
+/**
+ * Bypass duckdb-wasm query method to get Arrow IPC bytes directly.
+ * https://github.com/duckdb/duckdb-wasm/issues/267#issuecomment-2252749509
+ * @param con The DuckDB-WASM connection.
+ * @param query The SQL query to run.
+ */
+function getArrowIPC(con, query) {
+    return new Promise((resolve, reject) => {
+        con.useUnsafe(async (bindings, conn) => {
+            try {
+                const buffer = await bindings.runQuery(conn, query);
+                resolve(buffer);
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    });
+}
+/**
+ * Establish a new database connection for the given connector.
+ * @param c The connector.
+ * @returns Connection promise.
+ */
+function connect(c) {
+    if (!c._loadPromise) {
+        // use a loading promise to avoid race conditions
+        // synchronizes multiple callees on the same load
+        c._loadPromise = (c._db
+            ? Promise.resolve(c._db)
+            : initDatabase(c._options).then(result => c._db = result))
+            .then(db => db.connect())
+            .then(result => c._con = result);
+    }
+    return c._loadPromise;
+}
+/**
+ * Initialize a new DuckDB-WASM instance.
+ * @param options Database initialization options.
+ */
+async function initDatabase({ log = false } = {}) {
+    const JSDELIVR_BUNDLES = duckdb.getJsDelivrBundles();
+    // Select a bundle based on browser checks
+    const bundle = await duckdb.selectBundle(JSDELIVR_BUNDLES);
+    const worker_url = URL.createObjectURL(new Blob([`importScripts("${bundle.mainWorker}");`], { type: 'text/javascript' }));
+    // Instantiate the asynchronus version of DuckDB-wasm
+    const worker = new Worker(worker_url);
+    const logger = log ? new duckdb.ConsoleLogger() : new duckdb.VoidLogger();
+    const db = new duckdb.AsyncDuckDB(logger, worker);
+    await db.instantiate(bundle.mainModule, bundle.pthreadWorker);
+    URL.revokeObjectURL(worker_url);
+    return db;
+}
+//# sourceMappingURL=wasm.js.map

package/dist/src/connectors/wasm.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,28 @@
+export { MosaicClient } from './MosaicClient.js';
+export { makeClient } from './make-client.js';
+export { Coordinator, coordinator } from './Coordinator.js';
+export { Selection, isSelection } from './Selection.js';
+export { Param, isParam } from './Param.js';
+export { Priority } from './QueryManager.js';
+export { restConnector } from './connectors/rest.js';
+export { socketConnector } from './connectors/socket.js';
+export { wasmConnector } from './connectors/wasm.js';
+export { RestConnector } from './connectors/rest.js';
+export { SocketConnector } from './connectors/socket.js';
+export { DuckDBWASMConnector } from './connectors/wasm.js';
+export { clauseInterval, clauseIntervals, clausePoint, clausePoints, clauseMatch } from './SelectionClause.js';
+export { decodeIPC } from './util/decode-ipc.js';
+export { distinct } from './util/distinct.js';
+export { isArrowTable } from './util/is-arrow-table.js';
+export { Synchronizer } from './util/synchronizer.js';
+export { throttle } from './util/throttle.js';
+export { toDataColumns } from './util/to-data-columns.js';
+export { queryFieldInfo } from './util/field-info.js';
+export { jsType } from './util/js-type.js';
+export { isActivatable } from './util/is-activatable.js';
+export type { QueryResult } from './util/query-result.js';
+export * from './types.js';
+export type * from './connectors/Connector.js';
+export type * from './Selection.js';
+export type * from './SelectionClause.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,cAAc,YAAY,CAAC;AAE3B,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,sBAAsB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,25 @@
+export { MosaicClient } from './MosaicClient.js';
+export { makeClient } from './make-client.js';
+export { Coordinator, coordinator } from './Coordinator.js';
+export { Selection, isSelection } from './Selection.js';
+export { Param, isParam } from './Param.js';
+export { Priority } from './QueryManager.js';
+// deprecated in favor of constructors
+export { restConnector } from './connectors/rest.js';
+export { socketConnector } from './connectors/socket.js';
+export { wasmConnector } from './connectors/wasm.js';
+export { RestConnector } from './connectors/rest.js';
+export { SocketConnector } from './connectors/socket.js';
+export { DuckDBWASMConnector } from './connectors/wasm.js';
+export { clauseInterval, clauseIntervals, clausePoint, clausePoints, clauseMatch } from './SelectionClause.js';
+export { decodeIPC } from './util/decode-ipc.js';
+export { distinct } from './util/distinct.js';
+export { isArrowTable } from './util/is-arrow-table.js';
+export { Synchronizer } from './util/synchronizer.js';
+export { throttle } from './util/throttle.js';
+export { toDataColumns } from './util/to-data-columns.js';
+export { queryFieldInfo } from './util/field-info.js';
+export { jsType } from './util/js-type.js';
+export { isActivatable } from './util/is-activatable.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,cAAc,YAAY,CAAC"}

package/dist/src/make-client.d.ts

@@ -0,0 +1,35 @@
+import type { Coordinator } from './Coordinator.js';
+import type { Selection } from './Selection.js';
+import type { FilterExpr } from '@uwdata/mosaic-sql';
+import { type ClientQuery, MosaicClient } from './MosaicClient.js';
+export interface MakeClientOptions {
+    /** Mosaic coordinator. Defaults to the global coordinator. */
+    coordinator?: Coordinator;
+    /** A selection whose predicates are fed into the query function to produce the SQL query. */
+    selection?: Selection;
+    /** A flag (default `true`) indicating if the client should initially be enabled or not. */
+    enabled?: boolean;
+    /** A flag (default `true`) indicating if client queries can be sped up using pre-aggregated data.
+     * Should be set to `false` if filtering changes the groupby domain of the query. */
+    filterStable?: boolean;
+    /** An async function to prepare the client before running queries. */
+    prepare?: () => Promise<void>;
+    /** A function that returns a query from a list of selection predicates. */
+    query?: (filter: FilterExpr) => ClientQuery;
+    /** Called by the coordinator to return a query result. */
+    queryResult?: (data: unknown) => void;
+    /** Called by the coordinator to inform the client that a query is pending. */
+    queryPending?: () => void;
+    /** Called by the coordinator to report a query execution error. */
+    queryError?: (error: Error) => void;
+}
+/**
+ * Make a new client with the given options, and connect the client to the
+ * provided coordinator.
+ * @param options The options for making the client.
+ * @returns The resulting client, along with a method to destroy the client when no longer needed.
+ */
+export declare function makeClient(options: MakeClientOptions): MosaicClient & {
+    destroy: () => void;
+};
+//# sourceMappingURL=make-client.d.ts.map

package/dist/src/make-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-client.d.ts","sourceRoot":"","sources":["../../src/make-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnE,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;wFACoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,WAAW,CAAC;IAC5C,0DAA0D;IAC1D,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAQ7F"}

package/dist/src/make-client.js

@@ -0,0 +1,52 @@
+import { MosaicClient } from './MosaicClient.js';
+import { coordinator as defaultCoordinator } from './Coordinator.js';
+/**
+ * Make a new client with the given options, and connect the client to the
+ * provided coordinator.
+ * @param options The options for making the client.
+ * @returns The resulting client, along with a method to destroy the client when no longer needed.
+ */
+export function makeClient(options) {
+    const { coordinator = defaultCoordinator(), ...clientOptions } = options;
+    const client = new ProxyClient(clientOptions);
+    coordinator.connect(client);
+    return client;
+}
+/**
+ * An internal class used to implement the makeClient API.
+ */
+class ProxyClient extends MosaicClient {
+    _methods;
+    _filterStable;
+    /**
+     * @param options The options for making the client.
+     */
+    constructor({ selection = undefined, enabled = true, filterStable = true, ...methods }) {
+        super(selection);
+        this.enabled = enabled;
+        this._methods = methods;
+        this._filterStable = filterStable;
+    }
+    get filterStable() {
+        return this._filterStable;
+    }
+    async prepare() {
+        await this._methods.prepare?.();
+    }
+    query(filter) {
+        return this._methods.query?.(filter) ?? null;
+    }
+    queryResult(data) {
+        this._methods.queryResult?.(data);
+        return this;
+    }
+    queryPending() {
+        this._methods.queryPending?.();
+        return this;
+    }
+    queryError(error) {
+        this._methods.queryError?.(error);
+        return this;
+    }
+}
+//# sourceMappingURL=make-client.js.map

package/dist/src/make-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-client.js","sourceRoot":"","sources":["../../src/make-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,WAAW,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAwBrE;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,MAAM,EACJ,WAAW,GAAG,kBAAkB,EAAE,EAClC,GAAG,aAAa,EACjB,GAAG,OAAO,CAAC;IACZ,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;IAC9C,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,WAAY,SAAQ,YAAY;IACnB,QAAQ,CAAoF;IAC5F,aAAa,CAAU;IAExC;;OAEG;IACH,YAAY,EACV,SAAS,GAAG,SAAS,EACrB,OAAO,GAAG,IAAI,EACd,YAAY,GAAG,IAAI,EACnB,GAAG,OAAO,EAC6B;QACvC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,MAAkB;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED,WAAW,CAAC,IAAa;QACvB,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY;QACV,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,KAAY;QACrB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}