@uwdata/mosaic-core 0.17.0 → 0.19.0

package/dist/src/SelectionClause.js

@@ -0,0 +1,168 @@
+import { isMosaicClient } from './MosaicClient.js';
+import { and, contains, isBetween, isIn, isNotDistinct, literal, or, prefix, regexp_matches, suffix, listHasAny, listHasAll, lower } from '@uwdata/mosaic-sql';
+/**
+ * Generate a selection clause for a single selected point value.
+ * @param field The table column or expression to select.
+ * @param value The selected value.
+ * @param options Additional clause properties.
+ * @param options.source The source component generating this clause.
+ * @param options.clients The Mosaic clients associated
+ *  with this clause. These clients are not filtered by this clause in
+ *  cross-filtering contexts.
+ * @returns The generated selection clause.
+ */
+export function clausePoint(field, value, { source, clients = isMosaicClient(source) ? new Set([source]) : undefined }) {
+    const predicate = value !== undefined
+        ? isIn(field, [literal(value)])
+        : null;
+    return {
+        meta: { type: 'point' },
+        source,
+        clients,
+        value,
+        predicate
+    };
+}
+/**
+ * Generate a selection clause for multiple selected point values.
+ * @param fields The table columns or expressions to select.
+ * @param value The selected values, as an array of
+ *  arrays. Each subarray contains values for each *fields* entry.
+ * @param options Additional clause properties.
+ * @param options.source The source component generating this clause.
+ * @param options.clients The Mosaic clients associated
+ *  with this clause. These clients are not filtered by this clause in
+ *  cross-filtering contexts.
+ * @returns The generated selection clause.
+ */
+export function clausePoints(fields, value, { source, clients = isMosaicClient(source) ? new Set([source]) : undefined }) {
+    let predicate = null;
+    if (value?.length) {
+        const clauses = value.length && fields.length === 1
+            ? [isIn(fields[0], value.map(v => literal(v[0])))]
+            : value.map(v => and(v.map((_, i) => isNotDistinct(fields[i], literal(_)))));
+        predicate = value.length === 0 ? literal(false)
+            : clauses.length > 1 ? or(clauses)
+                : clauses[0];
+    }
+    return {
+        meta: { type: 'point' },
+        source,
+        clients,
+        value,
+        predicate
+    };
+}
+/**
+ * Generate a selection clause for a selected 1D interval.
+ * @param field The table column or expression to select.
+ * @param value The selected interval as a [lo, hi] array.
+ * @param options Additional clause properties.
+ * @param options.source The source component generating this clause.
+ * @param options.clients The Mosaic clients associated
+ *  with this clause. These clients are not filtered by this clause in
+ *  cross-filtering contexts.
+ * @param options.scale The scale mapping descriptor.
+ * @param options.bin A binning method hint.
+ * @param options.pixelSize The interactive pixel size.
+ * @returns The generated selection clause.
+ */
+export function clauseInterval(field, value, { source, clients = isMosaicClient(source) ? new Set([source]) : undefined, bin, scale, pixelSize = 1 }) {
+    const predicate = value != null ? isBetween(field, value) : null;
+    const meta = {
+        type: 'interval',
+        scales: scale && [scale],
+        bin,
+        pixelSize
+    };
+    return { meta, source, clients, value, predicate };
+}
+/**
+ * Generate a selection clause for multiple selected intervals.
+ * @param fields The table columns or expressions to select.
+ * @param value The selected intervals, as an array of extents.
+ * @param options Additional clause properties.
+ * @param options.source The source component generating this clause.
+ * @param options.clients The Mosaic clients associated
+ *  with this clause. These clients are not filtered by this clause in
+ *  cross-filtering contexts.
+ * @param options.scales The scale mapping descriptors,
+ *  in an order matching the given *fields* and *value* extents.
+ * @param options.bin A binning method hint.
+ * @param options.pixelSize The interactive pixel size.
+ * @returns The generated selection clause.
+ */
+export function clauseIntervals(fields, value, { source, clients = isMosaicClient(source) ? new Set([source]) : undefined, bin, scales = [], pixelSize = 1 }) {
+    const predicate = value != null
+        ? and(fields.map((f, i) => isBetween(f, value[i])))
+        : null;
+    const meta = {
+        type: 'interval',
+        scales,
+        bin,
+        pixelSize
+    };
+    return { meta, source, clients, value, predicate };
+}
+const identity = (x) => x;
+const MATCH_METHODS = { contains, prefix, suffix, regexp: regexp_matches };
+/**
+ * Generate a selection clause for text search matching over a single column.
+ * @param field The table column or expression to match.
+ * @param value The selected text search query string.
+ * @param options Additional clause properties.
+ * @param options.source The source component generating this clause.
+ * @param options.clients Mosaic clients associated with this clause.
+ *  These clients are not filtered by this clause in cross-filtering contexts.
+ * @param options.method The text matching method to use, default `'contains'`.
+ * @param options.caseSensitive Flag for case sensitive matching, default `false`.
+ * @returns The generated selection clause.
+ */
+export function clauseMatch(field, value, { source, clients = undefined, method = 'contains', caseSensitive = false }) {
+    const fn = MATCH_METHODS[method];
+    const transform = caseSensitive ? identity : lower;
+    const predicate = value ? fn(transform(field), transform(literal(value))) : null;
+    const meta = { type: 'match', method };
+    return { meta, source, clients, value, predicate };
+}
+/**
+ * Generate a selection clause for text search matching over multiple columns.
+ * A match will succeed if any field successfully matches.
+ * @param fields The table columns or expressions to match.
+ * @param value The selected text search query string.
+ * @param options Additional clause properties.
+ * @param options.source The source component generating this clause.
+ * @param options.clients Mosaic clients associated with this clause.
+ *  These clients are not filtered by this clause in cross-filtering contexts.
+ * @param options.method The text matching method to use, default `'contains'`.
+ * @param options.caseSensitive Flag for case sensitive matching, default `false`.
+ * @returns The generated selection clause.
+ */
+export function clauseMatchAny(fields, value, { source, clients = undefined, method = 'contains', caseSensitive = false }) {
+    value = value || null;
+    const fn = MATCH_METHODS[method];
+    const transform = caseSensitive ? identity : lower;
+    const query = transform(literal(value));
+    const predicate = value
+        ? or(fields.flatMap(field => value ? fn(transform(field), query) : []))
+        : null;
+    const meta = { type: 'match', method };
+    return { meta, source, clients, value, predicate };
+}
+/**
+ * Generate a selection clause for a single selected point value in a list.
+ * @param field The table column or expression to select, which must be a list.
+ * @param value The selected value.
+ * @param options Additional clause properties.
+ * @param options.source The source component generating this clause.
+ * @param options.clients The Mosaic clients associated
+ *  with this clause. These clients are not filtered by this clause in
+ *  cross-filtering contexts.
+ * @returns The generated selection clause.
+ */
+export function clauseList(field, value, { source, clients = isMosaicClient(source) ? new Set([source]) : undefined, listMatch = 'any' }) {
+    const listFn = listMatch === 'all' ? listHasAll : listHasAny;
+    const predicate = value !== undefined ? listFn(field, literal(value)) : null;
+    return { source, clients, value, predicate };
+}
+//# sourceMappingURL=SelectionClause.js.map

