/** * Copyright JS Foundation and other contributors, http://js.foundation * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. **/ const fs = require("fs"); const path = require("path"); const log = require("@node-red/util").log; const i18n = require("@node-red/util").i18n; const registryUtil = require("./util"); // Default allow/deny lists let loadAllowList = ['*']; let loadDenyList = []; var settings; var disableNodePathScan = false; var iconFileExtensions = [".png", ".gif", ".svg"]; var packageList = {}; function init(_settings) { settings = _settings; // TODO: This is duplicated in installer.js // Should it *all* be managed by util? if (settings.externalModules && settings.externalModules.palette) { if (settings.externalModules.palette.allowList || settings.externalModules.palette.denyList) { loadAllowList = settings.externalModules.palette.allowList; loadDenyList = settings.externalModules.palette.denyList; } } loadAllowList = registryUtil.parseModuleList(loadAllowList); loadDenyList = registryUtil.parseModuleList(loadDenyList); } function isIncluded(name) { if (settings.nodesIncludes) { for (var i=0;i= 0) { const package = getPackageDetails(dir) if(package.isNodeRedModule) { return {files: [], icons: []}; } } files.forEach(function(fn) { var stats = fs.statSync(path.join(dir,fn)); if (stats.isFile()) { if (/\.js$/.test(fn)) { var info = getLocalFile(path.join(dir,fn)); if (info) { result.push(info); } } } else if (stats.isDirectory()) { // Ignore /.dirs/, /lib/ /node_modules/ if (!/^(\..*|lib|icons|node_modules|test|locales)$/.test(fn)) { var subDirResults = getLocalNodeFiles(path.join(dir,fn), skipValidNodeRedModules); result = result.concat(subDirResults.files); icons = icons.concat(subDirResults.icons); } else if (fn === "icons") { var iconList = scanIconDir(path.join(dir,fn)); icons.push({path:path.join(dir,fn),icons:iconList}); } } }); return {files: result, icons: icons} } function scanDirForNodesModules(dir,moduleName,package) { let results = []; let scopeName; let files try { let isNodeRedModule = false if(package) { dir = path.join(package.moduleDir,'..') files = [path.basename(package.moduleDir)] moduleName = (package.package ? package.package.name : null) || moduleName isNodeRedModule = package.isNodeRedModule } else { files = fs.readdirSync(dir); if (moduleName) { var m = /^(?:(@[^/]+)[/])?([^@/]+)/.exec(moduleName); if (m) { scopeName = m[1]; moduleName = m[2]; } } } for (let i=0;i/node_modules then it is considered // a local module. // Also check to see if it is listed in the package.json file as a user-installed // module. This distinguishes modules installed as a dependency r.local = true; r.user = !!packageList[r.package.name]; }); } if (coreNodesDir) { var up = path.resolve(path.join(coreNodesDir,"..")); while (up !== coreNodesDir) { var pm = path.join(coreNodesDir,"node_modules"); if (pm != userDir) { results = results.concat(scanDirForNodesModules(pm,moduleName)); } coreNodesDir = up; up = path.resolve(path.join(coreNodesDir,"..")); } } // scan nodesDir for any node-red modules /* 1. if !exist(package.json) || !package.json.has(node-red) => look for node_modules 2. exist(package.json) && package.json.has(node-red) => load this only 3. in original scan of nodesDir, ignore if:(exist(package.json) && package.json.has(node-red)) */ if (nodesDir) { for (let dirIndex = 0; dirIndex < nodesDir.length; dirIndex++) { const nodeDir = nodesDir[dirIndex]; const packageDetails = getPackageDetails(nodeDir) if(packageDetails.isNodeRedModule) { //we have found a node-red module, scan it const nrModules = scanDirForNodesModules(nodeDir, packageDetails.package.name, packageDetails); results = results.concat(nrModules); } else if (packageDetails.has_node_modules) { //If this dir has a `node_modues` dir, scan it const nodeModulesDir = path.join(nodeDir, 'node_modules') const nrModules = scanDirForNodesModules(nodeModulesDir, moduleName ); results = results.concat(nrModules); } else { //If this is not a node-red module AND it does NOT have a node_modules dir, //it may be a directory of project directories or a node_modules dir? //scan this instead const nrModules = scanDirForNodesModules(nodeDir, moduleName); results = results.concat(nrModules); } } } return results; } function getModuleNodeFiles(module) { var moduleDir = module.dir; var pkg = module.package; var iconDirs = []; var iconList = []; function scanTypes(types) { const files = []; for (var n in types) { /* istanbul ignore else */ if (types.hasOwnProperty(n)) { var file = path.join(moduleDir,types[n]); files.push({ file: file, module: pkg.name, name: n, version: pkg.version }); var iconDir = path.join(moduleDir,path.dirname(types[n]),"icons"); if (iconDirs.indexOf(iconDir) == -1) { try { fs.statSync(iconDir); var icons = scanIconDir(iconDir); iconList.push({path:iconDir,icons:icons}); iconDirs.push(iconDir); } catch(err) { } } } } return files; } var result = { nodeFiles:scanTypes(pkg['node-red'].nodes||{}), pluginFiles:scanTypes(pkg['node-red'].plugins||{}), icons:iconList }; var examplesDir = path.join(moduleDir,"examples"); try { fs.statSync(examplesDir) result.examples = {path:examplesDir}; } catch(err) { } var resourcesDir = path.join(moduleDir,"resources"); try { fs.statSync(resourcesDir) result.resources = {path:resourcesDir}; } catch(err) { } return result; } function getNodeFiles(disableNodePathScan) { // Find all of the nodes to load let results; let nodesDir; if(settings.nodesDir) { nodesDir = Array.isArray(settings.nodesDir) ? settings.nodesDir : [settings.nodesDir] } let dir; let nodeFiles = []; let iconList = []; if (settings.coreNodesDir) { results = getLocalNodeFiles(path.resolve(settings.coreNodesDir)); nodeFiles = nodeFiles.concat(results.files); iconList = iconList.concat(results.icons); let defaultLocalesPath = path.join(settings.coreNodesDir,"locales"); i18n.registerMessageCatalog("node-red",defaultLocalesPath,"messages.json"); } if (settings.userDir) { dir = path.join(settings.userDir,"lib","icons"); let icons = scanIconDir(dir); if (icons.length > 0) { iconList.push({path:dir,icons:icons}); } dir = path.join(settings.userDir,"nodes"); results = getLocalNodeFiles(path.resolve(dir)); nodeFiles = nodeFiles.concat(results.files); iconList = iconList.concat(results.icons); } if (nodesDir) { for (let i = 0; i < nodesDir.length; i++) { results = getLocalNodeFiles(nodesDir[i], true); nodeFiles = nodeFiles.concat(results.files); iconList = iconList.concat(results.icons); } } var coreNodeEntry = { name: "node-red", version: settings.version, nodes: {}, icons: iconList } var nodeList = { "node-red": coreNodeEntry }; nodeFiles.forEach(function(node) { coreNodeEntry.nodes[node.name] = node; }); if (settings.coreNodesDir) { var examplesDir = path.join(settings.coreNodesDir,"examples"); coreNodeEntry.examples = {path: examplesDir}; } if (!disableNodePathScan) { var moduleFiles = scanTreeForNodesModules(); // Filter the module list to ignore global modules // that have also been installed locally - allowing the user to // update a module they may not otherwise be able to touch moduleFiles.sort(function(A,B) { if (A.local && !B.local) { return -1 } else if (!A.local && B.local) { return 1 } return 0; }) var knownModules = {}; moduleFiles = moduleFiles.filter(function(mod) { var result; if (!knownModules[mod.package.name]) { knownModules[mod.package.name] = mod; result = true; } else { result = false; } log.debug((result?"":"! ")+"Module: "+mod.package.name+" "+mod.package.version+" "+mod.dir+(result?"":" *ignored due to local copy*")); return result; }); // Do a second pass to check we have all the declared node dependencies // As this is only done as part of the initial palette load, `knownModules` will // contain a list of everything discovered during this phase. This means // we can check for missing dependencies here. moduleFiles = moduleFiles.filter(function(mod) { if (Array.isArray(mod.package["node-red"].dependencies)) { const deps = mod.package["node-red"].dependencies; const missingDeps = mod.package["node-red"].dependencies.filter(dep => { if (knownModules[dep]) { knownModules[dep].usedBy = knownModules[dep].usedBy || []; knownModules[dep].usedBy.push(mod.package.name) } else { return true; } }) if (missingDeps.length > 0) { log.error(`Module: ${mod.package.name} missing dependencies:`); missingDeps.forEach(m => { log.error(` - ${m}`)}); return false; } } return true; }); nodeList = convertModuleFileListToObject(moduleFiles, nodeList); } else { // console.log("node path scan disabled"); } return nodeList; } function getModuleFiles(module) { // Update the package list var moduleFiles = scanTreeForNodesModules(module); if (moduleFiles.length === 0) { var err = new Error(log._("nodes.registry.localfilesystem.module-not-found", {module:module})); err.code = 'MODULE_NOT_FOUND'; throw err; } // Unlike when doing the initial palette load, this call cannot verify the // dependencies of the new module as it doesn't have visiblity of what // is in the registry. That will have to be done be the caller in loader.js return convertModuleFileListToObject(moduleFiles); } function convertModuleFileListToObject(moduleFiles,seedObject) { const nodeList = seedObject || {}; moduleFiles.forEach(function(moduleFile) { var nodeModuleFiles = getModuleNodeFiles(moduleFile); nodeList[moduleFile.package.name] = { name: moduleFile.package.name, version: moduleFile.package.version, path: moduleFile.dir, local: moduleFile.local||false, user: moduleFile.user||false, nodes: {}, plugins: {}, resources: nodeModuleFiles.resources, icons: nodeModuleFiles.icons, examples: nodeModuleFiles.examples }; if (moduleFile.package['node-red'].version) { nodeList[moduleFile.package.name].redVersion = moduleFile.package['node-red'].version; } if (moduleFile.package['node-red'].dependencies) { nodeList[moduleFile.package.name].dependencies = moduleFile.package['node-red'].dependencies; } if (moduleFile.usedBy) { nodeList[moduleFile.package.name].usedBy = moduleFile.usedBy; } nodeModuleFiles.nodeFiles.forEach(function(node) { nodeList[moduleFile.package.name].nodes[node.name] = node; nodeList[moduleFile.package.name].nodes[node.name].local = moduleFile.local || false; }); nodeModuleFiles.pluginFiles.forEach(function(plugin) { nodeList[moduleFile.package.name].plugins[plugin.name] = plugin; nodeList[moduleFile.package.name].plugins[plugin.name].local = moduleFile.local || false; }); }); return nodeList; } // If this finds an svg and a png with the same name, it will only list the svg function scanIconDir(dir) { var iconList = []; var svgs = {}; try { var files = fs.readdirSync(dir); files.forEach(function(file) { var stats = fs.statSync(path.join(dir, file)); var ext = path.extname(file).toLowerCase(); if (stats.isFile() && iconFileExtensions.indexOf(ext) !== -1) { iconList.push(file); if (ext === ".svg") { svgs[file.substring(0,file.length-4)] = true; } } }); } catch(err) { } iconList = iconList.filter(f => { return /.svg$/i.test(f) || !svgs[f.substring(0,f.length-4)] }) return iconList; } /** * Gets the list of modules installed in this runtime as reported by package.json * Note: these may include non-Node-RED modules */ function getPackageList() { var list = {}; if (settings.userDir) { try { var userPackage = path.join(settings.userDir,"package.json"); var pkg = JSON.parse(fs.readFileSync(userPackage,"utf-8")); return pkg.dependencies || {}; } catch(err) { log.error(err); } } return list; } /** * Gets the package json object for the supplied `dir`. * If there is no package.json or the `node-red` section is missing, `result.isNodeRedModule` will be `false`. * If there is no package.json `isPackage` will be `false`. * If an error occurs, `result.error` will contain the error. * @param {string} dir The directory to inspect */ function getPackageDetails(dir) { const result = { /** @type {string} The package directory */ moduleDir: dir, /** @type {string} The full file path of package.json for this package */ packageFile: null, /** @type {boolean} True if this is a valid node-red module */ isNodeRedModule: false, /** @type {boolean} True if a package.json file is present */ isPackage: false, /** @type {boolean} True if this a node-red module and passes the checks */ allowed: false, /** @type {object} The contents of package.json */ package: null, } if (!dir) { return result } try { const packagefile = path.join(dir,'package.json') result.has_node_modules = fs.existsSync(path.join(dir,'node_modules')) if(!fs.existsSync(packagefile)) { return result } result.packageFile = packagefile const pkg = require(packagefile) result.package = pkg if(result.package) { result.allowed = true result.isPackage = true result.isNodeRedModule = typeof result.package['node-red'] === 'object' if(result.isNodeRedModule) { result.isNodeRedModule = true; result.allowed = registryUtil.checkModuleAllowed(pkg.name,pkg.version,loadAllowList,loadDenyList) } } } catch(err) { result.error = err; // this is not a package we are interested in! } return result || result; } module.exports = { init: init, getNodeFiles: getNodeFiles, getLocalFile: getLocalFile, getModuleFiles: getModuleFiles }