@visactor/vbi 0.4.16 → 0.4.19

package/dist/index.js

@@ -1,12 +1,269 @@
 import { Array as external_yjs_Array, Doc, Map as external_yjs_Map, UndoManager, applyUpdate, encodeStateAsUpdate } from "yjs";
+import { pipe } from "remeda";
 import { ChartTypeEnum, findTreeNodesBy, preorderTraverse } from "@visactor/vseed";
 import { v4 } from "uuid";
-import { pipe } from "remeda";
+const connectorMap = new Map();
+const registerConnector = (id, connector)=>{
+    connectorMap.set(id, connector);
+};
+const getConnector = async (id)=>{
+    const connector = connectorMap.get(id);
+    if (!connector) throw new Error(`connector ${id} not registered`);
+    if ('function' == typeof connector) return connector();
+    return connector;
+};
+const VBI_TO_VQUERY_AGGR_FUNC_MAP = {
+    count: 'count',
+    countDistinct: 'count_distinct',
+    sum: 'sum',
+    avg: 'avg',
+    min: 'min',
+    max: 'max',
+    variance: 'variance',
+    variancePop: 'variance_pop',
+    stddev: 'stddev',
+    median: 'median',
+    quantile: 'quantile'
+};
+const mapAggregateForVQuery = (aggregate)=>{
+    if (!aggregate) return aggregate;
+    const mappedFunc = VBI_TO_VQUERY_AGGR_FUNC_MAP[aggregate.func] ?? aggregate.func;
+    return {
+        ...aggregate,
+        func: mappedFunc
+    };
+};
+const buildSelect = (queryDSL, context)=>{
+    const { vbiDSL } = context;
+    const measures = vbiDSL.measures;
+    const dimensions = vbiDSL.dimensions;
+    const result = {
+        ...queryDSL
+    };
+    const measureNodes = measures.filter((measure)=>MeasuresBuilder.isMeasureNode(measure));
+    const measureSelects = measureNodes.map((measure)=>({
+            field: measure.field,
+            alias: measure.alias,
+            aggr: mapAggregateForVQuery(measure.aggregate)
+        }));
+    const dimensionNodes = dimensions.filter((dimension)=>DimensionsBuilder.isDimensionNode(dimension));
+    const dimensionSelects = dimensionNodes.map((dimension)=>({
+            field: dimension.field,
+            alias: dimension.alias
+        }));
+    result.select = [
+        ...measureSelects,
+        ...dimensionSelects
+    ];
+    return result;
+};
+const buildGroupBy = (queryDSL, context)=>{
+    const result = {
+        ...queryDSL
+    };
+    const { vbiDSL } = context;
+    const dimensions = vbiDSL.dimensions;
+    const dimensionNodes = dimensions.filter((dimension)=>DimensionsBuilder.isDimensionNode(dimension));
+    result.groupBy = dimensionNodes.map((dimension)=>dimension.field);
+    return result;
+};
+const buildWhere = (queryDSL, context)=>{
+    const { vbiDSL } = context;
+    const whereFilter = vbiDSL.whereFilter;
+    if (!whereFilter || 0 === whereFilter.conditions.length) return queryDSL;
+    const result = {
+        ...queryDSL
+    };
+    result.where = mapGroupToCondition(whereFilter);
+    return result;
+};
+function isWhereGroup(clause) {
+    return 'op' in clause && 'conditions' in clause;
+}
+function mapClauseToCondition(clause) {
+    if (isWhereGroup(clause)) return [
+        mapGroupToCondition(clause)
+    ];
+    return mapFilterToCondition(clause);
+}
+function mapGroupToCondition(group) {
+    return {
+        op: group.op,
+        conditions: group.conditions.flatMap(mapClauseToCondition)
+    };
+}
+function mapFilterToCondition(filter) {
+    if ('between' === filter.op || 'not between' === filter.op) return handleBetweenFilter(filter);
+    return handleSimpleFilter(filter);
+}
+function handleBetweenFilter(filter) {
+    const value = normalizeBetweenValue(filter.value);
+    const lowerCondition = void 0 !== value.min && null !== value.min && '' !== value.min ? {
+        field: filter.field,
+        op: '<' === value.leftOp ? '>' : '>=',
+        value: value.min
+    } : void 0;
+    const upperCondition = void 0 !== value.max && null !== value.max && '' !== value.max ? {
+        field: filter.field,
+        op: '<' === value.rightOp ? '<' : '<=',
+        value: value.max
+    } : void 0;
+    if ('not between' === filter.op) {
+        const outsideConditions = [
+            lowerCondition && invertLowerBound(lowerCondition),
+            upperCondition && invertUpperBound(upperCondition)
+        ].filter(Boolean);
+        if (outsideConditions.length <= 1) return outsideConditions;
+        return [
+            {
+                op: 'or',
+                conditions: outsideConditions
+            }
+        ];
+    }
+    return [
+        lowerCondition,
+        upperCondition
+    ].filter(Boolean);
+}
+function normalizeBetweenValue(value) {
+    if (Array.isArray(value)) return {
+        min: value[0],
+        max: value[1],
+        leftOp: '<=',
+        rightOp: '<='
+    };
+    if ('object' == typeof value && null !== value) return value;
+    return {};
+}
+function invertLowerBound(condition) {
+    return {
+        field: condition.field,
+        op: '>' === condition.op ? '<=' : '<',
+        value: condition.value
+    };
+}
+function invertUpperBound(condition) {
+    return {
+        field: condition.field,
+        op: '<' === condition.op ? '>=' : '>',
+        value: condition.value
+    };
+}
+function handleSimpleFilter(filter) {
+    let mappedOp = filter.op ?? '=';
+    const value = filter.value;
+    if (Array.isArray(value)) {
+        if ('=' === mappedOp) mappedOp = 'in';
+        if ('!=' === mappedOp) mappedOp = 'not in';
+    }
+    return [
+        {
+            field: filter.field,
+            op: mappedOp,
+            value
+        }
+    ];
+}
+const DEFAULT_HAVING_AGGREGATE = {
+    func: 'sum'
+};
+const buildHaving = (queryDSL, context)=>{
+    const { vbiDSL } = context;
+    const havingFilter = vbiDSL.havingFilter;
+    if (!havingFilter || 0 === havingFilter.conditions.length) return queryDSL;
+    const result = {
+        ...queryDSL
+    };
+    result.having = {
+        op: havingFilter.op,
+        conditions: havingFilter.conditions.flatMap(buildHaving_mapClauseToCondition)
+    };
+    return result;
+};
+function isHavingGroup(clause) {
+    return 'op' in clause && 'conditions' in clause;
+}
+function buildHaving_mapClauseToCondition(clause) {
+    if (isHavingGroup(clause)) return [
+        buildHaving_mapGroupToCondition(clause)
+    ];
+    return buildHaving_mapFilterToCondition(clause);
+}
+function buildHaving_mapGroupToCondition(group) {
+    return {
+        op: group.op,
+        conditions: group.conditions.flatMap(buildHaving_mapClauseToCondition)
+    };
+}
+function buildHaving_mapFilterToCondition(filter) {
+    const mappedOp = normalizeOperator(filter.op, filter.value);
+    const aggregate = mapAggregateForVQuery(filter.aggregate ?? DEFAULT_HAVING_AGGREGATE);
+    return [
+        {
+            field: filter.field,
+            aggr: aggregate,
+            op: mappedOp,
+            value: filter.value
+        }
+    ];
+}
+function normalizeOperator(op, value) {
+    let mappedOp = op ?? '=';
+    if (Array.isArray(value)) {
+        if ('=' === mappedOp) mappedOp = 'in';
+        if ('!=' === mappedOp) mappedOp = 'not in';
+    }
+    return mappedOp;
+}
+const buildLimit = (queryDSL, context)=>{
+    const result = {
+        ...queryDSL
+    };
+    const limit = context.vbiDSL.limit ?? 1000;
+    result.limit = limit;
+    return result;
+};
+const buildVQuery = (vbiDSL, builder)=>{
+    const wrapper = (processor)=>(queryDSL)=>processor(queryDSL, {
+                vbiDSL,
+                builder
+            });
+    return pipe({}, wrapper(buildSelect), wrapper(buildGroupBy), wrapper(buildWhere), wrapper(buildHaving), wrapper(buildLimit));
+};
+const buildVQueryDSL = ({ vbiDSL, builder })=>buildVQuery(vbiDSL, builder);
+const buildVSeedDSL = async ({ vbiDSL, queryDSL })=>{
+    const connectorId = vbiDSL.connectorId;
+    const connector = await getConnector(connectorId);
+    const schema = await connector.discoverSchema();
+    const queryResult = await connector.query({
+        queryDSL,
+        schema,
+        connectorId
+    });
+    return {
+        chartType: vbiDSL.chartType,
+        dataset: queryResult.dataset,
+        theme: vbiDSL.theme,
+        locale: vbiDSL.locale
+    };
+};
+const defaultVBIBuilderAdapters = {
+    buildVQuery: buildVQueryDSL,
+    buildVSeed: buildVSeedDSL
+};
+const resolveVBIBuilderAdapters = (adapters)=>({
+        buildVQuery: adapters?.buildVQuery ?? defaultVBIBuilderAdapters.buildVQuery,
+        buildVSeed: adapters?.buildVSeed ?? defaultVBIBuilderAdapters.buildVSeed
+    });
 class MeasureNodeBuilder {
     yMap;
     constructor(yMap){
         this.yMap = yMap;
     }
+    getId() {
+        return this.yMap.get('id');
+    }
     getField() {
         return this.yMap.get('field');
     }
@@ -26,13 +283,46 @@ class MeasureNodeBuilder {
         return this.yMap.toJSON();
     }
 }
