dtable-utils 5.0.6 → 5.0.7-beta.2

package/es/archive/sql-generator/filter-condition.js

@@ -1,8 +1,9 @@
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
 import dayjs from 'dayjs';
 import utc from 'dayjs/plugin/utc';
 import { ValidateFilter } from '../../validate/filter.js';
-import { otherDate } from '../../filter/core.js';
+import { otherDate, checkIsFilterGroup } from '../../filter/core.js';
 import { getTableColumnByKey } from '../../table/column.js';
 import { FILTER_ERR_MSG } from '../../constants/filter/index.js';
 import { CellType } from '../../constants/cell-type.js';
@@ -12,6 +13,8 @@ import PatchUtils from '../../helper/patch-utils.js';
 import { FILTER_PREDICATE_TYPE } from '../../constants/filter/filter-predicate.js';
 import { FILTER_TERM_MODIFIER_TYPE } from '../../constants/filter/filter-modifier.js';
 
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 dayjs.extend(utc);
 
 // TEXT | GEOLOCATION | EMAIL | AUTO_NUMBER
@@ -114,7 +117,7 @@ var dateSqlCondition = function dateSqlCondition(column, filterItem) {
     filter_term = filterItem.filter_term,
     filter_term_modifier = filterItem.filter_term_modifier;
   var filterLabel = [FILTER_PREDICATE_TYPE.EMPTY, FILTER_PREDICATE_TYPE.NOT_EMPTY];
-  if (filter_term.length === 0 && filterLabel.indexOf(filter_predicate) < 0 && filter_term_modifier === FILTER_TERM_MODIFIER_TYPE.EXACT_DATE) {
+  if ((!filter_term || filter_term.length === 0) && filterLabel.indexOf(filter_predicate) < 0 && filter_term_modifier === FILTER_TERM_MODIFIER_TYPE.EXACT_DATE) {
     return '';
   }
   if (filter_predicate === FILTER_PREDICATE_TYPE.IS) {
@@ -173,7 +176,7 @@ var ctimeSqlCondition = function ctimeSqlCondition(column, filterItem) {
     filter_term = filterItem.filter_term,
     filter_term_modifier = filterItem.filter_term_modifier;
   var filterLabel = [FILTER_PREDICATE_TYPE.EMPTY, FILTER_PREDICATE_TYPE.NOT_EMPTY];
-  if (filter_term.length === 0 && filterLabel.indexOf(filter_predicate) < 0 && filter_term_modifier === FILTER_TERM_MODIFIER_TYPE.EXACT_DATE) {
+  if ((!filter_term || filter_term.length === 0) && filterLabel.indexOf(filter_predicate) < 0 && filter_term_modifier === FILTER_TERM_MODIFIER_TYPE.EXACT_DATE) {
     return '';
   }
 
@@ -692,32 +695,103 @@ var getSqlConditionByFilter = function getSqlConditionByFilter(column, filterIte
   }
   return '';
 };
-var filter2SqlCondition = function filter2SqlCondition(table, view, username, userId, userDepartmentIdsMap) {
+
+/**
+ * FilterGroup: {"filter_conjunction": "And", filters: [Filter, ...]}
+ * Filter: {"column_key": "xxx", filter_predicate: "xxx", ...}
+ * @param {array} filters
+ * @param {object} table
+ * @param {string} username
+ * @param {string} userId
+ * @param {object} userDepartmentIdsMap
+ * @returns string
+ */
+var getSqlConditionsByFilters = function getSqlConditionsByFilters(filters, table, username, userId, userDepartmentIdsMap) {
+  var columns = table.columns;
   var patchedUsername = PatchUtils.getUsername(username);
   var patchedUserId = PatchUtils.getUserId(userId);
   var patchedUserDepartmentIdsMap = PatchUtils.getUserDepartmentIdsMap(userDepartmentIdsMap);
+  var sqlConditions = [];
+  filters.forEach(function (filter) {
+    if (checkIsFilterGroup(filter)) {
+      var subFilters = filter.filters,
+        sub_filter_conjunction = filter.filter_conjunction;
+      var subSqlConditions = subFilters.map(function (subFilter) {
+        var filterColumn = getTableColumnByKey(table, subFilter.column_key);
+        return getSqlConditionByFilter(filterColumn, subFilter, patchedUsername, patchedUserId, patchedUserDepartmentIdsMap);
+      });
+      var subSqlConditionsLength = subSqlConditions.length;
+      if (subSqlConditionsLength > 0) {
+        var subSqlConditionsString = subSqlConditions.length === 1 ? subSqlConditions + '' : "(".concat(subSqlConditions.join(' ' + sub_filter_conjunction + ' '), ")");
+        sqlConditions.push(subSqlConditionsString);
+      }
+    } else {
+      var column_key = filter.column_key;
+      var filterColumn = columns.find(function (column) {
+        return column.key === column_key;
+      });
+      sqlConditions.push(getSqlConditionByFilter(filterColumn, filter, patchedUsername, patchedUserId, patchedUserDepartmentIdsMap));
+    }
+  });
+  return sqlConditions;
+};
+var checkFilter = function checkFilter(filter, columns) {
+  var _ValidateFilter$valid = ValidateFilter.validate(filter, columns),
+    error_message = _ValidateFilter$valid.error_message;
+  if (error_message) {
+    if (error_message === FILTER_ERR_MSG.INCOMPLETE_FILTER) {
+      return false;
+    }
+    throw new Error(error_message);
+  }
+  return true;
+};
+var validateFilters = function validateFilters(filters, columns) {
+  var validFilters = [];
+  filters.forEach(function (filter) {
+    if (checkIsFilterGroup(filter)) {
+      var subFilters = filter.filters;
+      if (!Array.isArray(subFilters) || subFilters.length === 0) {
+        return;
+      }
+      var validSubFilters = subFilters.filter(function (subFilter) {
+        return checkFilter(subFilter, columns);
+      });
+      if (validSubFilters.length === 0) {
+        return;
+      }
+      validFilters.push(_objectSpread(_objectSpread({}, filter), {}, {
+        filters: validSubFilters
+      }));
+    } else {
+      if (!checkFilter(filter, columns)) {
+        return;
+      }
+      validFilters.push(filter);
+    }
+  });
+  return validFilters;
+};
+var filter2SqlCondition = function filter2SqlCondition(table, view, username, userId, userDepartmentIdsMap) {
   var columns = table.columns;
   var filter_conjunction = view.filter_conjunction,
     filters = view.filters;
   if (typeof filter_conjunction !== 'string' || !Array.isArray(filters) || filters.length === 0) {
     return '';
   }
+  var validFilters = [];
+  try {
+    validFilters = validateFilters(filters, columns);
+  } catch (err) {
+    throw new Error(err.message);
+  }
+  if (validFilters.length === 0) {
+    return '';
+  }
 
   // 1. add WHERE condition
   var filterHeader = 'WHERE ';
-  var stringList = filters.map(function (filterItem) {
-    var _ValidateFilter$valid = ValidateFilter.validate(filterItem, columns),
-      error_message = _ValidateFilter$valid.error_message;
-    if (error_message) {
-      if (error_message === FILTER_ERR_MSG.INCOMPLETE_FILTER) {
-        return '';
-      }
-      throw new Error(error_message);
-    }
-    var column_key = filterItem.column_key;
-    var column = getTableColumnByKey(table, column_key);
-    return getSqlConditionByFilter(column, filterItem, patchedUsername, patchedUserId, patchedUserDepartmentIdsMap);
-  });
+  var stringList = getSqlConditionsByFilters(validFilters, table, username, userId, userDepartmentIdsMap);
 
   // 2. filtered '' sql clause
   stringList = stringList.filter(function (item) {
@@ -729,9 +803,14 @@ var filter2SqlCondition = function filter2SqlCondition(table, view, username, us
   // const filterContent = stringList.join(' ' + filter_conjunction + ' ');
   var filterContent = stringList[0];
   for (var i = 1; i < stringList.length; i++) {
-    filterContent += " ".concat(filter_conjunction, " (").concat(stringList[i], ")");
+    var currStr = stringList[i];
+    if (currStr.startsWith('(') && currStr.endsWith(')')) {
+      filterContent += " ".concat(filter_conjunction, " ").concat(stringList[i]);
+    } else {
+      filterContent += " ".concat(filter_conjunction, " (").concat(stringList[i], ")");
+    }
   }
   return filterHeader + filterContent;
 };
 
-export { checkboxSqlCondition, collaboratorSqlCondition, creatorSqlCondition, ctimeSqlCondition, dateSqlCondition, departmentSingleSelectSqlCondition, fileSqlCondition, filter2SqlCondition, formulaSqlCondition, getSqlConditionByFilter, linkSqlCondition, longtextSqlCondition, multipleSelectSqlCondition, numberSqlCondition, singleSelectSqlCondition, textSqlCondition };
+export { arrayColumnCondition, checkboxSqlCondition, collaboratorSqlCondition, creatorSqlCondition, ctimeSqlCondition, dateSqlCondition, departmentMultipleSelectSqlCondition, departmentSingleSelectSqlCondition, fileSqlCondition, filter2SqlCondition, formulaSqlCondition, getSqlConditionByFilter, getSqlConditionsByFilters, linkSqlCondition, longtextSqlCondition, multipleSelectSqlCondition, numberSqlCondition, singleSelectSqlCondition, textSqlCondition };

package/es/color/column-color.js

@@ -1,7 +1,7 @@
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import deepCopy from 'deep-copy';
 import { deleteInvalidFilter, getFormattedFilters } from '../filter/core.js';
-import { filterRows, filterRow } from '../filter/filter-row.js';
+import { filterRows, filterRow as _filterRow } from '../filter/filter-row.js';
 import { ValidateFilter } from '../validate/filter.js';
 import { isNumberColumn } from '../column/number.js';
 import { getRowsByIds } from '../table/row.js';
@@ -327,7 +327,7 @@ var getColumnColors = function getColumnColors(rows, view, table, value) {
           var filter_conjunction = colorRule.filter_conjunction,
             filters = colorRule.filters,
             color = colorRule.color;
-          if (filterRow(row, filter_conjunction, filters, {
+          if (_filterRow(row, filter_conjunction, filters, {
             formulaRow: formulaRow,
             username: username,
             userId: userId,

package/es/color/row-color.js

@@ -6,7 +6,7 @@ import { getColumnOptions } from '../column/option.js';
 import { getGeolocationDisplayString } from '../cell-value-get/geolocation.js';
 import { ValidateFilter } from '../validate/filter.js';
 import { deleteInvalidFilter, getFormattedFilters } from '../filter/core.js';
-import { filterRow } from '../filter/filter-row.js';
+import { filterRow as _filterRow } from '../filter/filter-row.js';
 import { ROW_COLOR_TYPE, ROW_COLOR_FOR_DUPLICATE_VALUES, SUPPORT_CHECKING_DUPLICATE_COLUMNS_TYPES } from '../constants/row-color.js';
 import { CellType } from '../constants/cell-type.js';
 
@@ -177,7 +177,7 @@ var getRowsColorByRules = function getRowsColorByRules(rows, view, table) {
       var color = colorRule.color,
         filter_conjunction = colorRule.filter_conjunction,
         filters = colorRule.filters;
-      if (filterRow(row, filter_conjunction, filters, {
+      if (_filterRow(row, filter_conjunction, filters, {
         formulaRow: formulaRow,
         username: username,
         userId: userId,

package/es/common.js

@@ -42,5 +42,8 @@ var isEmptyObject = function isEmptyObject(obj) {
   }
   return true;
 };
+var hasOwnProperty = function hasOwnProperty(obj, key) {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+};
 
-export { generatorBase64Code, isEmpty, isEmptyObject };
+export { generatorBase64Code, hasOwnProperty, isEmpty, isEmptyObject };

package/es/constants/column.js

@@ -2,7 +2,7 @@ import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import { CellType } from './cell-type.js';
 
 var _COLUMNS_ICON_CONFIG, _SINGLE_CELL_VALUE_CO;
-var COLUMNS_ICON_CONFIG = (_COLUMNS_ICON_CONFIG = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_COLUMNS_ICON_CONFIG, CellType.DEFAULT, 'dtable-font dtable-icon-single-line-text'), CellType.TEXT, 'dtable-font dtable-icon-single-line-text'), CellType.NUMBER, 'dtable-font dtable-icon-number'), CellType.CHECKBOX, 'dtable-font dtable-icon-check-square-solid'), CellType.DATE, 'dtable-font dtable-icon-calendar-alt-solid'), CellType.SINGLE_SELECT, 'dtable-font dtable-icon-single-election'), CellType.LONG_TEXT, 'dtable-font dtable-icon-long-text'), CellType.IMAGE, 'dtable-font dtable-icon-picture'), CellType.FILE, 'dtable-font dtable-icon-file-alt-solid'), CellType.MULTIPLE_SELECT, 'dtable-font dtable-icon-multiple-selection'), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_COLUMNS_ICON_CONFIG, CellType.COLLABORATOR, 'dtable-font dtable-icon-collaborator'), CellType.LINK, 'dtable-font dtable-icon-link-other-record'), CellType.FORMULA, 'dtable-font dtable-icon-formula'), CellType.LINK_FORMULA, 'dtable-font dtable-icon-link-formulas'), CellType.CREATOR, 'dtable-font dtable-icon-creator'), CellType.CTIME, 'dtable-font dtable-icon-creation-time'), CellType.LAST_MODIFIER, 'dtable-font dtable-icon-creator'), CellType.MTIME, 'dtable-font dtable-icon-creation-time'), CellType.GEOLOCATION, 'dtable-font dtable-icon-location'), CellType.AUTO_NUMBER, 'dtable-font dtable-icon-autonumber'), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_COLUMNS_ICON_CONFIG, CellType.URL, 'dtable-font dtable-icon-url'), CellType.EMAIL, 'dtable-font dtable-icon-email'), CellType.DURATION, 'dtable-font dtable-icon-duration'), CellType.BUTTON, 'dtable-font dtable-icon-button'), CellType.RATE, 'dtable-font dtable-icon-rate'), CellType.DIGITAL_SIGN, 'dtable-font dtable-icon-handwritten-signature'), CellType.DEPARTMENT_SINGLE_SELECT, 'dtable-font dtable-icon-department-single-selection'));
+var COLUMNS_ICON_CONFIG = (_COLUMNS_ICON_CONFIG = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_COLUMNS_ICON_CONFIG, CellType.DEFAULT, 'dtable-font dtable-icon-single-line-text'), CellType.TEXT, 'dtable-font dtable-icon-single-line-text'), CellType.STRING, 'dtable-font dtable-icon-single-line-text'), CellType.NUMBER, 'dtable-font dtable-icon-number'), CellType.CHECKBOX, 'dtable-font dtable-icon-check-square-solid'), CellType.DATE, 'dtable-font dtable-icon-calendar-alt-solid'), CellType.SINGLE_SELECT, 'dtable-font dtable-icon-single-election'), CellType.LONG_TEXT, 'dtable-font dtable-icon-long-text'), CellType.IMAGE, 'dtable-font dtable-icon-picture'), CellType.FILE, 'dtable-font dtable-icon-file-alt-solid'), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_COLUMNS_ICON_CONFIG, CellType.MULTIPLE_SELECT, 'dtable-font dtable-icon-multiple-selection'), CellType.COLLABORATOR, 'dtable-font dtable-icon-collaborator'), CellType.LINK, 'dtable-font dtable-icon-link-other-record'), CellType.FORMULA, 'dtable-font dtable-icon-formula'), CellType.LINK_FORMULA, 'dtable-font dtable-icon-link-formulas'), CellType.CREATOR, 'dtable-font dtable-icon-creator'), CellType.CTIME, 'dtable-font dtable-icon-creation-time'), CellType.LAST_MODIFIER, 'dtable-font dtable-icon-creator'), CellType.MTIME, 'dtable-font dtable-icon-creation-time'), CellType.GEOLOCATION, 'dtable-font dtable-icon-location'), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_COLUMNS_ICON_CONFIG, CellType.AUTO_NUMBER, 'dtable-font dtable-icon-autonumber'), CellType.URL, 'dtable-font dtable-icon-url'), CellType.EMAIL, 'dtable-font dtable-icon-email'), CellType.DURATION, 'dtable-font dtable-icon-duration'), CellType.BUTTON, 'dtable-font dtable-icon-button'), CellType.RATE, 'dtable-font dtable-icon-rate'), CellType.DIGITAL_SIGN, 'dtable-font dtable-icon-handwritten-signature'), CellType.DEPARTMENT_SINGLE_SELECT, 'dtable-font dtable-icon-department-single-selection'));
 var COLUMN_OPTIONS = [{
   iconName: 'Basic',
   iconClass: '',

package/es/filter/core.js

@@ -3,12 +3,52 @@ import { ValidateFilter } from '../validate/filter.js';
 import { DateUtils } from '../date.js';
 import { FILTER_ERR_MSG } from '../constants/filter/index.js';
 import { CellType } from '../constants/cell-type.js';
-import { FORMULA_RESULT_TYPE } from '../constants/formula.js';
+import { FORMULA_RESULT_TYPE, FORMULA_COLUMN_TYPES_MAP } from '../constants/formula.js';
+import { hasOwnProperty } from '../common.js';
 import { FILTER_TERM_MODIFIER_TYPE } from '../constants/filter/filter-modifier.js';
 
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var EXACT_DATE_TERM_MODIFIER_TYPES = [FILTER_TERM_MODIFIER_TYPE.TODAY, FILTER_TERM_MODIFIER_TYPE.TOMORROW, FILTER_TERM_MODIFIER_TYPE.YESTERDAY, FILTER_TERM_MODIFIER_TYPE.ONE_WEEK_AGO, FILTER_TERM_MODIFIER_TYPE.ONE_WEEK_FROM_NOW, FILTER_TERM_MODIFIER_TYPE.ONE_MONTH_AGO, FILTER_TERM_MODIFIER_TYPE.ONE_MONTH_FROM_NOW, FILTER_TERM_MODIFIER_TYPE.NUMBER_OF_DAYS_AGO, FILTER_TERM_MODIFIER_TYPE.NUMBER_OF_DAYS_FROM_NOW, FILTER_TERM_MODIFIER_TYPE.EXACT_DATE];
+
+/**
+ * Check if is filter group
+ * @param {object} filter
+ * @returns bool
+ */
+var checkIsFilterGroup = function checkIsFilterGroup(filter) {
+  return hasOwnProperty(filter, 'filters');
+};
+
+/**
+ * Check if is formula/link filter
+ * @param {object} filter
+ * @returns bool
+ */
+var checkIsFormulaFilter = function checkIsFormulaFilter(filter) {
+  var column = filter.column;
+  return FORMULA_COLUMN_TYPES_MAP[column.type] || column.type === CellType.LINK;
+};
+
+/**
+ * Check has contains formula filter
+ * @param {array} filters e.g. [{ column_key, column, ...}]
+ * @returns bool
+ */
+var checkHasFormulaFilter = function checkHasFormulaFilter(filters) {
+  return filters.some(function (filter) {
+    if (checkIsFilterGroup(filter)) {
+      var subFilters = filter.filters;
+      if (!Array.isArray(subFilters) || subFilters.length === 0) {
+        return false;
+      }
+      return subFilters.some(function (subFilter) {
+        return checkIsFormulaFilter(subFilter);
+      });
+    }
+    return checkIsFormulaFilter(filter);
+  });
+};
 var isCurrentUserDepartment = function isCurrentUserDepartment(departmentId, userDepartmentIdsMap) {
   var _ref = userDepartmentIdsMap || {},
     current_user_department_ids = _ref.current_user_department_ids;
@@ -24,9 +64,24 @@ var isSpecificDepartment = function isSpecificDepartment(departmentId, filterTer
   return filterTerm.includes(departmentId);
 };
 
+/**
+ * Check if the filter is available to display
+ * @param {object} filter
+ * @param {array} columns
+ * @returns bool
+ */
+var checkIsAvailableFilter = function checkIsAvailableFilter(filter, columns) {
+  var _ValidateFilter$valid = ValidateFilter.validate(filter, columns),
+    error_message = _ValidateFilter$valid.error_message;
+  if (error_message && error_message === FILTER_ERR_MSG.INCOMPLETE_FILTER) {
+    return false;
+  }
+  return true;
+};
+
 /**
  * Get filters which excludes incomplete
- * @param {array} filters e.g. [{ column_key, filter_predicate, ... }]
+ * @param {array} filters e.g. [{ column_key, filter_predicate, ... }, { filters: [...]}]
  * @param {array} columns
  * @returns valid filters, array
  */
@@ -34,11 +89,28 @@ var getValidFilters = function getValidFilters(filters, columns) {
   if (!Array.isArray(filters) || !Array.isArray(columns)) {
     return [];
   }
-  return filters.filter(function (filter) {
-    var _ValidateFilter$valid = ValidateFilter.validate(filter, columns),
-      error_message = _ValidateFilter$valid.error_message;
-    return !error_message || error_message !== FILTER_ERR_MSG.INCOMPLETE_FILTER;
+  var availableFilters = [];
+  filters.forEach(function (filter) {
+    if (checkIsFilterGroup(filter)) {
+      var subFilters = filter.filters;
+      var availableSubFilters = [];
+      if (Array.isArray(subFilters) && subFilters.length > 0) {
+        availableSubFilters = subFilters.filter(function (subFilter) {
+          return checkIsAvailableFilter(subFilter, columns);
+        });
+      }
+
+      // just keep the filter group which has valid sub-filters
+      if (availableSubFilters.length > 0) {
+        availableFilters.push(_objectSpread(_objectSpread({}, filter), {}, {
+          filters: availableSubFilters
+        }));
+      }
+    } else if (checkIsAvailableFilter(filter, columns)) {
+      availableFilters.push(filter);
+    }
   });
+  return availableFilters;
 };
 
 /**
@@ -300,9 +372,37 @@ var _getFormattedFilter = function getFormattedFilter(filter, column) {
  */
 var getFormattedFilters = function getFormattedFilters(filters) {
   return filters.map(function (filter) {
+    if (checkIsFilterGroup(filter)) {
+      var subFilters = filter.filters;
+      var formattedSubFilters = [];
+      if (Array.isArray(subFilters) && subFilters.length > 0) {
+        formattedSubFilters = subFilters.map(function (subFilter) {
+          return _getFormattedFilter(subFilter, subFilter.column);
+        });
+      }
+      return _objectSpread(_objectSpread({}, filter), {}, {
+        filters: formattedSubFilters
+      });
+    }
     return _getFormattedFilter(filter, filter.column);
   });
 };
+var checkFilter = function checkFilter(filter, columns) {
+  var _ValidateFilter$valid2 = ValidateFilter.validate(filter, columns),
+    error_message = _ValidateFilter$valid2.error_message;
+  if (error_message) {
+    if (error_message === FILTER_ERR_MSG.INCOMPLETE_FILTER) {
+      return null;
+    }
+    throw new Error(error_message);
+  }
+  var newFilter = _objectSpread({}, filter);
+  var column_key = filter.column_key;
+  newFilter.column = columns.find(function (column) {
+    return column.key === column_key;
+  });
+  return newFilter;
+};
 
 /**
  * Get filters without error messages and formatted with filter column
@@ -316,24 +416,99 @@ var deleteInvalidFilter = function deleteInvalidFilter(filters, columns) {
   }
   var cleanFilters = [];
   filters.forEach(function (filter) {
-    var column_key = filter.column_key;
-    var _ValidateFilter$valid2 = ValidateFilter.validate(filter, columns),
-      error_message = _ValidateFilter$valid2.error_message;
-    if (error_message) {
-      if (error_message !== FILTER_ERR_MSG.INCOMPLETE_FILTER) {
-        throw new Error(error_message);
+    if (checkIsFilterGroup(filter)) {
+      var subFilters = filter.filters;
+      if (Array.isArray(subFilters) && subFilters.length > 0) {
+        var cleanSubFilters = [];
+        subFilters.forEach(function (subFilter) {
+          var newSubFilter = checkFilter(subFilter, columns);
+          if (newSubFilter) {
+            cleanSubFilters.push(newSubFilter);
+          }
+        });
+
+        // just keep the filter group which has valid sub-filters
+        if (cleanSubFilters.length > 0) {
+          cleanFilters.push(_objectSpread(_objectSpread({}, filter), {}, {
+            filters: cleanSubFilters
+          }));
+        }
       }
     } else {
-      var filterColumn = columns.find(function (column) {
-        return column.key === column_key;
-      });
-      var newFilter = _objectSpread(_objectSpread({}, filter), {}, {
-        column: filterColumn
-      });
-      cleanFilters.push(newFilter);
+      var newFilter = checkFilter(filter, columns);
+      if (newFilter) {
+        cleanFilters.push(newFilter);
+      }
     }
   });
   return cleanFilters;
 };
 
-export { deleteInvalidFilter, _getFormattedFilter as getFormattedFilter, getFormattedFilterOtherDate, getFormattedFilters, getValidFilters, getValidFiltersWithoutError, isCurrentUserDepartment, isCurrentUserDepartmentAndSub, isSpecificDepartment, otherDate };
+/**
+ * Categorize filters
+ * @param {array} filters
+ * @returns {object} { generalFilters, formulaFilters, filterGroups }
+ */
+var getClassifiedFilters = function getClassifiedFilters(filters) {
+  var generalFilters = [];
+  var formulaFilters = [];
+  var filterGroups = [];
+  filters.forEach(function (filter) {
+    if (checkIsFilterGroup(filter)) {
+      filterGroups.push(filter);
+    } else if (checkIsFormulaFilter(filter)) {
+      formulaFilters.push(filter);
+    } else {
+      generalFilters.push(filter);
+    }
+  });
+  return {
+    generalFilters: generalFilters,
+    formulaFilters: formulaFilters,
+    filterGroups: filterGroups
+  };
+};
+
+/**
+ * Check if is related filter of given columns
+ * @param {object} filter
+ * @param {object} updatedColumnKeyMap e.g. { [column.key]: true }
+ * @returns bool
+ */
+var checkIsRelatedFilter = function checkIsRelatedFilter(filter, columnKeyMap) {
+  var column_key = filter.column_key;
+  if (!column_key) {
+    return false;
+  }
+  return !!columnKeyMap[column_key];
+};
+
+/**
+ * Check if is related filter group of given columns
+ * @param {object} filterGroup
+ * @param {object} columnKeyMap
+ * @returns bool
+ */
+var checkIsRelatedFilterGroup = function checkIsRelatedFilterGroup(filterGroup, columnKeyMap) {
+  var filters = filterGroup.filters;
+  if (!Array.isArray(filters) || filters.length === 0) {
+    return false;
+  }
+  return filters.some(function (filter) {
+    return checkIsRelatedFilter(filter, columnKeyMap);
+  });
+};
+
+/**
+ * Check if has related filters of given columns
+ * @param {array} filters
+ * @param {object} updatedColumnKeyMap e.g. { [column.key]: true }
+ * @returns bool
+ */
+var hasRelatedFilters = function hasRelatedFilters(filters, columnKeyMap) {
+  return filters.some(function (filter) {
+    return checkIsFilterGroup(filter) ? checkIsRelatedFilterGroup(filter, columnKeyMap) : checkIsRelatedFilter(filter, columnKeyMap);
+  });
+};
+
+export { checkHasFormulaFilter, checkIsAvailableFilter, checkIsFilterGroup, checkIsFormulaFilter, checkIsRelatedFilter, checkIsRelatedFilterGroup, deleteInvalidFilter, getClassifiedFilters, _getFormattedFilter as getFormattedFilter, getFormattedFilterOtherDate, getFormattedFilters, getValidFilters, getValidFiltersWithoutError, hasRelatedFilters, isCurrentUserDepartment, isCurrentUserDepartmentAndSub, isSpecificDepartment, otherDate };

package/es/filter/filter-row.js

@@ -1,4 +1,4 @@
-import { getFormattedFilters, deleteInvalidFilter } from './core.js';
+import { checkIsFilterGroup, getFormattedFilters, deleteInvalidFilter } from './core.js';
 import { checkboxFilter } from './filter-column/checkbox.js';
 import { collaboratorFilter } from './filter-column/collaborator.js';
 import { creatorFilter } from './filter-column/creator.js';
@@ -137,7 +137,7 @@ var getFilterResult = function getFilterResult(row, filter, _ref) {
  * @param {object} userDepartmentIdsMap e.g. { current_user_department_ids: [8, 10], current_user_department_and_sub_ids: [8, 10, 12, 34] }
  * @returns filter result, bool
  */
-var filterRow = function filterRow(row, filterConjunction, filters) {
+var _filterRow = function filterRow(row, filterConjunction, filters) {
   var _ref2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {},
     formulaRow = _ref2.formulaRow,
     _ref2$username = _ref2.username,
@@ -147,6 +147,14 @@ var filterRow = function filterRow(row, filterConjunction, filters) {
     userDepartmentIdsMap = _ref2$userDepartmentI === void 0 ? {} : _ref2$userDepartmentI;
   if (filterConjunction === FILTER_CONJUNCTION_TYPE.AND) {
     return filters.every(function (filter) {
+      if (checkIsFilterGroup(filter)) {
+        return _filterRow(row, filter.filter_conjunction, filter.filters, {
+          formulaRow: formulaRow,
+          username: username,
+          userId: userId,
+          userDepartmentIdsMap: userDepartmentIdsMap
+        });
+      }
       return getFilterResult(row, filter, {
         formulaRow: formulaRow,
         username: username,
@@ -157,6 +165,14 @@ var filterRow = function filterRow(row, filterConjunction, filters) {
   }
   if (filterConjunction === FILTER_CONJUNCTION_TYPE.OR) {
     return filters.some(function (filter) {
+      if (checkIsFilterGroup(filter)) {
+        return _filterRow(row, filter.filter_conjunction, filter.filters, {
+          formulaRow: formulaRow,
+          username: username,
+          userId: userId,
+          userDepartmentIdsMap: userDepartmentIdsMap
+        });
+      }
       return getFilterResult(row, filter, {
         formulaRow: formulaRow,
         username: username,
@@ -189,7 +205,7 @@ var filterRows = function filterRows(filterConjunction, filters, rows, _ref3) {
   rows.forEach(function (row) {
     var rowId = row._id;
     var formulaRow = formulaRows ? formulaRows[rowId] : null;
-    if (filterRow(row, filterConjunction, formattedFilters, {
+    if (_filterRow(row, filterConjunction, formattedFilters, {
       formulaRow: formulaRow,
       username: username,
       userId: userId,
@@ -253,4 +269,4 @@ var getFilteredRowsWithoutFormulaCalculation = function getFilteredRowsWithoutFo
   };
 };
 
-export { filterRow, filterRows, getFilteredRowsWithoutFormulaCalculation };
+export { _filterRow as filterRow, filterRows, getFilteredRowsWithoutFormulaCalculation };

package/es/index.js

@@ -57,7 +57,7 @@ export { searchCollaborators } from './search.js';
 export { ValidateFilter } from './validate/filter.js';
 export { isValidEmail } from './validate/email.js';
 export { isValidPosition } from './validate/geolocation.js';
-export { deleteInvalidFilter, getFormattedFilter, getFormattedFilterOtherDate, getFormattedFilters, getValidFilters, getValidFiltersWithoutError, otherDate } from './filter/core.js';
+export { checkHasFormulaFilter, checkIsFilterGroup, checkIsRelatedFilter, deleteInvalidFilter, getClassifiedFilters, getFormattedFilter, getFormattedFilterOtherDate, getFormattedFilters, getValidFilters, getValidFiltersWithoutError, hasRelatedFilters, otherDate } from './filter/core.js';
 export { checkboxFilter } from './filter/filter-column/checkbox.js';
 export { collaboratorFilter } from './filter/filter-column/collaborator.js';
 export { creatorFilter } from './filter/filter-column/creator.js';

package/es/link/core.js

@@ -61,23 +61,30 @@ var getLinkedTableID = function getLinkedTableID(currentTableID, tableID, otherT
 /**
  * Get linked rows ids by the given row id
  * @param {array} links e.g. [ { _id, table1_id, table2_id, table1_table2_map, table2_table1_map, ... }, ... ]
- * @param {string} linkId
- * @param {string} table1Id
- * @param {string} table2Id
- * @param {string} rowId
+ * @param {string} link_id
+ * @param {string} table1_id
+ * @param {string} table2_id
+ * @param {string} row_id
+ * @param {boolean} is_linked_back, determine the self-link column which use 'table1_table2_map'
  * @returns linked rows ids, array
  */
-var getLinkCellValue = function getLinkCellValue(links, linkId, table1Id, table2Id, rowId) {
-  if (!Array.isArray(links) || links.length === 0 || !table1Id || !table2Id || !rowId) return [];
-  var linkBetween2Tables = getLinkById(links, linkId);
+var getLinkCellValue = function getLinkCellValue(_ref) {
+  var links = _ref.links,
+    link_id = _ref.link_id,
+    table1_id = _ref.table1_id,
+    table2_id = _ref.table2_id,
+    row_id = _ref.row_id,
+    is_linked_back = _ref.is_linked_back;
+  if (!Array.isArray(links) || links.length === 0 || !table1_id || !table2_id || !row_id) return [];
+  var linkBetween2Tables = getLinkById(links, link_id);
   if (!linkBetween2Tables) return [];
   var linkMap = {};
-  if (table1Id === table2Id) {
-    linkMap = linkBetween2Tables.table2_table1_map;
+  if (table1_id === table2_id) {
+    linkMap = is_linked_back ? linkBetween2Tables.table1_table2_map : linkBetween2Tables.table2_table1_map;
   } else {
-    linkMap = linkBetween2Tables.table1_id === table1Id ? linkBetween2Tables.table1_table2_map : linkBetween2Tables.table2_table1_map;
+    linkMap = linkBetween2Tables.table1_id === table1_id ? linkBetween2Tables.table1_table2_map : linkBetween2Tables.table2_table1_map;
   }
-  var linkedRowIds = linkMap[rowId];
+  var linkedRowIds = linkMap[row_id];
   if (!linkedRowIds) {
     return [];
   }
@@ -94,21 +101,29 @@ var getTableLinkRows = function getTableLinkRows(operateRows, table, value) {
   linkColumns.forEach(function (column) {
     var key = column.key,
       data = column.data;
-    var _ref = data || {},
-      link_id = _ref.link_id,
-      table_id = _ref.table_id,
-      other_table_id = _ref.other_table_id;
+    var _ref2 = data || {},
+      link_id = _ref2.link_id,
+      table_id = _ref2.table_id,
+      other_table_id = _ref2.other_table_id,
+      is_linked_back = _ref2.is_linked_back;
     var linkedTableId = currentTableId === table_id ? other_table_id : table_id;
     var linkedTable = getTableById(tables, linkedTableId);
     rows.forEach(function (row) {
-      var rowId = row._id;
-      var linkedRowIds = linkedTable && getLinkCellValue(links, link_id, currentTableId, linkedTableId, rowId) || [];
+      var row_id = row._id;
+      var linkedRowIds = linkedTable && getLinkCellValue({
+        links: links,
+        link_id: link_id,
+        table1_id: currentTableId,
+        table2_id: linkedTableId,
+        row_id: row_id,
+        is_linked_back: is_linked_back
+      }) || [];
 
       // Handle the linked row has been deleted, but link still exists
       linkedRowIds = linkedRowIds.filter(function (linkedRowId) {
         return linkedTable.id_row_map[linkedRowId];
       });
-      linkRows[rowId] = _objectSpread(_objectSpread({}, linkRows[rowId]), {}, _defineProperty({}, key, linkedRowIds));
+      linkRows[row_id] = _objectSpread(_objectSpread({}, linkRows[row_id]), {}, _defineProperty({}, key, linkedRowIds));
     });
   });
   return linkRows;