dtable-utils 0.0.3-beta.1 → 0.0.4-beta.1

package/lib/filter/filter-row.js

@@ -117,6 +117,17 @@ var getFilterResult = function getFilterResult(row, filter, _ref) {
       }
   }
 };
+
+/**
+ * Filter row
+ * @param {object} row e.g. { _id, .... }
+ * @param {string} filterConjunction e.g. 'And' | 'Or'
+ * @param {array} filters e.g. [{ column_key, filter_predicate, ... }, ...]
+ * @param {object} formulaRow
+ * @param {string} username
+ * @param {string} userId
+ * @returns filter result, bool
+ */
 var filterRow = function filterRow(row, filterConjunction, filters) {
   var _ref2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {},
     _ref2$formulaRow = _ref2.formulaRow,
@@ -144,6 +155,17 @@ var filterRow = function filterRow(row, filterConjunction, filters) {
   }
   return false;
 };
+
+/**
+ * Filter rows
+ * @param {string} filterConjunction e.g. 'And' | 'Or'
+ * @param {array} filters e.g. [{ column_key, filter_predicate, ... }, ...]
+ * @param {array} rows e.g. [{ _id, .... }, ...]
+ * @param {object} formulaRows
+ * @param {string} username
+ * @param {userId} username
+ * @returns filtered rows ids, array
+ */
 var filterRows = function filterRows(filterConjunction, filters, rows, _ref3) {
   var formulaRows = _ref3.formulaRows,
     username = _ref3.username,
@@ -163,6 +185,19 @@ var filterRows = function filterRows(filterConjunction, filters, rows, _ref3) {
   });
   return filteredRows;
 };
