core/datastore/utils/utils.js

import _isEmpty from 'lodash/isEmpty';

import { KinveyError } from '../../errors';
import { isNonemptyString } from '../../utils';

/**
 * @private
 */
export const dataStoreTagSeparator = '.';

/**
 * @private
 */
export { buildCollectionUrl } from '../repositories/utils';

/**
 * @private
 */
export function getEntitiesPendingPushError(entityCount, prefix) {
  let countMsg = `are ${entityCount} entities, matching the provided query`;

  if (entityCount === 1) {
    countMsg = `is ${entityCount} entity, matching the provided query or id`;
  }

  const errMsg = `Unable to ${prefix} on the backend. There ${countMsg}, pending push to the backend. The result will overwrite your local changes.`;
  return new KinveyError(errMsg);
}

/**
 * @private
 */
export function generateEntityId(length = 24) {
  const chars = 'abcdef0123456789';
  let objectId = '';

  for (let i = 0, j = chars.length; i < length; i += 1) {
    const pos = Math.floor(Math.random() * j);
    objectId += chars.substring(pos, pos + 1);
  }

  return objectId;
}

/**
 * @private
 */
export function isNotEmpty(object) {
  return !_isEmpty(object);
}

/**
 * @private
 */
export function isEmpty(object) {
  return _isEmpty(object);
}

/**
 * @private
 */
export function isLocalEntity(entity) {
  // not using Metadata class because it mutates the entity
  return !!entity && !!entity._kmd && entity._kmd.local === true;
}

/**
 * @private
 */
export function isValidDataStoreTag(value) {
  const regexp = /^[a-z0-9-]+$/i;
  return isNonemptyString(value) && regexp.test(value);
}

/**
 * @private
 */
export function collectionHasTag(collection) {
  return collection.indexOf(dataStoreTagSeparator) >= 0;
}

/**
 * @private
 */
export function formTaggedCollectionName(collection, tag) {
  if (tag) {
    return `${collection}${dataStoreTagSeparator}${tag}`;
  }
  return collection;
}

/**
 * @private
 */
export function stripTagFromCollectionName(collectionName) {
  return collectionName.split(dataStoreTagSeparator)[0];
}

/**
 * @private
 */
export function getTagFromCollectionName(collectionName) {
  return collectionName.split(dataStoreTagSeparator)[1];
}