package/dist/src/SelectionClause.js.map

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

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":"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"}

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

@@ -0,0 +1,56 @@
+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;
+    /** Optional database config. */
+    config?: duckdb.DuckDBConfig;
+}
+/**
+ * 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;
+    _config?: duckdb.DuckDBConfig;
+    _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;IAC1C,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;CAC9B;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,OAAO,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;;OAGG;gBACS,OAAO,GAAE,0BAA+B;IASpD;;;;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,116 @@
+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;
+    _config;
+    _loadPromise;
+    /**
+     * Create a new DuckDB-WASM connector instance.
+     * @param options Connector options.
+     */
+    constructor(options = {}) {
+        const { ipc, duckdb, connection, config, ...opts } = options;
+        this._ipc = ipc;
+        this._options = opts;
+        this._db = duckdb;
+        this._con = connection;
+        this._config = config;
+    }
+    /**
+     * 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 => c._config != undefined ? db.open(c._config).then(() => db) : db)
+            .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 asynchronous 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":"AAEA,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAkBlD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAAsC,EAAE;IACpE,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACtB,IAAI,CAAqB;IAC1B,QAAQ,CAAoB;IAC5B,GAAG,CAAsB;IACzB,IAAI,CAAgC;IACpC,OAAO,CAAuB;IAC9B,YAAY,CAAoB;IAEvC;;;OAGG;IACH,YAAY,UAAsC,EAAE;QAClD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,GAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,IAAK,CAAC;IACpB,CAAC;IAKD,KAAK,CAAC,KAAK,CAAC,KAA4B;QACtC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS;YAChC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;gBACjD,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;CACF;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,GAAiC,EAAE,KAAa;IACnE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACpD,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,CAAsB;IACrC,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QACpB,iDAAiD;QACjD,iDAAiD;QACjD,CAAC,CAAC,YAAY,GAAG,CACf,CAAC,CAAC,GAAG;YACH,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACxB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;aAC3D,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;aACxB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,CAAC,YAAY,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,YAAY,CAAC,EAC1B,GAAG,GAAG,KAAK,KACU,EAAE;IACvB,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAErD,0CAA0C;IAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAE3D,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,CACpC,IAAI,IAAI,CAAC,CAAC,kBAAkB,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,EAAC,IAAI,EAAE,iBAAiB,EAAC,CAAC,CAChF,CAAC;IAEF,sDAAsD;IACtD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1E,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9D,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAEhC,OAAO,EAAE,CAAC;AACZ,CAAC"}