var assert = require('assert'); var cloneDeep = require('lodash').cloneDeep; var fs = require('fs'); var path = require('path'); var toposort = require('toposort'); var ConfigLoader = require('./config-loader'); var debug = require('debug')('loopback:boot:compiler'); var Module = require('module'); var _ = require('lodash'); var FILE_EXTENSION_JSON = '.json'; /** * Gather all bootstrap-related configuration data and compile it into * a single object containing instruction for `boot.execute`. * * @options {String|Object} options Boot options; If String, this is * the application root directory; if object, has the properties * described in `bootLoopBackApp` options above. * @return {Object} * * @header boot.compile(options) */ module.exports = function compile(options) { options = options || {}; if (typeof options === 'string') { options = { appRootDir: options }; } var appRootDir = options.appRootDir = options.appRootDir || process.cwd(); var env = options.env || process.env.NODE_ENV || 'development'; var appConfigRootDir = options.appConfigRootDir || appRootDir; var appConfig = options.config || ConfigLoader.loadAppConfig(appConfigRootDir, env); assertIsValidConfig('app', appConfig); var modelsRootDir = options.modelsRootDir || appRootDir; var modelsConfig = options.models || ConfigLoader.loadModels(modelsRootDir, env); assertIsValidModelConfig(modelsConfig); var dsRootDir = options.dsRootDir || appRootDir; var dataSourcesConfig = options.dataSources || ConfigLoader.loadDataSources(dsRootDir, env); assertIsValidConfig('data source', dataSourcesConfig); // not configurable yet var middlewareRootDir = appRootDir; var middlewareConfig = options.middleware || ConfigLoader.loadMiddleware(middlewareRootDir, env); var middlewareInstructions = buildMiddlewareInstructions(middlewareRootDir, middlewareConfig); var componentRootDir = appRootDir; // not configurable yet var componentConfig = options.components || ConfigLoader.loadComponents(componentRootDir, env); var componentInstructions = buildComponentInstructions(componentRootDir, componentConfig); // require directories var bootDirs = options.bootDirs || []; // precedence bootDirs = bootDirs.concat(path.join(appRootDir, 'boot')); resolveRelativePaths(bootDirs, appRootDir); var bootScripts = options.bootScripts || []; resolveRelativePaths(bootScripts, appRootDir); bootDirs.forEach(function(dir) { bootScripts = bootScripts.concat(findScripts(dir)); var envdir = dir + '/' + env; bootScripts = bootScripts.concat(findScripts(envdir)); }); // de-dedup boot scripts -ERS // https://github.com/strongloop/loopback-boot/issues/64 bootScripts = _.uniq(bootScripts); var modelsMeta = modelsConfig._meta || {}; delete modelsConfig._meta; var modelSources = options.modelSources || modelsMeta.sources || ['./models']; var modelInstructions = buildAllModelInstructions( modelsRootDir, modelsConfig, modelSources, options.modelDefinitions); var mixinDirs = options.mixinDirs || []; var mixinSources = options.mixinSources || modelsMeta.mixins || ['./mixins']; var mixinInstructions = buildAllMixinInstructions( appRootDir, mixinDirs, mixinSources, options, modelInstructions); // When executor passes the instruction to loopback methods, // loopback modifies the data. Since we are loading the data using `require`, // such change affects also code that calls `require` for the same file. var instructions = { env: env, config: appConfig, dataSources: dataSourcesConfig, models: modelInstructions, middleware: middlewareInstructions, components: componentInstructions, mixins: mixinInstructions, files: { boot: bootScripts, }, }; if (options.appId) instructions.appId = options.appId; return cloneDeep(instructions); }; function assertIsValidConfig(name, config) { if (config) { assert(typeof config === 'object', name + ' config must be a valid JSON object'); } } function assertIsValidModelConfig(config) { assertIsValidConfig('model', config); for (var name in config) { var entry = config[name]; var options = entry.options || {}; var unsupported = entry.properties || entry.base || options.base || entry.plural || options.plural; if (unsupported) { throw new Error( 'The data in model-config.json is in the unsupported 1.x format.'); } } } /** * Find all javascript files (except for those prefixed with _) * and all directories. * @param {String} dir Full path of the directory to enumerate. * @return {Array.} A list of absolute paths to pass to `require()`. * @private */ function findScripts(dir, extensions) { assert(dir, 'cannot require directory contents without directory name'); var files = tryReadDir(dir); extensions = extensions || _.keys(require.extensions); // sort files in lowercase alpha for linux files.sort(function(a, b) { a = a.toLowerCase(); b = b.toLowerCase(); if (a < b) { return -1; } else if (b < a) { return 1; } else { return 0; } }); var results = []; files.forEach(function(filename) { // ignore index.js and files prefixed with underscore if (filename === 'index.js' || filename[0] === '_') { return; } var filepath = path.resolve(path.join(dir, filename)); var stats = fs.statSync(filepath); // only require files supported by require.extensions (.txt .md etc.) if (stats.isFile()) { if (isPreferredExtension(filename)) results.push(filepath); else debug('Skipping file %s - unknown extension', filepath); } else { debug('Skipping directory %s', filepath); } }); return results; } function tryReadDir() { try { return fs.readdirSync.apply(fs, arguments); } catch (e) { return []; } } function buildAllModelInstructions(rootDir, modelsConfig, sources, modelDefinitions) { var registry = verifyModelDefinitions(rootDir, modelDefinitions) || findModelDefinitions(rootDir, sources); var modelNamesToBuild = addAllBaseModels(registry, Object.keys(modelsConfig)); var instructions = modelNamesToBuild .map(function createModelInstructions(name) { var config = modelsConfig[name]; var definition = registry[name] || {}; debug('Using model "%s"\nConfiguration: %j\nDefinition %j', name, config, definition.definition); return { name: name, config: config, definition: definition.definition, sourceFile: definition.sourceFile, }; }); return sortByInheritance(instructions); } function addAllBaseModels(registry, modelNames) { var result = []; var visited = {}; while (modelNames.length) { var name = modelNames.shift(); if (visited[name]) continue; visited[name] = true; result.push(name); var definition = registry[name] && registry[name].definition; if (!definition) continue; var base = getBaseModelName(definition); // ignore built-in models like User if (!registry[base]) continue; modelNames.push(base); } return result; } function getBaseModelName(modelDefinition) { if (!modelDefinition) return undefined; return modelDefinition.base || modelDefinition.options && modelDefinition.options.base; } function sortByInheritance(instructions) { // create edges Base name -> Model name var edges = instructions .map(function(inst) { return [getBaseModelName(inst.definition), inst.name]; }); var sortedNames = toposort(edges); var instructionsByModelName = {}; instructions.forEach(function(inst) { instructionsByModelName[inst.name] = inst; }); return sortedNames // convert to instructions .map(function(name) { return instructionsByModelName[name]; }) // remove built-in models .filter(function(inst) { return !!inst; }); } function verifyModelDefinitions(rootDir, modelDefinitions) { if (!modelDefinitions || modelDefinitions.length < 1) { return undefined; } var registry = {}; modelDefinitions.forEach(function(definition, idx) { if (definition.sourceFile) { var fullPath = path.resolve(rootDir, definition.sourceFile); definition.sourceFile = fixFileExtension( fullPath, tryReadDir(path.dirname(fullPath)), true); if (!definition.sourceFile) { debug('Model source code not found: %s - %s', definition.sourceFile); } } debug('Found model "%s" - %s %s', definition.definition.name, 'from options', definition.sourceFile ? path.relative(rootDir, definition.sourceFile) : '(no source file)'); var modelName = definition.definition.name; if (!modelName) { debug('Skipping model definition without Model name ' + '(from options.modelDefinitions @ index %s)', idx); return; } registry[modelName] = definition; }); return registry; } function findModelDefinitions(rootDir, sources) { var registry = {}; sources.forEach(function(src) { var srcDir = tryResolveAppPath(rootDir, src, { strict: false }); if (!srcDir) { debug('Skipping unknown module source dir %j', src); return; } var files = tryReadDir(srcDir); files .filter(function(f) { return f[0] !== '_' && path.extname(f) === '.json'; }) .forEach(function(f) { var fullPath = path.resolve(srcDir, f); var entry = loadModelDefinition(rootDir, fullPath, files); var modelName = entry.definition.name; if (!modelName) { debug('Skipping model definition without Model name: %s', path.relative(srcDir, fullPath)); return; } registry[modelName] = entry; }); }); return registry; } function resolveAppPath(rootDir, relativePath, resolveOptions) { var resolvedPath = tryResolveAppPath(rootDir, relativePath, resolveOptions); if (resolvedPath === undefined && !resolveOptions.optional) { var err = new Error('Cannot resolve path "' + relativePath + '"'); err.code = 'PATH_NOT_FOUND'; throw err; } return resolvedPath; } function tryResolveAppPath(rootDir, relativePath, resolveOptions) { var fullPath; var start = relativePath.substring(0, 2); /* In order to retain backward compatibility, we need to support * two ways how to treat values that are not relative nor absolute * path (e.g. `relativePath = 'foobar'`) * - `resolveOptions.strict = true` searches in `node_modules` only * - `resolveOptions.strict = false` attempts to resolve the value * as a relative path first before searching `node_modules` */ resolveOptions = resolveOptions || { strict: true }; var isModuleRelative = false; if (relativePath[0] === '/') { fullPath = relativePath; } else if (start === './' || start === '..') { fullPath = path.resolve(rootDir, relativePath); } else if (!resolveOptions.strict) { isModuleRelative = true; fullPath = path.resolve(rootDir, relativePath); } if (fullPath) { // This check is needed to support paths pointing to a directory if (fs.existsSync(fullPath)) { return fullPath; } try { fullPath = require.resolve(fullPath); return fullPath; } catch (err) { if (!isModuleRelative) { debug ('Skipping %s - %s', fullPath, err); return undefined; } } } // Handle module-relative path, e.g. `loopback/common/models` // Module.globalPaths is a list of globally configured paths like // [ env.NODE_PATH values, $HOME/.node_modules, etc. ] // Module._nodeModulePaths(rootDir) returns a list of paths like // [ rootDir/node_modules, rootDir/../node_modules, etc. ] var modulePaths = Module.globalPaths .concat(Module._nodeModulePaths(rootDir)); fullPath = modulePaths .map(function(candidateDir) { var absPath = path.join(candidateDir, relativePath); try { // NOTE(bajtos) We need to create a proper String object here, // otherwise we can't attach additional properties to it var filePath = new String(require.resolve(absPath)); filePath.unresolvedPath = absPath; return filePath; } catch (err) { return absPath; } }) .filter(function(candidate) { return fs.existsSync(candidate.toString()); }) [0]; if (fullPath) { if (fullPath.unresolvedPath && resolveOptions.fullResolve === false) return fullPath.unresolvedPath; // Convert String object back to plain string primitive return fullPath.toString(); } debug ('Skipping %s - module not found', fullPath); return undefined; } function loadModelDefinition(rootDir, jsonFile, allFiles) { var definition = require(jsonFile); var basename = path.basename(jsonFile, path.extname(jsonFile)); definition.name = definition.name || _.capitalize(_.camelCase(basename)); // find a matching file with a supported extension like `.js` or `.coffee` var sourceFile = fixFileExtension(jsonFile, allFiles, true); if (sourceFile === undefined) { debug('Model source code not found: %s', sourceFile); } debug('Found model "%s" - %s %s', definition.name, path.relative(rootDir, jsonFile), sourceFile ? path.relative(rootDir, sourceFile) : '(no source file)'); return { definition: definition, sourceFile: sourceFile, }; } function buildMiddlewareInstructions(rootDir, config) { var phasesNames = Object.keys(config); var middlewareList = []; phasesNames.forEach(function(phase) { var phaseConfig = config[phase]; Object.keys(phaseConfig).forEach(function(middleware) { var allConfigs = phaseConfig[middleware]; if (!Array.isArray(allConfigs)) allConfigs = [allConfigs]; allConfigs.forEach(function(config) { var resolved = resolveMiddlewarePath(rootDir, middleware, config); // resolved.sourceFile will be false-y if an optional middleware // is not resolvable. // if a non-optional middleware is not resolvable, it will throw // at resolveAppPath() and not reach here if (!resolved.sourceFile) { return console.log('Middleware "%s" not found: %s', middleware, resolved.optional ); } var middlewareConfig = cloneDeep(config); middlewareConfig.phase = phase; if (middlewareConfig.params) { middlewareConfig.params = resolveMiddlewareParams( rootDir, middlewareConfig.params); } var item = { sourceFile: resolved.sourceFile, config: middlewareConfig, }; if (resolved.fragment) { item.fragment = resolved.fragment; } middlewareList.push(item); }); }); }); var flattenedPhaseNames = phasesNames .map(function getBaseName(name) { return name.replace(/:[^:]+$/, ''); }) .filter(function differsFromPreviousItem(value, ix, source) { // Skip duplicate entries. That happens when // `name:before` and `name:after` are both translated to `name` return ix === 0 || value !== source[ix - 1]; }); return { phases: flattenedPhaseNames, middleware: middlewareList, }; } function resolveMiddlewarePath(rootDir, middleware, config) { var resolved = { optional: !!config.optional, }; var segments = middleware.split('#'); var pathName = segments[0]; var fragment = segments[1]; var middlewarePath = pathName; var opts = { strict: true, optional: !!config.optional, }; if (fragment) { resolved.fragment = fragment; } if (pathName.indexOf('./') === 0 || pathName.indexOf('../') === 0) { // Relative path pathName = path.resolve(rootDir, pathName); } var resolveOpts = _.extend(opts, { // Workaround for strong-agent to allow probes to detect that // strong-express-middleware was loaded: exclude the path to the // module main file from the source file path. // For example, return // node_modules/strong-express-metrics // instead of // node_modules/strong-express-metrics/index.js fullResolve: false, }); var sourceFile = resolveAppScriptPath(rootDir, middlewarePath, resolveOpts); if (!fragment) { resolved.sourceFile = sourceFile; return resolved; } // Try to require the module and check if . is a valid // function var m = require(pathName); if (typeof m[fragment] === 'function') { resolved.sourceFile = sourceFile; return resolved; } /* * module/server/middleware/fragment * module/middleware/fragment */ var candidates = [ pathName + '/server/middleware/' + fragment, pathName + '/middleware/' + fragment, // TODO: [rfeng] Should we support the following flavors? // pathName + '/lib/' + fragment, // pathName + '/' + fragment ]; var err = undefined; // see https://github.com/eslint/eslint/issues/5744 for (var ix in candidates) { try { resolved.sourceFile = resolveAppScriptPath(rootDir, candidates[ix], opts); delete resolved.fragment; return resolved; } catch (e) { // Report the error for the first candidate when no candidate matches if (!err) err = e; } } throw err; } // Match values starting with `$!./` or `$!../` var MIDDLEWARE_PATH_PARAM_REGEX = /^\$!(\.\/|\.\.\/)/; function resolveMiddlewareParams(rootDir, params) { return cloneDeep(params, function resolvePathParam(value) { if (typeof value === 'string' && MIDDLEWARE_PATH_PARAM_REGEX.test(value)) { return path.resolve(rootDir, value.slice(2)); } else { return undefined; // no change } }); } function buildComponentInstructions(rootDir, componentConfig) { return Object.keys(componentConfig) .filter(function(name) { return !!componentConfig[name]; }) .map(function(name) { return { sourceFile: resolveAppScriptPath(rootDir, name, { strict: true }), config: componentConfig[name], }; }); } function resolveRelativePaths(relativePaths, appRootDir) { var resolveOpts = { strict: false }; relativePaths.forEach(function(relativePath, k) { var resolvedPath = tryResolveAppPath(appRootDir, relativePath, resolveOpts); if (resolvedPath !== undefined) { relativePaths[k] = resolvedPath; } else { debug ('skipping boot script %s - unknown file', relativePath); } }); } function getExcludedExtensions() { return { '.json': '.json', '.node': 'node', }; } function isPreferredExtension(filename) { var includeExtensions = require.extensions; var ext = path.extname(filename); return (ext in includeExtensions) && !(ext in getExcludedExtensions()); } function fixFileExtension(filepath, files, onlyScriptsExportingFunction) { var results = []; var otherFile; /* Prefer coffee scripts over json */ if (isPreferredExtension(filepath)) return filepath; var basename = path.basename(filepath, FILE_EXTENSION_JSON); var sourceDir = path.dirname(filepath); files.forEach(function(f) { otherFile = path.resolve(sourceDir, f); var stats = fs.statSync(otherFile); if (stats.isFile()) { var otherFileExtension = path.extname(f); if (!(otherFileExtension in getExcludedExtensions()) && path.basename(f, otherFileExtension) == basename) { if (!onlyScriptsExportingFunction) results.push(otherFile); else if (onlyScriptsExportingFunction && (typeof require.extensions[otherFileExtension]) === 'function') { results.push(otherFile); } } } }); return (results.length > 0 ? results[0] : undefined); } function resolveAppScriptPath(rootDir, relativePath, resolveOptions) { var resolvedPath = resolveAppPath(rootDir, relativePath, resolveOptions); if (!resolvedPath) { return false; } var sourceDir = path.dirname(resolvedPath); var files = tryReadDir(sourceDir); var fixedFile = fixFileExtension(resolvedPath, files, false); return (fixedFile === undefined ? resolvedPath : fixedFile); } function buildAllMixinInstructions(appRootDir, mixinDirs, mixinSources, options, modelInstructions) { var extensions = _.without(_.keys(require.extensions), _.keys(getExcludedExtensions())); // load mixins from `options.mixins` var sourceFiles = options.mixins || []; var instructionsFromMixins = loadMixins(sourceFiles, options); // load mixins from `options.mixinDirs` sourceFiles = findMixinDefinitions(appRootDir, mixinDirs, extensions); if (sourceFiles === undefined) return; var instructionsFromMixinDirs = loadMixins(sourceFiles, options); /* If `mixinDirs` and `mixinSources` have any directories in common, * then remove the common directories from `mixinSources` */ mixinSources = _.difference(mixinSources, mixinDirs); // load mixins from `options.mixinSources` sourceFiles = findMixinDefinitions(appRootDir, mixinSources, extensions); if (sourceFiles === undefined) return; var instructionsFromMixinSources = loadMixins(sourceFiles, options); // Fetch unique list of mixin names, used in models var modelMixins = fetchMixinNamesUsedInModelInstructions(modelInstructions); modelMixins = _.uniq(modelMixins); // Filter-in only mixins, that are used in models instructionsFromMixinSources = filterMixinInstructionsUsingWhitelist( instructionsFromMixinSources, modelMixins); var mixins = _.assign( instructionsFromMixins, instructionsFromMixinDirs, instructionsFromMixinSources); return _.values(mixins); } function findMixinDefinitions(appRootDir, sourceDirs, extensions) { var files = []; sourceDirs.forEach(function(dir) { var path = tryResolveAppPath(appRootDir, dir); if (!path) { debug('Skipping unknown module source dir %j', dir); return; } files = files.concat(findScripts(path, extensions)); }); return files; } function loadMixins(sourceFiles, options) { var mixinInstructions = {}; sourceFiles.forEach(function(filepath) { var dir = path.dirname(filepath); var ext = path.extname(filepath); var name = path.basename(filepath, ext); var metafile = path.join(dir, name + FILE_EXTENSION_JSON); name = normalizeMixinName(name, options); var meta = {}; meta.name = name; if (fs.existsSync(metafile)) { // May overwrite name, not sourceFile _.extend(meta, require(metafile)); } meta.sourceFile = filepath; mixinInstructions[meta.name] = meta; }); return mixinInstructions; } function fetchMixinNamesUsedInModelInstructions(modelInstructions) { return _.flatten(modelInstructions .map(function(model) { return model.definition && model.definition.mixins ? Object.keys(model.definition.mixins) : []; })); } function filterMixinInstructionsUsingWhitelist(instructions, includeMixins) { var instructionKeys = Object.keys(instructions); includeMixins = _.intersection(instructionKeys, includeMixins); var filteredInstructions = {}; instructionKeys.forEach(function(mixinName) { if (includeMixins.indexOf(mixinName) !== -1) { filteredInstructions[mixinName] = instructions[mixinName]; } }); return filteredInstructions; } function normalizeMixinName(str, options) { var normalization = options.normalization; switch (normalization) { case false: case 'none': return str; case undefined: case 'classify': str = String(str).replace(/([A-Z]+)/g, ' $1').trim(); str = String(str).replace(/[\W_]/g, ' ').toLowerCase(); str = str.replace(/(?:^|\s|-)\S/g, function(c) { return c.toUpperCase(); }); str = str.replace(/\s+/g, ''); return str; case 'dasherize': str = String(str).replace(/([A-Z]+)/g, ' $1').trim(); str = String(str).replace(/[\W_]/g, ' ').toLowerCase(); str = str.replace(/\s+/g, '-'); return str; default: if (typeof normalization === 'function') { return normalization(str); } var err = new Error('Invalid normalization format - "' + normalization + '"'); err.code = 'INVALID_NORMALIZATION_FORMAT'; throw err; } }