681 lines
19 KiB
JavaScript
681 lines
19 KiB
JavaScript
// Copyright IBM Corp. 2012,2016. All Rights Reserved.
|
|
// Node module: loopback-datasource-juggler
|
|
// This file is licensed under the MIT License.
|
|
// License text available at https://opensource.org/licenses/MIT
|
|
'use strict';
|
|
|
|
exports.safeRequire = safeRequire;
|
|
exports.fieldsToArray = fieldsToArray;
|
|
exports.selectFields = selectFields;
|
|
exports.removeUndefined = removeUndefined;
|
|
exports.parseSettings = parseSettings;
|
|
exports.mergeSettings = exports.deepMerge = deepMerge;
|
|
exports.deepMergeProperty = deepMergeProperty;
|
|
exports.isPlainObject = isPlainObject;
|
|
exports.defineCachedRelations = defineCachedRelations;
|
|
exports.sortObjectsByIds = sortObjectsByIds;
|
|
exports.setScopeValuesFromWhere = setScopeValuesFromWhere;
|
|
exports.mergeQuery = mergeQuery;
|
|
exports.mergeIncludes = mergeIncludes;
|
|
exports.createPromiseCallback = createPromiseCallback;
|
|
exports.uniq = uniq;
|
|
exports.toRegExp = toRegExp;
|
|
exports.hasRegExpFlags = hasRegExpFlags;
|
|
exports.idEquals = idEquals;
|
|
exports.findIndexOf = findIndexOf;
|
|
exports.collectTargetIds = collectTargetIds;
|
|
exports.idName = idName;
|
|
exports.rankArrayElements = rankArrayElements;
|
|
|
|
var g = require('strong-globalize')();
|
|
var traverse = require('traverse');
|
|
var assert = require('assert');
|
|
var Promise = require('bluebird');
|
|
|
|
function safeRequire(module) {
|
|
try {
|
|
return require(module);
|
|
} catch (e) {
|
|
g.log('Run "{{npm install loopback-datasource-juggler}} %s" command ',
|
|
'to use {{loopback-datasource-juggler}} using %s database engine',
|
|
module, module);
|
|
process.exit(1);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Extracting fixed property values for the scope from the where clause into
|
|
* the data object
|
|
*
|
|
* @param {Object} The data object
|
|
* @param {Object} The where clause
|
|
*/
|
|
function setScopeValuesFromWhere(data, where, targetModel) {
|
|
for (var i in where) {
|
|
if (i === 'and') {
|
|
// Find fixed property values from each subclauses
|
|
for (var w = 0, n = where[i].length; w < n; w++) {
|
|
setScopeValuesFromWhere(data, where[i][w], targetModel);
|
|
}
|
|
continue;
|
|
}
|
|
var prop = targetModel.definition.properties[i];
|
|
if (prop) {
|
|
var val = where[i];
|
|
if (typeof val !== 'object' || val instanceof prop.type ||
|
|
prop.type.name === 'ObjectID' || // MongoDB key
|
|
prop.type.name === 'uuidFromString') { // C*
|
|
// Only pick the {propertyName: propertyValue}
|
|
data[i] = where[i];
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Merge include options of default scope with runtime include option.
|
|
* exhibits the _.extend behaviour. Property value of source overrides
|
|
* property value of destination if property name collision occurs
|
|
* @param {String|Array|Object} destination The default value of `include` option
|
|
* @param {String|Array|Object} source The runtime value of `include` option
|
|
* @returns {Object}
|
|
*/
|
|
function mergeIncludes(destination, source) {
|
|
var destArray = convertToArray(destination);
|
|
var sourceArray = convertToArray(source);
|
|
if (destArray.length === 0) {
|
|
return sourceArray;
|
|
}
|
|
if (sourceArray.length === 0) {
|
|
return destArray;
|
|
}
|
|
var relationNames = [];
|
|
var resultArray = [];
|
|
for (var j in sourceArray) {
|
|
var sourceEntry = sourceArray[j];
|
|
var sourceEntryRelationName = (typeof (sourceEntry.rel || sourceEntry.relation) === 'string') ?
|
|
sourceEntry.relation : Object.keys(sourceEntry)[0];
|
|
relationNames.push(sourceEntryRelationName);
|
|
resultArray.push(sourceEntry);
|
|
}
|
|
for (var i in destArray) {
|
|
var destEntry = destArray[i];
|
|
var destEntryRelationName = (typeof (destEntry.rel || destEntry.relation) === 'string') ?
|
|
destEntry.relation : Object.keys(destEntry)[0];
|
|
if (relationNames.indexOf(destEntryRelationName) === -1) {
|
|
resultArray.push(destEntry);
|
|
}
|
|
}
|
|
return resultArray;
|
|
}
|
|
|
|
/**
|
|
* Converts input parameter into array of objects which wraps the value.
|
|
* "someValue" is converted to [{"someValue":true}]
|
|
* ["someValue"] is converted to [{"someValue":true}]
|
|
* {"someValue":true} is converted to [{"someValue":true}]
|
|
* @param {String|Array|Object} param - Input parameter to be converted
|
|
* @returns {Array}
|
|
*/
|
|
function convertToArray(include) {
|
|
if (typeof include === 'string') {
|
|
const obj = {};
|
|
obj[include] = true;
|
|
return [obj];
|
|
} else if (isPlainObject(include)) {
|
|
// if include is of the form - {relation:'',scope:''}
|
|
if (include.rel || include.relation) {
|
|
return [include];
|
|
}
|
|
// Build an array of key/value pairs
|
|
var newInclude = [];
|
|
for (var key in include) {
|
|
const obj = {};
|
|
obj[key] = include[key];
|
|
newInclude.push(obj);
|
|
}
|
|
return newInclude;
|
|
} else if (Array.isArray(include)) {
|
|
var normalized = [];
|
|
for (var i in include) {
|
|
var includeEntry = include[i];
|
|
if (typeof includeEntry === 'string') {
|
|
const obj = {};
|
|
obj[includeEntry] = true;
|
|
normalized.push(obj);
|
|
} else {
|
|
normalized.push(includeEntry);
|
|
}
|
|
}
|
|
return normalized;
|
|
}
|
|
return [];
|
|
}
|
|
|
|
/*!
|
|
* Merge query parameters
|
|
* @param {Object} base The base object to contain the merged results
|
|
* @param {Object} update The object containing updates to be merged
|
|
* @param {Object} spec Optionally specifies parameters to exclude (set to false)
|
|
* @returns {*|Object} The base object
|
|
* @private
|
|
*/
|
|
function mergeQuery(base, update, spec) {
|
|
if (!update) {
|
|
return;
|
|
}
|
|
spec = spec || {};
|
|
base = base || {};
|
|
|
|
if (update.where && Object.keys(update.where).length > 0) {
|
|
if (base.where && Object.keys(base.where).length > 0) {
|
|
base.where = {and: [base.where, update.where]};
|
|
} else {
|
|
base.where = update.where;
|
|
}
|
|
}
|
|
|
|
// Merge inclusion
|
|
if (spec.include !== false && update.include) {
|
|
if (!base.include) {
|
|
base.include = update.include;
|
|
} else {
|
|
if (spec.nestedInclude === true) {
|
|
// specify nestedInclude=true to force nesting of inclusions on scoped
|
|
// queries. e.g. In physician.patients.getAsync({include: 'address'}),
|
|
// inclusion should be on patient model, not on physician model.
|
|
var saved = base.include;
|
|
base.include = {};
|
|
base.include[update.include] = saved;
|
|
} else {
|
|
// default behaviour of inclusion merge - merge inclusions at the same
|
|
// level. - https://github.com/strongloop/loopback-datasource-juggler/pull/569#issuecomment-95310874
|
|
base.include = mergeIncludes(base.include, update.include);
|
|
}
|
|
}
|
|
}
|
|
|
|
if (spec.collect !== false && update.collect) {
|
|
base.collect = update.collect;
|
|
}
|
|
|
|
// Overwrite fields
|
|
if (spec.fields !== false && update.fields !== undefined) {
|
|
base.fields = update.fields;
|
|
} else if (update.fields !== undefined) {
|
|
base.fields = [].concat(base.fields).concat(update.fields);
|
|
}
|
|
|
|
// set order
|
|
if ((!base.order || spec.order === false) && update.order) {
|
|
base.order = update.order;
|
|
}
|
|
|
|
// overwrite pagination
|
|
if (spec.limit !== false && update.limit !== undefined) {
|
|
base.limit = update.limit;
|
|
}
|
|
|
|
var skip = spec.skip !== false && spec.offset !== false;
|
|
|
|
if (skip && update.skip !== undefined) {
|
|
base.skip = update.skip;
|
|
}
|
|
|
|
if (skip && update.offset !== undefined) {
|
|
base.offset = update.offset;
|
|
}
|
|
|
|
return base;
|
|
}
|
|
|
|
/**
|
|
* Normalize fields to an array of included properties
|
|
* @param {String|String[]|Object} fields Fields filter
|
|
* @param {String[]} properties Property names
|
|
* @param {Boolean} excludeUnknown To exclude fields that are unknown properties
|
|
* @returns {String[]} An array of included property names
|
|
*/
|
|
function fieldsToArray(fields, properties, excludeUnknown) {
|
|
if (!fields) return;
|
|
|
|
// include all properties by default
|
|
var result = properties;
|
|
var i, n;
|
|
|
|
if (typeof fields === 'string') {
|
|
result = [fields];
|
|
} else if (Array.isArray(fields) && fields.length > 0) {
|
|
// No empty array, including all the fields
|
|
result = fields;
|
|
} else if ('object' === typeof fields) {
|
|
// { field1: boolean, field2: boolean ... }
|
|
var included = [];
|
|
var excluded = [];
|
|
var keys = Object.keys(fields);
|
|
if (!keys.length) return;
|
|
|
|
for (i = 0, n = keys.length; i < n; i++) {
|
|
var k = keys[i];
|
|
if (fields[k]) {
|
|
included.push(k);
|
|
} else if ((k in fields) && !fields[k]) {
|
|
excluded.push(k);
|
|
}
|
|
}
|
|
if (included.length > 0) {
|
|
result = included;
|
|
} else if (excluded.length > 0) {
|
|
for (i = 0, n = excluded.length; i < n; i++) {
|
|
var index = result.indexOf(excluded[i]);
|
|
if (index !== -1) result.splice(index, 1); // only when existing field excluded
|
|
}
|
|
}
|
|
}
|
|
|
|
var fieldArray = [];
|
|
if (excludeUnknown) {
|
|
for (i = 0, n = result.length; i < n; i++) {
|
|
if (properties.indexOf(result[i]) !== -1) {
|
|
fieldArray.push(result[i]);
|
|
}
|
|
}
|
|
} else {
|
|
fieldArray = result;
|
|
}
|
|
return fieldArray;
|
|
}
|
|
|
|
function selectFields(fields) {
|
|
// map function
|
|
return function(obj) {
|
|
var result = {};
|
|
var key;
|
|
|
|
for (var i = 0; i < fields.length; i++) {
|
|
key = fields[i];
|
|
|
|
result[key] = obj[key];
|
|
}
|
|
return result;
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Remove undefined values from the queury object
|
|
* @param query
|
|
* @param handleUndefined {String} either "nullify", "throw" or "ignore" (default: "ignore")
|
|
* @returns {exports.map|*}
|
|
*/
|
|
function removeUndefined(query, handleUndefined) {
|
|
if (typeof query !== 'object' || query === null) {
|
|
return query;
|
|
}
|
|
// WARNING: [rfeng] Use map() will cause mongodb to produce invalid BSON
|
|
// as traverse doesn't transform the ObjectId correctly
|
|
return traverse(query).forEach(function(x) {
|
|
if (x === undefined) {
|
|
switch (handleUndefined) {
|
|
case 'nullify':
|
|
this.update(null);
|
|
break;
|
|
case 'throw':
|
|
throw new Error(g.f('Unexpected `undefined` in query'));
|
|
break;
|
|
case 'ignore':
|
|
default:
|
|
this.remove();
|
|
}
|
|
}
|
|
|
|
if (!Array.isArray(x) && (typeof x === 'object' && x !== null &&
|
|
x.constructor !== Object)) {
|
|
// This object is not a plain object
|
|
this.update(x, true); // Stop navigating into this object
|
|
return x;
|
|
}
|
|
|
|
return x;
|
|
});
|
|
}
|
|
|
|
var url = require('url');
|
|
var qs = require('qs');
|
|
|
|
/**
|
|
* Parse a URL into a settings object
|
|
* @param {String} urlStr The URL for connector settings
|
|
* @returns {Object} The settings object
|
|
*/
|
|
function parseSettings(urlStr) {
|
|
if (!urlStr) {
|
|
return {};
|
|
}
|
|
var uri = url.parse(urlStr, false);
|
|
var settings = {};
|
|
settings.connector = uri.protocol && uri.protocol.split(':')[0]; // Remove the trailing :
|
|
settings.host = settings.hostname = uri.hostname;
|
|
settings.port = uri.port && Number(uri.port); // port is a string
|
|
settings.user = settings.username = uri.auth && uri.auth.split(':')[0]; // <username>:<password>
|
|
settings.password = uri.auth && uri.auth.split(':')[1];
|
|
settings.database = uri.pathname && uri.pathname.split('/')[1]; // remove the leading /
|
|
settings.url = urlStr;
|
|
if (uri.query) {
|
|
var params = qs.parse(uri.query);
|
|
for (var p in params) {
|
|
settings[p] = params[p];
|
|
}
|
|
}
|
|
return settings;
|
|
}
|
|
|
|
/**
|
|
* Objects deep merge
|
|
*
|
|
* Forked from https://github.com/nrf110/deepmerge/blob/master/index.js
|
|
*
|
|
* The original function tries to merge array items if they are objects, this
|
|
* was changed to always push new items in arrays, independently of their type.
|
|
*
|
|
* NOTE: The function operates as a deep clone when called with a single object
|
|
* argument.
|
|
*
|
|
* @param {Object} base The base object
|
|
* @param {Object} extras The object to merge with base
|
|
* @returns {Object} The merged object
|
|
*/
|
|
function deepMerge(base, extras) {
|
|
// deepMerge allows undefined extras to allow deep cloning of arrays
|
|
var array = Array.isArray(base) && (Array.isArray(extras) || !extras);
|
|
var dst = array && [] || {};
|
|
|
|
if (array) {
|
|
// extras or base is an array
|
|
extras = extras || [];
|
|
// Add items from base into dst
|
|
dst = dst.concat(base);
|
|
// Add non-existent items from extras into dst
|
|
extras.forEach(function(e) {
|
|
if (dst.indexOf(e) === -1) {
|
|
dst.push(e);
|
|
}
|
|
});
|
|
} else {
|
|
if (base != null && typeof base === 'object') {
|
|
// Add properties from base to dst
|
|
Object.keys(base).forEach(function(key) {
|
|
if (base[key] && typeof base[key] === 'object') {
|
|
// call deepMerge on nested object to operate a deep clone
|
|
dst[key] = deepMerge(base[key]);
|
|
} else {
|
|
dst[key] = base[key];
|
|
}
|
|
});
|
|
}
|
|
if (extras != null && typeof extras === 'object') {
|
|
// extras is an object {}
|
|
Object.keys(extras).forEach(function(key) {
|
|
var extra = extras[key];
|
|
if (extra == null || typeof extra !== 'object') {
|
|
// extra item value is null, undefined or not an object
|
|
dst[key] = extra;
|
|
} else {
|
|
// The extra item value is an object
|
|
if (base == null || typeof base !== 'object' ||
|
|
base[key] == null) {
|
|
// base is not an object or base item value is undefined or null
|
|
dst[key] = extra;
|
|
} else {
|
|
// call deepMerge on nested object
|
|
dst[key] = deepMerge(base[key], extra);
|
|
}
|
|
}
|
|
});
|
|
}
|
|
}
|
|
|
|
return dst;
|
|
}
|
|
|
|
/**
|
|
* Properties deep merge
|
|
* Similar as deepMerge but also works on single properties of any type
|
|
*
|
|
* @param {Object} base The base property
|
|
* @param {Object} extras The property to merge with base
|
|
* @returns {Object} The merged property
|
|
*/
|
|
function deepMergeProperty(base, extras) {
|
|
let mergedObject = deepMerge({key: base}, {key: extras});
|
|
let mergedProperty = mergedObject.key;
|
|
return mergedProperty;
|
|
}
|
|
|
|
/**
|
|
* Adds a property __rank to array elements of type object {}
|
|
* If an inner element already has the __rank property it is not altered
|
|
* NOTE: the function mutates the provided array
|
|
*
|
|
* @param array The original array
|
|
* @param rank The rank to apply to array elements
|
|
* @return rankedArray The original array with newly ranked elements
|
|
*/
|
|
function rankArrayElements(array, rank) {
|
|
if (!Array.isArray(array) || !Number.isFinite(rank))
|
|
return array;
|
|
|
|
array.forEach(function(el) {
|
|
// only apply ranking on objects {} in array
|
|
if (!el || typeof el != 'object' || Array.isArray(el))
|
|
return;
|
|
|
|
// property rank is already defined for array element
|
|
if (el.__rank)
|
|
return;
|
|
|
|
// define rank property as non-enumerable and read-only
|
|
Object.defineProperty(el, '__rank', {
|
|
writable: false,
|
|
enumerable: false,
|
|
configurable: false,
|
|
value: rank,
|
|
});
|
|
});
|
|
return array;
|
|
}
|
|
|
|
/**
|
|
* Define an non-enumerable __cachedRelations property
|
|
* @param {Object} obj The obj to receive the __cachedRelations
|
|
*/
|
|
function defineCachedRelations(obj) {
|
|
if (!obj.__cachedRelations) {
|
|
Object.defineProperty(obj, '__cachedRelations', {
|
|
writable: true,
|
|
enumerable: false,
|
|
configurable: true,
|
|
value: {},
|
|
});
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check if the argument is plain object
|
|
* @param {*) obj The obj value
|
|
* @returns {boolean}
|
|
*/
|
|
function isPlainObject(obj) {
|
|
return (typeof obj === 'object') && (obj !== null) &&
|
|
(obj.constructor === Object);
|
|
}
|
|
|
|
function sortObjectsByIds(idName, ids, objects, strict) {
|
|
ids = ids.map(function(id) {
|
|
return (typeof id === 'object') ? String(id) : id;
|
|
});
|
|
|
|
var indexOf = function(x) {
|
|
var isObj = (typeof x[idName] === 'object'); // ObjectID
|
|
var id = isObj ? String(x[idName]) : x[idName];
|
|
return ids.indexOf(id);
|
|
};
|
|
|
|
var heading = [];
|
|
var tailing = [];
|
|
|
|
objects.forEach(function(x) {
|
|
if (typeof x === 'object') {
|
|
var idx = indexOf(x);
|
|
if (strict && idx === -1) return;
|
|
idx === -1 ? tailing.push(x) : heading.push(x);
|
|
}
|
|
});
|
|
|
|
heading.sort(function(x, y) {
|
|
var a = indexOf(x);
|
|
var b = indexOf(y);
|
|
if (a === -1 || b === -1) return 1; // last
|
|
if (a === b) return 0;
|
|
if (a > b) return 1;
|
|
if (a < b) return -1;
|
|
});
|
|
|
|
return heading.concat(tailing);
|
|
};
|
|
|
|
function createPromiseCallback() {
|
|
var cb;
|
|
var promise = new Promise(function(resolve, reject) {
|
|
cb = function(err, data) {
|
|
if (err) return reject(err);
|
|
return resolve(data);
|
|
};
|
|
});
|
|
cb.promise = promise;
|
|
return cb;
|
|
}
|
|
|
|
/**
|
|
* Dedupe an array
|
|
* @param {Array} an array
|
|
* @returns {Array} an array with unique items
|
|
*/
|
|
function uniq(a) {
|
|
var uniqArray = [];
|
|
if (!a) {
|
|
return uniqArray;
|
|
}
|
|
assert(Array.isArray(a), 'array argument is required');
|
|
for (var i = 0, n = a.length; i < n; i++) {
|
|
if (a.indexOf(a[i]) === i) {
|
|
uniqArray.push(a[i]);
|
|
}
|
|
}
|
|
return uniqArray;
|
|
}
|
|
|
|
/**
|
|
* Converts a string, regex literal, or a RegExp object to a RegExp object.
|
|
* @param {String|Object} The string, regex literal, or RegExp object to convert
|
|
* @returns {Object} A RegExp object
|
|
*/
|
|
function toRegExp(regex) {
|
|
var isString = typeof regex === 'string';
|
|
var isRegExp = regex instanceof RegExp;
|
|
|
|
if (!(isString || isRegExp))
|
|
return new Error(g.f('Invalid argument, must be a string, {{regex}} literal, or ' +
|
|
'{{RegExp}} object'));
|
|
|
|
if (isRegExp)
|
|
return regex;
|
|
|
|
if (!hasRegExpFlags(regex))
|
|
return new RegExp(regex);
|
|
|
|
// only accept i, g, or m as valid regex flags
|
|
var flags = regex.split('/').pop().split('');
|
|
var validFlags = ['i', 'g', 'm'];
|
|
var invalidFlags = [];
|
|
flags.forEach(function(flag) {
|
|
if (validFlags.indexOf(flag) === -1)
|
|
invalidFlags.push(flag);
|
|
});
|
|
|
|
var hasInvalidFlags = invalidFlags.length > 0;
|
|
if (hasInvalidFlags)
|
|
return new Error(g.f('Invalid {{regex}} flags: %s', invalidFlags));
|
|
|
|
// strip regex delimiter forward slashes
|
|
var expression = regex.substr(1, regex.lastIndexOf('/') - 1);
|
|
return new RegExp(expression, flags.join(''));
|
|
}
|
|
|
|
function hasRegExpFlags(regex) {
|
|
return regex instanceof RegExp ?
|
|
regex.toString().split('/').pop() :
|
|
!!regex.match(/.*\/.+$/);
|
|
}
|
|
|
|
// Compare two id values to decide if updateAttributes is trying to change
|
|
// the id value for a given instance
|
|
function idEquals(id1, id2) {
|
|
if (id1 === id2) {
|
|
return true;
|
|
}
|
|
// Allows number/string conversions
|
|
if ((typeof id1 === 'number' && typeof id2 === 'string') ||
|
|
(typeof id1 === 'string' && typeof id2 === 'number')) {
|
|
return id1 == id2;
|
|
}
|
|
// For complex id types such as MongoDB ObjectID
|
|
id1 = JSON.stringify(id1);
|
|
id2 = JSON.stringify(id2);
|
|
if (id1 === id2) {
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
// Defaults to native Array.prototype.indexOf when no idEqual is present
|
|
// Otherwise, returns the lowest index for which isEqual(arr[]index, target) is true
|
|
function findIndexOf(arr, target, isEqual) {
|
|
if (!isEqual) {
|
|
return arr.indexOf(target);
|
|
}
|
|
|
|
for (var i = 0; i < arr.length; i++) {
|
|
if (isEqual(arr[i], target)) { return i; }
|
|
};
|
|
|
|
return -1;
|
|
}
|
|
|
|
/**
|
|
* Returns an object that queries targetIds.
|
|
* @param {Array} The array of targetData
|
|
* @param {String} The Id property name of target model
|
|
* @returns {Object} The object that queries targetIds
|
|
*/
|
|
function collectTargetIds(targetData, idPropertyName) {
|
|
var targetIds = [];
|
|
for (var i = 0; i < targetData.length; i++) {
|
|
var targetId = targetData[i][idPropertyName];
|
|
targetIds.push(targetId);
|
|
};
|
|
var IdQuery = {
|
|
inq: uniq(targetIds),
|
|
};
|
|
return IdQuery;
|
|
}
|
|
|
|
/**
|
|
* Find the idKey of a Model.
|
|
* @param {ModelConstructor} m - Model Constructor
|
|
* @returns {String}
|
|
*/
|
|
function idName(m) {
|
|
return m.definition.idName() || 'id';
|
|
}
|