883 lines
33 KiB
JavaScript
883 lines
33 KiB
JavaScript
'use strict';
|
|
|
|
// The Resolver is currently experimental and might be exposed to users in the future.
|
|
|
|
const pa = require('path');
|
|
const fs = require('fs');
|
|
|
|
const {
|
|
VMError
|
|
} = require('./bridge');
|
|
const { VMScript } = require('./script');
|
|
|
|
// This should match. Note that '\', '%' are invalid characters
|
|
// 1. name/.*
|
|
// 2. @scope/name/.*
|
|
const EXPORTS_PATTERN = /^((?:@[^/\\%]+\/)?[^/\\%]+)(\/.*)?$/;
|
|
|
|
// See https://tc39.es/ecma262/#integer-index
|
|
function isArrayIndex(key) {
|
|
const keyNum = +key;
|
|
if (`${keyNum}` !== key) return false;
|
|
return keyNum >= 0 && keyNum < 0xFFFFFFFF;
|
|
}
|
|
|
|
class Resolver {
|
|
|
|
constructor(builtinModules, globalPaths, hostRequire) {
|
|
this.builtinModules = builtinModules;
|
|
this.globalPaths = globalPaths;
|
|
this.hostRequire = hostRequire;
|
|
}
|
|
|
|
init(vm) {
|
|
|
|
}
|
|
|
|
pathResolve(path) {
|
|
return pa.resolve(path);
|
|
}
|
|
|
|
pathIsRelative(path) {
|
|
if (path === '' || path[0] !== '.') return false;
|
|
if (path.length === 1) return true;
|
|
const idx = path[1] === '.' ? 2 : 1;
|
|
if (path.length <= idx) return false;
|
|
return path[idx] === '/' || path[idx] === pa.sep;
|
|
}
|
|
|
|
pathIsAbsolute(path) {
|
|
return pa.isAbsolute(path);
|
|
}
|
|
|
|
pathConcat(...paths) {
|
|
return pa.join(...paths);
|
|
}
|
|
|
|
pathBasename(path) {
|
|
return pa.basename(path);
|
|
}
|
|
|
|
pathDirname(path) {
|
|
return pa.dirname(path);
|
|
}
|
|
|
|
lookupPaths(mod, id) {
|
|
if (typeof id === 'string') throw new Error('Id is not a string');
|
|
if (this.pathIsRelative(id)) return [mod.path || '.'];
|
|
return [...mod.paths, ...this.globalPaths];
|
|
}
|
|
|
|
getBuiltinModulesList() {
|
|
return Object.getOwnPropertyNames(this.builtinModules);
|
|
}
|
|
|
|
loadBuiltinModule(vm, id) {
|
|
const handler = this.builtinModules[id];
|
|
return handler && handler(this, vm, id);
|
|
}
|
|
|
|
loadJS(vm, mod, filename) {
|
|
throw new VMError(`Access denied to require '${filename}'`, 'EDENIED');
|
|
}
|
|
|
|
loadJSON(vm, mod, filename) {
|
|
throw new VMError(`Access denied to require '${filename}'`, 'EDENIED');
|
|
}
|
|
|
|
loadNode(vm, mod, filename) {
|
|
throw new VMError(`Access denied to require '${filename}'`, 'EDENIED');
|
|
}
|
|
|
|
registerModule(mod, filename, path, parent, direct) {
|
|
|
|
}
|
|
|
|
resolve(mod, x, options, ext, direct) {
|
|
if (typeof x !== 'string') throw new Error('Id is not a string');
|
|
|
|
if (x.startsWith('node:') || this.builtinModules[x]) {
|
|
// a. return the core module
|
|
// b. STOP
|
|
return x;
|
|
}
|
|
|
|
return this.resolveFull(mod, x, options, ext, direct);
|
|
}
|
|
|
|
resolveFull(mod, x, options, ext, direct) {
|
|
// 7. THROW "not found"
|
|
throw new VMError(`Cannot find module '${x}'`, 'ENOTFOUND');
|
|
}
|
|
|
|
// NODE_MODULES_PATHS(START)
|
|
genLookupPaths(path) {
|
|
// 1. let PARTS = path split(START)
|
|
// 2. let I = count of PARTS - 1
|
|
// 3. let DIRS = []
|
|
const dirs = [];
|
|
// 4. while I >= 0,
|
|
while (true) {
|
|
const name = this.pathBasename(path);
|
|
// a. if PARTS[I] = "node_modules" CONTINUE
|
|
if (name !== 'node_modules') {
|
|
// b. DIR = path join(PARTS[0 .. I] + "node_modules")
|
|
// c. DIRS = DIR + DIRS // Note: this seems wrong. Should be DIRS + DIR
|
|
dirs.push(this.pathConcat(path, 'node_modules'));
|
|
}
|
|
const dir = this.pathDirname(path);
|
|
if (dir == path) break;
|
|
// d. let I = I - 1
|
|
path = dir;
|
|
}
|
|
|
|
return dirs;
|
|
// This is done later on
|
|
// 5. return DIRS + GLOBAL_FOLDERS
|
|
}
|
|
|
|
}
|
|
|
|
class DefaultResolver extends Resolver {
|
|
|
|
constructor(builtinModules, checkPath, globalPaths, pathContext, customResolver, hostRequire, compiler) {
|
|
super(builtinModules, globalPaths, hostRequire);
|
|
this.checkPath = checkPath;
|
|
this.pathContext = pathContext;
|
|
this.customResolver = customResolver;
|
|
this.compiler = compiler;
|
|
this.packageCache = {__proto__: null};
|
|
this.scriptCache = {__proto__: null};
|
|
}
|
|
|
|
isPathAllowed(path) {
|
|
return this.checkPath(path);
|
|
}
|
|
|
|
pathTestIsDirectory(path) {
|
|
try {
|
|
const stat = fs.statSync(path, {__proto__: null, throwIfNoEntry: false});
|
|
return stat && stat.isDirectory();
|
|
} catch (e) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
pathTestIsFile(path) {
|
|
try {
|
|
const stat = fs.statSync(path, {__proto__: null, throwIfNoEntry: false});
|
|
return stat && stat.isFile();
|
|
} catch (e) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
readFile(path) {
|
|
return fs.readFileSync(path, {encoding: 'utf8'});
|
|
}
|
|
|
|
readFileWhenExists(path) {
|
|
return this.pathTestIsFile(path) ? this.readFile(path) : undefined;
|
|
}
|
|
|
|
readScript(filename) {
|
|
let script = this.scriptCache[filename];
|
|
if (!script) {
|
|
script = new VMScript(this.readFile(filename), {filename, compiler: this.compiler});
|
|
this.scriptCache[filename] = script;
|
|
}
|
|
return script;
|
|
}
|
|
|
|
checkAccess(mod, filename) {
|
|
if (!this.isPathAllowed(filename)) {
|
|
throw new VMError(`Module '${filename}' is not allowed to be required. The path is outside the border!`, 'EDENIED');
|
|
}
|
|
}
|
|
|
|
loadJS(vm, mod, filename) {
|
|
filename = this.pathResolve(filename);
|
|
this.checkAccess(mod, filename);
|
|
if (this.pathContext(filename, 'js') === 'sandbox') {
|
|
const script = this.readScript(filename);
|
|
vm.run(script, {filename, strict: true, module: mod, wrapper: 'none', dirname: mod.path});
|
|
} else {
|
|
const m = this.hostRequire(filename);
|
|
mod.exports = vm.readonly(m);
|
|
}
|
|
}
|
|
|
|
loadJSON(vm, mod, filename) {
|
|
filename = this.pathResolve(filename);
|
|
this.checkAccess(mod, filename);
|
|
const json = this.readFile(filename);
|
|
mod.exports = vm._jsonParse(json);
|
|
}
|
|
|
|
loadNode(vm, mod, filename) {
|
|
filename = this.pathResolve(filename);
|
|
this.checkAccess(mod, filename);
|
|
if (this.pathContext(filename, 'node') === 'sandbox') throw new VMError('Native modules can be required only with context set to \'host\'.');
|
|
const m = this.hostRequire(filename);
|
|
mod.exports = vm.readonly(m);
|
|
}
|
|
|
|
// require(X) from module at path Y
|
|
resolveFull(mod, x, options, ext, direct) {
|
|
// Note: core module handled by caller
|
|
|
|
const extList = Object.getOwnPropertyNames(ext);
|
|
const path = mod.path || '.';
|
|
|
|
// 5. LOAD_PACKAGE_SELF(X, dirname(Y))
|
|
let f = this.loadPackageSelf(x, path, extList);
|
|
if (f) return f;
|
|
|
|
// 4. If X begins with '#'
|
|
if (x[0] === '#') {
|
|
// a. LOAD_PACKAGE_IMPORTS(X, dirname(Y))
|
|
f = this.loadPackageImports(x, path, extList);
|
|
if (f) return f;
|
|
}
|
|
|
|
// 2. If X begins with '/'
|
|
if (this.pathIsAbsolute(x)) {
|
|
// a. set Y to be the filesystem root
|
|
f = this.loadAsFileOrDirecotry(x, extList);
|
|
if (f) return f;
|
|
|
|
// c. THROW "not found"
|
|
throw new VMError(`Cannot find module '${x}'`, 'ENOTFOUND');
|
|
|
|
// 3. If X begins with './' or '/' or '../'
|
|
} else if (this.pathIsRelative(x)) {
|
|
if (typeof options === 'object' && options !== null) {
|
|
const paths = options.paths;
|
|
if (Array.isArray(paths)) {
|
|
for (let i = 0; i < paths.length; i++) {
|
|
// a. LOAD_AS_FILE(Y + X)
|
|
// b. LOAD_AS_DIRECTORY(Y + X)
|
|
f = this.loadAsFileOrDirecotry(this.pathConcat(paths[i], x), extList);
|
|
if (f) return f;
|
|
}
|
|
} else if (paths === undefined) {
|
|
// a. LOAD_AS_FILE(Y + X)
|
|
// b. LOAD_AS_DIRECTORY(Y + X)
|
|
f = this.loadAsFileOrDirecotry(this.pathConcat(path, x), extList);
|
|
if (f) return f;
|
|
} else {
|
|
throw new VMError('Invalid options.paths option.');
|
|
}
|
|
} else {
|
|
// a. LOAD_AS_FILE(Y + X)
|
|
// b. LOAD_AS_DIRECTORY(Y + X)
|
|
f = this.loadAsFileOrDirecotry(this.pathConcat(path, x), extList);
|
|
if (f) return f;
|
|
}
|
|
|
|
// c. THROW "not found"
|
|
throw new VMError(`Cannot find module '${x}'`, 'ENOTFOUND');
|
|
}
|
|
|
|
let dirs;
|
|
if (typeof options === 'object' && options !== null) {
|
|
const paths = options.paths;
|
|
if (Array.isArray(paths)) {
|
|
dirs = [];
|
|
|
|
for (let i = 0; i < paths.length; i++) {
|
|
const lookups = this.genLookupPaths(paths[i]);
|
|
for (let j = 0; j < lookups.length; j++) {
|
|
if (!dirs.includes(lookups[j])) dirs.push(lookups[j]);
|
|
}
|
|
if (i === 0) {
|
|
const globalPaths = this.globalPaths;
|
|
for (let j = 0; j < globalPaths.length; j++) {
|
|
if (!dirs.includes(globalPaths[j])) dirs.push(globalPaths[j]);
|
|
}
|
|
}
|
|
}
|
|
} else if (paths === undefined) {
|
|
dirs = [...mod.paths, ...this.globalPaths];
|
|
} else {
|
|
throw new VMError('Invalid options.paths option.');
|
|
}
|
|
} else {
|
|
dirs = [...mod.paths, ...this.globalPaths];
|
|
}
|
|
|
|
// 6. LOAD_NODE_MODULES(X, dirname(Y))
|
|
f = this.loadNodeModules(x, dirs, extList);
|
|
if (f) return f;
|
|
|
|
f = this.customResolver(this, x, path, extList);
|
|
if (f) return f;
|
|
|
|
return super.resolveFull(mod, x, options, ext, direct);
|
|
}
|
|
|
|
loadAsFileOrDirecotry(x, extList) {
|
|
// a. LOAD_AS_FILE(X)
|
|
const f = this.loadAsFile(x, extList);
|
|
if (f) return f;
|
|
// b. LOAD_AS_DIRECTORY(X)
|
|
return this.loadAsDirectory(x, extList);
|
|
}
|
|
|
|
tryFile(x) {
|
|
x = this.pathResolve(x);
|
|
return this.isPathAllowed(x) && this.pathTestIsFile(x) ? x : undefined;
|
|
}
|
|
|
|
tryWithExtension(x, extList) {
|
|
for (let i = 0; i < extList.length; i++) {
|
|
const ext = extList[i];
|
|
if (ext !== this.pathBasename(ext)) continue;
|
|
const f = this.tryFile(x + ext);
|
|
if (f) return f;
|
|
}
|
|
return undefined;
|
|
}
|
|
|
|
readPackage(path) {
|
|
const packagePath = this.pathResolve(this.pathConcat(path, 'package.json'));
|
|
|
|
const cache = this.packageCache[packagePath];
|
|
if (cache !== undefined) return cache;
|
|
|
|
if (!this.isPathAllowed(packagePath)) return undefined;
|
|
const content = this.readFileWhenExists(packagePath);
|
|
if (!content) {
|
|
this.packageCache[packagePath] = false;
|
|
return false;
|
|
}
|
|
|
|
let parsed;
|
|
try {
|
|
parsed = JSON.parse(content);
|
|
} catch (e) {
|
|
e.path = packagePath;
|
|
e.message = 'Error parsing ' + packagePath + ': ' + e.message;
|
|
throw e;
|
|
}
|
|
|
|
const filtered = {
|
|
name: parsed.name,
|
|
main: parsed.main,
|
|
exports: parsed.exports,
|
|
imports: parsed.imports,
|
|
type: parsed.type
|
|
};
|
|
this.packageCache[packagePath] = filtered;
|
|
return filtered;
|
|
}
|
|
|
|
readPackageScope(path) {
|
|
while (true) {
|
|
const dir = this.pathDirname(path);
|
|
if (dir === path) break;
|
|
const basename = this.pathBasename(dir);
|
|
if (basename === 'node_modules') break;
|
|
const pack = this.readPackage(dir);
|
|
if (pack) return {data: pack, scope: dir};
|
|
path = dir;
|
|
}
|
|
return {data: undefined, scope: undefined};
|
|
}
|
|
|
|
// LOAD_AS_FILE(X)
|
|
loadAsFile(x, extList) {
|
|
// 1. If X is a file, load X as its file extension format. STOP
|
|
const f = this.tryFile(x);
|
|
if (f) return f;
|
|
// 2. If X.js is a file, load X.js as JavaScript text. STOP
|
|
// 3. If X.json is a file, parse X.json to a JavaScript Object. STOP
|
|
// 4. If X.node is a file, load X.node as binary addon. STOP
|
|
return this.tryWithExtension(x, extList);
|
|
}
|
|
|
|
// LOAD_INDEX(X)
|
|
loadIndex(x, extList) {
|
|
// 1. If X/index.js is a file, load X/index.js as JavaScript text. STOP
|
|
// 2. If X/index.json is a file, parse X/index.json to a JavaScript object. STOP
|
|
// 3. If X/index.node is a file, load X/index.node as binary addon. STOP
|
|
return this.tryWithExtension(this.pathConcat(x, 'index'), extList);
|
|
}
|
|
|
|
// LOAD_AS_DIRECTORY(X)
|
|
loadAsPackage(x, pack, extList) {
|
|
// 1. If X/package.json is a file,
|
|
// already done.
|
|
if (pack) {
|
|
// a. Parse X/package.json, and look for "main" field.
|
|
// b. If "main" is a falsy value, GOTO 2.
|
|
if (typeof pack.main === 'string') {
|
|
// c. let M = X + (json main field)
|
|
const m = this.pathConcat(x, pack.main);
|
|
// d. LOAD_AS_FILE(M)
|
|
let f = this.loadAsFile(m, extList);
|
|
if (f) return f;
|
|
// e. LOAD_INDEX(M)
|
|
f = this.loadIndex(m, extList);
|
|
if (f) return f;
|
|
// f. LOAD_INDEX(X) DEPRECATED
|
|
f = this.loadIndex(x, extList);
|
|
if (f) return f;
|
|
// g. THROW "not found"
|
|
throw new VMError(`Cannot find module '${x}'`, 'ENOTFOUND');
|
|
}
|
|
}
|
|
|
|
// 2. LOAD_INDEX(X)
|
|
return this.loadIndex(x, extList);
|
|
}
|
|
|
|
// LOAD_AS_DIRECTORY(X)
|
|
loadAsDirectory(x, extList) {
|
|
// 1. If X/package.json is a file,
|
|
const pack = this.readPackage(x);
|
|
return this.loadAsPackage(x, pack, extList);
|
|
}
|
|
|
|
// LOAD_NODE_MODULES(X, START)
|
|
loadNodeModules(x, dirs, extList) {
|
|
// 1. let DIRS = NODE_MODULES_PATHS(START)
|
|
// This step is already done.
|
|
|
|
// 2. for each DIR in DIRS:
|
|
for (let i = 0; i < dirs.length; i++) {
|
|
const dir = dirs[i];
|
|
// a. LOAD_PACKAGE_EXPORTS(X, DIR)
|
|
let f = this.loadPackageExports(x, dir, extList);
|
|
if (f) return f;
|
|
// b. LOAD_AS_FILE(DIR/X)
|
|
f = this.loadAsFile(dir + '/' + x, extList);
|
|
if (f) return f;
|
|
// c. LOAD_AS_DIRECTORY(DIR/X)
|
|
f = this.loadAsDirectory(dir + '/' + x, extList);
|
|
if (f) return f;
|
|
}
|
|
|
|
return undefined;
|
|
}
|
|
|
|
// LOAD_PACKAGE_IMPORTS(X, DIR)
|
|
loadPackageImports(x, dir, extList) {
|
|
// 1. Find the closest package scope SCOPE to DIR.
|
|
const {data, scope} = this.readPackageScope(dir);
|
|
// 2. If no scope was found, return.
|
|
if (!data) return undefined;
|
|
// 3. If the SCOPE/package.json "imports" is null or undefined, return.
|
|
if (typeof data.imports !== 'object' || data.imports === null || Array.isArray(data.imports)) return undefined;
|
|
// 4. let MATCH = PACKAGE_IMPORTS_RESOLVE(X, pathToFileURL(SCOPE),
|
|
// ["node", "require"]) defined in the ESM resolver.
|
|
|
|
// PACKAGE_IMPORTS_RESOLVE(specifier, parentURL, conditions)
|
|
// 1. Assert: specifier begins with "#".
|
|
// 2. If specifier is exactly equal to "#" or starts with "#/", then
|
|
if (x === '#' || x.startsWith('#/')) {
|
|
// a. Throw an Invalid Module Specifier error.
|
|
throw new VMError(`Invalid module specifier '${x}'`, 'ERR_INVALID_MODULE_SPECIFIER');
|
|
}
|
|
// 3. Let packageURL be the result of LOOKUP_PACKAGE_SCOPE(parentURL).
|
|
// Note: packageURL === parentURL === scope
|
|
// 4. If packageURL is not null, then
|
|
// Always true
|
|
// a. Let pjson be the result of READ_PACKAGE_JSON(packageURL).
|
|
// pjson === data
|
|
// b. If pjson.imports is a non-null Object, then
|
|
// Already tested
|
|
// x. Let resolved be the result of PACKAGE_IMPORTS_EXPORTS_RESOLVE( specifier, pjson.imports, packageURL, true, conditions).
|
|
const match = this.packageImportsExportsResolve(x, data.imports, scope, true, ['node', 'require'], extList);
|
|
// y. If resolved is not null or undefined, return resolved.
|
|
if (!match) {
|
|
// 5. Throw a Package Import Not Defined error.
|
|
throw new VMError(`Package import not defined for '${x}'`, 'ERR_PACKAGE_IMPORT_NOT_DEFINED');
|
|
}
|
|
// END PACKAGE_IMPORTS_RESOLVE
|
|
|
|
// 5. RESOLVE_ESM_MATCH(MATCH).
|
|
return this.resolveEsmMatch(match, x, extList);
|
|
}
|
|
|
|
// LOAD_PACKAGE_EXPORTS(X, DIR)
|
|
loadPackageExports(x, dir, extList) {
|
|
// 1. Try to interpret X as a combination of NAME and SUBPATH where the name
|
|
// may have a @scope/ prefix and the subpath begins with a slash (`/`).
|
|
const res = x.match(EXPORTS_PATTERN);
|
|
// 2. If X does not match this pattern or DIR/NAME/package.json is not a file,
|
|
// return.
|
|
if (!res) return undefined;
|
|
const scope = this.pathConcat(dir, res[1]);
|
|
const pack = this.readPackage(scope);
|
|
if (!pack) return undefined;
|
|
// 3. Parse DIR/NAME/package.json, and look for "exports" field.
|
|
// 4. If "exports" is null or undefined, return.
|
|
if (!pack.exports) return undefined;
|
|
// 5. let MATCH = PACKAGE_EXPORTS_RESOLVE(pathToFileURL(DIR/NAME), "." + SUBPATH,
|
|
// `package.json` "exports", ["node", "require"]) defined in the ESM resolver.
|
|
const match = this.packageExportsResolve(scope, '.' + (res[2] || ''), pack.exports, ['node', 'require'], extList);
|
|
// 6. RESOLVE_ESM_MATCH(MATCH)
|
|
return this.resolveEsmMatch(match, x, extList);
|
|
}
|
|
|
|
// LOAD_PACKAGE_SELF(X, DIR)
|
|
loadPackageSelf(x, dir, extList) {
|
|
// 1. Find the closest package scope SCOPE to DIR.
|
|
const {data, scope} = this.readPackageScope(dir);
|
|
// 2. If no scope was found, return.
|
|
if (!data) return undefined;
|
|
// 3. If the SCOPE/package.json "exports" is null or undefined, return.
|
|
if (!data.exports) return undefined;
|
|
// 4. If the SCOPE/package.json "name" is not the first segment of X, return.
|
|
if (x !== data.name && !x.startsWith(data.name + '/')) return undefined;
|
|
// 5. let MATCH = PACKAGE_EXPORTS_RESOLVE(pathToFileURL(SCOPE),
|
|
// "." + X.slice("name".length), `package.json` "exports", ["node", "require"])
|
|
// defined in the ESM resolver.
|
|
const match = this.packageExportsResolve(scope, '.' + x.slice(data.name.length), data.exports, ['node', 'require'], extList);
|
|
// 6. RESOLVE_ESM_MATCH(MATCH)
|
|
return this.resolveEsmMatch(match, x, extList);
|
|
}
|
|
|
|
// RESOLVE_ESM_MATCH(MATCH)
|
|
resolveEsmMatch(match, x, extList) {
|
|
// 1. let { RESOLVED, EXACT } = MATCH
|
|
const resolved = match;
|
|
const exact = true;
|
|
// 2. let RESOLVED_PATH = fileURLToPath(RESOLVED)
|
|
const resolvedPath = resolved;
|
|
let f;
|
|
// 3. If EXACT is true,
|
|
if (exact) {
|
|
// a. If the file at RESOLVED_PATH exists, load RESOLVED_PATH as its extension
|
|
// format. STOP
|
|
f = this.tryFile(resolvedPath);
|
|
// 4. Otherwise, if EXACT is false,
|
|
} else {
|
|
// a. LOAD_AS_FILE(RESOLVED_PATH)
|
|
// b. LOAD_AS_DIRECTORY(RESOLVED_PATH)
|
|
f = this.loadAsFileOrDirecotry(resolvedPath, extList);
|
|
}
|
|
if (f) return f;
|
|
// 5. THROW "not found"
|
|
throw new VMError(`Cannot find module '${x}'`, 'ENOTFOUND');
|
|
}
|
|
|
|
// PACKAGE_EXPORTS_RESOLVE(packageURL, subpath, exports, conditions)
|
|
packageExportsResolve(packageURL, subpath, rexports, conditions, extList) {
|
|
// 1. If exports is an Object with both a key starting with "." and a key not starting with ".", throw an Invalid Package Configuration error.
|
|
let hasDots = false;
|
|
if (typeof rexports === 'object' && !Array.isArray(rexports)) {
|
|
const keys = Object.getOwnPropertyNames(rexports);
|
|
if (keys.length > 0) {
|
|
hasDots = keys[0][0] === '.';
|
|
for (let i = 0; i < keys.length; i++) {
|
|
if (hasDots !== (keys[i][0] === '.')) {
|
|
throw new VMError('Invalid package configuration', 'ERR_INVALID_PACKAGE_CONFIGURATION');
|
|
}
|
|
}
|
|
}
|
|
}
|
|
// 2. If subpath is equal to ".", then
|
|
if (subpath === '.') {
|
|
// a. Let mainExport be undefined.
|
|
let mainExport = undefined;
|
|
// b. If exports is a String or Array, or an Object containing no keys starting with ".", then
|
|
if (typeof rexports === 'string' || Array.isArray(rexports) || !hasDots) {
|
|
// x. Set mainExport to exports.
|
|
mainExport = rexports;
|
|
// c. Otherwise if exports is an Object containing a "." property, then
|
|
} else if (hasDots) {
|
|
// x. Set mainExport to exports["."].
|
|
mainExport = rexports['.'];
|
|
}
|
|
// d. If mainExport is not undefined, then
|
|
if (mainExport) {
|
|
// x. Let resolved be the result of PACKAGE_TARGET_RESOLVE( packageURL, mainExport, "", false, false, conditions).
|
|
const resolved = this.packageTargetResolve(packageURL, mainExport, '', false, false, conditions, extList);
|
|
// y. If resolved is not null or undefined, return resolved.
|
|
if (resolved) return resolved;
|
|
}
|
|
// 3. Otherwise, if exports is an Object and all keys of exports start with ".", then
|
|
} else if (hasDots) {
|
|
// a. Let matchKey be the string "./" concatenated with subpath.
|
|
// Note: Here subpath starts already with './'
|
|
// b. Let resolved be the result of PACKAGE_IMPORTS_EXPORTS_RESOLVE( matchKey, exports, packageURL, false, conditions).
|
|
const resolved = this.packageImportsExportsResolve(subpath, rexports, packageURL, false, conditions, extList);
|
|
// c. If resolved is not null or undefined, return resolved.
|
|
if (resolved) return resolved;
|
|
}
|
|
// 4. Throw a Package Path Not Exported error.
|
|
throw new VMError(`Package path '${subpath}' is not exported`, 'ERR_PACKAGE_PATH_NOT_EXPORTED');
|
|
}
|
|
|
|
// PACKAGE_IMPORTS_EXPORTS_RESOLVE(matchKey, matchObj, packageURL, isImports, conditions)
|
|
packageImportsExportsResolve(matchKey, matchObj, packageURL, isImports, conditions, extList) {
|
|
// 1. If matchKey is a key of matchObj and does not contain "*", then
|
|
let target = matchObj[matchKey];
|
|
if (target && matchKey.indexOf('*') === -1) {
|
|
// a. Let target be the value of matchObj[matchKey].
|
|
// b. Return the result of PACKAGE_TARGET_RESOLVE(packageURL, target, "", false, isImports, conditions).
|
|
return this.packageTargetResolve(packageURL, target, '', false, isImports, conditions, extList);
|
|
}
|
|
// 2. Let expansionKeys be the list of keys of matchObj containing only a single "*",
|
|
// sorted by the sorting function PATTERN_KEY_COMPARE which orders in descending order of specificity.
|
|
const expansionKeys = Object.getOwnPropertyNames(matchObj);
|
|
let bestKey = '';
|
|
let bestSubpath;
|
|
// 3. For each key expansionKey in expansionKeys, do
|
|
for (let i = 0; i < expansionKeys.length; i++) {
|
|
const expansionKey = expansionKeys[i];
|
|
if (matchKey.length < expansionKey.length) continue;
|
|
// a. Let patternBase be the substring of expansionKey up to but excluding the first "*" character.
|
|
const star = expansionKey.indexOf('*');
|
|
if (star === -1) continue; // Note: expansionKeys was not filtered
|
|
const patternBase = expansionKey.slice(0, star);
|
|
// b. If matchKey starts with but is not equal to patternBase, then
|
|
if (matchKey.startsWith(patternBase) && expansionKey.indexOf('*', star + 1) === -1) { // Note: expansionKeys was not filtered
|
|
// 1. Let patternTrailer be the substring of expansionKey from the index after the first "*" character.
|
|
const patternTrailer = expansionKey.slice(star + 1);
|
|
// 2. If patternTrailer has zero length, or if matchKey ends with patternTrailer and the length of matchKey is greater than or
|
|
// equal to the length of expansionKey, then
|
|
if (matchKey.endsWith(patternTrailer) && this.patternKeyCompare(bestKey, expansionKey) === 1) { // Note: expansionKeys was not sorted
|
|
// a. Let target be the value of matchObj[expansionKey].
|
|
target = matchObj[expansionKey];
|
|
// b. Let subpath be the substring of matchKey starting at the index of the length of patternBase up to the length of
|
|
// matchKey minus the length of patternTrailer.
|
|
bestKey = expansionKey;
|
|
bestSubpath = matchKey.slice(patternBase.length, matchKey.length - patternTrailer.length);
|
|
}
|
|
}
|
|
}
|
|
if (bestSubpath) { // Note: expansionKeys was not sorted
|
|
// c. Return the result of PACKAGE_TARGET_RESOLVE(packageURL, target, subpath, true, isImports, conditions).
|
|
return this.packageTargetResolve(packageURL, target, bestSubpath, true, isImports, conditions, extList);
|
|
}
|
|
// 4. Return null.
|
|
return null;
|
|
}
|
|
|
|
// PATTERN_KEY_COMPARE(keyA, keyB)
|
|
patternKeyCompare(keyA, keyB) {
|
|
// 1. Assert: keyA ends with "/" or contains only a single "*".
|
|
// 2. Assert: keyB ends with "/" or contains only a single "*".
|
|
// 3. Let baseLengthA be the index of "*" in keyA plus one, if keyA contains "*", or the length of keyA otherwise.
|
|
const baseAStar = keyA.indexOf('*');
|
|
const baseLengthA = baseAStar === -1 ? keyA.length : baseAStar + 1;
|
|
// 4. Let baseLengthB be the index of "*" in keyB plus one, if keyB contains "*", or the length of keyB otherwise.
|
|
const baseBStar = keyB.indexOf('*');
|
|
const baseLengthB = baseBStar === -1 ? keyB.length : baseBStar + 1;
|
|
// 5. If baseLengthA is greater than baseLengthB, return -1.
|
|
if (baseLengthA > baseLengthB) return -1;
|
|
// 6. If baseLengthB is greater than baseLengthA, return 1.
|
|
if (baseLengthB > baseLengthA) return 1;
|
|
// 7. If keyA does not contain "*", return 1.
|
|
if (baseAStar === -1) return 1;
|
|
// 8. If keyB does not contain "*", return -1.
|
|
if (baseBStar === -1) return -1;
|
|
// 9. If the length of keyA is greater than the length of keyB, return -1.
|
|
if (keyA.length > keyB.length) return -1;
|
|
// 10. If the length of keyB is greater than the length of keyA, return 1.
|
|
if (keyB.length > keyA.length) return 1;
|
|
// 11. Return 0.
|
|
return 0;
|
|
}
|
|
|
|
// PACKAGE_TARGET_RESOLVE(packageURL, target, subpath, pattern, internal, conditions)
|
|
packageTargetResolve(packageURL, target, subpath, pattern, internal, conditions, extList) {
|
|
// 1. If target is a String, then
|
|
if (typeof target === 'string') {
|
|
// a. If pattern is false, subpath has non-zero length and target does not end with "/", throw an Invalid Module Specifier error.
|
|
if (!pattern && subpath.length > 0 && !target.endsWith('/')) {
|
|
throw new VMError(`Invalid package specifier '${subpath}'`, 'ERR_INVALID_MODULE_SPECIFIER');
|
|
}
|
|
// b. If target does not start with "./", then
|
|
if (!target.startsWith('./')) {
|
|
// 1. If internal is true and target does not start with "../" or "/" and is not a valid URL, then
|
|
if (internal && !target.startsWith('../') && !target.startsWith('/')) {
|
|
let isURL = false;
|
|
try {
|
|
// eslint-disable-next-line no-new
|
|
new URL(target);
|
|
isURL = true;
|
|
} catch (e) {}
|
|
if (!isURL) {
|
|
// a. If pattern is true, then
|
|
if (pattern) {
|
|
// 1. Return PACKAGE_RESOLVE(target with every instance of "*" replaced by subpath, packageURL + "/").
|
|
return this.packageResolve(target.replace(/\*/g, subpath), packageURL, conditions, extList);
|
|
}
|
|
// b. Return PACKAGE_RESOLVE(target + subpath, packageURL + "/").
|
|
return this.packageResolve(this.pathConcat(target, subpath), packageURL, conditions, extList);
|
|
}
|
|
}
|
|
// Otherwise, throw an Invalid Package Target error.
|
|
throw new VMError(`Invalid package target for '${subpath}'`, 'ERR_INVALID_PACKAGE_TARGET');
|
|
}
|
|
target = decodeURI(target);
|
|
// c. If target split on "/" or "\" contains any ".", ".." or "node_modules" segments after the first segment, case insensitive
|
|
// and including percent encoded variants, throw an Invalid Package Target error.
|
|
if (target.split(/[/\\]/).slice(1).findIndex(x => x === '.' || x === '..' || x.toLowerCase() === 'node_modules') !== -1) {
|
|
throw new VMError(`Invalid package target for '${subpath}'`, 'ERR_INVALID_PACKAGE_TARGET');
|
|
}
|
|
// d. Let resolvedTarget be the URL resolution of the concatenation of packageURL and target.
|
|
const resolvedTarget = this.pathConcat(packageURL, target);
|
|
// e. Assert: resolvedTarget is contained in packageURL.
|
|
subpath = decodeURI(subpath);
|
|
// f. If subpath split on "/" or "\" contains any ".", ".." or "node_modules" segments, case insensitive and including percent
|
|
// encoded variants, throw an Invalid Module Specifier error.
|
|
if (subpath.split(/[/\\]/).findIndex(x => x === '.' || x === '..' || x.toLowerCase() === 'node_modules') !== -1) {
|
|
throw new VMError(`Invalid package specifier '${subpath}'`, 'ERR_INVALID_MODULE_SPECIFIER');
|
|
}
|
|
// g. If pattern is true, then
|
|
if (pattern) {
|
|
// 1. Return the URL resolution of resolvedTarget with every instance of "*" replaced with subpath.
|
|
return resolvedTarget.replace(/\*/g, subpath);
|
|
}
|
|
// h. Otherwise,
|
|
// 1. Return the URL resolution of the concatenation of subpath and resolvedTarget.
|
|
return this.pathConcat(resolvedTarget, subpath);
|
|
// 3. Otherwise, if target is an Array, then
|
|
} else if (Array.isArray(target)) {
|
|
// a. If target.length is zero, return null.
|
|
if (target.length === 0) return null;
|
|
let lastException = undefined;
|
|
// b. For each item targetValue in target, do
|
|
for (let i = 0; i < target.length; i++) {
|
|
const targetValue = target[i];
|
|
// 1. Let resolved be the result of PACKAGE_TARGET_RESOLVE( packageURL, targetValue, subpath, pattern, internal, conditions),
|
|
// continuing the loop on any Invalid Package Target error.
|
|
let resolved;
|
|
try {
|
|
resolved = this.packageTargetResolve(packageURL, targetValue, subpath, pattern, internal, conditions, extList);
|
|
} catch (e) {
|
|
if (e.code !== 'ERR_INVALID_PACKAGE_TARGET') throw e;
|
|
lastException = e;
|
|
continue;
|
|
}
|
|
// 2. If resolved is undefined, continue the loop.
|
|
// 3. Return resolved.
|
|
if (resolved !== undefined) return resolved;
|
|
if (resolved === null) {
|
|
lastException = null;
|
|
}
|
|
}
|
|
// c. Return or throw the last fallback resolution null return or error.
|
|
if (lastException === undefined || lastException === null) return lastException;
|
|
throw lastException;
|
|
// 2. Otherwise, if target is a non-null Object, then
|
|
} else if (typeof target === 'object' && target !== null) {
|
|
const keys = Object.getOwnPropertyNames(target);
|
|
// a. If exports contains any index property keys, as defined in ECMA-262 6.1.7 Array Index, throw an Invalid Package Configuration error.
|
|
for (let i = 0; i < keys.length; i++) {
|
|
const p = keys[i];
|
|
if (isArrayIndex(p)) throw new VMError(`Invalid package configuration for '${subpath}'`, 'ERR_INVALID_PACKAGE_CONFIGURATION');
|
|
}
|
|
// b. For each property p of target, in object insertion order as,
|
|
for (let i = 0; i < keys.length; i++) {
|
|
const p = keys[i];
|
|
// 1. If p equals "default" or conditions contains an entry for p, then
|
|
if (p === 'default' || conditions.includes(p)) {
|
|
// a. Let targetValue be the value of the p property in target.
|
|
const targetValue = target[p];
|
|
// b. Let resolved be the result of PACKAGE_TARGET_RESOLVE( packageURL, targetValue, subpath, pattern, internal, conditions).
|
|
const resolved = this.packageTargetResolve(packageURL, targetValue, subpath, pattern, internal, conditions, extList);
|
|
// c. If resolved is equal to undefined, continue the loop.
|
|
// d. Return resolved.
|
|
if (resolved !== undefined) return resolved;
|
|
}
|
|
}
|
|
// c. Return undefined.
|
|
return undefined;
|
|
// 4. Otherwise, if target is null, return null.
|
|
} else if (target == null) {
|
|
return null;
|
|
}
|
|
// Otherwise throw an Invalid Package Target error.
|
|
throw new VMError(`Invalid package target for '${subpath}'`, 'ERR_INVALID_PACKAGE_TARGET');
|
|
}
|
|
|
|
// PACKAGE_RESOLVE(packageSpecifier, parentURL)
|
|
packageResolve(packageSpecifier, parentURL, conditions, extList) {
|
|
// 1. Let packageName be undefined.
|
|
let packageName = undefined;
|
|
// 2. If packageSpecifier is an empty string, then
|
|
if (packageSpecifier === '') {
|
|
// a. Throw an Invalid Module Specifier error.
|
|
throw new VMError(`Invalid package specifier '${packageSpecifier}'`, 'ERR_INVALID_MODULE_SPECIFIER');
|
|
}
|
|
// 3. If packageSpecifier is a Node.js builtin module name, then
|
|
if (this.builtinModules[packageSpecifier]) {
|
|
// a. Return the string "node:" concatenated with packageSpecifier.
|
|
return 'node:' + packageSpecifier;
|
|
}
|
|
let idx = packageSpecifier.indexOf('/');
|
|
// 5. Otherwise,
|
|
if (packageSpecifier[0] === '@') {
|
|
// a. If packageSpecifier does not contain a "/" separator, then
|
|
if (idx === -1) {
|
|
// x. Throw an Invalid Module Specifier error.
|
|
throw new VMError(`Invalid package specifier '${packageSpecifier}'`, 'ERR_INVALID_MODULE_SPECIFIER');
|
|
}
|
|
// b. Set packageName to the substring of packageSpecifier until the second "/" separator or the end of the string.
|
|
idx = packageSpecifier.indexOf('/', idx + 1);
|
|
}
|
|
// else
|
|
// 4. If packageSpecifier does not start with "@", then
|
|
// a. Set packageName to the substring of packageSpecifier until the first "/" separator or the end of the string.
|
|
packageName = idx === -1 ? packageSpecifier : packageSpecifier.slice(0, idx);
|
|
// 6. If packageName starts with "." or contains "\" or "%", then
|
|
if (idx !== 0 && (packageName[0] === '.' || packageName.indexOf('\\') >= 0 || packageName.indexOf('%') >= 0)) {
|
|
// a. Throw an Invalid Module Specifier error.
|
|
throw new VMError(`Invalid package specifier '${packageSpecifier}'`, 'ERR_INVALID_MODULE_SPECIFIER');
|
|
}
|
|
// 7. Let packageSubpath be "." concatenated with the substring of packageSpecifier from the position at the length of packageName.
|
|
const packageSubpath = '.' + packageSpecifier.slice(packageName.length);
|
|
// 8. If packageSubpath ends in "/", then
|
|
if (packageSubpath[packageSubpath.length - 1] === '/') {
|
|
// a. Throw an Invalid Module Specifier error.
|
|
throw new VMError(`Invalid package specifier '${packageSpecifier}'`, 'ERR_INVALID_MODULE_SPECIFIER');
|
|
}
|
|
// 9. Let selfUrl be the result of PACKAGE_SELF_RESOLVE(packageName, packageSubpath, parentURL).
|
|
const selfUrl = this.packageSelfResolve(packageName, packageSubpath, parentURL);
|
|
// 10. If selfUrl is not undefined, return selfUrl.
|
|
if (selfUrl) return selfUrl;
|
|
// 11. While parentURL is not the file system root,
|
|
let packageURL;
|
|
while (true) {
|
|
// a. Let packageURL be the URL resolution of "node_modules/" concatenated with packageSpecifier, relative to parentURL.
|
|
packageURL = this.pathResolve(this.pathConcat(parentURL, 'node_modules', packageSpecifier));
|
|
// b. Set parentURL to the parent folder URL of parentURL.
|
|
const parentParentURL = this.pathDirname(parentURL);
|
|
// c. If the folder at packageURL does not exist, then
|
|
if (this.isPathAllowed(packageURL) && this.pathTestIsDirectory(packageURL)) break;
|
|
// 1. Continue the next loop iteration.
|
|
if (parentParentURL === parentURL) {
|
|
// 12. Throw a Module Not Found error.
|
|
throw new VMError(`Cannot find module '${packageSpecifier}'`, 'ENOTFOUND');
|
|
}
|
|
parentURL = parentParentURL;
|
|
}
|
|
// d. Let pjson be the result of READ_PACKAGE_JSON(packageURL).
|
|
const pack = this.readPackage(packageURL);
|
|
// e. If pjson is not null and pjson.exports is not null or undefined, then
|
|
if (pack && pack.exports) {
|
|
// 1. Return the result of PACKAGE_EXPORTS_RESOLVE(packageURL, packageSubpath, pjson.exports, defaultConditions).
|
|
return this.packageExportsResolve(packageURL, packageSubpath, pack.exports, conditions, extList);
|
|
}
|
|
// f. Otherwise, if packageSubpath is equal to ".", then
|
|
if (packageSubpath === '.') {
|
|
// 1. If pjson.main is a string, then
|
|
// a. Return the URL resolution of main in packageURL.
|
|
return this.loadAsPackage(packageSubpath, pack, extList);
|
|
}
|
|
// g. Otherwise,
|
|
// 1. Return the URL resolution of packageSubpath in packageURL.
|
|
return this.pathConcat(packageURL, packageSubpath);
|
|
}
|
|
|
|
}
|
|
|
|
exports.Resolver = Resolver;
|
|
exports.DefaultResolver = DefaultResolver;
|