+const id_id = {
+    uuid: ()=>v4()
+};
+function isVBIFilter(clause) {
+    return 'field' in clause;
+}
+function isVBIWhereGroup(clause) {
+    return 'conditions' in clause;
+}
+function isVBIHavingFilter(clause) {
+    return 'field' in clause;
+}
+function isVBIHavingGroup(clause) {
+    return 'conditions' in clause;
+}
+const getOrCreateMeasures = (dsl)=>{
+    const measures = dsl.get('measures');
+    if (measures instanceof external_yjs_Array) return measures;
+    const yMeasures = new external_yjs_Array();
+    dsl.set('measures', yMeasures);
+    return yMeasures;
+};
+const normalizeMeasureNodeIds = (measures)=>{
+    measures.toArray().forEach((item)=>{
+        if (item instanceof external_yjs_Map && 'string' == typeof item.get('field') && !item.get('id')) item.set('id', id_id.uuid());
+    });
+};
+const locateMeasureIndexById = (measures, measureId)=>measures.toArray().findIndex((item)=>item.get('id') === measureId);
 class MeasuresBuilder {
     dsl;
-    constructor(_doc, dsl){
+    constructor(doc, dsl){
         this.dsl = dsl;
+        doc.transact(()=>{
+            const measures = getOrCreateMeasures(this.dsl);
+            normalizeMeasureNodeIds(measures);
+        });
     }
     add(field, callback) {
         const measure = {
+            id: id_id.uuid(),
             alias: field,
             field,
             encoding: 'yAxis',
@@ -42,45 +332,50 @@ class MeasuresBuilder {
         };
         const yMap = new external_yjs_Map();
         for (const [key, value] of Object.entries(measure))yMap.set(key, value);
-        this.dsl.get('measures').push([
+        const measures = getOrCreateMeasures(this.dsl);
+        measures.push([
             yMap
         ]);
         const node = new MeasureNodeBuilder(yMap);
         callback(node);
         return this;
     }
-    remove(field) {
-        const measures = this.dsl.get('measures');
-        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 !== index) this.dsl.get('measures').delete(index, 1);
+    remove(id) {
+        const measures = getOrCreateMeasures(this.dsl);
+        const index = locateMeasureIndexById(measures, id);
+        if (-1 !== index) measures.delete(index, 1);
         return this;
     }
-    update(field, callback) {
-        const measures = this.dsl.get('measures');
-        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 === index) throw new Error(`Measure with field "${field}" not found`);
+    update(id, callback) {
+        const measures = getOrCreateMeasures(this.dsl);
+        const index = locateMeasureIndexById(measures, id);
+        if (-1 === index) throw new Error(`Measure with id "${id}" not found`);
         const measureYMap = measures.get(index);
         const node = new MeasureNodeBuilder(measureYMap);
         callback(node);
         return this;
     }
-    find(field) {
-        const measures = this.dsl.get('measures');
-        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 === index) return;
-        return new MeasureNodeBuilder(measures.get(index));
+    find(predicate) {
+        const measures = getOrCreateMeasures(this.dsl);
+        const items = measures.toArray();
+        for(let index = 0; index < items.length; index++){
+            const node = new MeasureNodeBuilder(items[index]);
+            if (predicate(node, index)) return node;
+        }
     }
     findAll() {
-        const measures = this.dsl.get('measures');
+        const measures = getOrCreateMeasures(this.dsl);
         return measures.toArray().map((yMap)=>new MeasureNodeBuilder(yMap));
     }
     toJSON() {
-        return this.dsl.get('measures').toJSON();
+        const measures = getOrCreateMeasures(this.dsl);
+        return measures.toJSON();
     }
     observe(callback) {
-        this.dsl.get('measures').observe(callback);
+        const measures = getOrCreateMeasures(this.dsl);
+        measures.observe(callback);
         return ()=>{
-            this.dsl.get('measures').unobserve(callback);
+            measures.unobserve(callback);
         };
     }
     static isMeasureNode(node) {
@@ -95,6 +390,9 @@ class DimensionNodeBuilder {
     constructor(yMap){
         this.yMap = yMap;
     }
+    getId() {
+        return this.yMap.get('id');
+    }
     getField() {
         return this.yMap.get('field');
     }
@@ -106,57 +404,80 @@ class DimensionNodeBuilder {
         return this.yMap.toJSON();
     }
 }
+const getOrCreateDimensions = (dsl)=>{
+    const dimensions = dsl.get('dimensions');
+    if (dimensions instanceof external_yjs_Array) return dimensions;
+    const yDimensions = new external_yjs_Array();
+    dsl.set('dimensions', yDimensions);
+    return yDimensions;
+};
+const normalizeDimensionNodeIds = (dimensions)=>{
+    dimensions.toArray().forEach((item)=>{
+        if (item instanceof external_yjs_Map && 'string' == typeof item.get('field') && !item.get('id')) item.set('id', id_id.uuid());
+    });
+};
+const locateDimensionIndexById = (dimensions, dimensionId)=>dimensions.toArray().findIndex((item)=>item.get('id') === dimensionId);
 class DimensionsBuilder {
     dsl;
-    constructor(_doc, dsl){
+    constructor(doc, dsl){
         this.dsl = dsl;
+        doc.transact(()=>{
+            const dimensions = getOrCreateDimensions(this.dsl);
+            normalizeDimensionNodeIds(dimensions);
+        });
     }
     add(field, callback) {
         const dimension = {
+            id: id_id.uuid(),
             alias: field,
             field
         };
         const yMap = new external_yjs_Map();
         for (const [key, value] of Object.entries(dimension))yMap.set(key, value);
-        this.dsl.get('dimensions').push([
+        const dimensions = getOrCreateDimensions(this.dsl);
+        dimensions.push([
             yMap
         ]);
         const node = new DimensionNodeBuilder(yMap);
         callback(node);
         return this;
     }
-    remove(field) {
-        const dimensions = this.dsl.get('dimensions');
-        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 !== index) this.dsl.get('dimensions').delete(index, 1);
+    remove(id) {
+        const dimensions = getOrCreateDimensions(this.dsl);
+        const index = locateDimensionIndexById(dimensions, id);
+        if (-1 !== index) dimensions.delete(index, 1);
         return this;
     }
-    update(field, callback) {
-        const dimensions = this.dsl.get('dimensions');
-        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 === index) throw new Error(`Dimension with field "${field}" not found`);
+    update(id, callback) {
+        const dimensions = getOrCreateDimensions(this.dsl);
+        const index = locateDimensionIndexById(dimensions, id);
+        if (-1 === index) throw new Error(`Dimension with id "${id}" not found`);
         const dimensionYMap = dimensions.get(index);
         const node = new DimensionNodeBuilder(dimensionYMap);
         callback(node);
         return this;
     }
-    find(field) {
-        const dimensions = this.dsl.get('dimensions');
-        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 === index) return;
-        return new DimensionNodeBuilder(dimensions.get(index));
+    find(predicate) {
+        const dimensions = getOrCreateDimensions(this.dsl);
+        const items = dimensions.toArray();
+        for(let index = 0; index < items.length; index++){
+            const node = new DimensionNodeBuilder(items[index]);
+            if (predicate(node, index)) return node;
+        }
     }
     findAll() {
-        const dimensions = this.dsl.get('dimensions');
+        const dimensions = getOrCreateDimensions(this.dsl);
         return dimensions.toArray().map((yMap)=>new DimensionNodeBuilder(yMap));
     }
     toJSON() {
-        return this.dsl.get('dimensions').toJSON();
+        const dimensions = getOrCreateDimensions(this.dsl);
+        return dimensions.toJSON();
     }
     observe(callback) {
-        this.dsl.get('dimensions').observe(callback);
+        const dimensions = getOrCreateDimensions(this.dsl);
+        dimensions.observe(callback);
         return ()=>{
-            this.dsl.get('dimensions').unobserve(callback);
+            dimensions.unobserve(callback);
         };
     }
     static isDimensionNode(node) {
@@ -215,21 +536,6 @@ class ChartTypeBuilder {
         ];
     }
 }
-const id_id = {
-    uuid: ()=>v4()
-};
-function isVBIFilter(clause) {
-    return 'field' in clause;
-}
-function isVBIWhereGroup(clause) {
-    return 'conditions' in clause;
-}
-function isVBIHavingFilter(clause) {
-    return 'field' in clause;
-}
-function isVBIHavingGroup(clause) {
-    return 'conditions' in clause;
-}
 function createWhereGroup(op = 'and', groupId = 'root') {
     const yMap = new external_yjs_Map();
     yMap.set('id', groupId);
@@ -237,7 +543,7 @@ function createWhereGroup(op = 'and', groupId = 'root') {
     yMap.set('conditions', new external_yjs_Array());
     return yMap;
 }
-function isWhereGroup(yMap) {
+function where_utils_isWhereGroup(yMap) {
     return void 0 !== yMap.get('op') && void 0 !== yMap.get('conditions');
 }
 function findEntry(collection, entryId) {
@@ -249,7 +555,7 @@ function findEntry(collection, entryId) {
             index,
             item
         };
-        if (isWhereGroup(item)) {
+        if (where_utils_isWhereGroup(item)) {
             const nestedCollection = item.get('conditions');
             const nestedMatch = findEntry(nestedCollection, entryId);
             if (nestedMatch) return nestedMatch;
@@ -411,13 +717,21 @@ class WhereFilterBuilder {
         }
         return this;
     }
-    find(id) {
-        const conditions = this.getConditions();
-        const match = findEntry(conditions, id);
-        const yMap = match?.item;
-        if (!yMap) return;
-        if (WhereFilterBuilder.isGroup(yMap)) return new WhereGroupBuilder(yMap);
-        return new WhereFilterNodeBuilder(yMap);
+    find(predicate) {
+        const traverse = (collection)=>{
+            const items = collection.toArray();
+            for(let index = 0; index < items.length; index++){
+                const yMap = items[index];
+                const entry = WhereFilterBuilder.isGroup(yMap) ? new WhereGroupBuilder(yMap) : new WhereFilterNodeBuilder(yMap);
+                if (predicate(entry, index)) return entry;
+                if (WhereFilterBuilder.isGroup(yMap)) {
+                    const nestedCollection = yMap.get('conditions');
+                    const nestedMatch = traverse(nestedCollection);
+                    if (nestedMatch) return nestedMatch;
+                }
+            }
+        };
+        return traverse(this.getConditions());
     }
     clear() {
         const conditions = this.getConditions();
@@ -434,7 +748,7 @@ class WhereFilterBuilder {
         };
     }
     static isGroup(yMap) {
-        return isWhereGroup(yMap);
+        return where_utils_isWhereGroup(yMap);
     }
     static isNode(yMap) {
         return void 0 !== yMap.get('field');
@@ -447,7 +761,7 @@ function createHavingGroup(op = 'and', groupId = 'root') {
     yMap.set('conditions', new external_yjs_Array());
     return yMap;
 }
-function isHavingGroup(yMap) {
+function having_utils_isHavingGroup(yMap) {
     return void 0 !== yMap.get('op') && void 0 !== yMap.get('conditions');
 }
 function having_utils_findEntry(collection, entryId) {
@@ -459,7 +773,7 @@ function having_utils_findEntry(collection, entryId) {
             index,
             item
         };
-        if (isHavingGroup(item)) {
+        if (having_utils_isHavingGroup(item)) {
             const nestedCollection = item.get('conditions');
             const nestedMatch = having_utils_findEntry(nestedCollection, entryId);
             if (nestedMatch) return nestedMatch;
@@ -480,6 +794,9 @@ class HavingFilterNodeBuilder {
     getOperator() {
         return this.yMap.get('op');
     }
+    getAggregate() {
+        return this.yMap.get('aggregate');
+    }
     setValue(value) {
         this.yMap.set('value', value);
         return this;
@@ -488,6 +805,10 @@ class HavingFilterNodeBuilder {
         this.yMap.set('op', operator);
         return this;
     }
+    setAggregate(aggregate) {
+        this.yMap.set('aggregate', aggregate);
+        return this;
+    }
     toJSON() {
         return this.yMap.toJSON();
     }
@@ -514,6 +835,9 @@ class HavingGroupBuilder {
         const yMap = new external_yjs_Map();
         yMap.set('id', id_id.uuid());
         yMap.set('field', field);
+        yMap.set('aggregate', {
+            func: 'sum'
+        });
         this.getConditions().push([
             yMap
         ]);
@@ -571,6 +895,9 @@ class HavingFilterBuilder {
         const yMap = new external_yjs_Map();
         yMap.set('id', id_id.uuid());
         yMap.set('field', field);
+        yMap.set('aggregate', {
+            func: 'sum'
+        });
         this.getConditions().push([
             yMap
         ]);
@@ -617,13 +944,21 @@ class HavingFilterBuilder {
         }
         return this;
     }
-    find(id) {
-        const conditions = this.getConditions();
-        const match = having_utils_findEntry(conditions, id);
-        const yMap = match?.item;
-        if (!yMap) return;
-        if (HavingFilterBuilder.isGroup(yMap)) return new HavingGroupBuilder(yMap);
-        return new HavingFilterNodeBuilder(yMap);
+    find(predicate) {
+        const traverse = (collection)=>{
+            const items = collection.toArray();
+            for(let index = 0; index < items.length; index++){
+                const yMap = items[index];
+                const entry = HavingFilterBuilder.isGroup(yMap) ? new HavingGroupBuilder(yMap) : new HavingFilterNodeBuilder(yMap);
+                if (predicate(entry, index)) return entry;
+                if (HavingFilterBuilder.isGroup(yMap)) {
+                    const nestedCollection = yMap.get('conditions');
+                    const nestedMatch = traverse(nestedCollection);
+                    if (nestedMatch) return nestedMatch;
+                }
+            }
+        };
+        return traverse(this.getConditions());
     }
     clear() {
         const conditions = this.getConditions();
@@ -640,7 +975,7 @@ class HavingFilterBuilder {
         };
     }
     static isGroup(yMap) {
-        return isHavingGroup(yMap);
+        return having_utils_isHavingGroup(yMap);
     }
     static isNode(yMap) {
         return void 0 !== yMap.get('field');
@@ -739,202 +1074,30 @@ class undo_manager_UndoManager {
         this.manager.clear(clearUndoStack, clearRedoStack);
     }
 }
-const buildSelect = (queryDSL, context)=>{
-    const { vbiDSL } = context;
-    const measures = vbiDSL.measures;
-    const dimensions = vbiDSL.dimensions;
-    const result = {
-        ...queryDSL
-    };
-    const measureNodes = measures.filter((measure)=>MeasuresBuilder.isMeasureNode(measure));
-    const measureSelects = measureNodes.map((measure)=>({
-            field: measure.field,
-            alias: measure.alias,
-            aggr: measure.aggregate
-        }));
-    const dimensionNodes = dimensions.filter((dimension)=>DimensionsBuilder.isDimensionNode(dimension));
-    const dimensionSelects = dimensionNodes.map((dimension)=>({
-            field: dimension.field,
-            alias: dimension.alias
-        }));
-    result.select = measureSelects.concat(dimensionSelects);
-    return result;
-};
-const buildGroupBy = (queryDSL, context)=>{
-    const result = {
-        ...queryDSL
-    };
-    const { vbiDSL } = context;
-    const dimensions = vbiDSL.dimensions;
-    const dimensionNodes = dimensions.filter((dimension)=>DimensionsBuilder.isDimensionNode(dimension));
-    result.groupBy = dimensionNodes.map((dimension)=>dimension.field);
-    return result;
-};
-const buildWhere = (queryDSL, context)=>{
-    const { vbiDSL } = context;
-    const whereFilter = vbiDSL.whereFilter;
-    if (!whereFilter || 0 === whereFilter.conditions.length) return queryDSL;
-    const result = {
-        ...queryDSL
-    };
-    result.where = mapGroupToCondition(whereFilter);
-    return result;
-};
-function buildWhere_isWhereGroup(clause) {
-    return 'op' in clause && 'conditions' in clause;
-}
-function mapClauseToCondition(clause) {
-    if (buildWhere_isWhereGroup(clause)) return [
-        mapGroupToCondition(clause)
-    ];
-    return mapFilterToCondition(clause);
-}
-function mapGroupToCondition(group) {
-    return {
-        op: group.op,
-        conditions: group.conditions.flatMap(mapClauseToCondition)
-    };
-}
-function mapFilterToCondition(filter) {
-    if ('between' === filter.op || 'not between' === filter.op) return handleBetweenFilter(filter);
-    return handleSimpleFilter(filter);
-}
-function handleBetweenFilter(filter) {
-    const value = normalizeBetweenValue(filter.value);
-    const lowerCondition = void 0 !== value.min && null !== value.min && '' !== value.min ? {
-        field: filter.field,
-        op: '<' === value.leftOp ? '>' : '>=',
-        value: value.min
-    } : void 0;
-    const upperCondition = void 0 !== value.max && null !== value.max && '' !== value.max ? {
-        field: filter.field,
-        op: '<' === value.rightOp ? '<' : '<=',
-        value: value.max
-    } : void 0;
-    if ('not between' === filter.op) {
-        const outsideConditions = [
-            lowerCondition && invertLowerBound(lowerCondition),
-            upperCondition && invertUpperBound(upperCondition)
-        ].filter(Boolean);
-        if (outsideConditions.length <= 1) return outsideConditions;
-        return [
-            {
-                op: 'or',
-                conditions: outsideConditions
-            }
-        ];
-    }
-    return [
-        lowerCondition,
-        upperCondition
-    ].filter(Boolean);
-}
-function normalizeBetweenValue(value) {
-    if (Array.isArray(value)) return {
-        min: value[0],
-        max: value[1],
-        leftOp: '<=',
-        rightOp: '<='
-    };
-    if ('object' == typeof value && null !== value) return value;
-    return {};
-}
-function invertLowerBound(condition) {
-    return {
-        field: condition.field,
-        op: '>' === condition.op ? '<=' : '<',
-        value: condition.value
-    };
-}
-function invertUpperBound(condition) {
-    return {
-        field: condition.field,
-        op: '<' === condition.op ? '>=' : '>',
-        value: condition.value
-    };
-}
-function handleSimpleFilter(filter) {
-    let mappedOp = filter.op ?? '=';
-    const value = filter.value;
-    if (Array.isArray(value)) {
-        if ('=' === mappedOp) mappedOp = 'in';
-        if ('!=' === mappedOp) mappedOp = 'not in';
-    }
-    return [
-        {
-            field: filter.field,
-            op: mappedOp,
-            value
-        }
-    ];
-}
-const buildHaving = (queryDSL, context)=>{
-    const { vbiDSL } = context;
-    const havingFilter = vbiDSL.havingFilter;
-    if (!havingFilter || 0 === havingFilter.conditions.length) return queryDSL;
-    const result = {
-        ...queryDSL
-    };
-    result.having = {
-        op: havingFilter.op,
-        conditions: havingFilter.conditions.flatMap(buildHaving_mapClauseToCondition)
-    };
-    return result;
-};
-function buildHaving_isHavingGroup(clause) {
-    return 'op' in clause && 'conditions' in clause;
-}
-function buildHaving_mapClauseToCondition(clause) {
-    if (buildHaving_isHavingGroup(clause)) return [
-        buildHaving_mapGroupToCondition(clause)
-    ];
-    return buildHaving_mapFilterToCondition(clause);
-}
-function buildHaving_mapGroupToCondition(group) {
-    return {
-        op: group.op,
-        conditions: group.conditions.flatMap(buildHaving_mapClauseToCondition)
-    };
-}
-function buildHaving_mapFilterToCondition(filter) {
-    const mappedOp = filter.op ?? '=';
-    return [
-        {
-            field: filter.field,
-            op: mappedOp,
-            value: filter.value
-        }
-    ];
-}
-const buildLimit = (queryDSL, context)=>{
-    const result = {
-        ...queryDSL
-    };
-    const limit = context.vbiDSL.limit ?? 1000;
-    result.limit = limit;
-    return result;
+const applyUpdateToDoc = (doc, update, transactionOrigin)=>{
+    applyUpdate(doc, update, transactionOrigin);
 };
-const buildVQuery = (vbiDSL, builder)=>{
-    const wrapper = (processor)=>(queryDSL)=>processor(queryDSL, {
-                vbiDSL,
-                builder
-            });
-    return pipe({}, wrapper(buildSelect), wrapper(buildGroupBy), wrapper(buildWhere), wrapper(buildHaving), wrapper(buildLimit));
+const encodeDocStateAsUpdate = (doc, targetStateVector)=>encodeStateAsUpdate(doc, targetStateVector);
+const buildVBIDSL = (dsl)=>dsl.toJSON();
+const getCollectionLength = (value)=>{
+    if (value instanceof external_yjs_Array) return value.length;
+    if (Array.isArray(value)) return value.length;
+    return 0;
 };
-const connectorMap = new Map();
-const registerConnector = (id, connector)=>{
-    connectorMap.set(id, connector);
+const isEmptyVBIDSL = (dsl)=>{
+    const dimensionsLength = getCollectionLength(dsl.get('dimensions'));
+    const measuresLength = getCollectionLength(dsl.get('measures'));
+    return 0 === dimensionsLength && 0 === measuresLength;
 };
-const getConnector = async (id)=>{
-    const connector = connectorMap.get(id);
-    if (!connector) throw new Error(`connector ${id} not registered`);
-    if ('function' == typeof connector) return connector();
-    return connector;
+const getBuilderSchema = async (dsl)=>{
+    const connectorId = dsl.get('connectorId');
+    const connector = await getConnector(connectorId);
+    return connector.discoverSchema();
 };
 class VBIBuilder {
     doc;
     dsl;
-    undoManager;
+    adapters;
     chartType;
     measures;
     dimensions;
@@ -943,9 +1106,11 @@ class VBIBuilder {
     theme;
     locale;
     limit;
-    constructor(doc){
+    undoManager;
+    constructor(doc, options){
         this.doc = doc;
         this.dsl = doc.getMap('dsl');
+        this.adapters = resolveVBIBuilderAdapters(options?.adapters);
         this.undoManager = new undo_manager_UndoManager(this.dsl);
         this.chartType = new ChartTypeBuilder(doc, this.dsl);
         this.measures = new MeasuresBuilder(doc, this.dsl);
@@ -956,149 +1121,193 @@ class VBIBuilder {
         this.locale = new LocaleBuilder(doc, this.dsl);
         this.limit = new LimitBuilder(doc, this.dsl);
     }
-    applyUpdate(update) {
-        applyUpdate(this.doc, update);
-    }
-    encodeStateAsUpdate(targetStateVector) {
-        return encodeStateAsUpdate(this.doc, targetStateVector);
-    }
+    applyUpdate = (update, transactionOrigin)=>applyUpdateToDoc(this.doc, update, transactionOrigin);
+    encodeStateAsUpdate = (targetStateVector)=>encodeDocStateAsUpdate(this.doc, targetStateVector);
     buildVSeed = async ()=>{
         const vbiDSL = this.build();
-        const connectorId = vbiDSL.connectorId;
-        const connector = await getConnector(vbiDSL.connectorId);
-        const queryDSL = this.buildVQuery();
-        const schema = await connector.discoverSchema();
-        const queryResult = await connector.query({
+        const queryDSL = this.adapters.buildVQuery({
+            dsl: this.dsl,
+            vbiDSL,
+            builder: this
+        });
+        return this.adapters.buildVSeed({
+            dsl: this.dsl,
+            vbiDSL,
             queryDSL,
-            schema,
-            connectorId
+            builder: this
         });
-        return {
-            chartType: vbiDSL.chartType,
-            dataset: queryResult.dataset,
-            theme: vbiDSL.theme,
-            locale: vbiDSL.locale
-        };
     };
     buildVQuery = ()=>{
         const vbiDSL = this.build();
-        return buildVQuery(vbiDSL, this);
-    };
-    build = ()=>this.dsl.toJSON();
-    getSchema = async ()=>{
-        const connectorId = this.dsl.get('connectorId');
-        const con = await getConnector(connectorId);
-        const result = await con.discoverSchema();
-        return result;
+        return this.adapters.buildVQuery({
+            dsl: this.dsl,
+            vbiDSL,
+            builder: this
+        });
     };
+    build = ()=>buildVBIDSL(this.dsl);
+    isEmpty = ()=>isEmptyVBIDSL(this.dsl);
+    getSchema = async ()=>getBuilderSchema(this.dsl);
 }
-const createVBI = ()=>({
-        connectorMap: connectorMap,
-        registerConnector: registerConnector,
-        getConnector: getConnector,
-        generateEmptyDSL: (connectorId)=>({
-                connectorId: connectorId,
-                chartType: 'table',
-                measures: [],
-                dimensions: [],
-                whereFilter: {
-                    id: 'root',
-                    op: 'and',
-                    conditions: []
-                },
-                havingFilter: {
-                    id: 'root',
-                    op: 'and',
-                    conditions: []
-                },
-                theme: 'light',
-                locale: 'zh-CN',
-                version: 0
-            }),
-        from: (vbi)=>{
-            const doc = new Doc();
-            const dsl = doc.getMap('dsl');
-            doc.transact(()=>{
-                if (vbi.connectorId) dsl.set('connectorId', vbi.connectorId);
-                if (vbi.chartType) dsl.set('chartType', vbi.chartType);
-                if (vbi.theme) dsl.set('theme', vbi.theme);
-                if (vbi.limit) dsl.set('limit', vbi.limit);
-                if (vbi.locale) dsl.set('locale', vbi.locale);
-                if (void 0 !== vbi.version) dsl.set('version', vbi.version);
-                const toYMap = (obj, ensureId = false)=>{
-                    const yMap = new external_yjs_Map();
-                    if (ensureId && !obj.id) yMap.set('id', id_id.uuid());
-                    for (const [key, value] of Object.entries(obj))if ('conditions' === key && Array.isArray(value)) {
-                        const yArr = new external_yjs_Array();
-                        value.forEach((child)=>{
-                            if (child instanceof external_yjs_Map) yArr.push([
-                                child
-                            ]);
-                            else if ('object' == typeof child && null !== child) yArr.push([
-                                toYMap(child, true)
-                            ]);
-                            else yArr.push([
-                                child
-                            ]);
-                        });
-                        yMap.set(key, yArr);
-                    } else yMap.set(key, value);
-                    return yMap;
-                };
-                const ensureYArray = (arr, ensureId = false)=>{
-                    if (!arr) return new external_yjs_Array();
-                    if (arr instanceof external_yjs_Array) return arr;
-                    const yArr = new external_yjs_Array();
-                    arr.forEach((item)=>{
-                        if (item instanceof external_yjs_Map) yArr.push([
-                            item
-                        ]);
-                        else if ('object' == typeof item && null !== item) yArr.push([
-                            toYMap(item, ensureId)
-                        ]);
-                        else yArr.push([
-                            item
-                        ]);
-                    });
-                    return yArr;
-                };
-                const whereFilter = vbi.whereFilter ?? {
-                    id: 'root',
-                    op: 'and',
-                    conditions: []
-                };
-                const whereGroup = whereFilter instanceof external_yjs_Map ? whereFilter : createWhereGroup();
-                if (whereFilter instanceof external_yjs_Map) {
-                    if (!(whereGroup.get('conditions') instanceof external_yjs_Array)) whereGroup.set('conditions', new external_yjs_Array());
-                    if (!whereGroup.get('id')) whereGroup.set('id', 'root');
-                    if (!whereGroup.get('op')) whereGroup.set('op', 'and');
-                } else {
-                    whereGroup.set('id', whereFilter.id ?? 'root');
-                    whereGroup.set('op', whereFilter.op ?? 'and');
-                    whereGroup.set('conditions', ensureYArray(whereFilter.conditions, true));
+const shouldEnsureIdForObject = (obj, ensureId)=>{
+    if (true === ensureId) return true;
+    if ('field' === ensureId) return 'string' == typeof obj.field;
+    return false;
+};
+const toYMap = (obj, ensureId = false)=>{
+    const yMap = new external_yjs_Map();
+    if (shouldEnsureIdForObject(obj, ensureId) && !obj.id) yMap.set('id', id_id.uuid());
+    for (const [key, value] of Object.entries(obj)){
+        if (('conditions' === key || 'children' === key) && Array.isArray(value)) {
+            const yArr = new external_yjs_Array();
+            for (const child of value){
+                if (child instanceof external_yjs_Map) {
+                    yArr.push([
+                        child
+                    ]);
+                    continue;
                 }
-                dsl.set('whereFilter', whereGroup);
-                const havingFilter = vbi.havingFilter ?? {
-                    id: 'root',
-                    op: 'and',
-                    conditions: []
-                };
-                const havingGroup = havingFilter instanceof external_yjs_Map ? havingFilter : createHavingGroup();
-                if (havingFilter instanceof external_yjs_Map) {
-                    if (!(havingGroup.get('conditions') instanceof external_yjs_Array)) havingGroup.set('conditions', new external_yjs_Array());
-                    if (!havingGroup.get('id')) havingGroup.set('id', 'root');
-                    if (!havingGroup.get('op')) havingGroup.set('op', 'and');
-                } else {
-                    havingGroup.set('id', havingFilter.id ?? 'root');
-                    havingGroup.set('op', havingFilter.op ?? 'and');
-                    havingGroup.set('conditions', ensureYArray(havingFilter.conditions, true));
+                if ('object' == typeof child && null !== child) {
+                    yArr.push([
+                        toYMap(child, ensureId)
+                    ]);
+                    continue;
                 }
-                dsl.set('havingFilter', havingGroup);
-                dsl.set('measures', ensureYArray(vbi.measures));
-                dsl.set('dimensions', ensureYArray(vbi.dimensions));
-            });
-            return new VBIBuilder(doc);
+                yArr.push([
+                    child
+                ]);
+            }
+            yMap.set(key, yArr);
+            continue;
+        }
+        yMap.set(key, value);
+    }
+    return yMap;
+};
+const ensureYArray = (arr, ensureId = false)=>{
+    if (!arr) return new external_yjs_Array();
+    if (arr instanceof external_yjs_Array) return arr;
+    const yArr = new external_yjs_Array();
+    for (const item of arr){
+        if (item instanceof external_yjs_Map) {
+            yArr.push([
+                item
+            ]);
+            continue;
+        }
+        if ('object' == typeof item && null !== item) {
+            yArr.push([
+                toYMap(item, ensureId)
+            ]);
+            continue;
         }
+        yArr.push([
+            item
+        ]);
+    }
+    return yArr;
+};
+const getDefaultWhereFilter = ()=>({
+        id: 'root',
+        op: 'and',
+        conditions: []
+    });
+const isFilterGroupInput = (value)=>'object' == typeof value && null !== value;
+const ensureWhereGroup = (whereFilter)=>{
+    const sourceWhereFilter = whereFilter instanceof external_yjs_Map || isFilterGroupInput(whereFilter) ? whereFilter : getDefaultWhereFilter();
+    const whereGroup = sourceWhereFilter instanceof external_yjs_Map ? sourceWhereFilter : createWhereGroup();
+    if (sourceWhereFilter instanceof external_yjs_Map) {
+        if (!(whereGroup.get('conditions') instanceof external_yjs_Array)) whereGroup.set('conditions', new external_yjs_Array());
+        if (!whereGroup.get('id')) whereGroup.set('id', 'root');
+        if (!whereGroup.get('op')) whereGroup.set('op', 'and');
+        return whereGroup;
+    }
+    whereGroup.set('id', sourceWhereFilter.id ?? 'root');
+    whereGroup.set('op', sourceWhereFilter.op ?? 'and');
+    whereGroup.set('conditions', ensureYArray(sourceWhereFilter.conditions, true));
+    return whereGroup;
+};
+const getDefaultHavingFilter = ()=>({
+        id: 'root',
+        op: 'and',
+        conditions: []
     });
+const ensure_having_group_isFilterGroupInput = (value)=>'object' == typeof value && null !== value;
+const ensureHavingGroup = (havingFilter)=>{
+    const sourceHavingFilter = havingFilter instanceof external_yjs_Map || ensure_having_group_isFilterGroupInput(havingFilter) ? havingFilter : getDefaultHavingFilter();
+    const havingGroup = sourceHavingFilter instanceof external_yjs_Map ? sourceHavingFilter : createHavingGroup();
+    if (sourceHavingFilter instanceof external_yjs_Map) {
+        if (!(havingGroup.get('conditions') instanceof external_yjs_Array)) havingGroup.set('conditions', new external_yjs_Array());
+        if (!havingGroup.get('id')) havingGroup.set('id', 'root');
+        if (!havingGroup.get('op')) havingGroup.set('op', 'and');
+        return havingGroup;
+    }
+    havingGroup.set('id', sourceHavingFilter.id ?? 'root');
+    havingGroup.set('op', sourceHavingFilter.op ?? 'and');
+    havingGroup.set('conditions', ensureYArray(sourceHavingFilter.conditions, true));
+    return havingGroup;
+};
+const setBaseDSLFields = (dsl, vbi)=>{
+    if (vbi.connectorId) dsl.set('connectorId', vbi.connectorId);
+    if (vbi.chartType) dsl.set('chartType', vbi.chartType);
+    if (vbi.theme) dsl.set('theme', vbi.theme);
+    if (vbi.limit) dsl.set('limit', vbi.limit);
+    if (vbi.locale) dsl.set('locale', vbi.locale);
+    if (void 0 !== vbi.version) dsl.set('version', vbi.version);
+};
+const fromVBIDSLInput = (vbi, options)=>{
+    const doc = new Doc();
+    const dsl = doc.getMap('dsl');
+    doc.transact(()=>{
+        setBaseDSLFields(dsl, vbi);
+        dsl.set('whereFilter', ensureWhereGroup(vbi.whereFilter));
+        dsl.set('havingFilter', ensureHavingGroup(vbi.havingFilter));
+        dsl.set('measures', ensureYArray(vbi.measures, 'field'));
+        dsl.set('dimensions', ensureYArray(vbi.dimensions, 'field'));
+    });
+    return new VBIBuilder(doc, options);
+};
+const generateEmptyDSL = (connectorId)=>({
+        connectorId,
+        chartType: 'table',
+        measures: [],
+        dimensions: [],
+        whereFilter: {
+            id: 'root',
+            op: 'and',
+            conditions: []
+        },
+        havingFilter: {
+            id: 'root',
+            op: 'and',
+            conditions: []
+        },
+        theme: 'light',
+        locale: 'zh-CN',
+        version: 0
+    });
+const mergeBuilderOptions = (base, overrides)=>{
+    if (!base) return overrides;
+    if (!overrides) return base;
+    return {
+        ...base,
+        ...overrides,
+        adapters: {
+            ...base.adapters,
+            ...overrides.adapters
+        }
+    };
+};
+function createVBI(defaultBuilderOptions) {
+    const from = (vbi, builderOptions)=>fromVBIDSLInput(vbi, mergeBuilderOptions(defaultBuilderOptions, builderOptions));
+    return {
+        connectorMap: connectorMap,
+        registerConnector: registerConnector,
+        getConnector: getConnector,
+        generateEmptyDSL: generateEmptyDSL,
+        from,
+        create: from
+    };
+}
 const VBI = createVBI();
-export { ChartTypeBuilder, DimensionsBuilder, HavingFilterBuilder, LimitBuilder, LocaleBuilder, MeasuresBuilder, ThemeBuilder, undo_manager_UndoManager as UndoManager, VBI, VBIBuilder, WhereFilterBuilder, buildVQuery, findTreeNodesBy, id_id as id, isVBIFilter, isVBIHavingFilter, isVBIHavingGroup, isVBIWhereGroup, preorderTraverse };
+export { ChartTypeBuilder, DimensionsBuilder, HavingFilterBuilder, LimitBuilder, LocaleBuilder, MeasuresBuilder, ThemeBuilder, undo_manager_UndoManager as UndoManager, VBI, VBIBuilder, WhereFilterBuilder, buildVQuery, createVBI, defaultVBIBuilderAdapters, findTreeNodesBy, id_id as id, isVBIFilter, isVBIHavingFilter, isVBIHavingGroup, isVBIWhereGroup, preorderTraverse, resolveVBIBuilderAdapters };