@visactor/vquery 0.2.2 → 0.2.5

package/dist/esm/types/DataSource.d.ts

@@ -0,0 +1,11 @@
+export type TidyDatum = Record<string, number | string | null | boolean | undefined>;
+export type DatasetSourceType = 'csv' | 'json' | 'xlsx' | 'parquet';
+export type DatasetSourceValue = string | ArrayBuffer | Blob | TidyDatum[];
+export interface DatasetSource {
+    type: DatasetSourceType;
+    blob: Blob;
+}
+export interface RawDatasetSource {
+    type: DatasetSourceType;
+    rawDataset: DatasetSourceValue;
+}

package/dist/esm/types/QueryResult.d.ts

@@ -0,0 +1 @@
+export type QueryResult = any;

package/dist/esm/types/adapters/QueryAdapter.d.ts

@@ -0,0 +1,11 @@
+import { QueryResult } from '../QueryResult';
+export interface QueryAdapter {
+    open: () => Promise<void>;
+    close: () => Promise<void>;
+    writeFile: <T extends Blob>(fileName: string, source: T) => Promise<void>;
+    getSchema: (fileName: string) => Promise<QueryResult>;
+    query: (sql: string) => Promise<{
+        dataset: any[];
+        table: any;
+    }>;
+}

package/dist/esm/types/adapters/StorageAdapter.d.ts

@@ -0,0 +1,17 @@
+import { DatasetSchema } from '../DataSet';
+import { DatasetSource } from '../DataSource';
+export interface StorageAdapter {
+    open: () => Promise<void>;
+    close: () => Promise<void>;
+    writeDataset: (datasetId: string, datasetSchema: DatasetSchema, datasetSource?: DatasetSource) => Promise<void>;
+    readDataset: (datasetId: string) => Promise<{
+        datasetSchema: DatasetSchema;
+        datasetSource?: DatasetSource;
+    } | null>;
+    deleteDataset: (datasetId: string) => Promise<void>;
+    listDatasets: () => Promise<{
+        datasetId: string;
+        datasetSchema: DatasetSchema;
+        datasetSource?: DatasetSource;
+    }[]>;
+}

package/dist/esm/types/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export * from './QueryAdapter';
+export * from './StorageAdapter';

package/dist/esm/types/dsl/GroupBy.d.ts

@@ -0,0 +1 @@
+export type GroupBy<T> = Array<keyof T>;

package/dist/esm/types/dsl/OrderBy.d.ts

@@ -0,0 +1,4 @@
+export type OrderBy<T> = Array<{
+    field: string | keyof T;
+    order?: 'asc' | 'desc';
+}>;

package/dist/esm/types/dsl/QueryDSL.d.ts

@@ -0,0 +1,12 @@
+import { GroupBy } from './GroupBy';
+import { OrderBy } from './OrderBy';
+import { Select } from './Select';
+import { Where } from './Where';
+export interface QueryDSL<Table> {
+    select: Select<Table>;
+    where?: Where<Table>;
+    groupBy?: GroupBy<Table>;
+    orderBy?: OrderBy<Table>;
+    limit?: number;
+}
+export type VQueryDSL<Table = Record<string, unknown>> = QueryDSL<Table>;

package/dist/esm/types/dsl/Select.d.ts

@@ -0,0 +1,7 @@
+export type AggregateFunction = 'count' | 'sum' | 'avg' | 'min' | 'max' | 'quantile';
+export type SelectItem<T> = {
+    field: keyof T;
+    alias?: string;
+    func?: AggregateFunction;
+};
+export type Select<T> = Array<keyof T | SelectItem<T>>;

package/dist/esm/types/dsl/Where.d.ts

@@ -0,0 +1,24 @@
+export type Where<T> = WhereGroup<T>;
+export type WhereGroup<T> = {
+    op: 'and' | 'or';
+    conditions: Array<WhereClause<T>>;
+};
+export type WhereClause<T> = WhereLeaf<T> | WhereGroup<T>;
+export type WhereLeaf<T> = {
+    [K in keyof T]: {
+        [O in Operator]: {
+            field: K;
+            op: O;
+        } & (O extends 'is null' | 'is not null' ? {
+            value?: never;
+        } : O extends 'in' | 'not in' ? {
+            value: T[K] | T[K][];
+        } : O extends 'between' | 'not between' ? {
+            value: [T[K], T[K]];
+        } : {
+            value: T[K];
+        });
+    }[Operator];
+}[keyof T];
+type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'like' | 'not like' | 'ilike' | 'not ilike' | 'in' | 'not in' | 'between' | 'not between' | 'is null' | 'is not null';
+export {};

package/dist/esm/types/dsl/demo.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/dsl/index.d.ts

@@ -0,0 +1,5 @@
+export type { QueryDSL, VQueryDSL } from './QueryDSL';
+export type { GroupBy } from './GroupBy';
+export type { OrderBy } from './OrderBy';
+export type { Select } from './Select';
+export type { Where, WhereClause, WhereLeaf, WhereGroup } from './Where';

package/dist/esm/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './DataSet';
+export * from './DataSource';
+export * from './QueryResult';
+export * from './dsl';
+export * from './adapters';

package/dist/esm/utils/index.d.ts

@@ -0,0 +1 @@
+export { isUrl, isHttpUrl, isBase64Url } from './url';

package/dist/esm/utils/url.d.ts

