dtable-utils 0.0.3 → 4.2.0

package/lib/link/core.js

@@ -0,0 +1,90 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var _toConsumableArray__default = /*#__PURE__*/_interopDefaultLegacy(_toConsumableArray);
+
+/**
+ * Get link by id
+ * @param {array} links e.g. [{ _id, ... }, ...]
+ * @param {string} linkId
+ * @returns link, object
+ */
+var getLinkById = function getLinkById(links, linkId) {
+  if (!Array.isArray(links) || !linkId) return null;
+  return links.find(function (link) {
+    return link._id === linkId;
+  });
+};
+
+/**
+ * Check is valid link
+ * @param {object} columnData
+ * @returns bool
+ */
+var isValidLink = function isValidLink(linkColumnData) {
+  if (!linkColumnData) return false;
+  var link_id = linkColumnData.link_id,
+    table_id = linkColumnData.table_id,
+    other_table_id = linkColumnData.other_table_id,
+    display_column_key = linkColumnData.display_column_key;
+  return !!(link_id && table_id && other_table_id && display_column_key);
+};
+
+/**
+ * Get current table id by link relationship
+ * @param {string} currentTableID
+ * @param {string} tableID
+ * @param {string} otherTableID
+ * @returns current table id, string
+ */
+var getLinkTableID = function getLinkTableID(currentTableID, tableID, otherTableID) {
+  return currentTableID === tableID ? tableID : otherTableID;
+};
+
+/**
+ * Get linked table id by link relationship
+ * @param {string} currentTableID
+ * @param {string} tableID
+ * @param {string} otherTableID
+ * @returns linked table id, string
+ */
+var getLinkedTableID = function getLinkedTableID(currentTableID, tableID, otherTableID) {
+  return currentTableID === tableID ? otherTableID : tableID;
+};
+
+/**
+ * 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 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);
+  if (!linkBetween2Tables) return [];
+  var linkMap = {};
+  if (table1Id === table2Id) {
+    linkMap = linkBetween2Tables.table2_table1_map;
+  } else {
+    linkMap = linkBetween2Tables.table1_id === table1Id ? linkBetween2Tables.table1_table2_map : linkBetween2Tables.table2_table1_map;
+  }
+  var linkedRowIds = linkMap[rowId];
+  if (!linkedRowIds) {
+    return [];
+  }
+  return _toConsumableArray__default["default"](linkedRowIds);
+};
+
+exports.getLinkById = getLinkById;
+exports.getLinkCellValue = getLinkCellValue;
+exports.getLinkTableID = getLinkTableID;
+exports.getLinkedTableID = getLinkedTableID;
+exports.isValidLink = isValidLink;

package/lib/number.js

@@ -0,0 +1,26 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 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]';
+};
+
+/**
+ * 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;
+exports.isNumberEqual = isNumberEqual;

package/lib/row/core.js

@@ -0,0 +1,189 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+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');
+var common = require('../common.js');
+var cellType = require('../constants/cell-type.js');
+var limit = require('../constants/limit.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+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;
+  var result = {};
+  // eslint-disable-next-line
+  if (row.hasOwnProperty('_id')) {
+    result._id = row._id;
+  }
+  // eslint-disable-next-line
+  if (row.hasOwnProperty('_mtime')) {
+    result._mtime = row._mtime;
+  }
+  // eslint-disable-next-line
+  if (row.hasOwnProperty('_ctime')) {
+    result._ctime = row._ctime;
+  }
+  var columns = table.columns;
+  if (columns.length > limit.CONVERT_ROW_COLUMNS_LIMIT) {
+    columns = columns.slice(0, limit.CONVERT_ROW_COLUMNS_LIMIT);
+  }
+  var hiddenColumns = view ? view.hidden_columns : null;
+  for (var i = 0; i < columns.length; i++) {
+    var column = columns[i];
+    var key = column.key,
+      type = column.type,
+      columnName = column.name;
+    if (hiddenColumns && hiddenColumns.includes(key)) {
+      continue;
+    }
+    var cellValue$1 = row[key];
+    switch (type) {
+      case cellType.CellType.SINGLE_SELECT:
+        {
+          if (!column.data) {
+            if (debug) {
+              debug('No options found');
+            }
+            break;
+          }
+          result[columnName] = option.getColumnOptionNameById(column, cellValue$1);
+          break;
+        }
+      case cellType.CellType.MULTIPLE_SELECT:
+        {
+          if (!column.data) {
+            if (debug) {
+              debug('No options found');
+            }
+            break;
+          }
+          if (!Array.isArray(cellValue$1)) {
+            result[columnName] = '';
+            break;
+          }
+          var optionNames = [];
+          for (var optionIndex = 0; optionIndex < cellValue$1.length; optionIndex++) {
+            var optionName = option.getColumnOptionNameById(column, cellValue$1[optionIndex]);
+            if (optionName) {
+              optionNames.push(optionName);
+            }
+          }
+          result[columnName] = optionNames;
+          break;
+        }
+      case cellType.CellType.LONG_TEXT:
+        {
+          result[columnName] = cellValue$1 ? cellValue$1.text : '';
+          break;
+        }
+      case cellType.CellType.LINK:
+        {
+          if (!column.data) {
+            if (debug) {
+              debug('No links found');
+            }
+            break;
+          }
+          // convertLinkID to display value
+          if (convertLinkID) {
+            // get values form formulaResults
+            var formulaRow = formulaResults && formulaResults[row._id];
+            var cellResult = formulaRow && formulaRow[key];
+            if (!Array.isArray(cellResult) || cellResult.length === 0) {
+              result[columnName] = null;
+              break;
+            }
+            // linked with common column:
+            // cellResult
+            // [
+            //   {row_id: '', displayValue: ''},
+            //   {row_id: '', displayValue: ''},
+            // ]
+
+            // linked with formula column and formula result is array
+            // cellResult
+            // [
+            //   {row_id: '', display_value: []},
+            //   {row_id: '', display_value: []},
+            // ]
+            result[columnName] = cellResult;
+            break;
+          }
+          var tableID = table._id;
+          var _column$data = column.data,
+            link_id = _column$data.link_id,
+            table_id = _column$data.table_id,
+            other_table_id = _column$data.other_table_id;
+          var otherTableID = tableID === table_id ? other_table_id : table_id;
+          var links = value.links;
+          result[columnName] = core.getLinkCellValue(links, link_id, tableID, otherTableID, row._id);
+          break;
+        }
+      case cellType.CellType.FORMULA:
+      case cellType.CellType.LINK_FORMULA:
+        {
+          if (!column.data || !formulaResults) {
+            if (debug) {
+              debug('No formula found');
+            }
+            break;
+          }
+          var _formulaRow = formulaResults[row._id] || {};
+          result[columnName] = cellValue.getFormulaDisplayString(_formulaRow[key], column.data);
+          break;
+        }
+      default:
+        {
+          // text/email/url/auto-number/
+          // check/
+          // rate/duration/
+          // file/image/button/
+          // translate in dtable-events
+          // number/
+          // date/ctime/mtime/
+          // geolocation/
+          // collaborator/creator/last-modifier/
+          result[columnName] = cellValue$1;
+        }
+    }
+    if (common.isEmpty(result[columnName])) {
+      delete result[columnName];
+    }
+  }
+  return result;
+};
+
+exports.convertRow = convertRow;
+exports.isTableRows = isTableRows;

package/lib/sort/core.js

@@ -0,0 +1,102 @@
+'use strict';
+
+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, ... }
+ * @param {array} columns
+ * @returns bool
+ */
+var isValidSort = function isValidSort(sort$1, columns) {
+  var sortByColumn = sort$1 && columns.find(function (column) {
+    return column.key === sort$1.column_key;
+  });
+  if (!sortByColumn) return false;
+  return sort.SORT_COLUMN_OPTIONS.includes(sortByColumn.type);
+};
+
+/**
+ * Get valid sorts
+ *   1. sort column is exist or not
+ *   2. valid sort type
+ * @param {array} sorts e.g. [{ column_key, sort_type, ... }, ...]
+ * @param {array} columns
+ * @returns valid sorts, array
+ */
+var getValidSorts = function getValidSorts(sorts, columns) {
+  if (!Array.isArray(sorts) || !Array.isArray(columns)) return [];
+  return sorts.filter(function (sort) {
+    return isValidSort(sort, 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;

package/lib/sort/sort-column/array.js

@@ -0,0 +1,76 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var collaborator = require('../../cell-value-get/collaborator.js');
+var cellValue = require('../../cell-value-get/cell-value.js');
+var checkbox = require('./checkbox.js');
+var collaborator$1 = require('./collaborator.js');
+var date = require('./date.js');
+var number = require('./number.js');
+var text = require('./text.js');
+var cellType = require('../../constants/cell-type.js');
+var column = require('../../constants/column.js');
+var formula = require('../../constants/formula.js');
+
+/**
+ * Sort by array type
+ * @param {array} leftArray
+ * @param {array} rightArray
+ * @param {string} sortType e.g. 'up' | 'down
+ * @param {object} columnData e.g. { result_type, array_type, array_data, ... }
+ * @param {object} value e.g. { collaborators, ... }
+ * @returns number
+ */
+var sortByArrayType = function sortByArrayType(leftArray, rightArray, sortType, _ref) {
+  var columnData = _ref.columnData,
+    value = _ref.value;
+  var _ref2 = columnData || {},
+    array_type = _ref2.array_type;
+  if (column.NUMERIC_COLUMNS_TYPES.includes(array_type)) {
+    var leftNumber = leftArray;
+    var rightNumber = rightArray;
+    if (Array.isArray(leftArray)) {
+      leftNumber = leftArray[0];
+    }
+    if (Array.isArray(rightArray)) {
+      rightNumber = rightArray[0];
+    }
+    leftNumber = leftNumber || leftNumber === 0 ? leftNumber : null;
+    rightNumber = rightNumber || rightNumber === 0 ? rightNumber : null;
+    return number.sortNumber(leftNumber, rightNumber, sortType);
+  }
+  if (column.DATE_COLUMN_OPTIONS.includes(array_type)) {
+    var leftDate = Array.isArray(leftArray) ? leftArray[0] : leftArray;
+    var rightDate = Array.isArray(rightArray) ? rightArray[0] : rightArray;
+    return date.sortDate(leftDate, rightDate, sortType);
+  }
+  if (array_type === cellType.CellType.CHECKBOX || array_type === formula.FORMULA_RESULT_TYPE.BOOL) {
+    var leftBool = leftArray;
+    var rightBool = rightArray;
+    if (Array.isArray(leftArray)) {
+      leftBool = leftArray[0];
+    }
+    if (Array.isArray(rightArray)) {
+      rightBool = rightArray[0];
+    }
+    leftBool = leftBool || false;
+    rightBool = rightBool || false;
+    return checkbox.sortCheckbox(leftBool, rightBool, sortType);
+  }
+  if (array_type === cellType.CellType.COLLABORATOR) {
+    var collaborators = value.collaborators;
+    var leftCollaborators = Array.isArray(leftArray) ? leftArray : [leftArray];
+    var rightCollaborators = Array.isArray(rightArray) ? rightArray : [rightArray];
+    if (collaborators) {
+      leftCollaborators = collaborator.getCollaboratorsNames(leftCollaborators, collaborators);
+      rightCollaborators = collaborator.getCollaboratorsNames(rightCollaborators, collaborators);
+    }
+    return collaborator$1.sortCollaborator(leftCollaborators, rightCollaborators, sortType);
+  }
+  var leftText = cellValue.getFormulaDisplayString(leftArray, columnData);
+  var rightText = cellValue.getFormulaDisplayString(rightArray, columnData);
+  return text.sortText(leftText, rightText, sortType);
+};
+
+exports.sortByArrayType = sortByArrayType;

package/lib/sort/sort-column/checkbox.js

@@ -0,0 +1,26 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var sort = require('../../constants/sort.js');
+
+/**
+ * Sort checkbox
+ * @param {bool} leftChecked
+ * @param {bool} rightChecked
+ * @param {string} sortType e.g. 'up' | 'down
+ * @returns number
+ */
+var sortCheckbox = function sortCheckbox(leftChecked, rightChecked, sortType) {
+  var normalizedCurrChecked = leftChecked ? 1 : -1;
+  var normalizedNextChecked = rightChecked ? 1 : -1;
+  if (normalizedCurrChecked > normalizedNextChecked) {
+    return sortType === sort.SORT_TYPE.UP ? 1 : -1;
+  }
+  if (normalizedCurrChecked < normalizedNextChecked) {
+    return sortType === sort.SORT_TYPE.UP ? -1 : 1;
+  }
+  return 0;
+};
+
+exports.sortCheckbox = sortCheckbox;

package/lib/sort/sort-column/collaborator.js

@@ -0,0 +1,20 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var text = require('./text.js');
+
+/**
+ * Sort collaborator with email or name
+ * @param {array} leftCollaborators e.g. [ collaborator.email, ... ] | [ collaborator.name, ... ]
+ * @param {array} rightCollaborators
+ * @param {string} sortType e.g. 'up' | 'down
+ * @returns number
+ */
+var sortCollaborator = function sortCollaborator(leftCollaborators, rightCollaborators, sortType) {
+  var sLeftCollaborators = Array.isArray(leftCollaborators) && leftCollaborators.length ? leftCollaborators.join('') : null;
+  var sRightCollaborators = Array.isArray(rightCollaborators) && rightCollaborators.length ? rightCollaborators.join('') : null;
+  return text.sortText(sLeftCollaborators, sRightCollaborators, sortType);
+};
+
+exports.sortCollaborator = sortCollaborator;

package/lib/sort/sort-column/date.js

@@ -0,0 +1,29 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var sort = require('../../constants/sort.js');
+
+/**
+ * Sort date
+ * @param {string} leftDate e.g. '2023-07-31'
+ * @param {string} nextDate
+ * @param {string} sortType e.g. 'up' | 'down'
+ * @returns number
+ */
+var sortDate = function sortDate(leftDate, rightDate, sortType) {
+  var emptyLeftDate = !leftDate;
+  var emptyRightDate = !rightDate;
+  if (emptyLeftDate && emptyRightDate) return 0;
+  if (emptyLeftDate) return 1;
+  if (emptyRightDate) return -1;
+  if (leftDate > rightDate) {
+    return sortType === sort.SORT_TYPE.UP ? 1 : -1;
+  }
+  if (leftDate < rightDate) {
+    return sortType === sort.SORT_TYPE.UP ? -1 : 1;
+  }
+  return 0;
+};
+
+exports.sortDate = sortDate;

package/lib/sort/sort-column/formula.js

@@ -0,0 +1,53 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cellValue = require('../../cell-value-get/cell-value.js');
+var array = require('./array.js');
+var checkbox = require('./checkbox.js');
+var date = require('./date.js');
+var number = require('./number.js');
+var text = require('./text.js');
+var column = require('../../constants/column.js');
+var formula = require('../../constants/formula.js');
+var sort = require('../../constants/sort.js');
+
+/**
+ * Sort formula
+ * @param {any} leftComputedValue compute value from formula row
+ * @param {any} rightComputedValue
+ * @param {string} sortType e.g. 'up' | 'down
+ * @param {object} columnData e.g. { result_type, array_type, array_data, ... }
+ * @param {object} value e.g. { collaborators, ... }
+ * @returns number
+ */
+var sortFormula = function sortFormula(leftComputedValue, rightComputedValue, sortType, _ref) {
+  var columnData = _ref.columnData,
+    value = _ref.value;
+  var _ref2 = columnData || {},
+    result_type = _ref2.result_type;
+  if (sort.NUMBER_SORTER_COLUMN_TYPES.includes(result_type)) {
+    var leftNumber = leftComputedValue || leftComputedValue === 0 ? leftComputedValue - 0 : null;
+    var rightNumber = rightComputedValue || rightComputedValue === 0 ? rightComputedValue - 0 : null;
+    return number.sortNumber(leftNumber, rightNumber, sortType);
+  }
+  if (column.DATE_COLUMN_OPTIONS.includes(result_type)) {
+    return date.sortDate(leftComputedValue, rightComputedValue, sortType);
+  }
+  if (result_type === formula.FORMULA_RESULT_TYPE.BOOL) {
+    var leftBoolean = leftComputedValue || false;
+    var rightBoolean = rightComputedValue || false;
+    return checkbox.sortCheckbox(leftBoolean, rightBoolean, sortType);
+  }
+  if (result_type === formula.FORMULA_RESULT_TYPE.ARRAY) {
+    return array.sortByArrayType(leftComputedValue, rightComputedValue, sortType, {
+      columnData: columnData,
+      value: value
+    });
+  }
+  var leftText = cellValue.getFormulaDisplayString(leftComputedValue, columnData);
+  var rightText = cellValue.getFormulaDisplayString(rightComputedValue, columnData);
+  return text.sortText(leftText, rightText, sortType);
+};
+
+exports.sortFormula = sortFormula;

package/lib/sort/sort-column/link.js

@@ -0,0 +1,36 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var array = require('./array.js');
+
+/**
+ * Sort link
+ * @param {array} leftLinkedCellValues e.g. [{ row_id, display_value }]
+ * @param {array} rightLinkedCellValues
+ * @param {string} sortType e.g. 'up' | 'down
+ * @param {object} columnData e.g. { result_type, array_type, array_data, ... }
+ * @param {object} value e.g. { collaborators, ... }
+ * @returns number
+ */
+var sortLink = function sortLink(leftLinkedCellValues, rightLinkedCellValues, sortType, _ref) {
+  var columnData = _ref.columnData,
+    value = _ref.value;
+  var emptyLeftLinkedCellValues = !Array.isArray(leftLinkedCellValues) || leftLinkedCellValues.length === 0;
+  var emptyRightLinkedCellValues = !Array.isArray(rightLinkedCellValues) || rightLinkedCellValues.length === 0;
+  if (emptyLeftLinkedCellValues && emptyRightLinkedCellValues) return 0;
+  if (emptyLeftLinkedCellValues) return 1;
+  if (emptyRightLinkedCellValues) return -1;
+  var leftDisplayValues = leftLinkedCellValues.map(function (linked) {
+    return linked.display_value;
+  });
+  var rightDisplayValues = rightLinkedCellValues.map(function (linked) {
+    return linked.display_value;
+  });
+  return array.sortByArrayType(leftDisplayValues, rightDisplayValues, sortType, {
+    columnData: columnData,
+    value: value
+  });
+};
+
+exports.sortLink = sortLink;