+
+/**
+ * Filter rows without formula calculation
+ * The "formulaRows" need to be provided if you want to filter formula, link columns etc.
+ * @param {string} filterConjunction e.g. 'And' | 'Or'
+ * @param {array} filters e.g. [{ column_key, filter_predicate, ... }, ...]
+ * @param {array} rows e.g. [{ _id, .... }, ...]
+ * @param {object} table e.g. { columns, ... }
+ * @param {object} formulaRows
+ * @param {string} username
+ * @param {userId} username
+ * @returns filtered rows: row_ids and error message: error_message, object
+ */
 var getFilteredRowsWithoutFormulaCalculation = function getFilteredRowsWithoutFormulaCalculation(filterConjunction, filters, rows, table) {
   var _ref4 = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
     _ref4$formulaRows = _ref4.formulaRows,

package/lib/group/core.js

@@ -18,10 +18,10 @@ function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (O
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty__default["default"](target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 
 /**
- * check is valid groupby
- * @param {object} groupby { column_key: '', count_type: '', sort_type: '' }
+ * Check is valid groupby
+ * @param {object} groupby e.g. { column_key, count_type, sort_type, ... }
  * @param {array} columns
- * @returns boolean
+ * @returns bool
  */
 var isValidGroupby = function isValidGroupby(groupby, columns) {
   if (!groupby || !Array.isArray(columns)) return false;
@@ -36,10 +36,10 @@ var isValidGroupby = function isValidGroupby(groupby, columns) {
 };
 
 /**
- * get valid groupbys
- * @param {array} groupbys
+ * Get valid groupbys
+ * @param {array} groupbys e.g. [{ column_key, count_type, ... }, ...]
  * @param {array} columns
- * @returns array
+ * @returns valid groupbys, array
  */
 var getValidGroupbys = function getValidGroupbys(groupbys, columns) {
   if (!Array.isArray(groupbys) || !Array.isArray(columns)) {
@@ -49,6 +49,15 @@ var getValidGroupbys = function getValidGroupbys(groupbys, columns) {
     return isValidGroupby(groupby, columns);
   });
 };
+
+/**
+ * Get valid and formatted groupbys
+ * @param {array} groupbys e.g. [{ column_key, count_type, ... }, ...]
+ * @param {array} columns
+ * @param {object} currentTable e.g. { _id, ... }
+ * @param {object} value e.g. { tables, collaborators }
+ * @returns valid and formatted groupbys
+ */
 var deleteInvalidGroupby = function deleteInvalidGroupby(groupbys, columns, currentTable, value) {
   var validGroupbys = getValidGroupbys(groupbys, columns);
   var cleanGroupbys = [];

package/lib/group/group-row.js

@@ -320,6 +320,17 @@ var groupRowsWithMultipleGroupbys = function groupRowsWithMultipleGroupbys(group
   groups = getSortedGroups(groups, validGroupbys, value, 0);
   return groups;
 };
+
+/**
+ * Group table rows
+ * @param {array} groupbys e.g. [{ column_key, count_type, column, ... }, ...]
+ * @param {array} rows e.g. [{ _id, ... }, ...]
+ * @param {object} formulaRows computed value of formula, link-formula, link etc.
+ * @param {object} value e.g. { collaborators, ... }
+ * @returns groups: [{
+ *    cell_value, original_cell_value, column_key,
+      row_ids, subgroups, summaries, ...}, ...], array
+ */
 var groupTableRows = function groupTableRows(groupbys, rows, formulaRows, value) {
   if (groupbys.length === 0) {
     return [];
@@ -356,13 +367,38 @@ var groupTableRows = function groupTableRows(groupbys, rows, formulaRows, value)
   groups = getSortedGroups(groups, groupbys, value, 0);
   return groups;
 };
-var groupViewRows = function groupViewRows(groupbys, table, rows, formulaRows, value) {
-  if (rows.length === 0) {
+
+/**
+ * Group view rows
+ * @param {array} groupbys e.g. [{ column_key, count_type, column, ... }, ...]
+ * @param {object} table e.g. { id_row_map, ... }
+ * @param {array} rowsIds e.g. [ row._id, ...]
+ * @param {object} formulaRows computed value of formula, link-formula, link etc.
+ * @param {object} value e.g. { collaborators, ... }
+ * @returns groups: [{
+ *    cell_value, original_cell_value, column_key,
+      row_ids, subgroups, summaries, ...}, ...], array
+ */
+var groupViewRows = function groupViewRows(groupbys, table, rowsIds, formulaRows, value) {
+  if (rowsIds.length === 0) {
     return [];
   }
-  var rowsData = row.getRowsByIds(table, rows);
+  var rowsData = row.getRowsByIds(table, rowsIds);
   return groupTableRows(groupbys, rowsData, formulaRows, value);
 };
+
+/**
+ * Group rows
+ * The "formulaRows" must be supplied if you want group rows by formula/link-formula/link columns
+ * @param {array} groupbys e.g. [{ column_key, count_type, ... }, ...]
+ * @param {array} rows e.g. table rows: [{ _id, ... }, ...] | view rows: [ row._id, ...]
+ * @param {object} table e.g. { id_row_map, columns, ... }
+ * @param {object} value e.g. { collaborators, ... }
+ * @param {object} formulaRows computed value of formula, link-formula, link etc.
+ * @returns groups: [{
+ *    cell_value, original_cell_value, column_key,
+      row_ids, subgroups, summaries, ...}, ...], array
+ */
 var getGroupedRowsWithoutFormulaCalculation = function getGroupedRowsWithoutFormulaCalculation(groupbys, rows, table, value) {
   var _ref3 = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {},
     _ref3$formulaRows = _ref3.formulaRows,

package/lib/index.js

@@ -14,14 +14,15 @@ var reg = require('./constants/reg.js');
 var color = require('./constants/color.js');
 var gridHeader = require('./constants/grid-header.js');
 var common = require('./common.js');
-var index$1 = require('./table/index.js');
-var core = require('./row/core.js');
-var color$1 = require('./row/color.js');
-var core$1 = require('./view/core.js');
+var core = require('./table/core.js');
+var column$1 = require('./table/column.js');
+var row = require('./table/row.js');
+var core$1 = require('./row/core.js');
+var core$2 = require('./view/core.js');
 var summaries = require('./view/summaries.js');
 var formula$1 = require('./view/formula.js');
 var group$1 = require('./view/group.js');
-var core$2 = require('./link/core.js');
+var core$3 = require('./link/core.js');
 var date = require('./cell-value-get/date.js');
 var duration = require('./cell-value-get/duration.js');
 var number = require('./cell-value-get/number.js');
@@ -37,13 +38,12 @@ var date$1 = require('./cell-value-set/date.js');
 var option$1 = require('./column/option.js');
 var date$2 = require('./column/date.js');
 var number$2 = require('./column/number.js');
-var color$2 = require('./column/color.js');
 var date$3 = require('./date.js');
 var number$3 = require('./number.js');
 var filter = require('./validate/filter.js');
 var email = require('./validate/email.js');
 var geolocation$1 = require('./validate/geolocation.js');
-var core$3 = require('./filter/core.js');
+var core$4 = require('./filter/core.js');
 var checkbox = require('./filter/filter-column/checkbox.js');
 var collaborator$1 = require('./filter/filter-column/collaborator.js');
 var creator = require('./filter/filter-column/creator.js');
@@ -59,7 +59,7 @@ var number$4 = require('./filter/filter-column/number.js');
 var singleSelect = require('./filter/filter-column/single-select.js');
 var link = require('./filter/filter-column/link.js');
 var filterRow = require('./filter/filter-row.js');
-var core$4 = require('./sort/core.js');
+var core$5 = require('./sort/core.js');
 var checkbox$1 = require('./sort/sort-column/checkbox.js');
 var collaborator$2 = require('./sort/sort-column/collaborator.js');
 var date$5 = require('./sort/sort-column/date.js');
@@ -71,15 +71,15 @@ var number$5 = require('./sort/sort-column/number.js');
 var singleSelect$1 = require('./sort/sort-column/single-select.js');
 var text$1 = require('./sort/sort-column/text.js');
 var sortRow = require('./sort/sort-row.js');
-var core$5 = require('./group/core.js');
+var core$6 = require('./group/core.js');
 var groupRow = require('./group/group-row.js');
 var gradientColor = require('./color/gradient-color.js');
+var columnColor = require('./color/column-color.js');
+var rowColor = require('./color/row-color.js');
 var filterColumnOptions = require('./constants/filter/filter-column-options.js');
 var filterModifier = require('./constants/filter/filter-modifier.js');
 var filterPredicate = require('./constants/filter/filter-predicate.js');
 var filterIsWithin = require('./constants/filter/filter-is-within.js');
-var column$1 = require('./table/column.js');
-var row = require('./table/row.js');
 
 
 
@@ -105,6 +105,7 @@ exports.SINGLE_CELL_VALUE_COLUMN_TYPE_MAP = column.SINGLE_CELL_VALUE_COLUMN_TYPE
 exports.UTC_FORMAT_DEFAULT = column.UTC_FORMAT_DEFAULT;
 exports.FILTER_CONJUNCTION_TYPE = index.FILTER_CONJUNCTION_TYPE;
 exports.FILTER_ERR_MSG = index.FILTER_ERR_MSG;
+exports.DISPLAY_INTERNAL_ERRORS = formula.DISPLAY_INTERNAL_ERRORS;
 exports.FORMULA_COLUMN_TYPES_MAP = formula.FORMULA_COLUMN_TYPES_MAP;
 exports.FORMULA_RESULT_TYPE = formula.FORMULA_RESULT_TYPE;
 exports.HIGHLIGHT_COLORS = selectOption.HIGHLIGHT_COLORS;
@@ -126,16 +127,20 @@ exports.COLOR_GRADATION_OPTIONS = color.COLOR_GRADATION_OPTIONS;
 exports.HEADER_HEIGHT_TYPE = gridHeader.HEADER_HEIGHT_TYPE;
 exports.generatorBase64Code = common.generatorBase64Code;
 exports.isEmpty = common.isEmpty;
-exports.getTableById = index$1.getTableById;
-exports.convertRow = core.convertRow;
-exports.isTableRows = core.isTableRows;
-exports.RowColorUtils = color$1["default"];
-exports.getLinkColumnsUsedInFilters = core$1.getLinkColumnsUsedInFilters;
-exports.getViewById = core$1.getViewById;
-exports.isDefaultView = core$1.isDefaultView;
-exports.isFilterView = core$1.isFilterView;
-exports.isGroupView = core$1.isGroupView;
-exports.isSortView = core$1.isSortView;
+exports.isEmptyObject = common.isEmptyObject;
+exports.getTableById = core.getTableById;
+exports.getTableColumnByKey = column$1.getTableColumnByKey;
+exports.getTableColumnByName = column$1.getTableColumnByName;
+exports.getRowById = row.getRowById;
+exports.getRowsByIds = row.getRowsByIds;
+exports.convertRow = core$1.convertRow;
+exports.isTableRows = core$1.isTableRows;
+exports.getLinkColumnsUsedInFilters = core$2.getLinkColumnsUsedInFilters;
+exports.getViewById = core$2.getViewById;
+exports.isDefaultView = core$2.isDefaultView;
+exports.isFilterView = core$2.isFilterView;
+exports.isGroupView = core$2.isGroupView;
+exports.isSortView = core$2.isSortView;
 exports.getSummaries = summaries.getSummaries;
 exports.getSummariesWithSubgroups = summaries.getSummariesWithSubgroups;
 exports.updateGroupSummaries = summaries.updateGroupSummaries;
@@ -144,11 +149,11 @@ exports.getSortedFormulaColumns = formula$1.getSortedFormulaColumns;
 exports.getSortedFormulaColumnsContainLinks = formula$1.getSortedFormulaColumnsContainLinks;
 exports.transLink2LinkFormula = formula$1.transLink2LinkFormula;
 exports.getGroupByPath = group$1.getGroupByPath;
-exports.getLinkById = core$2.getLinkById;
-exports.getLinkCellValue = core$2.getLinkCellValue;
-exports.getLinkTableID = core$2.getLinkTableID;
-exports.getLinkedTableID = core$2.getLinkedTableID;
-exports.isValidLink = core$2.isValidLink;
+exports.getLinkById = core$3.getLinkById;
+exports.getLinkCellValue = core$3.getLinkCellValue;
+exports.getLinkTableID = core$3.getLinkTableID;
+exports.getLinkedTableID = core$3.getLinkedTableID;
+exports.isValidLink = core$3.isValidLink;
 exports.getDateDisplayString = date.getDateDisplayString;
 exports.getDurationDisplayString = duration.getDurationDisplayString;
 exports.getNumberDisplayString = number.getNumberDisplayString;
@@ -181,20 +186,19 @@ exports.getColumnOptions = option$1.getColumnOptions;
 exports.isDateColumn = date$2.isDateColumn;
 exports.isNumberColumn = number$2.isNumberColumn;
 exports.isNumericColumn = number$2.isNumericColumn;
-exports.ColumnColorUtils = color$2["default"];
 exports.DateUtils = date$3.DateUtils;
 exports.isNumber = number$3.isNumber;
 exports.isNumberEqual = number$3.isNumberEqual;
 exports.ValidateFilter = filter.ValidateFilter;
 exports.isValidEmail = email.isValidEmail;
 exports.isValidPosition = geolocation$1.isValidPosition;
-exports.deleteInvalidFilter = core$3.deleteInvalidFilter;
-exports.getFormattedFilter = core$3.getFormattedFilter;
-exports.getFormattedFilterOtherDate = core$3.getFormattedFilterOtherDate;
-exports.getFormattedFilters = core$3.getFormattedFilters;
-exports.getValidFilters = core$3.getValidFilters;
-exports.getValidFiltersWithoutError = core$3.getValidFiltersWithoutError;
-exports.otherDate = core$3.otherDate;
+exports.deleteInvalidFilter = core$4.deleteInvalidFilter;
+exports.getFormattedFilter = core$4.getFormattedFilter;
+exports.getFormattedFilterOtherDate = core$4.getFormattedFilterOtherDate;
+exports.getFormattedFilters = core$4.getFormattedFilters;
+exports.getValidFilters = core$4.getValidFilters;
+exports.getValidFiltersWithoutError = core$4.getValidFiltersWithoutError;
+exports.otherDate = core$4.otherDate;
 exports.checkboxFilter = checkbox.checkboxFilter;
 exports.collaboratorFilter = collaborator$1.collaboratorFilter;
 exports.creatorFilter = creator.creatorFilter;
@@ -212,30 +216,32 @@ exports.linkFilter = link.linkFilter;
 exports.filterRow = filterRow.filterRow;
 exports.filterRows = filterRow.filterRows;
 exports.getFilteredRowsWithoutFormulaCalculation = filterRow.getFilteredRowsWithoutFormulaCalculation;
-exports.getValidSorts = core$4.getValidSorts;
-exports.isValidSort = core$4.isValidSort;
+exports.deleteInvalidSort = core$5.deleteInvalidSort;
+exports.getMultipleIndexesOrderbyOptions = core$5.getMultipleIndexesOrderbyOptions;
+exports.getValidSorts = core$5.getValidSorts;
+exports.isValidSort = core$5.isValidSort;
 exports.sortCheckbox = checkbox$1.sortCheckbox;
 exports.sortCollaborator = collaborator$2.sortCollaborator;
 exports.sortDate = date$5.sortDate;
 exports.sortByArrayType = array.sortByArrayType;
 exports.sortFormula = formula$3.sortFormula;
 exports.sortLink = link$1.sortLink;
-exports.getMultipleIndexesOrderbyOptions = multipleSelect$1.getMultipleIndexesOrderbyOptions;
 exports.sortMultipleSelect = multipleSelect$1.sortMultipleSelect;
 exports.sortNumber = number$5.sortNumber;
 exports.sortSingleSelect = singleSelect$1.sortSingleSelect;
 exports.compareString = text$1.compareString;
 exports.sortText = text$1.sortText;
-exports.deleteInvalidSort = sortRow.deleteInvalidSort;
 exports.sortRowsWithMultiSorts = sortRow.sortRowsWithMultiSorts;
 exports.sortTableRows = sortRow.sortTableRows;
-exports.deleteInvalidGroupby = core$5.deleteInvalidGroupby;
-exports.getValidGroupbys = core$5.getValidGroupbys;
-exports.isValidGroupby = core$5.isValidGroupby;
+exports.deleteInvalidGroupby = core$6.deleteInvalidGroupby;
+exports.getValidGroupbys = core$6.getValidGroupbys;
+exports.isValidGroupby = core$6.isValidGroupby;
 exports.getGroupedRowsWithoutFormulaCalculation = groupRow.getGroupedRowsWithoutFormulaCalculation;
 exports.groupTableRows = groupRow.groupTableRows;
 exports.groupViewRows = groupRow.groupViewRows;
 exports.GradientColorUtils = gradientColor["default"];
+exports.ColumnColorUtils = columnColor["default"];
+exports.RowColorUtils = rowColor["default"];
 exports.FILTER_COLUMN_OPTIONS = filterColumnOptions.FILTER_COLUMN_OPTIONS;
 exports.FILTER_TERM_MODIFIER_SHOW = filterModifier.FILTER_TERM_MODIFIER_SHOW;
 exports.FILTER_TERM_MODIFIER_TYPE = filterModifier.FILTER_TERM_MODIFIER_TYPE;
@@ -243,7 +249,3 @@ exports.FILTER_PREDICATE_SHOW = filterPredicate.FILTER_PREDICATE_SHOW;
 exports.FILTER_PREDICATE_TYPE = filterPredicate.FILTER_PREDICATE_TYPE;
 exports.filterTermModifierIsWithin = filterIsWithin.filterTermModifierIsWithin;
 exports.filterTermModifierNotWithin = filterIsWithin.filterTermModifierNotWithin;
-exports.getTableColumnByKey = column$1.getTableColumnByKey;
-exports.getTableColumnByName = column$1.getTableColumnByName;
-exports.getRowById = row.getRowById;
-exports.getRowsByIds = row.getRowsByIds;

package/lib/link/core.js

@@ -9,10 +9,10 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 var _toConsumableArray__default = /*#__PURE__*/_interopDefaultLegacy(_toConsumableArray);
 
 /**
- * get link by id
- * @param {array} links [{ _id, ... }]
+ * Get link by id
+ * @param {array} links e.g. [{ _id, ... }, ...]
  * @param {string} linkId
- * @returns object
+ * @returns link, object
  */
 var getLinkById = function getLinkById(links, linkId) {
   if (!Array.isArray(links) || !linkId) return null;
@@ -22,9 +22,9 @@ var getLinkById = function getLinkById(links, linkId) {
 };
 
 /**
- * check is valid link by link column's data
- * @param {object} columnData 
- * @returns boolean
+ * Check is valid link
+ * @param {object} columnData
+ * @returns bool
  */
 var isValidLink = function isValidLink(linkColumnData) {
   if (!linkColumnData) return false;
@@ -36,35 +36,35 @@ var isValidLink = function isValidLink(linkColumnData) {
 };
 
 /**
- * get current table's id
+ * Get current table id by link relationship
  * @param {string} currentTableID
  * @param {string} tableID
  * @param {string} otherTableID
- * @returns string
+ * @returns current table id, string
  */
 var getLinkTableID = function getLinkTableID(currentTableID, tableID, otherTableID) {
   return currentTableID === tableID ? tableID : otherTableID;
 };
 
 /**
- * get linked table's id
+ * Get linked table id by link relationship
  * @param {string} currentTableID
  * @param {string} tableID
  * @param {string} otherTableID
- * @returns string
+ * @returns linked table id, string
  */
 var getLinkedTableID = function getLinkedTableID(currentTableID, tableID, otherTableID) {
   return currentTableID === tableID ? otherTableID : tableID;
 };
 
 /**
- * get linked rows ids of the row id
- * @param {array} links [ { _id: '', table1_id, table2_id: '', table1_table2_map: {}, table2_table1_map: {} }, ... ]
- * @param {string} link_id
+ * 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
- * @returns array, linked rows ids
+ * @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 [];

package/lib/number.js

@@ -3,15 +3,23 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 /**
- * check whether is number
+ * Check whether is number
  * @param {number} number
  * @returns boolean
  */
 var isNumber = function isNumber(number) {
   return (number || number === 0) && Object.prototype.toString.call(number) === '[object Number]';
 };
-var isNumberEqual = function isNumberEqual(number1, number2) {
-  return number1 === number2 || Math.abs(number1 - number2) < 0.00001;
+
+/**
+ * Check whether the numbers is equal
+ * Two numbers are considered equal if the absolute value of their difference is less than 0.00001
+ * @param {number} leftNumber
+ * @param {number} rightNumber
+ * @returns bool
+ */
+var isNumberEqual = function isNumberEqual(leftNumber, rightNumber) {
+  return leftNumber === rightNumber || Math.abs(leftNumber - rightNumber) < 0.00001;
 };
 
 exports.isNumber = isNumber;

package/lib/row/core.js

@@ -6,6 +6,7 @@ var _typeof = require('@babel/runtime/helpers/typeof');
 var cellValue = require('../cell-value-get/cell-value.js');
 require('dayjs');
 require('../constants/column.js');
+require('../constants/formula.js');
 var option = require('../cell-value-get/option.js');
 require('../constants/group.js');
 var core = require('../link/core.js');
@@ -17,9 +18,27 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 
 var _typeof__default = /*#__PURE__*/_interopDefaultLegacy(_typeof);
 
+/**
+ * Check is table rows
+ * @param {array} rows e.g. table rows: [{ _id, xxx }, ...] | view rows: [ row._id, ... ]
+ * @returns bool
+ */
 var isTableRows = function isTableRows(rows) {
   return Array.isArray(rows) && _typeof__default["default"](rows[0]) === 'object';
 };
+
+/**
+ * Convert row
+ * e.g. { '0000': 'a' } to { 'Name': 'a' }
+ * @param {object} row
+ * @param {object} value e.g. { links, ... }
+ * @param {object} table e.g. { _id, columns, ... }
+ * @param {object} view e.g. { hidden_columns, ... }
+ * @param {object} formulaResults computed value of formula, link-formula, link etc.
+ * @param {bool} convertLinkID use to convert link: get linked from formulaResults if true, otherwise get linked from links
+ * @param {func} debug use to debug if supplied
+ * @returns converted row, object
+ */
 var convertRow = function convertRow(row, value, table, view, formulaResults, convertLinkID) {
   var _ref = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : {},
     debug = _ref.debug;
@@ -102,7 +121,7 @@ var convertRow = function convertRow(row, value, table, view, formulaResults, co
             // get values form formulaResults
             var formulaRow = formulaResults && formulaResults[row._id];
             var cellResult = formulaRow && formulaRow[key];
-            if (!cellResult || !Array.isArray(cellResult) || cellResult.length === 0) {
+            if (!Array.isArray(cellResult) || cellResult.length === 0) {
               result[columnName] = null;
               break;
             }

package/lib/sort/core.js

@@ -2,13 +2,23 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var _defineProperty = require('@babel/runtime/helpers/defineProperty');
+var option = require('../column/option.js');
+var cellType = require('../constants/cell-type.js');
 var sort = require('../constants/sort.js');
 
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var _defineProperty__default = /*#__PURE__*/_interopDefaultLegacy(_defineProperty);
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty__default["default"](target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
 /**
- * check is valid sort
- * @param {object} sort e.g. { column_key: '', sort_type: '' }
+ * Check is valid sort
+ * @param {object} sort e.g. { column_key, sort_type, ... }
  * @param {array} columns
- * @returns boolean
+ * @returns bool
  */
 var isValidSort = function isValidSort(sort$1, columns) {
   var sortByColumn = sort$1 && columns.find(function (column) {
@@ -19,12 +29,12 @@ var isValidSort = function isValidSort(sort$1, columns) {
 };
 
 /**
- * get valid sorts
+ * Get valid sorts
  *   1. sort column is exist or not
  *   2. valid sort type
- * @param {array} sorts
+ * @param {array} sorts e.g. [{ column_key, sort_type, ... }, ...]
  * @param {array} columns
- * @returns array
+ * @returns valid sorts, array
  */
 var getValidSorts = function getValidSorts(sorts, columns) {
   if (!Array.isArray(sorts) || !Array.isArray(columns)) return [];
@@ -33,5 +43,60 @@ var getValidSorts = function getValidSorts(sorts, columns) {
   });
 };
 
+/**
+ * Get sorted option index of the "optionIds"
+ * @param {array} optionIds
+ * @param {object} option_id_index_map e.g. {[option.id]: 0, ...}
+ * @returns sorted options index, array
+ */
+var getMultipleIndexesOrderbyOptions = function getMultipleIndexesOrderbyOptions(optionIds, option_id_index_map) {
+  var indexArr = [];
+  optionIds.forEach(function (optionId) {
+    var index = option_id_index_map[optionId];
+    if (index > -1) {
+      indexArr.push(index);
+    }
+  });
+  return indexArr.sort();
+};
+
+/**
+ * Get valid and formatted sorts
+ * @param {array} sorts e.g. [{ column_key, sort_type, ... }, ...]
+ * @param {array} columns
+ * @returns valid and formatted sorts, array
+ */
+var deleteInvalidSort = function deleteInvalidSort(sorts, columns) {
+  var validSorts = getValidSorts(sorts, columns);
+  var cleanSorts = [];
+  validSorts.forEach(function (sort) {
+    var column_key = sort.column_key;
+    var sortColumn = columns.find(function (column) {
+      return column.key === column_key;
+    });
+    var columnType = sortColumn.type;
+    var newSort = _objectSpread(_objectSpread({}, sort), {}, {
+      column: sortColumn
+    });
+    switch (columnType) {
+      case cellType.CellType.SINGLE_SELECT:
+      case cellType.CellType.MULTIPLE_SELECT:
+        {
+          var options = option.getColumnOptions(sortColumn);
+          var option_id_index_map = {};
+          options.forEach(function (option, index) {
+            option_id_index_map[option.id] = index;
+          });
+          newSort.option_id_index_map = option_id_index_map;
+          break;
+        }
+    }
+    cleanSorts.push(newSort);
+  });
+  return cleanSorts;
+};
+
+exports.deleteInvalidSort = deleteInvalidSort;
+exports.getMultipleIndexesOrderbyOptions = getMultipleIndexesOrderbyOptions;
 exports.getValidSorts = getValidSorts;
 exports.isValidSort = isValidSort;