@@ -0,0 +1,3 @@
+export declare const isUrl: (url: string) => boolean;
+export declare const isHttpUrl: (url: string) => boolean;
+export declare const isBase64Url: (url: string) => boolean;

package/dist/esm/vquery-browser.d.ts

@@ -0,0 +1,21 @@
+import { Dataset } from './dataset/dataset';
+import { RawDatasetSource, DatasetColumn } from './types';
+export declare class VQuery {
+    private queryAdapter;
+    private storageAdapter;
+    private isInitialized;
+    constructor();
+    private checkInitialized;
+    private checkDatasetExists;
+    createDataset(datasetId: string, columns?: DatasetColumn[], rawDatasetSource?: RawDatasetSource): Promise<void>;
+    updateDatasetSource(datasetId: string, columns?: DatasetColumn[], rawDatasetSource?: RawDatasetSource): Promise<void>;
+    dropDataset(datasetId: string): Promise<void>;
+    connectDataset(datasetId: string, temporaryColumns?: DatasetColumn[], temporaryRawDatasetSource?: RawDatasetSource): Promise<Dataset>;
+    hasDataset(datasetId: string): Promise<boolean>;
+    listDatasets(): Promise<{
+        datasetId: string;
+        datasetSchema: import("./types").DatasetSchema;
+        datasetSource?: import("./types").DatasetSource;
+    }[]>;
+    close(): Promise<void>;
+}

package/dist/esm/vquery-node.d.ts

@@ -0,0 +1,21 @@
+import { Dataset } from './dataset/dataset';
+import { RawDatasetSource, DatasetColumn } from './types';
+export declare class VQuery {
+    private queryAdapter;
+    private storageAdapter;
+    private isInitialized;
+    constructor();
+    private checkInitialized;
+    private checkDatasetExists;
+    createDataset(datasetId: string, columns?: DatasetColumn[], rawDatasetSource?: RawDatasetSource): Promise<void>;
+    updateDatasetSource(datasetId: string, columns?: DatasetColumn[], rawDatasetSource?: RawDatasetSource): Promise<void>;
+    dropDataset(datasetId: string): Promise<void>;
+    connectDataset(datasetId: string, temporaryColumns?: DatasetColumn[], temporaryRawDatasetSource?: RawDatasetSource): Promise<Dataset>;
+    hasDataset(datasetId: string): Promise<boolean>;
+    listDatasets(): Promise<{
+        datasetId: string;
+        datasetSchema: import("./types").DatasetSchema;
+        datasetSource?: import("./types").DatasetSource;
+    }[]>;
+    close(): Promise<void>;
+}

package/package.json

@@ -1,33 +1,39 @@
 {
   "name": "@visactor/vquery",
-  "version": "0.2.2",
+  "version": "0.2.5",
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "require": {
+        "types": "./dist/cjs/node.d.ts",
+        "default": "./dist/cjs/node.cjs"
+      },
+      "import": {
+        "types": "./dist/esm/browser.d.js",
+        "default": "./dist/esm/browser.js"
+      }
     }
   },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/cjs/node.cjs",
+  "types": "./dist/cjs/node.d.ts",
   "files": [
     "dist"
   ],
   "dependencies": {
     "@duckdb/duckdb-wasm": "1.30.0",
-    "kysely": "^0.27.2"
+    "kysely": "0.27.6",
+    "web-worker": "1.5.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.35.0",
-    "@rslib/core": "0.18.1",
-    "@rstest/core": "0.6.5",
-    "@types/node": "^22.18.10",
-    "@rstest/coverage-istanbul": "0.0.5",
-    "eslint": "^9.35.0",
-    "globals": "^16.3.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.43.0"
+    "@eslint/js": "9.39.0",
+    "@rslib/core": "0.18.3",
+    "@rstest/core": "0.7.0",
+    "@types/node": "24.10.1",
+    "@rstest/coverage-istanbul": "0.1.0",
+    "eslint": "9.39.0",
+    "globals": "16.4.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.46.2"
   },
   "scripts": {
     "build": "rslib build",
@@ -35,7 +41,7 @@
     "lint": "eslint .",
     "test": "rstest",
     "test:update": "rstest --update",
-    "test:coverage": "rstest --coverage && open ./coverage/index.html",
+    "test:coverage": "rstest --coverage; open ./coverage/index.html",
     "type-check": "tsc --noEmit"
   }
 }

package/dist/db/duckDb.d.ts

@@ -1,35 +0,0 @@
-import { QueryResult } from '../types/DataSet';
-export declare class DuckDB {
-    private db;
-    private connection;
-    constructor();
-    /**
-     * @description 初始化 DuckDB 实例
-     */
-    init: () => Promise<void>;
-    /**
-     * @description 释放 DuckDB 实例
-     */
-    close: () => Promise<void>;
-    /**
-     * 注册文件到 DuckDB 实例
-     * @param fileName 文件名
-     * @param source 文件内容
-     */
-    writeFile: <T extends Blob>(fileName: string, source: T) => Promise<void>;
-    /**
-     * @description 执行 SQL 查询
-     * @param sql SQL 语句
-     * @returns 查询结果
-     */
-    query: (sql: string) => Promise<{
-        dataset: any[];
-        table: any;
-    }>;
-    /**
-     * @description 获取文件的 Schema
-     * @param fileName 文件名
-     * @returns 文件的 Schema
-     */
-    getSchema: (fileName: string) => Promise<QueryResult>;
-}